@oracle-agent/oracle 0.16.0 → 0.18.0

package/dist/cli/commands/data.mjs

@@ -1,12 +1,17 @@
-import{parseArgs as w}from"node:util";import{spawn as v}from"node:child_process";var m=["SIGINT","SIGTERM","SIGHUP"];function h(r,t=[],a={},l=r){return new Promise(o=>{let e=v(r,t,a),n=!1,p=null,u=new Map(m.map(s=>[s,()=>{p||=s,e.exitCode===null&&e.signalCode===null&&e.kill(s)}]));for(let[s,c]of u)process.on(s,c);let f=()=>{for(let[s,c]of u)process.off(s,c)};e.once("error",s=>{n||(n=!0,f(),process.stderr.write(`oracle: could not start ${l}: ${s.message}
-`),o(1))}),e.once("exit",(s,c)=>{if(n)return;n=!0,f();let g=p||c;if(g){process.kill(process.pid,g);return}o(s??1)})})}var S="http://127.0.0.1:8787";function i(){process.stderr.write(`usage: oracle data <serve|call|catalog|health> [args]
+import{parseArgs as k}from"node:util";import{spawn as m}from"node:child_process";var v=["SIGINT","SIGTERM","SIGHUP"];function h(t,a=[],r={},n=t){return new Promise(s=>{let e=m(t,a,r),o=!1,c=null,i=new Map(v.map(l=>[l,()=>{c||=l,e.exitCode===null&&e.signalCode===null&&e.kill(l)}]));for(let[l,p]of i)process.on(l,p);let u=()=>{for(let[l,p]of i)process.off(l,p)};e.once("error",l=>{o||(o=!0,u(),process.stderr.write(`oracle: could not start ${n}: ${l.message}
+`),s(1))}),e.once("exit",(l,p)=>{if(o)return;o=!0,u();let f=c||p;if(f){process.kill(process.pid,f);return}s(l??1)})})}var w="http://127.0.0.1:8787";function g(){process.stderr.write(`usage: oracle data <serve|call|catalog|health> [args]
   oracle data serve [--port N]
-  oracle data call <provider> <op> [--args '<json>']
+  oracle data call <provider> <op> [key=value ...] [--key value ...] [--args '<json>']
   oracle data catalog
   oracle data health
-`)}async function d(r,{method:t="GET",body:a}={}){let o=(process.env.ORACLE_DATA_URL||S).replace(/\/$/,"")+r;try{let e=await fetch(o,{method:t,headers:a?{"content-type":"application/json"}:void 0,body:a?JSON.stringify(a):void 0}),n=await e.text();return process.stdout.write(n.endsWith(`
-`)?n:n+`
+
+examples:
+  oracle data call bitcoin-esplora tipHeight
+  oracle data call poly-public markets slug=will-oscar-piastri-be-the-2026-f1-drivers-champion
+  oracle data call hl-markets coin coin=HYPE
+`)}function y(t){let a=t[0],r=t[1];if(!a||!r)return{ok:!1,error:"provider and op are required"};let n={};for(let s=2;s<t.length;s+=1){let e=t[s];if(e==="--args"){try{Object.assign(n,JSON.parse(t[++s]||"{}"))}catch(c){return{ok:!1,error:`invalid --args JSON: ${c.message}`}}continue}if(e.startsWith("--")){let c=e.slice(2),i=t[s+1];if(i==null||i.startsWith("--")){n[c]=!0;continue}n[c]=i,s+=1;continue}let o=e.indexOf("=");if(o>0){n[e.slice(0,o)]=e.slice(o+1);continue}return{ok:!1,error:`unexpected positional argument '${e}'. Pass parameters as key=value (e.g. slug=${e}), as --key value, or as --args '{"slug":"${e}"}'.`}}return{ok:!0,provider:a,op:r,args:n}}async function d(t,{method:a="GET",body:r}={}){let s=(process.env.ORACLE_DATA_URL||w).replace(/\/$/,"")+t;try{let e=await fetch(s,{method:a,headers:r?{"content-type":"application/json"}:void 0,body:r?JSON.stringify(r):void 0}),o=await e.text();return process.stdout.write(o.endsWith(`
+`)?o:o+`
 `),e.ok?0:1}catch(e){return e&&(e.code==="ECONNREFUSED"||/fetch failed|ECONNREFUSED/i.test(String(e)))?(process.stderr.write(`oracle: data server not running \u2014 start it with 'oracle data serve'
 `),4):(process.stderr.write(`oracle data: ${e.message||e}
-`),1)}}var R={name:"data",summary:"desk data plane",group:"read",usage:"oracle data serve|call|catalog|health",async run(r){let t=r.argv[0];if(!t||t==="--help"||t==="-h")return i(),t?0:1;if(t==="serve"){let a=null;try{let{values:e}=w({args:r.argv.slice(1),options:{port:{type:"string"}},allowPositionals:!0,strict:!1});a=e.port||null}catch{}let l={...process.env};a&&(l.ORACLE_DATA_PORT=String(a));let o=r.bin("desk-server.mjs");return h(process.execPath,[o],{stdio:"inherit",env:l},"desk-server")}if(t==="health")return d("/health");if(t==="catalog")return d("/data/catalog");if(t==="call"){let a=r.argv[1],l=r.argv[2];if(!a||!l)return i(),1;let o={},e=r.argv.indexOf("--args");if(e>=0)try{o=JSON.parse(r.argv[e+1]||"{}")}catch(n){return process.stderr.write(`oracle data call: invalid --args JSON: ${n.message}
-`),1}return d("/data/call",{method:"POST",body:{provider:a,op:l,args:o}})}return i(),1}};export{R as default};
+`),1)}}var N={name:"data",summary:"desk data plane",group:"read",usage:"oracle data serve|call|catalog|health",async run(t){let a=t.argv[0];if(!a||a==="--help"||a==="-h")return g(),a?0:1;if(a==="serve"){let r=null;try{let{values:e}=k({args:t.argv.slice(1),options:{port:{type:"string"}},allowPositionals:!0,strict:!1});r=e.port||null}catch{}let n={...process.env};r&&(n.ORACLE_DATA_PORT=String(r));let s=t.bin("desk-server.mjs");return h(process.execPath,[s],{stdio:"inherit",env:n},"desk-server")}if(a==="health")return d("/health");if(a==="catalog")return d("/data/catalog");if(a==="call"){let r=y(t.argv.slice(1));return r.ok?d("/data/call",{method:"POST",body:{provider:r.provider,op:r.op,args:r.args}}):(process.stderr.write(`oracle data call: ${r.error}
+`),1)}return g(),1}};export{N as default,y as parseDataCallArgs};

package/dist/cli/commands/doctor.mjs

