agentix-cli 0.55.0 → 0.56.0

package/dist/{chunk-JC5Q5MPI.js → chunk-IL2XLW4H.js}

@@ -1,4 +1,4 @@
-import{a as $c,b as Hn,g as kc}from"./chunk-WOMQ2VGA.js";import{a as gc,c as mc}from"./chunk-D3LSPFHK.js";import{a as ro,b as dc,f as Jn,g as pc,h as uc,i as ii,j as wc,l as bc}from"./chunk-76AHNHWC.js";import{a as fc,c as hc,d as yc}from"./chunk-Z3IP66SL.js";import{a as Gs,b as Gr}from"./chunk-RKPAVWXF.js";import{a as pt}from"./chunk-GV7S5BAX.js";import{e as Pr}from"./chunk-GSX4NK2N.js";import{c as Mr}from"./chunk-SZDACK6O.js";import{$ as Fn,A as Ua,B as qa,C as Wa,D as Ba,E as Ja,F as Ha,G as Xt,H as Xs,I as Mn,J as Ga,K as Eo,L as za,M as Qs,N as Zs,O as Ya,P as Va,Q as Qt,R as Ln,S as Ka,T as Xa,U as Qa,V as Za,W as ft,X as ht,Y as ec,Z as oc,_ as Ce,a as ea,aa as Zt,b as oa,ba as ei,ca as tc,da as Un,ea as qn,fa as ic,ga as ni,h as ia,ha as ac,i as Kt,ia as Wn,j as Nn,ja as yt,k as ca,ka as Bn,l as la,la as si,m as da,ma as cc,n as ga,na as lc,o as ka,p as va,q as Pn,r as Vs,s as Ta,t as Na,u as Da,v as Pa,w as Ma,x as La,y as Fa,z as Ks}from"./chunk-K4RDE6YU.js";import{A as Ca,J as nc,K as oi,L as sc,M as ti,_ as io,aa as rc,m as So,p as Oa,s as Ia,z as ja}from"./chunk-UIVHSYCN.js";import{a as ta,d as na,e as sa}from"./chunk-723K4SAW.js";import{a as Ys,b as Rn,c as _n,d as ma,e as pa,f as ua,i as fa,j as ha,k as ya,l as wa,o as Dn,q as ba,r as $a}from"./chunk-S7CVSKOX.js";import{a as zs,e as zr,f as Yr,h as Vr,i as Kr,k as Xr,l as Qr,m as Zr}from"./chunk-SA23V7WX.js";import{a as ra,p as aa}from"./chunk-W4YMMWJL.js";import{a as xa,b as Sa,c as Ea,d as Aa}from"./chunk-2D3RYIDU.js";import{a as Ra,b as _a}from"./chunk-L53FTKEP.js";import{B as xo,H as Jr,S as Hr,h as jr,q as Cr,v as Bs,w as _r}from"./chunk-EJ5ISSWW.js";import{b as Yt,c as gt,d as jn,e as Cn,f as mt,g as Dr,h as Ho,i as Vt}from"./chunk-CELYD5QW.js";import{e as qr,f as Hs,k as Wr}from"./chunk-WP6KLXTP.js";import{a as Ir}from"./chunk-N6EWZGIX.js";import{b as dt}from"./chunk-DP7RTNDM.js";import{a as Nr,k as Ur}from"./chunk-O3XG2NVR.js";import{b as he,c as Ae,d as ut,e as Br}from"./chunk-EZN2YXRY.js";import{j as Rr}from"./chunk-X5C5W3E4.js";import{f as Lr,g as Fr,h as Js}from"./chunk-76Z4VHDX.js";import{h as Or}from"./chunk-DWADWDMU.js";import{a as Ws}from"./chunk-LKJSPO3S.js";import{b as vo,d as In}from"./chunk-C3VRBEJ7.js";import{b as lt,d as Tr}from"./chunk-2GIDVZ4H.js";import{a as qs,b as fr,c as bg,d as Tn,e as hr,f as kr,g as kg,h as vr,i as vg,m as ct,n as Sr,o as Er,s as Ar,v as so,w as zt}from"./chunk-M4AG2YNX.js";import{a as fo,b as at,e as wr,f as Gt}from"./chunk-72SZI2UW.js";import{a as xr,b as xg}from"./chunk-FX3D7YON.js";import{a as uo,b as wg}from"./chunk-7I7IEX4S.js";import{m as yr,n as j,o as On,q as re}from"./chunk-U4H35SJS.js";import{g as br,k as $r,l as $g}from"./chunk-RGDKHYY2.js";import{Command as Sg}from"commander";var vc=new Sg().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 oa({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()});re();import{Command as Eg}from"commander";import{execFileSync as ao}from"node:child_process";import{cpSync as xc,existsSync as ai,mkdirSync as ri,mkdtempSync as Ag,rmSync as Tg,writeFileSync as Sc}from"node:fs";import{dirname as Ec,join as Le}from"node:path";import{homedir as Gn,release as Og,tmpdir as Ig}from"node:os";import{setTimeout as jg}from"node:timers/promises";function zn(){let e=ma(process.platform,process.arch,Og());if(e)throw new Error(e)}function en(){return`gui/${process.getuid()}/${Ys}`}function wt(){return Le(Gn(),"Library/LaunchAgents",`${Ys}.plist`)}async function Ac(){try{ao("launchctl",["bootout",en()],{stdio:"pipe"})}catch{}for(let e=0;e<30;e++){try{ao("launchctl",["print",en()],{stdio:"pipe"})}catch{return}await jg(200)}throw new Error("The desktop login service did not stop. Retry agentx desktop stop before installing.")}function Tc(){if(!ai(wt()))throw new Error("Run agentx desktop install first.");let e=!0;try{ao("launchctl",["print",en()],{stdio:"pipe"})}catch{e=!1}e||ao("launchctl",["bootstrap",`gui/${process.getuid()}`,wt()],{stdio:"pipe"}),ao("launchctl",["kickstart",en()],{stdio:"pipe"})}function Cg(){let e=wa();if(e&&ai(Le(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 bt=new Eg("desktop").description("install and control the macOS desktop assistant");bt.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=>{zn();let o=j(),t=pa(o.agents,e.agent),n=e.agent,s=o.dashboard?.daemonUrl||`http://${o.node.bind.replace(/^0\.0\.0\.0:/,"127.0.0.1:")}`,i=Cg(),r=Le(Gn(),"Applications");if(console.log(`Desktop assistant \u2192 ${Le(r,Rn)}
+import{a as $c,b as Hn,g as kc}from"./chunk-WOMQ2VGA.js";import{a as gc,c as mc}from"./chunk-D3LSPFHK.js";import{a as ro,b as dc,f as Jn,g as pc,h as uc,i as ii,j as wc,l as bc}from"./chunk-76AHNHWC.js";import{a as fc,c as hc,d as yc}from"./chunk-Z3IP66SL.js";import{a as Gs,b as Gr}from"./chunk-RKPAVWXF.js";import{a as pt}from"./chunk-GV7S5BAX.js";import{e as Pr}from"./chunk-GSX4NK2N.js";import{c as Mr}from"./chunk-SZDACK6O.js";import{$ as oc,A as Ua,B as qa,C as Wa,D as Ba,E as Ja,F as Ha,G as Xt,H as Xs,I as Mn,J as Ga,K as Eo,L as za,M as Qs,N as Zs,O as Ya,P as Va,Q as Qt,R as Ln,S as Ka,T as Xa,U as Fn,V as Un,W as Qa,X as Za,Y as ft,Z as ht,_ as ec,a as ea,aa as Ce,b as oa,ba as qn,ca as Zt,da as ei,ea as tc,fa as ic,ga as ni,h as ia,ha as ac,i as Kt,ia as Wn,j as Nn,ja as yt,k as ca,ka as Bn,l as la,la as si,m as da,ma as cc,n as ga,na as lc,o as ka,p as va,q as Pn,r as Vs,s as Ta,t as Na,u as Da,v as Pa,w as Ma,x as La,y as Fa,z as Ks}from"./chunk-WKMTT2UY.js";import{A as Ca,J as nc,K as oi,L as sc,M as ti,_ as io,aa as rc,m as So,p as Oa,s as Ia,z as ja}from"./chunk-UIVHSYCN.js";import{a as ta,d as na,e as sa}from"./chunk-723K4SAW.js";import{a as Ys,b as Rn,c as _n,d as ma,e as pa,f as ua,i as fa,j as ha,k as ya,l as wa,o as Dn,q as ba,r as $a}from"./chunk-S7CVSKOX.js";import{a as zs,e as zr,f as Yr,h as Vr,i as Kr,k as Xr,l as Qr,m as Zr}from"./chunk-SA23V7WX.js";import{a as ra,p as aa}from"./chunk-W4YMMWJL.js";import{a as xa,b as Sa,c as Ea,d as Aa}from"./chunk-2D3RYIDU.js";import{a as Ra,b as _a}from"./chunk-L53FTKEP.js";import{B as xo,H as Jr,S as Hr,h as jr,q as Cr,v as Bs,w as _r}from"./chunk-EJ5ISSWW.js";import{b as Yt,c as gt,d as jn,e as Cn,f as mt,g as Dr,h as Ho,i as Vt}from"./chunk-CELYD5QW.js";import{e as qr,f as Hs,k as Wr}from"./chunk-WP6KLXTP.js";import{a as Ir}from"./chunk-N6EWZGIX.js";import{b as dt}from"./chunk-DP7RTNDM.js";import{a as Nr,k as Ur}from"./chunk-O3XG2NVR.js";import{b as he,c as Ae,d as ut,e as Br}from"./chunk-EZN2YXRY.js";import{j as Rr}from"./chunk-X5C5W3E4.js";import{f as Lr,g as Fr,h as Js}from"./chunk-76Z4VHDX.js";import{h as Or}from"./chunk-DWADWDMU.js";import{a as Ws}from"./chunk-LKJSPO3S.js";import{b as vo,d as In}from"./chunk-C3VRBEJ7.js";import{b as lt,d as Tr}from"./chunk-2GIDVZ4H.js";import{a as qs,b as fr,c as bg,d as Tn,e as hr,f as kr,g as kg,h as vr,i as vg,m as ct,n as Sr,o as Er,s as Ar,v as so,w as zt}from"./chunk-M4AG2YNX.js";import{a as fo,b as at,e as wr,f as Gt}from"./chunk-72SZI2UW.js";import{a as xr,b as xg}from"./chunk-FX3D7YON.js";import{a as uo,b as wg}from"./chunk-7I7IEX4S.js";import{m as yr,n as j,o as On,q as re}from"./chunk-U4H35SJS.js";import{g as br,k as $r,l as $g}from"./chunk-RGDKHYY2.js";import{Command as Sg}from"commander";var vc=new Sg().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 oa({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()});re();import{Command as Eg}from"commander";import{execFileSync as ao}from"node:child_process";import{cpSync as xc,existsSync as ai,mkdirSync as ri,mkdtempSync as Ag,rmSync as Tg,writeFileSync as Sc}from"node:fs";import{dirname as Ec,join as Le}from"node:path";import{homedir as Gn,release as Og,tmpdir as Ig}from"node:os";import{setTimeout as jg}from"node:timers/promises";function zn(){let e=ma(process.platform,process.arch,Og());if(e)throw new Error(e)}function en(){return`gui/${process.getuid()}/${Ys}`}function wt(){return Le(Gn(),"Library/LaunchAgents",`${Ys}.plist`)}async function Ac(){try{ao("launchctl",["bootout",en()],{stdio:"pipe"})}catch{}for(let e=0;e<30;e++){try{ao("launchctl",["print",en()],{stdio:"pipe"})}catch{return}await jg(200)}throw new Error("The desktop login service did not stop. Retry agentx desktop stop before installing.")}function Tc(){if(!ai(wt()))throw new Error("Run agentx desktop install first.");let e=!0;try{ao("launchctl",["print",en()],{stdio:"pipe"})}catch{e=!1}e||ao("launchctl",["bootstrap",`gui/${process.getuid()}`,wt()],{stdio:"pipe"}),ao("launchctl",["kickstart",en()],{stdio:"pipe"})}function Cg(){let e=wa();if(e&&ai(Le(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 bt=new Eg("desktop").description("install and control the macOS desktop assistant");bt.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=>{zn();let o=j(),t=pa(o.agents,e.agent),n=e.agent,s=o.dashboard?.daemonUrl||`http://${o.node.bind.replace(/^0\.0\.0\.0:/,"127.0.0.1:")}`,i=Cg(),r=Le(Gn(),"Applications");if(console.log(`Desktop assistant \u2192 ${Le(r,Rn)}
 Computer-use helper \u2192 ${Le(r,_n)}
 Agent \u2192 ${n?`${t} (pinned)`:"picked from the menu-bar icon"}
 Daemon \u2192 ${s}
@@ -276,7 +276,7 @@ rules:
     action: deny
     severity: critical
     message: "coder-agent is not permitted to run commands against production."
-`,il=[{relPath:"policy.yaml",content:qm},{relPath:"environments/production.yaml",content:Wm},{relPath:"agents/coder-agent.yaml",content:Bm}];var Ro=new Jm().name("guard").description("destructive-action guardrails \u2014 policy, checks, audit");function Ai(e){return e==="deny"?me.red:e==="escalate"||e==="ask"?me.yellow:e==="warn"?me.magenta:me.green}function ns(e){return e.root?al(e.root):Ha()}Ro.command("check").description("PreToolUse hook entrypoint: read a tool-call payload on stdin, emit a Claude Code decision").option("--agent <id>","agent id this workspace belongs to").option("--root <dir>","AgentX install root (holds .agentx/guardrails + .agentx/db.sqlite)").option("--env <name>","environment scope (e.g. production)").action(async e=>{await Ja({root:ns(e),agentId:e.agent,env:e.env}),process.exit(0)});Ro.command("test <command>").description("dry-run a command through the policy engine and print the verdict").option("--agent <id>","evaluate as this agent").option("--env <name>","environment scope").option("--tool <name>","tool name","Bash").option("--cwd <dir>","workspace cwd for $VAR/.env resolution",process.cwd()).option("--root <dir>","AgentX install root (policy source)").option("--enforce","evaluate as if mode=enforce (show what WOULD block)").option("--json","emit JSON").action((e,o)=>{let t=ns(o),n=o.enforce?"enforce":void 0,{verdict:s,mode:i,ms:r}=Ba({tool:o.tool,command:e,cwd:o.cwd,agentId:o.agent,env:o.env},{root:t,agentId:o.agent,env:o.env,modeOverride:n,noAudit:!0});if(o.json){console.log(JSON.stringify({verdict:s,mode:i,ms:r},null,2));return}Vm(s,i,r)});function Vm(e,o,t){let n=Ai(e.action);console.log(),console.log(`  policy verdict   ${n(e.action.toUpperCase())}${e.matched?"":me.dim("  (no rule matched)")}`),console.log(`  enforced as      ${Ai(e.effectiveAction)(e.effectiveAction)} ${me.dim(`(mode=${o})`)}`),e.ruleId&&console.log(`  rule             ${me.cyan(e.ruleId)}${e.severity?me.dim(`  [${e.severity}]`):""}`),e.resolvedTarget&&console.log(`  resolved target  ${me.yellow(e.resolvedTarget)}`),e.message&&console.log(`  message          ${e.message}`),console.log(`  ${me.dim(`evaluated in ${t}ms`)}`),console.log()}Ro.command("log").description("read the guardrail decision audit trail (newest first)").option("--root <dir>","AgentX install root (holds .agentx/db.sqlite)").option("--verdict <v>","filter by verdict (deny|escalate|warn|allow)").option("--agent <id>","filter by agent").option("--task <id>","filter by task id").option("-n, --limit <n>","max rows","30").option("--json","emit JSON").action(e=>{let o=jr({root:ns(e),verdict:e.verdict,agentId:e.agent,taskId:e.task,limit:parseInt(e.limit,10)||30});if(e.json){console.log(JSON.stringify(o,null,2));return}if(o.length===0){console.log(me.dim("  (no guardrail decisions recorded yet)"));return}for(let t of o){let n=new Date(t.ts).toISOString().replace("T"," ").slice(0,19),s=Ai(t.verdict),i=t.effective_action!==t.verdict?me.dim(`->${t.effective_action}`):"";console.log(`  ${me.dim(n)}  ${s(t.verdict.toUpperCase().padEnd(8))}${i}  ${me.cyan((t.agent_id??"?").padEnd(16))} ${me.dim((t.matched_rule??"-").padEnd(24))} ${(t.command??"").slice(0,70)}`),t.resolved_target&&console.log(me.dim(`             target: ${t.resolved_target}`))}});Ro.command("init").description("scaffold .agentx/guardrails/ with a starter policy + protected-resource example").option("--root <dir>","where to create .agentx/guardrails/",process.cwd()).option("--force","overwrite existing files").action(e=>{let o=rl(al(e.root),qa),t=0;for(let n of il){let s=rl(o,n.relPath);if(Hm(s)&&!e.force){console.log(me.dim(`  skip (exists)  ${n.relPath}`));continue}Gm(Ym(s),{recursive:!0}),zm(s,n.content),console.log(me.green(`  created        ${n.relPath}`)),t++}console.log(),console.log(`  Guardrails scaffolded under ${me.cyan(o)}`),console.log(me.dim("  Edit environments/production.yaml with YOUR prod hosts/URLs, then")),console.log(me.dim('  `agentx guard test "<cmd>" --enforce` to preview, and flip mode: enforce when ready.'))});Ro.command("reload").description("signal the daemon to reload (note: guard policy is read live per tool call already)").option("--url <url>","daemon base url",process.env.AGENTX_DAEMON_URL||"http://localhost:19900").action(async e=>{try{let o=await fetch(`${String(e.url).replace(/\/$/,"")}/reload`,{method:"POST"});o.ok?console.log(me.green(`  daemon reloaded (${e.url})`)):console.log(me.yellow(`  daemon reachable but returned ${o.status}`))}catch(o){console.log(me.dim(`  daemon not reachable (${o.message}). Policy files are still read live on each check.`))}});Ro.command("policy").description("print the resolved (merged) policy for an agent").option("--agent <id>","agent id").option("--root <dir>","AgentX install root").action(e=>{let o=Wa(ns(e),e.agent);console.log(JSON.stringify(o,null,2))});zt();import{Command as Km}from"commander";import{execFile as Xm}from"child_process";import{promisify as Qm}from"util";import{existsSync as Zm}from"fs";import Ze from"chalk";Gt();var ln="ui-element";function ss(e){let o=(e.priorAttempts??[]).slice(-4);return{request:e.request,app:e.app,window:e.window??null,...o.length?{alreadyTried:o.map(t=>({control:cn(t.tried,80),screenChanged:t.changed,note:t.note?cn(t.note,120):null}))}:{},controls:e.candidates.map(t=>({id:String(t.id),role:cl(t.role),label:cn(t.label,120),value:t.value?cn(t.value,80):null,enabled:t.enabled}))}}function is(e){let o={};for(let t of e){let n=t.label||t.value||"(unlabelled)";o[String(t.id)]=`${cl(t.role)}: ${cn(n,80)}`}return{target:at(o,"Which control does the request refer to? If `alreadyTried` shows a control was clicked and the screen did not change, that one did not work \u2014 choose differently."),present:fo("The screen actually contains a control matching the request.",{true:"One of the listed controls is plainly the thing the request names, or is the obvious way to perform it.",false:"Nothing listed corresponds to the request \u2014 the right control is on another screen, behind a menu, not yet visible, or this application simply cannot do what was asked."})}}function rs(e,o){let t=e.target,n=o.map(s=>({id:s.id,score:t.probabilities[String(s.id)]??0})).sort((s,i)=>i.score-s.score);return{id:Number(t.choice),confidence:t.confidence,present:e.present.noul,ranked:n}}function cl(e){return e.replace(/^AX/,"").replace(/([a-z])([A-Z])/g,"$1 $2").toLowerCase()}function cn(e,o){let t=String(e??"").replace(/\s+/g," ").trim();return t.length>o?t.slice(0,o):t}var ll=Qm(Xm),dl=new Km().name("point").description("point at the on-screen control matching a description (does not click)").argument("<request>",'what you mean, e.g. "the send button"').option("--max <n>","candidates to consider","40").option("--json","emit the decision as JSON instead of pointing").option("--min-present <p>","refuse below this P(control exists)","0.5").action(async(e,o)=>{Zm(Ce)||(console.log(Ze.red("  helper not built \u2014 run apps/mac-helper/build.sh")),process.exit(1));let t;try{t=await Fn({max:Number(o.max)||40})}catch(d){console.log(Ze.red(`  could not read the screen: ${d?.message??d}`)),process.exit(1)}let n=t.candidates;if(n.length===0&&(console.log(Ze.yellow(`  ${t.app} exposes no usable controls and no readable text`)),process.exit(2)),n.length===1){let d=Zt(t,n[0].id);d&&(console.log(Ze.yellow(`  ${t.app} exposes exactly one target \u2014 pointing at it: `)+Ze.bold(n[0].label)),await ll(Ce,["point","--x",String(d.x),"--y",String(d.y),"--w",String(d.width),"--h",String(d.height),"--label",n[0].label]));return}let s=await so(ln,ss({request:e,app:t.app,window:t.window,candidates:n}),is(n),{features:{app:t.app,candidates:n.length,ocr:t.usedOCR}});s||(console.log(Ze.red(`  the ui-element seat is unavailable \u2014 set decisions.seats.${ln}.mode`)),process.exit(1));let i=rs(s.answers,n),r=Zt(t,i.id),a=n.find(d=>d.id===i.id)?.label??"",c=t.ocrRects.has(i.id),l=Number(o.minPresent)||.5;if((i.present<l||!r)&&(console.log(Ze.yellow(`  nothing on screen matches "${e}"`)+Ze.dim(` (P(exists)=${i.present.toFixed(2)} below ${l})`)),process.exit(2)),o.json){console.log(JSON.stringify({app:t.app,request:e,chosen:{...r,label:a,fromOCR:c},present:i.present,confidence:i.confidence,ranked:i.ranked.slice(0,5).map(d=>({...d,label:n.find(p=>p.id===d.id)?.label}))},null,2));return}let g=a;console.log(`  ${Ze.green("\u2192")} ${Ze.bold(g)} `+Ze.dim(`(${c?"read from screen":"control"}, confidence ${i.confidence.toFixed(2)}, P(exists) ${i.present.toFixed(2)})`)),await ll(Ce,["point","--x",String(r.x),"--y",String(r.y),"--w",String(r.width),"--h",String(r.height),"--label",g])});import{Command as kp}from"commander";import Be from"chalk";import{readFileSync as gl}from"fs";import{homedir as ep}from"os";import{join as op}from"path";var ml=12e5,tp="https://openrouter.ai/api/v1/chat/completions",np=process.env.AGENTX_VISION_MODEL??"anthropic/claude-sonnet-5";async function sp(e={kind:"window"},o=ml,t={}){let n={...t.deps,maxPixels:o,settings:t.screen??t.deps?.settings};if(!t.settle)return yt(e,{},n);try{return await yt(e,{untilStable:!0},n)}catch(s){if(s instanceof ac)return yt(e,{},n);throw s}}var ip=`You are reading a screenshot of a macOS screen to answer one question about what is CURRENTLY TRUE on it.
+`,il=[{relPath:"policy.yaml",content:qm},{relPath:"environments/production.yaml",content:Wm},{relPath:"agents/coder-agent.yaml",content:Bm}];var Ro=new Jm().name("guard").description("destructive-action guardrails \u2014 policy, checks, audit");function Ai(e){return e==="deny"?me.red:e==="escalate"||e==="ask"?me.yellow:e==="warn"?me.magenta:me.green}function ns(e){return e.root?al(e.root):Ha()}Ro.command("check").description("PreToolUse hook entrypoint: read a tool-call payload on stdin, emit a Claude Code decision").option("--agent <id>","agent id this workspace belongs to").option("--root <dir>","AgentX install root (holds .agentx/guardrails + .agentx/db.sqlite)").option("--env <name>","environment scope (e.g. production)").action(async e=>{await Ja({root:ns(e),agentId:e.agent,env:e.env}),process.exit(0)});Ro.command("test <command>").description("dry-run a command through the policy engine and print the verdict").option("--agent <id>","evaluate as this agent").option("--env <name>","environment scope").option("--tool <name>","tool name","Bash").option("--cwd <dir>","workspace cwd for $VAR/.env resolution",process.cwd()).option("--root <dir>","AgentX install root (policy source)").option("--enforce","evaluate as if mode=enforce (show what WOULD block)").option("--json","emit JSON").action((e,o)=>{let t=ns(o),n=o.enforce?"enforce":void 0,{verdict:s,mode:i,ms:r}=Ba({tool:o.tool,command:e,cwd:o.cwd,agentId:o.agent,env:o.env},{root:t,agentId:o.agent,env:o.env,modeOverride:n,noAudit:!0});if(o.json){console.log(JSON.stringify({verdict:s,mode:i,ms:r},null,2));return}Vm(s,i,r)});function Vm(e,o,t){let n=Ai(e.action);console.log(),console.log(`  policy verdict   ${n(e.action.toUpperCase())}${e.matched?"":me.dim("  (no rule matched)")}`),console.log(`  enforced as      ${Ai(e.effectiveAction)(e.effectiveAction)} ${me.dim(`(mode=${o})`)}`),e.ruleId&&console.log(`  rule             ${me.cyan(e.ruleId)}${e.severity?me.dim(`  [${e.severity}]`):""}`),e.resolvedTarget&&console.log(`  resolved target  ${me.yellow(e.resolvedTarget)}`),e.message&&console.log(`  message          ${e.message}`),console.log(`  ${me.dim(`evaluated in ${t}ms`)}`),console.log()}Ro.command("log").description("read the guardrail decision audit trail (newest first)").option("--root <dir>","AgentX install root (holds .agentx/db.sqlite)").option("--verdict <v>","filter by verdict (deny|escalate|warn|allow)").option("--agent <id>","filter by agent").option("--task <id>","filter by task id").option("-n, --limit <n>","max rows","30").option("--json","emit JSON").action(e=>{let o=jr({root:ns(e),verdict:e.verdict,agentId:e.agent,taskId:e.task,limit:parseInt(e.limit,10)||30});if(e.json){console.log(JSON.stringify(o,null,2));return}if(o.length===0){console.log(me.dim("  (no guardrail decisions recorded yet)"));return}for(let t of o){let n=new Date(t.ts).toISOString().replace("T"," ").slice(0,19),s=Ai(t.verdict),i=t.effective_action!==t.verdict?me.dim(`->${t.effective_action}`):"";console.log(`  ${me.dim(n)}  ${s(t.verdict.toUpperCase().padEnd(8))}${i}  ${me.cyan((t.agent_id??"?").padEnd(16))} ${me.dim((t.matched_rule??"-").padEnd(24))} ${(t.command??"").slice(0,70)}`),t.resolved_target&&console.log(me.dim(`             target: ${t.resolved_target}`))}});Ro.command("init").description("scaffold .agentx/guardrails/ with a starter policy + protected-resource example").option("--root <dir>","where to create .agentx/guardrails/",process.cwd()).option("--force","overwrite existing files").action(e=>{let o=rl(al(e.root),qa),t=0;for(let n of il){let s=rl(o,n.relPath);if(Hm(s)&&!e.force){console.log(me.dim(`  skip (exists)  ${n.relPath}`));continue}Gm(Ym(s),{recursive:!0}),zm(s,n.content),console.log(me.green(`  created        ${n.relPath}`)),t++}console.log(),console.log(`  Guardrails scaffolded under ${me.cyan(o)}`),console.log(me.dim("  Edit environments/production.yaml with YOUR prod hosts/URLs, then")),console.log(me.dim('  `agentx guard test "<cmd>" --enforce` to preview, and flip mode: enforce when ready.'))});Ro.command("reload").description("signal the daemon to reload (note: guard policy is read live per tool call already)").option("--url <url>","daemon base url",process.env.AGENTX_DAEMON_URL||"http://localhost:19900").action(async e=>{try{let o=await fetch(`${String(e.url).replace(/\/$/,"")}/reload`,{method:"POST"});o.ok?console.log(me.green(`  daemon reloaded (${e.url})`)):console.log(me.yellow(`  daemon reachable but returned ${o.status}`))}catch(o){console.log(me.dim(`  daemon not reachable (${o.message}). Policy files are still read live on each check.`))}});Ro.command("policy").description("print the resolved (merged) policy for an agent").option("--agent <id>","agent id").option("--root <dir>","AgentX install root").action(e=>{let o=Wa(ns(e),e.agent);console.log(JSON.stringify(o,null,2))});zt();import{Command as Km}from"commander";import{execFile as Xm}from"child_process";import{promisify as Qm}from"util";import{existsSync as Zm}from"fs";import Ze from"chalk";Gt();var ln="ui-element";function ss(e){let o=(e.priorAttempts??[]).slice(-4);return{request:e.request,app:e.app,window:e.window??null,...o.length?{alreadyTried:o.map(t=>({control:cn(t.tried,80),screenChanged:t.changed,note:t.note?cn(t.note,120):null}))}:{},controls:e.candidates.map(t=>({id:String(t.id),role:cl(t.role),label:cn(t.label,120),value:t.value?cn(t.value,80):null,enabled:t.enabled}))}}function is(e){let o={};for(let t of e){let n=t.label||t.value||"(unlabelled)";o[String(t.id)]=`${cl(t.role)}: ${cn(n,80)}`}return{target:at(o,"Which control does the request refer to? If `alreadyTried` shows a control was clicked and the screen did not change, that one did not work \u2014 choose differently."),present:fo("The screen actually contains a control matching the request.",{true:"One of the listed controls is plainly the thing the request names, or is the obvious way to perform it.",false:"Nothing listed corresponds to the request \u2014 the right control is on another screen, behind a menu, not yet visible, or this application simply cannot do what was asked."})}}function rs(e,o){let t=e.target,n=o.map(s=>({id:s.id,score:t.probabilities[String(s.id)]??0})).sort((s,i)=>i.score-s.score);return{id:Number(t.choice),confidence:t.confidence,present:e.present.noul,ranked:n}}function cl(e){return e.replace(/^AX/,"").replace(/([a-z])([A-Z])/g,"$1 $2").toLowerCase()}function cn(e,o){let t=String(e??"").replace(/\s+/g," ").trim();return t.length>o?t.slice(0,o):t}var ll=Qm(Xm),dl=new Km().name("point").description("point at the on-screen control matching a description (does not click)").argument("<request>",'what you mean, e.g. "the send button"').option("--max <n>","candidates to consider","40").option("--json","emit the decision as JSON instead of pointing").option("--min-present <p>","refuse below this P(control exists)","0.5").action(async(e,o)=>{Zm(Ce)||(console.log(Ze.red("  helper not built \u2014 run apps/mac-helper/build.sh")),process.exit(1));let t;try{t=await qn({max:Number(o.max)||40})}catch(d){console.log(Ze.red(`  could not read the screen: ${d?.message??d}`)),process.exit(1)}let n=t.candidates;if(n.length===0&&(console.log(Ze.yellow(`  ${t.app} exposes no usable controls and no readable text`)),process.exit(2)),n.length===1){let d=Zt(t,n[0].id);d&&(console.log(Ze.yellow(`  ${t.app} exposes exactly one target \u2014 pointing at it: `)+Ze.bold(n[0].label)),await ll(Ce,["point","--x",String(d.x),"--y",String(d.y),"--w",String(d.width),"--h",String(d.height),"--label",n[0].label]));return}let s=await so(ln,ss({request:e,app:t.app,window:t.window,candidates:n}),is(n),{features:{app:t.app,candidates:n.length,ocr:t.usedOCR}});s||(console.log(Ze.red(`  the ui-element seat is unavailable \u2014 set decisions.seats.${ln}.mode`)),process.exit(1));let i=rs(s.answers,n),r=Zt(t,i.id),a=n.find(d=>d.id===i.id)?.label??"",c=t.ocrRects.has(i.id),l=Number(o.minPresent)||.5;if((i.present<l||!r)&&(console.log(Ze.yellow(`  nothing on screen matches "${e}"`)+Ze.dim(` (P(exists)=${i.present.toFixed(2)} below ${l})`)),process.exit(2)),o.json){console.log(JSON.stringify({app:t.app,request:e,chosen:{...r,label:a,fromOCR:c},present:i.present,confidence:i.confidence,ranked:i.ranked.slice(0,5).map(d=>({...d,label:n.find(p=>p.id===d.id)?.label}))},null,2));return}let g=a;console.log(`  ${Ze.green("\u2192")} ${Ze.bold(g)} `+Ze.dim(`(${c?"read from screen":"control"}, confidence ${i.confidence.toFixed(2)}, P(exists) ${i.present.toFixed(2)})`)),await ll(Ce,["point","--x",String(r.x),"--y",String(r.y),"--w",String(r.width),"--h",String(r.height),"--label",g])});import{Command as kp}from"commander";import Be from"chalk";import{readFileSync as gl}from"fs";import{homedir as ep}from"os";import{join as op}from"path";var ml=12e5,tp="https://openrouter.ai/api/v1/chat/completions",np=process.env.AGENTX_VISION_MODEL??"anthropic/claude-sonnet-5";async function sp(e={kind:"window"},o=ml,t={}){let n={...t.deps,maxPixels:o,settings:t.screen??t.deps?.settings};if(!t.settle)return yt(e,{},n);try{return await yt(e,{untilStable:!0},n)}catch(s){if(s instanceof ac)return yt(e,{},n);throw s}}var ip=`You are reading a screenshot of a macOS screen to answer one question about what is CURRENTLY TRUE on it.
 
 Report only what is visible in this image.
 
@@ -309,7 +309,7 @@ ${e.slice(-n)}`}function Al(e){let o=e.trim();return o.includes(`
 `).map(t=>`  ${t}`).join(`
 `),ls=_p(Rp(),".agentx","paste-undo.txt");function Pp(e){try{Np(Dp(ls),{recursive:!0}),Il(ls,e,{mode:384})}catch{}}function Mp(){try{let e=Cp(ls,"utf-8");return Il(ls,"",{mode:384}),e.length?e:null}catch{return null}}async function Lp(){let{stdout:e}=await Ii("pbpaste",[],{maxBuffer:16777216});return e}async function Nl(e){await new Promise((o,t)=>{Ol("pbcopy",[],s=>s?t(s):o()).stdin?.end(e)})}async function Fp(){if(!jp(Ce))return{app:"unknown",role:"an unknown control",label:null};try{let{stdout:e}=await Ii(Ce,["focused"]),o=JSON.parse(e);return o.ok===!1||!o.role?{app:"unknown",role:"an unknown control",label:null}:{app:o.app??"unknown",role:Up(o.role??"",o.editable),label:o.label||null}}catch{return{app:"unknown",role:"an unknown control",label:null}}}function Up(e,o){return{AXTextField:"a single-line text field",AXTextArea:"a multi-line text area",AXSearchField:"a search field",AXComboBox:"a combo box",AXSecureTextField:"a password field"}[e]??(o?"an editable control":`a ${e||"unknown"} control`)}import{Command as qp}from"commander";import Ue from"chalk";re();function Rl(e,o,t={}){let n={shot:null,error:"no banner was shown (held for Focus, or the banner is off)"};return{alert:async(s,i)=>{let{shot:r,error:a}=await Bn(()=>e(s,i),o,{},t);n=r?.timedOut&&!r.changed?{shot:r,error:"the banner region did not change \u2014 Do Not Disturb, or notifications not allowed"}:{shot:r,error:a}},proof:()=>n}}var Wp=process.env.AGENTX_DAEMON_URL??"http://127.0.0.1:18800";function Bp(e,o){return async({title:t,message:n,channel:s,chatId:i})=>{let r=t&&!n.startsWith(t)?`${t}
 ${n}`:n,a=await fetch(`${Wp}/send`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({channel:s??e,chatId:i??o,text:r})});if(!a.ok)throw new Error(`daemon ${a.status}: ${(await a.text().catch(()=>"")).slice(0,200)}`)}}function Jp(e){let o;try{o=j(e.config)}catch{o=void 0}let t=Dn(o?.notifications.local);e.sound||(t.sound=!1),e.banner||(t.banner=!1);let n=e.channel??Pn(o);return{alert:ba(t),banner:t.banner,channel:n}}var _l=new qp().name("notify").description("tell the operator something, holding it if they are in Focus").argument("[message]","what to say").option("--from <who>","who is speaking","agentx").option("--title <text>","notification title","AgentX").option("--priority <n>","1 (min) to 5 (max)","4").option("--urgent","deliver even during Focus").option("--channel <name>","delivery channel (default: notifications.channel, else push when it is on, else ntfy)").option("--chat-id <id>","channel address","default").option("--no-sound","do not play a sound on this machine").option("--no-banner","do not show a banner on this machine").option("-c, --config <path>","agentx.json to read local settings from (default: ./agentx.json)").option("--proof","capture the banner as it shows and print the frame's path").option("--status","show Focus state and anything being held").option("--flush","deliver everything held, as one message").option("--json","emit the result as JSON").action(async(e,o)=>{let t=new ga,n=la(),{alert:s,banner:i,channel:r}=Jp(o),a=s,c;if(o.proof&&!i)c=()=>({shot:null,error:"the banner is off, so there is nothing to capture"});else if(o.proof){let g=io(o.config),d=Rl(s,Wn("notifications",g),{settings:g});a=d.alert,c=d.proof}if(o.status){let g=t.list();if(o.json){console.log(JSON.stringify({focus:n,held:g},null,2));return}console.log(`  ${n.active?Ue.yellow("\u25D0"):Ue.green("\u25CB")} ${da(n)} ${Ue.dim(`\xB7 ${n.reason}`)}`),console.log(`  ${g.length} held`);for(let d of g.slice(0,8)){let p=new Date(d.at).toLocaleTimeString([],{hour:"2-digit",minute:"2-digit"});console.log(Ue.dim(`     ${p}  ${d.from}: ${d.message.slice(0,70)}`))}return}let l=Bp(r,o.chatId);if(o.flush){let g=await va(l,{queue:t,alert:s});console.log(g?Ue.green(`  delivered ${g} held notification(s)`):Ue.dim("  nothing was held"));return}e?.trim()||(console.log(Ue.red("  nothing to say \u2014 pass a message, or use --status / --flush")),process.exit(1));try{let g=await ka({message:e.trim(),from:o.from,title:o.title,priority:Number(o.priority)||4,urgent:!!o.urgent,channel:r,chatId:o.chatId},l,{queue:t,alert:a,focus:n}),d=c?.();if(o.json){console.log(JSON.stringify(d?{...g,proof:d}:g,null,2));return}let p=g.delivered?Ue.green("\u2192"):Ue.yellow("\u23F8");console.log(`  ${p} ${g.reason}`),g.held&&console.log(Ue.dim("    it will arrive with the others when Focus ends")),d?.shot&&console.log(`  ${d.error?Ue.yellow("?"):Ue.green("\u2713")} banner: ${d.shot.path}${Ue.dim(` \xB7 ${d.shot.waitedMs}ms`)}`),d?.error&&console.log(Ue.yellow(`    ${d.error}`))}catch(g){console.log(Ue.red(`  ${g?.message??g}`)),await s(o.title,e.trim()),process.exit(1)}});zt();Sr();hr();Gt();import{Command as Hp}from"commander";import{readFileSync as Gp}from"fs";var Dl=new Hp().name("decide").description("ask a typed question about some state and get a calibrated answer back").option("--file <path>","spec JSON file (default: stdin)").option("--backend <name>","decision backend","typesafe").option("--seat <name>","seat name the answers are recorded under","adhoc").option("--no-record","answer without writing a row").option("--timeout <ms>","abandon the call after this long","20000").action(async e=>{let o;try{o=e.file?Gp(e.file,"utf8"):await zp()}catch(r){et(`could not read the spec: ${r?.message??r}`);return}if(!o.trim())return et("no spec given \u2014 pipe JSON on stdin or pass --file");let t;try{t=JSON.parse(o)}catch(r){return et(`spec is not valid JSON: ${r?.message??r}`)}if(!t.state)return et("spec needs a `state`");if(!t.questions||Object.keys(t.questions).length===0)return et("spec needs at least one entry in `questions`");try{wr(t.questions)}catch(r){return et(r?.message??String(r))}let n=t.seat||e.seat;ct(),process.env[Ar(n)]="active";let s=null;if(e.record!==!1)try{s=new Tn({})}catch(r){process.stderr.write(`[decide] not recording (${r?.message??r})
-`)}Er({enabled:!0,defaultBackend:e.backend,store:s,seats:{[n]:{mode:"active",backend:e.backend}}});let i=await so(n,t.state,t.questions,{timeoutMs:Number(e.timeout)||2e4,features:{via:"cli"}});if(!i)return et(`the ${e.backend} backend did not answer \u2014 check the key and that the seat is reachable`);console.log(JSON.stringify({ok:!0,seat:n,callId:i.callId,answers:i.answers},null,2)),s?.close()});function et(e){console.log(JSON.stringify({ok:!1,error:e},null,2)),process.exitCode=1}async function zp(){if(process.stdin.isTTY)return"";let e=[];for await(let o of process.stdin)e.push(Buffer.from(o));return Buffer.concat(e).toString("utf8")}zt();import{Command as Su}from"commander";import{execFile as Eu,spawn as Kl}from"child_process";import{promisify as Au}from"util";import{existsSync as Tu,statSync as Ou}from"fs";import{join as Xl}from"path";import{tmpdir as Iu}from"os";import Q from"chalk";var Yp={id:"x-advanced-search",title:"X search: find anyone's best posts",appHint:"Opens X in Chrome; sign in before running the lesson.",start:{app:"Google Chrome",url:"https://x.com/home",ready:"Google Chrome is frontmost showing the signed-in x.com home page with its navigation sidebar"},steps:[{say:"Here's something about X search that almost nobody uses. It takes ten seconds and it changes what the site is good for."},{say:"Let's open search. This is it in the sidebar.",find:"the search and explore link in the sidebar",label:"Search",before:"Google Chrome is frontmost showing signed-in x.com with the search and explore sidebar link visible",click:!0,afterClickWaitMs:2600},{say:"Here's the box itself. Most people type a few words here and scroll. But it accepts commands, not just words.",find:"the search query input field where you type",label:"search field",before:"Google Chrome is frontmost showing x.com with the search query input visible",click:!0,afterClickWaitMs:900},{say:"Watch. From colon, then a username, limits it to that person. Then min underscore faves, colon, five hundred \u2014 only posts with at least five hundred likes.",before:"Google Chrome is frontmost on x.com and the empty search query input has keyboard focus",type:"from:naval min_faves:500",holdSeconds:1.8},{say:"And submit.",before:"Google Chrome is frontmost on x.com and the focused search input contains from:naval min_faves:500",key:"return",holdSeconds:3.2,verify:"the x.com page is displaying search results for the query from:naval min_faves:500, with at least one post visible"},{say:"There it is. That person's greatest hits \u2014 everything they wrote that actually landed. No scrolling through years of replies.",holdSeconds:2},{say:"Two more that pair well with it. Until colon, and since colon, with a date, pin it to a time period. Useful when you half remember something from a particular month."},{say:"And filter colon links, or filter colon media, narrows it to posts that shared something, which is usually where the substance is."},{say:"After you search, check the Latest tab. Top is ranked, Latest is chronological, and for research you almost always want chronological.",find:"the Latest tab",label:"Latest"},{say:"That's it. From colon someone, min underscore faves colon five hundred. It works on your own account too, which is a quick way to see what people actually responded to."}]},Vp={id:"x-bookmark-folders",title:"X bookmarks: turn the pile into folders",appHint:"Opens X in Chrome; sign in before running the lesson.",start:{app:"Google Chrome",url:"https://x.com/home",ready:"Google Chrome is frontmost showing the signed-in x.com home page with its navigation sidebar"},steps:[{say:"Most people's bookmarks on X are a single pile they never open again. There's a fix that takes a minute."},{say:"Bookmarks live here in the sidebar. By default everything you save lands in one list, in the order you saved it.",find:"the Bookmarks link in the sidebar",label:"Bookmarks",before:"Google Chrome is frontmost showing signed-in x.com with the Bookmarks sidebar link visible",click:!0,verify:"Google Chrome is showing the x.com Bookmarks page"},{say:"But bookmarks support folders. Open bookmarks and look for the add folder control, usually a small plus at the top right.",find:"the add folder button",label:"new folder"},{say:"The trick is what you name them. Not topics like design or tech, which you'll never search for. Name them after decisions you're going to make, like hiring, or pricing.",holdSeconds:2},{say:"Then when you save a post, hold the bookmark button instead of tapping it, and it asks which folder. That one gesture is the whole difference between a pile and a library."}]},Kp={id:"agentx-dashboard-tour",title:"AgentX: a tour of your agent team",appHint:"Start the demo first: docker compose -f docker-compose.demo.yml up -d",start:{app:"Google Chrome",url:"http://127.0.0.1:18931/live",cleanWindow:!0,ready:"The text laptop-paris is visible on the page"},steps:[{say:"This is AgentX: a team of AI agents running on your own machines. Everything here is real, except the model's replies, which are scripted for the demo."},{say:"Up top, three machines, one agent each, all online.",find:"the 3/3 machines count under Agents online",label:"3 machines online"},{say:"This machine is a laptop in Paris. Its agent, CX, talks to customers, and hands technical work to others.",find:"the laptop-paris machine name",label:"CX \xB7 laptop-paris"},{say:"And this is Builder, on a server in New York. When CX gets a code problem, it sends it here, across the mesh.",find:"the @builder Builder agent name in the vps-nyc section",label:"Builder \xB7 vps-nyc"},{say:"Operations shows what the whole team actually did.",find:"the Operations tab in the top navigation bar",label:"Operations",before:"The AgentX Live page is on screen with the Live tab selected",click:!0,verify:"The page shows the heading Mesh operations"},{say:"Machines online, work in progress, failures today, and jobs waiting for a person to review.",find:"the Nodes online summary",label:"The team at a glance"},{say:"Each lane is one kind of work. The demo's run landed here, as direct tasks.",find:"the Direct lane label in the What ran chart",label:"Direct tasks"},{say:"Workflows turn a job you repeat into steps you can review before they run.",find:"the Workflows tab in the top navigation bar",label:"Workflows",before:"The AgentX page with the heading Mesh operations is on screen",click:!0,verify:"The page shows a Workflows list that includes Draft the demo shop report"},{say:"This one drafts a report for the demo shop. It's saved switched off, so nothing runs until you say so.",find:"the Draft the demo shop report workflow title",label:"A saved workflow"},{say:"And on every page, you can ask an agent about what you're looking at.",find:"the Ask an agent about this page input",label:"Ask an agent"},{say:"That's the tour. Your machines, the work they did, and the jobs you can hand them."}]},ji=[Yp,Vp,Kp];re();re();import oo from"chalk";import{execFile as Xp}from"child_process";import{promisify as Qp}from"util";import{createInterface as Zp}from"readline";var Pl=Qp(Xp);function eu(e){e.type==="step"?console.log(`${oo.cyan(`  ${e.n}. ${e.action}`)}${e.target?oo.dim(` "${e.target}"`):""}  ${e.say}`):e.type==="changed"?console.log(oo.dim(`     ${e.changed?"screen changed":"no change"}`)):e.type==="acted"?console.log(e.error?oo.red(`     failed: ${e.error}`):oo.dim("     done it")):e.type==="replanned"?console.log(oo.yellow(`     screen changed, looking again: ${e.reason}`)):e.type==="door"?console.log(oo.cyan(`  you: ${e.text}`)):e.type==="error"?console.log(oo.red(`  error: ${e.error}`)):e.type==="end"&&console.log(oo.dim(`  \xB7 ended (${e.reason})`))}async function ou(e,o){let t=Date.now()+o;for(let n=0;Date.now()<t;n++){n&&n%10===0&&await Pl("open",["-a",e]).catch(()=>{});try{let s=(await ei()).app;if(s.toLowerCase()===e.replace(/\.app$/i,"").toLowerCase())return s}catch{}await new Promise(s=>setTimeout(s,500))}return null}async function Ml(e,o){let t=j(o.config),n=o.agent||process.env.AGENTX_VOICE_AGENT||t.node.defaultAgent;if(!n||!t.agents[n])throw new Error(`Unknown agent: ${n}`);let s=["teach","watch","act"].includes(o.mode??"")?o.mode:"teach",i;if(o.app&&(await Pl("open",["-a",o.app]),i=await ou(o.app,15e3)??void 0,!i))throw new Error(`${o.app} did not come to the front`);let r=Ln(n,t.agents,!1),a=t.voice.listener??Qa,c=Un(n,t.agents[n]),l=new oc({goal:e,app:i,mode:s,speaker:r,actionsAllowed:c.allowActions,maxSteps:Number(o.steps)||void 0,listener:a},{readScreen:ei,presence:new qn(c,Ce,n),speech:new ft,model:ht({system:ec(r.persona,a)}),act:tc});l.on(eu),console.log(oo.bold(`
+`)}Er({enabled:!0,defaultBackend:e.backend,store:s,seats:{[n]:{mode:"active",backend:e.backend}}});let i=await so(n,t.state,t.questions,{timeoutMs:Number(e.timeout)||2e4,features:{via:"cli"}});if(!i)return et(`the ${e.backend} backend did not answer \u2014 check the key and that the seat is reachable`);console.log(JSON.stringify({ok:!0,seat:n,callId:i.callId,answers:i.answers},null,2)),s?.close()});function et(e){console.log(JSON.stringify({ok:!1,error:e},null,2)),process.exitCode=1}async function zp(){if(process.stdin.isTTY)return"";let e=[];for await(let o of process.stdin)e.push(Buffer.from(o));return Buffer.concat(e).toString("utf8")}zt();import{Command as Su}from"commander";import{execFile as Eu,spawn as Kl}from"child_process";import{promisify as Au}from"util";import{existsSync as Tu,statSync as Ou}from"fs";import{join as Xl}from"path";import{tmpdir as Iu}from"os";import Q from"chalk";var Yp={id:"x-advanced-search",title:"X search: find anyone's best posts",appHint:"Opens X in Chrome; sign in before running the lesson.",start:{app:"Google Chrome",url:"https://x.com/home",ready:"Google Chrome is frontmost showing the signed-in x.com home page with its navigation sidebar"},steps:[{say:"Here's something about X search that almost nobody uses. It takes ten seconds and it changes what the site is good for."},{say:"Let's open search. This is it in the sidebar.",find:"the search and explore link in the sidebar",label:"Search",before:"Google Chrome is frontmost showing signed-in x.com with the search and explore sidebar link visible",click:!0,afterClickWaitMs:2600},{say:"Here's the box itself. Most people type a few words here and scroll. But it accepts commands, not just words.",find:"the search query input field where you type",label:"search field",before:"Google Chrome is frontmost showing x.com with the search query input visible",click:!0,afterClickWaitMs:900},{say:"Watch. From colon, then a username, limits it to that person. Then min underscore faves, colon, five hundred \u2014 only posts with at least five hundred likes.",before:"Google Chrome is frontmost on x.com and the empty search query input has keyboard focus",type:"from:naval min_faves:500",holdSeconds:1.8},{say:"And submit.",before:"Google Chrome is frontmost on x.com and the focused search input contains from:naval min_faves:500",key:"return",holdSeconds:3.2,verify:"the x.com page is displaying search results for the query from:naval min_faves:500, with at least one post visible"},{say:"There it is. That person's greatest hits \u2014 everything they wrote that actually landed. No scrolling through years of replies.",holdSeconds:2},{say:"Two more that pair well with it. Until colon, and since colon, with a date, pin it to a time period. Useful when you half remember something from a particular month."},{say:"And filter colon links, or filter colon media, narrows it to posts that shared something, which is usually where the substance is."},{say:"After you search, check the Latest tab. Top is ranked, Latest is chronological, and for research you almost always want chronological.",find:"the Latest tab",label:"Latest"},{say:"That's it. From colon someone, min underscore faves colon five hundred. It works on your own account too, which is a quick way to see what people actually responded to."}]},Vp={id:"x-bookmark-folders",title:"X bookmarks: turn the pile into folders",appHint:"Opens X in Chrome; sign in before running the lesson.",start:{app:"Google Chrome",url:"https://x.com/home",ready:"Google Chrome is frontmost showing the signed-in x.com home page with its navigation sidebar"},steps:[{say:"Most people's bookmarks on X are a single pile they never open again. There's a fix that takes a minute."},{say:"Bookmarks live here in the sidebar. By default everything you save lands in one list, in the order you saved it.",find:"the Bookmarks link in the sidebar",label:"Bookmarks",before:"Google Chrome is frontmost showing signed-in x.com with the Bookmarks sidebar link visible",click:!0,verify:"Google Chrome is showing the x.com Bookmarks page"},{say:"But bookmarks support folders. Open bookmarks and look for the add folder control, usually a small plus at the top right.",find:"the add folder button",label:"new folder"},{say:"The trick is what you name them. Not topics like design or tech, which you'll never search for. Name them after decisions you're going to make, like hiring, or pricing.",holdSeconds:2},{say:"Then when you save a post, hold the bookmark button instead of tapping it, and it asks which folder. That one gesture is the whole difference between a pile and a library."}]},Kp={id:"agentx-dashboard-tour",title:"AgentX: a tour of your agent team",appHint:"Start the demo first: docker compose -f docker-compose.demo.yml up -d",start:{app:"Google Chrome",url:"http://127.0.0.1:18931/live",cleanWindow:!0,ready:"The text laptop-paris is visible on the page"},steps:[{say:"This is AgentX: a team of AI agents running on your own machines. Everything here is real, except the model's replies, which are scripted for the demo."},{say:"Up top, three machines, one agent each, all online.",find:"the 3/3 machines count under Agents online",label:"3 machines online"},{say:"This machine is a laptop in Paris. Its agent, CX, talks to customers, and hands technical work to others.",find:"the laptop-paris machine name",label:"CX \xB7 laptop-paris"},{say:"And this is Builder, on a server in New York. When CX gets a code problem, it sends it here, across the mesh.",find:"the @builder Builder agent name in the vps-nyc section",label:"Builder \xB7 vps-nyc"},{say:"Operations shows what the whole team actually did.",find:"the Operations tab in the top navigation bar",label:"Operations",before:"The AgentX Live page is on screen with the Live tab selected",click:!0,verify:"The page shows the heading Mesh operations"},{say:"Machines online, work in progress, failures today, and jobs waiting for a person to review.",find:"the Nodes online summary",label:"The team at a glance"},{say:"Each lane is one kind of work. The demo's run landed here, as direct tasks.",find:"the Direct lane label in the What ran chart",label:"Direct tasks"},{say:"Workflows turn a job you repeat into steps you can review before they run.",find:"the Workflows tab in the top navigation bar",label:"Workflows",before:"The AgentX page with the heading Mesh operations is on screen",click:!0,verify:"The page shows a Workflows list that includes Draft the demo shop report"},{say:"This one drafts a report for the demo shop. It's saved switched off, so nothing runs until you say so.",find:"the Draft the demo shop report workflow title",label:"A saved workflow"},{say:"And on every page, you can ask an agent about what you're looking at.",find:"the Ask an agent about this page input",label:"Ask an agent"},{say:"That's the tour. Your machines, the work they did, and the jobs you can hand them."}]},ji=[Yp,Vp,Kp];re();re();import oo from"chalk";import{execFile as Xp}from"child_process";import{promisify as Qp}from"util";import{createInterface as Zp}from"readline";var Pl=Qp(Xp);function eu(e){e.type==="step"?console.log(`${oo.cyan(`  ${e.n}. ${e.action}`)}${e.target?oo.dim(` "${e.target}"`):""}  ${e.say}`):e.type==="changed"?console.log(oo.dim(`     ${e.changed?"screen changed":"no change"}`)):e.type==="acted"?console.log(e.error?oo.red(`     failed: ${e.error}`):oo.dim("     done it")):e.type==="replanned"?console.log(oo.yellow(`     screen changed, looking again: ${e.reason}`)):e.type==="door"?console.log(oo.cyan(`  you: ${e.text}`)):e.type==="error"?console.log(oo.red(`  error: ${e.error}`)):e.type==="end"&&console.log(oo.dim(`  \xB7 ended (${e.reason})`))}async function ou(e,o){let t=Date.now()+o;for(let n=0;Date.now()<t;n++){n&&n%10===0&&await Pl("open",["-a",e]).catch(()=>{});try{let s=(await ei()).app;if(s.toLowerCase()===e.replace(/\.app$/i,"").toLowerCase())return s}catch{}await new Promise(s=>setTimeout(s,500))}return null}async function Ml(e,o){let t=j(o.config),n=o.agent||process.env.AGENTX_VOICE_AGENT||t.node.defaultAgent;if(!n||!t.agents[n])throw new Error(`Unknown agent: ${n}`);let s=["teach","watch","act"].includes(o.mode??"")?o.mode:"teach",i;if(o.app&&(await Pl("open",["-a",o.app]),i=await ou(o.app,15e3)??void 0,!i))throw new Error(`${o.app} did not come to the front`);let r=Ln(n,t.agents,!1),a=t.voice.listener??Qa,c=Fn(n,t.agents[n]),l=new oc({goal:e,app:i,mode:s,speaker:r,actionsAllowed:c.allowActions,maxSteps:Number(o.steps)||void 0,listener:a},{readScreen:ei,presence:new Un(c,Ce,n),speech:new ft,model:ht({system:ec(r.persona,a)}),act:tc});l.on(eu),console.log(oo.bold(`
   ${c.name} teaches: ${e}`)+oo.dim(`  (${s}${s==="act"&&!c.allowActions?", actions not allowed":""}; type to cut in, "stop" to end)
 `));let g=Zp({input:process.stdin});g.on("line",d=>{d.trim()&&l.door(d)}),process.once("SIGINT",()=>l.stop("interrupted")),await l.run(),g.close()}re();import to from"chalk";import{execFile as fu}from"child_process";import{existsSync as Ri,writeFileSync as hu}from"fs";import{homedir as yu}from"os";import{join as Yl,resolve as wu}from"path";import{promisify as bu}from"util";var qe={w:1e3,h:640},Ci=["black","grey","light-violet","violet","blue","light-blue","yellow","orange","green","light-green","light-red","red","white"],Ul=["rectangle","ellipse","triangle","diamond","pentagon","hexagon","octagon","star","rhombus","oval","trapezoid","arrow-right","arrow-left","arrow-up","arrow-down","cloud","heart"],Ll=["none","semi","solid","fill","pattern"],Ni=180,ql=48,tu=["s","m","l","xl"],nu=["draw","sans","serif","mono"];function Wl(){return[`You are an illustrator drawing on a tldraw canvas ${qe.w} wide and ${qe.h} tall (x right, y down, origin top-left).`,`Reply with JSON Lines only: one element per line, no prose, no code fences. Scale the number of elements to the brief: a quick sketch needs 10 to 20, a finished, ambitious piece up to ${Ni}. Draw back to front: background first, then midground, foreground, details, text last, arrows at the very end.`,'Palette (optional, first line): {"palette":{"blue":"#1f5fa6","white":"#f7f3ea"},"say":"Choosing a palette."} remaps any of the colour names to a hex value for this drawing; every later element uses the names.','Shape: {"id":"sea","say":"First, the sea.","geo":"rectangle","x":0,"y":420,"w":1000,"h":220,"color":"blue","fill":"fill","label":"","opacity":1}',`Path: {"id":"dome","say":"","path":[[400,200],[410,170],[440,150],[470,170],[480,200],[400,200]],"color":"white","fill":"fill","opacity":1} is a free outline of 3 to ${ql} points, closed and filled, for any silhouette a box can't make: domes, arches, hills, foliage, stairs, shadows, reflections. Straight edges stay straight; give curves enough points. With fill none it is an open stroke: a railing, a grille bar, a crack, a horizon line.`,'Text: {"id":"title","say":"And a title.","text":"Sidi Bou Said","x":330,"y":40,"size":"xl","color":"black","font":"serif"}',`Arrow: {"id":"a1","say":"That's the sun.","arrow":["sun-note","sun"],"label":"","color":"black"}`,"An arrow joins two DIFFERENT earlier elements. To label something, first add a small text element beside it, then an arrow from that text to the thing.",`geo is one of: ${Ul.join(", ")}.`,`color is one of: ${Ci.join(", ")}. fill is fill (strong colour), solid (pale tint), semi, none or pattern. opacity is 0.1 to 1: use it for shadows, haze and atmospheric depth. size is s, m, l or xl. font is draw (hand-lettered), sans, serif or mono.`,"Keep everything inside the canvas. Give text room: an xl word is about 40 px tall and 28 px wide per letter.","say is a short caption, at most 8 words, in the voice of someone drawing it live. Caption only the steps worth narrating (about one in five) and leave say empty on the rest: captioned steps pause so they can be read, the others draw straight through."].join(`
 `)}function Ot(e,o,t){return typeof e=="string"&&o.includes(e)?e:t}function ot(e){return typeof e=="number"&&Number.isFinite(e)?e:null}var tt=(e,o,t)=>Math.min(t,Math.max(o,e)),Fl=e=>tt(ot(e)??1,.1,1),su=/^#[0-9a-f]{6}$/i;function iu(e){if(!e||typeof e!="object")return null;let o={};for(let[t,n]of Object.entries(e))Ci.includes(t)&&typeof n=="string"&&su.test(n)&&(o[t]=n);return Object.keys(o).length?o:null}function ru(e){if(!Array.isArray(e))return null;let o=[];for(let t of e.slice(0,ql)){if(!Array.isArray(t))return null;let n=ot(t[0]),s=ot(t[1]);if(n===null||s===null)return null;o.push([tt(n,0,qe.w),tt(s,0,qe.h)])}return o.length>=2?o:null}function Bl(e,o){let t=e.trim().replace(/,$/,"");if(!t.startsWith("{"))return null;let n;try{n=JSON.parse(t)}catch{return null}if("palette"in n){let l=iu(n.palette);return!l||o.has("palette")?null:{kind:"palette",id:"palette",say:typeof n.say=="string"?n.say.slice(0,80):"",colors:l}}let s=typeof n.id=="string"&&n.id?n.id.slice(0,40):null;if(!s||o.has(s))return null;let i=typeof n.say=="string"?n.say.slice(0,80):"",r=Ot(n.color,Ci,"black");if(Array.isArray(n.arrow)){let[l,g]=n.arrow;return typeof l!="string"||typeof g!="string"||!o.has(l)||!o.has(g)||l===g?null:{kind:"arrow",id:s,say:i,from:l,to:g,label:typeof n.label=="string"?n.label.slice(0,40):"",color:r}}if("path"in n){let l=ru(n.path),g=Ot(n.fill,Ll,"fill");return!l||g!=="none"&&l.length<3?null:{kind:"path",id:s,say:i,pts:l,color:r,fill:g,opacity:Fl(n.opacity)}}let a=ot(n.x),c=ot(n.y);if(a===null||c===null)return null;if(typeof n.text=="string"&&n.text)return{kind:"text",id:s,say:i,text:n.text.slice(0,60),x:tt(a,0,qe.w-20),y:tt(c,0,qe.h-20),size:Ot(n.size,tu,"l"),color:r,font:Ot(n.font,nu,"draw")};if(typeof n.geo=="string"){let l=ot(n.w),g=ot(n.h);if(l===null||g===null||l<4||g<4)return null;let d=tt(a,0,qe.w-4),p=tt(c,0,qe.h-4);return{kind:"geo",id:s,say:i,geo:Ot(n.geo,Ul,"rectangle"),x:d,y:p,w:Math.min(l,qe.w-d),h:Math.min(g,qe.h-p),color:r,fill:Ot(n.fill,Ll,"solid"),label:typeof n.label=="string"?n.label.slice(0,40):"",opacity:Fl(n.opacity)}}return null}var ds=class{buf="";push(o){this.buf+=o;let t=this.buf.split(`
@@ -367,7 +367,7 @@ return id`:`${n}
 const arrow = helpers.createArrowBetweenShapes(createShapeId(${t(e.from)}), createShapeId(${t(e.to)}), el.label ? { richText: toRichText(el.label) } : {})
 const aid = typeof arrow === 'string' ? arrow : arrow?.id
 if (aid) editor.updateShape({ id: aid, type: 'arrow', props: { color: el.color } })
-return aid ?? null`}function gu(e,o){if(e.kind==="path"){let s=e.pts,i=s[Math.floor(s.length/2)];return[yo(s[0][0],s[0][1]),yo(i[0],i[1])]}if(e.kind==="geo")return[yo(e.x,e.y),yo(e.x+e.w,e.y+e.h)];if(e.kind==="text"){let s=Hl(e);return[yo(s.x,s.y+s.h/2),yo(s.x+s.w,s.y+s.h/2)]}let t=o.get(e.from),n=o.get(e.to);return[yo(t.x+t.w/2,t.y+t.h/2),yo(n.x+n.w/2,n.y+n.h/2)]}var yo=(e,o)=>({x:e,y:o,w:0,h:0});async function zl(e,o,t,n=()=>{}){let s=o.sleep??(x=>new Promise($=>setTimeout($,x))),i=o.now??Date.now,r=t.stepMs??1500,a=t.runTag??i().toString(36),c=i(),l=await o.api.exec(t.docId,cu(60)),g=new Set,d=new Map,p=[],f=!1,u=0,w=null,y=null,k=null,b=()=>{k?.(),k=null},v=x=>{if(g.size>=Ni)return;let $=Bl(x,g);if(!$){x.trim()&&n({type:"skipped",line:x.slice(0,120)});return}g.add($.id),w??=i()-c,p.push($),n({type:"planned",n:g.size,el:$,atMs:i()-c}),b()},A=(async()=>{let x=new ds;try{for await(let $ of o.model.reply(`Draw: ${e}`,t.signal))x.push($).forEach(v);x.flush().forEach(v)}catch($){y=$?.message??String($)}finally{u=i()-c,f=!0,b()}})(),S=0;for(;!t.signal?.aborted;){let x=p.shift();if(!x){if(f)break;await new Promise(P=>{k=P});continue}if(x.kind==="arrow"&&!(d.has(x.from)&&d.has(x.to))){n({type:"error",error:`${x.id}: an end was not drawn`});continue}let $=i();if(x.kind==="palette"){x.say&&o.presence.say(x.say);try{await o.api.exec(t.docId,Gl(x))}catch(P){n({type:"error",error:`palette: ${P?.message??P}`});continue}S++,n({type:"drawn",n:S,el:x,ms:i()-$});continue}let[R,C]=gu(x,d);x.say&&o.presence.say(x.say),o.presence.moveTo(Jl(l,R.x,R.y)),await s(250),o.presence.moveTo(Jl(l,C.x,C.y));try{await o.api.exec(t.docId,du(x,a))}catch(P){n({type:"error",error:`${x.id}: ${P?.message??P}`});continue}d.set(x.id,x.kind==="geo"?x:x.kind==="text"?Hl(x):x.kind==="path"?lu(x.pts):yo(0,0)),S++,n({type:"drawn",n:S,el:x,ms:i()-$});let I=(x.say?r:0)-(i()-$);I>0&&await s(I)}return await A,y&&n({type:"error",error:`plan: ${y}`}),o.presence.park(),{steps:S,totalMs:i()-c,firstLineMs:w,planMs:u}}import{readFileSync as mu}from"fs";import{homedir as pu}from"os";import{join as uu}from"path";var pn=uu(pu(),"Library","Application Support","tldraw","server.json"),gs=class{constructor(o=pn,t=fetch){this.serverJson=o;this.fetchFn=t}server(){let o;try{o=mu(this.serverJson,"utf8")}catch{throw new Error("tldraw offline is not running (no server.json)")}let{port:t,token:n}=JSON.parse(o);return{port:t,token:n}}async post(o,t){let{port:n,token:s}=this.server(),i=await this.fetchFn(`http://localhost:${n}${o}`,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${s}`},body:JSON.stringify(t)}),r=await i.json();if(!i.ok||r.success===!1)throw new Error(`tldraw ${o}: ${r.error??i.status}`);return r.result}createDoc(o,t){return this.post("/api/docs/create",{name:o,...t?{directory:t}:{}})}exec(o,t){return this.post(`/api/doc/${o}/exec`,{code:t})}search(o){return this.post("/api/search",{code:o})}};var $u=bu(fu),ku="claude-sonnet-5";function vu(e){e.type==="planned"?console.log(to.dim(`     planned ${e.n}: ${e.el.kind} ${e.el.id} at ${(e.atMs/1e3).toFixed(1)} s`)):e.type==="drawn"?console.log(`${to.cyan(`  ${e.n}. ${e.el.kind} ${e.el.id}`)}  ${e.el.say}${to.dim(`  (${(e.ms/1e3).toFixed(1)} s)`)}`):e.type==="skipped"?console.log(to.yellow(`     skipped: ${e.line}`)):console.log(to.red(`  error: ${e.error}`))}async function xu(){if(!Ri(pn)){await $u("open",["-a","tldraw offline"]);for(let e=0;e<40&&!Ri(pn);e++)await new Promise(o=>setTimeout(o,500));if(!Ri(pn))throw new Error("tldraw offline did not start")}}async function Vl(e,o){let t=j(o.config),n=o.agent||process.env.AGENTX_VOICE_AGENT||t.node.defaultAgent;if(!n||!t.agents[n])throw new Error(`Unknown agent: ${n}`);let s=o.model||ku,i=wu(o.out||Yl(yu(),"Documents")),r=Un(n,t.agents[n]),a=ht({system:Wl(),model:s}),c=new qn(r,Ce,n),l=new gs;try{await xu();let g=new Date().toISOString().slice(0,19).replace(/[:T]/g,"-"),d=await l.createDoc(`agentx-draw-${g}`,i);await new Promise(k=>setTimeout(k,800)),console.log(to.bold(`
+return aid ?? null`}function gu(e,o){if(e.kind==="path"){let s=e.pts,i=s[Math.floor(s.length/2)];return[yo(s[0][0],s[0][1]),yo(i[0],i[1])]}if(e.kind==="geo")return[yo(e.x,e.y),yo(e.x+e.w,e.y+e.h)];if(e.kind==="text"){let s=Hl(e);return[yo(s.x,s.y+s.h/2),yo(s.x+s.w,s.y+s.h/2)]}let t=o.get(e.from),n=o.get(e.to);return[yo(t.x+t.w/2,t.y+t.h/2),yo(n.x+n.w/2,n.y+n.h/2)]}var yo=(e,o)=>({x:e,y:o,w:0,h:0});async function zl(e,o,t,n=()=>{}){let s=o.sleep??(x=>new Promise($=>setTimeout($,x))),i=o.now??Date.now,r=t.stepMs??1500,a=t.runTag??i().toString(36),c=i(),l=await o.api.exec(t.docId,cu(60)),g=new Set,d=new Map,p=[],f=!1,u=0,w=null,y=null,k=null,b=()=>{k?.(),k=null},v=x=>{if(g.size>=Ni)return;let $=Bl(x,g);if(!$){x.trim()&&n({type:"skipped",line:x.slice(0,120)});return}g.add($.id),w??=i()-c,p.push($),n({type:"planned",n:g.size,el:$,atMs:i()-c}),b()},A=(async()=>{let x=new ds;try{for await(let $ of o.model.reply(`Draw: ${e}`,t.signal))x.push($).forEach(v);x.flush().forEach(v)}catch($){y=$?.message??String($)}finally{u=i()-c,f=!0,b()}})(),S=0;for(;!t.signal?.aborted;){let x=p.shift();if(!x){if(f)break;await new Promise(P=>{k=P});continue}if(x.kind==="arrow"&&!(d.has(x.from)&&d.has(x.to))){n({type:"error",error:`${x.id}: an end was not drawn`});continue}let $=i();if(x.kind==="palette"){x.say&&o.presence.say(x.say);try{await o.api.exec(t.docId,Gl(x))}catch(P){n({type:"error",error:`palette: ${P?.message??P}`});continue}S++,n({type:"drawn",n:S,el:x,ms:i()-$});continue}let[R,C]=gu(x,d);x.say&&o.presence.say(x.say),o.presence.moveTo(Jl(l,R.x,R.y)),await s(250),o.presence.moveTo(Jl(l,C.x,C.y));try{await o.api.exec(t.docId,du(x,a))}catch(P){n({type:"error",error:`${x.id}: ${P?.message??P}`});continue}d.set(x.id,x.kind==="geo"?x:x.kind==="text"?Hl(x):x.kind==="path"?lu(x.pts):yo(0,0)),S++,n({type:"drawn",n:S,el:x,ms:i()-$});let I=(x.say?r:0)-(i()-$);I>0&&await s(I)}return await A,y&&n({type:"error",error:`plan: ${y}`}),o.presence.park(),{steps:S,totalMs:i()-c,firstLineMs:w,planMs:u}}import{readFileSync as mu}from"fs";import{homedir as pu}from"os";import{join as uu}from"path";var pn=uu(pu(),"Library","Application Support","tldraw","server.json"),gs=class{constructor(o=pn,t=fetch){this.serverJson=o;this.fetchFn=t}server(){let o;try{o=mu(this.serverJson,"utf8")}catch{throw new Error("tldraw offline is not running (no server.json)")}let{port:t,token:n}=JSON.parse(o);return{port:t,token:n}}async post(o,t){let{port:n,token:s}=this.server(),i=await this.fetchFn(`http://localhost:${n}${o}`,{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${s}`},body:JSON.stringify(t)}),r=await i.json();if(!i.ok||r.success===!1)throw new Error(`tldraw ${o}: ${r.error??i.status}`);return r.result}createDoc(o,t){return this.post("/api/docs/create",{name:o,...t?{directory:t}:{}})}exec(o,t){return this.post(`/api/doc/${o}/exec`,{code:t})}search(o){return this.post("/api/search",{code:o})}};var $u=bu(fu),ku="claude-sonnet-5";function vu(e){e.type==="planned"?console.log(to.dim(`     planned ${e.n}: ${e.el.kind} ${e.el.id} at ${(e.atMs/1e3).toFixed(1)} s`)):e.type==="drawn"?console.log(`${to.cyan(`  ${e.n}. ${e.el.kind} ${e.el.id}`)}  ${e.el.say}${to.dim(`  (${(e.ms/1e3).toFixed(1)} s)`)}`):e.type==="skipped"?console.log(to.yellow(`     skipped: ${e.line}`)):console.log(to.red(`  error: ${e.error}`))}async function xu(){if(!Ri(pn)){await $u("open",["-a","tldraw offline"]);for(let e=0;e<40&&!Ri(pn);e++)await new Promise(o=>setTimeout(o,500));if(!Ri(pn))throw new Error("tldraw offline did not start")}}async function Vl(e,o){let t=j(o.config),n=o.agent||process.env.AGENTX_VOICE_AGENT||t.node.defaultAgent;if(!n||!t.agents[n])throw new Error(`Unknown agent: ${n}`);let s=o.model||ku,i=wu(o.out||Yl(yu(),"Documents")),r=Fn(n,t.agents[n]),a=ht({system:Wl(),model:s}),c=new Un(r,Ce,n),l=new gs;try{await xu();let g=new Date().toISOString().slice(0,19).replace(/[:T]/g,"-"),d=await l.createDoc(`agentx-draw-${g}`,i);await new Promise(k=>setTimeout(k,800)),console.log(to.bold(`
   ${r.name} draws: ${e}`)+to.dim(`  (${s}, ${d.filePath})
 `));let p=new AbortController;process.once("SIGINT",()=>p.abort());let f=await zl(e,{api:l,presence:c,model:a},{docId:d.id,signal:p.signal},vu);await l.exec(d.id,"await helpers.saveDoc(); return true");let u=await l.exec(d.id,"const r = await editor.toImageDataUrl([...editor.getCurrentPageShapeIds()], { format: 'png', scale: 2, background: true }); return r.url"),w=d.filePath?d.filePath.replace(/\.tldraw$/,".png"):Yl(i,`agentx-draw-${g}.png`);hu(w,Buffer.from(u.slice(u.indexOf(",")+1),"base64")),console.log(to.bold(`
   ${f.steps} steps in ${(f.totalMs/1e3).toFixed(1)} s`)+to.dim(`  (first shape planned at ${f.firstLineMs===null?"\u2013":(f.firstLineMs/1e3).toFixed(1)} s, plan done at ${(f.planMs/1e3).toFixed(1)} s)`));let y=a.lastUsage;y&&console.log(to.dim(`  tokens: ${y.inputTokens} in, ${y.outputTokens} out, ${y.cacheReadTokens} cache read, ${y.cacheWriteTokens} cache write; cost ${y.costUsd===null?"not reported":`$${y.costUsd.toFixed(4)}`}`)),console.log(to.dim(`  ${d.filePath}
@@ -382,7 +382,7 @@ return aid ?? null`}function gu(e,o){if(e.kind==="path"){let s=e.pts,i=s[Math.fl
   stopping: could not confirm \u2014 ${d.verify}`)),console.log(Q.dim(`  ${w.reason}`)),console.log(Q.dim(`  screenshot: ${w.sighting.shot.path}`)),await Do(2500);try{r?.stdin?.end()}catch{}l=!0;break}}}}}catch(g){l=!0,console.log(Q.red(`  stopping: ${g?.message??g}`)),a("Stopped",String(g?.message??g),"waiting")}finally{if(l)try{r?.stdin?.end()}catch{}}if(!l){a("Done",t.title,"done"),await Do(1200);try{r?.stdin?.end()}catch{}}if(s&&i){s.kill("SIGINT"),await Do(2500);try{let{size:g}=Ou(i);console.log(Q.green(`  recorded ${(g/1048576).toFixed(1)} MB \u2192 ${i}`))}catch{console.log(Q.yellow("  recording produced no file \u2014 check Screen Recording permission"))}}if(l){console.log(Q.red(`  lesson stopped before the end.
 `)),process.exitCode=3;return}console.log(Q.green(`
   done.
-`))});function ju(e){return e.cleanWindow?["-na",e.app,"--args",`--user-data-dir=${Xl(Iu(),"agentx-teach-chrome")}`,"--no-first-run","--no-default-browser-check","--window-position=0,200","--window-size=1440,680",`--app=${e.url}`]:["-a",e.app,e.url]}async function ms(e){let o=await gn(e);if(!o.ok)throw new Error(`Not ready: ${e}. ${o.reason}`)}async function _i(e){try{let{stdout:o}=await Di(Ce,e),t=JSON.parse(o||"{}");return t.ok===!1?{error:String(t.error??"refused")}:{error:null,changed:t.changed}}catch(o){try{let t=JSON.parse(o?.stdout||"{}");if(t.error)return{error:String(t.error)}}catch{}return{error:o?.message??"failed"}}}async function Cu(e,o=[]){try{let t=await Fn({max:45});if(t.candidates.length<2)return null;let n=await so(ln,ss({request:e,app:t.app,window:t.window,candidates:t.candidates,priorAttempts:o}),is(t.candidates),{features:{app:t.app,via:"teach",ocr:t.usedOCR}});if(!n)return null;let s=rs(n.answers,t.candidates);return s.present<.5?null:Zt(t,s.id)}catch{return null}}function Nu(e,o){if(e?.trim().toLowerCase()===Eo)return{provider:"system",elevenlabs:Qt(),system:null,fallback:!0};let t=e?Mn(e,Xt()):null;if(t)return{provider:"system",elevenlabs:Qt(),system:t.id,fallback:!0};if(e)return{provider:"elevenlabs",elevenlabs:e,system:null,fallback:!0};try{let n=j(),s=o||process.env.AGENTX_VOICE_AGENT||n.node.defaultAgent;return s&&!n.agents[s]&&console.log(Q.yellow(`  no agent "${s}" in agentx.json \u2014 using the default voice`)),s&&n.agents[s]?Va(za(s,n.agents,n.voice)):{provider:n.voice.provider,elevenlabs:Qt(),system:null,fallback:n.voice.fallback==="system"}}catch(n){return console.log(Q.dim(`  no agent voice (${String(n?.message??n).split(`
+`))});function ju(e){return e.cleanWindow?["-na",e.app,"--args",`--user-data-dir=${Xl(Iu(),"agentx-teach-chrome")}`,"--no-first-run","--no-default-browser-check","--window-position=0,200","--window-size=1440,680",`--app=${e.url}`]:["-a",e.app,e.url]}async function ms(e){let o=await gn(e);if(!o.ok)throw new Error(`Not ready: ${e}. ${o.reason}`)}async function _i(e){try{let{stdout:o}=await Di(Ce,e),t=JSON.parse(o||"{}");return t.ok===!1?{error:String(t.error??"refused")}:{error:null,changed:t.changed}}catch(o){try{let t=JSON.parse(o?.stdout||"{}");if(t.error)return{error:String(t.error)}}catch{}return{error:o?.message??"failed"}}}async function Cu(e,o=[]){try{let t=await qn({max:45});if(t.candidates.length<2)return null;let n=await so(ln,ss({request:e,app:t.app,window:t.window,candidates:t.candidates,priorAttempts:o}),is(t.candidates),{features:{app:t.app,via:"teach",ocr:t.usedOCR}});if(!n)return null;let s=rs(n.answers,t.candidates);return s.present<.5?null:Zt(t,s.id)}catch{return null}}function Nu(e,o){if(e?.trim().toLowerCase()===Eo)return{provider:"system",elevenlabs:Qt(),system:null,fallback:!0};let t=e?Mn(e,Xt()):null;if(t)return{provider:"system",elevenlabs:Qt(),system:t.id,fallback:!0};if(e)return{provider:"elevenlabs",elevenlabs:e,system:null,fallback:!0};try{let n=j(),s=o||process.env.AGENTX_VOICE_AGENT||n.node.defaultAgent;return s&&!n.agents[s]&&console.log(Q.yellow(`  no agent "${s}" in agentx.json \u2014 using the default voice`)),s&&n.agents[s]?Va(za(s,n.agents,n.voice)):{provider:n.voice.provider,elevenlabs:Qt(),system:null,fallback:n.voice.fallback==="system"}}catch(n){return console.log(Q.dim(`  no agent voice (${String(n?.message??n).split(`
 `)[0]}) \u2014 using the default`)),{provider:"system",elevenlabs:Qt(),system:null,fallback:!0}}}var Ru=new ft;async function _u(e,o){o&&await Ru.say({voice:o,text:e})}var Do=e=>new Promise(o=>setTimeout(o,e));re();import{Command as Zl}from"commander";import Je from"chalk";import{createInterface as ed}from"readline";var Du=()=>(process.env.AGENTX_DAEMON_URL||"http://127.0.0.1:18800").replace(/\/+$/,"");async function It(e,o,t){let n={"Content-Type":"application/json"};process.env.MESH_TOKEN&&(n.Authorization=`Bearer ${process.env.MESH_TOKEN}`);let s=await fetch(Du()+o,{method:e,headers:n,body:t?JSON.stringify(t):void 0});return{status:s.status,data:await s.json().catch(()=>({}))}}function Pu(e){e.type==="line"?console.log(`${Je.bold(e.name)}: ${e.text}`):e.type==="gap"?console.log(Je.dim(`  \xB7 ${e.ms} ms between speakers`)):e.type==="door"?console.log(Je.cyan(`  you: ${e.text}`)):e.type==="answered"?console.log(Je.dim(`  \xB7 answered ${e.ms} ms after you spoke`)):e.type==="hush"?console.log(Je.dim("  \xB7 hushed")):e.type==="error"?console.log(Je.red(`  error: ${e.error}`)):e.type==="end"&&console.log(Je.dim(`  \xB7 ended (${e.reason})`))}function od(e){if(!e.length)return"no hand-overs measured";let o=[...e].sort((n,s)=>n-s);return`gap between speakers: median ${o[Math.floor(o.length/2)]} ms, max ${o.at(-1)} ms over ${e.length} hand-overs`}async function Mu(e,o,t){let n=j(t.config),s=n.agents,i;if(e.some(d=>!s[d])){let d=await It("GET","/mesh").then(p=>Array.isArray(p.data)?p.data:[]).catch(()=>[]);i=new Xa(()=>n,()=>d),i.usePool(await Ka(Ga()))}let r=e.map(d=>s[d]?Ln(d,s,!0):i?.speaker(d,!0)),a=e.filter((d,p)=>!r[p]);if(a.length)throw new Error(`Unknown agent: ${a.join(", ")}`);let c=Date.now(),l=new Za({topic:o,context:t.context,maxTurns:Number(t.turns)||10,speakers:r,speech:new ft,listener:n.voice.listener,model:(d,p)=>ht({system:p})});l.on(Pu),l.on(d=>{d.type==="line"&&d.turn===0&&console.log(Je.dim(`  \xB7 first line written ${Date.now()-c} ms after start`))});let g=ed({input:process.stdin});g.on("line",d=>{d.trim()&&l.door(d)}),process.once("SIGINT",()=>l.stop("interrupted")),await l.run(),g.close(),console.log(Je.dim(`  ${od(l.gaps)}`))}async function Lu(e,o,t){let n=await It("POST","/talk",{agents:e,topic:o,context:t.context,maxTurns:Number(t.turns)||void 0});if(n.status>=300)throw new Error(n.data.error||`HTTP ${n.status}`);let s=ed({input:process.stdin});s.on("line",a=>{a.trim()&&It("POST","/talk/door",{text:a})}),process.once("SIGINT",()=>void It("POST","/talk/stop"));let i=0,r=[];for(;;){let{data:a}=await It("GET","/talk"),c=a.transcript??[];for(;i<c.length;i++)console.log(`${Je.bold(c[i].name)}: ${c[i].text}`);if(r=a.gaps??r,!a.active)break;await new Promise(l=>setTimeout(l,400))}s.close(),console.log(Je.dim(`  ${od(r)}`))}var td=new Zl().name("talk").description('two agents, local or on a mesh peer, talk a topic through out loud; type to cut in, "stop" to end').argument("<agentA>").argument("<agentB>").argument("<topic...>").option("--context <text>","a few lines of context both agents should know").option("--turns <n>","most lines before they wrap up (default 10)").option("--local","run the talk in this process instead of the daemon").option("-c, --config <path>","agentx.json for --local (default: the usual lookup)").action(async(e,o,t,n)=>{let s=t.join(" ");try{await(n.local?Mu:Lu)([e,o],s,n),process.exit(0)}catch(i){console.error(Je.red(`  ${i?.message??i}`)),process.exit(1)}}),nd=new Zl().name("narrate").description("switch spoken task narration on or off for an agent or one task").argument("<target>","agent id, or task id with --task").argument("<state>","on | off | default").option("--task","the target is a task id").action(async(e,o,t)=>{let n=o==="on"?!0:o==="off"?!1:o==="default"?null:void 0;n===void 0&&(console.error(Je.red("  state must be on, off or default")),process.exit(1));let{status:s,data:i}=await It("POST","/narration",{[t.task?"taskId":"agentId"]:e,on:n});s>=300&&(console.error(Je.red(`  ${i.error||`HTTP ${s}`}`)),process.exit(1)),console.log(JSON.stringify(i))});re();import{Command as Fu}from"commander";import Oe from"chalk";import{existsSync as Uu,readFileSync as qu,writeFileSync as Wu}from"fs";import{resolve as sd}from"path";var ps=new Fu().name("voice").description("list installed system voices and pick each agent's voice");function Bu(e){let o=e?[e]:[sd(process.cwd(),"agentx.json"),sd(process.cwd(),".agentx/config.json")],t=o.find(n=>Uu(n));if(!t)throw new Error(`No config found. Searched: ${o.join(", ")}`);return t}function Ju(e,o,t,n,s){let{provider:i,gender:r}=n,a=n.lang?.toLowerCase().split(/[-_]/)[0],c=e?.agents?.[o];if(!c)throw new Error(`No agent "${o}" in agentx.json`);if(i&&i!=="system"&&i!=="elevenlabs")throw new Error("--provider must be system or elevenlabs");if(r&&!["female","male","neutral"].includes(r))throw new Error("--gender must be female, male or neutral");if(a&&!t)throw new Error("--lang needs a voice");if(!t&&!i&&!r)throw new Error("Give a voice, a --provider, a --gender, or a mix");let l={...c.voice??{}};i&&(l.provider=i),r&&(l.gender=r);let g=l.provider??e?.voice?.provider??"system",d=[i&&`provider ${i}`,r&&`gender ${r}`],p=w=>{if(!a){l.system=w;return}let y=typeof l.system=="string"?{[String(e?.voice?.locale??"en").toLowerCase().split(/[-_]/)[0]]:l.system}:{...l.system??{}};l.system={...y,[a]:w}},f=a?` for ${a}`:"";if(t){let w=t.trim().toLowerCase()===Eo,y=w?null:Mn(t,s,a??e?.voice?.locale),k=y?`system voice ${Qs(y)}`:"the OS default voice";if((y||w)&&g==="system")p(w?Eo:t),d.push(`${k}${f}`);else if(g==="elevenlabs"&&!y&&!w&&!a)l.elevenlabsVoiceId=t,d.push(`ElevenLabs voice ${t}`);else if(y||w)p(w?Eo:t),d.push(`fallback ${k}${f}`);else throw new Error(`"${t}" is not an installed system voice. Run \`agentx voice list\`, or add --provider elevenlabs for an ElevenLabs voice id.`)}let u=d.filter(Boolean).join(", ");return{raw:{...e,agents:{...e.agents,[o]:{...c,voice:l}}},summary:u}}ps.command("list").alias("ls").description("installed system voices, best first, and which agent uses which").option("--all","every language, not only the configured one").option("-c, --config <path>","agentx.json to read").action(e=>{let o=Xt(),t;try{t=j(e.config)}catch{}let n=t?.voice.locale??"en",s=new Map,i=t?Ya(t.agents,t.voice,o):new Map;if(t)for(let[r,a]of Object.entries(t.agents)){let c=i.get(r),l=Object.values(Zs(r,a.voice?.system,a.voice?.gender,t.voice,o));for(let g of new Set([c,...l]))g&&s.set(g.id,[...s.get(g.id)??[],r])}if(!o.length)console.log(Oe.yellow(`
   No system voices found (system voices need macOS).
 `));else{let r=e.all?Xs(o,""):Xs(o,n);console.log(Oe.bold(`
@@ -396,7 +396,7 @@ return aid ?? null`}function gu(e,o){if(e.kind==="path"){let s=e.pts,i=s[Math.fl
    settings \u2014 without this an attached production identity would be less
    guarded than a spawned one.)`))):console.log(N.yellow("  ! Guard hook skipped. An attached production identity will run unguarded.")),console.log(),console.log(`Next: ${N.cyan("agentx attach <agent>")} inside a Claude Code session.`)}catch(o){console.error(N.red(`Install failed: ${o?.message??o}`)),process.exit(1)}});Po.command("uninstall").description("remove the attach hooks from ~/.claude/settings.json").option("--path <file>","settings file to patch (default: ~/.claude/settings.json)").option("--remove-guard","also remove the PreToolUse guard hook").action(e=>{try{let o=Nc({path:e.path,keepGuard:!e.removeGuard});console.log(o.changed?`${N.green("\u2713")} Removed attach hooks from ${N.gray(o.path)} (${o.events.join(", ")})`:`${N.gray("Nothing to remove.")}`),e.removeGuard||console.log(N.gray("  PreToolUse guard left in place \u2014 pass --remove-guard to drop it too."))}catch(o){console.error(N.red(`Uninstall failed: ${o?.message??o}`)),process.exit(1)}});re();import{Command as Ku}from"commander";import ye from"chalk";var ws=new Ku().name("process").description("inspect / rotate persistent claude processes (--persistentProcess agents)");function cd(e){let o=typeof e.node=="string"?e.node:"",t=typeof e.token=="string"?e.token:"";if(!o||!t)try{let n=j(e.config);o||(o=n.dashboard?.daemonUrl||""),t||(t=n.dashboard?.token||"")}catch{}return o||(o="http://localhost:18800"),{baseUrl:o.replace(/\/+$/,""),token:t}}function ld(e,o){let t={};return e&&(t.Authorization=`Bearer ${e}`),o&&(t["Content-Type"]=o),t}function ad(e){let o=Math.round((Date.now()-e)/1e3);return o<60?`${o}s`:o<3600?`${Math.round(o/60)}m`:o<86400?`${Math.round(o/3600)}h`:`${Math.round(o/86400)}d`}function Xu(e){return e==="busy"?ye.magenta:e==="warm-hot"?ye.green:e==="warm-cold"?ye.cyan:e==="idle"?ye.yellow:e==="dead"?ye.red:ye.dim}ws.command("list").description("list every live persistent claude process").option("-c, --config <path>","daemon config file").option("--node <url>","daemon URL (defaults to dashboard.daemonUrl)").option("--token <token>","bearer token (defaults to dashboard.token)").option("--json","emit JSON").action(async e=>{let{baseUrl:o,token:t}=cd(e),n;try{n=await fetch(`${o}/api/processes`,{headers:ld(t)})}catch(r){console.log(ye.red(`  could not reach daemon at ${o}: ${r.message||r}`)),process.exit(1)}if(n.status===503){console.log(ye.dim(`  daemon at ${o} has no agents with persistentProcess: true`));return}n.ok||(console.log(ye.red(`  HTTP ${n.status} from ${o}/processes`)),process.exit(1));let i=(await n.json()).processes??[];if(e.json){console.log(JSON.stringify(i,null,2));return}if(i.length===0){console.log(ye.dim("  (no processes)"));return}for(let r of i){let a=Xu(r.state)(r.state.padEnd(9)),c=ad(r.spawnedAt),l=r.lastTurnAt?ad(r.lastTurnAt)+" ago":"\u2014",g=r.lastInputTokens?ye.dim(`last_in=${r.lastInputTokens} tok`):"",d=r.claudeSessionId?ye.dim(`sess=${r.claudeSessionId.slice(0,8)}\u2026`):ye.dim("sess=\u2014"),p=r.pendingTaskId?ye.cyan(`task=${String(r.pendingTaskId).slice(0,12)}`):"";console.log(`${a} ${ye.bold(r.key.agentId)}${ye.dim(":"+r.key.channel+":"+r.key.chatId)} ${ye.dim("\xB7")} pid=${r.pid??"?"} age=${c} turn#${r.turnCount} last=${l} ${d} ${g} ${p}`),r.deadReason&&console.log(`    ${ye.red("dead:")} ${r.deadReason}`)}});ws.command("kill <agentId> <channel> <chatId>").description("force-kill one persistent process (the next dispatch will spawn fresh)").option("-c, --config <path>","daemon config file").option("--node <url>","daemon URL (defaults to dashboard.daemonUrl)").option("--token <token>","bearer token (defaults to dashboard.token)").option("-r, --reason <reason>","kill reason (recorded on the dead-process snapshot)","operator-cli").action(async(e,o,t,n)=>{let{baseUrl:s,token:i}=cd(n),r;try{r=await fetch(`${s}/api/processes/kill`,{method:"POST",headers:ld(i,"application/json"),body:JSON.stringify({agentId:e,channel:o,chatId:t,reason:n.reason})})}catch(a){console.log(ye.red(`  could not reach daemon at ${s}: ${a.message||a}`)),process.exit(1)}if(r.status===503){console.log(ye.dim("  daemon has no persistent-process registry"));return}if(!r.ok){let a=`HTTP ${r.status}`;try{let c=await r.json();c.error&&(a+=` \u2014 ${c.error}`)}catch{}console.log(ye.red(`  ${a}`)),process.exit(1)}console.log(ye.green(`  killed ${e}:${o}:${t}`))});import{Command as Qu}from"commander";import De from"chalk";import{existsSync as Pi,rmSync as Zu}from"fs";import{resolve as Mi}from"path";var jt=new Qu().name("rag").description("manage per-agent lexical (BM25) RAG indexes (improvement plan #7)");jt.command("add <agentId>").description("build or refresh an agent's lexical index from one or more globs").argument("<globs...>","glob patterns relative to cwd (e.g. './docs/**/*.md')").option("-v, --verbose","log each indexed file").action(async(e,o,t)=>{o.length===0&&(console.log(De.red(`  No globs provided. Example: agentx rag add ${e} './docs/**/*.md'`)),process.exit(1));let n=!!t.verbose,s=Date.now(),i=await Lr(e,o,{verbose:n}),r=Date.now()-s;console.log(De.green(`  \u2713 indexed ${i.docs} doc(s) for ${De.bold(e)} in ${r}ms`)),console.log(De.dim(`  \u2192 ${i.path}`))});jt.command("list").description("list every agent's index, sizes, paths").option("-c, --cwd <path>","search root",process.cwd()).action(async e=>{let o=Mi(e.cwd,".agentx","rag");if(!Pi(o)){console.log(De.dim("  (no indexes yet \u2014 try `agentx rag add <agentId> <glob>`)"));return}let{readdirSync:t}=await import("fs"),n=t(o).filter(s=>Pi(Mi(o,s,"index.json")));if(n.length===0){console.log(De.dim("  (no indexes)"));return}for(let s of n.sort()){let i=Js(s);console.log(`  ${De.bold(s)}  ${i.docs} doc(s)  ${De.dim(i.path)}`)}});jt.command("search <agentId> <query>").description("query an agent's index \u2014 useful for debugging recall before the agent calls rag.lexical").option("-k, --k <n>","top-k results","5").option("--json","emit JSON").action((e,o,t)=>{let n=parseInt(t.k,10)||5,s=Fr(e,o,{k:n});if(t.json){console.log(JSON.stringify(s,null,2));return}if(s.length===0){let i=Js(e);i.exists?console.log(De.dim(`  (no hits in ${i.docs} indexed docs)`)):console.log(De.red(`  no index for ${e} \u2014 run \`agentx rag add ${e} <glob>\` first`));return}for(let i of s)console.log(`  ${De.bold(i.title)} ${De.dim(`(${i.score.toFixed(2)})`)}`),console.log(`    ${De.dim(i.path)}`),console.log(`    ${De.dim(i.snippet.slice(0,200))}`)});jt.command("clear <agentId>").description("delete an agent's index").action(e=>{let o=Mi(process.cwd(),".agentx","rag",e);if(!Pi(o)){console.log(De.dim(`  no index for ${e} \u2014 nothing to clear`));return}Zu(o,{recursive:!0,force:!0}),console.log(De.green(`  \u2713 cleared index for ${e}`))});re();import{Command as ef}from"commander";import X from"chalk";import Ct from"prompts";var nt=new ef().name("backlog").description("manage the local backlog used by business workSource=backlog");function un(e){let o=j(e),t=o.business?.workSource,n=t?.type==="backlog"?t.path:".agentx/backlog.md";return{config:o,storePath:n,store:new nc(n)}}function of(e){return e?X.cyan(`${e.type}:${e.project}#${e.iid}`):X.dim("manual")}function tf(e){return{todo:X.gray("todo"),doing:X.yellow("doing"),blocked:X.red("blocked"),done:X.green("done")}[e]}nt.command("list",{isDefault:!0}).description("list backlog items").option("--status <status>","filter by status (todo|doing|blocked|done)").option("--assignee <agent>","filter by assignee").option("--source <type>","filter by source.type (gitlab|github|manual)").option("-c, --config <path>","config path").action(async e=>{let{store:o}=un(e.config),t=o.list();if(e.status&&(t=t.filter(n=>n.status===e.status)),e.assignee&&(t=t.filter(n=>n.assignee===e.assignee)),e.source&&(t=t.filter(n=>e.source==="manual"?!n.source:n.source?.type===e.source)),!t.length){console.log(X.dim("  (no items)"));return}console.log();for(let n of t){let s=n.assignee?X.magenta(`@${n.assignee}`):X.dim("unassigned");console.log(`  ${tf(n.status).padEnd(7)} ${of(n.source)} ${s}  ${n.title}`),n.source?.url&&console.log(X.dim(`         ${n.source.url}`))}console.log(),console.log(X.dim(`  ${t.length} item${t.length===1?"":"s"} \u2014 ${o.jsonPath()}`))});nt.command("claim <id> <agent>").description("assign an item to an agent and set status=doing").option("-c, --config <path>","config path").action(async(e,o,t)=>{let n=un(t.config);n.store.findById(e)||(console.error(X.red(`  item ${e} not found`)),process.exit(1));let i=n.store.update(e,{assignee:o,status:"doing"});if(console.log(X.green(`  claimed: ${i.title} -> ${o}`)),i.source){let r=sc([o],i.source,n.config),a=await ti(i,{assigneeUsernames:r,addLabels:["Doing"],removeLabels:["To Do"]},n.config,(...c)=>console.log(X.dim("  sync:"),...c));console.log(a.ok?X.dim(`  synced -> ${a.url??i.source.type}`):X.yellow(`  sync failed: ${a.error}`))}});nt.command("done <id>").description("mark an item as done; closes the upstream issue if linked").option("--note <text>","comment to post upstream").option("--close","also close the upstream issue (default: only labels change)",!1).option("-c, --config <path>","config path").action(async(e,o)=>{let t=un(o.config);t.store.findById(e)||(console.error(X.red(`  item ${e} not found`)),process.exit(1));let s=t.store.update(e,{status:"done"});if(console.log(X.green(`  done: ${s.title}`)),s.source){let i=await ti(s,{addLabels:["Done"],removeLabels:["Doing"],state:o.close?"closed":void 0,note:o.note},t.config,(...r)=>console.log(X.dim("  sync:"),...r));console.log(i.ok?X.dim(`  synced -> ${i.url??s.source.type}`):X.yellow(`  sync failed: ${i.error}`))}});nt.command("remove <id>").description("remove an item from the local backlog (does NOT touch upstream)").option("-c, --config <path>","config path").action(async(e,o)=>{let{store:t}=un(o.config);t.remove(e)||(console.error(X.red(`  item ${e} not found`)),process.exit(1)),console.log(X.green(`  removed ${e}`))});nt.command("import").description("import open issues from gitlab/github into the backlog (interactive)").option("--source <type>","source type (gitlab|github)").option("--project <id>","project id (group/repo for gitlab, owner/repo for github)").option("--assignee <agent>","assign all imported items to this agentId").option("-c, --config <path>","config path").action(async e=>{let o=un(e.config),t=!!o.config.channels.gitlab?.token,n=!!o.config.channels.github?.token;!t&&!n&&(console.error(X.red("  no source configured \u2014 set channels.gitlab.token or channels.github.token in agentx.json")),process.exit(1));let s=e.source;if(!s){let y=[t&&{title:"GitLab",value:"gitlab"},n&&{title:"GitHub",value:"github"}].filter(Boolean);if(s=(await Ct({type:"select",name:"source",message:"Source",choices:y})).source,!s)return}s==="gitlab"&&!t&&(console.error(X.red("  channels.gitlab.token not configured")),process.exit(1)),s==="github"&&!n&&(console.error(X.red("  channels.github.token not configured")),process.exit(1));let i=e.project;if(!i){let y=s==="gitlab"?sf(o.config):rf(o.config);y.length?(i=(await Ct({type:"autocomplete",name:"project",message:"Project (type to filter, or pick + then Enter for custom)",choices:[...y.map(b=>({title:b,value:b})),{title:"(custom \u2014 type below)",value:"__CUSTOM__"}]})).project,i==="__CUSTOM__"&&(i=(await Ct({type:"text",name:"p",message:s==="gitlab"?"Group/path":"owner/repo"})).p)):i=(await Ct({type:"text",name:"p",message:s==="gitlab"?"Group/path":"owner/repo"})).p}if(!i)return;let a=((await Ct({type:"text",name:"search",message:"Search filter (optional \u2014 leave empty for all open)"})).search||"").trim();console.log(X.dim(`  fetching open issues from ${s}:${i}${a?` (search: ${a})`:""}\u2026`));let c=s==="gitlab"?await af(o.config,i,a):await cf(o.config,i,a);if(!c.length){console.log(X.yellow("  no open issues matched"));return}console.log(X.dim(`  ${c.length} open issue${c.length===1?"":"s"}`));let l=i,g=new Set(o.store.list().map(y=>y.id)),d=c.map(y=>{let k=oi({type:s,project:l,iid:y.iid,url:y.url}),b=g.has(k),v=y.labels.length?` [${y.labels.slice(0,3).join(",")}]`:"";return{title:`#${y.iid} ${y.title}${v}${b?X.dim(" (already imported)"):""}`,value:y,disabled:b}}),f=(await Ct({type:"autocompleteMultiselect",name:"selected",message:"Pick issues to import (space to toggle, Enter to confirm)",instructions:!1,choices:d,min:1})).selected||[];if(!f.length){console.log(X.dim("  nothing selected"));return}let u=f.map(y=>{let k={type:s,host:s==="gitlab"?nf(o.config):void 0,project:l,iid:y.iid,url:y.url};return{id:oi(k),title:y.title,description:y.description,assignee:e.assignee||y.assignee,labels:y.labels,milestone:y.milestone,status:"todo",source:k,importedAt:new Date().toISOString()}}),w=o.store.addMany(u);console.log(X.green(`  imported ${w.length} item${w.length===1?"":"s"}`));for(let y of w)console.log(X.dim(`    ${y.id} \u2014 ${y.title}`))});function nf(e){let o=e.channels.gitlab?.host;if(o)return o.replace(/^https?:\/\//,"").replace(/\/+$/,"")}function sf(e){let o=new Set;for(let n of e.channels.gitlab?.routes??[])n.project&&n.project!=="*"&&o.add(n.project);let t=e.business?.workSource;if(t?.type==="gitlab")for(let n of t.projects??[])o.add(n);for(let n of e.business?.projects??[])n?.id&&n.id.includes("/")&&o.add(n.id);return[...o].sort()}function rf(e){let o=new Set;for(let t of e.channels.github?.routes??[])t.repo&&t.repo!=="*"&&o.add(t.repo);return[...o].sort()}async function af(e,o,t){let n=e.channels.gitlab,s=new URLSearchParams({state:"opened",scope:"all",per_page:"100",order_by:"updated_at",sort:"desc"});t&&s.set("search",t);let i=await fetch(`${n.host}/api/v4/projects/${encodeURIComponent(o)}/issues?${s}`,{headers:{"PRIVATE-TOKEN":n.token}});if(!i.ok)throw new Error(`GitLab ${i.status}: ${await i.text().catch(()=>"")}`);let r=await i.json();return Array.isArray(r)?r.map(a=>({iid:a.iid,title:a.title,description:a.description||void 0,labels:Array.isArray(a.labels)?a.labels.map(c=>typeof c=="string"?c:c.name):[],milestone:a.milestone?.title||void 0,assignee:a.assignee?.username||a.assignees?.[0]?.username||void 0,url:a.web_url})):[]}async function cf(e,o,t){let s={Authorization:`Bearer ${e.channels.github.token}`,Accept:"application/vnd.github+json","X-GitHub-Api-Version":"2022-11-28"},i;if(t){let c=`repo:${o} is:issue is:open ${t}`;i=`https://api.github.com/search/issues?q=${encodeURIComponent(c)}&per_page=100&sort=updated&order=desc`;let l=await fetch(i,{headers:s});if(!l.ok)throw new Error(`GitHub ${l.status}: ${await l.text().catch(()=>"")}`);return((await l.json()).items??[]).map(dd)}i=`https://api.github.com/repos/${o}/issues?state=open&per_page=100&sort=updated&direction=desc`;let r=await fetch(i,{headers:s});if(!r.ok)throw new Error(`GitHub ${r.status}: ${await r.text().catch(()=>"")}`);let a=await r.json();return Array.isArray(a)?a.filter(c=>!c.pull_request).map(dd):[]}function dd(e){return{iid:e.number,title:e.title,description:e.body||void 0,labels:Array.isArray(e.labels)?e.labels.map(o=>typeof o=="string"?o:o.name):[],milestone:e.milestone?.title||void 0,assignee:e.assignee?.login||e.assignees?.[0]?.login||void 0,url:e.html_url}}import{Command as lf}from"commander";import W from"chalk";import{existsSync as df,readFileSync as gf}from"fs";import{resolve as mf}from"path";import pf from"prompts";re();function gd(e){let o=e||mf(process.cwd(),"agentx.json");return df(o)||(console.log(W.red(`  No config at ${o}. Run: agentx init`)),process.exit(1)),JSON.parse(gf(o,"utf-8"))}async function uf(e,o){if(!e)return;if(e==="me"){let n=o?.notifications?.destination;if(n?.channel&&n?.chatId)return{channel:n.channel,chatId:n.chatId,accountId:n.accountId};console.log(W.yellow("  --notify me: no notifications.destination set yet."));let{channel:s,chatId:i,accountId:r}=await pf([{type:"text",name:"channel",message:"Destination channel (telegram/whatsapp):"},{type:"text",name:"chatId",message:"Destination chatId:"},{type:"text",name:"accountId",message:"Account id (optional):"}]);return!s||!i?void 0:{channel:s,chatId:i,accountId:r||void 0}}let t=e.split(":");if(t.length>=2)return{channel:t[0],chatId:t[1],accountId:t[2]};console.log(W.red(`  Unrecognized --notify value: ${e} (use "me" or "channel:chatId[:account]")`))}var wo=new lf().name("schedule").description('schedule agents with natural-language cron: "every morning at 9" --agent devops --do "Post standup"');wo.argument("[when]",'natural-language schedule, e.g. "every morning at 9"').option("--agent <id>","agent to run").option("--do <prompt>","prompt to run at each tick (required unless --id exists)").option("--id <name>","explicit cron id (default: auto-slug of <when>-<agent>)").option("--notify <target>",'"me" (use notifications.destination) or "channel:chatId[:accountId]"').option("--on-error <modes>",'comma list of "log|notify|disable" (default: log; notify implies "notify")').option("--timezone <tz>",`IANA timezone (default: ${zs})`,zs).option("--timeout <seconds>","max run time","600").option("--model <model>","override model").option("--disabled","create but leave disabled").option("--dry-run","print what would be written without writing").action(async(e,o)=>{if(!e){wo.help();return}o.agent||(console.log(W.red('  --agent is required. Try: agentx schedule "every morning at 9" --agent devops --do "..."')),process.exit(1)),!o.do&&!o.id&&(console.log(W.red('  --do "<prompt>" is required')),process.exit(1));let t=Gs(e);t||(console.log(W.red(`  Couldn't parse: "${e}"`)),console.log(W.dim('  Try: "every morning at 9", "weekdays at 6pm", "every 15 minutes",')),console.log(W.dim('       "every monday at 10am", "1st of every month at noon",')),console.log(W.dim('       "daily at 9:30am", "every hour", "hourly"')),process.exit(1));let n=gd(o.config),s=yr(n);n.agents?.[o.agent]||(console.log(W.red(`  Agent "${o.agent}" not found in agentx.json`)),console.log(W.dim(`  Available: ${Object.keys(n.agents||{}).join(", ")||"(none)"}`)),process.exit(1));let i=await uf(o.notify,s),r=o.id||Gr(t.matched,o.agent),a=Yr({parsed:t,agent:o.agent,prompt:o.do,timezone:o.timezone,timeout:parseInt(o.timeout,10),model:o.model,notify:i,onError:zr(o.onError),enabled:!o.disabled}),c=a.onError,l=await he(d=>Ae(d,`crons.${r}`,a),{configPath:o.config,dryRun:!!o.dryRun});l.success||(console.log(W.red(`  \u2717 ${l.error}`)),process.exit(1));let g=o.dryRun?"would add":"Added";console.log(W.green(`  \u2713 ${g} cron ${W.cyan(r)}`)),console.log(W.dim(`    Schedule: ${t.cron}  (${t.human}, ${o.timezone})`)),console.log(W.dim(`    Agent: ${o.agent}`)),i&&console.log(W.dim(`    Notify: ${i.channel} ${i.chatId}`)),c.length&&console.log(W.dim(`    On error: ${c.join(", ")}`)),!o.dryRun&&l.reloaded&&console.log(W.dim("    Daemon hot-reloaded."))});wo.command("list").alias("ls").description("list all scheduled jobs with human-readable descriptions").option("-c, --config <path>","path to agentx.json").action(async e=>{let t=gd(e.config).crons||{},n=Object.entries(t);if(!n.length){console.log(W.dim("  No scheduled jobs"));return}console.log();for(let[s,i]of n){let r=i.approval?W.yellow("\u25D0"):i.enabled?W.green("\u25CF"):W.dim("\u25CB"),a=i.schedule;try{a=(await import("cronstrue")).default.toString(i.schedule,{use24HourTimeFormat:!1})}catch{}if(console.log(`  ${r} ${W.cyan(s.padEnd(32))} ${W.dim(i.schedule.padEnd(14))} ${W.dim("\u2192")} ${i.agent}`),console.log(W.dim(`      ${a} (${i.timezone||"UTC"})`)),i.notify&&console.log(W.dim(`      notify: ${i.notify.channel} ${i.notify.chatId}`)),i.createdBy&&console.log(W.dim(`      created by agent: ${i.createdBy}`)),i.approval){let c=i.timezone||"UTC",l=Kr(Vr(i.schedule,c),c);console.log(W.yellow(`      pending ${i.approval.action} approval (requested by ${i.approval.requestedBy}); next fire: ${l}`)),console.log(W.dim(`      agentx schedule approve ${s}  |  agentx schedule reject ${s}`))}}console.log()});for(let[e,o]of[["on",!0],["off",!1]])wo.command(`${e} <id>`).description(`${o?"enable":"disable"} a scheduled job`).action(async t=>{let n=await Zr(t,o);n.success||(console.log(W.red(`  \u2717 ${n.error}`)),process.exit(1)),console.log(W.green(`  \u2713 ${t} ${o?"enabled":"disabled"}`)),n.reloaded&&console.log(W.dim("    Daemon hot-reloaded."))});wo.command("remove <id>").alias("rm").description("remove a scheduled job").action(async e=>{let o=await he(t=>{if(!ut(t,`crons.${e}`))throw new Error(`cron "${e}" not found`);Br(t,`crons.${e}`)});o.success||(console.log(W.red(`  \u2717 ${o.error}`)),process.exit(1)),console.log(W.green(`  \u2713 ${e} removed`)),o.reloaded&&console.log(W.dim("    Daemon hot-reloaded."))});for(let[e,o,t]of[["approve",Xr,"approve an agent's pending create/delete request (enables or removes the job)"],["reject",Qr,"reject an agent's pending create/delete request (drops the request)"]])wo.command(`${e} <id>`).description(t).option("-c, --config <path>","path to agentx.json").action(async(n,s)=>{let i=await o(n,{configPath:s.config});i.success||(console.log(W.red(`  \u2717 ${i.message}`)),process.exit(1)),console.log(W.green(`  \u2713 ${i.message}`)),i.result?.reloaded&&console.log(W.dim("    Daemon hot-reloaded."))});wo.command("parse <when...>").description("preview a natural-language parse without writing anything").action(e=>{let o=e.join(" "),t=Gs(o);t||(console.log(W.red(`  \u2717 could not parse: "${o}"`)),process.exit(1)),console.log(W.green(`  "${o}"`)),console.log(W.dim(`    \u2192 ${t.cron}`)),console.log(W.dim(`    \u2192 ${t.human}`))});import{Command as ff}from"commander";import ve from"chalk";var Mo=new ff("approvals").description("one inbox for every decision waiting for you (cards, schedules, memory facts, wiki proposals)"),hf={card:"card",schedule:"schedule",memory:"memory",wiki:"wiki"};function md(){return{root:process.cwd()}}function Li(e){return e?e.slice(0,16).replace("T"," ")+" UTC":"unknown"}function yf(e){console.log(`  ${ve.cyan(e.key)}  ${ve.dim(`[${hf[e.kind]}] from ${e.raised_by}`)}${e.snoozed_until?ve.dim(` (later: until ${Li(e.snoozed_until)})`):""}`),console.log(`    ${ve.bold(e.title)}`),console.log(`    ${e.ask}`),e.recommend&&console.log(`    ${ve.green("Recommends:")} ${e.recommend}`),e.expires&&console.log(ve.yellow(`    Expires ${Li(e.expires)}; then: ${e.if_silent}`)),e.detail&&console.log(ve.dim(`    ${e.detail}`)),e.source&&console.log(ve.dim(`    ${e.source}`)),console.log(ve.dim(`    yes: ${e.yes} \xB7 no: ${e.no}${e.more?` \xB7 more: ${e.more}`:""}`))}Mo.command("list",{isDefault:!0}).alias("ls").description("what is waiting, most urgent first").option("--all","include items you put off with `later`").option("--json","machine-readable output").action(e=>{let o=ja(md(),{includeSnoozed:e.all});if(e.json){console.log(JSON.stringify(o,null,2));return}for(let t of o.errors)console.log(ve.red(`  couldn't read ${t.kind}: ${t.error}`));if(o.items.length===0){console.log(ve.dim(`  nothing waiting${o.snoozed?` (${o.snoozed} put off; --all shows them)`:""}`));return}console.log();for(let t of o.items)yf(t),console.log();console.log(ve.dim(`  ${o.items.length} waiting${o.snoozed?`, ${o.snoozed} put off (--all)`:""}. Answer with: agentx approvals approve|reject|later <key>`))});async function Fi(e,o,t){let n=Jn(),s=t.hours?Number(t.hours):n.laterHours;if(o==="later"&&!(s>0)){console.error(ve.red("  --hours must be a positive number")),process.exitCode=1;return}let i=await Ca(md(),e,o,{force:t.force,note:t.note,laterHours:s});if(!i.ok){console.error(ve.red(`  ${i.error}`)),process.exitCode=1;return}console.log(ve.green(`  \u2713 ${i.message}`))}Mo.command("approve").alias("yes").description("say yes: enables the schedule, lets the fact be used, writes the wiki article, or tells the agent yes").argument("<key>","item key from `agentx approvals list`, e.g. card:2026-01-05-publish-draft-ab12").option("--force","wiki: approve even if the article changed since the proposal").option("--note <text>","cards: a note passed to the agent with your answer").action((e,o)=>Fi(e,"yes",o));Mo.command("reject").alias("no").description("say no: drops the request, keeps the fact out, declines the article, or tells the agent no").argument("<key>","item key from `agentx approvals list`").option("--note <text>","why; kept with cards and wiki proposals").action((e,o)=>Fi(e,"no",o));Mo.command("later").description("put an item off; it leaves the list and comes back later (a card still expires on time)").argument("<key>","item key from `agentx approvals list`").option("--hours <n>","how long (default: approvals.laterHours, 24)").action((e,o)=>Fi(e,"later",o));Mo.command("request").description("raise a decision card yourself, for example to test the inbox (agents use the agentx_approval tool)").requiredOption("--agent <id>","the agent the card is from; it gets the result").requiredOption("--title <text>","what it is, in one line").requiredOption("--ask <text>","the yes/no question").requiredOption("--recommend <text>","the advice and why, in one line").requiredOption("--if-silent <value>",`what applies if nobody answers: ${Oa.join(", ")}`).option("--expires <when>","ISO date or time, or like 12h / 3d (default: approvals.defaultExpiryDays)").option("--source <link>","link to the draft, PR or issue").action(e=>{let o=Jn(),t=Ia(process.cwd(),{raised_by:e.agent,title:e.title,ask:e.ask,recommend:e.recommend,if_silent:e.ifSilent,expires:e.expires,source:e.source},{settings:o});if(!t.ok){console.error(ve.red(`  ${t.error}`)),process.exitCode=1;return}console.log(ve.green(`  \u2713 card:${t.card.id} raised; expires ${Li(t.card.expires)}, then: ${t.card.if_silent}`))});Mo.command("settings").description('show or change expiry, "later" and digest settings (approvals in agentx.json)').option("--expiry-days <n>","days a card gets when it doesn't say").option("--max-expiry-days <n>","longest a card may wait").option("--later-hours <n>","how long `later` hides an item").option("--notify-agent <on|off>","tell the agent that raised a card its result").option("--digest <on|off>","the daily message about what is waiting").option("--digest-time <HH:MM>","when the digest goes out, 24-hour local time").option("--digest-timezone <zone>",`IANA timezone for --digest-time; "local" for this machine's`).option("--digest-to <channel:chatId>",'where the digest goes; "default" for notifications.destination').action(async e=>{let o={},t=(a,c)=>{if(c===void 0)return;let l=Number(c);if(!(l>0))throw new Error(`${a} must be a positive number`);return l},n=(a,c)=>{if(c!==void 0){if(c==="on")return!0;if(c==="off")return!1;throw new Error(`${a} takes on or off`)}};try{if(o.defaultExpiryDays=t("--expiry-days",e.expiryDays),o.maxExpiryDays=t("--max-expiry-days",e.maxExpiryDays),o.laterHours=t("--later-hours",e.laterHours),o.notifyAgent=n("--notify-agent",e.notifyAgent),o.digestEnabled=n("--digest",e.digest),e.digestTime!==void 0&&(o.digestTime=e.digestTime),e.digestTimezone!==void 0&&(o.digestTimezone=e.digestTimezone==="local"?null:e.digestTimezone),e.digestTo!==void 0)if(e.digestTo==="default")o.destination=null;else{let a=pc(e.digestTo);if(!a)throw new Error("--digest-to takes channel:chatId, for example telegram:123456");o.destination=a}}catch(a){console.error(ve.red(`  ${a.message}`)),process.exitCode=1;return}if(Object.values(o).some(a=>a!==void 0)){let a=await uc(o);if(!a.success){console.error(ve.red(`  ${a.error}`)),process.exitCode=1;return}console.log(ve.green("  \u2713 saved")+(a.reloaded?ve.dim(" (daemon reloaded)"):""))}let i=Jn(),r=i.digest.destination;console.log(`  Cards expire after      ${i.defaultExpiryDays} day(s) unless they say (at most ${i.maxExpiryDays})`),console.log(`  "Later" hides an item   ${i.laterHours} hour(s)`),console.log(`  Tell the agent          ${i.notifyAgent?"on":"off"}`),console.log(`  Daily digest            ${i.digest.enabled?`on, at ${i.digest.time}${i.digest.timezone?` (${i.digest.timezone})`:" (this machine's time)"}`:"off"}`),console.log(`  Digest goes to          ${r?`${r.channel} ${r.chatId}`:"notifications.destination"}`)});import{Command as Uf}from"commander";import Nt from"chalk";import te from"chalk";import hn from"prompts";import{readFileSync as wf,writeFileSync as bf,existsSync as $f}from"fs";import{resolve as pd}from"path";var kf=/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/;function vf(e){let o=e.trim();return o.startsWith('"')&&o.endsWith('"')||o.startsWith("'")&&o.endsWith("'")?o.slice(1,-1):o}function Ui(e){return/[\s#"'\\]/.test(e)||e===""?JSON.stringify(e):e}function ud(e=".env"){let o=pd(e);if(!$f(o))return[];let t=wf(o,"utf-8"),n=[];for(let s of t.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 i=s.match(kf);i?n.push({kind:"kv",key:i[1],value:vf(i[2]),raw:s}):n.push({kind:"comment",raw:s})}return n.length&&n[n.length-1].kind==="blank"&&n.pop(),n}function xf(e){return e.map(o=>o.kind==="kv"?`${o.key}=${Ui(o.value)}`:o.raw).join(`
 `)+`
-`}function fn(e,o,t=".env"){let n=pd(t),s=ud(n),i=s.findIndex(r=>r.kind==="kv"&&r.key===e);i>=0?s[i]={kind:"kv",key:e,value:o,raw:`${e}=${Ui(o)}`}:(s.length&&s[s.length-1].kind!=="blank"&&s.push({kind:"blank",raw:""}),s.push({kind:"kv",key:e,value:o,raw:`${e}=${Ui(o)}`})),bf(n,xf(s))}function qi(e,o=".env"){return ud(o).find(s=>s.kind==="kv"&&s.key===e)?.value}var fd="https://t.me/BotFather";async function Sf(e){try{let o=await fetch(`https://api.telegram.org/bot${e}/getMe`,{signal:AbortSignal.timeout(8e3)});if(!o.ok)return null;let t=await o.json();return t?.ok?t.result:null}catch{return null}}async function Ef(e,o){let t=Date.now()+o,n=0;try{let i=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=-1&timeout=0`,{signal:AbortSignal.timeout(5e3)})).json();i?.result?.length&&(n=i.result[0].update_id+1)}catch{}for(;Date.now()<t;)try{let i=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=${n}&timeout=10`,{signal:AbortSignal.timeout(15e3)})).json();for(let r of i?.result||[]){n=Math.max(n,r.update_id+1);let a=r.message||r.edited_message||r.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 hd(e={}){console.log(),console.log(te.bold("  Connect Telegram")),console.log(),console.log(te.dim(`  1. Open ${fd}`)),console.log(te.dim("     /newbot   (or /mybots \u2192 pick existing \u2192 API Token)")),console.log(te.dim("  2. Copy the HTTP API token \u2014 looks like 123456789:ABCdef...")),console.log();let{openBrowser:o}=await hn({type:"confirm",name:"openBrowser",message:"Open BotFather in your browser?",initial:!0});if(o)try{let{spawn:b}=await import("child_process"),v=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";b(v,[fd],{stdio:"ignore",detached:!0}).unref()}catch{}let{token:t}=await hn({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"});t||(console.log(te.red("  Aborted")),process.exit(1)),process.stdout.write("  Verifying token... ");let n=await Sf(t.trim());n||(console.log(te.red("\u2717 invalid or revoked")),process.exit(1)),console.log(te.green(`\u2713 ${n.first_name} (@${n.username})`));let{readFileSync:s,existsSync:i}=await import("fs"),{resolve:r}=await import("path"),a=e.configPath||r(process.cwd(),"agentx.json");i(a)||(console.log(te.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(te.red("  No agents configured. Run: agentx agent add")),process.exit(1));let g=e.agent;g||(g=(await hn({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(te.red("  Aborted")),process.exit(1));let d=c.channels?.telegram?.accounts||{},p=e.account||g;d[p]&&d[p].agentBinding!==g&&(p=(await hn({type:"text",name:"account",message:`Account "${p}" 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),p||(console.log(te.red("  Aborted")),process.exit(1));let f=`TG_${p.toUpperCase().replace(/-/g,"_")}_BOT_TOKEN`;fn(f,t.trim()),process.env[f]=t.trim();let u=await he(b=>{Ae(b,"channels.telegram.enabled",!0),Ae(b,`channels.telegram.accounts.${p}`,{token:`\${${f}}`,agentBinding:g});let v=ut(b,`agents.${g}.mentions`)||[],A=`@${n.username}`;v.includes(A)||(v.push(A),Ae(b,`agents.${g}.mentions`,v))},{configPath:e.configPath});if(u.success||(console.log(te.red(`  \u2717 ${u.error}`)),process.exit(1)),console.log(),console.log(te.green(`  \u2713 Bot @${n.username} bound to agent "${g}"`)),console.log(te.dim(`    Token stored in .env as ${f}`)),console.log(te.dim(`    Mentions updated to include @${n.username}`)),u.reloaded?console.log(te.dim("    Daemon hot-reloaded.")):console.log(te.dim("    Start the daemon to begin polling (agentx daemon start)")),e.skipChatCapture)return;console.log();let{capture:w}=await hn({type:"confirm",name:"capture",message:"Listen for a message so we can set this as your default --notify target?",initial:!0});if(!w)return;console.log(),console.log(te.dim(`  Send any message to @${n.username} from the chat you want to use.`)),console.log(te.dim("  Waiting up to 90s..."));let y=await Ef(t.trim(),9e4);if(!y){console.log(te.yellow("  No message received \u2014 skipping. You can set it later with:")),console.log(te.dim("    agentx config set notifications.destination.channel telegram")),console.log(te.dim("    agentx config set notifications.destination.chatId <chatId>")),console.log(te.dim(`    agentx config set notifications.destination.accountId ${p}`));return}let k=await he(b=>{Ae(b,"notifications.destination",{channel:"telegram",chatId:String(y.chatId),accountId:p})},{configPath:e.configPath});if(!k.success){console.log(te.red(`  \u2717 failed to save destination: ${k.error}`));return}console.log(te.green("  \u2713 Default --notify target set")),console.log(te.dim(`    Chat: ${y.chatTitle||y.chatId} (from ${y.from})`)),console.log(te.dim("    From now on, --notify me resolves to this chat.")),k.reloaded&&console.log(te.dim("    Daemon hot-reloaded."))}import we from"chalk";import Wi from"prompts";import{existsSync as Ji,mkdirSync as Af,readdirSync as Tf,readFileSync as yd}from"fs";import{resolve as Bi}from"path";var Of=".agentx/whatsapp-sessions";function If(){let e=Bi(process.cwd(),".agentx/daemon.pid");if(!Ji(e))return!1;try{let o=parseInt(yd(e,"utf-8").trim(),10);return o?(process.kill(o,0),!0):!1}catch{return!1}}function jf(e){if(!Ji(e))return!1;try{return Tf(e).some(o=>o.includes("creds")||o.endsWith(".json"))}catch{return!1}}async function Cf(e,o){let t;try{t=await import("@whiskeysockets/baileys")}catch{return o(we.red("  WhatsApp pairing needs @whiskeysockets/baileys.")),o(we.red("  Install with: pnpm add @whiskeysockets/baileys  (or npm install)")),!1}let{makeWASocket:n,useMultiFileAuthState:s}=t.default||t;Af(e,{recursive:!0});let{state:i,saveCreds:r}=await s(e),a;try{a=(await t.fetchLatestBaileysVersion()).version}catch{}let c={level:"silent",trace:()=>{},debug:()=>{},info:()=>{},warn:()=>{},fatal:()=>{},error:()=>{},child:()=>c},l=n({auth:{creds:i.creds,keys:t.makeCacheableSignalKeyStore?t.makeCacheableSignalKeyStore(i.keys,c):i.keys},...a?{version:a}:{},logger:c,printQRInTerminal:!1,browser:["agentx-connect","pairing","1.0"],syncFullHistory:!1,markOnlineOnConnect:!1});return l.ev.on("creds.update",r),await new Promise(g=>{let p=setTimeout(()=>{o(we.yellow("  Timed out waiting for scan (2min)."));try{l.end(void 0)}catch{}g(!1)},12e4);l.ev.on("connection.update",async f=>{if(f.qr){o(we.dim("  Scan this QR with WhatsApp \u2192 Linked devices \u2192 Link a device:")),o("");try{let{default:u}=await import("qrcode-terminal");u.generate(f.qr,{small:!0})}catch{o(`  QR: ${f.qr}`)}o("")}if(f.connection==="open"){clearTimeout(p),o(we.green("  \u2713 Paired"));try{l.end(void 0)}catch{}g(!0)}f.connection==="close"&&!f.qr&&f.lastDisconnect?.error?.output?.statusCode===401&&(clearTimeout(p),o(we.red("  \u2717 Authorization failed \u2014 rescan required")),g(!1))})})}async function wd(e={}){if(console.log(),console.log(we.bold("  Connect WhatsApp")),console.log(),If()){console.log(we.yellow("  \u26A0 The daemon is running. Stop it first so pairing can open a fresh Baileys session:")),console.log(we.dim("    agentx daemon stop")),console.log();let{cont:l}=await Wi({type:"confirm",name:"cont",message:"Continue anyway? (expect errors)",initial:!1});l||(console.log(we.red("  Aborted")),process.exit(1))}let o=e.configPath||Bi(process.cwd(),"agentx.json");Ji(o)||(console.log(we.red(`  No agentx.json at ${o}. Run: agentx init`)),process.exit(1));let t=JSON.parse(yd(o,"utf-8")),n=e.sessionDir||t.channels?.whatsapp?.sessionDir||Of,s=Bi(process.cwd(),n),i=Object.keys(t.agents||{});i.length===0&&(console.log(we.red("  No agents configured. Run: agentx agent add")),process.exit(1));let r=e.agent;r||(r=(await Wi({type:"select",name:"agent",message:"Default agent for incoming messages:",choices:i.map(g=>({title:g,value:g})),initial:0})).agent),r||(console.log(we.red("  Aborted")),process.exit(1));let a=!e.skipPair;if(jf(s)&&a){let{keep:l}=await Wi({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(we.dim("  Keeping existing session \u2014 skipping QR pair."))}a&&(await Cf(s,g=>console.log(g))||(console.log(we.red("  Pairing failed. You can retry with `agentx connect whatsapp`.")),process.exit(1)));let c=await he(l=>{Ae(l,"channels.whatsapp.enabled",!0),Ae(l,"channels.whatsapp.sessionDir",n),Ae(l,"channels.whatsapp.defaultAgent",r)},{configPath:e.configPath});c.success||(console.log(we.red(`  \u2717 ${c.error}`)),process.exit(1)),console.log(),console.log(we.green(`  \u2713 WhatsApp bound to agent "${r}"`)),console.log(we.dim(`    Session: ${n}`)),console.log(we.dim("    Start the daemon to begin receiving:")),console.log(we.dim("      agentx daemon start")),console.log(we.dim("    Add routes later with:")),console.log(we.dim(`      agentx config set channels.whatsapp.routes '[{"contact":"+1234567890","agent":"${r}"}]'`)),console.log()}import{randomBytes as Nf}from"crypto";import xe from"chalk";import bd from"prompts";var bs="agentx-mesh:",$s="//join/";function Rf(e){return Buffer.from(e,"utf-8").toString("base64url")}function _f(e){return Buffer.from(e,"base64url").toString("utf-8")}function Df(e){return`${bs}${$s}${Rf(JSON.stringify(e))}`}function Pf(e){if(!e.startsWith(`${bs}${$s}`))throw new Error(`Not a mesh invite link \u2014 expected ${bs}${$s}\u2026`);let o=e.slice(bs.length+$s.length),t=JSON.parse(_f(o));if(t.version!==1)throw new Error(`Unsupported invite version: ${t.version}`);if(typeof t.url!="string"||typeof t.token!="string"||typeof t.name!="string")throw new Error("Invite payload missing required fields (url, token, name)");return t}function Mf(){return Nf(32).toString("hex")}function Lf(e){let o=e?.node?.bind||"127.0.0.1:18800",[t,n]=o.split(":");return`http://${t}:${n}`}function Ff(e){return e?.node?.name||e?.node?.id||"node"}async function $d(e){let{readFileSync:o,existsSync:t}=await import("fs"),{resolve:n}=await import("path"),s=e.configPath||n(process.cwd(),"agentx.json");t(s)||(console.log(xe.red(`  No agentx.json at ${s}. Run: agentx init`)),process.exit(1));let i=JSON.parse(o(s,"utf-8")),r=qi("MESH_TOKEN");r||(r=Mf(),fn("MESH_TOKEN",r),console.log(xe.dim("  Generated new MESH_TOKEN (32 bytes) and saved to .env")));let a=e.url||Lf(i);if((a.includes("0.0.0.0")||a.includes("127.0.0.1")||a.includes("localhost"))&&!e.url){let{url:d}=await bd({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:p=>/^https?:\/\//.test(p)||"must start with http:// or https://"});d||(console.log(xe.red("  Aborted")),process.exit(1)),a=d}let l=await he(d=>{Ae(d,"mesh.enabled",!0)},{configPath:e.configPath});l.success||(console.log(xe.red(`  \u2717 ${l.error}`)),process.exit(1));let g=Df({url:a,token:r,name:Ff(i),version:1});console.log(),console.log(xe.bold("  Mesh invite")),console.log(),console.log(`  ${xe.cyan(g)}`),console.log(),console.log(xe.dim("  Run on the other node:")),console.log(xe.dim(`    agentx connect mesh join "${g}"`)),console.log(),console.log(xe.yellow("  Share over a trusted channel only \u2014 whoever holds this link can join your mesh.")),console.log()}async function kd(e,o={}){let t;try{t=Pf(e)}catch(i){console.log(xe.red(`  \u2717 ${i.message}`)),process.exit(1)}let n=qi("MESH_TOKEN");if(n&&n!==t.token){let{overwrite:i}=await bd({type:"confirm",name:"overwrite",message:"A different MESH_TOKEN already exists in .env. Overwrite with the invite's token?",initial:!1});i||(console.log(xe.red("  Aborted (keeping existing .env)")),process.exit(1))}fn("MESH_TOKEN",t.token);let s=await he(i=>{Ae(i,"mesh.enabled",!0);let r=ut(i,"mesh.peers")||[],a=r.findIndex(l=>l.name===t.name),c={name:t.name,url:t.url,token:"${MESH_TOKEN}"};a>=0?r[a]=c:r.push(c),Ae(i,"mesh.peers",r)},{configPath:o.configPath});s.success||(console.log(xe.red(`  \u2717 ${s.error}`)),process.exit(1)),console.log(xe.green("  \u2713 Joined mesh")),console.log(xe.dim(`    Peer: ${t.name} @ ${t.url}`)),console.log(xe.dim("    Shared token stored in .env as MESH_TOKEN")),s.reloaded?console.log(xe.dim("    Daemon hot-reloaded.")):console.log(xe.dim("    Restart the daemon to start the mesh (agentx daemon start).")),console.log();try{let i=await fetch(`${t.url.replace(/\/$/,"")}/.well-known/agent-card.json`,{signal:AbortSignal.timeout(5e3)});if(i.ok){let r=await i.json(),a=Array.isArray(r.agents)?r.agents.length:"?";console.log(xe.dim(`    Reachable \u2014 ${t.name} exposes ${a} agents`))}else console.log(xe.yellow(`    Peer returned HTTP ${i.status} \u2014 double-check the URL`))}catch(i){console.log(xe.yellow(`    Could not reach ${t.url} right now (${i?.cause?.code||i.message}) \u2014 verify VPN / Tailscale when the peer daemon is up`))}}var Rt=new Uf().name("connect").description("connect a channel or mesh peer \u2014 no manual file editing required");Rt.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 hd({agent:e.agent,account:e.account,configPath:e.config,skipChatCapture:!!e.skipChatCapture})});Rt.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 wd({agent:e.agent,sessionDir:e.sessionDir,skipPair:!!e.skipPair,configPath:e.config})});var vd=Rt.command("mesh").description("mesh invite + join \u2014 replaces manual MESH_TOKEN copy-paste");vd.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 $d({url:e.url,configPath:e.config})});vd.command("join <link>").description("accept an invite link from another AgentX node").option("-c, --config <path>","path to agentx.json").action(async(e,o)=>{await kd(e,{configPath:o.config})});Rt.action(()=>{console.log(),console.log(Nt.bold("  agentx connect \u2014 which channel?")),console.log(),console.log(`    ${Nt.cyan("agentx connect telegram")}        \u2014 pair a Telegram bot`),console.log(`    ${Nt.cyan("agentx connect whatsapp")}        \u2014 pair WhatsApp via QR`),console.log(`    ${Nt.cyan("agentx connect mesh invite")}     \u2014 emit a mesh join link for another node`),console.log(`    ${Nt.cyan("agentx connect mesh join <link>")} \u2014 accept a mesh invite`),console.log(),console.log(Nt.dim("  GitLab connect is the next slice.")),console.log()});re();import{Command as qf}from"commander";import pe from"chalk";var yn=new qf().name("usage").description("token usage analysis and reporting");yn.command("today",{isDefault:!0}).description("show today's token usage").action(async()=>{try{let e=j(),[o,t]=e.node.bind.split(":"),s=await(await fetch(`http://${o||"127.0.0.1"}:${t}/usage`,{signal:AbortSignal.timeout(3e3)})).json();if(console.log(),console.log(pe.bold("  Token Usage (last 7 days)")),console.log(),s.totalTasks===0){console.log(pe.dim("  No tasks recorded yet")),console.log();return}let i=a=>a.toLocaleString();console.log(`  Total: ${pe.bold(i(s.totalTokens))} tokens across ${s.totalTasks} tasks`),console.log(`    Input:        ${i(s.totalInput)}`),console.log(`    Output:       ${i(s.totalOutput)}`),console.log(`    Cache read:   ${i(s.totalCacheRead)}`),console.log(`    Cache create: ${i(s.totalCacheCreate)}`),s.cacheHitRatio>0&&console.log(`    Cache hit:    ${(s.cacheHitRatio*100).toFixed(1)}%`),s.totalErrors>0&&console.log(`    Errors:       ${pe.red(String(s.totalErrors))}`),console.log(),console.log(pe.bold("  By Agent:"));let r=Object.entries(s.byAgent||{});r.sort((a,c)=>c[1].total-a[1].total);for(let[a,c]of r){let l=i(c.total||c.input+c.output+c.cacheRead+c.cacheCreate),g=c.avgDuration?`${(c.avgDuration/1e3).toFixed(1)}s avg`:"";console.log(`    ${pe.cyan(a)}: ${l} tokens (${c.tasks} tasks) ${pe.dim(g)}`)}console.log()}catch(e){e.cause?.code==="ECONNREFUSED"?console.log(pe.red("  Daemon not running. Start with: agentx daemon start")):console.log(pe.red(`  ${e.message}`))}});yn.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:o}=await import("child_process"),{existsSync:t}=await import("fs"),{resolve:n}=await import("path"),s=n(process.cwd(),"scripts/token-report.py");if(!t(s)){console.log(pe.red(`  Script not found: ${s}`)),console.log(pe.dim("  The token analyzer script should be at scripts/token-report.py"));return}console.log(pe.dim("  Analyzing Claude Code sessions..."));try{o(`SINCE_DAYS=${e.days} python3 "${s}"`,{stdio:"inherit"})}catch{console.log(pe.red("  Analysis failed. Is Python 3 installed?"))}});yn.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:o}=await import("./surface-usage-HVVP22SA.js"),t=e.kind==="cli"||e.kind==="page"?e.kind:void 0,n=o({kind:t,sinceDays:Number(e.days)||30});if(e.unused){let{buildProgram:i}=await import("./program-D5TAPSIH.js"),r=await i(),a=new Set(n.filter(d=>d.kind==="cli").map(d=>d.name)),c=[],l=(d,p)=>{for(let f of d.commands??[]){let u=p?`${p} ${f.name()}`:f.name();c.push(u),l(f,u)}};l(r,"");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(pe.bold(`  Never used in the last ${e.days} days  (${g.length}/${c.length})`)),console.log();for(let d of g)console.log(`  ${pe.dim("\xB7")} ${d}`);console.log(),console.log(pe.dim("  Zero use is necessary but not sufficient to remove a surface \u2014")),console.log(pe.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(pe.dim(`  No surface usage recorded in the last ${e.days} days.`)),console.log(pe.dim("  Counting starts once this build has been running for a while.")),console.log();return}console.log(),console.log(pe.bold(`  Surface usage \u2014 last ${e.days} days`)),console.log();let s="";for(let i of n){i.kind!==s&&(console.log(pe.dim(`  ${i.kind==="cli"?"CLI commands":"Dashboard pages"}`)),s=i.kind);let r=String(i.count).padStart(6),a=pe.dim(`${i.days}d`);console.log(`  ${pe.cyan(r)}  ${i.name.padEnd(28)} ${a}`)}console.log(),console.log(pe.dim(`  ${n.length} surface(s) with recorded use. See --unused for the rest.`)),console.log()});import{Command as Wf}from"commander";import be from"chalk";import{readFileSync as Bf}from"fs";import{resolve as Jf}from"path";re();var Lo=new Wf().name("board").description("kanban board dashboard \u2014 visual work view over configured sources");Lo.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{Tr(Jf(process.cwd(),".env"))}catch{}let o=Hf(e.port,e.bind),{startBoardDashboard:t}=await import("./board-dashboard-NRRYCDZW.js");t(o)}catch(o){console.log(be.red(`  ${o.message}`)),process.env.DEBUG&&o.stack&&console.log(be.dim(o.stack)),process.exit(1)}});function Hf(e,o){try{let t=j();return e&&(t.dashboard.port=parseInt(e,10)),o&&(t.dashboard.bind=o),t}catch{return console.log(be.yellow("  No agentx.json found \u2014 starting dashboard in setup-only mode.")),console.log(be.dim("  Visit http://127.0.0.1:"+(e||"4202")+` to run the wizard.
+`}function fn(e,o,t=".env"){let n=pd(t),s=ud(n),i=s.findIndex(r=>r.kind==="kv"&&r.key===e);i>=0?s[i]={kind:"kv",key:e,value:o,raw:`${e}=${Ui(o)}`}:(s.length&&s[s.length-1].kind!=="blank"&&s.push({kind:"blank",raw:""}),s.push({kind:"kv",key:e,value:o,raw:`${e}=${Ui(o)}`})),bf(n,xf(s))}function qi(e,o=".env"){return ud(o).find(s=>s.kind==="kv"&&s.key===e)?.value}var fd="https://t.me/BotFather";async function Sf(e){try{let o=await fetch(`https://api.telegram.org/bot${e}/getMe`,{signal:AbortSignal.timeout(8e3)});if(!o.ok)return null;let t=await o.json();return t?.ok?t.result:null}catch{return null}}async function Ef(e,o){let t=Date.now()+o,n=0;try{let i=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=-1&timeout=0`,{signal:AbortSignal.timeout(5e3)})).json();i?.result?.length&&(n=i.result[0].update_id+1)}catch{}for(;Date.now()<t;)try{let i=await(await fetch(`https://api.telegram.org/bot${e}/getUpdates?offset=${n}&timeout=10`,{signal:AbortSignal.timeout(15e3)})).json();for(let r of i?.result||[]){n=Math.max(n,r.update_id+1);let a=r.message||r.edited_message||r.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 hd(e={}){console.log(),console.log(te.bold("  Connect Telegram")),console.log(),console.log(te.dim(`  1. Open ${fd}`)),console.log(te.dim("     /newbot   (or /mybots \u2192 pick existing \u2192 API Token)")),console.log(te.dim("  2. Copy the HTTP API token \u2014 looks like 123456789:ABCdef...")),console.log();let{openBrowser:o}=await hn({type:"confirm",name:"openBrowser",message:"Open BotFather in your browser?",initial:!0});if(o)try{let{spawn:b}=await import("child_process"),v=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";b(v,[fd],{stdio:"ignore",detached:!0}).unref()}catch{}let{token:t}=await hn({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"});t||(console.log(te.red("  Aborted")),process.exit(1)),process.stdout.write("  Verifying token... ");let n=await Sf(t.trim());n||(console.log(te.red("\u2717 invalid or revoked")),process.exit(1)),console.log(te.green(`\u2713 ${n.first_name} (@${n.username})`));let{readFileSync:s,existsSync:i}=await import("fs"),{resolve:r}=await import("path"),a=e.configPath||r(process.cwd(),"agentx.json");i(a)||(console.log(te.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(te.red("  No agents configured. Run: agentx agent add")),process.exit(1));let g=e.agent;g||(g=(await hn({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(te.red("  Aborted")),process.exit(1));let d=c.channels?.telegram?.accounts||{},p=e.account||g;d[p]&&d[p].agentBinding!==g&&(p=(await hn({type:"text",name:"account",message:`Account "${p}" 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),p||(console.log(te.red("  Aborted")),process.exit(1));let f=`TG_${p.toUpperCase().replace(/-/g,"_")}_BOT_TOKEN`;fn(f,t.trim()),process.env[f]=t.trim();let u=await he(b=>{Ae(b,"channels.telegram.enabled",!0),Ae(b,`channels.telegram.accounts.${p}`,{token:`\${${f}}`,agentBinding:g});let v=ut(b,`agents.${g}.mentions`)||[],A=`@${n.username}`;v.includes(A)||(v.push(A),Ae(b,`agents.${g}.mentions`,v))},{configPath:e.configPath});if(u.success||(console.log(te.red(`  \u2717 ${u.error}`)),process.exit(1)),console.log(),console.log(te.green(`  \u2713 Bot @${n.username} bound to agent "${g}"`)),console.log(te.dim(`    Token stored in .env as ${f}`)),console.log(te.dim(`    Mentions updated to include @${n.username}`)),u.reloaded?console.log(te.dim("    Daemon hot-reloaded.")):console.log(te.dim("    Start the daemon to begin polling (agentx daemon start)")),e.skipChatCapture)return;console.log();let{capture:w}=await hn({type:"confirm",name:"capture",message:"Listen for a message so we can set this as your default --notify target?",initial:!0});if(!w)return;console.log(),console.log(te.dim(`  Send any message to @${n.username} from the chat you want to use.`)),console.log(te.dim("  Waiting up to 90s..."));let y=await Ef(t.trim(),9e4);if(!y){console.log(te.yellow("  No message received \u2014 skipping. You can set it later with:")),console.log(te.dim("    agentx config set notifications.destination.channel telegram")),console.log(te.dim("    agentx config set notifications.destination.chatId <chatId>")),console.log(te.dim(`    agentx config set notifications.destination.accountId ${p}`));return}let k=await he(b=>{Ae(b,"notifications.destination",{channel:"telegram",chatId:String(y.chatId),accountId:p})},{configPath:e.configPath});if(!k.success){console.log(te.red(`  \u2717 failed to save destination: ${k.error}`));return}console.log(te.green("  \u2713 Default --notify target set")),console.log(te.dim(`    Chat: ${y.chatTitle||y.chatId} (from ${y.from})`)),console.log(te.dim("    From now on, --notify me resolves to this chat.")),k.reloaded&&console.log(te.dim("    Daemon hot-reloaded."))}import we from"chalk";import Wi from"prompts";import{existsSync as Ji,mkdirSync as Af,readdirSync as Tf,readFileSync as yd}from"fs";import{resolve as Bi}from"path";var Of=".agentx/whatsapp-sessions";function If(){let e=Bi(process.cwd(),".agentx/daemon.pid");if(!Ji(e))return!1;try{let o=parseInt(yd(e,"utf-8").trim(),10);return o?(process.kill(o,0),!0):!1}catch{return!1}}function jf(e){if(!Ji(e))return!1;try{return Tf(e).some(o=>o.includes("creds")||o.endsWith(".json"))}catch{return!1}}async function Cf(e,o){let t;try{t=await import("@whiskeysockets/baileys")}catch{return o(we.red("  WhatsApp pairing needs @whiskeysockets/baileys.")),o(we.red("  Install with: pnpm add @whiskeysockets/baileys  (or npm install)")),!1}let{makeWASocket:n,useMultiFileAuthState:s}=t.default||t;Af(e,{recursive:!0});let{state:i,saveCreds:r}=await s(e),a;try{a=(await t.fetchLatestBaileysVersion()).version}catch{}let c={level:"silent",trace:()=>{},debug:()=>{},info:()=>{},warn:()=>{},fatal:()=>{},error:()=>{},child:()=>c},l=n({auth:{creds:i.creds,keys:t.makeCacheableSignalKeyStore?t.makeCacheableSignalKeyStore(i.keys,c):i.keys},...a?{version:a}:{},logger:c,printQRInTerminal:!1,browser:["agentx-connect","pairing","1.0"],syncFullHistory:!1,markOnlineOnConnect:!1});return l.ev.on("creds.update",r),await new Promise(g=>{let p=setTimeout(()=>{o(we.yellow("  Timed out waiting for scan (2min)."));try{l.end(void 0)}catch{}g(!1)},12e4);l.ev.on("connection.update",async f=>{if(f.qr){o(we.dim("  Scan this QR with WhatsApp \u2192 Linked devices \u2192 Link a device:")),o("");try{let{default:u}=await import("qrcode-terminal");u.generate(f.qr,{small:!0})}catch{o(`  QR: ${f.qr}`)}o("")}if(f.connection==="open"){clearTimeout(p),o(we.green("  \u2713 Paired"));try{l.end(void 0)}catch{}g(!0)}f.connection==="close"&&!f.qr&&f.lastDisconnect?.error?.output?.statusCode===401&&(clearTimeout(p),o(we.red("  \u2717 Authorization failed \u2014 rescan required")),g(!1))})})}async function wd(e={}){if(console.log(),console.log(we.bold("  Connect WhatsApp")),console.log(),If()){console.log(we.yellow("  \u26A0 The daemon is running. Stop it first so pairing can open a fresh Baileys session:")),console.log(we.dim("    agentx daemon stop")),console.log();let{cont:l}=await Wi({type:"confirm",name:"cont",message:"Continue anyway? (expect errors)",initial:!1});l||(console.log(we.red("  Aborted")),process.exit(1))}let o=e.configPath||Bi(process.cwd(),"agentx.json");Ji(o)||(console.log(we.red(`  No agentx.json at ${o}. Run: agentx init`)),process.exit(1));let t=JSON.parse(yd(o,"utf-8")),n=e.sessionDir||t.channels?.whatsapp?.sessionDir||Of,s=Bi(process.cwd(),n),i=Object.keys(t.agents||{});i.length===0&&(console.log(we.red("  No agents configured. Run: agentx agent add")),process.exit(1));let r=e.agent;r||(r=(await Wi({type:"select",name:"agent",message:"Default agent for incoming messages:",choices:i.map(g=>({title:g,value:g})),initial:0})).agent),r||(console.log(we.red("  Aborted")),process.exit(1));let a=!e.skipPair;if(jf(s)&&a){let{keep:l}=await Wi({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(we.dim("  Keeping existing session \u2014 skipping QR pair."))}a&&(await Cf(s,g=>console.log(g))||(console.log(we.red("  Pairing failed. You can retry with `agentx connect whatsapp`.")),process.exit(1)));let c=await he(l=>{Ae(l,"channels.whatsapp.enabled",!0),Ae(l,"channels.whatsapp.sessionDir",n),Ae(l,"channels.whatsapp.defaultAgent",r)},{configPath:e.configPath});c.success||(console.log(we.red(`  \u2717 ${c.error}`)),process.exit(1)),console.log(),console.log(we.green(`  \u2713 WhatsApp bound to agent "${r}"`)),console.log(we.dim(`    Session: ${n}`)),console.log(we.dim("    Start the daemon to begin receiving:")),console.log(we.dim("      agentx daemon start")),console.log(we.dim("    Add routes later with:")),console.log(we.dim(`      agentx config set channels.whatsapp.routes '[{"contact":"+1234567890","agent":"${r}"}]'`)),console.log()}import{randomBytes as Nf}from"crypto";import xe from"chalk";import bd from"prompts";var bs="agentx-mesh:",$s="//join/";function Rf(e){return Buffer.from(e,"utf-8").toString("base64url")}function _f(e){return Buffer.from(e,"base64url").toString("utf-8")}function Df(e){return`${bs}${$s}${Rf(JSON.stringify(e))}`}function Pf(e){if(!e.startsWith(`${bs}${$s}`))throw new Error(`Not a mesh invite link \u2014 expected ${bs}${$s}\u2026`);let o=e.slice(bs.length+$s.length),t=JSON.parse(_f(o));if(t.version!==1)throw new Error(`Unsupported invite version: ${t.version}`);if(typeof t.url!="string"||typeof t.token!="string"||typeof t.name!="string")throw new Error("Invite payload missing required fields (url, token, name)");return t}function Mf(){return Nf(32).toString("hex")}function Lf(e){let o=e?.node?.bind||"127.0.0.1:18800",[t,n]=o.split(":");return`http://${t}:${n}`}function Ff(e){return e?.node?.name||e?.node?.id||"node"}async function $d(e){let{readFileSync:o,existsSync:t}=await import("fs"),{resolve:n}=await import("path"),s=e.configPath||n(process.cwd(),"agentx.json");t(s)||(console.log(xe.red(`  No agentx.json at ${s}. Run: agentx init`)),process.exit(1));let i=JSON.parse(o(s,"utf-8")),r=qi("MESH_TOKEN");r||(r=Mf(),fn("MESH_TOKEN",r),console.log(xe.dim("  Generated new MESH_TOKEN (32 bytes) and saved to .env")));let a=e.url||Lf(i);if((a.includes("0.0.0.0")||a.includes("127.0.0.1")||a.includes("localhost"))&&!e.url){let{url:d}=await bd({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:p=>/^https?:\/\//.test(p)||"must start with http:// or https://"});d||(console.log(xe.red("  Aborted")),process.exit(1)),a=d}let l=await he(d=>{Ae(d,"mesh.enabled",!0)},{configPath:e.configPath});l.success||(console.log(xe.red(`  \u2717 ${l.error}`)),process.exit(1));let g=Df({url:a,token:r,name:Ff(i),version:1});console.log(),console.log(xe.bold("  Mesh invite")),console.log(),console.log(`  ${xe.cyan(g)}`),console.log(),console.log(xe.dim("  Run on the other node:")),console.log(xe.dim(`    agentx connect mesh join "${g}"`)),console.log(),console.log(xe.yellow("  Share over a trusted channel only \u2014 whoever holds this link can join your mesh.")),console.log()}async function kd(e,o={}){let t;try{t=Pf(e)}catch(i){console.log(xe.red(`  \u2717 ${i.message}`)),process.exit(1)}let n=qi("MESH_TOKEN");if(n&&n!==t.token){let{overwrite:i}=await bd({type:"confirm",name:"overwrite",message:"A different MESH_TOKEN already exists in .env. Overwrite with the invite's token?",initial:!1});i||(console.log(xe.red("  Aborted (keeping existing .env)")),process.exit(1))}fn("MESH_TOKEN",t.token);let s=await he(i=>{Ae(i,"mesh.enabled",!0);let r=ut(i,"mesh.peers")||[],a=r.findIndex(l=>l.name===t.name),c={name:t.name,url:t.url,token:"${MESH_TOKEN}"};a>=0?r[a]=c:r.push(c),Ae(i,"mesh.peers",r)},{configPath:o.configPath});s.success||(console.log(xe.red(`  \u2717 ${s.error}`)),process.exit(1)),console.log(xe.green("  \u2713 Joined mesh")),console.log(xe.dim(`    Peer: ${t.name} @ ${t.url}`)),console.log(xe.dim("    Shared token stored in .env as MESH_TOKEN")),s.reloaded?console.log(xe.dim("    Daemon hot-reloaded.")):console.log(xe.dim("    Restart the daemon to start the mesh (agentx daemon start).")),console.log();try{let i=await fetch(`${t.url.replace(/\/$/,"")}/.well-known/agent-card.json`,{signal:AbortSignal.timeout(5e3)});if(i.ok){let r=await i.json(),a=Array.isArray(r.agents)?r.agents.length:"?";console.log(xe.dim(`    Reachable \u2014 ${t.name} exposes ${a} agents`))}else console.log(xe.yellow(`    Peer returned HTTP ${i.status} \u2014 double-check the URL`))}catch(i){console.log(xe.yellow(`    Could not reach ${t.url} right now (${i?.cause?.code||i.message}) \u2014 verify VPN / Tailscale when the peer daemon is up`))}}var Rt=new Uf().name("connect").description("connect a channel or mesh peer \u2014 no manual file editing required");Rt.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 hd({agent:e.agent,account:e.account,configPath:e.config,skipChatCapture:!!e.skipChatCapture})});Rt.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 wd({agent:e.agent,sessionDir:e.sessionDir,skipPair:!!e.skipPair,configPath:e.config})});var vd=Rt.command("mesh").description("mesh invite + join \u2014 replaces manual MESH_TOKEN copy-paste");vd.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 $d({url:e.url,configPath:e.config})});vd.command("join <link>").description("accept an invite link from another AgentX node").option("-c, --config <path>","path to agentx.json").action(async(e,o)=>{await kd(e,{configPath:o.config})});Rt.action(()=>{console.log(),console.log(Nt.bold("  agentx connect \u2014 which channel?")),console.log(),console.log(`    ${Nt.cyan("agentx connect telegram")}        \u2014 pair a Telegram bot`),console.log(`    ${Nt.cyan("agentx connect whatsapp")}        \u2014 pair WhatsApp via QR`),console.log(`    ${Nt.cyan("agentx connect mesh invite")}     \u2014 emit a mesh join link for another node`),console.log(`    ${Nt.cyan("agentx connect mesh join <link>")} \u2014 accept a mesh invite`),console.log(),console.log(Nt.dim("  GitLab connect is the next slice.")),console.log()});re();import{Command as qf}from"commander";import pe from"chalk";var yn=new qf().name("usage").description("token usage analysis and reporting");yn.command("today",{isDefault:!0}).description("show today's token usage").action(async()=>{try{let e=j(),[o,t]=e.node.bind.split(":"),s=await(await fetch(`http://${o||"127.0.0.1"}:${t}/usage`,{signal:AbortSignal.timeout(3e3)})).json();if(console.log(),console.log(pe.bold("  Token Usage (last 7 days)")),console.log(),s.totalTasks===0){console.log(pe.dim("  No tasks recorded yet")),console.log();return}let i=a=>a.toLocaleString();console.log(`  Total: ${pe.bold(i(s.totalTokens))} tokens across ${s.totalTasks} tasks`),console.log(`    Input:        ${i(s.totalInput)}`),console.log(`    Output:       ${i(s.totalOutput)}`),console.log(`    Cache read:   ${i(s.totalCacheRead)}`),console.log(`    Cache create: ${i(s.totalCacheCreate)}`),s.cacheHitRatio>0&&console.log(`    Cache hit:    ${(s.cacheHitRatio*100).toFixed(1)}%`),s.totalErrors>0&&console.log(`    Errors:       ${pe.red(String(s.totalErrors))}`),console.log(),console.log(pe.bold("  By Agent:"));let r=Object.entries(s.byAgent||{});r.sort((a,c)=>c[1].total-a[1].total);for(let[a,c]of r){let l=i(c.total||c.input+c.output+c.cacheRead+c.cacheCreate),g=c.avgDuration?`${(c.avgDuration/1e3).toFixed(1)}s avg`:"";console.log(`    ${pe.cyan(a)}: ${l} tokens (${c.tasks} tasks) ${pe.dim(g)}`)}console.log()}catch(e){e.cause?.code==="ECONNREFUSED"?console.log(pe.red("  Daemon not running. Start with: agentx daemon start")):console.log(pe.red(`  ${e.message}`))}});yn.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:o}=await import("child_process"),{existsSync:t}=await import("fs"),{resolve:n}=await import("path"),s=n(process.cwd(),"scripts/token-report.py");if(!t(s)){console.log(pe.red(`  Script not found: ${s}`)),console.log(pe.dim("  The token analyzer script should be at scripts/token-report.py"));return}console.log(pe.dim("  Analyzing Claude Code sessions..."));try{o(`SINCE_DAYS=${e.days} python3 "${s}"`,{stdio:"inherit"})}catch{console.log(pe.red("  Analysis failed. Is Python 3 installed?"))}});yn.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:o}=await import("./surface-usage-HVVP22SA.js"),t=e.kind==="cli"||e.kind==="page"?e.kind:void 0,n=o({kind:t,sinceDays:Number(e.days)||30});if(e.unused){let{buildProgram:i}=await import("./program-G6DIFJUF.js"),r=await i(),a=new Set(n.filter(d=>d.kind==="cli").map(d=>d.name)),c=[],l=(d,p)=>{for(let f of d.commands??[]){let u=p?`${p} ${f.name()}`:f.name();c.push(u),l(f,u)}};l(r,"");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(pe.bold(`  Never used in the last ${e.days} days  (${g.length}/${c.length})`)),console.log();for(let d of g)console.log(`  ${pe.dim("\xB7")} ${d}`);console.log(),console.log(pe.dim("  Zero use is necessary but not sufficient to remove a surface \u2014")),console.log(pe.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(pe.dim(`  No surface usage recorded in the last ${e.days} days.`)),console.log(pe.dim("  Counting starts once this build has been running for a while.")),console.log();return}console.log(),console.log(pe.bold(`  Surface usage \u2014 last ${e.days} days`)),console.log();let s="";for(let i of n){i.kind!==s&&(console.log(pe.dim(`  ${i.kind==="cli"?"CLI commands":"Dashboard pages"}`)),s=i.kind);let r=String(i.count).padStart(6),a=pe.dim(`${i.days}d`);console.log(`  ${pe.cyan(r)}  ${i.name.padEnd(28)} ${a}`)}console.log(),console.log(pe.dim(`  ${n.length} surface(s) with recorded use. See --unused for the rest.`)),console.log()});import{Command as Wf}from"commander";import be from"chalk";import{readFileSync as Bf}from"fs";import{resolve as Jf}from"path";re();var Lo=new Wf().name("board").description("kanban board dashboard \u2014 visual work view over configured sources");Lo.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{Tr(Jf(process.cwd(),".env"))}catch{}let o=Hf(e.port,e.bind),{startBoardDashboard:t}=await import("./board-dashboard-NRRYCDZW.js");t(o)}catch(o){console.log(be.red(`  ${o.message}`)),process.env.DEBUG&&o.stack&&console.log(be.dim(o.stack)),process.exit(1)}});function Hf(e,o){try{let t=j();return e&&(t.dashboard.port=parseInt(e,10)),o&&(t.dashboard.bind=o),t}catch{return console.log(be.yellow("  No agentx.json found \u2014 starting dashboard in setup-only mode.")),console.log(be.dim("  Visit http://127.0.0.1:"+(e||"4202")+` to run the wizard.
 `)),{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:o||"127.0.0.1",daemonUrl:"http://localhost:18800",daemons:[]},business:void 0,session:{staleMinutes:120}}}}Lo.command("list").description("list configured boards").action(()=>{try{let e=j();if(!e.boards?.length){console.log(be.dim(`
   No boards configured.
 `));return}console.log();for(let o of e.boards){console.log(`  ${be.cyan(o.id)}  \u2014 ${o.name}`);let t=o.source;console.log(be.dim(`    source: ${t.type}${t.projects?" ("+t.projects.join(", ")+")":""}`)),o.primaryToolLabel&&console.log(be.dim(`    primary label: ${o.primaryToolLabel}`)),console.log(be.dim(`    window: ${o.timeRangeDays} days`))}console.log()}catch(e){console.log(be.red(`  ${e.message}`)),process.exit(1)}});Lo.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,o)=>{try{wn(t=>{if(Array.isArray(t.boards)||(t.boards=[]),t.boards.find(i=>i.id===e))throw new Error(`board "${e}" already exists`);let n=String(o.projects).split(",").map(i=>i.trim()).filter(Boolean);if(n.length===0)throw new Error("--projects must include at least one path");let s={id:e,name:o.name,source:{type:"gitlab",projects:n},timeRangeDays:parseInt(o.days,10)||30,closedWindowDays:parseInt(o.closedDays,10)||30};return o.label&&(s.primaryToolLabel=o.label),t.boards.push(s),`added board "${e}" (${n.join(", ")})`})}catch(t){console.log(be.red(`  ${t.message}`)),process.exit(1)}});Lo.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,o)=>{try{wn(t=>{let s=(Array.isArray(t.boards)?t.boards:[]).find(r=>r.id===e);if(!s)throw new Error(`board "${e}" not found`);let i=[];if(o.name&&(s.name=o.name,i.push(`name="${o.name}"`)),o.projects){let r=String(o.projects).split(",").map(a=>a.trim()).filter(Boolean);if(r.length===0)throw new Error("--projects must include at least one path");s.source={...s.source||{type:"gitlab"},type:"gitlab",projects:r},i.push(`projects=${r.length}`)}if(o.label!==void 0&&(o.label==="-"?(delete s.primaryToolLabel,i.push("label cleared")):(s.primaryToolLabel=o.label,i.push(`label="${o.label}"`))),o.days&&(s.timeRangeDays=parseInt(o.days,10)||s.timeRangeDays,i.push(`days=${s.timeRangeDays}`)),o.closedDays&&(s.closedWindowDays=parseInt(o.closedDays,10)||s.closedWindowDays,i.push(`closed-days=${s.closedWindowDays}`)),i.length===0)throw new Error("no changes \u2014 pass at least one option");return`board "${e}" updated (${i.join(", ")})`})}catch(t){console.log(be.red(`  ${t.message}`)),process.exit(1)}});var Hi=Lo.command("column").description("manage a board's columns (add / remove / edit / list)");Hi.command("list <boardId>").description("list columns on a board, in order").action(e=>{try{let t=(JSON.parse(Bf("agentx.json","utf-8")).boards||[]).find(s=>s.id===e);if(!t)throw new Error(`board "${e}" not found`);let n=t.columns||[];if(n.length===0){console.log(be.dim("  no columns (board falls back to GitLab default flow)"));return}for(let s of n){let i=s.kind==="scoped-label"?`scoped="${s.scopedLabel}"`:s.kind==="label"?`label="${s.mapsToLabel||""}"`:s.kind==="open-backlog"?`prefix="${s.scopedPrefix}"`:s.kind;console.log(`  ${be.cyan(s.id.padEnd(12))} ${s.title.padEnd(14)} ${be.dim(i)}`)}}catch(o){console.log(be.red(`  ${o.message}`)),process.exit(1)}});Hi.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,o,t)=>{try{wn(n=>{let i=(Array.isArray(n.boards)?n.boards:[]).find(a=>a.id===e);if(!i)throw new Error(`board "${e}" not found`);if(i.columns=i.columns||[],i.columns.find(a=>a.id===o))throw new Error(`column "${o}" already exists on board "${e}"`);let r={id:o,title:t.title,kind:t.kind,scopedPrefix:t.scopedPrefix};if(t.kind==="scoped-label"){if(!t.scoped)throw new Error("--scoped required for kind=scoped-label");r.scopedLabel=t.scoped}if(t.kind==="label"){if(!t.label)throw new Error("--label required for kind=label");r.mapsToLabel=t.label}return t.accent&&(r.accent=t.accent),i.columns.push(r),`column "${o}" added to board "${e}"`})}catch(n){console.log(be.red(`  ${n.message}`)),process.exit(1)}});Hi.command("remove <boardId> <columnId>").alias("rm").description("remove a column from a board").action((e,o)=>{try{wn(t=>{let s=(Array.isArray(t.boards)?t.boards:[]).find(r=>r.id===e);if(!s)throw new Error(`board "${e}" not found`);let i=(s.columns||[]).length;if(s.columns=(s.columns||[]).filter(r=>r.id!==o),s.columns.length===i)throw new Error(`column "${o}" not found`);return`column "${o}" removed from board "${e}"`})}catch(t){console.log(be.red(`  ${t.message}`)),process.exit(1)}});Lo.command("remove <id>").alias("rm").description("remove a board from agentx.json").action(e=>{try{wn(o=>{if(!Array.isArray(o.boards)||o.boards.length===0)throw new Error("no boards configured");let t=o.boards.length;if(o.boards=o.boards.filter(n=>n.id!==e),o.boards.length===t)throw new Error(`board "${e}" not found`);return`removed board "${e}"`})}catch(o){console.log(be.red(`  ${o.message}`)),process.exit(1)}});function wn(e){let{summary:o,backupPath:t}=ro(n=>e(n));console.log(be.green(`
@@ -622,7 +622,7 @@ Restart the daemon to activate.
 dist/
 *.log
 .env
-`}import{Command as Ey}from"commander";import je from"chalk";import{writeFileSync as Ay,mkdirSync as Ty,existsSync as Ls,readFileSync as dg,appendFileSync as gg}from"fs";import{resolve as Jt,dirname as ug}from"path";import{homedir as pr}from"os";var fg=new Ey().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:o}=await import("./program-D5TAPSIH.js"),t=await o(),n=String(e.shell||"zsh").toLowerCase(),s;switch(n){case"zsh":s=jy(t);break;case"bash":s=Dy(t);break;case"fish":s=Py(t);break;default:console.error(je.red(`unsupported shell: ${n}`)),console.error(je.dim("supported: zsh, bash, fish")),process.exit(1)}if(!e.install&&!e.output){process.stdout.write(s);return}let i=e.output?Jt(String(e.output)):Oy(n);Ty(ug(i),{recursive:!0}),Ay(i,s),console.log(je.green(`\u2713 Wrote ${n} completion to:`)),console.log(`  ${i}`),console.log(),Iy(n,i,!!e.yes)});function Oy(e){let o=pr();switch(e){case"zsh":return Jt(o,".zsh","completions","_agentx");case"bash":return Jt(o,".bash_completion.d","agentx.bash");case"fish":return Jt(o,".config","fish","completions","agentx.fish");default:throw new Error(`unsupported shell: ${e}`)}}function Iy(e,o,t){if(e==="zsh"){let n=Jt(pr(),".zshrc"),s=ug(o),i=`fpath=(${s} $fpath)`,r="autoload -U compinit && compinit",a=Ls(n)?dg(n,"utf-8"):"",c=!a.includes(s),l=!/autoload\s+-U\s+compinit/.test(a);if(!c&&!l){console.log(je.dim("~/.zshrc already has fpath + compinit wired up. Run `exec zsh` to pick up the new script."));return}if(t&&Ls(n)){let g=["","# agentx completion"];c&&g.push(i),l&&g.push(r),gg(n,g.join(`
+`}import{Command as Ey}from"commander";import je from"chalk";import{writeFileSync as Ay,mkdirSync as Ty,existsSync as Ls,readFileSync as dg,appendFileSync as gg}from"fs";import{resolve as Jt,dirname as ug}from"path";import{homedir as pr}from"os";var fg=new Ey().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:o}=await import("./program-G6DIFJUF.js"),t=await o(),n=String(e.shell||"zsh").toLowerCase(),s;switch(n){case"zsh":s=jy(t);break;case"bash":s=Dy(t);break;case"fish":s=Py(t);break;default:console.error(je.red(`unsupported shell: ${n}`)),console.error(je.dim("supported: zsh, bash, fish")),process.exit(1)}if(!e.install&&!e.output){process.stdout.write(s);return}let i=e.output?Jt(String(e.output)):Oy(n);Ty(ug(i),{recursive:!0}),Ay(i,s),console.log(je.green(`\u2713 Wrote ${n} completion to:`)),console.log(`  ${i}`),console.log(),Iy(n,i,!!e.yes)});function Oy(e){let o=pr();switch(e){case"zsh":return Jt(o,".zsh","completions","_agentx");case"bash":return Jt(o,".bash_completion.d","agentx.bash");case"fish":return Jt(o,".config","fish","completions","agentx.fish");default:throw new Error(`unsupported shell: ${e}`)}}function Iy(e,o,t){if(e==="zsh"){let n=Jt(pr(),".zshrc"),s=ug(o),i=`fpath=(${s} $fpath)`,r="autoload -U compinit && compinit",a=Ls(n)?dg(n,"utf-8"):"",c=!a.includes(s),l=!/autoload\s+-U\s+compinit/.test(a);if(!c&&!l){console.log(je.dim("~/.zshrc already has fpath + compinit wired up. Run `exec zsh` to pick up the new script."));return}if(t&&Ls(n)){let g=["","# agentx completion"];c&&g.push(i),l&&g.push(r),gg(n,g.join(`
 `)+`
 `),console.log(je.green("\u2713 Patched ~/.zshrc")),console.log(je.dim("Reload your shell: exec zsh"));return}console.log(je.dim("Add this to ~/.zshrc if not already present:")),c&&console.log(je.cyan(`  ${i}`)),l&&console.log(je.cyan(`  ${r}`)),console.log(),console.log(je.dim("Then reload: exec zsh")),console.log(je.dim("Or rerun with --yes to auto-patch ~/.zshrc"));return}if(e==="bash"){let n=Jt(pr(),".bashrc"),s=`[ -f "${o}" ] && source "${o}"`;if((Ls(n)?dg(n,"utf-8"):"").includes(o)){console.log(je.dim("~/.bashrc already sources this file. Start a new shell to pick it up."));return}if(t&&Ls(n)){gg(n,`
 # agentx completion
@@ -633,4 +633,4 @@ ${s}
 `)}function ur(e){return String(e||"").replace(/\r?\n/g," ").replace(/\\/g,"\\\\").replace(/"/g,'\\"')}function mr(e,o){let t=e.short?e.short.replace(/^-/,""):"",n=e.long?e.long.replace(/^--/,""):"";if(!t&&!n)return null;let s=ur(e.description||""),r=["complete -c agentx",o.map(a=>`-n "${a}"`).join(" ")];return t&&r.push(`-s ${t}`),n&&r.push(`-l ${n}`),r.push(`-d "${s}"`),r.join(" ")}async function $1(){let e=await lc(),o=new My().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");o.hook("preAction",(t,n)=>{let s=hc(n);yc(s)&&fc("cli",s)});for(let t of[Hc,Wc,Rt,bt,vt,Ke,mc,Yo,Zn,wo,Mo,Po,Qn,Vd,Ro,dl,bl,mn,jl,_l,Dl,Ql,td,nd,ps,yn,eg,sn,Oo,fg])o.addCommand(t);for(let t of yg)o.addCommand(t,{hidden:!0});return o.addHelpText("after",()=>{let t=yg.map(n=>n.name()).sort();return["",`Advanced (${t.length}, hidden \u2014 run \`agentx <command> --help\` for any of them):`,Ly(t,74,"  "),""].join(`
 `)}),o}var yg=[Z,_t,qo,no,an,jt,He,$o,Lo,nt,Lt,Ft,Co,We,At,ws,Gd,zd,ho,Vo,vc,Ko,En,yi,Uo,St,wi,js,po,Wo,ig,ag,Zd];function Ly(e,o,t){let n=[],s="";for(let i of e)s&&s.length+i.length+2>o&&(n.push(t+s),s=""),s+=(s?", ":"")+i;return s&&n.push(t+s),n.join(`
 `)}export{$1 as a};
-//# sourceMappingURL=chunk-JC5Q5MPI.js.map
+//# sourceMappingURL=chunk-IL2XLW4H.js.map