agentix-cli 0.157.0 → 0.158.0
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/README.md +32 -2
- package/dist/{absorb-eval-VUJFGASJ.js → absorb-eval-OCR3G5TE.js} +2 -2
- package/dist/{agent-EA55CR6J.js → agent-QZ4QTZKW.js} +2 -2
- package/dist/{board-dashboard-2X72LAVO.js → board-dashboard-QJ2CWJKI.js} +809 -281
- package/dist/board-dashboard-QJ2CWJKI.js.map +1 -0
- package/dist/{chunk-6HNCLOHS.js → chunk-5XPXYOWB.js} +2 -2
- package/dist/{chunk-SKSYII3K.js → chunk-6QZKQUAT.js} +2 -2
- package/dist/chunk-BERWTVG2.js +2 -0
- package/dist/{chunk-QD6IICK7.js.map → chunk-BERWTVG2.js.map} +1 -1
- package/dist/{chunk-3HO6CHT6.js → chunk-DNPL3YOH.js} +2 -2
- package/dist/{chunk-BKHIR2YJ.js → chunk-DPNCWHJW.js} +2 -2
- package/dist/{chunk-4UJ7S2DD.js → chunk-FM6RZI52.js} +2 -2
- package/dist/{chunk-R4HBEILQ.js → chunk-GVMV3TWS.js} +2 -2
- package/dist/{chunk-R4HBEILQ.js.map → chunk-GVMV3TWS.js.map} +1 -1
- package/dist/{chunk-7LN4VKDU.js → chunk-JYSJDHNS.js} +2 -2
- package/dist/chunk-JYSJDHNS.js.map +1 -0
- package/dist/{chunk-I5FRA3JS.js → chunk-LSDUL7EW.js} +4 -4
- package/dist/{chunk-GKQVXA3P.js → chunk-MKLRCNOX.js} +5 -5
- package/dist/{chunk-B2QYMUTD.js → chunk-P5RTEJUB.js} +2 -2
- package/dist/{chunk-OABGAL3N.js → chunk-PVWHEPF3.js} +2 -2
- package/dist/{chunk-MJHAMHEF.js → chunk-QH3RKKD3.js} +2 -2
- package/dist/{chunk-5OZMFHIZ.js → chunk-SRUIUZOC.js} +8 -8
- package/dist/{chunk-5OZMFHIZ.js.map → chunk-SRUIUZOC.js.map} +1 -1
- package/dist/{chunk-CCSG7MSD.js → chunk-TM2TPQKH.js} +2 -2
- package/dist/{chunk-FKYIYJF7.js → chunk-TRGNLW43.js} +2 -2
- package/dist/{chunk-YLFNY4OF.js → chunk-VHHKS7S4.js} +2 -2
- package/dist/{chunk-CLNOAP6S.js → chunk-ZSVCHDYT.js} +2 -2
- package/dist/cli.js +1 -1
- package/dist/{compaction-GSUWZYBK.js → compaction-VN3M5YGZ.js} +2 -2
- package/dist/{contributions-TMZ3DYY5.js → contributions-ECGVSETO.js} +2 -2
- package/dist/{doctor-FTUB5ITL.js → doctor-D6OVZAFB.js} +2 -2
- package/dist/index.js +1 -1
- package/dist/memory-extract-4JFORU2K.js +2 -0
- package/dist/processes-XM77XGOO.js +2 -0
- package/dist/{program-HWWXPPS5.js → program-7UMVHRD3.js} +12 -12
- package/dist/{query-2EWUIUIT.js → query-WWZEARB4.js} +2 -2
- package/dist/{query-settings-7CB37D6D.js → query-settings-3FE555NP.js} +2 -2
- package/dist/{registry-EZMQ2OYY.js → registry-JPZLE5XX.js} +2 -2
- package/dist/{wiki-PSUAAREB.js → wiki-5Y4GSCYL.js} +2 -2
- package/package.json +2 -2
- package/dist/board-dashboard-2X72LAVO.js.map +0 -1
- package/dist/chunk-7LN4VKDU.js.map +0 -1
- package/dist/chunk-QD6IICK7.js +0 -2
- package/dist/memory-extract-PFJDJNBH.js +0 -2
- package/dist/processes-M3N3S7V5.js +0 -2
- /package/dist/{absorb-eval-VUJFGASJ.js.map → absorb-eval-OCR3G5TE.js.map} +0 -0
- /package/dist/{agent-EA55CR6J.js.map → agent-QZ4QTZKW.js.map} +0 -0
- /package/dist/{chunk-6HNCLOHS.js.map → chunk-5XPXYOWB.js.map} +0 -0
- /package/dist/{chunk-SKSYII3K.js.map → chunk-6QZKQUAT.js.map} +0 -0
- /package/dist/{chunk-3HO6CHT6.js.map → chunk-DNPL3YOH.js.map} +0 -0
- /package/dist/{chunk-BKHIR2YJ.js.map → chunk-DPNCWHJW.js.map} +0 -0
- /package/dist/{chunk-4UJ7S2DD.js.map → chunk-FM6RZI52.js.map} +0 -0
- /package/dist/{chunk-I5FRA3JS.js.map → chunk-LSDUL7EW.js.map} +0 -0
- /package/dist/{chunk-GKQVXA3P.js.map → chunk-MKLRCNOX.js.map} +0 -0
- /package/dist/{chunk-B2QYMUTD.js.map → chunk-P5RTEJUB.js.map} +0 -0
- /package/dist/{chunk-OABGAL3N.js.map → chunk-PVWHEPF3.js.map} +0 -0
- /package/dist/{chunk-MJHAMHEF.js.map → chunk-QH3RKKD3.js.map} +0 -0
- /package/dist/{chunk-CCSG7MSD.js.map → chunk-TM2TPQKH.js.map} +0 -0
- /package/dist/{chunk-FKYIYJF7.js.map → chunk-TRGNLW43.js.map} +0 -0
- /package/dist/{chunk-YLFNY4OF.js.map → chunk-VHHKS7S4.js.map} +0 -0
- /package/dist/{chunk-CLNOAP6S.js.map → chunk-ZSVCHDYT.js.map} +0 -0
- /package/dist/{compaction-GSUWZYBK.js.map → compaction-VN3M5YGZ.js.map} +0 -0
- /package/dist/{contributions-TMZ3DYY5.js.map → contributions-ECGVSETO.js.map} +0 -0
- /package/dist/{doctor-FTUB5ITL.js.map → doctor-D6OVZAFB.js.map} +0 -0
- /package/dist/{memory-extract-PFJDJNBH.js.map → memory-extract-4JFORU2K.js.map} +0 -0
- /package/dist/{processes-M3N3S7V5.js.map → processes-XM77XGOO.js.map} +0 -0
- /package/dist/{program-HWWXPPS5.js.map → program-7UMVHRD3.js.map} +0 -0
- /package/dist/{query-2EWUIUIT.js.map → query-WWZEARB4.js.map} +0 -0
- /package/dist/{query-settings-7CB37D6D.js.map → query-settings-3FE555NP.js.map} +0 -0
- /package/dist/{registry-EZMQ2OYY.js.map → registry-JPZLE5XX.js.map} +0 -0
- /package/dist/{wiki-PSUAAREB.js.map → wiki-5Y4GSCYL.js.map} +0 -0
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{a as Qm,b as ri,g as Zm}from"./chunk-NY5ZY2WV.js";import{a as Xm,b as Km}from"./chunk-JJV7O7YK.js";import{b as Vm}from"./chunk-
|
|
1
|
+
import{a as Qm,b as ri,g as Zm}from"./chunk-NY5ZY2WV.js";import{a as Xm,b as Km}from"./chunk-JJV7O7YK.js";import{b as Vm}from"./chunk-TRGNLW43.js";import{E as jm,F as _m,G as ic,H as Dm,K as Fm,L as qm,M as Um,O as ac,P as Wm,R as Bm,S as Jm,T as Gm,a as mm,e as pm,f as fm,g as hm,h as ym,i as wm,j as $m,m as ni,n as si,o as Zt,q as vm,r as xm,s as Rm,t as Cm,v as Tm,w as Om,x as Nm,y as rc,z as Im}from"./chunk-ZSVCHDYT.js";import{a as Pm,c as Mm,d as Lm}from"./chunk-5NTWGUSJ.js";import{n as cc}from"./chunk-VHHKS7S4.js";import{a as Hm,b as zm,d as Ps,e as Ym}from"./chunk-5XPXYOWB.js";import"./chunk-XVTD6I34.js";import"./chunk-QAWKN2N4.js";import"./chunk-MTX4UPNB.js";import{a as At}from"./chunk-PA3KFAXH.js";import{a as bm,c as km}from"./chunk-GVMV3TWS.js";import{d as Sm,e as sc,h as Am,i as Em}from"./chunk-LLJZMS23.js";import{a as oc}from"./chunk-LNY6N73E.js";import"./chunk-P5RTEJUB.js";import{a as Pa,b as wg}from"./chunk-RKPAVWXF.js";import{$ as Bu,A as Ga,Aa as lm,B as hu,Ba as tc,C as yu,Ca as gm,D as wu,Da as ti,E as $u,Ea as Jn,F as bu,Fa as oi,G as zr,Ga as nc,H as ku,Ha as um,I as vu,J as xu,K as Su,L as Au,M as Eu,N as Ru,O as Yr,P as Ou,Q as ju,R as _u,S as Du,T as Pu,U as Mu,V as za,W as Lu,X as Fu,Y as qu,Z as Uu,_ as Wu,a as Eg,aa as Ju,b as Rg,ba as Gu,ca as Qu,da as Kr,ea as go,fa as Eo,ga as Un,h as _r,ha as Qr,i as Ng,ia as Zr,j as Ns,ja as Qa,k as Dr,ka as Zu,l as jg,la as em,m as Dg,ma as tm,n as zg,na as om,o as Yg,oa as nm,p as Ur,pa as sm,q as Ua,qa as Wn,r as tu,ra as Bn,s as du,sa as rm,t as gu,ta as _s,u as uu,ua as im,v as Ba,va as st,w as mu,wa as ei,x as pu,xa as Ds,y as Ja,ya as Za,z as fu,za as am}from"./chunk-MKLRCNOX.js";import{$a as Xu,Aa as Is,Da as Ya,Ea as Vr,Fa as Hu,Gb as Qt,Ib as dm,Ma as Ao,Na as zu,Oa as Va,P as au,Qa as Xa,R as Gr,S as cu,Sa as Yu,Ta as Vu,Ua as js,V as lu,W as Hr,Ya as Xr,ab as Ku,bb as Ka,da as Cu,ea as Ha,ga as Tu,rb as cm,sb as ec,v as _g}from"./chunk-SRUIUZOC.js";import"./chunk-GTJIKXDB.js";import{a as Cg,c as La,e as Tg,f as Og}from"./chunk-2NLPGLLL.js";import{F as Lr,G as Gg,H as Hg,a as Da,b as mg,e as pg,f as fg,n as Pr,o as Mr,p as Pg,q as Mg,r as Lg,t as Fg,u as qg,w as Ug,x as Wg,y as Bg,z as Jg}from"./chunk-QH3RKKD3.js";import"./chunk-JYSJDHNS.js";import"./chunk-IMLAPB7G.js";import"./chunk-ZVP6GB4G.js";import{c as Xg,e as Fr,g as qr}from"./chunk-LQE73AZR.js";import{a as Kg,b as Qg,c as Zg,d as eu}from"./chunk-2D3RYIDU.js";import"./chunk-MRIVENBY.js";import"./chunk-BNOGNRAM.js";import{a as ou,b as Xo,c as nu,d as Wr,g as su,h as ru,j as iu,k as Wa,n as Br,o as Ko,p as Jr}from"./chunk-LQS27HSV.js";import"./chunk-PPUN7YHA.js";import"./chunk-VZLIBDLH.js";import{a as Nu,b as Iu}from"./chunk-EKJG63EJ.js";import{a as Fa,p as Ig}from"./chunk-KPNAXVET.js";import"./chunk-2AXFYDWF.js";import"./chunk-AQASR6KR.js";import{b as St}from"./chunk-EMGB23H5.js";import{c as Vg}from"./chunk-6V5JBHUN.js";import"./chunk-2VDO2HEK.js";import"./chunk-JWDJMFU6.js";import{b as qa}from"./chunk-5HLD66CW.js";import"./chunk-IS2IWRP7.js";import{a as Kt}from"./chunk-MNG2AMKZ.js";import"./chunk-X7UQY7CH.js";import{a as Ma,e as $g,f as bg,h as kg,i as vg,k as xg,l as Sg,m as Ag}from"./chunk-E4O32ZYZ.js";import{b as qn,e as yg}from"./chunk-PYHR4HXO.js";import{c as hg}from"./chunk-KP7KDLZ2.js";import"./chunk-A5GYG56I.js";import{A as Ia,B as Kd,N as So,T as dg,g as Bd,r as Jd,ra as ug}from"./chunk-LSDUL7EW.js";import{F as cg,U as lg,W as gg,b as jn,g as _n,h as Ir,i as jr,j as Dn,k as Qd,l as vo,n as xo}from"./chunk-PVWHEPF3.js";import{b as Yo}from"./chunk-MEFPXHQJ.js";import"./chunk-FM6RZI52.js";import"./chunk-SFQUP3BP.js";import"./chunk-6TTGRTDO.js";import{c as eg}from"./chunk-SZDACK6O.js";import{f as tg,g as og,h as ja}from"./chunk-VE3SSOQX.js";import"./chunk-W4YR2RO2.js";import"./chunk-AFRHKA7B.js";import{e as sg,f as Vo,k as Mn}from"./chunk-5TTHN7DP.js";import{a as Vd,k as ng}from"./chunk-OYPKAYCH.js";import{a as Ln,b as ge,c as Je,d as Fn,e as rg}from"./chunk-EWBUH2IU.js";import{a as ig,b as _a,h as ag}from"./chunk-3UOTLMXD.js";import{f as Hd,g as zd}from"./chunk-36AXN6ZB.js";import"./chunk-PE5V2LI7.js";import{a as Na,b as Yd}from"./chunk-GQ76J72O.js";import"./chunk-ILEC3IAV.js";import"./chunk-J3SOEFRE.js";import"./chunk-SIU6STB2.js";import{j as Xd}from"./chunk-X5C5W3E4.js";import{a as Pn}from"./chunk-GV7S5BAX.js";import{e as Zd}from"./chunk-GSX4NK2N.js";import"./chunk-VWTBHLMX.js";import{a as Oa}from"./chunk-BY2AAMOO.js";import"./chunk-3ZMVYNFH.js";import{c as Gd}from"./chunk-OWNQ2FD4.js";import"./chunk-KEXBEUSU.js";import"./chunk-ROLSSYXE.js";import"./chunk-DNPL3YOH.js";import"./chunk-6QZKQUAT.js";import{g as ko,i as Nr}from"./chunk-B3I4EBLE.js";import"./chunk-WPNRDEHW.js";import"./chunk-MWNCS57L.js";import"./chunk-4LWFJ4MZ.js";import"./chunk-BIJHMWXK.js";import"./chunk-4UMMAI3Z.js";import{a as Sa,b as wd,c as J$,d as Ar,e as $d,f as Dd,g as Q$,h as Pd,i as Z$,m as In,n as Ld,q as Fd,u as qd,y as Xt,z as Os}from"./chunk-FEF432WU.js";import{a as lo,b as Nn,e as Id,f as Ts}from"./chunk-72SZI2UW.js";import"./chunk-FCPTN6NF.js";import{a as Or,b as Md}from"./chunk-MCI3DIWW.js";import"./chunk-MYVHVJWZ.js";import{g as bo,i as Ud}from"./chunk-6TURWSMN.js";import{n as Wd}from"./chunk-AV7T3SYT.js";import"./chunk-TM2TPQKH.js";import"./chunk-BERWTVG2.js";import"./chunk-QOYAX2FT.js";import"./chunk-OSH2PEBH.js";import"./chunk-6QLRRSKU.js";import{a as Vt,b as B$}from"./chunk-7I7IEX4S.js";import"./chunk-JHCI6XCJ.js";import"./chunk-DSYKYZMT.js";import{Ba as Od,Ca as Ra,Ea as Ca,J as Ad,K as z$,La as V$,Ma as Ta,Oa as Nd,P as Er,Pa as X$,Q as Rr,T as Ed,U as Rd,V as Ea,W as Cd,aa as Td,ba as Y$,db as Cr,eb as Cs,fb as C,h as bd,hb as Tr,i as kd,j as vd,k as xd,l as Sd,m as G$,ob as se,v as Aa,w as H$}from"./chunk-O5H6BCUN.js";import"./chunk-BRK6M6LA.js";import{f as xt,n as Rs}from"./chunk-UIBUZ2N3.js";import"./chunk-2QNT5JDS.js";import{g as jd,k as _d,l as K$}from"./chunk-RGDKHYY2.js";import"./chunk-QIJLFPWE.js";import{Command as eb}from"commander";var ep=new eb().name("a2a").description("start an A2A (Agent-to-Agent) protocol server for external agent integration").option("--port <port>","server port","3171").option("--host <host>","server host","0.0.0.0").option("-p, --provider <provider>","AI provider","claude-code").option("-m, --model <model>","model to use").option("--api-key <key>","API key for the provider").option("-c, --cwd <cwd>","working directory",process.cwd()).option("--no-cors","disable CORS headers").action(async e=>{await new Rg({port:parseInt(e.port,10),host:e.host,provider:e.provider,model:e.model,apiKey:e.apiKey,cwd:e.cwd,cors:e.cors!==!1}).start()});se();import{Command as tb}from"commander";import{execFileSync as jt}from"node:child_process";import{cpSync as tp,existsSync as gc,mkdirSync as lc,mkdtempSync as ob,readdirSync as nb,rmSync as op,writeFileSync as np}from"node:fs";import{dirname as sp,join as rt}from"node:path";import{homedir as ii,release as sb,tmpdir as rb}from"node:os";import{setTimeout as ib}from"node:timers/promises";function ai(){let e=Pg(process.platform,process.arch,sb());if(e)throw new Error(e)}function ci(){let e=rt(ii(),"Library/LaunchAgents"),t=[];try{t=nb(e).filter(Fg)}catch{}let o=t.flatMap(n=>{let s=rt(e,n);try{return[{file:s,plist:jt("plutil",["-convert","xml1","-o","-",s],{encoding:"utf8",stdio:["ignore","pipe","ignore"]})}]}catch{return[]}});return qg(e,o)}function Ms(e){return`gui/${process.getuid()}/${e.label}`}async function dc(e){try{jt("launchctl",["bootout",Ms(e)],{stdio:"pipe"})}catch{}for(let t=0;t<30;t++){try{jt("launchctl",["print",Ms(e)],{stdio:"pipe"})}catch{return}await ib(200)}throw new Error("The desktop login service did not stop. Retry agentx desktop stop before installing.")}function rp(e){if(!gc(e.file))throw new Error("Run agentx desktop install first.");let t=!0;try{jt("launchctl",["print",Ms(e)],{stdio:"pipe"})}catch{t=!1}t||jt("launchctl",["bootstrap",`gui/${process.getuid()}`,e.file],{stdio:"pipe"}),jt("launchctl",["kickstart",Ms(e)],{stdio:"pipe"})}function ab(){let e=Jg();if(e&&gc(rt(e,"apps/mac-voice/build.sh")))return e;throw new Error("Desktop sources are missing from this installation. Update AgentX to a release containing apps/mac-voice and apps/mac-helper.")}var Gn=new tb("desktop").description("install and control the macOS desktop assistant");Gn.command("install").description("build, install, and start voice and computer-use helpers at login").option("--agent <id>","pin this agent; without it, pick the agent from the menu-bar icon").option("--dry-run","show the installation plan without building or changing login items").action(async e=>{ai();let t=C(),o=Mg(t.agents,e.agent),n=e.agent,s=t.dashboard?.daemonUrl||`http://${t.node.bind.replace(/^0\.0\.0\.0:/,"127.0.0.1:")}`,r=ab(),i=rt(ii(),"Applications"),{keep:a,remove:c}=ci();if(console.log(`Desktop assistant \u2192 ${rt(i,Pr)}
|
|
2
2
|
Computer-use helper \u2192 ${rt(i,Mr)}
|
|
3
3
|
Agent \u2192 ${n?`${o} (pinned)`:"picked from the menu-bar icon"}
|
|
4
4
|
Daemon \u2192 ${s}
|
|
@@ -508,7 +508,7 @@ return aid ?? null`}function n0(e,t){if(e.kind==="path"){let s=e.pts,r=s[Math.fl
|
|
|
508
508
|
Plan ${L.dim(`[${s.state}] by ${s.createdBy}, ${$n(s.createdAt)}`)}`),my(n.steps(e)),console.log(`
|
|
509
509
|
Log`);for(let r of n.events(e))console.log(L.dim(` ${$n(r.at)} ${r.step?`step ${r.step} `:""}${r.kind}: ${r.detail}`))}});Fo.command("step <id> <step>").description("move a step of a request's plan on: --retry, --skip or --done").option("--retry","hand the step to its agent again, with a fresh count of nudges (approves a message whose card expired)").option("--skip","leave the step out; the plan goes on with the next one").option("--done","mark the step done yourself").option("--note <text>","why, or the evidence for --done").action((e,t,o)=>{let n=["retry","skip","done"].filter(c=>o[c]);if(n.length!==1){console.error(L.red(" give one of --retry, --skip or --done")),process.exitCode=1;return}let s=rr();if(!s)return;let r=zi();if(!r){process.exitCode=1;return}let i=Number(t),a=ku(s,r,{requestId:e,step:i,action:n[0],detail:o.note},Date.now());if(a){console.error(L.red(` ${a}`)),process.exitCode=1;return}console.log(L.green(` \u2713 step ${i} of ${e}: ${n[0]==="retry"?"handed over again":n[0]==="skip"?"skipped":"done"}`)+L.dim(" (the daemon goes on within a minute)")),my(r.steps(e))});function py(e,t,o,n){let s=Fo.command(`${e} <id>`).description(t).option(o,e==="done"?"link to the proof: PR, issue, message, deploy":"why it is dropped");e==="done"&&s.option("--reason <text>",'close it by hand without a link, saying why ("checked by hand"); also closes a loop its check cannot verify'),s.action((r,i)=>{let a=rr();if(!a)return;let c=e==="done"?i.evidence??(i.reason?`closed by owner: ${i.reason}`:void 0):i.reason??"dropped by the owner";if(!c){console.error(L.red(` ${n}`)),process.exitCode=1;return}let l=a.get(r);if(!l||l.state==="candidate"){console.error(L.red(` no request "${r}"`)),process.exitCode=1;return}if(!a.close(r,e==="done"?"done":"dropped",c,Date.now())){console.error(L.red(` ${r} is already closed (${bl[l.state]??l.state})`)),process.exitCode=1;return}console.log(L.green(` \u2713 ${r} ${e==="done"?"closed as done":"dropped"}`))})}py("done","close a request as finished, with a link to the evidence or the reason","--evidence <link>","a finished request needs --evidence <link> or --reason <text>");py("drop","drop a request you no longer want","--reason <text>","");Fo.command("settings").description("show or change the requests settings").option("--enabled <on|off>","record and follow your requests").option("--from <id,...>",'who counts as you on channels other people can reach, as channel:id (your login on GitLab and GitHub, your sender id elsewhere); "none" to clear').option("--channels <name,...>",'channels to record on; "all" for every channel a person writes on').option("--stale-hours <n>","hours without activity before an open request comes back to you").option("--retention-days <n>","days a closed request is kept").option("--headlines <on|off>","write a headline for a request its agent did not describe (one small model call each)").option("--catch <on|off>","read the reply of each of your turns for a promise or a question to you (one small model call each)").option("--catch-cap <n>","model calls a day the promise catch may make").option("--settle <on|off>","close a quiet request whose handed work all came back done, instead of bringing it back to you").option("--plans <on|off>","follow requests of two or more steps as tracked plans").option("--stall-minutes <n>","minutes without progress before a plan step's agent is nudged").option("--max-nudges <n>","nudges per step before it counts as blocked and you are told").option("--approve-kinds <kind,...>",'step kinds you approve once when the plan is made; "none" to clear').option("--plans-off-for <agent,...>",'agents that may not open a plan; "none" to clear').option("--plan-for <work,...>",'kinds of work an agent must plan before it starts (default code); "none" to clear').option("--plan-over <minutes>","work estimated over this many minutes needs a plan (default 30); 0 turns it off").option("--checks <kind,...>",`checks agents may use to close a loop (${Er.join(", ")}); "none" to turn them all off`).option("--check-every <minutes>","how often each open loop's check runs").action(async e=>{let t={};try{let l=(u,h)=>{if(h===void 0)return;let y=Number(h);if(!(y>0))throw new Error(`${u} must be a positive number`);return y},g=(u,h)=>u===void 0?void 0:u===h?[]:u.split(",").map(y=>y.trim()).filter(Boolean);if(e.enabled!==void 0){if(e.enabled!=="on"&&e.enabled!=="off")throw new Error("--enabled takes on or off");t.enabled=e.enabled==="on"}if(t.from=g(e.from,"none"),t.channels=g(e.channels,"all"),t.staleAfterHours=l("--stale-hours",e.staleHours),t.retentionDays=l("--retention-days",e.retentionDays),e.headlines!==void 0){if(e.headlines!=="on"&&e.headlines!=="off")throw new Error("--headlines takes on or off");t.headlines={enabled:e.headlines==="on"}}if(e.catch!==void 0||e.catchCap!==void 0){if(e.catch!==void 0&&e.catch!=="on"&&e.catch!=="off")throw new Error("--catch takes on or off");let u=l("--catch-cap",e.catchCap);if(u!==void 0&&!Number.isInteger(u))throw new Error("--catch-cap must be a whole number");t.catchPromises={...e.catch!==void 0?{enabled:e.catch==="on"}:{},...u!==void 0?{dailyCap:u}:{}}}if(e.settle!==void 0){if(e.settle!=="on"&&e.settle!=="off")throw new Error("--settle takes on or off");t.settleHandedBack=e.settle==="on"}let d={};if(e.plans!==void 0){if(e.plans!=="on"&&e.plans!=="off")throw new Error("--plans takes on or off");d.enabled=e.plans==="on"}if(d.stallMinutes=l("--stall-minutes",e.stallMinutes),e.maxNudges!==void 0){let u=Number(e.maxNudges);if(!Number.isInteger(u)||u<0)throw new Error("--max-nudges must be a whole number, 0 or more");d.maxNudges=u}if(d.approveKinds=g(e.approveKinds,"none"),d.disabledAgents=g(e.plansOffFor,"none"),d.requireForWork=g(e.planFor,"none"),e.planOver!==void 0){let u=Number(e.planOver);if(!(u>=0))throw new Error("--plan-over must be a number of minutes, 0 or more");d.requireOverMinutes=u}Object.values(d).some(u=>u!==void 0)&&(t.plans=d);let f={},p=g(e.checks,"none");if(p){let u=p.filter(h=>!Er.includes(h));if(u.length)throw new Error(`unknown check ${u.join(", ")}: use ${Er.join(", ")}`);f.enabled=p}f.checkEveryMinutes=l("--check-every",e.checkEvery),Object.values(f).some(u=>u!==void 0)&&(t.checkers=f)}catch(l){console.error(L.red(` ${l.message}`)),process.exitCode=1;return}if(Object.values(t).some(l=>l!==void 0)){let l=await cu(t);if(!l.success){console.error(L.red(` ${l.error}`)),process.exitCode=1;return}console.log(L.green(" \u2713 saved")+(l.reloaded?L.dim(" (daemon reloaded)"):""))}let o=Gr();console.log(` Requests ${o.enabled?"on":"off"}`),console.log(` Channels ${o.channels.length?o.channels.join(", "):"every channel a person writes on"}`),console.log(` Counts as you ${o.from.length?o.from.join(", "):"only voice, the app and the dashboard on this machine"}`),console.log(` Comes back after ${o.staleAfterHours} hour(s) without activity`),console.log(` Closed requests kept ${o.retentionDays} day(s)`),console.log(` Headlines ${o.headlines?.enabled===!1?"off: titled with the start of your words":"on: written when the agent gave none"}`);let n=o.catchPromises;console.log(` Catch promises ${n?.enabled?`on: each of your turns' reply is read, up to ${n.dailyCap} call(s) a day`:"off"}`),console.log(` Handed work came back ${o.settleHandedBack===!1?"comes back to you when quiet":"closed when quiet, with its link or marked unproven"}`);let s=o.plans??zr;console.log(` Plans ${s.enabled?"on":"off"}`),console.log(` Nudge a quiet step after ${s.stallMinutes} minute(s), up to ${s.maxNudges} time(s)`),console.log(` You approve up front ${s.approveKinds.length?s.approveKinds.join(", "):"nothing"}`),console.log(` Plans off for ${s.disabledAgents.length?s.disabledAgents.join(", "):"no agent"}`);let r=s.requireOverMinutes??zr.requireOverMinutes,i=s.requireForWork??zr.requireForWork;console.log(` Plan before starting ${[i.length?`${i.join(", ")} work`:"",r>0?`work over ${r} minute(s)`:""].filter(Boolean).join("; ")||"never required"}`);let a=o.checkers??Rr;console.log(` Loop checks ${a.enabled.length?a.enabled.join(", "):"off"}, every ${a.checkEveryMinutes} minute(s)`);let c=Object.keys(a.repos);console.log(` Repos for git-ancestor ${c.length?c.join(", "):"none (requests.checkers.repos in agentx.json)"}`)});import{Command as FS}from"commander";import ds from"chalk";se();var fy=new FS("request-status").description("show each person the state of their request in the thread where they asked (GitLab, GitHub)").argument("[channel]",ic.join(" or ")).argument("[state]","on or off").action(async(e,t)=>{if(e!==void 0){t!=="on"&&t!=="off"&&(console.error(ds.red("\u2717 say on or off, for example: agentx request-status gitlab on")),process.exit(1));let n="",s=await ge(r=>{n=Dm(r,e,t==="on")});s.success||(console.error(ds.red(`\u2717 ${s.error}`)),process.exit(1)),console.log(ds.green(`\u2713 ${n}`)),s.reloaded&&console.log(ds.dim(" daemon hot-reloaded"))}let o=C().requestStatus.channels.map(n=>n.toLowerCase());for(let n of ic)console.log(` ${n.padEnd(8)} ${o.includes(n)?ds.green("on"):ds.dim("off")}`)});import{Command as cA}from"commander";import gs from"chalk";import ye from"chalk";import ar from"prompts";import{readFileSync as qS,writeFileSync as US,existsSync as WS}from"fs";import{resolve as hy}from"path";var BS=/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/;function JS(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1):t}function vl(e){return/[\s#"'\\]/.test(e)||e===""?JSON.stringify(e):e}function yy(e=".env"){let t=hy(e);if(!WS(t))return[];let o=qS(t,"utf-8"),n=[];for(let s of o.split(/\r?\n/)){if(s.trim()===""){n.push({kind:"blank",raw:s});continue}if(s.trim().startsWith("#")){n.push({kind:"comment",raw:s});continue}let r=s.match(BS);r?n.push({kind:"kv",key:r[1],value:JS(r[2]),raw:s}):n.push({kind:"comment",raw:s})}return n.length&&n[n.length-1].kind==="blank"&&n.pop(),n}function GS(e){return e.map(t=>t.kind==="kv"?`${t.key}=${vl(t.value)}`:t.raw).join(`
|
|
510
510
|
`)+`
|
|
511
|
-
`}function ir(e,t,o=".env"){let n=hy(o),s=yy(n),r=s.findIndex(i=>i.kind==="kv"&&i.key===e);r>=0?s[r]={kind:"kv",key:e,value:t,raw:`${e}=${vl(t)}`}:(s.length&&s[s.length-1].kind!=="blank"&&s.push({kind:"blank",raw:""}),s.push({kind:"kv",key:e,value:t,raw:`${e}=${vl(t)}`})),US(n,GS(s))}function xl(e,t=".env"){return yy(t).find(s=>s.kind==="kv"&&s.key===e)?.value}var wy="https://t.me/BotFather";async function HS(e){try{let t=await fetch(`https://api.telegram.org/bot${e}/getMe`,{signal:AbortSignal.timeout(8e3)});if(!t.ok)return null;let o=await t.json();return o?.ok?o.result:null}catch{return null}}async function zS(e,t){let o=Date.now()+t,n=0;try{let r=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=-1&timeout=0`,{signal:AbortSignal.timeout(5e3)})).json();r?.result?.length&&(n=r.result[0].update_id+1)}catch{}for(;Date.now()<o;)try{let r=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=${n}&timeout=10`,{signal:AbortSignal.timeout(15e3)})).json();for(let i of r?.result||[]){n=Math.max(n,i.update_id+1);let a=i.message||i.edited_message||i.channel_post;if(a?.chat?.id)return{chatId:a.chat.id,chatTitle:a.chat.title||a.chat.username||a.chat.first_name,from:a.from?.first_name||a.from?.username||"unknown"}}}catch{}return null}async function $y(e={}){console.log(),console.log(ye.bold(" Connect Telegram")),console.log(),console.log(ye.dim(` 1. Open ${wy}`)),console.log(ye.dim(" /newbot (or /mybots \u2192 pick existing \u2192 API Token)")),console.log(ye.dim(" 2. Copy the HTTP API token \u2014 looks like 123456789:ABCdef...")),console.log();let{wantsBrowser:t}=await ar({type:"confirm",name:"wantsBrowser",message:"Open BotFather in your browser?",initial:!0});t&&en(wy);let{token:o}=await ar({type:"password",name:"token",message:"Paste the bot token from BotFather:",validate:b=>/^\d+:[A-Za-z0-9_-]{20,}$/.test(b.trim())||"That doesn't look like a Telegram token"});o||(console.log(ye.red(" Aborted")),process.exit(1)),process.stdout.write(" Verifying token... ");let n=await HS(o.trim());n||(console.log(ye.red("\u2717 invalid or revoked")),process.exit(1)),console.log(ye.green(`\u2713 ${n.first_name} (@${n.username})`));let{readFileSync:s,existsSync:r}=await import("fs"),{resolve:i}=await import("path"),a=e.configPath||i(process.cwd(),"agentx.json");r(a)||(console.log(ye.red(` No agentx.json at ${a}. Run: agentx init`)),process.exit(1));let c=JSON.parse(s(a,"utf-8")),l=Object.keys(c.agents||{});l.length===0&&(console.log(ye.red(" No agents configured. Run: agentx agent add")),process.exit(1));let g=e.agent;g||(g=(await ar({type:"select",name:"agent",message:"Bind this bot to which agent?",choices:l.map(v=>({title:v,value:v})),initial:0})).agent),g||(console.log(ye.red(" Aborted")),process.exit(1));let d=c.channels?.telegram?.accounts||{},f=e.account||g;d[f]&&d[f].agentBinding!==g&&(f=(await ar({type:"text",name:"account",message:`Account "${f}" is already in use. Pick a different label:`,initial:`${g}-2`,validate:v=>/^[a-z0-9-]+$/i.test(v)||"lowercase letters, digits, hyphens only"})).account),f||(console.log(ye.red(" Aborted")),process.exit(1));let p=`TG_${f.toUpperCase().replace(/-/g,"_")}_BOT_TOKEN`;ir(p,o.trim()),process.env[p]=o.trim();let u=await ge(b=>{Je(b,"channels.telegram.enabled",!0),Je(b,`channels.telegram.accounts.${f}`,{token:`\${${p}}`,agentBinding:g});let v=Fn(b,`agents.${g}.mentions`)||[],x=`@${n.username}`;v.includes(x)||(v.push(x),Je(b,`agents.${g}.mentions`,v))},{configPath:e.configPath});if(u.success||(console.log(ye.red(` \u2717 ${u.error}`)),process.exit(1)),console.log(),console.log(ye.green(` \u2713 Bot @${n.username} bound to agent "${g}"`)),console.log(ye.dim(` Token stored in .env as ${p}`)),console.log(ye.dim(` Mentions updated to include @${n.username}`)),u.reloaded?console.log(ye.dim(" Daemon hot-reloaded.")):console.log(ye.dim(" Start the daemon to begin polling (agentx daemon start)")),e.skipChatCapture)return;console.log();let{capture:h}=await ar({type:"confirm",name:"capture",message:"Listen for a message so we can set this as your default --notify target?",initial:!0});if(!h)return;console.log(),console.log(ye.dim(` Send any message to @${n.username} from the chat you want to use.`)),console.log(ye.dim(" Waiting up to 90s..."));let y=await zS(o.trim(),9e4);if(!y){console.log(ye.yellow(" No message received \u2014 skipping. You can set it later with:")),console.log(ye.dim(" agentx config set notifications.destination.channel telegram")),console.log(ye.dim(" agentx config set notifications.destination.chatId <chatId>")),console.log(ye.dim(` agentx config set notifications.destination.accountId ${f}`));return}let $=await ge(b=>{Je(b,"notifications.destination",{channel:"telegram",chatId:String(y.chatId),accountId:f})},{configPath:e.configPath});if(!$.success){console.log(ye.red(` \u2717 failed to save destination: ${$.error}`));return}console.log(ye.green(" \u2713 Default --notify target set")),console.log(ye.dim(` Chat: ${y.chatTitle||y.chatId} (from ${y.from})`)),console.log(ye.dim(" From now on, --notify me resolves to this chat.")),$.reloaded&&console.log(ye.dim(" Daemon hot-reloaded."))}import Ce from"chalk";import Sl from"prompts";import{existsSync as El,mkdirSync as YS,readdirSync as VS,readFileSync as by}from"fs";import{resolve as Al}from"path";var XS=".agentx/whatsapp-sessions";function KS(){let e=Al(process.cwd(),".agentx/daemon.pid");if(!El(e))return!1;try{let t=parseInt(by(e,"utf-8").trim(),10);return t?(process.kill(t,0),!0):!1}catch{return!1}}function QS(e){if(!El(e))return!1;try{return VS(e).some(t=>t.includes("creds")||t.endsWith(".json"))}catch{return!1}}async function ZS(e,t){let o;try{o=await import("@whiskeysockets/baileys")}catch{return t(Ce.red(" WhatsApp pairing needs @whiskeysockets/baileys.")),t(Ce.red(" Install with: pnpm add @whiskeysockets/baileys (or npm install)")),!1}let{makeWASocket:n,useMultiFileAuthState:s}=o.default||o;YS(e,{recursive:!0});let{state:r,saveCreds:i}=await s(e),a;try{a=(await o.fetchLatestBaileysVersion()).version}catch{}let c={level:"silent",trace:()=>{},debug:()=>{},info:()=>{},warn:()=>{},fatal:()=>{},error:()=>{},child:()=>c},l=n({auth:{creds:r.creds,keys:o.makeCacheableSignalKeyStore?o.makeCacheableSignalKeyStore(r.keys,c):r.keys},...a?{version:a}:{},logger:c,printQRInTerminal:!1,browser:["agentx-connect","pairing","1.0"],syncFullHistory:!1,markOnlineOnConnect:!1});return l.ev.on("creds.update",i),await new Promise(g=>{let f=setTimeout(()=>{t(Ce.yellow(" Timed out waiting for scan (2min)."));try{l.end(void 0)}catch{}g(!1)},12e4);l.ev.on("connection.update",async p=>{if(p.qr){t(Ce.dim(" Scan this QR with WhatsApp \u2192 Linked devices \u2192 Link a device:")),t("");try{let{default:u}=await import("qrcode-terminal");u.generate(p.qr,{small:!0})}catch{t(` QR: ${p.qr}`)}t("")}if(p.connection==="open"){clearTimeout(f),t(Ce.green(" \u2713 Paired"));try{l.end(void 0)}catch{}g(!0)}p.connection==="close"&&!p.qr&&p.lastDisconnect?.error?.output?.statusCode===401&&(clearTimeout(f),t(Ce.red(" \u2717 Authorization failed \u2014 rescan required")),g(!1))})})}async function ky(e={}){if(console.log(),console.log(Ce.bold(" Connect WhatsApp")),console.log(),KS()){console.log(Ce.yellow(" \u26A0 The daemon is running. Stop it first so pairing can open a fresh Baileys session:")),console.log(Ce.dim(" agentx daemon stop")),console.log();let{cont:l}=await Sl({type:"confirm",name:"cont",message:"Continue anyway? (expect errors)",initial:!1});l||(console.log(Ce.red(" Aborted")),process.exit(1))}let t=e.configPath||Al(process.cwd(),"agentx.json");El(t)||(console.log(Ce.red(` No agentx.json at ${t}. Run: agentx init`)),process.exit(1));let o=JSON.parse(by(t,"utf-8")),n=e.sessionDir||o.channels?.whatsapp?.sessionDir||XS,s=Al(process.cwd(),n),r=Object.keys(o.agents||{});r.length===0&&(console.log(Ce.red(" No agents configured. Run: agentx agent add")),process.exit(1));let i=e.agent;i||(i=(await Sl({type:"select",name:"agent",message:"Default agent for incoming messages:",choices:r.map(g=>({title:g,value:g})),initial:0})).agent),i||(console.log(Ce.red(" Aborted")),process.exit(1));let a=!e.skipPair;if(QS(s)&&a){let{keep:l}=await Sl({type:"confirm",name:"keep",message:`An existing session was found at ${n}. Keep it (recommended), or pair again?`,initial:!0});a=!l,l&&console.log(Ce.dim(" Keeping existing session \u2014 skipping QR pair."))}a&&(await ZS(s,g=>console.log(g))||(console.log(Ce.red(" Pairing failed. You can retry with `agentx connect whatsapp`.")),process.exit(1)));let c=await ge(l=>{Je(l,"channels.whatsapp.enabled",!0),Je(l,"channels.whatsapp.sessionDir",n),Je(l,"channels.whatsapp.defaultAgent",i)},{configPath:e.configPath});c.success||(console.log(Ce.red(` \u2717 ${c.error}`)),process.exit(1)),console.log(),console.log(Ce.green(` \u2713 WhatsApp bound to agent "${i}"`)),console.log(Ce.dim(` Session: ${n}`)),console.log(Ce.dim(" Start the daemon to begin receiving:")),console.log(Ce.dim(" agentx daemon start")),console.log(Ce.yellow(" No chat is answered until you list the allowed numbers (add your own to talk from your self-chat):")),console.log(Ce.dim(` agentx config set channels.whatsapp.allowFrom '["+15550001111"]'`)),console.log(Ce.dim(" Add routes later with:")),console.log(Ce.dim(` agentx config set channels.whatsapp.routes '[{"contact":"+1234567890","agent":"${i}"}]'`)),console.log()}import{randomBytes as eA}from"crypto";import We from"chalk";import vy from"prompts";var Yi="agentx-mesh:",Vi="//join/";function tA(e){return Buffer.from(e,"utf-8").toString("base64url")}function oA(e){return Buffer.from(e,"base64url").toString("utf-8")}function nA(e){return`${Yi}${Vi}${tA(JSON.stringify(e))}`}function sA(e){if(!e.startsWith(`${Yi}${Vi}`))throw new Error(`Not a mesh invite link \u2014 expected ${Yi}${Vi}\u2026`);let t=e.slice(Yi.length+Vi.length),o=JSON.parse(oA(t));if(o.version!==1)throw new Error(`Unsupported invite version: ${o.version}`);if(typeof o.url!="string"||typeof o.token!="string"||typeof o.name!="string")throw new Error("Invite payload missing required fields (url, token, name)");return o}function rA(){return eA(32).toString("hex")}function iA(e){let t=e?.node?.bind||"127.0.0.1:18800",[o,n]=t.split(":");return`http://${o}:${n}`}function aA(e){return e?.node?.name||e?.node?.id||"node"}async function xy(e){let{readFileSync:t,existsSync:o}=await import("fs"),{resolve:n}=await import("path"),s=e.configPath||n(process.cwd(),"agentx.json");o(s)||(console.log(We.red(` No agentx.json at ${s}. Run: agentx init`)),process.exit(1));let r=JSON.parse(t(s,"utf-8")),i=xl("MESH_TOKEN");i||(i=rA(),ir("MESH_TOKEN",i),console.log(We.dim(" Generated new MESH_TOKEN (32 bytes) and saved to .env")));let a=e.url||iA(r);if((a.includes("0.0.0.0")||a.includes("127.0.0.1")||a.includes("localhost"))&&!e.url){let{url:d}=await vy({type:"text",name:"url",message:"This node's URL as peers should reach it (e.g. http://100.x.x.x:18800):",initial:a,validate:f=>/^https?:\/\//.test(f)||"must start with http:// or https://"});d||(console.log(We.red(" Aborted")),process.exit(1)),a=d}let l=await ge(d=>{Je(d,"mesh.enabled",!0)},{configPath:e.configPath});l.success||(console.log(We.red(` \u2717 ${l.error}`)),process.exit(1));let g=nA({url:a,token:i,name:aA(r),version:1});console.log(),console.log(We.bold(" Mesh invite")),console.log(),console.log(` ${We.cyan(g)}`),console.log(),console.log(We.dim(" Run on the other node:")),console.log(We.dim(` agentx connect mesh join "${g}"`)),console.log(),console.log(We.yellow(" Share over a trusted channel only \u2014 whoever holds this link can join your mesh.")),console.log()}async function Sy(e,t={}){let o;try{o=sA(e)}catch(r){console.log(We.red(` \u2717 ${r.message}`)),process.exit(1)}let n=xl("MESH_TOKEN");if(n&&n!==o.token){let{overwrite:r}=await vy({type:"confirm",name:"overwrite",message:"A different MESH_TOKEN already exists in .env. Overwrite with the invite's token?",initial:!1});r||(console.log(We.red(" Aborted (keeping existing .env)")),process.exit(1))}ir("MESH_TOKEN",o.token);let s=await ge(r=>{Je(r,"mesh.enabled",!0);let i=Fn(r,"mesh.peers")||[],a=i.findIndex(l=>l.name===o.name),c={name:o.name,url:o.url,token:"${MESH_TOKEN}"};a>=0?i[a]=c:i.push(c),Je(r,"mesh.peers",i)},{configPath:t.configPath});s.success||(console.log(We.red(` \u2717 ${s.error}`)),process.exit(1)),console.log(We.green(" \u2713 Joined mesh")),console.log(We.dim(` Peer: ${o.name} @ ${o.url}`)),console.log(We.dim(" Shared token stored in .env as MESH_TOKEN")),s.reloaded?console.log(We.dim(" Daemon hot-reloaded.")):console.log(We.dim(" Restart the daemon to start the mesh (agentx daemon start).")),console.log();try{let r=await fetch(`${o.url.replace(/\/$/,"")}/.well-known/agent-card.json`,{signal:AbortSignal.timeout(5e3)});if(r.ok){let i=await r.json(),a=Array.isArray(i.agents)?i.agents.length:"?";console.log(We.dim(` Reachable \u2014 ${o.name} exposes ${a} agents`))}else console.log(We.yellow(` Peer returned HTTP ${r.status} \u2014 double-check the URL`))}catch(r){console.log(We.yellow(` Could not reach ${o.url} right now (${r?.cause?.code||r.message}) \u2014 verify VPN / Tailscale when the peer daemon is up`))}}var us=new cA().name("connect").description("connect a channel or mesh peer \u2014 no manual file editing required");us.command("telegram").description("pair a Telegram bot \u2014 persists token in .env, binds to an agent, auto-detects default chat").option("--agent <id>","agent to bind the bot to (skips the prompt)").option("--account <name>","account label in channels.telegram.accounts (defaults to agent id)").option("--skip-chat-capture","don't listen for the first message after pairing").option("-c, --config <path>","path to agentx.json").action(async e=>{await $y({agent:e.agent,account:e.account,configPath:e.config,skipChatCapture:!!e.skipChatCapture})});us.command("whatsapp").description("pair WhatsApp via QR (prints in terminal), then writes channels.whatsapp config").option("--agent <id>","default agent for inbound messages").option("--session-dir <path>","session directory (default: .agentx/whatsapp-sessions)").option("--skip-pair","skip QR pairing (use when session already exists)").option("-c, --config <path>","path to agentx.json").action(async e=>{await ky({agent:e.agent,sessionDir:e.sessionDir,skipPair:!!e.skipPair,configPath:e.config})});var Ay=us.command("mesh").description("mesh invite + join \u2014 replaces manual MESH_TOKEN copy-paste");Ay.command("invite").description("emit a single-use join link for another AgentX node").option("--url <url>","this node's URL as peers should reach it (Tailscale IP etc.)").option("-c, --config <path>","path to agentx.json").action(async e=>{await xy({url:e.url,configPath:e.config})});Ay.command("join <link>").description("accept an invite link from another AgentX node").option("-c, --config <path>","path to agentx.json").action(async(e,t)=>{await Sy(e,{configPath:t.config})});us.action(()=>{console.log(),console.log(gs.bold(" agentx connect \u2014 which channel?")),console.log(),console.log(` ${gs.cyan("agentx connect telegram")} \u2014 pair a Telegram bot`),console.log(` ${gs.cyan("agentx connect whatsapp")} \u2014 pair WhatsApp via QR`),console.log(` ${gs.cyan("agentx connect mesh invite")} \u2014 emit a mesh join link for another node`),console.log(` ${gs.cyan("agentx connect mesh join <link>")} \u2014 accept a mesh invite`),console.log(),console.log(gs.dim(" GitLab connect is the next slice.")),console.log()});se();import{Command as lA}from"commander";import te from"chalk";var bn=new lA().name("usage").description("token usage analysis and reporting");bn.command("today",{isDefault:!0}).description("show today's token usage").action(async()=>{try{let e=C(),[t,o]=e.node.bind.split(":"),s=await(await fetch(`http://${t||"127.0.0.1"}:${o}/usage`,{signal:AbortSignal.timeout(3e3)})).json();if(console.log(),console.log(te.bold(" Token Usage (last 7 days)")),console.log(),s.totalTasks===0){console.log(te.dim(" No tasks recorded yet")),console.log();return}let r=a=>a.toLocaleString();console.log(` Total: ${te.bold(r(s.totalTokens))} tokens across ${s.totalTasks} tasks`),console.log(` Input: ${r(s.totalInput)}`),console.log(` Output: ${r(s.totalOutput)}`),console.log(` Cache read: ${r(s.totalCacheRead)}`),console.log(` Cache create: ${r(s.totalCacheCreate)}`),s.cacheHitRatio>0&&console.log(` Cache hit: ${(s.cacheHitRatio*100).toFixed(1)}%`),s.totalErrors>0&&console.log(` Errors: ${te.red(String(s.totalErrors))}`),console.log(),console.log(te.bold(" By Agent:"));let i=Object.entries(s.byAgent||{});i.sort((a,c)=>c[1].total-a[1].total);for(let[a,c]of i){let l=r(c.total||c.input+c.output+c.cacheRead+c.cacheCreate),g=c.avgDuration?`${(c.avgDuration/1e3).toFixed(1)}s avg`:"";console.log(` ${te.cyan(a)}: ${l} tokens (${c.tasks} tasks) ${te.dim(g)}`)}console.log()}catch(e){e.cause?.code==="ECONNREFUSED"?console.log(te.red(" Daemon not running. Start with: agentx daemon start")):console.log(te.red(` ${e.message}`))}});bn.command("plan").description("show the Claude plan windows as Claude Code last reported them, and any hold on fresh sessions").option("--lift","lift the hold on fresh sessions now, without waiting for the reset time").option("--json","raw JSON output").action(async e=>{try{let t=C(),[o,n]=t.node.bind.split(":"),s=`http://${o||"127.0.0.1"}:${n}`,r=e.lift?await fetch(`${s}/usage/plan/lift`,{method:"POST",signal:AbortSignal.timeout(3e3)}):await fetch(`${s}/usage/plan`,{signal:AbortSignal.timeout(3e3)});if(!r.ok)throw new Error(`Daemon answered ${r.status}. It may be older than this command; restart it.`);let i=await r.json();if(e.json){console.log(JSON.stringify(i,null,2));return}let a=d=>d.replace(/_/g," ");if(console.log(),e.lift){let d=i.lifted.map(f=>a(f.window));console.log(d.length?` Lifted the hold on: ${d.join(", ")}. The next fresh session asks Claude again.`:te.dim(" No hold to lift.")),console.log();return}let c=i.now,l=new Set(i.holds.map(d=>d.window));console.log(te.bold(" Claude plan (as Claude Code last reported it)")),console.log(),i.provider.length===0&&console.log(te.dim(" No report yet. Claude Code reports on each turn; the list is empty after a daemon restart."));for(let d of i.provider){let f=d.usingOverage?"extra usage":d.status==="allowed_warning"?"nearly full":d.status,p=typeof d.utilization=="number"?`${Math.round(d.utilization*100)}% used`:"",u=Math.max(1,Math.round((d.resetsAt-c)/6e4)),h=d.resetsAt>c?u<60?`resets in ${u} min`:u<48*60?`resets in ${Math.round(u/60)} h`:`resets in ${Math.round(u/1440)} days`:"",y=l.has(d.window)?te.red("holding fresh sessions"):"";console.log(` ${a(d.window).padEnd(18)} ${f.padEnd(12)} ${[p,h,y].filter(Boolean).join(", ")}`)}console.log();let g=d=>d?` of ${d}`:"";console.log(` Fresh sessions started: ${i.lastHour}${g(i.maxPerHour)} in the last hour, ${i.last5h}${g(i.maxPer5h)} in the last 5 hours`),l.size&&console.log(te.dim(" To try again now: agentx usage plan --lift")),console.log()}catch(t){t.cause?.code==="ECONNREFUSED"?console.log(te.red(" Daemon not running. Start with: agentx daemon start")):console.log(te.red(` ${t.message}`))}});bn.command("report").description("run full session analysis (parses Claude Code JSONL files)").option("--days <n>","analyze last N days","7").action(async e=>{let{execSync:t}=await import("child_process"),{existsSync:o}=await import("fs"),{resolve:n}=await import("path"),s=n(process.cwd(),"scripts/token-report.py");if(!o(s)){console.log(te.red(` Script not found: ${s}`)),console.log(te.dim(" The token analyzer script should be at scripts/token-report.py"));return}console.log(te.dim(" Analyzing Claude Code sessions..."));try{t(`SINCE_DAYS=${e.days} python3 "${s}"`,{stdio:"inherit"})}catch{console.log(te.red(" Analysis failed. Is Python 3 installed?"))}});bn.command("channels").description("cost per channel over a fixed range of days, next to a saved baseline").requiredOption("--from <date>","first day, YYYY-MM-DD").requiredOption("--to <date>","last day, YYYY-MM-DD").option("--save <file>","write this range's figures to a JSON file").option("--baseline <file>","a file written by --save, shown beside this range").option("--json","raw JSON output").action(async e=>{let{readFileSync:t,writeFileSync:o}=await import("fs"),{TokenTracker:n}=await import("./token-tracker-W7DFDEFN.js"),{channelCosts:s,costPerTask:r}=await import("./usage-channels-KBLEC4NE.js"),i=u=>/^\d{4}-\d{2}-\d{2}$/.test(u)&&!Number.isNaN(Date.parse(u));if(!i(e.from)||!i(e.to)||e.from>e.to){console.log(te.red(" --from and --to must be YYYY-MM-DD, with --from not after --to")),process.exitCode=1;return}let a=s(new n,e.from,e.to);e.save&&o(e.save,JSON.stringify(a,null,2));let c=null;if(e.baseline)try{c=JSON.parse(t(e.baseline,"utf-8"))}catch(u){console.log(te.red(` Cannot read baseline ${e.baseline}: ${u.message}`)),process.exitCode=1;return}if(e.json){console.log(JSON.stringify(c?{baseline:c,current:a}:a,null,2));return}let l=u=>u===null?"-":`$${u.toFixed(u<10?3:2)}`,g=u=>`${(u/1e6).toFixed(1)}M`;console.log(),console.log(te.bold(` Cost per channel, ${a.from} to ${a.to} (${a.days} day(s) with data)`)),c&&console.log(te.dim(` Baseline: ${c.from} to ${c.to} (${c.days} day(s) with data)`)),console.log();let d=` ${"channel".padEnd(14)} ${"tasks".padStart(6)} ${"cache read".padStart(11)} ${"cache write".padStart(11)} ${"output".padStart(8)} ${"cost".padStart(10)} ${"per task".padStart(9)}`;console.log(te.dim(c?`${d} ${"baseline".padStart(9)} ${"change".padStart(7)}`:d));let p=[...new Set([...Object.keys(a.channels),...Object.keys(c?.channels||{})])].map(u=>[u,a.channels[u],c?.channels[u]]).sort((u,h)=>(h[1]?.cost||0)-(u[1]?.cost||0));p.push(["TOTAL",a.total,c?.total]);for(let[u,h,y]of p){let $=r(h),b=` ${u.padEnd(14)} ${String(h?.tasks||0).padStart(6)} ${g(h?.cacheRead||0).padStart(11)} ${g(h?.cacheCreate||0).padStart(11)} ${g(h?.output||0).padStart(8)} ${l(h?.cost||0).padStart(10)} ${l($).padStart(9)}`;if(c){let v=r(y),x=$!==null&&v?`${(($-v)/v*100).toFixed(0)}%`:"-";b+=` ${l(v).padStart(9)} ${x.padStart(7)}`}console.log(b)}console.log(),c&&console.log(te.dim(" change = cost per task against the baseline; the two ranges do not have the same tasks.")),e.save&&console.log(te.dim(` Saved ${e.save}`)),console.log()});bn.command("surfaces").description("which CLI commands and dashboard pages are actually used").option("--days <n>","window in days","30").option("--kind <kind>","cli | page (default: both)").option("--unused","list registered surfaces with ZERO recorded use instead").option("--json","raw JSON output").action(async e=>{let{listSurfaceUse:t}=await import("./surface-usage-WSY4SHHL.js"),o=e.kind==="cli"||e.kind==="page"?e.kind:void 0,n=t({kind:o,sinceDays:Number(e.days)||30});if(e.unused){let{buildProgram:r}=await import("./program-HWWXPPS5.js"),i=await r(),a=new Set(n.filter(d=>d.kind==="cli").map(d=>d.name)),c=[],l=(d,f)=>{for(let p of d.commands??[]){let u=f?`${f} ${p.name()}`:p.name();c.push(u),l(p,u)}};l(i,"");let g=c.filter(d=>!a.has(d)).sort();if(e.json){console.log(JSON.stringify({windowDays:Number(e.days)||30,unused:g},null,2));return}console.log(),console.log(te.bold(` Never used in the last ${e.days} days (${g.length}/${c.length})`)),console.log();for(let d of g)console.log(` ${te.dim("\xB7")} ${d}`);console.log(),console.log(te.dim(" Zero use is necessary but not sufficient to remove a surface \u2014")),console.log(te.dim(" it must also fail the impact test. See docs/architecture/surface-reduction.md")),console.log();return}if(e.json){console.log(JSON.stringify(n,null,2));return}if(n.length===0){console.log(),console.log(te.dim(` No surface usage recorded in the last ${e.days} days.`)),console.log(te.dim(" Counting starts once this build has been running for a while.")),console.log();return}console.log(),console.log(te.bold(` Surface usage \u2014 last ${e.days} days`)),console.log();let s="";for(let r of n){r.kind!==s&&(console.log(te.dim(` ${r.kind==="cli"?"CLI commands":"Dashboard pages"}`)),s=r.kind);let i=String(r.count).padStart(6),a=te.dim(`${r.days}d`);console.log(` ${te.cyan(i)} ${r.name.padEnd(28)} ${a}`)}console.log(),console.log(te.dim(` ${n.length} surface(s) with recorded use. See --unused for the rest.`)),console.log()});import{Command as dA}from"commander";import Me from"chalk";import{readFileSync as gA}from"fs";import{resolve as uA}from"path";se();var qo=new dA().name("board").description("kanban board dashboard \u2014 visual work view over configured sources");qo.command("serve",{isDefault:!0}).description("start the dashboard server (live view always; boards if configured)").option("--port <n>","override dashboard.port").option("--bind <host>","override dashboard.bind (e.g. 0.0.0.0)").action(async e=>{try{try{Ud(uA(process.cwd(),".env"))}catch{}let t=mA(e.port,e.bind),{startBoardDashboard:o}=await import("./board-dashboard-2X72LAVO.js");o(t)}catch(t){console.log(Me.red(` ${t.message}`)),process.env.DEBUG&&t.stack&&console.log(Me.dim(t.stack)),process.exit(1)}});function mA(e,t){try{let o=C();return e&&(o.dashboard.port=parseInt(e,10)),t&&(o.dashboard.bind=t),o}catch{return console.log(Me.yellow(" No agentx.json found \u2014 starting dashboard in setup-only mode.")),console.log(Me.dim(" Visit http://127.0.0.1:"+(e||"4202")+` to run the wizard.
|
|
511
|
+
`}function ir(e,t,o=".env"){let n=hy(o),s=yy(n),r=s.findIndex(i=>i.kind==="kv"&&i.key===e);r>=0?s[r]={kind:"kv",key:e,value:t,raw:`${e}=${vl(t)}`}:(s.length&&s[s.length-1].kind!=="blank"&&s.push({kind:"blank",raw:""}),s.push({kind:"kv",key:e,value:t,raw:`${e}=${vl(t)}`})),US(n,GS(s))}function xl(e,t=".env"){return yy(t).find(s=>s.kind==="kv"&&s.key===e)?.value}var wy="https://t.me/BotFather";async function HS(e){try{let t=await fetch(`https://api.telegram.org/bot${e}/getMe`,{signal:AbortSignal.timeout(8e3)});if(!t.ok)return null;let o=await t.json();return o?.ok?o.result:null}catch{return null}}async function zS(e,t){let o=Date.now()+t,n=0;try{let r=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=-1&timeout=0`,{signal:AbortSignal.timeout(5e3)})).json();r?.result?.length&&(n=r.result[0].update_id+1)}catch{}for(;Date.now()<o;)try{let r=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=${n}&timeout=10`,{signal:AbortSignal.timeout(15e3)})).json();for(let i of r?.result||[]){n=Math.max(n,i.update_id+1);let a=i.message||i.edited_message||i.channel_post;if(a?.chat?.id)return{chatId:a.chat.id,chatTitle:a.chat.title||a.chat.username||a.chat.first_name,from:a.from?.first_name||a.from?.username||"unknown"}}}catch{}return null}async function $y(e={}){console.log(),console.log(ye.bold(" Connect Telegram")),console.log(),console.log(ye.dim(` 1. Open ${wy}`)),console.log(ye.dim(" /newbot (or /mybots \u2192 pick existing \u2192 API Token)")),console.log(ye.dim(" 2. Copy the HTTP API token \u2014 looks like 123456789:ABCdef...")),console.log();let{wantsBrowser:t}=await ar({type:"confirm",name:"wantsBrowser",message:"Open BotFather in your browser?",initial:!0});t&&en(wy);let{token:o}=await ar({type:"password",name:"token",message:"Paste the bot token from BotFather:",validate:b=>/^\d+:[A-Za-z0-9_-]{20,}$/.test(b.trim())||"That doesn't look like a Telegram token"});o||(console.log(ye.red(" Aborted")),process.exit(1)),process.stdout.write(" Verifying token... ");let n=await HS(o.trim());n||(console.log(ye.red("\u2717 invalid or revoked")),process.exit(1)),console.log(ye.green(`\u2713 ${n.first_name} (@${n.username})`));let{readFileSync:s,existsSync:r}=await import("fs"),{resolve:i}=await import("path"),a=e.configPath||i(process.cwd(),"agentx.json");r(a)||(console.log(ye.red(` No agentx.json at ${a}. Run: agentx init`)),process.exit(1));let c=JSON.parse(s(a,"utf-8")),l=Object.keys(c.agents||{});l.length===0&&(console.log(ye.red(" No agents configured. Run: agentx agent add")),process.exit(1));let g=e.agent;g||(g=(await ar({type:"select",name:"agent",message:"Bind this bot to which agent?",choices:l.map(v=>({title:v,value:v})),initial:0})).agent),g||(console.log(ye.red(" Aborted")),process.exit(1));let d=c.channels?.telegram?.accounts||{},f=e.account||g;d[f]&&d[f].agentBinding!==g&&(f=(await ar({type:"text",name:"account",message:`Account "${f}" is already in use. Pick a different label:`,initial:`${g}-2`,validate:v=>/^[a-z0-9-]+$/i.test(v)||"lowercase letters, digits, hyphens only"})).account),f||(console.log(ye.red(" Aborted")),process.exit(1));let p=`TG_${f.toUpperCase().replace(/-/g,"_")}_BOT_TOKEN`;ir(p,o.trim()),process.env[p]=o.trim();let u=await ge(b=>{Je(b,"channels.telegram.enabled",!0),Je(b,`channels.telegram.accounts.${f}`,{token:`\${${p}}`,agentBinding:g});let v=Fn(b,`agents.${g}.mentions`)||[],x=`@${n.username}`;v.includes(x)||(v.push(x),Je(b,`agents.${g}.mentions`,v))},{configPath:e.configPath});if(u.success||(console.log(ye.red(` \u2717 ${u.error}`)),process.exit(1)),console.log(),console.log(ye.green(` \u2713 Bot @${n.username} bound to agent "${g}"`)),console.log(ye.dim(` Token stored in .env as ${p}`)),console.log(ye.dim(` Mentions updated to include @${n.username}`)),u.reloaded?console.log(ye.dim(" Daemon hot-reloaded.")):console.log(ye.dim(" Start the daemon to begin polling (agentx daemon start)")),e.skipChatCapture)return;console.log();let{capture:h}=await ar({type:"confirm",name:"capture",message:"Listen for a message so we can set this as your default --notify target?",initial:!0});if(!h)return;console.log(),console.log(ye.dim(` Send any message to @${n.username} from the chat you want to use.`)),console.log(ye.dim(" Waiting up to 90s..."));let y=await zS(o.trim(),9e4);if(!y){console.log(ye.yellow(" No message received \u2014 skipping. You can set it later with:")),console.log(ye.dim(" agentx config set notifications.destination.channel telegram")),console.log(ye.dim(" agentx config set notifications.destination.chatId <chatId>")),console.log(ye.dim(` agentx config set notifications.destination.accountId ${f}`));return}let $=await ge(b=>{Je(b,"notifications.destination",{channel:"telegram",chatId:String(y.chatId),accountId:f})},{configPath:e.configPath});if(!$.success){console.log(ye.red(` \u2717 failed to save destination: ${$.error}`));return}console.log(ye.green(" \u2713 Default --notify target set")),console.log(ye.dim(` Chat: ${y.chatTitle||y.chatId} (from ${y.from})`)),console.log(ye.dim(" From now on, --notify me resolves to this chat.")),$.reloaded&&console.log(ye.dim(" Daemon hot-reloaded."))}import Ce from"chalk";import Sl from"prompts";import{existsSync as El,mkdirSync as YS,readdirSync as VS,readFileSync as by}from"fs";import{resolve as Al}from"path";var XS=".agentx/whatsapp-sessions";function KS(){let e=Al(process.cwd(),".agentx/daemon.pid");if(!El(e))return!1;try{let t=parseInt(by(e,"utf-8").trim(),10);return t?(process.kill(t,0),!0):!1}catch{return!1}}function QS(e){if(!El(e))return!1;try{return VS(e).some(t=>t.includes("creds")||t.endsWith(".json"))}catch{return!1}}async function ZS(e,t){let o;try{o=await import("@whiskeysockets/baileys")}catch{return t(Ce.red(" WhatsApp pairing needs @whiskeysockets/baileys.")),t(Ce.red(" Install with: pnpm add @whiskeysockets/baileys (or npm install)")),!1}let{makeWASocket:n,useMultiFileAuthState:s}=o.default||o;YS(e,{recursive:!0});let{state:r,saveCreds:i}=await s(e),a;try{a=(await o.fetchLatestBaileysVersion()).version}catch{}let c={level:"silent",trace:()=>{},debug:()=>{},info:()=>{},warn:()=>{},fatal:()=>{},error:()=>{},child:()=>c},l=n({auth:{creds:r.creds,keys:o.makeCacheableSignalKeyStore?o.makeCacheableSignalKeyStore(r.keys,c):r.keys},...a?{version:a}:{},logger:c,printQRInTerminal:!1,browser:["agentx-connect","pairing","1.0"],syncFullHistory:!1,markOnlineOnConnect:!1});return l.ev.on("creds.update",i),await new Promise(g=>{let f=setTimeout(()=>{t(Ce.yellow(" Timed out waiting for scan (2min)."));try{l.end(void 0)}catch{}g(!1)},12e4);l.ev.on("connection.update",async p=>{if(p.qr){t(Ce.dim(" Scan this QR with WhatsApp \u2192 Linked devices \u2192 Link a device:")),t("");try{let{default:u}=await import("qrcode-terminal");u.generate(p.qr,{small:!0})}catch{t(` QR: ${p.qr}`)}t("")}if(p.connection==="open"){clearTimeout(f),t(Ce.green(" \u2713 Paired"));try{l.end(void 0)}catch{}g(!0)}p.connection==="close"&&!p.qr&&p.lastDisconnect?.error?.output?.statusCode===401&&(clearTimeout(f),t(Ce.red(" \u2717 Authorization failed \u2014 rescan required")),g(!1))})})}async function ky(e={}){if(console.log(),console.log(Ce.bold(" Connect WhatsApp")),console.log(),KS()){console.log(Ce.yellow(" \u26A0 The daemon is running. Stop it first so pairing can open a fresh Baileys session:")),console.log(Ce.dim(" agentx daemon stop")),console.log();let{cont:l}=await Sl({type:"confirm",name:"cont",message:"Continue anyway? (expect errors)",initial:!1});l||(console.log(Ce.red(" Aborted")),process.exit(1))}let t=e.configPath||Al(process.cwd(),"agentx.json");El(t)||(console.log(Ce.red(` No agentx.json at ${t}. Run: agentx init`)),process.exit(1));let o=JSON.parse(by(t,"utf-8")),n=e.sessionDir||o.channels?.whatsapp?.sessionDir||XS,s=Al(process.cwd(),n),r=Object.keys(o.agents||{});r.length===0&&(console.log(Ce.red(" No agents configured. Run: agentx agent add")),process.exit(1));let i=e.agent;i||(i=(await Sl({type:"select",name:"agent",message:"Default agent for incoming messages:",choices:r.map(g=>({title:g,value:g})),initial:0})).agent),i||(console.log(Ce.red(" Aborted")),process.exit(1));let a=!e.skipPair;if(QS(s)&&a){let{keep:l}=await Sl({type:"confirm",name:"keep",message:`An existing session was found at ${n}. Keep it (recommended), or pair again?`,initial:!0});a=!l,l&&console.log(Ce.dim(" Keeping existing session \u2014 skipping QR pair."))}a&&(await ZS(s,g=>console.log(g))||(console.log(Ce.red(" Pairing failed. You can retry with `agentx connect whatsapp`.")),process.exit(1)));let c=await ge(l=>{Je(l,"channels.whatsapp.enabled",!0),Je(l,"channels.whatsapp.sessionDir",n),Je(l,"channels.whatsapp.defaultAgent",i)},{configPath:e.configPath});c.success||(console.log(Ce.red(` \u2717 ${c.error}`)),process.exit(1)),console.log(),console.log(Ce.green(` \u2713 WhatsApp bound to agent "${i}"`)),console.log(Ce.dim(` Session: ${n}`)),console.log(Ce.dim(" Start the daemon to begin receiving:")),console.log(Ce.dim(" agentx daemon start")),console.log(Ce.yellow(" No chat is answered until you list the allowed numbers (add your own to talk from your self-chat):")),console.log(Ce.dim(` agentx config set channels.whatsapp.allowFrom '["+15550001111"]'`)),console.log(Ce.dim(" Add routes later with:")),console.log(Ce.dim(` agentx config set channels.whatsapp.routes '[{"contact":"+1234567890","agent":"${i}"}]'`)),console.log()}import{randomBytes as eA}from"crypto";import We from"chalk";import vy from"prompts";var Yi="agentx-mesh:",Vi="//join/";function tA(e){return Buffer.from(e,"utf-8").toString("base64url")}function oA(e){return Buffer.from(e,"base64url").toString("utf-8")}function nA(e){return`${Yi}${Vi}${tA(JSON.stringify(e))}`}function sA(e){if(!e.startsWith(`${Yi}${Vi}`))throw new Error(`Not a mesh invite link \u2014 expected ${Yi}${Vi}\u2026`);let t=e.slice(Yi.length+Vi.length),o=JSON.parse(oA(t));if(o.version!==1)throw new Error(`Unsupported invite version: ${o.version}`);if(typeof o.url!="string"||typeof o.token!="string"||typeof o.name!="string")throw new Error("Invite payload missing required fields (url, token, name)");return o}function rA(){return eA(32).toString("hex")}function iA(e){let t=e?.node?.bind||"127.0.0.1:18800",[o,n]=t.split(":");return`http://${o}:${n}`}function aA(e){return e?.node?.name||e?.node?.id||"node"}async function xy(e){let{readFileSync:t,existsSync:o}=await import("fs"),{resolve:n}=await import("path"),s=e.configPath||n(process.cwd(),"agentx.json");o(s)||(console.log(We.red(` No agentx.json at ${s}. Run: agentx init`)),process.exit(1));let r=JSON.parse(t(s,"utf-8")),i=xl("MESH_TOKEN");i||(i=rA(),ir("MESH_TOKEN",i),console.log(We.dim(" Generated new MESH_TOKEN (32 bytes) and saved to .env")));let a=e.url||iA(r);if((a.includes("0.0.0.0")||a.includes("127.0.0.1")||a.includes("localhost"))&&!e.url){let{url:d}=await vy({type:"text",name:"url",message:"This node's URL as peers should reach it (e.g. http://100.x.x.x:18800):",initial:a,validate:f=>/^https?:\/\//.test(f)||"must start with http:// or https://"});d||(console.log(We.red(" Aborted")),process.exit(1)),a=d}let l=await ge(d=>{Je(d,"mesh.enabled",!0)},{configPath:e.configPath});l.success||(console.log(We.red(` \u2717 ${l.error}`)),process.exit(1));let g=nA({url:a,token:i,name:aA(r),version:1});console.log(),console.log(We.bold(" Mesh invite")),console.log(),console.log(` ${We.cyan(g)}`),console.log(),console.log(We.dim(" Run on the other node:")),console.log(We.dim(` agentx connect mesh join "${g}"`)),console.log(),console.log(We.yellow(" Share over a trusted channel only \u2014 whoever holds this link can join your mesh.")),console.log()}async function Sy(e,t={}){let o;try{o=sA(e)}catch(r){console.log(We.red(` \u2717 ${r.message}`)),process.exit(1)}let n=xl("MESH_TOKEN");if(n&&n!==o.token){let{overwrite:r}=await vy({type:"confirm",name:"overwrite",message:"A different MESH_TOKEN already exists in .env. Overwrite with the invite's token?",initial:!1});r||(console.log(We.red(" Aborted (keeping existing .env)")),process.exit(1))}ir("MESH_TOKEN",o.token);let s=await ge(r=>{Je(r,"mesh.enabled",!0);let i=Fn(r,"mesh.peers")||[],a=i.findIndex(l=>l.name===o.name),c={name:o.name,url:o.url,token:"${MESH_TOKEN}"};a>=0?i[a]=c:i.push(c),Je(r,"mesh.peers",i)},{configPath:t.configPath});s.success||(console.log(We.red(` \u2717 ${s.error}`)),process.exit(1)),console.log(We.green(" \u2713 Joined mesh")),console.log(We.dim(` Peer: ${o.name} @ ${o.url}`)),console.log(We.dim(" Shared token stored in .env as MESH_TOKEN")),s.reloaded?console.log(We.dim(" Daemon hot-reloaded.")):console.log(We.dim(" Restart the daemon to start the mesh (agentx daemon start).")),console.log();try{let r=await fetch(`${o.url.replace(/\/$/,"")}/.well-known/agent-card.json`,{signal:AbortSignal.timeout(5e3)});if(r.ok){let i=await r.json(),a=Array.isArray(i.agents)?i.agents.length:"?";console.log(We.dim(` Reachable \u2014 ${o.name} exposes ${a} agents`))}else console.log(We.yellow(` Peer returned HTTP ${r.status} \u2014 double-check the URL`))}catch(r){console.log(We.yellow(` Could not reach ${o.url} right now (${r?.cause?.code||r.message}) \u2014 verify VPN / Tailscale when the peer daemon is up`))}}var us=new cA().name("connect").description("connect a channel or mesh peer \u2014 no manual file editing required");us.command("telegram").description("pair a Telegram bot \u2014 persists token in .env, binds to an agent, auto-detects default chat").option("--agent <id>","agent to bind the bot to (skips the prompt)").option("--account <name>","account label in channels.telegram.accounts (defaults to agent id)").option("--skip-chat-capture","don't listen for the first message after pairing").option("-c, --config <path>","path to agentx.json").action(async e=>{await $y({agent:e.agent,account:e.account,configPath:e.config,skipChatCapture:!!e.skipChatCapture})});us.command("whatsapp").description("pair WhatsApp via QR (prints in terminal), then writes channels.whatsapp config").option("--agent <id>","default agent for inbound messages").option("--session-dir <path>","session directory (default: .agentx/whatsapp-sessions)").option("--skip-pair","skip QR pairing (use when session already exists)").option("-c, --config <path>","path to agentx.json").action(async e=>{await ky({agent:e.agent,sessionDir:e.sessionDir,skipPair:!!e.skipPair,configPath:e.config})});var Ay=us.command("mesh").description("mesh invite + join \u2014 replaces manual MESH_TOKEN copy-paste");Ay.command("invite").description("emit a single-use join link for another AgentX node").option("--url <url>","this node's URL as peers should reach it (Tailscale IP etc.)").option("-c, --config <path>","path to agentx.json").action(async e=>{await xy({url:e.url,configPath:e.config})});Ay.command("join <link>").description("accept an invite link from another AgentX node").option("-c, --config <path>","path to agentx.json").action(async(e,t)=>{await Sy(e,{configPath:t.config})});us.action(()=>{console.log(),console.log(gs.bold(" agentx connect \u2014 which channel?")),console.log(),console.log(` ${gs.cyan("agentx connect telegram")} \u2014 pair a Telegram bot`),console.log(` ${gs.cyan("agentx connect whatsapp")} \u2014 pair WhatsApp via QR`),console.log(` ${gs.cyan("agentx connect mesh invite")} \u2014 emit a mesh join link for another node`),console.log(` ${gs.cyan("agentx connect mesh join <link>")} \u2014 accept a mesh invite`),console.log(),console.log(gs.dim(" GitLab connect is the next slice.")),console.log()});se();import{Command as lA}from"commander";import te from"chalk";var bn=new lA().name("usage").description("token usage analysis and reporting");bn.command("today",{isDefault:!0}).description("show today's token usage").action(async()=>{try{let e=C(),[t,o]=e.node.bind.split(":"),s=await(await fetch(`http://${t||"127.0.0.1"}:${o}/usage`,{signal:AbortSignal.timeout(3e3)})).json();if(console.log(),console.log(te.bold(" Token Usage (last 7 days)")),console.log(),s.totalTasks===0){console.log(te.dim(" No tasks recorded yet")),console.log();return}let r=a=>a.toLocaleString();console.log(` Total: ${te.bold(r(s.totalTokens))} tokens across ${s.totalTasks} tasks`),console.log(` Input: ${r(s.totalInput)}`),console.log(` Output: ${r(s.totalOutput)}`),console.log(` Cache read: ${r(s.totalCacheRead)}`),console.log(` Cache create: ${r(s.totalCacheCreate)}`),s.cacheHitRatio>0&&console.log(` Cache hit: ${(s.cacheHitRatio*100).toFixed(1)}%`),s.totalErrors>0&&console.log(` Errors: ${te.red(String(s.totalErrors))}`),console.log(),console.log(te.bold(" By Agent:"));let i=Object.entries(s.byAgent||{});i.sort((a,c)=>c[1].total-a[1].total);for(let[a,c]of i){let l=r(c.total||c.input+c.output+c.cacheRead+c.cacheCreate),g=c.avgDuration?`${(c.avgDuration/1e3).toFixed(1)}s avg`:"";console.log(` ${te.cyan(a)}: ${l} tokens (${c.tasks} tasks) ${te.dim(g)}`)}console.log()}catch(e){e.cause?.code==="ECONNREFUSED"?console.log(te.red(" Daemon not running. Start with: agentx daemon start")):console.log(te.red(` ${e.message}`))}});bn.command("plan").description("show the Claude plan windows as Claude Code last reported them, and any hold on fresh sessions").option("--lift","lift the hold on fresh sessions now, without waiting for the reset time").option("--json","raw JSON output").action(async e=>{try{let t=C(),[o,n]=t.node.bind.split(":"),s=`http://${o||"127.0.0.1"}:${n}`,r=e.lift?await fetch(`${s}/usage/plan/lift`,{method:"POST",signal:AbortSignal.timeout(3e3)}):await fetch(`${s}/usage/plan`,{signal:AbortSignal.timeout(3e3)});if(!r.ok)throw new Error(`Daemon answered ${r.status}. It may be older than this command; restart it.`);let i=await r.json();if(e.json){console.log(JSON.stringify(i,null,2));return}let a=d=>d.replace(/_/g," ");if(console.log(),e.lift){let d=i.lifted.map(f=>a(f.window));console.log(d.length?` Lifted the hold on: ${d.join(", ")}. The next fresh session asks Claude again.`:te.dim(" No hold to lift.")),console.log();return}let c=i.now,l=new Set(i.holds.map(d=>d.window));console.log(te.bold(" Claude plan (as Claude Code last reported it)")),console.log(),i.provider.length===0&&console.log(te.dim(" No report yet. Claude Code reports on each turn; the list is empty after a daemon restart."));for(let d of i.provider){let f=d.usingOverage?"extra usage":d.status==="allowed_warning"?"nearly full":d.status,p=typeof d.utilization=="number"?`${Math.round(d.utilization*100)}% used`:"",u=Math.max(1,Math.round((d.resetsAt-c)/6e4)),h=d.resetsAt>c?u<60?`resets in ${u} min`:u<48*60?`resets in ${Math.round(u/60)} h`:`resets in ${Math.round(u/1440)} days`:"",y=l.has(d.window)?te.red("holding fresh sessions"):"";console.log(` ${a(d.window).padEnd(18)} ${f.padEnd(12)} ${[p,h,y].filter(Boolean).join(", ")}`)}console.log();let g=d=>d?` of ${d}`:"";console.log(` Fresh sessions started: ${i.lastHour}${g(i.maxPerHour)} in the last hour, ${i.last5h}${g(i.maxPer5h)} in the last 5 hours`),l.size&&console.log(te.dim(" To try again now: agentx usage plan --lift")),console.log()}catch(t){t.cause?.code==="ECONNREFUSED"?console.log(te.red(" Daemon not running. Start with: agentx daemon start")):console.log(te.red(` ${t.message}`))}});bn.command("report").description("run full session analysis (parses Claude Code JSONL files)").option("--days <n>","analyze last N days","7").action(async e=>{let{execSync:t}=await import("child_process"),{existsSync:o}=await import("fs"),{resolve:n}=await import("path"),s=n(process.cwd(),"scripts/token-report.py");if(!o(s)){console.log(te.red(` Script not found: ${s}`)),console.log(te.dim(" The token analyzer script should be at scripts/token-report.py"));return}console.log(te.dim(" Analyzing Claude Code sessions..."));try{t(`SINCE_DAYS=${e.days} python3 "${s}"`,{stdio:"inherit"})}catch{console.log(te.red(" Analysis failed. Is Python 3 installed?"))}});bn.command("channels").description("cost per channel over a fixed range of days, next to a saved baseline").requiredOption("--from <date>","first day, YYYY-MM-DD").requiredOption("--to <date>","last day, YYYY-MM-DD").option("--save <file>","write this range's figures to a JSON file").option("--baseline <file>","a file written by --save, shown beside this range").option("--json","raw JSON output").action(async e=>{let{readFileSync:t,writeFileSync:o}=await import("fs"),{TokenTracker:n}=await import("./token-tracker-W7DFDEFN.js"),{channelCosts:s,costPerTask:r}=await import("./usage-channels-KBLEC4NE.js"),i=u=>/^\d{4}-\d{2}-\d{2}$/.test(u)&&!Number.isNaN(Date.parse(u));if(!i(e.from)||!i(e.to)||e.from>e.to){console.log(te.red(" --from and --to must be YYYY-MM-DD, with --from not after --to")),process.exitCode=1;return}let a=s(new n,e.from,e.to);e.save&&o(e.save,JSON.stringify(a,null,2));let c=null;if(e.baseline)try{c=JSON.parse(t(e.baseline,"utf-8"))}catch(u){console.log(te.red(` Cannot read baseline ${e.baseline}: ${u.message}`)),process.exitCode=1;return}if(e.json){console.log(JSON.stringify(c?{baseline:c,current:a}:a,null,2));return}let l=u=>u===null?"-":`$${u.toFixed(u<10?3:2)}`,g=u=>`${(u/1e6).toFixed(1)}M`;console.log(),console.log(te.bold(` Cost per channel, ${a.from} to ${a.to} (${a.days} day(s) with data)`)),c&&console.log(te.dim(` Baseline: ${c.from} to ${c.to} (${c.days} day(s) with data)`)),console.log();let d=` ${"channel".padEnd(14)} ${"tasks".padStart(6)} ${"cache read".padStart(11)} ${"cache write".padStart(11)} ${"output".padStart(8)} ${"cost".padStart(10)} ${"per task".padStart(9)}`;console.log(te.dim(c?`${d} ${"baseline".padStart(9)} ${"change".padStart(7)}`:d));let p=[...new Set([...Object.keys(a.channels),...Object.keys(c?.channels||{})])].map(u=>[u,a.channels[u],c?.channels[u]]).sort((u,h)=>(h[1]?.cost||0)-(u[1]?.cost||0));p.push(["TOTAL",a.total,c?.total]);for(let[u,h,y]of p){let $=r(h),b=` ${u.padEnd(14)} ${String(h?.tasks||0).padStart(6)} ${g(h?.cacheRead||0).padStart(11)} ${g(h?.cacheCreate||0).padStart(11)} ${g(h?.output||0).padStart(8)} ${l(h?.cost||0).padStart(10)} ${l($).padStart(9)}`;if(c){let v=r(y),x=$!==null&&v?`${(($-v)/v*100).toFixed(0)}%`:"-";b+=` ${l(v).padStart(9)} ${x.padStart(7)}`}console.log(b)}console.log(),c&&console.log(te.dim(" change = cost per task against the baseline; the two ranges do not have the same tasks.")),e.save&&console.log(te.dim(` Saved ${e.save}`)),console.log()});bn.command("surfaces").description("which CLI commands and dashboard pages are actually used").option("--days <n>","window in days","30").option("--kind <kind>","cli | page (default: both)").option("--unused","list registered surfaces with ZERO recorded use instead").option("--json","raw JSON output").action(async e=>{let{listSurfaceUse:t}=await import("./surface-usage-WSY4SHHL.js"),o=e.kind==="cli"||e.kind==="page"?e.kind:void 0,n=t({kind:o,sinceDays:Number(e.days)||30});if(e.unused){let{buildProgram:r}=await import("./program-7UMVHRD3.js"),i=await r(),a=new Set(n.filter(d=>d.kind==="cli").map(d=>d.name)),c=[],l=(d,f)=>{for(let p of d.commands??[]){let u=f?`${f} ${p.name()}`:p.name();c.push(u),l(p,u)}};l(i,"");let g=c.filter(d=>!a.has(d)).sort();if(e.json){console.log(JSON.stringify({windowDays:Number(e.days)||30,unused:g},null,2));return}console.log(),console.log(te.bold(` Never used in the last ${e.days} days (${g.length}/${c.length})`)),console.log();for(let d of g)console.log(` ${te.dim("\xB7")} ${d}`);console.log(),console.log(te.dim(" Zero use is necessary but not sufficient to remove a surface \u2014")),console.log(te.dim(" it must also fail the impact test. See docs/architecture/surface-reduction.md")),console.log();return}if(e.json){console.log(JSON.stringify(n,null,2));return}if(n.length===0){console.log(),console.log(te.dim(` No surface usage recorded in the last ${e.days} days.`)),console.log(te.dim(" Counting starts once this build has been running for a while.")),console.log();return}console.log(),console.log(te.bold(` Surface usage \u2014 last ${e.days} days`)),console.log();let s="";for(let r of n){r.kind!==s&&(console.log(te.dim(` ${r.kind==="cli"?"CLI commands":"Dashboard pages"}`)),s=r.kind);let i=String(r.count).padStart(6),a=te.dim(`${r.days}d`);console.log(` ${te.cyan(i)} ${r.name.padEnd(28)} ${a}`)}console.log(),console.log(te.dim(` ${n.length} surface(s) with recorded use. See --unused for the rest.`)),console.log()});import{Command as dA}from"commander";import Me from"chalk";import{readFileSync as gA}from"fs";import{resolve as uA}from"path";se();var qo=new dA().name("board").description("kanban board dashboard \u2014 visual work view over configured sources");qo.command("serve",{isDefault:!0}).description("start the dashboard server (live view always; boards if configured)").option("--port <n>","override dashboard.port").option("--bind <host>","override dashboard.bind (e.g. 0.0.0.0)").action(async e=>{try{try{Ud(uA(process.cwd(),".env"))}catch{}let t=mA(e.port,e.bind),{startBoardDashboard:o}=await import("./board-dashboard-QJ2CWJKI.js");o(t)}catch(t){console.log(Me.red(` ${t.message}`)),process.env.DEBUG&&t.stack&&console.log(Me.dim(t.stack)),process.exit(1)}});function mA(e,t){try{let o=C();return e&&(o.dashboard.port=parseInt(e,10)),t&&(o.dashboard.bind=t),o}catch{return console.log(Me.yellow(" No agentx.json found \u2014 starting dashboard in setup-only mode.")),console.log(Me.dim(" Visit http://127.0.0.1:"+(e||"4202")+` to run the wizard.
|
|
512
512
|
`)),{node:{id:"setup",name:"Setup",bind:"127.0.0.1:18800"},providers:{},agents:{},channels:{},crons:{},mesh:{enabled:!1,peers:[],discovery:"static",healthCheck:{interval:60,timeout:10}},boards:[],dashboard:{enabled:!0,port:e?parseInt(e,10):4202,bind:t||"127.0.0.1",daemonUrl:"http://localhost:18800",daemons:[]},business:void 0,session:{staleMinutes:120}}}}qo.command("list").description("list configured boards").action(()=>{try{let e=C();if(!e.boards?.length){console.log(Me.dim(`
|
|
513
513
|
No boards configured.
|
|
514
514
|
`));return}console.log();for(let t of e.boards){console.log(` ${Me.cyan(t.id)} \u2014 ${t.name}`);let o=t.source;console.log(Me.dim(` source: ${o.type}${o.projects?" ("+o.projects.join(", ")+")":""}`)),t.primaryToolLabel&&console.log(Me.dim(` primary label: ${t.primaryToolLabel}`)),console.log(Me.dim(` window: ${t.timeRangeDays} days`))}console.log()}catch(e){console.log(Me.red(` ${e.message}`)),process.exit(1)}});qo.command("add <id>").description("add a GitLab board to agentx.json").requiredOption("--name <name>","human-readable board name").requiredOption("--projects <paths>","comma-separated GitLab project paths (e.g. 'globex/system,globex/website')").option("--label <label>","primary tool label ANDed into every query (e.g. 'Tool::Claude')").option("--days <n>","open-window time range in days","30").option("--closed-days <n>","closed-window in days","30").action((e,t)=>{try{cr(o=>{if(Array.isArray(o.boards)||(o.boards=[]),o.boards.find(r=>r.id===e))throw new Error(`board "${e}" already exists`);let n=String(t.projects).split(",").map(r=>r.trim()).filter(Boolean);if(n.length===0)throw new Error("--projects must include at least one path");let s={id:e,name:t.name,source:{type:"gitlab",projects:n},timeRangeDays:parseInt(t.days,10)||30,closedWindowDays:parseInt(t.closedDays,10)||30};return t.label&&(s.primaryToolLabel=t.label),o.boards.push(s),`added board "${e}" (${n.join(", ")})`})}catch(o){console.log(Me.red(` ${o.message}`)),process.exit(1)}});qo.command("edit <id>").description("edit board fields without re-creating it").option("--name <name>","rename").option("--projects <paths>","comma-separated GitLab project paths (replaces the list)").option("--label <label>","primary tool label (set to '-' to clear)").option("--days <n>","open-window time range in days").option("--closed-days <n>","closed-window in days").action((e,t)=>{try{cr(o=>{let s=(Array.isArray(o.boards)?o.boards:[]).find(i=>i.id===e);if(!s)throw new Error(`board "${e}" not found`);let r=[];if(t.name&&(s.name=t.name,r.push(`name="${t.name}"`)),t.projects){let i=String(t.projects).split(",").map(a=>a.trim()).filter(Boolean);if(i.length===0)throw new Error("--projects must include at least one path");s.source={...s.source||{type:"gitlab"},type:"gitlab",projects:i},r.push(`projects=${i.length}`)}if(t.label!==void 0&&(t.label==="-"?(delete s.primaryToolLabel,r.push("label cleared")):(s.primaryToolLabel=t.label,r.push(`label="${t.label}"`))),t.days&&(s.timeRangeDays=parseInt(t.days,10)||s.timeRangeDays,r.push(`days=${s.timeRangeDays}`)),t.closedDays&&(s.closedWindowDays=parseInt(t.closedDays,10)||s.closedWindowDays,r.push(`closed-days=${s.closedWindowDays}`)),r.length===0)throw new Error("no changes \u2014 pass at least one option");return`board "${e}" updated (${r.join(", ")})`})}catch(o){console.log(Me.red(` ${o.message}`)),process.exit(1)}});var Rl=qo.command("column").description("manage a board's columns (add / remove / edit / list)");Rl.command("list <boardId>").description("list columns on a board, in order").action(e=>{try{let o=(JSON.parse(gA("agentx.json","utf-8")).boards||[]).find(s=>s.id===e);if(!o)throw new Error(`board "${e}" not found`);let n=o.columns||[];if(n.length===0){console.log(Me.dim(" no columns (board falls back to GitLab default flow)"));return}for(let s of n){let r=s.kind==="scoped-label"?`scoped="${s.scopedLabel}"`:s.kind==="label"?`label="${s.mapsToLabel||""}"`:s.kind==="open-backlog"?`prefix="${s.scopedPrefix}"`:s.kind;console.log(` ${Me.cyan(s.id.padEnd(12))} ${s.title.padEnd(14)} ${Me.dim(r)}`)}}catch(t){console.log(Me.red(` ${t.message}`)),process.exit(1)}});Rl.command("add <boardId> <columnId>").description("add a column to a board").requiredOption("--title <title>","column title").option("--kind <kind>","open-backlog | scoped-label | closed | label","scoped-label").option("--scoped <label>","for kind=scoped-label, the full label (e.g. 'Status::Doing')").option("--label <label>","for kind=label, the label name to add/remove").option("--scoped-prefix <prefix>","for kind=open-backlog/scoped-label","Status").option("--accent <color>","hex/CSS color for the column accent bar").action((e,t,o)=>{try{cr(n=>{let r=(Array.isArray(n.boards)?n.boards:[]).find(a=>a.id===e);if(!r)throw new Error(`board "${e}" not found`);if(r.columns=r.columns||[],r.columns.find(a=>a.id===t))throw new Error(`column "${t}" already exists on board "${e}"`);let i={id:t,title:o.title,kind:o.kind,scopedPrefix:o.scopedPrefix};if(o.kind==="scoped-label"){if(!o.scoped)throw new Error("--scoped required for kind=scoped-label");i.scopedLabel=o.scoped}if(o.kind==="label"){if(!o.label)throw new Error("--label required for kind=label");i.mapsToLabel=o.label}return o.accent&&(i.accent=o.accent),r.columns.push(i),`column "${t}" added to board "${e}"`})}catch(n){console.log(Me.red(` ${n.message}`)),process.exit(1)}});Rl.command("remove <boardId> <columnId>").alias("rm").description("remove a column from a board").action((e,t)=>{try{cr(o=>{let s=(Array.isArray(o.boards)?o.boards:[]).find(i=>i.id===e);if(!s)throw new Error(`board "${e}" not found`);let r=(s.columns||[]).length;if(s.columns=(s.columns||[]).filter(i=>i.id!==t),s.columns.length===r)throw new Error(`column "${t}" not found`);return`column "${t}" removed from board "${e}"`})}catch(o){console.log(Me.red(` ${o.message}`)),process.exit(1)}});qo.command("remove <id>").alias("rm").description("remove a board from agentx.json").action(e=>{try{cr(t=>{if(!Array.isArray(t.boards)||t.boards.length===0)throw new Error("no boards configured");let o=t.boards.length;if(t.boards=t.boards.filter(n=>n.id!==e),t.boards.length===o)throw new Error(`board "${e}" not found`);return`removed board "${e}"`})}catch(t){console.log(Me.red(` ${t.message}`)),process.exit(1)}});function cr(e){let{summary:t,backupPath:o}=At(n=>e(n));console.log(Me.green(`
|
|
@@ -540,17 +540,17 @@ ${t}
|
|
|
540
540
|
`}function Ty(e,t,o,n){let s=n.today??new Date().toISOString().slice(0,10),r=new Map;for(let i of t){let a=e.find(c=>c.id===i.id||i.id.length>=4&&c.id.startsWith(i.id));a&&!r.has(a.id)&&r.set(a.id,i)}return e.map(i=>{let a=r.get(i.id);if(!a)return{id:i.id,outcome:"deferred",reason:"absorb did not answer this note",patched:[]};let c=Xi(a.reason||"no reason given");if(a.outcome!=="patched")return{id:i.id,outcome:a.outcome,reason:c,patched:[]};let l=pA(a.edits,o,n.paths,n.agentId);if("refused"in l)return{id:i.id,outcome:"deferred",reason:Xi(`patch refused: ${l.refused}. Absorb said: ${c}`),patched:[]};let g=[],d="";for(let[p,{article:u,content:h}]of l.articles){let y=!1;try{y=o.writeArticle(p,{...u.meta,lastUpdated:s,sources:[...new Set([...u.meta.sources??[],Tl(i.id)])]},h,n.agentId)}catch($){d=`${p}: ${$?.message??$}`}if(!y){d||=p;break}g.push({path:p,article:u})}if(d){for(let p of g)try{o.writeArticle(p.path,p.article.meta,p.article.content,n.agentId)}catch{}return{id:i.id,outcome:"deferred",reason:Xi(`patch not saved: could not write ${d}. Absorb said: ${c}`),patched:[]}}let f=g.map(p=>p.path);return{id:i.id,outcome:"patched",reason:Xi(`${c} (edited ${f.join(", ")})`),patched:f}})}function pA(e,t,o,n){if(e.length===0)return{refused:"patched with no edits"};if(e.length>lr.edits)return{refused:`more than ${lr.edits} edits`};let s=new Map;for(let r of e){if(!o.has(r.path))return{refused:`${r.path} is not an article shown in full`};let i=s.get(r.path);if(!i){let c=t.readArticle(r.path);if(!c)return{refused:`${r.path} is not an existing article`};if(t.canWrite&&!t.canWrite(c.meta,n))return{refused:`no permission to write ${r.path}`};i={article:c,content:c.content,replaced:0},s.set(r.path,i)}if(!r.find.trim())return{refused:`an edit to ${r.path} quotes nothing`};if(r.find.length>lr.find||r.replace.length>lr.replace)return{refused:`an edit to ${r.path} is too long for a patch`};if(i.replaced+=r.find.length,i.replaced>i.article.content.length*lr.share)return{refused:`the edits replace most of ${r.path}; a note only patches`};let a=i.content.indexOf(r.find);if(a<0)return{refused:`the quoted passage is not in ${r.path}`};if(i.content.indexOf(r.find,a+1)>=0)return{refused:`the quoted passage appears more than once in ${r.path}`};i.content=i.content.slice(0,a)+r.replace+i.content.slice(a+r.find.length)}for(let[r,{article:i,content:a}]of s){let c=[...fA(i.content,a),...$A(i.content,a)];if(c.length>0)return{refused:`the edit to ${r} drops ${c.slice(0,4).join("; ")}${c.length>4?"; \u2026":""}`}}return{articles:s}}function fA(e,t){let o=Ps(e,t),n=Ps(t,e),s=i=>i.startsWith("link [[")?"wikilink":i.split(" ")[0],r=new Map;for(let i of n)r.set(s(i),(r.get(s(i))??0)+1);return o.filter(i=>{let a=r.get(s(i))??0;return a===0?!0:(r.set(s(i),a-1),!1)})}var hA=/[\w.+-]+@[\w-]+(?:\.[\w-]+)+/g,yA=/(?<![\w@.])@[A-Za-z0-9_]{3,}/g,wA=/^\s*(?:[-*]\s*)?(?:\|\s*)?\**\s*(role|job title|position|organi[sz]ation|company|team|employer|e-?mail|phone|mobile|tel|whatsapp|telegram|signal|slack|handle|contact|address)\s*\**\s*(?::|\|)\s*\**\s*(.+?)\s*\|?\s*$/gim;function $A(e,t){let o=t.toLowerCase(),n=[];for(let s of e.matchAll(hA))o.includes(s[0].toLowerCase())||n.push(`email ${s[0]}`);for(let s of e.matchAll(yA))o.includes(s[0].toLowerCase())||n.push(`handle ${s[0]}`);for(let s of e.matchAll(wA)){let r=s[2].replace(/\*+/g,"").trim();!r||/^(unknown|n\/a|none|-+|tbd)$/i.test(r)||o.includes(r.toLowerCase())||n.push(`${s[1].toLowerCase()} "${r}"`)}return[...new Set(n)]}function Xi(e){return e.length>_a.reason?`${e.slice(0,_a.reason-1)}\u2026`:e}import qe from"chalk";import{resolve as bA}from"path";var kA=e=>e||bA(process.cwd(),".agentx/wiki");async function ms(e){let{FactLedger:t}=await import("./ledger-P62U3FHT.js");return new t(kA(e))}function ps(e){return async(...t)=>{try{await e(...t)}catch(o){o?.name!=="LedgerCorruptError"&&console.error(qe.red(` ${o?.message??o}`)),process.exitCode=1}}}function Oy(e){let t=e.command("facts").description("facts with a source and a check date: list, show, set, proposals");t.command("list").description("every recorded fact, with where and when it was checked").option("--dir <path>","wiki directory").option("--stale","only facts past their time limit, or never checked").option("--json").action(ps(async n=>{let{isStaleFact:s}=await import("./ledger-P62U3FHT.js"),r=(await ms(n.dir)).list().filter(i=>!n.stale||s(i));if(n.json){console.log(JSON.stringify(r,null,2));return}if(r.length===0){console.log(qe.dim(" no facts recorded"));return}for(let i of r){let a=i.undated?qe.yellow(" UNCHECKED"):s(i)?qe.yellow(" STALE"):"";console.log(` ${qe.cyan(i.id)} ${qe.bold(i.subject)} \xB7 ${i.attribute}: ${i.value}${a}`),console.log(qe.dim(` ${i.volatility} \xB7 ${i.source} \xB7 checked ${i.verifiedAt.slice(0,10)} by ${i.verifiedBy}`))}})),t.command("show <id>").description("one fact, with its earlier values").option("--dir <path>","wiki directory").action(ps(async(n,s)=>{let r=(await ms(s.dir)).get(n);if(!r){console.error(qe.red(` no fact "${n}"`)),process.exitCode=1;return}console.log(JSON.stringify(r,null,2))})),t.command("set").description("record a fact you checked; a different value needs a newer --checked-at, or --confirm by a person").requiredOption("--subject <text>",'what the fact is about, e.g. "vendor account"').requiredOption("--attribute <text>",'which property, e.g. "billing status"').requiredOption("--value <text>","the value you found").requiredOption("--source <text>",'where you checked: a system, URL, command, or "owner said"').option("--by <id>","who checked it (agent id or person)",process.env.AGENTX_AGENT_ID||"operator").option("--checked-at <iso>",`when you checked it: an ISO date, or "now". Without it the value can't replace a different one already recorded`).option("--class <class>",`volatility class: ${Na.join(" | ")}`).option("--ttl-days <n>","days it stays trusted, overriding the class").option("--confirm","a person confirms this value: replace a newer-dated one").option("--dir <path>","wiki directory").action(ps(async n=>{if(n.class&&!Yd(n.class)){console.error(qe.red(` --class must be one of ${Na.join(", ")}`)),process.exitCode=1;return}let r=(await ms(n.dir)).write({subject:n.subject,attribute:n.attribute,value:n.value,source:n.source,verifiedBy:n.by,verifiedAt:n.checkedAt,volatility:n.class,ttlDays:n.ttlDays!==void 0?Number(n.ttlDays):void 0},n.confirm?{confirmedBy:n.by}:{});if(r.status==="contradiction"){let i=r.fact.confirmedBy?`${r.fact.confirmedBy} confirmed it, so only a person can change it`:n.checkedAt?"and this check is not newer":"and this value has no --checked-at";console.log(qe.yellow(` not replaced: the wiki says "${r.fact.value}" (checked ${r.fact.verifiedAt.slice(0,10)}), ${i}.`)),console.log(r.questionId?qe.dim(` Queued question ${r.questionId}: agentx wiki questions \xB7 agentx wiki answer ${r.questionId} "<true value>"`):r.questionClosed?qe.dim(` A person already ${r.questionClosed} this same claim, so it is not asked again.`):qe.red(" No question could be queued: the questions file is unreadable. Repair .agentx/wiki/_questions.json.")),process.exitCode=2;return}console.log(qe.green(` ${r.status}: ${r.fact.id} ${r.fact.subject} \xB7 ${r.fact.attribute}: ${r.fact.value}`))}));let o=t.command("proposals").description("claims from session summaries, waiting for a check (list, approve, reject)");o.command("list").description("claims waiting for a check (pending by default)").option("--dir <path>","wiki directory").option("--all","include approved and rejected").option("--json").action(ps(async n=>{let{listFactProposals:s}=await import("./fact-proposals-X2O4W7VN.js"),r=s(await ms(n.dir),n.all?void 0:"pending");if(n.json){console.log(JSON.stringify(r,null,2));return}if(r.length===0){console.log(qe.dim(" no fact proposals waiting"));return}for(let i of r)console.log(` ${qe.cyan(i.id)} ${i.status==="pending"?"":qe.dim(`[${i.status}] `)}${i.claim}`),console.log(qe.dim(` ${i.agentId} \xB7 ${i.origin} \xB7 ${i.source} \xB7 ${i.verifiedAt.slice(0,10)}`));console.log(qe.dim(`
|
|
541
541
|
Check each claim at its source, then: agentx wiki facts proposals approve <id> \xB7 reject <id>`))})),o.command("approve <id>").description("confirm a claim and record it as a fact").option("--subject <text>","correct the subject read from the claim").option("--attribute <text>","correct the attribute").option("--value <text>","correct the value").option("--source <text>","where you checked it").option("--by <id>","who confirms it","operator").option("--dir <path>","wiki directory").action(ps(async(n,s)=>{let{approveFactProposal:r}=await import("./fact-proposals-X2O4W7VN.js"),{write:i}=r(await ms(s.dir),n,s.by,{subject:s.subject,attribute:s.attribute,value:s.value,source:s.source});console.log(qe.green(` ${i.status}: ${i.fact.id} ${i.fact.subject} \xB7 ${i.fact.attribute}: ${i.fact.value}`))})),o.command("reject <id>").description("drop a claim; it is not recorded").option("--reason <text>","why, kept with the decision").option("--by <id>","who rejects it","operator").option("--dir <path>","wiki directory").action(ps(async(n,s)=>{let{rejectFactProposal:r}=await import("./fact-proposals-X2O4W7VN.js"),i=r(await ms(s.dir),n,s.by,s.reason);console.log(qe.dim(` rejected: ${i.claim}`))}))}import ze from"chalk";import{existsSync as Ny,readFileSync as Iy}from"fs";import{resolve as Nl}from"path";var Ol=e=>e||Nl(process.cwd(),".agentx/wiki");function vA(e){if(e)return e.replace(/\/+$/,"");if(process.env.AGENTX_DAEMON_URL)return process.env.AGENTX_DAEMON_URL.replace(/\/+$/,"");try{let t=Nl(process.cwd(),"agentx.json");if(Ny(t)){let o=JSON.parse(Iy(t,"utf-8"))?.node?.bind;if(typeof o=="string"&&o.includes(":")){let[n,s]=o.split(":");return`http://${n==="0.0.0.0"?"127.0.0.1":n}:${s}`}}}catch{}return"http://127.0.0.1:18800"}function io(e){console.error(ze.red(` ${e}`)),process.exitCode=1}function Ki(e){return async(...t)=>{try{await e(...t)}catch(o){io(o?.message??String(o))}}}function jy(e){let t=e.command("notes").description("notes agents leave for the wiki observe/sweep run: add, list, handle, config");t.command("add").description("leave a note for the wiki observe/sweep run: what changed, the source, the date").requiredOption("--change <text>","what changed, in a sentence or two").requiredOption("--source <text>",'where you saw it: a system, URL, command, or "owner said"').option("--date <YYYY-MM-DD>","when it changed or when you saw it (default: today)").option("--from <agent>","your agent id",process.env.AGENTX_AGENT_ID).option("--daemon <url>","this node's daemon (default: AGENTX_DAEMON_URL, else node.bind in agentx.json)").option("--dir <path>","write straight into this wiki directory instead of going through the daemon (needs --to)").option("--to <agent>","inbox agent, with --dir").option("--json").action(Ki(async o=>{if(!o.from){io("say who you are with --from <agent id>");return}let n={from:o.from,change:o.change,source:o.source,date:o.date},s;if(o.dir){if(!o.to){io("--dir needs --to <inbox agent>");return}let{NoteStore:a,validateNote:c}=await import("./notes-WJJEJ4CJ.js"),l=c({...n,to:o.to});if("error"in l){io(l.error);return}s={ok:!0,...new a(Ol(o.dir)).add(l.note)}}else{let a=vA(o.daemon),c;try{c=await fetch(`${a}/wiki/notes`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(n),signal:AbortSignal.timeout(2e4)})}catch(l){io(`could not reach the daemon at ${a}: ${l?.message??l}`);return}if(s=await c.json().catch(()=>({})),!c.ok){io(s?.error||`daemon answered ${c.status}`);return}}if(o.json){console.log(JSON.stringify(s,null,2));return}let r=s.note,i=s.peer?` on ${s.peer}`:"";console.log(s.added===!1?ze.dim(` already in the inbox${i}: ${r?.id} (${r?.status})`):ze.green(` note ${r?.id} left for ${r?.to}${i}; the next observe/sweep run reads it`))})),t.command("list").description("notes in this node's inbox (waiting ones by default)").option("--status <status>","waiting | open | patched | rejected | deferred | expired | all","waiting").option("--dir <path>","wiki directory").option("--json").action(Ki(async o=>{let{NoteStore:n}=await import("./notes-WJJEJ4CJ.js"),s=["waiting","open","patched","rejected","deferred","expired","all"];if(!s.includes(o.status)){io(`--status must be one of ${s.join(", ")}`);return}let r=new n(Ol(o.dir)),i=r.load();if(i.unreadable){io(`${r.path} is unreadable (${i.unreadable}); repair or move it aside`);return}let a=r.list(o.status==="all"?void 0:o.status);if(o.json){console.log(JSON.stringify(a,null,2));return}if(a.length===0){console.log(ze.dim(` no ${o.status==="all"?"":`${o.status} `}notes`));return}for(let c of a){let l=c.status==="open"?ze.yellow("open"):c.status==="deferred"?ze.yellow("deferred"):ze.dim(c.status);console.log(` ${ze.cyan(c.id)} ${l} \xB7 from ${c.from}${c.fromNode?` on ${c.fromNode}`:""} \xB7 ${c.date}`),console.log(` ${c.change}`),console.log(ze.dim(` source: ${c.source}`)),c.listedIn?.length&&console.log(ze.dim(` given to: ${c.listedIn.at(-1)}${c.listedIn.length>1?` (+${c.listedIn.length-1} earlier)`:""}`)),c.handled&&console.log(ze.dim(` ${c.handled.outcome}${c.deferrals?` (deferred ${c.deferrals}x)`:""} by ${c.handled.by} ${c.handled.at.slice(0,10)}: ${c.handled.reason}`)),c.expired&&console.log(ze.dim(` expired ${c.expired.at.slice(0,10)} after ${c.expired.after} deferrals; no longer offered to the run`))}})),t.command("handle <id>").description("record what the run did with a note: patched, rejected or deferred, with a reason").requiredOption("--outcome <outcome>","patched | rejected | deferred").requiredOption("--reason <text>","what you patched, why you rejected it, or why it waits").option("--run <id>","the run that used it").option("--by <agent>","who handled it",process.env.AGENTX_AGENT_ID||"operator").option("--dir <path>","wiki directory").action(Ki(async(o,n)=>{let{NoteStore:s}=await import("./notes-WJJEJ4CJ.js"),r=new s(Ol(n.dir)).handle(o,n.outcome,n.reason,n.by,n.run);console.log(ze.green(` note ${r.id}: ${r.status}`))})),t.command("config").description("show or set the inbox agent, and the schedules and absorb pass that read it").option("--inbox <agent>",'agent that runs the wiki observe/sweep schedule ("" clears it)').option("--cron <ids>",'comma-separated schedule ids that read the inbox ("" for none)').option("--absorb <agent>",'agent whose `wiki absorb` pass reads and answers the notes ("" clears it)').option("--max <n>","most notes one run is given (1-100)").option("--max-deferrals <n>","times a note may be deferred before it expires (1-20)").option("--enable","turn wiki notes on").option("--disable","turn wiki notes off").option("--json").action(Ki(async o=>{let{patchWikiNotes:n,wikiNotesSettings:s}=await import("./notes-settings-VPXI5IIS.js"),r={};if(o.inbox!==void 0&&(r.inbox=o.inbox),o.cron!==void 0&&(r.crons=String(o.cron).split(",")),o.absorb!==void 0&&(r.absorbAgent=o.absorb),o.max!==void 0&&(r.maxNotesPerRun=Number(o.max)),o.maxDeferrals!==void 0&&(r.maxDeferrals=Number(o.maxDeferrals)),o.enable&&o.disable){io("pick one of --enable and --disable");return}if(o.enable&&(r.enabled=!0),o.disable&&(r.enabled=!1),Object.keys(r).length>0){let{mutateAgentxConfig:c}=await import("./config-mutate-JYW5G7T6.js"),{summary:l}=c(g=>n(g,r));console.log(ze.green(` ${l}`))}let i=Nl(process.cwd(),"agentx.json");if(!Ny(i)){io(`agentx.json not found at ${i}`);return}let a=s(JSON.parse(Iy(i,"utf-8"))?.wikiNotes);if(o.json){console.log(JSON.stringify(a,null,2));return}console.log(` wiki notes: ${a.enabled?ze.green("on"):ze.dim("off")}`),console.log(` inbox agent: ${a.inbox||ze.dim("not set")}`),console.log(` schedules that read it: ${a.crons.length?a.crons.join(", "):ze.dim("none on this node")}`),console.log(` absorb that reads it: ${a.absorbAgent?`wiki absorb for ${a.absorbAgent}`:ze.dim("none")}`),console.log(` most notes per run: ${a.maxNotesPerRun}`),console.log(` deferrals before a note expires: ${a.maxDeferrals}`)}))}import Uo from"chalk";import{resolve as xA}from"path";var Il=e=>e||xA(process.cwd(),".agentx/wiki");function _y(e){let t=e.command("ontology").description("the wiki's pillars, types, typed relations and page lenses (show, init, check)");t.command("init").description("write the default ontology to ontology.yaml in the wiki, to edit").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async o=>{let{writeDefaultOntology:n}=await import("./load-LQ2I2PQI.js");try{let s=n(Il(o.dir));console.log(Uo.green(` wrote ${s}`))}catch(s){console.error(Uo.red(` ${s.message}`)),process.exitCode=1}}),t.command("check").description("report problems in ontology.yaml").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async o=>{let{loadOntology:n}=await import("./load-LQ2I2PQI.js"),{file:s,errors:r}=n(Il(o.dir));if(!s){console.log(Uo.dim(" no ontology.yaml: the built-in defaults are in use"));return}if(r.length===0){console.log(Uo.green(` ${s}: no problems`));return}console.log(Uo.yellow(` ${s}: ${r.length} problem(s)`));for(let i of r)console.log(` - ${i}`);process.exitCode=1}),t.command("show").description("pages per pillar and type, as the wiki view groups them").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--json","print JSON").action(async o=>{let{loadOntology:n}=await import("./load-LQ2I2PQI.js"),{GraphCache:s}=await import("./graph-ZVKV3JBD.js"),{WikiHub:r}=await import("./hub-MOAG5BEQ.js"),i=Il(o.dir),{loadRoster:a}=await import("./roster-BZGKG2ZA.js"),{ontology:c,errors:l}=n(i),g=new r(i,()=>{}),d=new s().get(g,c,a(i,g.listAgents([]),c.agent_names)),f=new Map;for(let p of d.entities.values())f.set(p.type,(f.get(p.type)??0)+1);if(o.json){console.log(JSON.stringify({entities:d.entities.size,types:Object.fromEntries(f),errors:l},null,2));return}console.log(Uo.bold(` ${d.entities.size} entities`));for(let p of c.pillars){let u=c.types.filter(y=>y.pillar===p.id),h=u.reduce((y,$)=>y+(f.get($.id)??0),0);console.log(` ${p.label.padEnd(26)} ${String(h).padStart(6)} ${Uo.dim(u.map(y=>`${y.id} ${f.get(y.id)??0}`).join(" \xB7 "))}`)}l.length&&console.log(Uo.yellow(` ontology.yaml has ${l.length} problem(s): agentx wiki ontology check`))})}import Xe from"chalk";import{resolve as SA}from"path";var jl=e=>e||SA(process.cwd(),".agentx/wiki"),AA=()=>new Date().toISOString().slice(0,10);async function _l(e){let{WikiHub:t}=await import("./hub-MOAG5BEQ.js"),{GraphCache:o}=await import("./graph-ZVKV3JBD.js"),{loadOntology:n}=await import("./load-LQ2I2PQI.js"),{loadRoster:s}=await import("./roster-BZGKG2ZA.js"),r=new t(e,()=>{}),{ontology:i}=n(e),a=new o().get(r,i,s(e,r.listAgents([]),i.agent_names));return{hub:r,g:a}}function Dy(e,t){let o=Number(e);return Number.isInteger(o)&&o>=1?o:(console.error(Xe.red(` ${t} must be a whole number, 1 or more`)),process.exitCode=1,null)}function Py(e){let t=e.command("events").description("give each event page an importance level (minor, normal, major) and the pages it is about").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--about <titles...>","only events linked to or naming these pages (a pilot)").option("--max <n>","most events per run","200").option("--batch <n>","events per model call","20").option("--max-cost <usd>","stop before the next call once the run spent this much","1").option("--model <m>","model","haiku").option("--rules-only","use only the importance rules in ontology.yaml; no model call").option("--force","redo events whose level this job set earlier").option("--dry-run","show what would be written, write nothing").option("--json","print the run as JSON").action(async o=>{let{runEvents:n,summariseAbout:s}=await import("./event-levels-NBOMTB23.js"),{claudeCall:r}=await import("./wiki-enrich-TJIL4B3V.js"),i=Dy(o.max,"--max"),a=Dy(o.batch,"--batch");if(i===null||a===null)return;let c=Number(o.maxCost);if(!Number.isFinite(c)||c<=0){console.error(Xe.red(" --max-cost must be a positive number of dollars")),process.exitCode=1;return}let{hub:l,g}=await _l(jl(o.dir)),d=o.about??[],{normName:f}=await import("./graph-ZVKV3JBD.js"),p=d.filter($=>!g.names.has(f($))&&!g.entities.has($));if(p.length){console.error(Xe.red(` no page is titled: ${p.join(", ")}`)),process.exitCode=1;return}let u=await n(l,g,r(o.model),{about:d,max:i,batch:a,maxCostUsd:c,dryRun:!!o.dryRun,force:!!o.force,rulesOnly:!!o.rulesOnly,today:AA()}),h=s(g,u,d);if(o.json){console.log(JSON.stringify({...u,about:h},null,2));return}for(let $ of u.outcomes){let b=$.status==="written"?Xe.green("\u2713"):$.status==="dry-run"?Xe.cyan("~"):Xe.yellow("\xB7"),v=$.importance?`${$.importance}${$.proposed?` (proposed ${$.proposed})`:""}`:$.status;console.log(` ${b} ${$.date||"no date "} ${v.padEnd(8)} ${$.title} ${Xe.dim(`${$.by??$.status}${$.about.length?` \xB7 about ${$.about.join(", ")}`:""}${$.why?` \xB7 ${$.why}`:""}`)}`);for(let x of $.dropped.slice(0,4))console.log(Xe.dim(` dropped: ${x}`))}for(let $ of h)console.log(Xe.bold(` ${$.title}`)+Xe.dim(` (${$.type}): ${$.before} events in its History before \xB7 after: ${$.after.major} major, ${$.after.normal} normal, ${$.after.minor} minor (folded)`));let y=u.outcomes.filter($=>$.importance).length;u.outcomes.length===0&&console.log(Xe.dim(" nothing to do: every event in scope already has a level (--force redoes the ones this job set)")),console.log(Xe.dim(` ${y} event${y===1?"":"s"} ${o.dryRun?"would get":"got"} a level \xB7 ${u.left} left \xB7 ${u.calls} model call${u.calls===1?"":"s"} \xB7 spent $${u.costUsd.toFixed(3)} of $${c}${u.capped?" \xB7 stopped at the cap":""}`)),u.outcomes.some($=>$.status==="failed")&&(process.exitCode=1)});t.command("set <title> <level>").description("set an event's importance yourself (minor, normal or major); no later run changes it").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(o,n,s,r)=>{let{setEventLevel:i}=await import("./event-levels-NBOMTB23.js"),{IMPORTANCE_LEVELS:a}=await import("./types-YZX46RES.js"),c=n.toLowerCase();if(!a.includes(c)){console.error(Xe.red(` level must be one of ${a.join(", ")}`)),process.exitCode=1;return}let{hub:l,g}=await _l(jl(r.optsWithGlobals().dir)),d=i(l,g,o,c);d.ok?console.log(Xe.green(` ${d.title} is now ${c}`)+Xe.dim(` (${d.page})`)):(console.error(Xe.red(` not set: ${d.reason}`)),process.exitCode=1)}),t.command("proposed").description("list events a run suggests as major, waiting for you to decide").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--json","print as JSON").action(async(o,n)=>{let s=n.optsWithGlobals(),{g:r}=await _l(jl(s.dir)),i=[...r.entities.values()].filter(a=>a.type==="event"&&a.importanceProposed&&a.importanceProposed!==a.importance).sort((a,c)=>(c.date||"").localeCompare(a.date||""));if(s.json){console.log(JSON.stringify(i.map(a=>({id:a.id,title:a.title,date:a.date,importance:a.importance,proposed:a.importanceProposed})),null,2));return}for(let a of i)console.log(` ${a.date||"no date "} ${a.title} ${Xe.dim(`now ${a.importance}, proposed ${a.importanceProposed}`)}`);console.log(Xe.dim(i.length?` ${i.length} waiting. Decide each with: agentx wiki events set "<title>" major (or normal)`:" none waiting"))})}import vt from"chalk";import{resolve as EA}from"path";var RA=e=>e||EA(process.cwd(),".agentx/wiki");function My(e){e.command("rules [pages...]").description("write one obligation page per rule the wiki states, with deadline, penalty, source and check date").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--words <list>","comma-separated words that mark a page as stating rules (default: deadline, penalty, filing\u2026 in English, French and Arabic)").option("--max <n>","most source pages per run","10").option("--max-cost <usd>","stop before the next call once the run spent this much","1").option("--model <m>","model","sonnet").option("--force","read again pages that did not change").option("--dry-run","show what would be written, write nothing").option("--json","print the run as JSON").action(async(t,o)=>{let{WikiHub:n}=await import("./hub-MOAG5BEQ.js"),{GraphCache:s}=await import("./graph-ZVKV3JBD.js"),{loadOntology:r}=await import("./load-LQ2I2PQI.js"),{loadRoster:i}=await import("./roster-BZGKG2ZA.js"),{loadRulesState:a,ruleWordsPattern:c,runRules:l,saveRulesState:g}=await import("./rules-5ZZQZLQA.js"),d=RA(o.dir),f=Number(o.max);if(!Number.isInteger(f)||f<1){console.error(vt.red(" --max must be a whole number of pages, 1 or more")),process.exitCode=1;return}let p=Number(o.maxCost);if(!Number.isFinite(p)||p<=0){console.error(vt.red(" --max-cost must be a positive number of dollars")),process.exitCode=1;return}let u=o.words?.split(",").map(x=>x.trim()).filter(Boolean);if(o.words!==void 0&&!u?.length){console.error(vt.red(" --words needs at least one word")),process.exitCode=1;return}let h=new n(d,()=>{}),{ontology:y}=r(d);if(!y.types.some(x=>x.id==="obligation")){console.error(vt.red(" ontology.yaml has no `obligation` type; add it back to write rule pages")),process.exitCode=1;return}let $=new s().get(h,y,i(d,h.listAgents([]),y.agent_names)),b=a(d),v=await l(h,$,Xm(o.model),{only:t,words:c(u),max:f,maxCostUsd:p,dryRun:!!o.dryRun,force:!!o.force,today:new Date().toISOString().slice(0,10),save:x=>g(d,x)},b);if(o.json){console.log(JSON.stringify(v,null,2));return}for(let x of v.outcomes){let S=x.status==="written"?vt.green("\u2713"):x.status==="dry-run"?vt.cyan("~"):vt.yellow("\xB7");console.log(` ${S} ${x.title} ${vt.dim(`${x.status} \xB7 ${x.page??"no page"} \xB7 ${x.rules.length} rules \xB7 $${x.costUsd.toFixed(3)}`)}`);for(let k of x.rules){let A=[k.deadline?"":"no deadline",k.penalty?"":"no penalty"].filter(Boolean);console.log(` ${k.created?"new":"updated"}: ${k.title} ${vt.dim(`\xB7 ${k.page}${A.length?` \xB7 ${A.join(", ")}`:""}${k.linked.length?` \xB7 linked from ${k.linked.join(", ")}`:""}`)}`),k.preview&&console.log(vt.dim(k.preview.split(`
|
|
542
542
|
`).map(R=>` | ${R}`).join(`
|
|
543
|
-
`)))}for(let k of x.dropped.slice(0,6))console.log(vt.dim(` dropped: ${k}`))}v.outcomes.length===0&&console.log(vt.dim(" nothing to do: no page that states rules changed since the last run (--force reads them again)")),console.log(vt.dim(` spent $${v.costUsd.toFixed(3)} of $${p}${v.capped?" \xB7 stopped at the cap":""}`))})}import Qi from"chalk";import{resolve as CA}from"path";var TA=e=>e||CA(process.cwd(),".agentx/wiki");function Ly(e){e.command("summarize").description("write the one-line page summaries `wiki query` picks pages from; only new or changed pages are summarised").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--agent <id>","summarise this agent's pages (default: the calling agent)").option("--all","summarise every agent's pages and the shared pages").option("--model <m>","model (default: wiki.summaries.model, haiku)").option("--batch <n>","pages per model call (default: wiki.summaries.batchSize, 20)").option("--workers <n>","model calls running at once","4").option("--limit <n>","most pages to summarise per agent in this run (0 = all)","0").option("--dry-run","show how many pages are due, call no model, write nothing").option("--json","print the run as JSON").action(async t=>{let{WikiHub:o}=await import("./wiki-
|
|
543
|
+
`)))}for(let k of x.dropped.slice(0,6))console.log(vt.dim(` dropped: ${k}`))}v.outcomes.length===0&&console.log(vt.dim(" nothing to do: no page that states rules changed since the last run (--force reads them again)")),console.log(vt.dim(` spent $${v.costUsd.toFixed(3)} of $${p}${v.capped?" \xB7 stopped at the cap":""}`))})}import Qi from"chalk";import{resolve as CA}from"path";var TA=e=>e||CA(process.cwd(),".agentx/wiki");function Ly(e){e.command("summarize").description("write the one-line page summaries `wiki query` picks pages from; only new or changed pages are summarised").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--agent <id>","summarise this agent's pages (default: the calling agent)").option("--all","summarise every agent's pages and the shared pages").option("--model <m>","model (default: wiki.summaries.model, haiku)").option("--batch <n>","pages per model call (default: wiki.summaries.batchSize, 20)").option("--workers <n>","model calls running at once","4").option("--limit <n>","most pages to summarise per agent in this run (0 = all)","0").option("--dry-run","show how many pages are due, call no model, write nothing").option("--json","print the run as JSON").action(async t=>{let{WikiHub:o}=await import("./wiki-5Y4GSCYL.js"),{summarizeStore:n}=await import("./summaries-BIRSNWGH.js"),{claudeModelCall:s}=await import("./model-call-J7JATTMW.js"),r={model:"haiku",batchSize:20,maxWords:35};try{let{loadDaemonConfig:g}=await import("./config-NFDEJ3NB.js");r=g().wiki.summaries}catch{}let i=new o(TA(t.dir),void 0,"graph"),a=t.agent||process.env.AGENTX_AGENT_ID;if(!t.all&&!a){console.log(Qi.red(" Name an agent with --agent <id>, or pass --all.")),process.exitCode=1;return}let c=t.all?[...i.sharedScope("").map(g=>({id:g.id,store:g.store,skip:g.skip}))]:[{id:a,store:i.getAgentWiki(a),skip:void 0}],l=[];for(let g of c){let d=await n(g.store,{call:s,model:t.model??r.model,batchSize:t.batch?parseInt(t.batch):r.batchSize,maxWords:r.maxWords,workers:parseInt(t.workers),limit:parseInt(t.limit),dryRun:t.dryRun,skip:g.skip,log:t.json?void 0:f=>console.log(Qi.dim(` ${g.id}: ${f}`))});if(l.push({agent:g.id,...d}),!t.json&&(d.pages>0||d.removed>0)){let f=t.dryRun?`${d.due} due`:`${d.written} written${d.failed?Qi.yellow(`, ${d.failed} failed`):""}${d.removed?`, ${d.removed} removed`:""}`;console.log(` ${Qi.bold(g.id)}: ${d.pages} pages, ${f}`)}}t.json&&console.log(JSON.stringify(l,null,2)),l.some(g=>g.failed>0)&&(process.exitCode=1)})}import{resolve as q,relative as Fy,dirname as qy}from"path";import{exec as NA,execSync as kn}from"child_process";import{promisify as IA}from"util";import{appendFileSync as jA,statSync as _A,writeFileSync as Nt,mkdirSync as Jt,readFileSync as It,readdirSync as DA,renameSync as Zi,rmSync as Pl,existsSync as Ke}from"fs";var Hy=IA(NA);function we(e,t){return new Oa(ut(e),void 0,t||"graph")}async function zy(e){let t=[];try{let{loadDaemonConfig:n}=await import("./config-NFDEJ3NB.js");t=(n().mesh?.peers||[]).map(s=>({url:s.url,token:s.token}))}catch{}if(!e?.length)return t;let o=n=>n.replace(/\/$/,"");return e.map(n=>({url:n,token:t.find(s=>o(s.url)===o(n))?.token}))}async function Yy(){try{let{loadDaemonConfig:e}=await import("./config-NFDEJ3NB.js"),t=Object.keys(e().agents||{});return t.length?new Set(t):null}catch{return null}}async function Uy(){try{let{loadDaemonConfig:e}=await import("./config-NFDEJ3NB.js"),t=e().wikiNotes;return!t?.enabled||!t.inbox||!t.absorbAgent?null:{inbox:t.inbox,absorbAgent:t.absorbAgent,max:t.maxNotesPerRun,maxDeferrals:t.maxDeferrals}}catch{return null}}async function PA(){try{let{loadDaemonConfig:e}=await import("./config-NFDEJ3NB.js");return Fm(e().agents||{})}catch{return new Set}}function vn(e,t){let o=e.syncedFrom(t);return o?(console.log(m.yellow(` ${t}'s articles are copied from ${o.node} and read-only here; change them on ${o.node}.`)),process.exitCode=1,!0):!1}async function Wy(){let{sharedQueryEnabled:e}=await import("./query-WWZEARB4.js");return e()}async function Vy(e){let{loadQuerySettings:t}=await import("./query-settings-3FE555NP.js"),o=await t();if(e.method&&!["auto","summaries","catalog"].includes(e.method))return console.log(m.red(` --method takes auto, summaries or catalog, not "${e.method}".`)),process.exitCode=1,null;let n=e.linked===void 0?o.summaries.linkedPages:Number(e.linked);if(!Number.isInteger(n)||n<0||n>10)return console.log(m.red(` --linked takes a whole number from 0 to 10, not "${e.linked}".`)),process.exitCode=1,null;let s={...o.summaries.live,enabled:o.summaries.live.enabled&&e.live!==!1},r={...o.notes,enabled:o.notes.enabled&&e.notes!==!1};return{...o,method:e.method??o.method,summaries:{...o.summaries,linkedPages:n,live:s},notes:r}}function ut(e){return e||q(process.cwd(),".agentx/wiki")}function Ml(e){return e==="graph"?"Knowledge Graph":e==="flat"?"Karpathy Flat":"Unified"}var H=new OA().name("wiki").description("wiki knowledge base management");Oy(H);jy(H);_y(H);Km(H);Py(H);My(H);Ly(H);H.command("status").description("show wiki status per agent").option("--dir <path>","wiki directory").option("--mode <mode>","graph (default, canonical) | unified | flat (legacy, back-compat)","graph").action(e=>{let t=e.mode,o=we(e.dir,t),n=o.summary(),r=o.getSharedStore().listEntries().length;console.log(),console.log(m.bold(` Wiki Hub Status [${Ml(t)}]`)),console.log(),console.log(` Total raw entries: ${r}`),console.log(` Agents: ${n.length}`),console.log();for(let a of n){let c=a.unabsorbed>0?m.yellow(`${a.unabsorbed} unabsorbed`):m.green("up to date");if(console.log(` ${m.cyan(a.agentId)}`),console.log(` Entries: ${a.totalEntries} Articles: ${a.totalArticles} ${c}`),console.log(m.dim(` Cited by an article: ${a.cited} Read, not cited: ${a.readNotCited}`)),a.articles.length>0){for(let l of a.articles.slice(0,3))console.log(m.dim(` - ${l.title} [${(l.tags||[]).slice(0,3).join(", ")}]`));a.articles.length>3&&console.log(m.dim(` ... and ${a.articles.length-3} more`))}console.log()}let i=n.reduce((a,c)=>a+c.unabsorbed,0);i>0&&(console.log(m.dim(` ${i} raw entries wait for absorb \u2014 run 'agentx wiki absorb'.`)),console.log())});H.command("lint").description("check wiki for issues per agent").option("--dir <path>","wiki directory").option("--mode <mode>","graph (default, canonical) | unified | flat (legacy, back-compat)","graph").option("--agent <id>","lint a specific agent's wiki").action(async e=>{let t=we(e.dir,e.mode),o=e.agent?[e.agent]:t.listAgents(),n=0;console.log();for(let i of o){let c=t.getAgentWiki(i).lint();if(n+=c.length,c.length===0)console.log(` ${m.cyan(i)}: ${m.green("healthy")}`);else{console.log(` ${m.cyan(i)}: ${m.yellow(`${c.length} issues`)}`);for(let l of c){let g=l.type==="broken-link"?"x":l.type==="orphan"?"?":"!";console.log(` [${g}] ${m.dim(l.type)} ${l.article}: ${l.message}`)}}}let{factContradictions:s}=await import("./ledger-P62U3FHT.js"),r=s(ut(e.dir));if(n+=r.length,r.length>0){console.log(` ${m.cyan("facts")}: ${m.yellow(`${r.length} contradiction(s)`)}`);for(let i of r)console.log(` [!] ${m.dim(i.type)} ${i.articles[0]}: ${i.message}`)}console.log(),n===0&&console.log(m.green(" All agent wikis are healthy")),console.log()});H.command("absorb").description("compile unabsorbed entries into typed per-agent wiki articles (Farzapedia-faithful)").option("--dir <path>","wiki directory").option("--mode <mode>","graph (default, canonical) | unified | flat (legacy, back-compat)","graph").option("--agent <id>","absorb only this agent").option("--dry-run","preview without running").option("--no-facts","skip the system-of-record lookups").option("--max <n>","max entries per agent","10").option("--since <date>","only entries dated on or after YYYY-MM-DD").option("--until <date>","only entries dated on or before YYYY-MM-DD").option("--model <model>","compile model (default: AGENTX_WIKI_ABSORB_MODEL, else sonnet)").option("--run-label <label>","tag this run's lines in _absorb-runs.jsonl, for `wiki absorb-runs`").option("--no-notes","do not read the wiki notes inbox, even for wikiNotes.absorbAgent").action(async e=>{let t=e.mode,o;try{o=Cl(e.model)}catch(R){console.log(m.red(` ${R.message}`)),process.exitCode=1;return}let n=we(e.dir,t),s=await Yy(),{agents:r,skipped:i}=qm(n.listAgents().filter(R=>!s||s.has(R)),{only:e.agent,off:await PA()}),a=i.length&&e.notes!==!1?(await Uy())?.absorbAgent:void 0;for(let R of i)console.log(` ${m.cyan(R)}: ${m.dim(Um(R,a))}`);let c=r.filter(R=>{let O=n.syncedFrom(R);return O&&console.log(` ${m.cyan(R)}: ${m.dim(`copied from ${O.node}, read-only here; absorb it there`)}`),!O}),l=parseInt(e.max),g=(()=>{try{let R=q(process.cwd(),".agentx/graph");return Ke(R)?new ko({baseDir:R}):null}catch{return null}})(),d=new Map;if(g)try{let R=g.loadIndex();for(let[O,N]of Object.entries(R.entries))d.set(O,N.path)}catch{}let f,p=R=>{let O=R.meta?.intentPath;if(Array.isArray(O)&&O.every(_=>typeof _=="string")&&O.length>0)return O;if(!g||d.size===0)return;let N=String(R.meta?.sender??""),D=g.fingerprint({text:R.content,channel:R.source,sender:N});return d.get(D)},u=(R,O)=>{let N=new Map;for(let _ of R){let J=O.find(Ee=>Ee.id===_);if(!J)continue;let W=p(J);if(!W?.length)continue;let X=W.join("/"),K=N.get(X);K?K.n++:N.set(X,{path:W,n:1})}if(N.size===0)return;let D;for(let _ of N.values())(!D||_.n>D.n)&&(D=_);return D?.path},h=0,y=0,$=0,b=q(n.getBaseDir(),"_absorb-runs.jsonl"),v=typeof e.runLabel=="string"&&e.runLabel.trim()?e.runLabel.trim():void 0,x=R=>{if(!e.dryRun)try{jA(b,`${JSON.stringify(R)}
|
|
544
544
|
`)}catch{}},S=new Date().toISOString(),k=e.notes===!1?null:await Uy(),A=k?new ag(n.getBaseDir()):null;for(let R of c){let O=Date.now(),N=typeof e.since=="string"?e.since.trim():"",D=typeof e.until=="string"?e.until.trim():"",_=n.getUnabsorbedEntries(R).filter(ae=>!N||(ae.date??"")>=N).filter(ae=>!D||(ae.date??"").slice(0,10)<=D).slice(0,l),J=!!(k&&A&&k.absorbAgent===R),W=`absorb/${R}/${S.replace(/[:.]/g,"-")}`,X=[];if(J&&e.dryRun?X=A.peekForRun(k.inbox,k.max,k.maxDeferrals):J&&(X=A.takeForRun(k.inbox,W,k.max,k.maxDeferrals)),_.length===0&&X.length===0){console.log(` ${m.cyan(R)}: ${m.green("all absorbed")}`);continue}console.log(),console.log(m.bold(` ${m.cyan(R)}: ${_.length} entries to absorb`));for(let ae of _.slice(0,3))console.log(m.dim(` [${ae.date} via ${ae.source}] ${ae.content.slice(0,80)}...`));if(_.length>3&&console.log(m.dim(` ... and ${_.length-3} more`)),X.length>0&&console.log(m.dim(` Wiki notes: ${X.length} from the ${k.inbox} inbox${e.dryRun?"":` (run ${W})`}`)),e.dryRun)continue;let K=n.getAgentWiki(R),Ee=K.rebuildIndex(),Be=K.getWorldview()||n.getSharedStore().getWorldview()||"",P=_.map(ae=>`--- ENTRY ${ae.id} [${ae.date} ${ae.agentId} via ${ae.source}] ---
|
|
545
545
|
${ae.content}
|
|
546
546
|
--- END ENTRY ---`).join(`
|
|
547
547
|
|
|
548
|
-
`),ie="";if(e.facts!==!1){let{extractHints:ae,resolveFacts:Go,mergeRecords:Rn,renderFactsBlock:Cn,installPrompts:Sr,defaultSources:Tn,recordsFromEntries:Ho}=await import("./facts-ROUMKS7I.js");if(!f){let F=new Set;for(let Le of n.listAgents())for(let mt of n.getAgentWiki(Le).listArticles(Le))mt.meta.type==="person"&&F.add(mt.meta.title);f=[...F]}let zo=ae(_.map(F=>({context:F.sourceContext,content:F.content,sender:typeof F.meta?.sender=="string"?F.meta.sender:void 0})),{known:f}),On=Ho(_);if(zo.length>0||On.length>0){let F=Tn(),{records:Le,results:mt}=zo.length>0?await Go(zo,{sources:F}):{records:[],results:[]},be=Rn([...On,...Le]);ie=Cn(be);let tt=[...On.length>0?[`entries:${On.length}`]:[],...mt.filter(je=>je.records.length>0).map(je=>`${je.source}:${je.records.length}`)];console.log(m.dim(` Facts: ${zo.length} entities \u2192 ${be.length} resolved${tt.length?` (${tt.join(" ")})`:""}`));for(let je of Sr(mt,F))console.log(m.yellow(` ! ${je.source} ${je.kind} \u2014 would supply ${je.provides.join(", ")}`)),console.log(m.dim(` ${je.hint}`))}}let Te=Ee.articles.filter(ae=>ae.path&&!ae.path.includes("/_versions/")),le=await Hm([..._,...X.map(ae=>({id:Tl(ae.id),content:ae.change}))],K,R,Te);le.length>0&&console.log(m.dim(` Existing: ${le.map(ae=>ae.path).join(", ")}`));let I=zm(le),fe=Cy(X),et=Fa(t,R,Be,Ee.articles,P,_.length,ie,I,fe);console.log(m.dim(` Mode: ${Ml(t)}`));let Yt=q(K.baseDir,"_tmp");Jt(Yt,{recursive:!0});let Ne=q(Yt,"absorb-prompt.txt");Nt(Ne,et),console.log(m.dim(` Compiling with Claude (${o})...`));let Ie={kind:"call",at:"",label:v,agent:R,model:o,entries:_.length,articles:0,refused:0,failed:!0,wallMs:0,promptChars:et.length,promptParts:{entries:P.length,catalog:et.length-Fa(t,R,Be,[],P,_.length,ie,I,fe).length,catalogArticles:Ee.articles.length,covering:I.length,facts:ie.length,worldview:Be.length,notes:fe.length},...X.length?{notes:X.length}:{}},co=Date.now();Ie.prepMs=co-O;try{let ae,Go=!1;try{ae=kn(`cat '${Ne}' | claude -p - --output-format json --max-turns 3 --model '${o}' --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,{env:bo(),encoding:"utf-8",timeout:9e5,maxBuffer:10*1024*1024})}catch(F){if(ae=F.stdout||"",!ae)throw F;Go=!0}let Rn=ae;try{let F=JSON.parse(ae);Object.assign(Ie,cc(F)),F.is_error===!0&&(Go=!0),Rn=F.result||F.content||"",Rn||(console.log(m.dim(` Claude envelope keys: ${Object.keys(F).join(", ")}`)),console.log(m.dim(` is_error: ${F.is_error}, stop_reason: ${F.stop_reason}`)))}catch{}let Cn=Ey(Rn);if("error"in Cn){X.length>0&&console.log(m.yellow(` ${X.length} wiki note(s) stay waiting`)),console.log(m.red(` ${Cn.error}`)),console.log(m.dim(` First 500 chars: ${Rn.slice(0,500)}`));continue}let{articles:Sr,gaps:Tn}=Cn,Ho=new Set,zo=new Set,On=new Set(_.map(F=>F.id));for(let F of Sr){let Le=new Date().toISOString().slice(0,10),mt=Array.isArray(F.sources)?F.sources:[],be=X.length>0?mt.filter($o=>On.has($o)):mt;if(X.length>0&&be.length===0){console.log(m.yellow(` ! refused ${F.path}: cites no entry from this batch; a wiki note only patches`)),Ie.refused++;continue}let tt=Ym(F,Te);tt!==F.path&&(console.log(m.dim(` ~ ${F.path} \u2192 ${tt} (an article with this title exists)`)),F.path=tt);let je=K.readArticle(F.path);if(je){let $o=Ps(je.content,String(F.content??""));if($o.length>0){console.log(m.yellow(` ! refused ${F.path}: the rewrite drops ${$o.length} fact(s) the article has`)),console.log(m.dim(` ${$o.slice(0,8).join("; ")}${$o.length>8?"; \u2026":""}`));for(let W$ of be)Ho.add(W$);Ie.refused++;continue}}let xa=u(be,_)??je?.meta.graphPath;K.writeArticle(F.path,{title:F.title,type:F.type,related:Array.isArray(F.related)?F.related:void 0,tags:F.tags||[],owner:R,access:je?.meta.access??"public",sharedWith:je?.meta.sharedWith?.length?je.meta.sharedWith:void 0,created:je?.meta.created||Le,lastUpdated:Le,sources:[...new Set([...je?.meta.sources??[],...be])],graphPath:xa},F.content,R);let q$=F.type?m.magenta(`[${F.type}]`)+" ":"",U$=Array.isArray(F.related)&&F.related.length?` \u2192 ${F.related.slice(0,3).join(", ")}${F.related.length>3?", \u2026":""}`:"";console.log(` ${m.green(je?"~":"+")} ${q$}${F.path}: ${F.title}${m.dim(U$)}`);let yd=(F.tags||[]).slice(0,4).join(", ");yd&&console.log(m.dim(` tags: ${yd}`)),xa?.length&&(console.log(m.dim(` graphPath: ${xa.join(" \u203A ")}`)),y++),h++,Ie.articles++;for(let $o of be)zo.add($o)}if(X.length>0&&!Go){let F=X.filter(be=>{let tt=A.get(be.id);return tt&&tt.status!=="open"&&tt.status!=="deferred"?(console.log(m.dim(` note ${be.id} already ${tt.status} by ${tt.handled?.by??"another run"}; left as it is`)),!1):tt?.handled&&tt.handled.at>S?(console.log(m.dim(` note ${be.id} already deferred by ${tt.handled.by} during this run; left as it is`)),!1):!0}),Le=Ty(F,Ry(Cn.notes),K,{agentId:R,paths:new Set(le.map(be=>be.path))}),mt=0;for(let be of Le){try{A.handle(be.id,be.outcome,be.reason,R,W),mt++}catch(je){console.log(m.yellow(` ! note ${be.id}: could not record ${be.outcome}: ${je?.message??je}`))}let tt=be.outcome==="patched"?m.green("~"):be.outcome==="rejected"?m.red("x"):m.yellow("\u2026");console.log(` ${tt} note ${be.id} ${be.outcome}: ${m.dim(be.reason.slice(0,160))}`)}Ie.notesPatched=Le.filter(be=>be.outcome==="patched").length,Ie.notesRecorded=mt}else X.length>0&&console.log(m.yellow(` ${X.length} wiki note(s) stay waiting`));if(Ie.failed=Go,Ie.heldCited=[...Ho].filter(F=>zo.has(F)).length,Go)console.log(m.yellow(` Run reported an error \u2014 ${_.length} entries stay queued`));else{let F=_.map(Le=>Le.id).filter(Le=>!Ho.has(Le));Ho.size>0&&console.log(m.yellow(` ${_.length-F.length} entries stay queued behind refused saves`)),n.markProcessed(R,F,Sr.flatMap(Le=>Le.sources||[]).filter(Le=>!Ho.has(Le)))}if(Tn.length>0){console.log(),console.log(m.yellow(` Gaps detected (${Tn.length} missing pieces):`));for(let F of Tn)console.log(m.yellow(` ? ${F}`));try{let{QuestionStore:F}=await import("./questions-ZATLU5AW.js"),Le=new F(ut(e.dir)).add(Tn.map(mt=>({kind:"article",agentId:R,path:"",subject:String(mt).slice(0,120),question:`No article yet for: ${String(mt).slice(0,160)}`})));Le.added>0&&console.log(m.dim(` queued ${Le.added} for follow-up (agentx wiki questions)`))}catch{}}K.rebuildIndex()}catch(ae){console.log(m.red(` Absorb failed: ${ae.message?.slice(0,200)}`)),ae.stderr&&console.log(m.dim(String(ae.stderr).slice(0,300))),ae.stdout&&console.log(m.dim("stdout: "+String(ae.stdout).slice(0,300)))}finally{Ie.at=new Date().toISOString(),Ie.wallMs=Date.now()-co,Ie.failed&&$++,x(Ie)}}if(x({kind:"run",label:v,startedAt:S,endedAt:new Date().toISOString(),max:l,model:o,failed:$}),console.log(),e.dryRun)console.log(m.dim(" Dry run \u2014 no changes made"));else if(h>0&&(console.log(m.green(` ${h} articles compiled across ${c.length} agent(s)`)),g)){let R=h>0?Math.round(y/h*100):0;console.log(m.dim(` ${y}/${h} carry graphPath (${R}%) \u2014 wiki retrieval graph weight is now non-zero for those`))}$>0&&(console.log(m.red(` ${$} absorb call(s) failed; their entries stay queued`)),process.exitCode=1),console.log()});H.command("absorb-eval").description("score absorbed articles against the entries they cite").option("--dir <path>","wiki directory").option("--mode <mode>","graph | unified | flat","graph").option("--agent <id>","only this agent's articles").option("--since <date>","only articles last updated on or after YYYY-MM-DD").option("--changed-after <time>","only articles whose file changed after this time (ISO, e.g. 2026-10-07T20:05:00Z)").option("--n <n>","articles in the sample","40").option("--seed <seed>","sample seed; the same seed picks the same articles","absorb-eval").option("--sample <file>","reuse the sample saved in this file, or save it there on first use").option("--judge","also ask a model to check each article's claims (one call per article)").option("--judge-model <model>","model for --judge","sonnet").option("--out <file>","write the scorecard as Markdown to this file").option("--json","print the scorecard and every article's checks as JSON").action(async e=>{let{pickSample:t,checkArticle:o,findDuplicates:n,buildJudgePrompt:s,parseJudgeReply:r,buildScorecard:i,renderScorecard:a,uncitedWithFacts:c}=await import("./absorb-eval-
|
|
548
|
+
`),ie="";if(e.facts!==!1){let{extractHints:ae,resolveFacts:Go,mergeRecords:Rn,renderFactsBlock:Cn,installPrompts:Sr,defaultSources:Tn,recordsFromEntries:Ho}=await import("./facts-ROUMKS7I.js");if(!f){let F=new Set;for(let Le of n.listAgents())for(let mt of n.getAgentWiki(Le).listArticles(Le))mt.meta.type==="person"&&F.add(mt.meta.title);f=[...F]}let zo=ae(_.map(F=>({context:F.sourceContext,content:F.content,sender:typeof F.meta?.sender=="string"?F.meta.sender:void 0})),{known:f}),On=Ho(_);if(zo.length>0||On.length>0){let F=Tn(),{records:Le,results:mt}=zo.length>0?await Go(zo,{sources:F}):{records:[],results:[]},be=Rn([...On,...Le]);ie=Cn(be);let tt=[...On.length>0?[`entries:${On.length}`]:[],...mt.filter(je=>je.records.length>0).map(je=>`${je.source}:${je.records.length}`)];console.log(m.dim(` Facts: ${zo.length} entities \u2192 ${be.length} resolved${tt.length?` (${tt.join(" ")})`:""}`));for(let je of Sr(mt,F))console.log(m.yellow(` ! ${je.source} ${je.kind} \u2014 would supply ${je.provides.join(", ")}`)),console.log(m.dim(` ${je.hint}`))}}let Te=Ee.articles.filter(ae=>ae.path&&!ae.path.includes("/_versions/")),le=await Hm([..._,...X.map(ae=>({id:Tl(ae.id),content:ae.change}))],K,R,Te);le.length>0&&console.log(m.dim(` Existing: ${le.map(ae=>ae.path).join(", ")}`));let I=zm(le),fe=Cy(X),et=Fa(t,R,Be,Ee.articles,P,_.length,ie,I,fe);console.log(m.dim(` Mode: ${Ml(t)}`));let Yt=q(K.baseDir,"_tmp");Jt(Yt,{recursive:!0});let Ne=q(Yt,"absorb-prompt.txt");Nt(Ne,et),console.log(m.dim(` Compiling with Claude (${o})...`));let Ie={kind:"call",at:"",label:v,agent:R,model:o,entries:_.length,articles:0,refused:0,failed:!0,wallMs:0,promptChars:et.length,promptParts:{entries:P.length,catalog:et.length-Fa(t,R,Be,[],P,_.length,ie,I,fe).length,catalogArticles:Ee.articles.length,covering:I.length,facts:ie.length,worldview:Be.length,notes:fe.length},...X.length?{notes:X.length}:{}},co=Date.now();Ie.prepMs=co-O;try{let ae,Go=!1;try{ae=kn(`cat '${Ne}' | claude -p - --output-format json --max-turns 3 --model '${o}' --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,{env:bo(),encoding:"utf-8",timeout:9e5,maxBuffer:10*1024*1024})}catch(F){if(ae=F.stdout||"",!ae)throw F;Go=!0}let Rn=ae;try{let F=JSON.parse(ae);Object.assign(Ie,cc(F)),F.is_error===!0&&(Go=!0),Rn=F.result||F.content||"",Rn||(console.log(m.dim(` Claude envelope keys: ${Object.keys(F).join(", ")}`)),console.log(m.dim(` is_error: ${F.is_error}, stop_reason: ${F.stop_reason}`)))}catch{}let Cn=Ey(Rn);if("error"in Cn){X.length>0&&console.log(m.yellow(` ${X.length} wiki note(s) stay waiting`)),console.log(m.red(` ${Cn.error}`)),console.log(m.dim(` First 500 chars: ${Rn.slice(0,500)}`));continue}let{articles:Sr,gaps:Tn}=Cn,Ho=new Set,zo=new Set,On=new Set(_.map(F=>F.id));for(let F of Sr){let Le=new Date().toISOString().slice(0,10),mt=Array.isArray(F.sources)?F.sources:[],be=X.length>0?mt.filter($o=>On.has($o)):mt;if(X.length>0&&be.length===0){console.log(m.yellow(` ! refused ${F.path}: cites no entry from this batch; a wiki note only patches`)),Ie.refused++;continue}let tt=Ym(F,Te);tt!==F.path&&(console.log(m.dim(` ~ ${F.path} \u2192 ${tt} (an article with this title exists)`)),F.path=tt);let je=K.readArticle(F.path);if(je){let $o=Ps(je.content,String(F.content??""));if($o.length>0){console.log(m.yellow(` ! refused ${F.path}: the rewrite drops ${$o.length} fact(s) the article has`)),console.log(m.dim(` ${$o.slice(0,8).join("; ")}${$o.length>8?"; \u2026":""}`));for(let W$ of be)Ho.add(W$);Ie.refused++;continue}}let xa=u(be,_)??je?.meta.graphPath;K.writeArticle(F.path,{title:F.title,type:F.type,related:Array.isArray(F.related)?F.related:void 0,tags:F.tags||[],owner:R,access:je?.meta.access??"public",sharedWith:je?.meta.sharedWith?.length?je.meta.sharedWith:void 0,created:je?.meta.created||Le,lastUpdated:Le,sources:[...new Set([...je?.meta.sources??[],...be])],graphPath:xa},F.content,R);let q$=F.type?m.magenta(`[${F.type}]`)+" ":"",U$=Array.isArray(F.related)&&F.related.length?` \u2192 ${F.related.slice(0,3).join(", ")}${F.related.length>3?", \u2026":""}`:"";console.log(` ${m.green(je?"~":"+")} ${q$}${F.path}: ${F.title}${m.dim(U$)}`);let yd=(F.tags||[]).slice(0,4).join(", ");yd&&console.log(m.dim(` tags: ${yd}`)),xa?.length&&(console.log(m.dim(` graphPath: ${xa.join(" \u203A ")}`)),y++),h++,Ie.articles++;for(let $o of be)zo.add($o)}if(X.length>0&&!Go){let F=X.filter(be=>{let tt=A.get(be.id);return tt&&tt.status!=="open"&&tt.status!=="deferred"?(console.log(m.dim(` note ${be.id} already ${tt.status} by ${tt.handled?.by??"another run"}; left as it is`)),!1):tt?.handled&&tt.handled.at>S?(console.log(m.dim(` note ${be.id} already deferred by ${tt.handled.by} during this run; left as it is`)),!1):!0}),Le=Ty(F,Ry(Cn.notes),K,{agentId:R,paths:new Set(le.map(be=>be.path))}),mt=0;for(let be of Le){try{A.handle(be.id,be.outcome,be.reason,R,W),mt++}catch(je){console.log(m.yellow(` ! note ${be.id}: could not record ${be.outcome}: ${je?.message??je}`))}let tt=be.outcome==="patched"?m.green("~"):be.outcome==="rejected"?m.red("x"):m.yellow("\u2026");console.log(` ${tt} note ${be.id} ${be.outcome}: ${m.dim(be.reason.slice(0,160))}`)}Ie.notesPatched=Le.filter(be=>be.outcome==="patched").length,Ie.notesRecorded=mt}else X.length>0&&console.log(m.yellow(` ${X.length} wiki note(s) stay waiting`));if(Ie.failed=Go,Ie.heldCited=[...Ho].filter(F=>zo.has(F)).length,Go)console.log(m.yellow(` Run reported an error \u2014 ${_.length} entries stay queued`));else{let F=_.map(Le=>Le.id).filter(Le=>!Ho.has(Le));Ho.size>0&&console.log(m.yellow(` ${_.length-F.length} entries stay queued behind refused saves`)),n.markProcessed(R,F,Sr.flatMap(Le=>Le.sources||[]).filter(Le=>!Ho.has(Le)))}if(Tn.length>0){console.log(),console.log(m.yellow(` Gaps detected (${Tn.length} missing pieces):`));for(let F of Tn)console.log(m.yellow(` ? ${F}`));try{let{QuestionStore:F}=await import("./questions-ZATLU5AW.js"),Le=new F(ut(e.dir)).add(Tn.map(mt=>({kind:"article",agentId:R,path:"",subject:String(mt).slice(0,120),question:`No article yet for: ${String(mt).slice(0,160)}`})));Le.added>0&&console.log(m.dim(` queued ${Le.added} for follow-up (agentx wiki questions)`))}catch{}}K.rebuildIndex()}catch(ae){console.log(m.red(` Absorb failed: ${ae.message?.slice(0,200)}`)),ae.stderr&&console.log(m.dim(String(ae.stderr).slice(0,300))),ae.stdout&&console.log(m.dim("stdout: "+String(ae.stdout).slice(0,300)))}finally{Ie.at=new Date().toISOString(),Ie.wallMs=Date.now()-co,Ie.failed&&$++,x(Ie)}}if(x({kind:"run",label:v,startedAt:S,endedAt:new Date().toISOString(),max:l,model:o,failed:$}),console.log(),e.dryRun)console.log(m.dim(" Dry run \u2014 no changes made"));else if(h>0&&(console.log(m.green(` ${h} articles compiled across ${c.length} agent(s)`)),g)){let R=h>0?Math.round(y/h*100):0;console.log(m.dim(` ${y}/${h} carry graphPath (${R}%) \u2014 wiki retrieval graph weight is now non-zero for those`))}$>0&&(console.log(m.red(` ${$} absorb call(s) failed; their entries stay queued`)),process.exitCode=1),console.log()});H.command("absorb-eval").description("score absorbed articles against the entries they cite").option("--dir <path>","wiki directory").option("--mode <mode>","graph | unified | flat","graph").option("--agent <id>","only this agent's articles").option("--since <date>","only articles last updated on or after YYYY-MM-DD").option("--changed-after <time>","only articles whose file changed after this time (ISO, e.g. 2026-10-07T20:05:00Z)").option("--n <n>","articles in the sample","40").option("--seed <seed>","sample seed; the same seed picks the same articles","absorb-eval").option("--sample <file>","reuse the sample saved in this file, or save it there on first use").option("--judge","also ask a model to check each article's claims (one call per article)").option("--judge-model <model>","model for --judge","sonnet").option("--out <file>","write the scorecard as Markdown to this file").option("--json","print the scorecard and every article's checks as JSON").action(async e=>{let{pickSample:t,checkArticle:o,findDuplicates:n,buildJudgePrompt:s,parseJudgeReply:r,buildScorecard:i,renderScorecard:a,uncitedWithFacts:c}=await import("./absorb-eval-OCR3G5TE.js"),{extractJson:l}=await import("./extract-json-7775Q7KO.js"),g=we(e.dir,e.mode),d=e.agent?[e.agent]:g.listAgents(),f=typeof e.since=="string"?e.since.trim():"",p=typeof e.changedAfter=="string"&&e.changedAfter.trim()?new Date(e.changedAfter.trim()):null;if(p&&Number.isNaN(p.getTime())){console.log(m.red(` not a time: ${e.changedAfter}`)),process.exitCode=1;return}let u=p?p.toISOString().slice(0,19):f,h=new Map;for(let P of g.getSharedStore().listEntries())h.set(P.id,{id:P.id,date:P.date,content:P.content});let y=[];for(let P of d)for(let ie of g.getAgentWiki(P).listArticles(P))y.push({key:`${P}/${ie.path}`,agent:P,article:ie});let $=new Map;for(let P of y)for(let ie of P.article.meta.sources??[]){let Te=$.get(ie);Te?Te.push(P.article.content):$.set(ie,[P.article.content])}let b=P=>{if(!p)return!0;try{return _A(q(g.getAgentWiki(P.agent).baseDir,P.article.path)).mtimeMs>p.getTime()}catch{return!1}},v=y.filter(P=>!f||(P.article.meta.lastUpdated??"")>=f.slice(0,10)).filter(b),x=String(e.seed),S;if(e.sample&&Ke(e.sample)){let P=JSON.parse(It(e.sample,"utf-8"));x=P.seed??x;let ie=new Map(y.map(le=>[le.key,le]));S=P.keys.map(le=>ie.get(le)).filter(le=>!!le);let Te=P.keys.length-S.length;Te>0&&console.error(m.yellow(` ${Te} sampled article(s) no longer exist`))}else S=t(v.map(P=>({...P,path:P.key})),parseInt(e.n),x),e.sample&&(Nt(e.sample,`${JSON.stringify({seed:x,since:u||void 0,keys:S.map(P=>P.key)},null,2)}
|
|
549
549
|
`),console.error(m.dim(` sample saved to ${e.sample}`)));if(S.length===0){console.log(m.yellow(` no articles${u?` changed since ${u}`:""} to score`));return}let k=P=>P.replace(/^---\n[\s\S]*?\n---\n?/,""),A=P=>{let ie=g.getAgentWiki(P.agent).getVersions(P.article.path),Te=u?ie.filter(I=>I.timestamp>=u):ie.slice(0,1),le=Te[Te.length-1];if(le)try{return k(It(le.path,"utf-8"))}catch{return}},R=S.map(P=>({path:P.key,title:P.article.meta.title,type:P.article.meta.type,content:P.article.content,sources:P.article.meta.sources??[],lastUpdated:P.article.meta.lastUpdated,previous:A(P)})),O=R.map(P=>o(P,h,ie=>$.get(ie)??[])),N=new Set(S.map(P=>P.key)),D=d.flatMap(P=>n(y.filter(ie=>ie.agent===P).map(ie=>({path:ie.key,title:ie.article.meta.title,type:ie.article.meta.type,sources:ie.article.meta.sources})),N)),_=[];if(e.judge){let P;try{P=Cl(e.judgeModel)}catch(le){console.log(m.red(` ${le.message}`)),process.exitCode=1;return}let ie=q(g.getBaseDir(),"_tmp");Jt(ie,{recursive:!0});let Te=R.map((le,I)=>({a:le,i:I}));await Promise.all(Array.from({length:Math.min(3,Te.length)},async()=>{for(let le=Te.shift();le;le=Te.shift()){let{a:I,i:fe}=le,et=I.sources.map(Ne=>h.get(Ne)).filter(Ne=>!!Ne),Yt=q(ie,`absorb-eval-${process.pid}-${fe}.txt`);Nt(Yt,s(I,et));try{let{stdout:Ne}=await Hy(`cat '${Yt}' | claude -p - --output-format json --max-turns 1 --model '${P}' --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,{env:bo(),encoding:"utf-8",timeout:3e5,maxBuffer:4194304}),Ie=Ne;try{Ie=JSON.parse(Ne).result??Ne}catch{}let co=r(l(Ie));co?_.push({path:I.path,verdict:co}):console.error(m.yellow(` judge reply for ${I.path} was not usable`))}catch(Ne){console.error(m.yellow(` judge failed for ${I.path}: ${String(Ne?.message??Ne).slice(0,160)}`))}finally{Pl(Yt,{force:!0})}}})),_.sort((le,I)=>le.path.localeCompare(I.path))}let J=new Set(y.flatMap(P=>P.article.meta.sources??[])),W=[];for(let P of d){let ie=q(g.getBaseDir(),"agents",P,"_absorbed.json");if(!Ke(ie))continue;let Te={};try{Te=JSON.parse(It(ie,"utf-8")).entries??{}}catch{continue}for(let[le,I]of Object.entries(Te)){if(J.has(le)||u&&String(I.at??"")<u)continue;let fe=h.get(le);fe&&W.push(fe)}}let X=y.map(P=>P.article.content).join(`
|
|
550
|
-
`),K=c(W,X),Ee=i(O,D,{seed:x,since:u||void 0},_,5,{entries:W.length,lost:K}),Be=a(Ee);e.out&&Nt(e.out,Be),e.json?console.log(JSON.stringify({card:Ee,checks:O},null,2)):e.out?console.log(m.green(` scorecard written to ${e.out}`)):console.log(Be)});H.command("query-runs").description("count wiki queries by outcome, with timing").option("--dir <path>","wiki directory").option("--since <date>","only queries on or after this date or time (ISO)").option("--json","print the summary as JSON").action(async e=>{let{QUERY_RUNS_FILE:t,summariseQueryRuns:o}=await import("./query-runs-VXS572PQ.js"),n=q(ut(e.dir),t);if(!Ke(n)){console.log(m.yellow(` no queries recorded yet (${n})`));return}let s=o(It(n,"utf-8"),typeof e.since=="string"?e.since.trim():void 0);if(e.json){console.log(JSON.stringify(s,null,2));return}console.log(),console.log(m.bold(` ${s.total} queries \xB7 ${s.failed} failed \xB7 p50 ${(s.wallMsP50/1e3).toFixed(1)} s \xB7 p95 ${(s.wallMsP95/1e3).toFixed(1)} s`));for(let[r,i]of Object.entries(s.byStatus).sort((a,c)=>c[1]-a[1]))console.log(` ${r.padEnd(14)} ${i}`);console.log(m.dim(` from: ${Object.entries(s.bySource).map(([r,i])=>`${r} ${i}`).join(" \xB7 ")}`)),console.log()});H.command("absorb-runs").description("time, cost and throughput of absorb runs, grouped by --run-label").option("--dir <path>","wiki directory").option("--label <label>","only this run label").option("--json","print the summary as JSON").action(async e=>{let{summariseRuns:t}=await import("./absorb-eval-
|
|
550
|
+
`),K=c(W,X),Ee=i(O,D,{seed:x,since:u||void 0},_,5,{entries:W.length,lost:K}),Be=a(Ee);e.out&&Nt(e.out,Be),e.json?console.log(JSON.stringify({card:Ee,checks:O},null,2)):e.out?console.log(m.green(` scorecard written to ${e.out}`)):console.log(Be)});H.command("query-runs").description("count wiki queries by outcome, with timing").option("--dir <path>","wiki directory").option("--since <date>","only queries on or after this date or time (ISO)").option("--json","print the summary as JSON").action(async e=>{let{QUERY_RUNS_FILE:t,summariseQueryRuns:o}=await import("./query-runs-VXS572PQ.js"),n=q(ut(e.dir),t);if(!Ke(n)){console.log(m.yellow(` no queries recorded yet (${n})`));return}let s=o(It(n,"utf-8"),typeof e.since=="string"?e.since.trim():void 0);if(e.json){console.log(JSON.stringify(s,null,2));return}console.log(),console.log(m.bold(` ${s.total} queries \xB7 ${s.failed} failed \xB7 p50 ${(s.wallMsP50/1e3).toFixed(1)} s \xB7 p95 ${(s.wallMsP95/1e3).toFixed(1)} s`));for(let[r,i]of Object.entries(s.byStatus).sort((a,c)=>c[1]-a[1]))console.log(` ${r.padEnd(14)} ${i}`);console.log(m.dim(` from: ${Object.entries(s.bySource).map(([r,i])=>`${r} ${i}`).join(" \xB7 ")}`)),console.log()});H.command("absorb-runs").description("time, cost and throughput of absorb runs, grouped by --run-label").option("--dir <path>","wiki directory").option("--label <label>","only this run label").option("--json","print the summary as JSON").action(async e=>{let{summariseRuns:t}=await import("./absorb-eval-OCR3G5TE.js"),o=q(ut(e.dir),"_absorb-runs.jsonl");if(!Ke(o)){console.log(m.yellow(` no absorb runs recorded yet (${o})`));return}let n=It(o,"utf-8").split(`
|
|
551
551
|
`).filter(Boolean).flatMap(c=>{try{return[JSON.parse(c)]}catch{return[]}}).filter(c=>!e.label||(c.label||"(none)")===e.label),s=t(n);if(e.json){console.log(JSON.stringify(s,null,2));return}if(s.length===0){console.log(m.yellow(" no matching runs"));return}let r=[["label",c=>c.label],["calls",c=>`${c.calls}${c.failed?` (${c.failed} failed)`:""}`],["entries",c=>String(c.entries)],["articles",c=>`${c.articles}${c.refused?` (${c.refused} refused${c.heldCited?`, ${c.heldCited} held entries lost`:""})`:""}`],["wall",c=>`${(c.wallMs/6e4).toFixed(1)} min`],["call p50/p95",c=>`${Math.round(c.callMsP50/1e3)}/${Math.round(c.callMsP95/1e3)} s`],["entries/min",c=>c.entriesPerMinute.toFixed(1)],["prep",c=>`${(c.prepMs/6e4).toFixed(1)} min`],["cost",c=>`$${c.costUsd.toFixed(2)}`],["$/entry",c=>`$${c.costPerEntry.toFixed(3)}`]],i=s.map(c=>r.map(([,l])=>l(c))),a=r.map(([c],l)=>Math.max(c.length,...i.map(g=>g[l].length)));console.log(),console.log(m.bold(r.map(([c],l)=>c.padEnd(a[l])).join(" ")));for(let c of i)console.log(c.map((l,g)=>l.padEnd(a[g])).join(" "));console.log()});H.command("promote").description("promote per-agent memories into shared, authoritative wiki articles").option("--dir <path>","wiki directory (default .agentx/wiki)").option("--memory-dir <path>","the .agentx dir holding agent-memory/ (default .agentx)").option("--since <duration>","memory window, e.g. 24h, 7d","7d").option("--agent <id>","only this agent's memories").option("--types <list>","comma-separated memory types","project,reference,feedback").option("--max <n>","max candidate memories per run","20").option("--via <agentId>","route the LLM call through an agent \u2014 uses the agent's own session, no API key").option("--model <model>","direct Anthropic API \u2014 needs ANTHROPIC_API_KEY").option("--daemon <url>","daemon API base URL for --via","http://127.0.0.1:18800").option("--reviews","also promote findings from session-monitor reviews").option("--review-kinds <list>","which review kinds","decisions,warnings,friction,context").option("--failures","also propose lessons from failures that recur across sessions").option("--min-sessions <n>","sessions a failure must recur in for --failures","3").option("--commit","judge and write proposals for review (default: dry-run)",!1).option("--budget <tokens>","max estimated tokens for the judge prompt","60000").action(async e=>{let t=MA(e.since),o=String(e.types).split(",").map(a=>a.trim()).filter(Boolean),n=["user","feedback","project","reference"],s=o.find(a=>!n.includes(a));s&&(console.log(m.red(` Invalid memory type "${s}". Valid: ${n.join(", ")}`)),process.exit(1)),e.commit&&!e.via&&!e.model&&(console.log(m.red(" --commit needs an LLM: pass --via <agentId> or --model <model>")),process.exit(1)),console.log(),console.log(m.bold(" Memory \u2192 Wiki Promotion")),console.log();let r=[];if(e.reviews){let{reviewsToCandidates:a}=await import("./review-candidates-CIEGXF7K.js"),{default:c}=await import("better-sqlite3"),l=q(process.cwd(),".agentx/db.sqlite");if(!Ke(l))console.log(m.yellow(` --reviews: no ${l}`));else{let g=new c(l,{readonly:!0});try{let d=g.prepare("SELECT id, session_id, agent, source, updated_at, result FROM session_reviews WHERE status='ready' AND result IS NOT NULL AND updated_at >= ? ORDER BY updated_at DESC").all(Date.now()-(t??6048e5));r=a(d,{kinds:String(e.reviewKinds).split(",").map(u=>u.trim()).filter(Boolean)});let f=r.filter(u=>(u.occurrences??1)>1).length;console.log(m.dim(` ${d.length} review(s) in window \u2192 ${r.length} candidate finding(s), ${f} seen in more than one session`));let p=r[0];p&&(p.occurrences??1)>1&&console.log(m.dim(` most recurrent (${p.occurrences} sessions): ${p.memory.description.slice(0,84)}`))}finally{g.close()}}}if(e.failures){let a=Number(e.minSessions);(!Number.isInteger(a)||a<2)&&(console.log(m.red(` Invalid --min-sessions "${e.minSessions}". Use a whole number of 2 or more.`)),process.exit(1));let{loadFailedTraces:c,failuresToCandidates:l}=await import("./failure-candidates-NQX2JMMS.js"),{default:g}=await import("better-sqlite3"),d=q(process.cwd(),".agentx/db.sqlite");if(!Ke(d))console.log(m.yellow(` --failures: no ${d}`));else{let f=new g(d,{readonly:!0});try{let p=c(f,{since:Date.now()-(t??6048e5)}),u=l(p,{minSessions:a});console.log(m.dim(` ${p.length} failed run(s) in window \u2192 ${u.length} failure(s) seen in ${a}+ sessions`));let h=u[0];h&&console.log(m.dim(` most recurrent (${h.occurrences} sessions, ${h.failure.runs} runs): ${h.memory.description.slice(0,84)}`)),r=[...r,...u]}finally{f.close()}}}let i=await Ig({extraCandidates:r,wikiDir:e.dir?q(e.dir):void 0,memoryRoot:e.memoryDir?q(e.memoryDir):void 0,sinceMs:t,agentFilter:e.agent,types:o,max:Number(e.max)||20,viaAgent:e.via,model:e.model,daemonUrl:e.daemon,commit:e.commit,budgetTokens:Number(e.budget)||void 0,log:a=>console.log(m.dim(` ${a}`))});if(i.candidates.length===0){console.log(m.dim(" Nothing unpromoted in window")),console.log();return}console.log(` ${i.candidates.length} candidate(s) in ${i.clusters.length} cluster(s):`);for(let a of i.clusters){let c=a.candidates[0],l=a.corroboratingAgents.length>1?m.green(` \xD7${a.corroboratingAgents.length} agents`):"";console.log(` ${m.cyan(`[${c.memory.type}]`)} ${c.memory.name}${l} ${m.dim(`(${a.corroboratingAgents.join(", ")}, conf ${a.confidence.toFixed(2)})`)}`),console.log(m.dim(` ${c.memory.description}`))}if(console.log(),i.dryRun){console.log(m.dim(" Dry run \u2014 pass --commit to judge and propose")),console.log();return}for(let a of i.proposed){let c=a.type?m.magenta(`[${a.type}]`)+" ":"",l=`${a.agents.length} agent(s)${a.occurrences>1?`, seen in ${a.occurrences} sessions`:""}`;console.log(` ${m.green("?")} ${c}${a.path}: ${a.title} ${m.dim(`(${l})`)}`),console.log(m.dim(` proposal ${a.id}`))}for(let a of i.skipped)console.log(` ${m.yellow("-")} ${a.stamp} ${m.dim(`\u2014 ${a.reason}`)}`);if(i.gaps.length){console.log(),console.log(m.yellow(` Gaps (${i.gaps.length}):`));for(let a of i.gaps)console.log(m.yellow(` ? ${a}`))}for(let a of i.warnings)console.log(m.dim(` ! ${a}`));for(let a of i.errors)console.log(m.red(` x ${a}`));console.log(),console.log(i.errors.length?m.red(` ${i.proposed.length} proposed, ${i.errors.length} error(s)`):m.green(` ${i.proposed.length} proposed, ${i.skipped.length} skipped`)),i.proposed.length&&console.log(m.dim(" Nothing is in the wiki yet. Review with: agentx wiki proposals list")),console.log(),i.errors.length&&process.exit(1)});var ea=H.command("proposals").description("review lessons proposed for the shared wiki (list, show, approve, reject)");function ta(e){return e?q(e):q(process.cwd(),".agentx","wiki")}ea.command("list").description("list proposals (pending by default)").option("--all","include approved and rejected").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async e=>{let{listProposals:t}=await import("./proposals-O4B5LD5T.js"),o=t(ta(e.dir),e.all?void 0:"pending");if(o.length===0){console.log(m.dim(e.all?" no proposals":" nothing pending"));return}for(let n of o){let s=n.evidence,r=s.sources.some(l=>l.kind==="failure")?" \xB7 from a recurring failure":"",i=`${s.agents.join(", ")}${s.occurrences>1?` \xB7 seen in ${s.occurrences} sessions`:""} \xB7 ${s.sources.length} source(s)${r}`,a=n.status==="pending"?"":m.dim(` [${n.status}]`),c=n.replaces?m.yellow("update"):m.green("new");console.log(` ${m.cyan(n.id)}${a}`),console.log(` ${c} ${n.article.path}: ${n.article.title}`),console.log(m.dim(` ${i}`))}});ea.command("show").description("the proposed article and the evidence behind it").argument("<id>","proposal id").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(e,t)=>{let{readProposal:o}=await import("./proposals-O4B5LD5T.js"),n=o(ta(t.dir),e);if(!n){console.error(m.red(` no proposal "${e}"`)),process.exitCode=1;return}console.log(m.bold(` ${n.article.title}`)+m.dim(` \u2192 ${n.article.path} (${n.replaces?"updates an existing article":"new article"}, ${n.status})`)),console.log(),console.log(n.article.content.split(`
|
|
552
552
|
`).map(s=>` ${s}`).join(`
|
|
553
|
-
`)),console.log(),console.log(m.bold(" Evidence"));for(let s of n.evidence.sources){let r=s.author?`${s.author}${s.taskId?` \xB7 task ${s.taskId}`:""}`:s.agentId,i=s.occurrences&&s.occurrences>1?` \xB7 seen in ${s.occurrences} sessions`:"";console.log(` - ${m.cyan(s.kind)} ${s.type}/${s.name} ${m.dim(`(${r}, ${s.updatedAt.slice(0,10)}${i})`)}`),console.log(m.dim(` ${s.description}`)),s.failure&&console.log(m.dim(` failing tool: ${s.failure.tool} \xB7 error: ${s.failure.errorClass} \xB7 ${s.failure.runs} run(s)`)),s.sessions?.length&&console.log(m.dim(` sessions: ${s.sessions.join(", ")}`)),s.tasks?.length&&console.log(m.dim(` runs: ${s.tasks.join(", ")} (agentx trace show <id>)`))}});ea.command("approve").description("write the proposed article into the shared wiki").argument("<id>","proposal id").option("--force","approve even if the article changed since the proposal").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(e,t)=>{let{approveProposal:o}=await import("./promote-AAEZYPBP.js"),n=o(ta(t.dir),e,{force:t.force});if(!n.ok){console.error(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${n.proposal.article.path} written to the shared wiki`))});ea.command("reject").description("decline a proposal; its sources aren't judged again until they change").argument("<id>","proposal id").option("--reason <text>","why, kept with the decision").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(e,t)=>{let{rejectProposal:o}=await import("./promote-AAEZYPBP.js"),n=o(ta(t.dir),e,{reason:t.reason});if(!n.ok){console.error(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${e} rejected`))});function MA(e){if(!e)return;let t=/^(\d+)\s*([smhd])$/.exec(e.trim());t||(console.log(m.red(` Invalid --since "${e}". Use "30m", "24h", or "7d".`)),process.exit(1));let o=Number(t[1]),n=t[2];return o*(n==="s"?1e3:n==="m"?6e4:n==="h"?36e5:864e5)}H.command("ab-test").description("side-by-side comparison: BM25 preload (old) vs agentic query (new) on real task-history messages").option("--dir <path>","wiki directory").option("--agent <id>","which agent to test against (required)").option("--history <path>","task-history root",q(process.cwd(),".agentx/task-history")).option("--n <n>","number of messages to sample (newest first)","10").option("--out <path>","markdown output file (default: stdout)").option("--selector-model <m>","agentic selector model","haiku").option("--synth-model <m>","agentic synthesis model","sonnet").action(async e=>{let{agenticQuery:t}=await import("./query-
|
|
553
|
+
`)),console.log(),console.log(m.bold(" Evidence"));for(let s of n.evidence.sources){let r=s.author?`${s.author}${s.taskId?` \xB7 task ${s.taskId}`:""}`:s.agentId,i=s.occurrences&&s.occurrences>1?` \xB7 seen in ${s.occurrences} sessions`:"";console.log(` - ${m.cyan(s.kind)} ${s.type}/${s.name} ${m.dim(`(${r}, ${s.updatedAt.slice(0,10)}${i})`)}`),console.log(m.dim(` ${s.description}`)),s.failure&&console.log(m.dim(` failing tool: ${s.failure.tool} \xB7 error: ${s.failure.errorClass} \xB7 ${s.failure.runs} run(s)`)),s.sessions?.length&&console.log(m.dim(` sessions: ${s.sessions.join(", ")}`)),s.tasks?.length&&console.log(m.dim(` runs: ${s.tasks.join(", ")} (agentx trace show <id>)`))}});ea.command("approve").description("write the proposed article into the shared wiki").argument("<id>","proposal id").option("--force","approve even if the article changed since the proposal").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(e,t)=>{let{approveProposal:o}=await import("./promote-AAEZYPBP.js"),n=o(ta(t.dir),e,{force:t.force});if(!n.ok){console.error(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${n.proposal.article.path} written to the shared wiki`))});ea.command("reject").description("decline a proposal; its sources aren't judged again until they change").argument("<id>","proposal id").option("--reason <text>","why, kept with the decision").option("--dir <path>","wiki directory (default .agentx/wiki)").action(async(e,t)=>{let{rejectProposal:o}=await import("./promote-AAEZYPBP.js"),n=o(ta(t.dir),e,{reason:t.reason});if(!n.ok){console.error(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${e} rejected`))});function MA(e){if(!e)return;let t=/^(\d+)\s*([smhd])$/.exec(e.trim());t||(console.log(m.red(` Invalid --since "${e}". Use "30m", "24h", or "7d".`)),process.exit(1));let o=Number(t[1]),n=t[2];return o*(n==="s"?1e3:n==="m"?6e4:n==="h"?36e5:864e5)}H.command("ab-test").description("side-by-side comparison: BM25 preload (old) vs agentic query (new) on real task-history messages").option("--dir <path>","wiki directory").option("--agent <id>","which agent to test against (required)").option("--history <path>","task-history root",q(process.cwd(),".agentx/task-history")).option("--n <n>","number of messages to sample (newest first)","10").option("--out <path>","markdown output file (default: stdout)").option("--selector-model <m>","agentic selector model","haiku").option("--synth-model <m>","agentic synthesis model","sonnet").action(async e=>{let{agenticQuery:t}=await import("./query-WWZEARB4.js"),{readdirSync:o,readFileSync:n,existsSync:s}=await import("fs"),{resolve:r,join:i}=await import("path"),a=we(e.dir),c=e.agent;if(!c){console.log(m.red(" --agent <id> is required"));return}let l=a.getAgentWiki(c),g=parseInt(e.n),d=r(e.history,c);if(!s(d)){console.log(m.yellow(` no task-history at ${d}`));return}let f=[],p=o(d).sort().reverse();for(let y of p){let $=i(d,y),b=[];try{b=o($).filter(v=>v.endsWith(".json")).sort().reverse()}catch{continue}for(let v of b){if(f.length>=g)break;try{let x=JSON.parse(n(i($,v),"utf-8")),S=x.message||x.task?.message;typeof S=="string"&&S.trim().length>10&&f.push({id:x.id||v.replace(".json",""),message:S.trim(),ts:x.at||x.timestamp||y})}catch{}}if(f.length>=g)break}if(f.length===0){console.log(m.yellow(` no task messages found under ${d}`));return}console.log(),console.log(m.bold(` A/B harness \u2014 ${f.length} messages from ${c}`)),console.log(m.dim(" OLD: findRelevant() BM25 over title+tags+content, top 3 truncated")),console.log(m.dim(` NEW: agenticQuery() catalog+wikilink walk (selector=${e.selectorModel}, synth=${e.synthModel})`)),console.log();let u=[`# Wiki A/B: ${c}`,"",`_Generated ${new Date().toISOString()} \xB7 ${f.length} messages sampled_`,"","For each message, the OLD BM25 retrieval (what Layer 10 used to preload) is shown alongside the NEW agentic query's selected articles + synthesized answer. Rate each pair on relevance 0\u20132 in the notes column.",""];for(let y=0;y<f.length;y++){let $=f[y];process.stdout.write(m.dim(` [${y+1}/${f.length}] querying... `));let v=l.findRelevant($.message,c,3).map(S=>`- **${S.meta.title}** [${S.meta.type||"?"}] (${S.path})`).join(`
|
|
554
554
|
`)||"_(none returned)_",x;try{let S=await t($.message,l,c,{selectorModel:e.selectorModel,synthModel:e.synthModel});if(S.status!=="ok")x=`_(status: ${S.status}${S.error?" \u2014 "+S.error:""})_`;else{let k=S.citations.map(A=>`\`${A.title}\` [${A.type||"?"}]`).join(", ");x=`**Answer:**
|
|
555
555
|
|
|
556
556
|
${S.answer}
|
|
@@ -567,14 +567,14 @@ Q: ${I.q}
|
|
|
567
567
|
A: ${I.a}`),"","## Existing articles (use [[Title]] wikilinks when referencing these)",b||"(none yet)","","## Output rules","- Output EXACTLY one markdown file: frontmatter (---) + body. No code fences, no preamble.","- Frontmatter fields in this exact order: title, type, related, tags, owner, access, created, last_updated, sources.",' - `title`: "\u2026"',` - \`type\`: ${d}`,' - `related`: ["Article Title", \u2026] (titles that exist in the catalog above; drop if none)'," - `tags`: 2-4 specific tags, lowercase-kebab \u2014 no dates unless type=event",` - \`owner\`: ${e.agent}`," - `access`: public (unless the content is sensitive)",` - \`created\`: ${new Date().toISOString().slice(0,10)}`,` - \`last_updated\`: ${new Date().toISOString().slice(0,10)}`,` - \`sources\`: ["interview-${new Date().toISOString().slice(0,10)}"]`,"- Body: 20-80 lines, Wikipedia-style, organized by theme (not by question), synthesized (not verbatim Q&A).","- Use [[Title]] inline every time you reference something that has an article in the catalog.","- Do NOT invent facts. If the transcript didn't cover something, skip that sub-topic."].join(`
|
|
568
568
|
`),x=q(a.baseDir,"_tmp");Jt(x,{recursive:!0});let S=q(x,`interview-${o().slice(0,8)}.txt`);Nt(S,v),console.log(),console.log(m.dim(` Synthesizing draft with ${e.model}...`));let k="";try{let I=`cat '${S}' | claude -p - --output-format json --max-turns 1 --model ${e.model} --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,fe=kn(I,{env:bo(),encoding:"utf-8",timeout:18e4,maxBuffer:4*1024*1024});try{let et=JSON.parse(fe);k=String(et.result||et.content||"")}catch{k=fe}}catch(I){console.log(m.red(` synthesis failed: ${I.message?.slice(0,200)}`)),c?.close();return}k=k.trim();let A=k.match(/```(?:markdown|md)?\s*\n([\s\S]*?)\n```\s*$/);A&&(k=A[1].trim());let R=k.indexOf("---");R>0&&(k=k.slice(R));let O=k.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);if(!O){console.log(m.red(" LLM output is not a valid frontmatter+body article:")),console.log(k.slice(0,600)),c?.close();return}let N={};for(let I of O[1].split(`
|
|
569
569
|
`)){let fe=I.match(/^(\w+):\s*(.+)$/);fe&&(N[fe[1]]=fe[2].trim().replace(/^"(.*)"$/,"$1"))}let D=O[2],_=N.title||g,J=_.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,60),X=`${{person:"people",project:"projects",place:"places",concept:"concepts",event:"events",decision:"decisions",pattern:"patterns"}[d]||d+"s"}/${J}.md`;console.log(),console.log(m.bold(" === Draft preview ===")),console.log(m.dim(` Path: ${X}`)),console.log(),console.log(k),console.log();let K=await l(` ${m.green("save")} / ${m.yellow("edit (opens $EDITOR)")} / ${m.red("scrap")} ? `);if(c?.close(),K==="scrap"||K==="/abort"){console.log(m.dim(" Discarded."));return}if(!e.commit){console.log(m.dim(" --no-commit: not writing.")),console.log(m.dim(` Draft kept at ${S} (prompt only; no article file)`));return}let Ee=D,Be={title:_,type:N.type||d,related:N.related?N.related.replace(/^\[|\]$/g,"").split(",").map(I=>I.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):void 0,tags:N.tags?N.tags.replace(/^\[|\]$/g,"").split(",").map(I=>I.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):[],owner:e.agent,access:N.access||"public",created:N.created||new Date().toISOString().slice(0,10),lastUpdated:N.last_updated||new Date().toISOString().slice(0,10),sources:[`interview-${new Date().toISOString().slice(0,10)}`]};if(K==="edit"){let I=process.env.EDITOR||"vi",fe=q(x,`draft-${o().slice(0,8)}.md`);Nt(fe,k);try{kn(`${I} '${fe}'`,{stdio:"inherit"});let Yt=It(fe,"utf-8").match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);if(Yt){let Ne={};for(let Ie of Yt[1].split(`
|
|
570
|
-
`)){let co=Ie.match(/^(\w+):\s*(.+)$/);co&&(Ne[co[1]]=co[2].trim().replace(/^"(.*)"$/,"$1"))}Ee=Yt[2],Be={...Be,title:Ne.title||Be.title,type:Ne.type||Be.type,access:Ne.access||Be.access,related:Ne.related?Ne.related.replace(/^\[|\]$/g,"").split(",").map(Ie=>Ie.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):Be.related,tags:Ne.tags?Ne.tags.replace(/^\[|\]$/g,"").split(",").map(Ie=>Ie.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):Be.tags}}}catch(et){console.log(m.red(` editor failed: ${et.message}`));return}}if(!a.writeArticle(X,Be,Ee,e.agent)){console.log(m.red(" write failed (permission?)"));return}a.rebuildIndex(),console.log(m.green(` \u2713 ${X} saved.`));let ie=a.extractWikilinks(Ee),Te=new Map;for(let I of a.listArticles(e.agent))Te.set(I.meta.title.toLowerCase(),!0);let le=ie.filter(I=>!Te.has(I.toLowerCase()));if(le.length){console.log(),console.log(m.bold(" Gaps referenced but not yet covered:"));for(let I of le.slice(0,8))console.log(m.dim(` - ${I}`));console.log(m.dim(` Run \`agentx wiki interview --agent ${e.agent} --topic "<title>"\` for any of these.`))}});H.command("quiz").description("reverse interview \u2014 ask the wiki questions and patch cited articles with corrections, additions, or links").option("--dir <path>","wiki directory").option("--agent <id>","which agent's wiki to quiz (required)").option("--selector-model <m>","candidate-selection model","haiku").option("--synth-model <m>","answer synthesis model","sonnet").option("--patch-model <m>","article patch model","sonnet").option("--rounds <n>","stop after N rounds","20").option("--script <path>","non-interactive: question line + /verdict line per entry, entries separated by blank lines").option("--no-commit","show proposed patches but don't write").option("--out <path>","write a session transcript as markdown").action(async e=>{let t=await import("node:readline/promises"),{randomUUID:o}=await import("node:crypto"),{agenticQuery:n}=await import("./query-
|
|
570
|
+
`)){let co=Ie.match(/^(\w+):\s*(.+)$/);co&&(Ne[co[1]]=co[2].trim().replace(/^"(.*)"$/,"$1"))}Ee=Yt[2],Be={...Be,title:Ne.title||Be.title,type:Ne.type||Be.type,access:Ne.access||Be.access,related:Ne.related?Ne.related.replace(/^\[|\]$/g,"").split(",").map(Ie=>Ie.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):Be.related,tags:Ne.tags?Ne.tags.replace(/^\[|\]$/g,"").split(",").map(Ie=>Ie.trim().replace(/^"(.*)"$/,"$1")).filter(Boolean):Be.tags}}}catch(et){console.log(m.red(` editor failed: ${et.message}`));return}}if(!a.writeArticle(X,Be,Ee,e.agent)){console.log(m.red(" write failed (permission?)"));return}a.rebuildIndex(),console.log(m.green(` \u2713 ${X} saved.`));let ie=a.extractWikilinks(Ee),Te=new Map;for(let I of a.listArticles(e.agent))Te.set(I.meta.title.toLowerCase(),!0);let le=ie.filter(I=>!Te.has(I.toLowerCase()));if(le.length){console.log(),console.log(m.bold(" Gaps referenced but not yet covered:"));for(let I of le.slice(0,8))console.log(m.dim(` - ${I}`));console.log(m.dim(` Run \`agentx wiki interview --agent ${e.agent} --topic "<title>"\` for any of these.`))}});H.command("quiz").description("reverse interview \u2014 ask the wiki questions and patch cited articles with corrections, additions, or links").option("--dir <path>","wiki directory").option("--agent <id>","which agent's wiki to quiz (required)").option("--selector-model <m>","candidate-selection model","haiku").option("--synth-model <m>","answer synthesis model","sonnet").option("--patch-model <m>","article patch model","sonnet").option("--rounds <n>","stop after N rounds","20").option("--script <path>","non-interactive: question line + /verdict line per entry, entries separated by blank lines").option("--no-commit","show proposed patches but don't write").option("--out <path>","write a session transcript as markdown").action(async e=>{let t=await import("node:readline/promises"),{randomUUID:o}=await import("node:crypto"),{agenticQuery:n}=await import("./query-WWZEARB4.js");if(!e.agent){console.log(m.red(" --agent <id> is required."));return}let s=we(e.dir);if(e.commit!==!1&&vn(s,e.agent))return;let r;try{r=s.getAgentWiki(e.agent)}catch(p){console.log(m.red(` can't open wiki for agent "${e.agent}": ${p.message}`));return}let i=null;if(e.script){let u=It(e.script,"utf-8").split(/\n\s*\n/).map(h=>h.trim()).filter(Boolean);i=[];for(let h of u){let y=h.split(/\r?\n/).filter(v=>v.trim());if(y.length<2)continue;let $=y[0].replace(/^Q:\s*/i,"").trim(),b=y.slice(1).join(" ").trim();$&&b&&i.push({q:$,verdict:b})}}let a=i?null:t.createInterface({input:process.stdin,output:process.stdout}),c=async p=>a?(await a.question(p)).trim():"",l=Math.min(parseInt(e.rounds)||20,i?.length??999),g=e.commit!==!1;console.log(),console.log(m.bold(" Wiki Quiz")),console.log(m.dim(` Agent: ${e.agent} \xB7 Rounds: ${l} \xB7 ${g?"commit":"dry-run"} \xB7 ${i?`scripted (${i.length})`:"interactive"}`)),console.log(m.dim(" Verdicts: /ok /correct <note> /add <note> /link <url> /skip /done")),console.log();let d=[],f=0;for(let p=0;p<l;p++){let u,h;if(i){let W=i[p];if(!W)break;u=W.q,h=W.verdict,console.log(m.cyan(` [${p+1}] Q: `)+u)}else{if(u=await c(m.cyan(` [${p+1}] Q: `)),!u||u==="/done"||u==="/abort")break;h=""}process.stdout.write(m.dim(" querying... "));let y;try{y=await n(u,r,e.agent,{selectorModel:e.selectorModel,synthModel:e.synthModel})}catch(W){console.log(m.red(`failed: ${W.message?.slice(0,120)}`));continue}if(console.log(m.dim("done")),y.status!=="ok")console.log(m.yellow(` (status: ${y.status}${y.error?" \u2014 "+y.error:""})`));else{let W=y.citations.map(X=>`${X.title} [${X.type||"?"}]`).join(" \xB7 ");console.log(),console.log(m.dim(" A: ")+y.answer.replace(/\n/g,`
|
|
571
571
|
`)),console.log(m.dim(" citations: "+W))}i||(h=await c(m.cyan(" verdict > "))),console.log(m.dim(" verdict: ")+h);let $={q:u,answer:y.answer,citations:y.citations,verdict:h},b=h.match(/^(\/ok|\/correct|\/add|\/link|\/skip)(?:\s+(.+))?$/i);if(!b){console.log(m.yellow(" (verdict not recognised \u2014 treating as /skip)")),d.push($);continue}let v=b[1].toLowerCase(),x=(b[2]||"").trim();if(d.push($),v==="/ok"||v==="/skip")continue;if(!x){console.log(m.yellow(` ${v} without note \u2014 skipping.`));continue}let S=y.citations[0];if(!S){console.log(m.yellow(" no cited article to patch."));continue}let k=r.readArticle(S.path);if(!k){console.log(m.red(` can't read ${S.path} to patch.`));continue}console.log(m.dim(` patching ${S.title} (${S.path})...`));let A=UA(k.content,v,x,k.meta.title,k.meta.type),R=q(r.baseDir,"_tmp");Jt(R,{recursive:!0});let O=q(R,`quiz-patch-${o().slice(0,8)}.txt`);Nt(O,A);let N="";try{let W=`cat '${O}' | claude -p - --output-format json --max-turns 1 --model ${e.patchModel} --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,X=kn(W,{env:bo(),encoding:"utf-8",timeout:12e4,maxBuffer:4*1024*1024});try{let Ee=JSON.parse(X);N=String(Ee.result||Ee.content||"")}catch{N=X}let K=N.trim().match(/```(?:markdown|md)?\s*\n([\s\S]*?)\n```\s*$/);K&&(N=K[1].trim()),N=N.trim()}catch(W){console.log(m.red(` patch failed: ${W.message?.slice(0,120)}`));continue}if(!N||N.length<20){console.log(m.yellow(" patch returned nothing usable."));continue}let D=k.content.split(`
|
|
572
572
|
`).length,_=N.split(`
|
|
573
573
|
`).length;if(console.log(m.dim(` diff: ${D} \u2192 ${_} lines (${_-D>=0?"+":""}${_-D})`)),!g){console.log(m.dim(" (--no-commit: patch not written)")),$.patched=S.path+" (dry)";continue}if(!r.writeArticle(S.path,{...k.meta,lastUpdated:new Date().toISOString().slice(0,10)},N,e.agent)){console.log(m.red(" write failed (permission?)"));continue}f++,$.patched=S.path,console.log(m.green(` \u2713 patched ${S.path}`))}if(a&&a.close(),f>0&&g&&r.rebuildIndex(),console.log(),console.log(m.bold(` Session done: ${d.length} rounds, ${f} patches applied.`)),e.out){let p=[`# Wiki Quiz \u2014 ${e.agent}`,"",`_Generated ${new Date().toISOString()} \xB7 ${d.length} rounds \xB7 ${f} patches_`,""];for(let u=0;u<d.length;u++){let h=d[u];p.push(`## ${u+1}. Q: ${h.q}`,"",`**A:** ${h.answer}`,"",`**Citations:** ${h.citations.map(y=>`\`${y.title}\``).join(", ")||"_(none)_"}`,"",`**Verdict:** \`${h.verdict}\``+(h.patched?` \u2192 patched \`${h.patched}\``:""),"")}Nt(e.out,p.join(`
|
|
574
574
|
`)),console.log(m.dim(` Transcript written to ${e.out}`))}});H.command("edit <agent> <titleOrPath>").description("open an article in $EDITOR (resolves by title or path), rebuild catalog on exit").option("--dir <path>","wiki directory").option("--editor <cmd>","override $EDITOR for this run").action((e,t,o)=>{let n=we(o.dir);if(vn(n,e))return;let s;try{s=n.getAgentWiki(e)}catch(l){console.log(m.red(` can't open wiki for agent "${e}": ${l.message}`));return}let r=gr(s,t,e);if(!r){console.log(m.yellow(` no article matches "${t}" in ${e}'s wiki.`)),console.log(m.dim(` Tip: ${m.green("agentx wiki status")} lists agents; ${m.green(`agentx wiki search "term" --agent ${e}`)} finds by content.`));return}let i=q(s.baseDir,r),a=o.editor||process.env.EDITOR||"vi";console.log(m.dim(` opening ${r} in ${a}...`));try{kn(`${a} '${i}'`,{stdio:"inherit"})}catch(l){console.log(m.red(` editor exited with error: ${l.message?.slice(0,150)}`));return}let c=s.readArticle(r);if(c){let l=new Set,g=s.extractWikilinks(c.content).filter(p=>l.has(p)?!1:(l.add(p),!0)),d=c.meta.related||[];(g.some(p=>!d.includes(p))||d.some(p=>!g.includes(p)))&&(s.writeArticle(r,{...c.meta,related:g.length?g:void 0,lastUpdated:new Date().toISOString().slice(0,10)},c.content,e),console.log(m.dim(` (synced frontmatter.related from body: ${g.length} wikilink${g.length===1?"":"s"})`)))}try{s.rebuildIndex(),console.log(m.green(` \u2713 ${r} saved. Catalog rebuilt.`))}catch(l){console.log(m.yellow(` saved, but catalog rebuild failed: ${l.message?.slice(0,100)}`))}});async function LA(){let{loadDaemonConfig:e}=await import("./config-NFDEJ3NB.js"),t=e(),o=t.dashboard?.daemonUrl?.replace(/\/+$/,"")||"http://127.0.0.1:18800",n={"Content-Type":"application/json"};return t.dashboard?.token&&(n.Authorization=`Bearer ${t.dashboard.token}`),{url:o,headers:n}}function FA(e){console.log(m.bold(` Page changed: +${e.added} / \u2212${e.removed} lines`));for(let t of e.diff||[]){let o=` ${t.op===" "?" ":t.op} ${t.text}`;console.log(t.op==="+"?m.green(o):t.op==="-"?m.red(o):m.dim(o))}if(e.sources?.length){console.log(m.bold(" Sources"));for(let t of e.sources)console.log(` - ${t}`)}else console.log(m.yellow(" No sources were cited for this change."));e.version&&console.log(m.dim(` Undo: agentx wiki restore <agent> <page> ${e.version}`))}H.command("curate <agent> <titleOrPath> <instruction>").description("ask the page curator agent to research and edit one page (needs the daemon)").option("--dir <path>","wiki directory").option("--timeout <minutes>","stop waiting after this long","30").action(async(e,t,o,n)=>{let s=we(n.dir);if(vn(s,e))return;let r=gr(s.getAgentWiki(e),t,e);if(!r){console.log(m.yellow(` no page matches "${t}" in ${e}'s wiki.`)),process.exitCode=1;return}let{url:i,headers:a}=await LA(),c=async(f,p,u)=>{let h=await fetch(i+p,{method:f,headers:a,...u?{body:JSON.stringify(u)}:{}}),y=await h.json().catch(()=>({}));if(!h.ok)throw new Error(y.error||`HTTP ${h.status}`);return y},l;try{l=await c("POST","/api/wiki/curate",{agent:e,path:r,message:o})}catch(f){console.log(m.red(` ${f.message?.includes("fetch failed")?`the daemon at ${i} is not running`:f.message}`)),process.exitCode=1;return}console.log(m.dim(` ${l.curator} is working on ${r}\u2026`));let g=`?agent=${encodeURIComponent(e)}&path=${encodeURIComponent(r)}`,d=Date.now()+Number(n.timeout||30)*6e4;for(;Date.now()<d;){await new Promise(u=>setTimeout(u,2e3));let p=(await c("GET",`/api/wiki/curate${g}`).catch(()=>null))?.messages?.find(u=>u.id===l.id);if(!(!p||p.status==="pending")){console.log(p.status==="error"?m.red(` ${p.text}`):` ${p.text}`),p.edit&&(p.edit.added||p.edit.removed)&&FA(p.edit),p.status==="error"&&(process.exitCode=1);return}}console.log(m.yellow(" still working; the result will show in the chat on the page."))});H.command("versions <agent> <titleOrPath>").description("list the saved earlier versions of one page, newest first").option("--dir <path>","wiki directory").action((e,t,o)=>{let n=we(o.dir).getAgentWiki(e),s=gr(n,t,e);if(!s){console.log(m.yellow(` no page matches "${t}" in ${e}'s wiki.`)),process.exitCode=1;return}let r=n.getVersions(s);if(!r.length){console.log(m.dim(` ${s} has no earlier versions.`));return}console.log(m.bold(` ${s}`));for(let i of r)console.log(` ${i.timestamp}`)});H.command("restore <agent> <titleOrPath> [version]").description("put a page back to an earlier version (default: the newest); the current text is kept as a version").option("--dir <path>","wiki directory").action((e,t,o,n)=>{let s=we(n.dir);if(vn(s,e))return;let r=s.getAgentWiki(e),i=gr(r,t,e);if(!i){console.log(m.yellow(` no page matches "${t}" in ${e}'s wiki.`)),process.exitCode=1;return}let a=o||r.getVersions(i)[0]?.timestamp,c=!1;try{c=!!a&&r.restoreVersion(i,a)}catch(l){if(!(l instanceof Gd))throw l;console.log(m.red(` ${i} was not restored: the page was busy; run again.`)),process.exitCode=1;return}if(!c){console.log(m.red(` no version ${a?`"${a}" `:""}of ${i}; see agentx wiki versions ${e} "${t}"`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${i} restored to ${a}.`))});H.command("curator").description("show or change the page curator: the chat bubble on wiki pages").option("--on","show the bubble on wiki pages").option("--off","hide the bubble and refuse curator requests").option("--agent <id>","agent that answers on every page").option("--owner","let each page's owner agent answer (the default)").action(async e=>{if(e.on&&e.off){console.log(m.red(" pick --on or --off, not both")),process.exitCode=1;return}if(e.agent&&e.owner){console.log(m.red(" pick --agent or --owner, not both")),process.exitCode=1;return}let{loadDaemonConfig:t}=await import("./config-NFDEJ3NB.js");if(e.on||e.off||e.agent||e.owner){if(e.agent&&!Object.keys(t().agents||{}).includes(e.agent)){console.log(m.red(` no agent "${e.agent}" in agentx.json`)),process.exitCode=1;return}let{mutateAgentxConfig:n}=await import("./config-mutate-JYW5G7T6.js");n(s=>(s.wiki=s.wiki||{},s.wiki.curator=s.wiki.curator||{},e.on&&(s.wiki.curator.enabled=!0),e.off&&(s.wiki.curator.enabled=!1),e.agent&&(s.wiki.curator.agent=e.agent),e.owner&&delete s.wiki.curator.agent,"wiki.curator updated"))}let o=t().wiki?.curator??{enabled:!0};console.log(` Page curator: ${o.enabled?m.green("on"):m.yellow("off")}`),console.log(` Answers: ${o.agent?o.agent:"each page's owner agent"}`)});H.command("patch <agent> <titleOrPath> <instruction>").description("LLM-patch an article from a free-form instruction; shows diff + confirms before writing").option("--dir <path>","wiki directory").option("--patch-model <m>","patch model","sonnet").option("--yes","skip confirmation and write immediately").option("--no-commit","show the patched body but don't write").option("--allow-fact-loss","save even when the patch shrinks the article or drops a phone number, email, role, link or number it had").action(async(e,t,o,n)=>{let s=await import("node:readline/promises"),{randomUUID:r}=await import("node:crypto"),i=we(n.dir);if(vn(i,e))return;let a;try{a=i.getAgentWiki(e)}catch(x){console.log(m.red(` can't open wiki for agent "${e}": ${x.message}`));return}let c=gr(a,t,e);if(!c){console.log(m.yellow(` no article matches "${t}" in ${e}'s wiki.`));return}let l=a.readArticle(c);if(!l){console.log(m.red(` can't read ${c}.`));return}let g=qA(l.content,l.meta.title,l.meta.type,o),d=q(a.baseDir,"_tmp");Jt(d,{recursive:!0});let f=q(d,`patch-${r().slice(0,8)}.txt`);Nt(f,g),console.log(),console.log(m.dim(` Target: ${l.meta.title} (${c})`)),console.log(m.dim(` Patching with ${n.patchModel}...`));let p="";try{let x=`cat '${f}' | claude -p - --output-format json --max-turns 1 --model ${n.patchModel} --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,S=kn(x,{env:bo(),encoding:"utf-8",timeout:12e4,maxBuffer:4*1024*1024});try{let A=JSON.parse(S);p=String(A.result||A.content||"")}catch{p=S}let k=p.trim().match(/```(?:markdown|md)?\s*\n([\s\S]*?)\n```\s*$/);k&&(p=k[1].trim()),p=p.trim()}catch(x){console.log(m.red(` patch failed: ${x.message?.slice(0,150)}`));return}if(!p||p.length<20){console.log(m.yellow(" patch returned nothing usable."));return}let u=l.content.split(`
|
|
575
575
|
`).length,h=p.split(`
|
|
576
|
-
`).length;console.log(),console.log(m.bold(" === Patched preview ===")),console.log(m.dim(` diff: ${u} \u2192 ${h} lines (${h-u>=0?"+":""}${h-u})`)),console.log(),console.log(p),console.log();let y=Vm(l.content,p);if(y.length){for(let x of y)console.log(m.yellow(` ! ${x}`));if(n.commit&&!n.allowFactLoss){console.log(m.yellow(" not saved. If this change is intended, run again with --allow-fact-loss.")),process.exitCode=1;return}}if(!n.commit){console.log(m.dim(" --no-commit: preview only, not written."));return}let $=!!n.yes;if(!$){let x=s.createInterface({input:process.stdin,output:process.stdout}),S=(await x.question(m.cyan(" apply? [y/N] "))).trim().toLowerCase();x.close(),$=S==="y"||S==="yes"}if(!$){console.log(m.dim(" aborted."));return}if(a.readArticle(c)?.content!==l.content){console.log(m.yellow(` ${c} changed while this patch was made (another patch or edit). Not saved; run the patch again.`)),process.exitCode=1;return}let b=[...new Set([...l.meta.related||[],...a.extractWikilinks(p)])];if(!a.writeArticle(c,{...l.meta,related:b.length?b:void 0,lastUpdated:new Date().toISOString().slice(0,10)},p,e)){console.log(m.red(" write failed (permission?)"));return}a.rebuildIndex(),console.log(m.green(` \u2713 ${c} patched.`))});var By=H.command("contribute").description("queue sourced wiki patches from an agent's work since its last run (enable, disable)").option("--dir <path>","wiki directory").option("--agent <id>","contribute for this agent").option("--all","every agent with wiki.contribute.enabled in agentx.json").option("--since <time>","first run only: read work from this date or time (default: the last 24 hours)").option("--max-patches <n>","patches per agent per run (default: the agent's setting, else 30)").option("--max-cost <usd>","model spend per agent per run, in USD (default: the agent's setting, else wiki.contributions.maxCostUsd, else 0.5)").option("--max-items <n>","chat entries and tasks read per agent per run","60").option("--model <model>","model (default: the agent's setting, else wiki.contributions.model, else sonnet)").option("--db <path>","trace database with the agents' task runs",".agentx/db.sqlite").option("--dry-run","show the patches without queueing them or moving the cursor").option("--json","print the batches as JSON").action(async e=>{let{runContribution:t}=await import("./contributions-
|
|
577
|
-
agentx wiki contributions approve <id> \xB7 agentx wiki contributions reject <id>`)),console.log()});dr.command("approve <id>").description("apply a held patch as it is").option("--dir <path>","wiki directory").action(async(e,t)=>{let{approveHeld:o}=await import("./contributions-
|
|
576
|
+
`).length;console.log(),console.log(m.bold(" === Patched preview ===")),console.log(m.dim(` diff: ${u} \u2192 ${h} lines (${h-u>=0?"+":""}${h-u})`)),console.log(),console.log(p),console.log();let y=Vm(l.content,p);if(y.length){for(let x of y)console.log(m.yellow(` ! ${x}`));if(n.commit&&!n.allowFactLoss){console.log(m.yellow(" not saved. If this change is intended, run again with --allow-fact-loss.")),process.exitCode=1;return}}if(!n.commit){console.log(m.dim(" --no-commit: preview only, not written."));return}let $=!!n.yes;if(!$){let x=s.createInterface({input:process.stdin,output:process.stdout}),S=(await x.question(m.cyan(" apply? [y/N] "))).trim().toLowerCase();x.close(),$=S==="y"||S==="yes"}if(!$){console.log(m.dim(" aborted."));return}if(a.readArticle(c)?.content!==l.content){console.log(m.yellow(` ${c} changed while this patch was made (another patch or edit). Not saved; run the patch again.`)),process.exitCode=1;return}let b=[...new Set([...l.meta.related||[],...a.extractWikilinks(p)])];if(!a.writeArticle(c,{...l.meta,related:b.length?b:void 0,lastUpdated:new Date().toISOString().slice(0,10)},p,e)){console.log(m.red(" write failed (permission?)"));return}a.rebuildIndex(),console.log(m.green(` \u2713 ${c} patched.`))});var By=H.command("contribute").description("queue sourced wiki patches from an agent's work since its last run (enable, disable)").option("--dir <path>","wiki directory").option("--agent <id>","contribute for this agent").option("--all","every agent with wiki.contribute.enabled in agentx.json").option("--since <time>","first run only: read work from this date or time (default: the last 24 hours)").option("--max-patches <n>","patches per agent per run (default: the agent's setting, else 30)").option("--max-cost <usd>","model spend per agent per run, in USD (default: the agent's setting, else wiki.contributions.maxCostUsd, else 0.5)").option("--max-items <n>","chat entries and tasks read per agent per run","60").option("--model <model>","model (default: the agent's setting, else wiki.contributions.model, else sonnet)").option("--db <path>","trace database with the agents' task runs",".agentx/db.sqlite").option("--dry-run","show the patches without queueing them or moving the cursor").option("--json","print the batches as JSON").action(async e=>{let{runContribution:t}=await import("./contributions-ECGVSETO.js"),o=we(e.dir),n=ut(e.dir),s={},r={};try{let{loadDaemonConfig:d}=await import("./config-NFDEJ3NB.js"),f=d();s=Object.fromEntries(Object.entries(f.agents||{}).map(([p,u])=>[p,u.wiki?.contribute])),r=f.wiki.contributions}catch{}let i=e.agent?[e.agent]:e.all?Object.keys(s).filter(d=>s[d]?.enabled).sort():[];if(i.length===0){console.log(m.yellow(e.all?" No agent has wiki.contribute.enabled. Turn one on with `agentx wiki contribute enable <agent>`.":" Name an agent with --agent <id>, or use --all.")),e.all||(process.exitCode=1);return}let a,c=q(process.cwd(),e.db);if(Ke(c)){let d=(await import("better-sqlite3")).default;a=new d(c,{readonly:!0})}else e.json||console.log(m.dim(` no trace database at ${c}; reading chat turns only`));let l=d=>async(f,p)=>{let u=q(n,"_tmp");Jt(u,{recursive:!0});let h=q(u,`contribute-${process.pid}-${Date.now()}.txt`);Nt(h,f);try{let{stdout:y}=await Hy(`cat '${h}' | claude -p - --output-format json --max-turns 1 --max-budget-usd ${p.toFixed(2)} --model ${d} --disallowedTools "Bash Read Write Edit Glob Grep Agent WebSearch WebFetch NotebookEdit"`,{env:bo(),timeout:18e4,maxBuffer:4194304});try{let $=JSON.parse(y);return{text:String($.result||$.content||""),costUsd:cc($).costUsd}}catch{return{text:y}}}finally{Pl(h,{force:!0})}},g=[];try{for(let d of i){if(vn(o,d))continue;let f=s[d],p=e.model||f?.model||r.model||process.env.AGENTX_WIKI_CONTRIBUTE_MODEL||"sonnet";try{let u=await t(o,n,d,{model:p,call:l(p),db:a,since:e.since,dryRun:!!e.dryRun,maxPatches:e.maxPatches?parseInt(e.maxPatches):f?.maxPatches,maxCostUsd:e.maxCost?parseFloat(e.maxCost):f?.maxCostUsd??r.maxCostUsd,maxItems:parseInt(e.maxItems)});if(g.push(u),e.json)continue;let h=u.stoppedBy?m.yellow(` \xB7 stopped at ${u.stoppedBy}`):"";console.log(` ${m.cyan(d)}: ${u.patches.length} patch(es) from ${u.workIds.length} item(s) of work \xB7 $${u.costUsd.toFixed(4)}${h}${e.dryRun?m.dim(" \xB7 dry run, not queued"):""}`);for(let y of u.patches){let $=y.attribute?`${y.attribute}: ${y.previous?`${y.previous} \u2192 `:""}${y.value??""}`:y.summary??"";console.log(m.dim(` ${y.kind.padEnd(8)} ${y.page} \xB7 ${$} (${y.source}, ${y.checkedAt.slice(0,10)})`))}}catch(u){console.log(m.red(` ${d}: ${u.message?.slice(0,200)}`)),process.exitCode=1}}}finally{a?.close()}e.json?console.log(JSON.stringify(g,null,2)):!e.dryRun&&g.some(d=>d.patches.length)&&console.log(m.dim(" queued; `agentx wiki contributions merge` applies them."))});for(let[e,t]of[["enable",!0],["disable",!1]])By.command(`${e} <agent>`).description(t?"turn on an agent's daily wiki contribution in agentx.json":"turn off an agent's daily wiki contribution").option("--max-cost <usd>","model spend per run, in USD").option("--max-patches <n>","patches per run").option("-c, --config <path>","path to agentx.json").action(async(o,n)=>{let{applyConfigMutation:s}=await import("./config-mutator-OMWL5XHO.js"),r=await s(i=>{let a=i.agents?.[o];if(!a)throw new Error(`no agent "${o}" in agentx.json`);a.wiki??={},a.wiki.contribute??={},a.wiki.contribute.enabled=t;let c={...By.opts(),...n};c.maxCost&&(a.wiki.contribute.maxCostUsd=parseFloat(c.maxCost)),c.maxPatches&&(a.wiki.contribute.maxPatches=parseInt(c.maxPatches))},{configPath:n.config});if(!r.success){console.log(m.red(` \u2717 ${r.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${o}: daily wiki contribution ${t?"on":"off"}`)),t&&console.log(m.dim(" The daily jobs wiki-contribute and wiki-contribute-merge now show in `agentx schedule list`."))});var dr=H.command("contributions").description("the daily merge of agents' wiki patches (list, merge, held, approve, reject)");dr.command("list",{isDefault:!0}).description("patches waiting for the merge, and what the last merge did").option("--dir <path>","wiki directory").option("--json").action(async e=>{let{listPendingBatches:t,latestReport:o,listHeld:n}=await import("./contributions-ECGVSETO.js"),s=ut(e.dir),r=t(s),i=o(s),a=n(s);if(e.json){console.log(JSON.stringify({pending:r,lastMerge:i,held:a.length},null,2));return}console.log(),console.log(m.bold(` Waiting for the merge: ${r.reduce((c,l)=>c+l.patches.length,0)} patch(es) in ${r.length} batch(es)`));for(let c of r)console.log(m.dim(` ${c.agentId} \xB7 ${c.runAt.slice(0,16)} \xB7 ${c.patches.length} patch(es) \xB7 $${c.costUsd.toFixed(4)}`));i?(console.log(m.bold(` Last merge ${i.at.slice(0,16)}:`)+` ${i.applied.length} fact(s) applied, ${i.pagesUpdated.length} page(s) updated, ${i.pagesCreated.length} created, ${i.contradictions.length} contradiction(s), ${i.held.length} held`),i.duplicates.length&&console.log(m.yellow(` ${i.duplicates.length} subject(s) have more than one page: ${i.duplicates.slice(0,5).map(c=>c.title).join(", ")}${i.duplicates.length>5?", \u2026":""}`))):console.log(m.dim(" No merge has run yet.")),a.length&&console.log(m.yellow(` ${a.length} patch(es) held for a person: agentx wiki contributions held`)),console.log()});dr.command("merge").description("apply the queued patches: newest checked fact wins, fact-losing changes are held").option("--dir <path>","wiki directory").option("--dry-run","show what would change without writing").option("--json","print the report as JSON").action(async e=>{let{mergeContributions:t}=await import("./contributions-ECGVSETO.js"),o=t(we(e.dir),ut(e.dir),{dryRun:!!e.dryRun,log:n=>console.error(n)});if(e.json){console.log(JSON.stringify(o,null,2));return}if(console.log(),o.batches.length===0){console.log(m.dim(" Nothing to merge.")),console.log();return}console.log(m.bold(` ${o.patches} patch(es) from ${o.agents.join(", ")}${o.dryRun?m.dim(" (dry run, nothing written)"):""}`)),console.log(` ${o.applied.length} fact(s) applied \xB7 ${o.pagesUpdated.length} page(s) updated \xB7 ${o.pagesCreated.length} page(s) created`);for(let n of o.pagesCreated)console.log(m.green(` + ${n}`));for(let n of o.pagesUpdated)console.log(m.dim(` ~ ${n}`));for(let n of o.contradictions)console.log(m.yellow(` ? ${n.page} \xB7 ${n.attribute}: ${n.by} reports "${n.value}" with an older check than the wiki's; a person is asked${n.questionId?` (${n.questionId})`:""}`));for(let n of o.held)console.log(m.yellow(` ! held ${n.id} \xB7 ${n.page}${n.attribute?` \xB7 ${n.attribute}`:""} from ${n.by}: ${n.reason}${n.lost?.length?` (${n.lost.slice(0,4).join(", ")})`:""}`));for(let n of o.duplicates.slice(0,10))console.log(m.yellow(` = ${n.title}: ${n.pages.join(" \xB7 ")}`));console.log()});dr.command("held").description("patches the merge held for a person, with the reason").option("--dir <path>","wiki directory").option("--all","include approved and rejected").option("--json").action(async e=>{let{listHeld:t}=await import("./contributions-ECGVSETO.js"),o=t(ut(e.dir),{all:!!e.all});if(e.json){console.log(JSON.stringify(o,null,2));return}console.log(),o.length===0&&console.log(m.dim(" Nothing held."));for(let n of o){let s=n.patch,r=n.status==="held"?"":m.dim(` [${n.status}]`);console.log(` ${m.bold(n.id)}${r} \xB7 ${m.cyan(s.agentId)} \xB7 ${s.kind} \xB7 ${s.page}${s.attribute?` \xB7 ${s.attribute}`:""}${s.value?`: ${s.value}`:""}`),console.log(m.dim(` ${n.reason}${n.lost?.length?`: ${n.lost.join(", ")}`:""} \xB7 source: ${s.source}, checked ${s.checkedAt.slice(0,10)}`))}o.some(n=>n.status==="held")&&console.log(m.dim(`
|
|
577
|
+
agentx wiki contributions approve <id> \xB7 agentx wiki contributions reject <id>`)),console.log()});dr.command("approve <id>").description("apply a held patch as it is").option("--dir <path>","wiki directory").action(async(e,t)=>{let{approveHeld:o}=await import("./contributions-ECGVSETO.js"),n=o(we(t.dir),ut(t.dir),e,{by:process.env.USER||"operator"});if(!n.ok){console.log(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${e} applied${n.page?` to ${n.page}`:""}. The page's previous version is kept.`))});dr.command("reject <id>").description("drop a held patch").option("--dir <path>","wiki directory").action(async(e,t)=>{let{rejectHeld:o}=await import("./contributions-ECGVSETO.js"),n=o(ut(t.dir),e,{by:process.env.USER||"operator"});if(!n.ok){console.log(m.red(` ${n.error}`)),process.exitCode=1;return}console.log(m.green(` \u2713 ${e} rejected.`))});function gr(e,t,o){let n=t.trim(),s=e.listArticles(o),r=n.toLowerCase(),i=s.find(l=>l.meta.title.toLowerCase()===r);if(i)return i.path;if(n.includes("/")||n.endsWith(".md")){let l=n.endsWith(".md")?n:`${n}.md`,g=s.find(d=>d.path===l||d.path===n);if(g)return g.path}let a=n.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,""),c=s.find(l=>{let g=l.meta.title.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"");return g===a||g.includes(a)||l.path.toLowerCase().includes(a)});return c?c.path:null}function qA(e,t,o,n){return["You are editing a single wiki article to incorporate an operator instruction.","",`## Article: "${t}" (type: ${o||"untyped"})`,"","<article-body>",e,"</article-body>","","## Operator instruction",n,"","## Rules","- Output ONLY the modified article body (content between the --- frontmatter markers).","- Do NOT output frontmatter (title, type, tags, etc.) \u2014 the serializer handles that.","- Do NOT wrap the output in code fences.",`- Do NOT prepend any preamble like "Here's the updated article:".`,"- Preserve existing wikilinks, markdown formatting, and section structure unless the instruction requires changing them.","- Make the MINIMUM edit that satisfies the instruction \u2014 don't rewrite untouched sections.","- If the instruction is ambiguous or can't be applied, return the original body unchanged."].join(`
|
|
578
578
|
`)}function UA(e,t,o,n,s){let r={"/correct":`The operator says the article contains an error:
|
|
579
579
|
|
|
580
580
|
${o}
|
|
@@ -631,7 +631,7 @@ Output (JSON array, one entry per input article, same order):
|
|
|
631
631
|
...
|
|
632
632
|
]`}H.command("entries").description("list raw entries").option("--dir <path>","wiki directory").option("--agent <id>","filter by agent").action(e=>{let n=we(e.dir).getSharedStore().listEntries();e.agent&&(n=n.filter(s=>s.agentId===e.agent)),console.log(),console.log(m.bold(` ${n.length} raw entries`)),console.log();for(let s of n.slice(-20))console.log(` ${m.dim(s.date)} ${m.cyan(s.agentId)} via ${s.source}: ${s.content.slice(0,80)}...`);n.length>20&&console.log(m.dim(` ... showing last 20 of ${n.length}`)),console.log()});H.command("serve").description("start a local web server to browse agent wikis (local + mesh)").option("--dir <path>","wiki directory").option("--mode <mode>","graph (default, canonical) | unified | flat (legacy, back-compat)","graph").option("--agent <id>","serve only this agent's wiki").option("--port <n>","port number","4200").option("--peer <urls...>","mesh peer URLs to federate").action(async e=>{let t=e.dir||q(process.cwd(),".agentx/wiki"),o=parseInt(e.port),n=await zy(e.peer),s=n.map(r=>r.url);console.log(),console.log(m.bold(" AgentX Wiki Server")),console.log(),console.log(` ${m.green(">")} http://localhost:${o}`),e.agent?console.log(` Agent: ${m.cyan(e.agent)}`):console.log(` Mode: ${m.cyan("Hub")} (all agents)`),s.length>0&&console.log(` Mesh: ${m.cyan(s.length+" peer(s)")} \u2014 ${s.join(", ")}`),console.log(m.dim(` Wiki: ${t}`)),console.log(m.dim(" Press Ctrl+C to stop")),console.log(),Bm(t,o,e.agent,n,e.mode)});H.command("grade").description("grade absorbed articles with the article-quality seat").option("--dir <path>","wiki directory").option("--mode <mode>","graph | unified | flat","graph").option("--agent <id>","grade only this agent's wiki").option("--limit <n>","articles to grade","20").option("--min <n>","only show articles scoring below this","3").option("--fields","also check the required fields for each article's type").option("--type <t>","grade only articles of this type (person, place, project, \u2026)").option("--json").action(async e=>{let{articleQualityQuestionsFor:t,articleQualityState:o,gradeArticle:n,ARTICLE_QUALITY_SEAT:s}=await import("./article-quality-JFJMZWFQ.js"),{fieldQuestions:r,reportFields:i}=await import("./article-fields-PITN4NHA.js"),{askSeat:a}=await import("./seat-JWRCBUKR.js"),c=we(e.dir,e.mode),l=e.agent?[e.agent]:c.listAgents(),g=parseInt(e.limit),d=parseFloat(e.min),f=[];e:for(let y of l){let $=c.getAgentWiki(y);for(let b of $.listArticles(y)){if(f.length>=g)break e;let v=$.readArticle(b.path);if(!v||e.type&&v.meta.type!==e.type)continue;let x={...t(v.meta.type),...e.fields?r(v.meta.type):{}},S=await a(s,o({path:b.path,title:v.meta.title,type:v.meta.type,tags:v.meta.tags,body:v.content}),x,{links:[{kind:"article",id:b.path}],features:{agent:y,type:v.meta.type??"?"}});if(!S){console.log(m.yellow(" seat is off or unavailable \u2014 set decisions.seats.article-quality.mode"));return}let k=n(S.answers),A=e.fields?i(v.meta.type,S.answers):null;k.completeness>=d&&!(A&&!A.fit)||f.push({agent:y,type:v.meta.type??"?",score:k.completeness.toFixed(2),standsAlone:k.standsAlone.toFixed(2),gap:k.biggestGap,...A?{missing:A.missingCritical.join(",")||"-",cov:`${Math.round(A.coverage*100)}%`}:{},title:v.meta.title.slice(0,44)})}}if(e.json){console.log(JSON.stringify(f,null,2));return}if(f.length===0){console.log(m.green(" no articles below the threshold"));return}f.sort((y,$)=>parseFloat(y.score)-parseFloat($.score));let p=e.fields?["score","cov","missing","type","gap","agent","title"]:["score","standsAlone","type","gap","agent","title"],u=p.map(y=>Math.max(y.length,...f.map($=>String($[y]).length))),h=y=>y.map(($,b)=>String($).padEnd(u[b])).join(" ");console.log(),console.log(m.bold(h(p)));for(let y of f)console.log(h(p.map($=>y[$])));if(e.fields){let y=f.filter($=>$.missing!=="-").length;console.log(m.dim(`
|
|
633
633
|
${f.length} article(s) flagged; ${y} missing a required field.`)),console.log(m.dim(" 'missing' is the actionable column \u2014 a named field beats a score."))}else console.log(m.dim(`
|
|
634
|
-
${f.length} article(s) below ${d}. standsAlone is the one that matters:`)),console.log(m.dim(" an article can open with a tidy identity line and still send the reader back to the source."))});H.command("query <question>").description("agentic wiki query \u2014 picks pages from their one-line summaries, reads live state at the source, then answers; walks the catalog + wikilink graph where no summaries exist").option("--dir <path>","wiki directory").option("--agent <id>","which agent's wiki to search first (default: the calling agent, else the first one with a catalog)").option("--method <m>","how pages are picked: auto, summaries or catalog (default: wiki.query.method)").option("--no-live","skip the live read of the summaries method").option("--linked <n>","also open up to n pages linked from the picked pages (summaries method; default: wiki.query.linkedPages)").option("--no-notes","leave the agent's own notes out (wiki.query.notes)").option("--selector-model <m>","candidate-selection model (default haiku)").option("--synth-model <m>","synthesis model (default sonnet)").option("--max-candidates <n>","candidates from selector (catalog method)","3").option("--max-hops <n>","wikilink hops from candidates (catalog method)","2").option("--max-articles <n>","cap on total articles walked (catalog method)","8").option("--json","emit full result as JSON (for A/B harnesses)").option("--trace","print selector + walk trace").option("--own-only","search only the agent's own articles, not the shared wiki").action(async(e,t)=>{let{agenticQuery:o}=await import("./query-
|
|
634
|
+
${f.length} article(s) below ${d}. standsAlone is the one that matters:`)),console.log(m.dim(" an article can open with a tidy identity line and still send the reader back to the source."))});H.command("query <question>").description("agentic wiki query \u2014 picks pages from their one-line summaries, reads live state at the source, then answers; walks the catalog + wikilink graph where no summaries exist").option("--dir <path>","wiki directory").option("--agent <id>","which agent's wiki to search first (default: the calling agent, else the first one with a catalog)").option("--method <m>","how pages are picked: auto, summaries or catalog (default: wiki.query.method)").option("--no-live","skip the live read of the summaries method").option("--linked <n>","also open up to n pages linked from the picked pages (summaries method; default: wiki.query.linkedPages)").option("--no-notes","leave the agent's own notes out (wiki.query.notes)").option("--selector-model <m>","candidate-selection model (default haiku)").option("--synth-model <m>","synthesis model (default sonnet)").option("--max-candidates <n>","candidates from selector (catalog method)","3").option("--max-hops <n>","wikilink hops from candidates (catalog method)","2").option("--max-articles <n>","cap on total articles walked (catalog method)","8").option("--json","emit full result as JSON (for A/B harnesses)").option("--trace","print selector + walk trace").option("--own-only","search only the agent's own articles, not the shared wiki").action(async(e,t)=>{let{agenticQuery:o}=await import("./query-WWZEARB4.js"),{noteSourceFor:n}=await import("./query-settings-3FE555NP.js"),{QUERY_RUNS_FILE:s,queryFailed:r,recordQueryRun:i,timedQuery:a}=await import("./query-runs-VXS572PQ.js"),c=await Vy(t);if(!c)return;let l=we(t.dir),g=t.agent?[t.agent]:l.listAgents(),d=q(l.getBaseDir(),s),f=Date.now(),p=t.agent||process.env.AGENTX_AGENT_ID,u=p&&!t.ownOnly&&await Wy()?p:null;for(let v of u?[]:g){let x=l.getAgentWiki(v),S=q(x.baseDir,"_index.md");try{if((await import("fs")).existsSync(S)){u=v;break}}catch{}}if(!u){console.log(m.yellow(" No agent has a catalog yet. Run `agentx wiki status` or migrate first.")),i(d,{at:new Date().toISOString(),agent:p||"",status:"no-catalog",source:"cli",wallMs:Date.now()-f}),process.exitCode=1;return}let h=u,y=l.getAgentWiki(h),$=t.ownOnly||!await Wy()?void 0:l.sharedScope(h),b=await a(d,h,"cli",()=>o(e,y,h,{selectorModel:t.selectorModel,synthModel:t.synthModel,maxCandidates:parseInt(t.maxCandidates),maxHops:parseInt(t.maxHops),maxArticles:parseInt(t.maxArticles),shared:$,method:c.method,summaries:c.summaries,notes:n(c,h)}));if(r(b.status)&&(process.exitCode=1),t.json){console.log(JSON.stringify(b,null,2));return}if(console.log(),console.log(m.bold(` Q: ${e}`)),console.log(m.dim(` agent: ${u} \xB7 status: ${b.status} \xB7 walked: ${b.walked.length}`)),console.log(),b.status!=="ok"){console.log(m.yellow(` (no answer) ${b.error||b.status}`));return}if(console.log(b.answer),console.log(),b.basis==="search"&&(console.log(m.dim(" No wiki page was used: the answer comes from a search at the source.")),console.log()),b.citations.length){console.log(m.dim(" Citations:"));for(let v of b.citations){let x=v.type?m.magenta(` [${v.type}]`):"";console.log(m.dim(` - ${v.title}${x} (${v.path})`))}console.log()}if(b.live?.length){console.log(m.dim(" Read live at the source:"));for(let v of b.live)console.log(m.dim(` - ${v.line}`));console.log()}if(t.trace&&b.trace){if(b.method==="summaries"&&console.log(m.dim(` method: summaries live reads: ${b.liveAsked??0} asked, ${b.live?.length??0} answered plan: ${b.trace.planMs??0}ms reads: ${b.trace.liveMs??0}ms`)),console.log(m.dim(` selector: ${b.trace.selectorMs}ms synthesis: ${b.trace.synthesisMs}ms`)),console.log(m.dim(` candidates: ${b.candidates.map(v=>v.title).join(" | ")||"(none)"}`)),b.walked.length>b.candidates.length){let v=b.walked.filter(x=>!b.candidates.some(S=>S.path===x.path));console.log(m.dim(` followed: ${v.map(x=>`${x.title}@h${x.hop}`).join(" | ")}`))}console.log()}});H.command("score").description("score the wiki's answers to a question set; compare two reports").option("--dir <path>","wiki directory").option("--questions <file>","question set: JSON array or JSON lines of {id, question, expect: [facts]}").option("--agent <id>","ask as this agent (its own wiki first, then the shared wiki)").option("--own-only","search only the agent's own articles, to measure without the shared wiki").option("--out <file>","write the report as JSON to this file").option("--compare <files...>","compare two saved reports (before after) instead of running").option("--method <m>","how pages are picked: auto, summaries or catalog (default: wiki.query.method)").option("--no-live","skip the live read of the summaries method").option("--linked <n>","also open up to n pages linked from the picked pages (summaries method; default: wiki.query.linkedPages)").option("--no-notes","leave the agent's own notes out (wiki.query.notes)").option("--selector-model <m>","candidate-selection model (default haiku)").option("--synth-model <m>","synthesis model (default sonnet)").option("--json","print the report as JSON").action(async e=>{let{parseQuestionSet:t,buildReport:o,compareReports:n,runCost:s}=await import("./score-LNJ46A67.js"),r=S=>`${Math.round(S*100)}%`,i=S=>S===void 0?"?":`${(S/1e3).toFixed(1)}s`,a=S=>S===void 0?"?":`$${S.toFixed(3)}`,c=S=>`${i(S.meanMs)} and ${a(S.meanCostUsd)} per question${S.unpriced?` (${S.unpriced} without a cost)`:""}`;if(e.compare){if(e.compare.length!==2){console.log(m.red(" --compare takes two report files: before after")),process.exitCode=1;return}let[S,k]=e.compare.map(R=>JSON.parse(It(q(R),"utf-8"))),A=n(S,k);if(e.json){console.log(JSON.stringify(A,null,2));return}console.log(),console.log(m.bold(` ${r(A.before)} \u2192 ${r(A.after)}`)),console.log(m.dim(` before: ${c(A.cost.before)}`)),console.log(m.dim(` after: ${c(A.cost.after)}`)),A.changed==="unknown"?console.log(m.yellow(" ! A report records no settings, so what changed between the runs is unknown.")):(console.log(m.dim(` changed: ${A.changed.join("; ")||"nothing"}`)),A.changed.length>1&&console.log(m.yellow(" ! More than one setting changed: the difference can't be put down to one of them."))),(A.onlyBefore.length||A.onlyAfter.length)&&console.log(m.yellow(` ! The runs asked different questions. Only before: ${A.onlyBefore.join(", ")||"none"}. Only after: ${A.onlyAfter.join(", ")||"none"}.`));for(let R of A.deltas){if(R.before===R.after)continue;let O=R.after>R.before?m.green("\u25B2"):m.red("\u25BC");console.log(` ${O} ${R.id} ${r(R.before)} \u2192 ${r(R.after)} ${m.dim(R.question.slice(0,80))}`),R.gained.length&&console.log(m.green(` + ${R.gained.join(", ")}`)),R.lost.length&&console.log(m.red(` - ${R.lost.join(", ")}`))}console.log();return}if(!e.questions){console.log(m.red(" --questions <file> is required (or --compare before.json after.json).")),process.exitCode=1;return}let l=e.agent||process.env.AGENTX_AGENT_ID;if(!l){console.log(m.red(" --agent <id> is required: the score is for one agent's view of the wiki.")),process.exitCode=1;return}let g=t(It(q(e.questions),"utf-8")),{agenticQuery:d,CATALOG_SELECTOR_MODEL:f,CATALOG_SYNTH_MODEL:p}=await import("./query-WWZEARB4.js"),{noteSourceFor:u}=await import("./query-settings-3FE555NP.js"),{meteredModelCall:h}=await import("./model-call-J7JATTMW.js"),y=await Vy(e);if(!y)return;let $=we(e.dir),b=!e.ownOnly,v=[];for(let S of g){let k={calls:0,usd:0,unpriced:0},A=Date.now(),R=await d(S.question,$.getAgentWiki(l),l,{selectorModel:e.selectorModel,synthModel:e.synthModel,shared:b?$.sharedScope(l):void 0,method:y.method,summaries:y.summaries,notes:u(y,l),call:h(k)}),O=Date.now()-A,N=R.method==="summaries"&&k.unpriced===0?k.usd:void 0;v.push({q:S,answer:R.answer||R.error||"",status:R.status,citations:R.citations.map(D=>D.path),method:R.method??"catalog",ms:O,costUsd:N}),e.json||process.stderr.write(m.dim(` ${S.id} ${R.status} ${i(O)} ${a(N)}
|
|
635
635
|
`))}let x=o({questions:e.questions,agent:l,shared:b,settings:{method:y.method,linkedPages:y.summaries.linkedPages,linkedChars:y.summaries.linkedChars,live:y.summaries.live.enabled,notes:y.notes.enabled,navigatorModel:e.selectorModel??y.summaries.navigatorModel,answerModel:e.synthModel??y.summaries.answerModel,catalogSelectorModel:e.selectorModel??f,catalogSynthModel:e.synthModel??p}},v);if(e.out&&Nt(q(e.out),`${JSON.stringify(x,null,2)}
|
|
636
636
|
`),e.json){console.log(JSON.stringify(x,null,2));return}console.log(),console.log(m.bold(` ${l}: ${r(x.score)} \xB7 ${x.full}/${x.results.length} questions fully answered${b?"":" (own articles only)"}`)),console.log(m.dim(` ${c(s(x))}`));for(let S of x.results){let k=S.missing.length===0?m.green("\u2713"):S.found.length?m.yellow("~"):m.red("\u2717");console.log(` ${k} ${S.id} ${r(S.score)} ${m.dim(S.question.slice(0,80))}`),S.missing.length&&console.log(m.dim(` missing: ${S.missing.join(", ")}`))}e.out&&console.log(m.dim(`
|
|
637
637
|
report saved to ${e.out}`)),console.log()});H.command("search <query>").description("search wiki articles").option("--dir <path>","wiki directory").option("--mode <mode>","graph (default, canonical) | unified | flat (legacy, back-compat)","graph").option("--agent <id>","search specific agent's wiki").action(async(e,t)=>{let o=we(t.dir,t.mode),n=t.agent?[t.agent]:o.listAgents();console.log();let s=0;for(let r of n){let a=await o.getAgentWiki(r).findRelevantReranked(e,void 0,10);if(a.length>0){console.log(m.bold(` ${m.cyan(r)}:`));for(let c of a)console.log(` ${c.meta.title} [${(c.meta.tags||[]).slice(0,3).join(", ")}]`),console.log(m.dim(` ${c.path} \u2014 ${c.content.slice(0,100)}...`));s+=a.length}}s===0&&console.log(m.dim(" No matching articles")),console.log()});H.command("backfill-graphpath").description("populate graphPath on existing articles by looking up source-entry classifications").option("--dir <path>","wiki directory").option("--agent <id>","backfill only this agent").option("--dry-run","preview without writing",!1).action(e=>{let t=we(e.dir),o=e.agent?[e.agent]:t.listAgents(),n=q(process.cwd(),".agentx/graph");if(!Ke(n)){console.log(m.red(` No graph store at ${n} \u2014 nothing to backfill against.`));return}let s=new ko({baseDir:n}),r=s.loadIndex(),i=new Map;for(let[d,f]of Object.entries(r.entries))i.set(d,f.path);if(i.size===0){console.log(m.yellow(" Graph index is empty \u2014 nothing to look up."));return}console.log(m.dim(` Loaded ${i.size} fingerprint -> path entries from .agentx/graph/index.json`));let a=0,c=0,l=0,g=0;for(let d of o){let f=t.getAgentWiki(d),p=f.listArticles(d),u=t.getSharedStore().listEntries(),h=new Map(u.map(v=>[v.id,v])),y=0,$=0,b=0;for(let v of p){if(a++,v.meta.graphPath?.length||!v.meta.sources?.length)continue;y++,c++;let x=new Map;for(let k of v.meta.sources){let A=h.get(k);if(!A)continue;let R=String(A.meta?.sender??""),O=s.fingerprint({text:A.content,channel:A.source,sender:R}),N=i.get(O);if(!N?.length)continue;let D=N.join("/"),_=x.get(D);_?_.n++:x.set(D,{path:N,n:1})}if(x.size===0)continue;$++,l++;let S;for(let k of x.values())(!S||k.n>S.n)&&(S=k);S&&(e.dryRun||(f.writeArticle(v.path,{...v.meta,graphPath:S.path},v.content,d),b++,g++))}console.log(` ${m.cyan(d)}: ${m.bold(p.length)} articles \xB7 ${y} eligible \xB7 ${$} matched \xB7 ${m.green(b)} written`)}console.log(),console.log(m.bold(` Total: ${a} articles, ${c} missing graphPath, ${l} matched (${Math.round(l/Math.max(1,c)*100)}%), ${g} written`)),e.dryRun&&console.log(m.dim(" Dry-run \u2014 re-run without --dry-run to commit.")),console.log()});H.command("sync").description("pull raw entries from mesh peers into local wiki, or with --articles copy their agents' articles (read-only)").option("--dir <path>","wiki directory").option("--peer <url>","sync from a specific peer URL (e.g., http://100.64.0.11:19900)").option("--articles","copy the articles of agents this node does not run, instead of raw entries").option("--dry-run","show what would be synced without writing").action(async e=>{let t=we(e.dir),o=t.getSharedStore(),n=await zy(e.peer?[e.peer]:void 0);if(n.length===0){console.log(m.dim(" No mesh peers configured")),console.log(m.dim(" Usage: agentx wiki sync --peer http://100.64.0.11:19900"));return}if(e.articles){let i=await Yy();if(!i){console.log(m.red(" No agents in this node's daemon config; run it where agentx.json is.")),process.exitCode=1;return}let{syncPeerArticles:a}=await import("./article-sync-4NOPOQU7.js");for(let c of n){console.log(),console.log(m.bold(` Copying articles from ${c.url}...`));try{let l=await a({hub:t,peer:c,localAgents:i,dryRun:e.dryRun});console.log(m.dim(` Node: ${l.node}`));for(let g of l.agents){if(g.skipped==="local"){console.log(m.dim(` ${g.agentId}: runs here, not copied`));continue}if(g.skipped){console.log(m.yellow(` ${g.agentId}: skipped (${g.skipped})`));continue}let d=[`${g.copied} ${e.dryRun?"to copy":"copied"}`,`${g.unchanged} unchanged`];g.removed&&d.push(`${g.removed} removed (gone on the peer)`),g.rejected&&d.push(`${g.rejected} refused`),console.log(` ${m.cyan(g.agentId)}: ${d.join(", ")}${g.error?m.red(` \u2014 stopped: ${g.error}`):""}`),g.error&&(process.exitCode=1)}}catch(l){console.log(m.red(` ${l.cause?.code==="ECONNREFUSED"?"Connection refused":l.message}`)),process.exitCode=1}}console.log();return}let s=new Set(o.listEntries().map(i=>i.id)),r=0;for(let{url:i,token:a}of n){console.log(),console.log(m.bold(` Syncing from ${i}...`));let c=a?{Authorization:`Bearer ${a}`}:{};try{let l=await fetch(`${i}/wiki/entries`,{headers:c,signal:AbortSignal.timeout(12e4)});if(!l.ok){console.log(m.red(` HTTP ${l.status}`));continue}let g=await l.json(),d=g.entries||[],f=g.nodeId||"unknown";console.log(m.dim(` Node: ${f} \u2014 ${d.length} entries`));let p=0;for(let u of d)s.has(u.id)||(e.dryRun||(o.addEntry({id:u.id,date:u.date,agentId:u.agentId,source:`${u.source}@${f}`,sourceContext:u.sourceContext,content:u.content}),s.add(u.id)),p++);p>0?console.log(m.green(` ${p} new entries${e.dryRun?" (dry run)":" synced"}`)):console.log(m.dim(" Already up to date")),r+=p;try{let u=await fetch(`${i}/wiki/agents`,{headers:c,signal:AbortSignal.timeout(5e3)});if(u.ok){let h=await u.json();for(let y of h.agents||[])y.totalEntries>0&&console.log(m.dim(` ${y.agentId}: ${y.totalEntries} entries, ${y.totalArticles} articles`))}}catch{}}catch(l){l.cause?.code==="ECONNREFUSED"?console.log(m.red(" Connection refused")):console.log(m.red(` ${l.message}`))}}console.log(),r>0&&!e.dryRun?console.log(m.green(` ${r} entries synced.`)):r>0?console.log(m.dim(` ${r} entries would be synced (dry run)`)):console.log(m.dim(" All peers up to date")),console.log()});H.command("compare").description("compare all wiki compilation modes for an agent").option("--dir <path>","wiki directory").requiredOption("--agent <id>","agent to compare").action(e=>{let t=e.dir||q(process.cwd(),".agentx/wiki"),o=e.agent,s=["flat","graph","unified"].map(c=>{let l=new Oa(t,void 0,c),d=l.getAgentWiki(o).rebuildIndex(),f=l.getAgentEntries(o),p=l.getUnabsorbedEntries(o),u=new Set,h=0,y=new Set;for(let b of d.articles){for(let v of b.tags||[])u.add(v);h+=b.tags?.length||0;for(let v of b.sources||[])y.add(v)}let $=new Set(d.articles.map(b=>b.path.includes("/")?b.path.split("/")[0]:"/"));return{mode:c,label:Ml(c),articles:d.articles.length,entries:f.length,unabsorbed:p.length,uniqueTags:u.size,avgTags:d.articles.length>0?(h/d.articles.length).toFixed(1):"0",dirs:$.size,coverage:y.size,articleList:d.articles}});console.log(),console.log(m.bold(` Wiki Compare: ${o}`)),console.log(` Raw entries: ${s[0].entries}`),console.log();let r=22;console.log(` ${"".padEnd(20)} ${s.map(c=>c.label.padEnd(r)).join(" ")}`),console.log(` ${"\u2500".repeat(20)} ${s.map(()=>"\u2500".repeat(r)).join(" ")}`);let i=[["Articles",c=>String(c.articles)],["Unabsorbed",c=>String(c.unabsorbed)],["Unique tags",c=>String(c.uniqueTags)],["Avg tags/article",c=>c.avgTags],["Directories",c=>String(c.dirs)],["Entry coverage",c=>`${c.coverage}/${c.entries}`]];for(let[c,l]of i){let g=s.map(d=>l(d).padEnd(r));console.log(` ${c.padEnd(20)} ${g.join(" ")}`)}console.log();let a=(c,l)=>{let g=Math.max(...s.map(f=>f[c])),d=s.filter(f=>f[c]===g).map(f=>f.label);g>0&&console.log(m.dim(` Best ${l}: ${d.join(", ")} (${g})`))};a("uniqueTags","tag richness"),a("articles","article count"),a("coverage","entry coverage"),console.log()});H.command("export [output]").description("export the entire wiki tree to a .tar.gz").option("--dir <path>","wiki directory to archive (default: .agentx/wiki)").option("--include-raw","also include raw entries (.agentx/wiki/raw/) \u2014 bigger archive").action(async(e,t)=>{let o=t.dir?q(process.cwd(),t.dir):q(process.cwd(),".agentx/wiki");Ke(o)||(console.log(m.red(` Wiki dir not found: ${o}`)),process.exit(1));let n=new Date().toISOString().slice(0,10),s=e?q(process.cwd(),e):q(process.cwd(),`agentx-wiki-${n}.tar.gz`),r=q(o,".."),i=o.split("/").pop()||"wiki",a=["-C",r,"-czf",s];t.includeRaw||a.push("--exclude="+i+"/raw"),a.push(i),console.log(m.dim(` tar ${a.join(" ")}`));let{spawnSync:c}=await import("child_process"),l=c("tar",a,{stdio:"inherit"});l.status!==0&&(console.log(m.red(` tar exited with ${l.status}`)),process.exit(l.status||1));let{statSync:g}=await import("fs"),d=Ke(s)?g(s).size:0;console.log(),console.log(m.green(` \u2713 wrote ${s} (${JA(d)})`)),console.log(m.dim(` Restore on another node: agentx wiki import ${s}`)),console.log()});H.command("gaps").description("what each article still needs, most load-bearing first").option("--dir <path>","wiki directory").option("--mode <mode>","graph | unified | flat","graph").option("--agent <id>","only this agent's wiki").option("--type <t>","only articles of this type").option("--max-tier <tier>","stop at this layer: foundation|pillar|walls|openings|furniture","pillar").option("--limit <n>","articles to check","40").option("--auto","only gaps a system of record can close without asking anyone").option("--ask","queue the gaps that need a person onto the questions list").option("--notify","push the load-bearing ones to notifications.destination").option("--notify-tier <tier>","tier at or above which to push","pillar").option("--unclear","include fields the grader was unsure about").option("--json").action(async e=>{let{fieldQuestions:t,reportFields:o,articleFieldsState:n,nextActions:s,TIER_MEANING:r,ARTICLE_FIELDS_SEAT:i}=await import("./article-fields-PITN4NHA.js"),{askSeat:a}=await import("./seat-JWRCBUKR.js"),{QuestionStore:c}=await import("./questions-ZATLU5AW.js"),l=we(e.dir,e.mode),g=[],d=e.agent?[e.agent]:l.listAgents(),f=parseInt(e.limit),p=0,u=[];e:for(let k of d){let A=l.getAgentWiki(k);for(let R of A.listArticles(k)){if(p>=f)break e;let O=A.readArticle(R.path);if(!O||e.type&&O.meta.type!==e.type)continue;p++;let N=await a(i,n({title:O.meta.title,type:O.meta.type,body:O.content}),t(O.meta.type),{links:[{kind:"article",id:R.path}],features:{agent:k,type:O.meta.type??"?"}});if(!N){console.log(m.yellow(" seat is off or unavailable \u2014 set decisions.seats.article-fields.mode"));return}let D=o(O.meta.type,N.answers);for(let _ of s(D,{maxTier:e.maxTier,includeUnclear:!!e.unclear}))e.auto&&_.needsHuman||(e.ask&&_.needsHuman&&g.push({kind:"field",agentId:k,path:R.path,subject:O.meta.title,field:_.field,tier:_.tier,question:`${O.meta.title} (${O.meta.type??"?"}) \u2014 ${_.label}?`}),u.push({tier:_.tier,need:_.field,how:_.needsHuman?m.yellow("ask"):_.sources.join("/"),uncertain:_.uncertain?"?":"",agent:k,article:O.meta.title.slice(0,40)}))}}let h={added:0,skipped:0};if(e.ask&&g.length>0&&(h=new c(ut(e.dir)).add(g)),e.json){console.log(JSON.stringify(u,null,2));return}if(u.length===0){console.log(m.green(` ${p} article(s) checked \u2014 nothing missing at or above ${e.maxTier}`));return}let y=["tier","need","how","uncertain","agent","article"],$=k=>String(k).replace(/\u001b\[[0-9;]*m/g,""),b=y.map(k=>Math.max(k.length,...u.map(A=>$(A[k]).length))),v=(k,A)=>String(k)+" ".repeat(Math.max(0,b[A]-$(k).length));console.log(),console.log(m.bold(y.map((k,A)=>v(k,A)).join(" ")));for(let k of u)console.log(y.map((A,R)=>v(k[A],R)).join(" "));let x=u.filter(k=>k.how!==m.yellow("ask")).length;console.log(),console.log(m.dim(` ${u.length} gap(s) across ${p} article(s).`)),console.log(m.dim(` ${x} can be closed by a lookup; ${u.length-x} need a person.`));let S=u[0]?.tier;if(S&&console.log(m.dim(` Start at ${S} \u2014 ${r[S]}.`)),e.ask&&(console.log(m.cyan(` Queued ${h.added} question(s) for a person (${h.skipped} already asked).`)),console.log(m.dim(' agentx wiki questions \xB7 agentx wiki answer <id> "<value>"'))),e.ask&&e.notify&&h.added>0){let{TIER_RANK:k}=await import("./article-fields-PITN4NHA.js"),A=k[e.notifyTier]??k.pillar,R=g.filter(O=>(k[O.tier??"furniture"]??9)<=A);if(R.length===0)console.log(m.dim(` Nothing at or above ${e.notifyTier} \u2014 not interrupting anyone.`));else{let{loadDaemonConfig:O}=await import("./config-NFDEJ3NB.js"),N=O(),D=N?.notifications?.destination;if(!D?.channel||!D?.chatId)console.log(m.yellow(" --notify: no notifications.destination configured \u2014 questions are queued but nobody was told."));else{let _=R.slice(0,10).map(K=>`\u2022 ${K.question}`).join(`
|
|
@@ -807,7 +807,7 @@ Restart the daemon to activate.
|
|
|
807
807
|
dist/
|
|
808
808
|
*.log
|
|
809
809
|
.env
|
|
810
|
-
`}import{Command as VR}from"commander";import Ze from"chalk";import{writeFileSync as XR,mkdirSync as KR,existsSync as ba,readFileSync as C$,appendFileSync as T$}from"fs";import{resolve as Ss,dirname as I$}from"path";import{homedir as gd}from"os";var j$=new VR().name("completion").description("generate a shell completion script for agentx").option("-s, --shell <shell>","shell to generate completion for: zsh|bash|fish","zsh").option("-i, --install","install the completion script to a default path for the shell").option("-o, --output <path>","write the script to this path (overrides default install path)").option("-y, --yes","skip confirmation prompts (non-interactive)").action(async e=>{let{buildProgram:t}=await import("./program-
|
|
810
|
+
`}import{Command as VR}from"commander";import Ze from"chalk";import{writeFileSync as XR,mkdirSync as KR,existsSync as ba,readFileSync as C$,appendFileSync as T$}from"fs";import{resolve as Ss,dirname as I$}from"path";import{homedir as gd}from"os";var j$=new VR().name("completion").description("generate a shell completion script for agentx").option("-s, --shell <shell>","shell to generate completion for: zsh|bash|fish","zsh").option("-i, --install","install the completion script to a default path for the shell").option("-o, --output <path>","write the script to this path (overrides default install path)").option("-y, --yes","skip confirmation prompts (non-interactive)").action(async e=>{let{buildProgram:t}=await import("./program-7UMVHRD3.js"),o=await t(),n=String(e.shell||"zsh").toLowerCase(),s;switch(n){case"zsh":s=eC(o);break;case"bash":s=rC(o);break;case"fish":s=iC(o);break;default:console.error(Ze.red(`unsupported shell: ${n}`)),console.error(Ze.dim("supported: zsh, bash, fish")),process.exit(1)}if(!e.install&&!e.output){process.stdout.write(s);return}let r=e.output?Ss(String(e.output)):QR(n);KR(I$(r),{recursive:!0}),XR(r,s),console.log(Ze.green(`\u2713 Wrote ${n} completion to:`)),console.log(` ${r}`),console.log(),ZR(n,r,!!e.yes)});function QR(e){let t=gd();switch(e){case"zsh":return Ss(t,".zsh","completions","_agentx");case"bash":return Ss(t,".bash_completion.d","agentx.bash");case"fish":return Ss(t,".config","fish","completions","agentx.fish");default:throw new Error(`unsupported shell: ${e}`)}}function ZR(e,t,o){if(e==="zsh"){let n=Ss(gd(),".zshrc"),s=I$(t),r=`fpath=(${s} $fpath)`,i="autoload -U compinit && compinit",a=ba(n)?C$(n,"utf-8"):"",c=!a.includes(s),l=!/autoload\s+-U\s+compinit/.test(a);if(!c&&!l){console.log(Ze.dim("~/.zshrc already has fpath + compinit wired up. Run `exec zsh` to pick up the new script."));return}if(o&&ba(n)){let g=["","# agentx completion"];c&&g.push(r),l&&g.push(i),T$(n,g.join(`
|
|
811
811
|
`)+`
|
|
812
812
|
`),console.log(Ze.green("\u2713 Patched ~/.zshrc")),console.log(Ze.dim("Reload your shell: exec zsh"));return}console.log(Ze.dim("Add this to ~/.zshrc if not already present:")),c&&console.log(Ze.cyan(` ${r}`)),l&&console.log(Ze.cyan(` ${i}`)),console.log(),console.log(Ze.dim("Then reload: exec zsh")),console.log(Ze.dim("Or rerun with --yes to auto-patch ~/.zshrc"));return}if(e==="bash"){let n=Ss(gd(),".bashrc"),s=`[ -f "${t}" ] && source "${t}"`;if((ba(n)?C$(n,"utf-8"):"").includes(t)){console.log(Ze.dim("~/.bashrc already sources this file. Start a new shell to pick it up."));return}if(o&&ba(n)){T$(n,`
|
|
813
813
|
# agentx completion
|
|
@@ -823,4 +823,4 @@ ${aC({...t,category:e.category})}`),g&&a.set(l.id,g)}let c=`https://github.com/$
|
|
|
823
823
|
${o.url}`)}catch(t){console.error(Es.red(` ${t.message}`)),process.exitCode=1}});xr.command("draft <file>").description("turn a draft JSON file ({category, title, fields}) into a pre-filled issue form link; '-' reads stdin").requiredOption("--model <model>","the model that wrote the draft").option("--models <pathOrUrl>","model list to read",md).action(async(e,t)=>{try{let o=await hd(t.models);if(!pd(t.model,o)){console.log(fd(t.model,o)),process.exitCode=1;return}let n=e==="-"?await dC():await lC(e,"utf8"),s=JSON.parse(n),{version:r}=await _r(),i=M$({...s,fields:s.fields??{}},{model:t.model,version:r??"unknown"});console.log(i)}catch(o){console.error(Es.red(` ${o.message}`)),process.exitCode=1}});async function dC(){let e=[];for await(let t of process.stdin)e.push(t);return Buffer.concat(e).toString("utf8")}async function PU(){let e=await _r(),t=new gC().name("agentx").description("self-hosted multi-agent orchestrator \u2014 Telegram, WhatsApp, crons, A2A mesh, wiki knowledge").version(e.version||"1.0.0","-v, --version","display the version number");t.hook("preAction",(o,n)=>{let s=Mm(n);Lm(s)&&Pm("cli",s)});for(let o of[Gp,Jp,us,Gn,eo,Et,km,tn,fi,mo,fo,Fo,fy,Lo,mi,n$,_o,jf,_f,Bf,er,eh,rh,Of,ch,lh,Eh,Oh,Nh,Ot,bn,l$,Bs,To,j$,xr])t.addCommand(o);for(let o of F$)t.addCommand(o,{hidden:!0});return t.addHelpText("after",()=>{let o=F$.map(n=>n.name()).sort();return["",`Advanced (${o.length}, hidden \u2014 run \`agentx <command> --help\` for any of them):`,uC(o,74," "),""].join(`
|
|
824
824
|
`)}),t}var F$=[H,fs,yo,Gt,Hs,as,Ye,ho,qo,yn,ws,$s,Io,pt,Zn,Ci,Ji,hn,Gi,e$,t$,uo,fr,Rt,ep,nn,kr,Nc,Bo,wt,Kn,Ic,la,ao,wo,v$,x$,a$];function uC(e,t,o){let n=[],s="";for(let r of e)s&&s.length+r.length+2>t&&(n.push(o+s),s=""),s+=(s?", ":"")+r;return s&&n.push(o+s),n.join(`
|
|
825
825
|
`)}export{PU as buildProgram};
|
|
826
|
-
//# sourceMappingURL=program-
|
|
826
|
+
//# sourceMappingURL=program-7UMVHRD3.js.map
|