@@ -1,5 +1,5 @@
-import v from"node:fs";import M from"node:path";var S="signing: not installed (optional) \u2014 npm i -g @oracle-agent/operator";import k from"node:fs";import u from"node:path";import w from"node:os";import h from"node:path";import{fileURLToPath as C}from"node:url";var P=h.dirname(C(import.meta.url)),z=h.resolve(P,"../..");function E(){return process.env.ORACLE_FAKE_HOME||w.homedir()}function N(){return process.env.ORACLE_PUBLIC_DESKTOP==="1"}function b(){return N()?process.env.ORACLE_CONFIG_DIR||h.join(E(),".config","oracle"):h.join(E(),".config","oracle")}var $="0.19.0",q=`hermes-agent==${$}`;var T="0.12.1",ee=Object.freeze({posix:Object.freeze({url:`https://github.com/astral-sh/uv/releases/download/${T}/uv-installer.sh`,sha256:"d3f5412d38c99f9d024901843bf98206f0d2c6dbe64df40d0b740e2751ca62c1"}),windows:Object.freeze({url:`https://github.com/astral-sh/uv/releases/download/${T}/uv-installer.ps1`,sha256:"b9ec035151bfbb11d616dbd69886498d885551489eddf095ea3c0ad59f640eb0"})});function I(){return u.join(b(),"runtime")}function L(){return u.join(I(),"venv")}function D(e){let t=process.platform==="win32"?"Scripts":"bin",o=process.platform==="win32"?`${e}.exe`:e;return u.join(L(),t,o)}function U(){return D("hermes")}function H(e){let t=process.platform==="win32"&&!u.extname(e)?["",".exe",".cmd",".bat"]:[""];for(let o of(process.env.PATH||"").split(u.delimiter))if(o)for(let r of t){let s=u.join(o,`${e}${r}`);try{if(k.existsSync(s))return s}catch{}}return null}function O(){if(process.env.ORACLE_HERMES_BIN)return{ok:!0,bin:process.env.ORACLE_HERMES_BIN,source:"env"};let e=H("hermes");if(e)return{ok:!0,bin:e,source:"path"};let t=U();return k.existsSync(t)?{ok:!0,bin:t,source:"managed"}:{ok:!1,bin:null,source:null}}function R(){let[e,t]=process.versions.node.split(".").map(Number);return e>20||e===20&&t>=19}function B(e){if(!v.existsSync(e))return{};let t={};for(let o of v.readFileSync(e,"utf8").split(/\r?\n/)){let r=o.match(/^([A-Z0-9_]+)=(.*)$/);r&&(t[r[1]]=r[2])}return t}async function V(e){try{return(await fetch(e.replace(/\/$/,"")+"/health")).ok}catch{return!1}}var ie={name:"doctor",summary:"check read plane; checks signer too when installed",group:"read",usage:"oracle doctor [--json]",async run(e){let t=e.argv.includes("--json"),o=[],r=!1,s=(n,c,f,a=null)=>{o.push({id:n,status:c,detail:f,fix:a}),c==="fail"&&(r=!0)};s("node",R()?"ok":"fail",`node ${process.versions.node}`,R()?null:"install node >= 20.19");let A=e.paths.oracleExecEnvPath(),d=B(A),m=process.env.ORACLE_ROUTE_ATTESTATION_SECRET||process.env.MAD_ROUTE_ATTESTATION_SECRET||process.env.ORACLE_ATTESTATION_SECRET||process.env.ORACLE_STAMP_HMAC_SECRET||d.ORACLE_ROUTE_ATTESTATION_SECRET||d.MAD_ROUTE_ATTESTATION_SECRET||d.ORACLE_ATTESTATION_SECRET||d.ORACLE_STAMP_HMAC_SECRET;s("attestation_secret",m?"ok":"warn",m?"present":"missing",m?null:"run oracle init --apply (writes ~/.config/oracle/exec.env)");let x=process.env.ORACLE_DATA_URL||"http://127.0.0.1:8787",y=await V(x);s("data_server",y?"ok":"warn",y?`reachable ${x}`:`down ${x}`,y?null:"oracle data serve");let l=O();s("agent_runtime",l.ok?"ok":"warn",l.ok?`present ${l.bin} (${l.source})`:"not installed",l.ok?null:"oracle bootstrap");let g=M.join(e.paths.hermesRoot(),"profiles"),p=0;v.existsSync(g)&&(p=v.readdirSync(g,{withFileTypes:!0}).filter(n=>n.isDirectory()).length),s("hermes_lanes",p>0?"ok":"warn",p>0?`${p} profile dir(s)`:"no lane profiles found",p>0?null:"oracle init --apply");let i=e.resolveOperator(),_={installed:!1};if(i.ok){let n=e.dispatchOperator("oracle-agentic-doctor",["--json"],{stdio:"pipe"}),c={installed:!0,version:i.version,source:i.source};if(n&&typeof n=="object"&&n.stdout)try{let a=JSON.parse(n.stdout);c={installed:!0,version:i.version,source:i.source,signingReady:a.signingReady,broadcastReady:a.broadcastReady,executionReady:a.executionReady,masterKillSwitch:a.masterKillSwitch,raw:a}}catch{c.doctorParseError=!0,c.doctorExit=n.code}else typeof n=="number"&&(c.doctorExit=n);_=c;let f=c.signingReady===!0;s("signing",f?"ok":"warn",f?`operator ${i.version} ready via ${i.source}`:`operator ${i.version} installed but signing is not ready`,f?null:"oracle sign doctor --json")}let j={ok:!r,checks:o,operator:_};if(t)process.stdout.write(JSON.stringify(j,null,2)+`
-`);else{for(let n of o)process.stdout.write(`${n.status.toUpperCase().padEnd(4)} ${n.id}: ${n.detail}
-`),n.fix&&process.stdout.write(`     fix: ${n.fix}
-`);i.ok||process.stdout.write(`INFO ${S}
-`)}return r?1:0}};export{ie as default};
+import y from"node:fs";import Y from"node:path";var b="signing: not installed (optional) \u2014 npm i -g @oracle-agent/operator";import L from"node:fs";import h from"node:path";import x from"node:fs";import P from"node:os";import d from"node:path";import{fileURLToPath as w}from"node:url";var I=d.dirname(w(import.meta.url)),q=d.resolve(I,"../..");function S(){return process.env.ORACLE_FAKE_HOME||P.homedir()}function $(){return process.env.ORACLE_PUBLIC_DESKTOP==="1"}function R(){return $()?process.env.ORACLE_CONFIG_DIR||d.join(S(),".config","oracle"):d.join(S(),".config","oracle")}function D(){return d.join(R(),"desk.json")}function N(){return d.join(R(),"env")}function f({force:e=!1}={}){if(f._done&&!e)return f._result||null;f._done=!0;let r={},t=(o,n)=>{if(n==null)return;let c=String(n).trim();c&&(process.env[o]!=null&&String(process.env[o]).trim()!==""||(process.env[o]=c,r[o]=c))};try{let o=N();if(x.existsSync(o))for(let n of x.readFileSync(o,"utf8").split(/\r?\n/)){let c=n.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*?)\s*$/);if(!c||c[2].startsWith("#"))continue;let a=c[2];(a.startsWith('"')&&a.endsWith('"')||a.startsWith("'")&&a.endsWith("'"))&&(a=a.slice(1,-1)),t(c[1],a)}}catch{}try{let o=D();if(x.existsSync(o)){let n=JSON.parse(x.readFileSync(o,"utf8"));n&&typeof n=="object"&&(t("ORACLE_DESK_URL",n.deskUrl||n.dataUrl||n.url),t("ORACLE_DATA_URL",n.dataUrl||n.deskUrl||n.url),t("ORACLE_API_URL",n.apiUrl||n.dataUrl||n.deskUrl),t("ORACLE_PUBLIC_URL",n.publicUrl||n.deskUrl||n.dataUrl),t("ORACLE_EXEC_URL",n.execUrl),t("MAD_DESK_URL",n.deskUrl||n.dataUrl))}}catch{}let s=process.env.ORACLE_DESK_URL||process.env.ORACLE_DATA_URL||"";return s&&(t("ORACLE_DESK_URL",s),t("ORACLE_DATA_URL",s),t("ORACLE_API_URL",s),t("ORACLE_PUBLIC_URL",s),t("MAD_DESK_URL",s)),f._result=Object.keys(r).length?r:null,f._result}try{f()}catch{}var H="0.19.0",se=`hermes-agent==${H}`;var C="0.12.1",ie=Object.freeze({posix:Object.freeze({url:`https://github.com/astral-sh/uv/releases/download/${C}/uv-installer.sh`,sha256:"d3f5412d38c99f9d024901843bf98206f0d2c6dbe64df40d0b740e2751ca62c1"}),windows:Object.freeze({url:`https://github.com/astral-sh/uv/releases/download/${C}/uv-installer.ps1`,sha256:"b9ec035151bfbb11d616dbd69886498d885551489eddf095ea3c0ad59f640eb0"})});function M(){return h.join(R(),"runtime")}function B(){return h.join(M(),"venv")}function V(e){let r=process.platform==="win32"?"Scripts":"bin",t=process.platform==="win32"?`${e}.exe`:e;return h.join(B(),r,t)}function F(){return V("hermes")}function K(e){let r=process.platform==="win32"&&!h.extname(e)?["",".exe",".cmd",".bat"]:[""];for(let t of(process.env.PATH||"").split(h.delimiter))if(t)for(let s of r){let o=h.join(t,`${e}${s}`);try{if(L.existsSync(o))return o}catch{}}return null}function T(){if(process.env.ORACLE_HERMES_BIN)return{ok:!0,bin:process.env.ORACLE_HERMES_BIN,source:"env"};let e=K("hermes");if(e)return{ok:!0,bin:e,source:"path"};let r=F();return L.existsSync(r)?{ok:!0,bin:r,source:"managed"}:{ok:!1,bin:null,source:null}}function U(){let[e,r]=process.versions.node.split(".").map(Number);return e>20||e===20&&r>=19}function G(e){if(!y.existsSync(e))return{};let r={};for(let t of y.readFileSync(e,"utf8").split(/\r?\n/)){let s=t.match(/^([A-Z0-9_]+)=(.*)$/);s&&(r[s[1]]=s[2])}return r}async function W(e){let r=e.replace(/\/$/,"");for(let t of["/health","/public/health"])try{if((await fetch(r+t)).ok)return!0}catch{}return!1}var fe={name:"doctor",summary:"check read plane; checks signer too when installed",group:"read",usage:"oracle doctor [--json]",async run(e){let r=e.argv.includes("--json"),t=[],s=!1,o=(i,u,E,p=null)=>{t.push({id:i,status:u,detail:E,fix:p}),u==="fail"&&(s=!0)};o("node",U()?"ok":"fail",`node ${process.versions.node}`,U()?null:"install node >= 20.19");let n=e.paths.oracleExecEnvPath(),c=G(n),a=process.env.ORACLE_ROUTE_ATTESTATION_SECRET||process.env.MAD_ROUTE_ATTESTATION_SECRET||process.env.ORACLE_ATTESTATION_SECRET||process.env.ORACLE_STAMP_HMAC_SECRET||c.ORACLE_ROUTE_ATTESTATION_SECRET||c.MAD_ROUTE_ATTESTATION_SECRET||c.ORACLE_ATTESTATION_SECRET||c.ORACLE_STAMP_HMAC_SECRET;o("attestation_secret",a?"ok":"warn",a?"present":"missing",a?null:"run oracle init --apply (writes ~/.config/oracle/exec.env)");let v=process.env.ORACLE_DATA_URL||"http://127.0.0.1:8787",g=await W(v),A=e.paths.loadDeskRouting&&(process.env.ORACLE_DESK_URL||process.env.ORACLE_PUBLIC_URL)?`desk ${process.env.ORACLE_DESK_URL||process.env.ORACLE_PUBLIC_URL}`:null;o("data_server",g?"ok":"warn",g?`reachable ${v}${A?` (${A})`:""}`:`down ${v}`,g?null:v.includes("127.0.0.1")||v.includes("localhost")?"oracle data serve  OR  set ~/.config/oracle/desk.json \u2192 Arch :8799":"check Arch desk is up (curl $ORACLE_DESK_URL/public/health)");let m=T();o("agent_runtime",m.ok?"ok":"warn",m.ok?`present ${m.bin} (${m.source})`:"not installed",m.ok?null:"oracle bootstrap");let O=Y.join(e.paths.hermesRoot(),"profiles"),_=0;y.existsSync(O)&&(_=y.readdirSync(O,{withFileTypes:!0}).filter(i=>i.isDirectory()).length),o("hermes_lanes",_>0?"ok":"warn",_>0?`${_} profile dir(s)`:"no lane profiles found",_>0?null:"oracle init --apply");let l=e.resolveOperator(),k={installed:!1};if(l.ok){let i=e.dispatchOperator("oracle-agentic-doctor",["--json"],{stdio:"pipe"}),u={installed:!0,version:l.version,source:l.source};if(i&&typeof i=="object"&&i.stdout)try{let p=JSON.parse(i.stdout);u={installed:!0,version:l.version,source:l.source,signingReady:p.signingReady,broadcastReady:p.broadcastReady,executionReady:p.executionReady,masterKillSwitch:p.masterKillSwitch,raw:p}}catch{u.doctorParseError=!0,u.doctorExit=i.code}else typeof i=="number"&&(u.doctorExit=i);k=u;let E=u.signingReady===!0;o("signing",E?"ok":"warn",E?`operator ${l.version} ready via ${l.source}`:`operator ${l.version} installed but signing is not ready`,E?null:"oracle sign doctor --json")}let j={ok:!s,checks:t,operator:k};if(r)process.stdout.write(JSON.stringify(j,null,2)+`
+`);else{for(let i of t)process.stdout.write(`${i.status.toUpperCase().padEnd(4)} ${i.id}: ${i.detail}
+`),i.fix&&process.stdout.write(`     fix: ${i.fix}
+`);l.ok||process.stdout.write(`INFO ${b}
+`)}return s?1:0}};export{fe as default};

package/dist/cli/commands/eval.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import{spawnSync as k}from"node:child_process";import T from"node:fs";import u from"node:path";import{fileURLToPath as E,pathToFileURL as S}from"node:url";var g=u.dirname(E(import.meta.url)),f=u.resolve(g,"../../.."),O=u.resolve(f,"../.."),h=u.join(O,"apps","oracle-app"),A=["test/best-execution.test.mjs","test/agent-grants.test.mjs","test/action-receipts.test.mjs","test/oracle-e2e-public-flow.test.mjs","test/auto-slippage.test.mjs","test/capability-posture.test.mjs","test/flag-polarity.test.mjs","test/cli-health-probe.test.mjs","test/public-surface-doc.test.mjs"];function R(c,{cwd:a,full:n=!1}={}){let e={...process.env,ORACLE_TEST_ISOLATE_SECRETS:"1",ORACLE_ROUTE_ATTESTATION_SECRET:process.env.ORACLE_ROUTE_ATTESTATION_SECRET||"oracle-unit-test-secret",ORACLE_GATE_BYPASS:"1"},o=n?["--test","test/*.test.mjs"]:["--test",...c];return n?k("bash",["-lc","ORACLE_TEST_ISOLATE_SECRETS=1 ORACLE_ROUTE_ATTESTATION_SECRET=oracle-unit-test-secret ORACLE_GATE_BYPASS=1 node --test test/*.test.mjs"],{cwd:a||f,encoding:"utf8",env:e,maxBuffer:20971520}):k(process.execPath,o,{cwd:a||f,encoding:"utf8",env:e,maxBuffer:20*1024*1024})}function _(c){let a=`${c.stdout||""}
+${c.stderr||""}`,n=Number((a.match(/ℹ pass (\d+)/)||[])[1]||0),e=Number((a.match(/ℹ fail (\d+)/)||[])[1]||0),o=Number((a.match(/ℹ skipped (\d+)/)||[])[1]||0);return{total:Number((a.match(/ℹ tests (\d+)/)||[])[1]||n+e+o),pass:n,fail:e,skipped:o,code:c.status??1}}async function w(){let c=u.join(h,"lib/oracle/swap-intent.ts");if(!T.existsSync(c))return{ok:!1,skipped:!0,error:`app parse module missing at ${c}`,cases:[]};let a=await import(S(c).href),{parseSwapIntent:n,parseConfirmIntent:e}=a,o=[],s=(r,m,d)=>o.push({name:r,ok:!!m,detail:d}),i=n("swap .1 eth to base");s("parse .1 eth to base \u2192 USDC/base",i?.tokenOut==="USDC"&&i?.chainHint==="base"&&i?.amount===".1",JSON.stringify(i));let l=n("swap 0.1 ETH to USDC on arbitrum");s("parse explicit pair+chain",l?.tokenOut==="USDC"&&l?.chainHint==="arbitrum");let p=n("sell .05 ETH for USDC on base");s("parse sell form",p?.tokenIn==="ETH"&&p?.tokenOut==="USDC"),s("garbage null",n("hello world")===null),s("confirm arm",e("arm")==="confirm"),s("confirm yes",e("yes")==="confirm"),s("cancel",e("cancel")==="cancel"),s("not confirm",e("what is eth")===null);let t=o.filter(r=>!r.ok).length;return{ok:t===0,total:o.length,pass:o.length-t,fail:t,cases:o}}var C={name:"eval",summary:"run desk / package eval harness",group:"read",usage:"oracle eval desk [--full] [--json]",async run(c){let a=c.argv||[],n=a.includes("--json"),e=a.includes("--full"),o=a.find(t=>!t.startsWith("-"))||"desk";if(o!=="desk"&&o!=="package")return process.stderr.write(`usage: oracle eval desk [--full] [--json]
+`),64;let s={suite:e?"oracle-eval-full":"oracle-eval-desk",at:new Date().toISOString(),packageRoot:f,slices:{}},i=A.filter(t=>T.existsSync(u.join(f,t))),l=R(i,{full:e}),p=_(l);s.slices.packageTests={...p,ok:p.fail===0&&p.code===0,mode:e?"full":"desk-critical",files:e?["test/*.test.mjs"]:i,tail:`${l.stdout||""}
+${l.stderr||""}`.trim().split(`
+`).slice(-30).join(`
+`)};try{s.slices.parse=await w()}catch(t){s.slices.parse={ok:!1,error:t instanceof Error?t.message:String(t)}}if(s.ok=s.slices.packageTests?.ok===!0&&(s.slices.parse?.ok===!0||s.slices.parse?.skipped===!0),n)process.stdout.write(`${JSON.stringify(s,null,2)}
+`);else{let t=s.slices.packageTests,r=s.slices.parse;if(process.stdout.write(`Oracle eval \xB7 ${s.suite}
+`),process.stdout.write(`  package tests (${t.mode}): ${t.pass}/${t.total} pass \xB7 fail ${t.fail} \xB7 skip ${t.skipped} \xB7 ${t.ok?"OK":"FAIL"}
+`),r?.skipped)process.stdout.write(`  parse eval: skipped (${r.error})
+`);else if(r&&(process.stdout.write(`  parse eval: ${r.pass}/${r.total} pass \xB7 ${r.ok?"OK":"FAIL"}
+`),!r.ok&&r.cases))for(let m of r.cases.filter(d=>!d.ok))process.stdout.write(`    \u2717 ${m.name} ${m.detail||""}
+`);process.stdout.write(`
+${s.ok?"PASS":"FAIL"} oracle eval desk
+`),!t.ok&&t.tail&&process.stdout.write(`
+--- package test tail ---
+${t.tail}
+`)}return s.ok?0:1}};export{C as default};

package/dist/cli/commands/fees.mjs

@@ -1,10 +1,10 @@
-import{readFileSync as w,existsSync as j}from"node:fs";import{Contract as x,JsonRpcProvider as g}from"ethers";var u="0x62FCFAf7573AD8B41a0FBF347AfEb85e06599A75",f=999,y="https://rpc.hyperliquid.xyz/evm",A=["function balanceOf(address owner) view returns (uint256)"],C=/^0x[a-fA-F0-9]{40}$/;function l(r){return C.test(String(r||""))}async function d(r,{contract:t=u,rpc:e=y,chainId:s=f,balanceOf:a}={}){if(!l(r))throw new Error("invalid-address");if(a)return BigInt(await a(r));let o=new g(e,s,{staticNetwork:!0}),c=new x(t,A,o);return BigInt(await c.balanceOf(r))}import L from"node:os";import i from"node:path";import{fileURLToPath as E}from"node:url";var _=i.dirname(E(import.meta.url)),H=i.resolve(_,"../..");function h(){return process.env.ORACLE_FAKE_HOME||L.homedir()}function v(){return process.env.ORACLE_PUBLIC_DESKTOP==="1"}function b(){return v()?process.env.ORACLE_CONFIG_DIR||i.join(h(),".config","oracle"):i.join(h(),".config","oracle")}function O(){return i.join(b(),"exec.env")}var m=`oracle fees \u2014 Oracle fee-waiver status
+import{readFileSync as D,existsSync as w}from"node:fs";import{Contract as C,JsonRpcProvider as m}from"ethers";var d="0x62FCFAf7573AD8B41a0FBF347AfEb85e06599A75",_=999,x="https://rpc.hyperliquid.xyz/evm",R=["function balanceOf(address owner) view returns (uint256)"],g=/^0x[a-fA-F0-9]{40}$/;function f(o){return g.test(String(o||""))}async function O(o,{contract:s=d,rpc:e=x,chainId:i=_,balanceOf:n}={}){if(!f(o))throw new Error("invalid-address");if(n)return BigInt(await n(o));let r=new m(e,i,{staticNetwork:!0}),c=new C(s,R,r);return BigInt(await c.balanceOf(o))}import p from"node:fs";import y from"node:os";import l from"node:path";import{fileURLToPath as v}from"node:url";var U=l.dirname(v(import.meta.url)),M=l.resolve(U,"../..");function L(){return process.env.ORACLE_FAKE_HOME||y.homedir()}function S(){return process.env.ORACLE_PUBLIC_DESKTOP==="1"}function h(){return S()?process.env.ORACLE_CONFIG_DIR||l.join(L(),".config","oracle"):l.join(L(),".config","oracle")}function A(){return l.join(h(),"exec.env")}function b(){return l.join(h(),"desk.json")}function j(){return l.join(h(),"env")}function u({force:o=!1}={}){if(u._done&&!o)return u._result||null;u._done=!0;let s={},e=(n,r)=>{if(r==null)return;let c=String(r).trim();c&&(process.env[n]!=null&&String(process.env[n]).trim()!==""||(process.env[n]=c,s[n]=c))};try{let n=j();if(p.existsSync(n))for(let r of p.readFileSync(n,"utf8").split(/\r?\n/)){let c=r.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*?)\s*$/);if(!c||c[2].startsWith("#"))continue;let a=c[2];(a.startsWith('"')&&a.endsWith('"')||a.startsWith("'")&&a.endsWith("'"))&&(a=a.slice(1,-1)),e(c[1],a)}}catch{}try{let n=b();if(p.existsSync(n)){let r=JSON.parse(p.readFileSync(n,"utf8"));r&&typeof r=="object"&&(e("ORACLE_DESK_URL",r.deskUrl||r.dataUrl||r.url),e("ORACLE_DATA_URL",r.dataUrl||r.deskUrl||r.url),e("ORACLE_API_URL",r.apiUrl||r.dataUrl||r.deskUrl),e("ORACLE_PUBLIC_URL",r.publicUrl||r.deskUrl||r.dataUrl),e("ORACLE_EXEC_URL",r.execUrl),e("MAD_DESK_URL",r.deskUrl||r.dataUrl))}}catch{}let i=process.env.ORACLE_DESK_URL||process.env.ORACLE_DATA_URL||"";return i&&(e("ORACLE_DESK_URL",i),e("ORACLE_DATA_URL",i),e("ORACLE_API_URL",i),e("ORACLE_PUBLIC_URL",i),e("MAD_DESK_URL",i)),u._result=Object.keys(s).length?s:null,u._result}try{u()}catch{}var E=`oracle fees \u2014 Oracle fee-waiver status
 
   oracle fees status            check the configured agent wallet
   oracle fees check <address>   check any address
   oracle fees info              show the Locals Only collection
 
 Oracle is public to everyone. A Locals Only NFT only waives Oracle's integrator
-fee. This command reads balanceOf on HyperEVM; it does not sign or request keys.`;function R(r=O()){if(!j(r))return null;try{let t=w(r,"utf8");for(let e of t.split(`
-`)){let s=e.match(/^\s*(?:export\s+)?ORACLE_EVM_ADDRESS\s*=\s*(.+)\s*$/);if(!s)continue;let a=s[1].trim().replace(/^["']|["']$/g,"");if(l(a))return a}}catch{return null}return null}function n(r,t){r.write(t+`
-`)}async function S(r=[],t={}){let e=t.out??process.stdout,s=t.err??process.stderr,a=t.balanceOf??d,o=r[0];if(!o||o==="--help"||o==="-h"||o==="help")return n(e,m),0;if(o==="info")return n(e,`contract: ${u}`),n(e,`chain:    HyperEVM (${f})`),n(e,"benefit:  0% Oracle integrator fee"),n(e,"access:   public to everyone"),0;let c;if(o==="status"){if(c=t.agentAddress?t.agentAddress():R(),!c)return n(e,"wallet: not configured"),n(e,"Locals Only fee-waiver status: unavailable"),n(e,"standard Oracle fee applies when configured"),n(e,"Oracle access remains public to everyone."),0}else if(o==="check"){if(c=r[1],!l(c))return n(s,"usage: oracle fees check <0x address>"),2}else return n(s,`oracle fees: unknown subcommand '${o}'`),2;try{let p=await a(c);return n(e,`wallet: ${c}`),BigInt(p)>0n?(n(e,`Locals Only balance: ${p}`),n(e,"Oracle integrator fee: 0%")):(n(e,"Locals Only balance: 0"),n(e,"standard Oracle fee applies when configured")),n(e,"Oracle access remains public to everyone."),0}catch{return n(e,"Locals Only fee-waiver status: unavailable"),n(e,"standard Oracle fee applies when configured"),n(e,"Oracle access remains public to everyone."),0}}var $="check Locals Only zero-fee eligibility",Y={name:"fees",summary:"check Locals Only zero-fee eligibility",group:"read",usage:m,async run(r){return S(r.argv??[])}};export{R as agentAddress,Y as default,$ as help,S as run};
+fee. This command reads balanceOf on HyperEVM; it does not sign or request keys.`;function k(o=A()){if(!w(o))return null;try{let s=D(o,"utf8");for(let e of s.split(`
+`)){let i=e.match(/^\s*(?:export\s+)?ORACLE_EVM_ADDRESS\s*=\s*(.+)\s*$/);if(!i)continue;let n=i[1].trim().replace(/^["']|["']$/g,"");if(f(n))return n}}catch{return null}return null}function t(o,s){o.write(s+`
+`)}async function P(o=[],s={}){let e=s.out??process.stdout,i=s.err??process.stderr,n=s.balanceOf??O,r=o[0];if(!r||r==="--help"||r==="-h"||r==="help")return t(e,E),0;if(r==="info")return t(e,`contract: ${d}`),t(e,`chain:    HyperEVM (${_})`),t(e,"benefit:  0% Oracle integrator fee"),t(e,"access:   public to everyone"),0;let c;if(r==="status"){if(c=s.agentAddress?s.agentAddress():k(),!c)return t(e,"wallet: not configured"),t(e,"Locals Only fee-waiver status: unavailable"),t(e,"standard Oracle fee applies when configured"),t(e,"Oracle access remains public to everyone."),0}else if(r==="check"){if(c=o[1],!f(c))return t(i,"usage: oracle fees check <0x address>"),2}else return t(i,`oracle fees: unknown subcommand '${r}'`),2;try{let a=await n(c);return t(e,`wallet: ${c}`),BigInt(a)>0n?(t(e,`Locals Only balance: ${a}`),t(e,"Oracle integrator fee: 0%")):(t(e,"Locals Only balance: 0"),t(e,"standard Oracle fee applies when configured")),t(e,"Oracle access remains public to everyone."),0}catch{return t(e,"Locals Only fee-waiver status: unavailable"),t(e,"standard Oracle fee applies when configured"),t(e,"Oracle access remains public to everyone."),0}}var z="check Locals Only zero-fee eligibility",J={name:"fees",summary:"check Locals Only zero-fee eligibility",group:"read",usage:E,async run(o){return P(o.argv??[])}};export{k as agentAddress,J as default,z as help,P as run};

package/dist/cli/commands/harness.mjs

@@ -1,15 +1,9 @@
-import l from"node:fs";import i from"node:path";var E=Object.freeze({openrouter:{key:"OPENROUTER_API_KEY",baseUrl:"https://openrouter.ai/api/v1",model:"openrouter/auto"},openai:{key:"OPENAI_API_KEY",baseUrl:"https://api.openai.com/v1",model:"gpt-4.1-mini"},xai:{key:"XAI_API_KEY",baseUrl:"https://api.x.ai/v1",model:"grok-4-latest"},deepseek:{key:"DEEPSEEK_API_KEY",baseUrl:"https://api.deepseek.com/v1",model:"deepseek-chat"},gemini:{key:"GEMINI_API_KEY",alternateKey:"GOOGLE_API_KEY",baseUrl:"https://generativelanguage.googleapis.com/v1beta/openai",model:"gemini-2.5-flash"}}),h=Object.freeze({"anthropic-oauth":{key:"ANTHROPIC_API_KEY",baseUrl:"https://api.anthropic.com/v1",model:"claude-sonnet-4-20250514",protocol:"anthropic-messages"},"openai-codex":{key:"OPENAI_API_KEY",baseUrl:"https://chatgpt.com/backend-api/codex",model:"gpt-5.4",protocol:"responses"},"xai-oauth":{key:"XAI_API_KEY",baseUrl:"https://api.x.ai/v1",model:"grok-4-latest",protocol:"responses"}});var u=Object.freeze([{name:"oracle",bin:"oracle",label:"Oracle Native (default)",kind:"oracle"},{name:"hermes",bin:"hermes",label:"Hermes Agent",kind:"hermes"},{name:"opencode",bin:"opencode",label:"OpenCode",kind:"mcp"},{name:"claude",bin:"claude",label:"Claude Code",kind:"mcp"},{name:"codex",bin:"codex",label:"OpenAI Codex CLI",kind:"mcp"},{name:"cursor",bin:"cursor",label:"Cursor IDE",kind:"mcp"},{name:"windsurf",bin:"windsurf",label:"Windsurf",kind:"mcp"},{name:"aider",bin:"aider",label:"Aider",kind:"mcp"},{name:"continue",bin:"continue",label:"Continue",kind:"mcp"}]);function d(n){for(let t of(process.env.PATH||"").split(i.delimiter)){let e=i.join(t,n);try{if(l.existsSync(e))return e}catch{}}return null}function c(){let n=[];for(let t of u){if(t.name==="oracle"){n.push({...t,path:process.argv[1]||"oracle"});continue}let e=d(t.bin);e&&n.push({...t,path:e})}return n}function s(){return["oracle harness \u2014 detect installed agent harnesses","","  oracle harness detect    scan PATH for Agent Plugins-compatible clients","","Oracle runs natively. If you prefer a different harness,","set ORACLE_CHAT_BACKEND=<name>.","","Detected: opencode, claude, codex, cursor, windsurf, aider, continue, hermes"].join(`
-`)}var b={name:"harness",summary:"detect installed agent harnesses",usage:s,async run(n,t){let e=n[0];if(e==="help"||e==="--help"||e==="-h")return process.stdout.write(s()+`
+import u from"node:fs";import c from"node:path";var g=Object.freeze({openrouter:{key:"OPENROUTER_API_KEY",baseUrl:"https://openrouter.ai/api/v1",model:"openrouter/auto"},openai:{key:"OPENAI_API_KEY",baseUrl:"https://api.openai.com/v1",model:"gpt-4.1-mini"},xai:{key:"XAI_API_KEY",baseUrl:"https://api.x.ai/v1",model:"grok-4-latest"},deepseek:{key:"DEEPSEEK_API_KEY",baseUrl:"https://api.deepseek.com/v1",model:"deepseek-chat"},gemini:{key:"GEMINI_API_KEY",alternateKey:"GOOGLE_API_KEY",baseUrl:"https://generativelanguage.googleapis.com/v1beta/openai",model:"gemini-2.5-flash"}}),O=Object.freeze({"anthropic-oauth":{key:"ANTHROPIC_API_KEY",baseUrl:"https://api.anthropic.com/v1",model:"claude-sonnet-4-20250514",protocol:"anthropic-messages"},"openai-codex":{key:"OPENAI_API_KEY",baseUrl:"https://chatgpt.com/backend-api/codex",model:"gpt-5.4",protocol:"responses"},"xai-oauth":{key:"XAI_API_KEY",baseUrl:"https://api.x.ai/v1",model:"grok-4-latest",protocol:"responses"}});var d=Object.freeze([{name:"oracle",bin:"oracle",label:"Oracle Native (default)",kind:"oracle"},{name:"hermes",bin:"hermes",label:"Hermes Agent",kind:"hermes"},{name:"opencode",bin:"opencode",label:"OpenCode",kind:"mcp"},{name:"claude",bin:"claude",label:"Claude Code",kind:"mcp"},{name:"codex",bin:"codex",label:"OpenAI Codex CLI",kind:"mcp"},{name:"cursor",bin:"cursor",label:"Cursor IDE",kind:"mcp"},{name:"windsurf",bin:"windsurf",label:"Windsurf",kind:"mcp"},{name:"aider",bin:"aider",label:"Aider",kind:"mcp"},{name:"continue",bin:"continue",label:"Continue",kind:"mcp"}]);function p(n){for(let o of(process.env.PATH||"").split(c.delimiter)){let e=c.join(o,n);try{if(u.existsSync(e))return e}catch{}}return null}function l(){let n=[];for(let o of d){if(o.name==="oracle"){n.push({...o,path:process.argv[1]||"oracle"});continue}let e=p(o.bin);e&&n.push({...o,path:e})}return n}var m=Object.freeze({claude:"claude-code",codex:"codex",cursor:"cursor",windsurf:"vscode",continue:"vscode",opencode:"generic",aider:"generic"});function h(n){if(n.kind==="oracle")return{...n,direction:"native",integrate:null,backendEnv:null,note:"Oracle's own agent loop. This is the default and needs no wiring."};let e=`oracle mcp install ${m[n.name]||"generic"}`;return n.kind==="hermes"?{...n,direction:"both",integrate:e,backendEnv:`ORACLE_CHAT_BACKEND=${n.name}`,note:"Legacy: this hands Oracle's native model loop to Hermes. Prefer the inbound MCP wiring above."}:{...n,direction:"inbound",integrate:e,backendEnv:null,note:"Calls Oracle as an MCP server. Oracle's native model loop stays in charge."}}function f(n){let o=n.map(h),e=o.find(r=>r.direction==="native"),a=o.filter(r=>r.direction==="inbound"||r.direction==="both"),i=o.filter(r=>r.backendEnv),t=[];if(t.push(""),t.push(`Oracle native chat: default${e?`  (${e.path})`:""}`),t.push("Oracle runs its own agent loop, memory, skills, and scheduler."),t.push(""),t.push("Integrate Oracle INTO these clients (recommended \u2014 native loop stays):"),a.length===0)t.push("  (none detected \u2014 Oracle runs standalone, nothing else required)");else for(let r of a)t.push(`  ${r.label.padEnd(22)} ${r.path}`),t.push(`  ${" ".repeat(22)} ${r.integrate}`);if(t.push(""),i.length>0){t.push("Delegate Oracle's model loop to another harness (legacy, not recommended):");for(let r of i)t.push(`  ${r.label.padEnd(22)} ${r.backendEnv}`),t.push(`  ${" ".repeat(22)} ${r.note}`);t.push("")}return t.push("Detection is capability discovery only. It never changes the backend."),t.join(`
+`)}function s(){return["oracle harness \u2014 detect installed agent harnesses","","  oracle harness detect    scan PATH for Agent Plugins-compatible clients","","Two directions, do not confuse them:","  inbound  \u2014 the client calls Oracle as an MCP server (oracle mcp install <target>).","             Oracle's native model loop stays in charge. This is integration.","  outbound \u2014 Oracle hands its model loop to that harness (ORACLE_CHAT_BACKEND=<name>).","             This surrenders the native harness and is legacy only.","","Detected: opencode, claude, codex, cursor, windsurf, aider, continue, hermes"].join(`
+`)}var C={name:"harness",summary:"detect installed agent harnesses",usage:s,async run(n,o){let e=n[0];if(e==="help"||e==="--help"||e==="-h")return process.stdout.write(s()+`
 `),0;if(e&&e!=="detect"&&e!=="list")return process.stderr.write(`oracle harness: unknown subcommand '${e}'
 `),process.stderr.write(s()+`
-`),1;let o=c();if(o.length===0)return process.stderr.write(`No agent harnesses detected on PATH.
+`),1;let a=l();return a.length===0?(process.stderr.write(`No agent harnesses detected on PATH.
 `),process.stderr.write(`Oracle runs natively \u2014 no external agent required.
-`),0;let p=o.find(r=>r.kind==="oracle"),a=o.filter(r=>r.kind!=="oracle");process.stdout.write(`
-Oracle native chat: default
-
-`),process.stdout.write(`Installed harnesses:
-`);for(let r of a)process.stdout.write(`  ${r.label.padEnd(22)} ${r.path}
-`);return a.length===0&&process.stdout.write(`  (none \u2014 Oracle runs standalone)
-`),process.stdout.write(`
-Set ORACLE_CHAT_BACKEND=<name> to use a different harness.
-`),0}};export{b as default};
+`),0):(process.stdout.write(f(a)+`
+`),0)}};export{h as classifyHarness,C as default,f as renderHarnessReport};

package/dist/cli/commands/mcp.mjs

@@ -1,36 +1,60 @@
-import{parseArgs as me}from"node:util";import M from"node:path";import{fileURLToPath as W}from"node:url";var z=M.dirname(W(import.meta.url)),he=M.resolve(z,"../.."),be=Object.freeze(["oracle-vault","oracle-credential","oracle-signer","oracle-runner","oracle-agentic-init","oracle-agentic-doctor","oracle-control-mcp","oracle-operator-caps"]),Se=Object.freeze(["vault","credential","signer","runner","sign"]),I=`oracle: signing is unavailable in the public package.
+import{parseArgs as Fe}from"node:util";import Y from"node:path";import{fileURLToPath as fe}from"node:url";var de=Y.dirname(fe(import.meta.url)),We=Y.resolve(de,"../.."),Be=Object.freeze(["oracle-vault","oracle-credential","oracle-signer","oracle-runner","oracle-agentic-init","oracle-agentic-doctor","oracle-control-mcp","oracle-operator-caps"]),Ge=Object.freeze(["vault","credential","signer","runner","sign"]),q=`oracle: signing is unavailable in the public package.
 
   The public 'oracle' package is prepare-only and never handles keys.
   Owner-operated signing is private infrastructure and has no public npm install.
   Review and sign prepared artifacts in your own wallet instead.
 
   Nothing about your read/research/prepare setup is affected.
-`;function y(e=process.stderr){e.write(I),I.endsWith(`
+`;function _(e=process.stderr){e.write(q),q.endsWith(`
 `)||e.write(`
-`)}import{spawnSync as D}from"node:child_process";import H from"node:path";import k from"node:fs";import v from"node:path";import Z from"node:os";import Y from"node:fs";import j from"node:path";import{fileURLToPath as Q}from"node:url";var X=j.dirname(Q(import.meta.url)),h=j.resolve(X,"../..");function $(e){let r=[j.join(h,"bin",e),j.join(h,"dist","bin",e),j.join(h,"..","bin",e)];return r.find(t=>Y.existsSync(t))||r[0]}function d(){return process.env.ORACLE_FAKE_HOME||Z.homedir()}function m({oracleRoot:e=h,operator:r=null,withControl:t=!1}={}){let s={"oracle-data":{command:"node",args:[e===h?$("oracle-data-mcp.mjs"):[v.join(e,"bin","oracle-data-mcp.mjs"),v.join(e,"dist","bin","oracle-data-mcp.mjs")].find(a=>k.existsSync(a))||v.join(e,"bin","oracle-data-mcp.mjs")]}};if(t){if(!r||!r.ok)return{ok:!1,reason:"operator-missing"};let a=r.bins?.["oracle-control-mcp"]||r.controlMcp||null;if(!a)return{ok:!1,reason:"control-bin-missing"};s["oracle-control"]={command:"node",args:[a]}}return{ok:!0,specs:s}}function C(e){if(!k.existsSync(e))return null;let r=`${e}.bak-oracle-${Math.floor(Date.now()/1e3)}`;return k.copyFileSync(e,r),r}function ee(e,r={}){return k.existsSync(e)?JSON.parse(k.readFileSync(e,"utf8")):structuredClone(r)}function re(e,r){k.mkdirSync(v.dirname(e),{recursive:!0}),k.writeFileSync(e,JSON.stringify(r,null,2)+`
-`)}function g(e,r){let t=ee(e,{});(!t.mcpServers||typeof t.mcpServers!="object")&&(t.mcpServers={});let i=!1;for(let[a,o]of Object.entries(r)){let p=t.mcpServers[a];p&&JSON.stringify(p)===JSON.stringify(o)||(t.mcpServers[a]=o,i=!0)}if(!i)return{status:"present",backup:null};let s=C(e);return re(e,t),{status:"written",backup:s}}function f(e,r={}){return{status:e,...r}}function te(){return H.join(d(),".claude.json")}function oe(e){return H.join(e||process.cwd(),".mcp.json")}function ne(e,r){let t=D("claude",["--version"],{encoding:"utf8",timeout:1e4});if(t.error||t.status!==0)return null;let i=D("claude",["mcp","add-json",e,JSON.stringify(r),"--scope","user"],{encoding:"utf8",timeout:3e4});return i.status!==0?{ok:!1,stderr:i.stderr||i.stdout||"failed"}:{ok:!0}}async function L({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:s=!1,cwd:a=process.cwd()}){let o=m({oracleRoot:e,operator:r,withControl:t});if(!o.ok)return{ok:!1,code:3,reason:o.reason};if(s)return{ok:!0,print:{mcpServers:o.specs}};if(i){let l=oe(a),u=g(l,o.specs);return{ok:!0,...f(u.status,{path:l,backup:u.backup})}}let p=!1;for(let[l,u]of Object.entries(o.specs)){let S=ne(l,u);if(S&&S.ok){p=!0;continue}break}if(p)return{ok:!0,...f("written",{method:"claude-cli"})};let c=te(),n=g(c,o.specs);return{ok:!0,...f(n.status,{path:c,backup:n.backup})}}import se from"node:fs";import E from"node:path";function ie(){return process.platform==="darwin"?E.join(d(),"Library","Application Support","Claude","claude_desktop_config.json"):E.join(d(),".config","Claude","claude_desktop_config.json")}async function P({oracleRoot:e,operator:r,withControl:t=!1,printOnly:i=!1}){let s=m({oracleRoot:e,operator:r,withControl:t});if(!s.ok)return{ok:!1,code:3,reason:s.reason};let a=ie(),o={mcpServers:s.specs};if(i)return{ok:!0,print:o};let p=E.dirname(a);if(!se.existsSync(p))return{ok:!0,status:"printed (Claude Desktop not detected)",path:a,print:o};let c=g(a,s.specs);return{ok:!0,...f(c.status,{path:a,backup:c.backup})}}import w from"node:fs";import F from"node:path";var G="# oracle-mcp-install begin",U="# oracle-mcp-install end";function ce(){return F.join(d(),".codex","config.toml")}function ae(e){let r=[G];for(let[t,i]of Object.entries(e))r.push(`[mcp_servers.${t}]`),r.push(`command = ${JSON.stringify(i.command)}`),r.push(`args = [${i.args.map(s=>JSON.stringify(s)).join(", ")}]`),r.push("");return r.push(U),r.join(`
+`)}import{spawnSync as Q}from"node:child_process";import ee from"node:path";import u from"node:fs";import j from"node:path";import ye from"node:os";import E from"node:fs";import me from"node:os";import h from"node:path";import{fileURLToPath as ge}from"node:url";var ke=h.dirname(ge(import.meta.url)),O=h.resolve(ke,"../..");function V(){return process.env.ORACLE_FAKE_HOME||me.homedir()}function he(){return process.env.ORACLE_PUBLIC_DESKTOP==="1"}function z(){return he()?process.env.ORACLE_CONFIG_DIR||h.join(V(),".config","oracle"):h.join(V(),".config","oracle")}function Se(){return h.join(z(),"desk.json")}function be(){return h.join(z(),"env")}function x({force:e=!1}={}){if(x._done&&!e)return x._result||null;x._done=!0;let r={},t=(n,o)=>{if(o==null)return;let s=String(o).trim();s&&(process.env[n]!=null&&String(process.env[n]).trim()!==""||(process.env[n]=s,r[n]=s))};try{let n=be();if(E.existsSync(n))for(let o of E.readFileSync(n,"utf8").split(/\r?\n/)){let s=o.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*?)\s*$/);if(!s||s[2].startsWith("#"))continue;let c=s[2];(c.startsWith('"')&&c.endsWith('"')||c.startsWith("'")&&c.endsWith("'"))&&(c=c.slice(1,-1)),t(s[1],c)}}catch{}try{let n=Se();if(E.existsSync(n)){let o=JSON.parse(E.readFileSync(n,"utf8"));o&&typeof o=="object"&&(t("ORACLE_DESK_URL",o.deskUrl||o.dataUrl||o.url),t("ORACLE_DATA_URL",o.dataUrl||o.deskUrl||o.url),t("ORACLE_API_URL",o.apiUrl||o.dataUrl||o.deskUrl),t("ORACLE_PUBLIC_URL",o.publicUrl||o.deskUrl||o.dataUrl),t("ORACLE_EXEC_URL",o.execUrl),t("MAD_DESK_URL",o.deskUrl||o.dataUrl))}}catch{}let i=process.env.ORACLE_DESK_URL||process.env.ORACLE_DATA_URL||"";return i&&(t("ORACLE_DESK_URL",i),t("ORACLE_DATA_URL",i),t("ORACLE_API_URL",i),t("ORACLE_PUBLIC_URL",i),t("MAD_DESK_URL",i)),x._result=Object.keys(r).length?r:null,x._result}try{x()}catch{}function P(e){let r=[h.join(O,"bin",e),h.join(O,"dist","bin",e),h.join(O,"..","bin",e)];return r.find(t=>E.existsSync(t))||r[0]}function g(){return process.env.ORACLE_FAKE_HOME||ye.homedir()}function k({oracleRoot:e=O,operator:r=null,withControl:t=!1}={}){let n={"oracle-data":{command:"node",args:[e===O?P("oracle-data-mcp.mjs"):[j.join(e,"bin","oracle-data-mcp.mjs"),j.join(e,"dist","bin","oracle-data-mcp.mjs")].find(o=>u.existsSync(o))||j.join(e,"bin","oracle-data-mcp.mjs")]}};if(t){if(!r||!r.ok)return{ok:!1,reason:"operator-missing"};let o=r.bins?.["oracle-control-mcp"]||r.controlMcp||null;if(!o)return{ok:!1,reason:"control-bin-missing"};n["oracle-control"]={command:"node",args:[o]};let s=e===O?P("oracle-exec-mcp.mjs"):[j.join(e,"bin","oracle-exec-mcp.mjs"),j.join(e,"dist","bin","oracle-exec-mcp.mjs")].find(c=>u.existsSync(c))||j.join(e,"bin","oracle-exec-mcp.mjs");u.existsSync(s)&&(n["oracle-exec"]={command:"node",args:[s]})}return{ok:!0,specs:n}}function S(e){if(!u.existsSync(e))return null;let r=`${e}.bak-oracle-${Math.floor(Date.now()/1e3)}`,t=r;for(let n=1;u.existsSync(t);n+=1)t=`${r}-${n}`;let i=Z(e,"read");try{let n=we(t);try{u.writeFileSync(n,u.readFileSync(i))}finally{u.closeSync(n)}}finally{u.closeSync(i)}return t}function $(){return u.constants.O_NOFOLLOW||0}function X(e){let r=u.lstatSync(e);if(r.isSymbolicLink()||!r.isFile())throw new Error(`refusing to use non-regular config path: ${e}`)}function Z(e,r){X(e);let t=(r==="read"?u.constants.O_RDONLY:u.constants.O_WRONLY)|$();return u.openSync(e,t)}function we(e){return u.openSync(e,u.constants.O_WRONLY|u.constants.O_CREAT|u.constants.O_EXCL|$(),384)}function Oe(e,r){u.existsSync(e)&&X(e);let t=u.openSync(e,u.constants.O_WRONLY|u.constants.O_CREAT|u.constants.O_TRUNC|$(),384);try{u.writeFileSync(t,r)}finally{u.closeSync(t)}try{u.chmodSync(e,384)}catch{}}function T(e,r=""){if(!u.existsSync(e))return r;let t=Z(e,"read");try{return u.readFileSync(t,"utf8")}finally{u.closeSync(t)}}function R(e,r){u.mkdirSync(j.dirname(e),{recursive:!0}),Oe(e,r)}function D(e,r={}){return u.existsSync(e)?JSON.parse(T(e,"{}")):structuredClone(r)}function I(e,r){R(e,JSON.stringify(r,null,2)+`
+`)}function b(e,r){let t=D(e,{});(!t.mcpServers||typeof t.mcpServers!="object")&&(t.mcpServers={});let i=!1;for(let[o,s]of Object.entries(r)){let c=t.mcpServers[o];c&&JSON.stringify(c)===JSON.stringify(s)||(t.mcpServers[o]=s,i=!0)}if(!i)return{status:"present",backup:null};let n=S(e);return I(e,t),{status:"written",backup:n}}function m(e,r={}){return{status:e,...r}}function je(){return ee.join(g(),".claude.json")}function ve(e){return ee.join(e||process.cwd(),".mcp.json")}function xe(e,r){let t=Q("claude",["--version"],{encoding:"utf8",timeout:1e4});if(t.error||t.status!==0)return null;let i=Q("claude",["mcp","add-json",e,JSON.stringify(r),"--scope","user"],{encoding:"utf8",timeout:3e4});return i.status!==0?{ok:!1,stderr:i.stderr||i.stdout||"failed"}:{ok:!0}}async function te({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:n=!1,cwd:o=process.cwd()}){let s=k({oracleRoot:e,operator:r,withControl:t});if(!s.ok)return{ok:!1,code:3,reason:s.reason};if(n)return{ok:!0,print:{mcpServers:s.specs}};if(i){let a=ve(o),f=b(a,s.specs);return{ok:!0,...m(f.status,{path:a,backup:f.backup})}}let c=!1;for(let[a,f]of Object.entries(s.specs)){let p=xe(a,f);if(p&&p.ok){c=!0;continue}break}if(c)return{ok:!0,...m("written",{method:"claude-cli"})};let d=je(),l=b(d,s.specs);return{ok:!0,...m(l.status,{path:d,backup:l.backup})}}import Ce from"node:fs";import F from"node:path";function _e(){return process.platform==="darwin"?F.join(g(),"Library","Application Support","Claude","claude_desktop_config.json"):F.join(g(),".config","Claude","claude_desktop_config.json")}async function J({oracleRoot:e,operator:r,withControl:t=!1,printOnly:i=!1}){let n=k({oracleRoot:e,operator:r,withControl:t});if(!n.ok)return{ok:!1,code:3,reason:n.reason};let o=_e(),s={mcpServers:n.specs};if(i)return{ok:!0,print:s};let c=F.dirname(o);if(!Ce.existsSync(c))return{ok:!0,status:"printed (Claude Desktop not detected)",path:o,print:s};let d=b(o,n.specs);return{ok:!0,...m(d.status,{path:o,backup:d.backup})}}import re from"node:fs";import ne from"node:path";var oe="# oracle-mcp-install begin",se="# oracle-mcp-install end";function Ee(){return ne.join(g(),".codex","config.toml")}function Re(e){let r=[oe];for(let[t,i]of Object.entries(e))r.push(`[mcp_servers.${t}]`),r.push(`command = ${JSON.stringify(i.command)}`),r.push(`args = [${i.args.map(n=>JSON.stringify(n)).join(", ")}]`),r.push("");return r.push(se),r.join(`
 `)+`
-`}function pe(e){return e.replace(new RegExp(`${G}[\\s\\S]*?${U}\\n?`,"g"),"")}async function A({oracleRoot:e,operator:r,withControl:t=!1,printOnly:i=!1}){let s=m({oracleRoot:e,operator:r,withControl:t});if(!s.ok)return{ok:!1,code:3,reason:s.reason};let a=ae(s.specs),o=ce();if(i)return{ok:!0,printText:a,path:o};w.mkdirSync(F.dirname(o),{recursive:!0});let p=w.existsSync(o)?w.readFileSync(o,"utf8"):"";if(p.includes(a.trim()))return{ok:!0,...f("present",{path:o,backup:null})};let n=(pe(p).trimEnd()+`
+`}function Ae(e){return e.replace(new RegExp(`${oe}[\\s\\S]*?${se}\\n?`,"g"),"")}async function M({oracleRoot:e,operator:r,withControl:t=!1,printOnly:i=!1}){let n=k({oracleRoot:e,operator:r,withControl:t});if(!n.ok)return{ok:!1,code:3,reason:n.reason};let o=Re(n.specs),s=Ee();if(i)return{ok:!0,printText:o,path:s};re.mkdirSync(ne.dirname(s),{recursive:!0});let c=re.existsSync(s)?T(s,""):"";if(c.includes(o.trim()))return{ok:!0,...m("present",{path:s,backup:null})};let l=(Ae(c).trimEnd()+`
 
-`+a).replace(/^\n+/,"");if(p.trim()===n.trim())return{ok:!0,...f("present",{path:o,backup:null})};let l=p?C(o):null;return w.writeFileSync(o,n.endsWith(`
-`)?n:n+`
-`),{ok:!0,...f("written",{path:o,backup:l})}}import B from"node:fs";import q from"node:path";var N="ChatGPT is hosted and can NEVER sign or reach your keys. This connector is read/prepare only; anything it prepares is unsigned until you sign it locally.";function ue(){return{openapi:"3.1.0",info:{title:"Oracle Public (read/prepare)",version:"1.0.0",description:"Secret-free public surface for hosted clients. "+N},servers:[{url:"https://REPLACE-WITH-YOUR-TUNNEL"}],paths:{"/public/health":{get:{operationId:"publicHealth",summary:"Health check",responses:{200:{description:"ok"}}}},"/public/config":{get:{operationId:"publicConfig",summary:"Public config",responses:{200:{description:"ok"}}}},"/public/connect/request":{post:{operationId:"connectRequest",summary:"Build a connect request (unsigned)",responses:{200:{description:"unsigned request artifact"}}}},"/public/connect/assemble":{post:{operationId:"connectAssemble",summary:"Assemble an unsigned grant artifact",responses:{200:{description:"unsigned grant artifact"}}}},"/public/grants/active":{post:{operationId:"grantsActive",summary:"List active grants (read)",responses:{200:{description:"ok"}}}},"/public/grants/get":{post:{operationId:"grantsGet",summary:"Get a grant by id (read)",responses:{200:{description:"ok"}}}}}}}async function R({printOnly:e=!1}={}){let r=ue(),t=q.join(d(),".config","oracle","connectors","chatgpt-openapi.json"),i=JSON.stringify(r,null,2)+`
-`;e||(B.mkdirSync(q.dirname(t),{recursive:!0}),B.writeFileSync(t,i));let s=[N,"","Next steps:","  1. oracle public serve","  2. Expose 127.0.0.1:8799 through YOUR HTTPS tunnel (cloudflared, tailscale funnel, etc.).","     Oracle will not create tunnels for you.","  3. Paste the OpenAPI spec into a GPT Action, or add the tunnel URL as a developer-mode MCP connector.",e?"":`  Spec written to: ${t}`].filter(Boolean).join(`
-`);return{ok:!0,...f(e?"printed":"written",{path:t,print:r,instructions:s,cannotSign:N})}}import _ from"node:path";import K from"node:os";function le(){return process.platform==="darwin"?_.join(K.homedir(),"Library","Application Support","Cursor","User","globalStorage","mcp.json"):process.platform==="win32"?_.join(K.homedir(),"AppData","Roaming","Cursor","User","globalStorage","mcp.json"):_.join(d(),".config","cursor","mcp.json")}async function T({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:s=!1,cwd:a=process.cwd()}){let o=m({oracleRoot:e,operator:r,withControl:t});if(!o.ok)return{ok:!1,code:3,reason:o.reason};if(s)return{ok:!0,printText:['Add this to your Cursor MCP config (Cmd+Shift+P \u2192 "MCP: Open Configuration"):',JSON.stringify({mcpServers:o.specs},null,2)].join(`
+`+o).replace(/^\n+/,"");if(c.trim()===l.trim())return{ok:!0,...m("present",{path:s,backup:null})};let a=c?S(s):null;return R(s,l.endsWith(`
+`)?l:l+`
+`),{ok:!0,...m("written",{path:s,backup:a})}}import Le from"node:fs";import ie from"node:path";var H="ChatGPT is hosted and can NEVER sign or reach your keys. This connector is read/prepare only; anything it prepares is unsigned until you sign it locally.";function Ne(){return{openapi:"3.1.0",info:{title:"Oracle Public (read/prepare)",version:"1.0.0",description:"Secret-free public surface for hosted clients. "+H},servers:[{url:"https://REPLACE-WITH-YOUR-TUNNEL"}],paths:{"/public/health":{get:{operationId:"publicHealth",summary:"Health check",responses:{200:{description:"ok"}}}},"/public/config":{get:{operationId:"publicConfig",summary:"Public config",responses:{200:{description:"ok"}}}},"/public/connect/request":{post:{operationId:"connectRequest",summary:"Build a connect request (unsigned)",responses:{200:{description:"unsigned request artifact"}}}},"/public/connect/assemble":{post:{operationId:"connectAssemble",summary:"Assemble an unsigned grant artifact",responses:{200:{description:"unsigned grant artifact"}}}},"/public/grants/active":{post:{operationId:"grantsActive",summary:"List active grants (read)",responses:{200:{description:"ok"}}}},"/public/grants/get":{post:{operationId:"grantsGet",summary:"Get a grant by id (read)",responses:{200:{description:"ok"}}}}}}}async function W({printOnly:e=!1}={}){let r=Ne(),t=ie.join(g(),".config","oracle","connectors","chatgpt-openapi.json"),i=JSON.stringify(r,null,2)+`
+`;e||(Le.mkdirSync(ie.dirname(t),{recursive:!0}),R(t,i));let n=[H,"","Next steps:","  1. oracle public serve","  2. Expose 127.0.0.1:8799 through YOUR HTTPS tunnel (cloudflared, tailscale funnel, etc.).","     Oracle will not create tunnels for you.","  3. Paste the OpenAPI spec into a GPT Action, or add the tunnel URL as a developer-mode MCP connector.",e?"":`  Spec written to: ${t}`].filter(Boolean).join(`
+`);return{ok:!0,...m(e?"printed":"written",{path:t,print:r,instructions:n,cannotSign:H})}}import B from"node:path";import ce from"node:os";function Ue(){return process.platform==="darwin"?B.join(ce.homedir(),"Library","Application Support","Cursor","User","globalStorage","mcp.json"):process.platform==="win32"?B.join(ce.homedir(),"AppData","Roaming","Cursor","User","globalStorage","mcp.json"):B.join(g(),".config","cursor","mcp.json")}async function G({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:n=!1,cwd:o=process.cwd()}){let s=k({oracleRoot:e,operator:r,withControl:t});if(!s.ok)return{ok:!1,code:3,reason:s.reason};if(n)return{ok:!0,printText:['Add this to your Cursor MCP config (Cmd+Shift+P \u2192 "MCP: Open Configuration"):',JSON.stringify({mcpServers:s.specs},null,2)].join(`
 
-`)};let p=le(),c=g(p,o.specs);return{ok:!0,...f(c.status,{path:p,backup:c.backup})}}import O from"node:path";import V from"node:os";function fe(){return process.platform==="darwin"?O.join(V.homedir(),"Library","Application Support","Code","User","globalStorage","mcp.json"):process.platform==="win32"?O.join(V.homedir(),"AppData","Roaming","Code","User","globalStorage","mcp.json"):O.join(d(),".config","Code","User","globalStorage","mcp.json")}function de(e){return O.join(e||process.cwd(),".vscode","mcp.json")}async function J({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:s=!1,cwd:a=process.cwd()}){let o=m({oracleRoot:e,operator:r,withControl:t});if(!o.ok)return{ok:!1,code:3,reason:o.reason};if(s)return{ok:!0,printText:["Add this to your VS Code MCP config (.vscode/mcp.json):",JSON.stringify({mcpServers:o.specs},null,2),"","Alternatively, add to VS Code settings.json:",`"mcp.servers": ${JSON.stringify(o.specs,null,2)}`].join(`
-`)};let p=i?de(a):fe(),c=g(p,o.specs);return{ok:!0,...f(c.status,{path:p,backup:c.backup})}}function x(){process.stderr.write(`usage: oracle mcp <install|print> [target] [flags]
+`)};let c=Ue(),d=b(c,s.specs);return{ok:!0,...m(d.status,{path:c,backup:d.backup})}}import A from"node:path";import ae from"node:os";function Pe(){return process.platform==="darwin"?A.join(ae.homedir(),"Library","Application Support","Code","User","globalStorage","mcp.json"):process.platform==="win32"?A.join(ae.homedir(),"AppData","Roaming","Code","User","globalStorage","mcp.json"):A.join(g(),".config","Code","User","globalStorage","mcp.json")}function $e(e){return A.join(e||process.cwd(),".vscode","mcp.json")}async function K({oracleRoot:e,operator:r,withControl:t=!1,project:i=!1,printOnly:n=!1,cwd:o=process.cwd()}){let s=k({oracleRoot:e,operator:r,withControl:t});if(!s.ok)return{ok:!1,code:3,reason:s.reason};if(n)return{ok:!0,printText:["Add this to your VS Code MCP config (.vscode/mcp.json):",JSON.stringify({mcpServers:s.specs},null,2),"","Alternatively, add to VS Code settings.json:",`"mcp.servers": ${JSON.stringify(s.specs,null,2)}`].join(`
+`)};let c=i?$e(o):Pe(),d=b(c,s.specs);return{ok:!0,...m(d.status,{path:c,backup:d.backup})}}import{readFileSync as N,existsSync as v,writeFileSync as L,mkdirSync as ue}from"node:fs";import{join as y,dirname as Te}from"node:path";import{homedir as pe}from"node:os";var De=y(Te(new URL(import.meta.url).pathname),"..","..","..","profiles","oracle","SOUL.md");function Ie(){let e=[De,y(pe(),".config","oracle","SOUL.md")];for(let r of e)if(v(r))return N(r,"utf8");throw new Error("SOUL.md not found \u2014 run 'oracle bootstrap' first")}async function le(e,{cwd:r=process.cwd(),printOnly:t=!1}={}){let i=Ie();if(e==="claude-code"||e==="claude"){let n=y(r,"CLAUDE.md"),o=v(n)?N(n,"utf8"):"",s=`# Oracle Agent Instructions
+${i}
+---
+${o}`;if(t)return{ok:!0,printText:`# Would write to ${n}:
+
+${s.slice(0,500)}...`,status:"printed"};let c=S(n);return L(n,s,"utf8"),{ok:!0,path:n,backup:c,status:"installed"}}if(e==="cursor"){let n=y(r,".cursorrules"),o=v(n)?N(n,"utf8"):"",s=`# Oracle Agent Instructions
+${i}
+---
+${o}`;if(t)return{ok:!0,printText:`# Would write to ${n}:
+
+${s.slice(0,500)}...`,status:"printed"};let c=S(n);return L(n,s,"utf8"),{ok:!0,path:n,backup:c,status:"installed"}}if(e==="claude-desktop"){let n=y(pe(),"Library","Application Support","Claude","claude_desktop_config.json");if(!v(n))return{ok:!1,reason:"Claude Desktop config not found. Open Claude Desktop once first, then retry."};let o=D(n);if(t)return{ok:!0,printText:`# Would add Oracle SOUL to Claude Desktop custom instructions
+
+${i.slice(0,500)}...`,status:"printed"};let s=S(n);return o.customInstructions=o.customInstructions||"",o.customInstructions=`# Oracle Agent Instructions
+${i}
+---
+${o.customInstructions}`,I(n,o),{ok:!0,path:n,backup:s,status:"installed"}}if(e==="codex"||e==="copilot"){let n=y(r,".github"),o=y(n,"copilot-instructions.md"),s=v(o)?N(o,"utf8"):"";if(t)return{ok:!0,printText:`# Would write to ${o}:
+
+${i.slice(0,500)}...`,status:"printed"};v(n)||ue(n,{recursive:!0});let c=S(o);return L(o,`${i}
+---
+${s}`,"utf8"),{ok:!0,path:o,backup:c,status:"installed"}}if(e==="vscode"||e==="vs-code"){let n=y(r,".vscode"),o=y(n,"instructions.md");if(t)return{ok:!0,printText:`# Would write to ${o}:
+
+${i.slice(0,500)}...`,status:"printed"};v(n)||ue(n,{recursive:!0});let s=S(o);return L(o,`${i}
+`,"utf8"),{ok:!0,path:o,backup:s,status:"installed"}}return{ok:!1,reason:`--with-soul not supported for target '${e}'`}}function U(){process.stderr.write(`usage: oracle mcp <install|print> [target] [flags]
   targets: claude-code | claude-desktop | codex | copilot | chatgpt | cursor | vscode | generic
-  flags:   --with-control --project --print --json
-`)}function b(e,{json:r=!1}={}){if(e.print&&!e.instructions?process.stdout.write(JSON.stringify(e.print,null,2)+`
+  flags:   --with-control --with-soul --project --print --json
+`)}function C(e,{json:r=!1}={}){if(e.print&&!e.instructions?process.stdout.write(JSON.stringify(e.print,null,2)+`
 `):e.printText&&process.stdout.write(e.printText),e.instructions&&(process.stdout.write(e.instructions+`
 `),e.print&&r&&process.stdout.write(JSON.stringify(e.print,null,2)+`
 `)),!e.print&&!e.printText&&!e.instructions){let t={status:e.status,path:e.path||null,backup:e.backup||null,method:e.method||null};process.stdout.write((r?JSON.stringify(t,null,2):`${t.status}${t.path?" "+t.path:""}`)+`
-`)}}var fr={name:"mcp",summary:"wire Oracle into AI clients",group:"read",usage:"oracle mcp install <target> | oracle mcp print [--target <t>]",async run(e){let r=e.argv[0];if(!r||r==="--help"||r==="-h")return x(),r?0:1;let t,i;try{({values:t,positionals:i}=me({args:e.argv.slice(1),options:{"with-control":{type:"boolean",default:!1},project:{type:"boolean",default:!1},print:{type:"boolean",default:!1},json:{type:"boolean",default:!1},target:{type:"string"}},allowPositionals:!0,strict:!1}))}catch(n){return process.stderr.write(`oracle mcp: ${n.message}
-`),x(),1}let s=!!t["with-control"],a=!!t.project,o=!!t.json,p=e.resolveOperator?e.resolveOperator():{ok:!1};if(s&&(!p||!p.ok))return y(process.stderr),3;let c={oracleRoot:e.root,operator:p,withControl:s,project:a,cwd:process.cwd()};if(r==="print"){let n=t.target||i[0]||"claude-code";if(n==="generic"||n==="claude-code"){let l=m(c);return l.ok?(process.stdout.write(JSON.stringify({mcpServers:l.specs},null,2)+`
-`),0):(y(process.stderr),3)}if(n==="chatgpt"){let l=await R({printOnly:!0});return b(l,{json:o}),0}return n==="codex"||n==="copilot"?(b(await A({...c,printOnly:!0}),{json:o}),0):n==="claude-desktop"?(b(await P({...c,printOnly:!0}),{json:o}),0):n==="cursor"?(b(await T({...c,printOnly:!0}),{json:o}),0):n==="vscode"||n==="vs-code"?(b(await J({...c,printOnly:!0}),{json:o}),0):(process.stderr.write(`oracle mcp: unknown target '${n}'
-`),1)}if(r==="install"){let n=i[0]||t.target;if(!n)return x(),1;let l=!!t.print,u;if(n==="claude-code")u=await L({...c,printOnly:l});else if(n==="claude-desktop")u=await P({...c,printOnly:l});else if(n==="codex"||n==="copilot")u=await A({...c,printOnly:l});else if(n==="chatgpt")u=await R({printOnly:l});else if(n==="cursor")u=await T({...c,printOnly:l});else if(n==="vscode"||n==="vs-code")u=await J({...c,printOnly:l});else if(n==="generic"){let S=m(c);return S.ok?(process.stdout.write(JSON.stringify({mcpServers:S.specs},null,2)+`
-`),0):(y(process.stderr),3)}else return process.stderr.write(`oracle mcp: unknown target '${n}'
-`),1;return u.ok?(b(u,{json:o}),u.status&&String(u.status).startsWith("printed")&&u.print&&process.stdout.write(JSON.stringify(u.print,null,2)+`
-`),0):(u.code===3?y(process.stderr):process.stderr.write(`oracle mcp: ${u.reason||"failed"}
-`),u.code||1)}return x(),1}};export{fr as default};
+`)}}var Gt={name:"mcp",summary:"wire Oracle into AI clients",group:"read",usage:"oracle mcp install <target> [--with-control] [--with-soul] | oracle mcp print [--target <t>] | oracle mcp watchdog [--once]",async run(e){let r=e.argv[0];if(!r||r==="--help"||r==="-h")return U(),r?0:1;if(r==="watchdog"){let{spawn:a}=await import("node:child_process"),f=await import("node:path"),p=e.argv.includes("--once"),w=f.join(e.root,"bin","oracle-mcp-watchdog.mjs");return a(process.execPath,[w,...p?["--once"]:[]],{stdio:"inherit",detached:!0}).unref(),0}let t,i;try{({values:t,positionals:i}=Fe({args:e.argv.slice(1),options:{"with-control":{type:"boolean",default:!1},"with-soul":{type:"boolean",default:!1},project:{type:"boolean",default:!1},print:{type:"boolean",default:!1},json:{type:"boolean",default:!1},target:{type:"string"}},allowPositionals:!0,strict:!1}))}catch(a){return process.stderr.write(`oracle mcp: ${a.message}
+`),U(),1}let n=!!t["with-control"],o=!!t["with-soul"],s=!!t.project,c=!!t.json,d=e.resolveOperator?e.resolveOperator():{ok:!1};if(n&&(!d||!d.ok))return _(process.stderr),3;let l={oracleRoot:e.root,operator:d,withControl:n,project:s,cwd:process.cwd()};if(r==="print"){let a=t.target||i[0]||"claude-code";if(a==="generic"||a==="claude-code"){let f=k(l);return f.ok?(process.stdout.write(JSON.stringify({mcpServers:f.specs},null,2)+`
+`),0):(_(process.stderr),3)}if(a==="chatgpt"){let f=await W({printOnly:!0});return C(f,{json:c}),0}return a==="codex"||a==="copilot"?(C(await M({...l,printOnly:!0}),{json:c}),0):a==="claude-desktop"?(C(await J({...l,printOnly:!0}),{json:c}),0):a==="cursor"?(C(await G({...l,printOnly:!0}),{json:c}),0):a==="vscode"||a==="vs-code"?(C(await K({...l,printOnly:!0}),{json:c}),0):(process.stderr.write(`oracle mcp: unknown target '${a}'
+`),1)}if(r==="install"){let a=i[0]||t.target;if(!a)return U(),1;let f=!!t.print,p;if(a==="claude-code")p=await te({...l,printOnly:f});else if(a==="claude-desktop")p=await J({...l,printOnly:f});else if(a==="codex"||a==="copilot")p=await M({...l,printOnly:f});else if(a==="chatgpt")p=await W({printOnly:f});else if(a==="cursor")p=await G({...l,printOnly:f});else if(a==="vscode"||a==="vs-code")p=await K({...l,printOnly:f});else if(a==="generic"){let w=k(l);return w.ok?(process.stdout.write(JSON.stringify({mcpServers:w.specs},null,2)+`
+`),0):(_(process.stderr),3)}else return process.stderr.write(`oracle mcp: unknown target '${a}'
+`),1;if(!p.ok)return p.code===3?_(process.stderr):process.stderr.write(`oracle mcp: ${p.reason||"failed"}
+`),p.code||1;if(C(p,{json:c}),o){let w=await le(a,{cwd:process.cwd(),printOnly:f});w.ok?process.stderr.write(`  soul \u2192 ${w.path||"injected"}
+`):process.stderr.write(`  soul: ${w.reason||"failed"}
+`)}return p.status&&String(p.status).startsWith("printed")&&p.print&&process.stdout.write(JSON.stringify(p.print,null,2)+`
+`),0}return U(),1}};export{Gt as default};