@oracle-agent/oracle 0.13.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (629) hide show
  1. package/CONTRIBUTING.md +99 -0
  2. package/README.md +531 -13
  3. package/SECURITY.md +112 -0
  4. package/SETUP.md +317 -0
  5. package/artifacts/inscription/oracle-was-here-preview.png +0 -0
  6. package/artifacts/inscription/oracle-was-here.svg +1 -0
  7. package/artifacts/specialist-packs/oracle-full-crypto.json +298 -0
  8. package/bin/desk-server.mjs +473 -0
  9. package/bin/oracle-data-mcp.mjs +1252 -0
  10. package/bin/oracle-equities.mjs +168 -0
  11. package/bin/oracle-init.mjs +525 -0
  12. package/bin/oracle-public-server.mjs +36 -0
  13. package/bin/oracle-route.mjs +254 -0
  14. package/bin/oracle-scan.mjs +192 -0
  15. package/bin/oracle-upgrade.mjs +42 -0
  16. package/bin/oracle.mjs +28 -19
  17. package/docs/adding-a-chain.md +229 -0
  18. package/docs/architecture.md +139 -0
  19. package/docs/buzz-integration.md +115 -0
  20. package/docs/cli.md +143 -0
  21. package/docs/connectors.md +13 -0
  22. package/docs/hyperliquid-builder-code.md +50 -0
  23. package/docs/locals-only-fee-waiver.md +34 -0
  24. package/docs/oracle-pack-standard.md +29 -0
  25. package/docs/profiles.md +151 -0
  26. package/docs/public-surface.md +206 -0
  27. package/examples/add-a-chain.mjs +65 -0
  28. package/examples/oracle-pack-template.mjs +38 -0
  29. package/examples/research-a-token.mjs +70 -0
  30. package/package.json +110 -14
  31. package/plugins/oracle-owner-gate/__init__.py +288 -0
  32. package/plugins/oracle-owner-gate/plugin.yaml +9 -0
  33. package/profiles/_template/SOUL.md +54 -0
  34. package/profiles/_template/profile.json +22 -0
  35. package/profiles/bitcoin-agent/SOUL.md +31 -0
  36. package/profiles/bitcoin-agent/profile.json +32 -0
  37. package/profiles/hyperliquid-agent/SOUL.md +34 -0
  38. package/profiles/hyperliquid-agent/profile.json +38 -0
  39. package/profiles/oracle/SOUL.md +120 -0
  40. package/profiles/oracle/profile.json +40 -0
  41. package/profiles/polymarket-agent/SOUL.md +35 -0
  42. package/profiles/polymarket-agent/profile.json +34 -0
  43. package/profiles/profile.schema.json +90 -0
  44. package/profiles/protocol-builder/SOUL.md +57 -0
  45. package/profiles/protocol-builder/profile.json +39 -0
  46. package/profiles/robinhood-agent/SOUL.md +53 -0
  47. package/profiles/robinhood-agent/profile.json +41 -0
  48. package/profiles/solana-agent/SOUL.md +37 -0
  49. package/profiles/solana-agent/profile.json +38 -0
  50. package/profiles/stable-agent/SOUL.md +43 -0
  51. package/profiles/stable-agent/profile.json +38 -0
  52. package/protocols/templates/safe-erc20/SECURITY.md +16 -0
  53. package/protocols/templates/safe-erc20/foundry.toml +12 -0
  54. package/protocols/templates/safe-erc20/remappings.txt +2 -0
  55. package/protocols/templates/safe-erc20/src/SafeERC20.sol +53 -0
  56. package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +72 -0
  57. package/public/agent-connect/app.js +84 -0
  58. package/public/agent-connect/index.html +83 -0
  59. package/public/agent-connect/styles.css +70 -0
  60. package/public/index.html +12 -0
  61. package/public/oracle-console/app.js +272 -0
  62. package/public/oracle-console/bitcoin-wallets.js +206 -0
  63. package/public/oracle-console/index.html +91 -0
  64. package/public/oracle-console/styles.css +239 -0
  65. package/public/oracle-splash/_variants/ice.html +2073 -0
  66. package/public/oracle-splash/_variants/ivory.html +2075 -0
  67. package/public/oracle-splash/assets/agents/claude.png +0 -0
  68. package/public/oracle-splash/assets/agents/codex.png +0 -0
  69. package/public/oracle-splash/assets/cli-chain-hyperliquid.jpg +0 -0
  70. package/public/oracle-splash/assets/desktop-app.jpg +0 -0
  71. package/public/oracle-splash/assets/hero/cli-session-poster.jpg +0 -0
  72. package/public/oracle-splash/assets/hero/cli-session.mp4 +0 -0
  73. package/public/oracle-splash/assets/hero/cli-session.webm +0 -0
  74. package/public/oracle-splash/assets/hero/orb-poster.jpg +0 -0
  75. package/public/oracle-splash/assets/hero/orb.avif +0 -0
  76. package/public/oracle-splash/assets/hero/orb.webm +0 -0
  77. package/public/oracle-splash/assets/hero/risk-session-poster.jpg +0 -0
  78. package/public/oracle-splash/assets/hero/risk-session.mp4 +0 -0
  79. package/public/oracle-splash/assets/hero/risk-session.webm +0 -0
  80. package/public/oracle-splash/assets/hero/route-session-poster.jpg +0 -0
  81. package/public/oracle-splash/assets/hero/route-session.mp4 +0 -0
  82. package/public/oracle-splash/assets/hero/route-session.webm +0 -0
  83. package/public/oracle-splash/assets/llms/claude.svg +1 -0
  84. package/public/oracle-splash/assets/llms/codex-icon.svg +1 -0
  85. package/public/oracle-splash/assets/llms/codex.svg +1 -0
  86. package/public/oracle-splash/assets/llms/cursor-icon.svg +12 -0
  87. package/public/oracle-splash/assets/llms/cursor.svg +17 -0
  88. package/public/oracle-splash/assets/llms/deepseek.svg +1 -0
  89. package/public/oracle-splash/assets/llms/gemini-icon.svg +1 -0
  90. package/public/oracle-splash/assets/llms/gemini.svg +1 -0
  91. package/public/oracle-splash/assets/llms/grok.svg +8 -0
  92. package/public/oracle-splash/assets/llms/hermes.png +0 -0
  93. package/public/oracle-splash/assets/llms/kimi-icon.svg +1 -0
  94. package/public/oracle-splash/assets/llms/kimi.svg +1 -0
  95. package/public/oracle-splash/assets/llms/manus.svg +18 -0
  96. package/public/oracle-splash/assets/llms/openclaw.svg +22 -0
  97. package/public/oracle-splash/assets/llms/perplexity.svg +1 -0
  98. package/public/oracle-splash/assets/llms/qwen.svg +1 -0
  99. package/public/oracle-splash/assets/llms/windsurf.svg +1 -0
  100. package/public/oracle-splash/assets/protocols/abcdex.png +0 -0
  101. package/public/oracle-splash/assets/protocols/across.png +0 -0
  102. package/public/oracle-splash/assets/protocols/aerodrome.png +0 -0
  103. package/public/oracle-splash/assets/protocols/balancer.png +0 -0
  104. package/public/oracle-splash/assets/protocols/cowswap.png +0 -0
  105. package/public/oracle-splash/assets/protocols/curve.png +0 -0
  106. package/public/oracle-splash/assets/protocols/dreamcash.png +0 -0
  107. package/public/oracle-splash/assets/protocols/felix.png +0 -0
  108. package/public/oracle-splash/assets/protocols/gmx.png +0 -0
  109. package/public/oracle-splash/assets/protocols/hyena.png +0 -0
  110. package/public/oracle-splash/assets/protocols/hyperbeat.png +0 -0
  111. package/public/oracle-splash/assets/protocols/hyperliquid.png +0 -0
  112. package/public/oracle-splash/assets/protocols/hyperswap.png +0 -0
  113. package/public/oracle-splash/assets/protocols/jupiter.png +0 -0
  114. package/public/oracle-splash/assets/protocols/kinetiq.png +0 -0
  115. package/public/oracle-splash/assets/protocols/lfj.png +0 -0
  116. package/public/oracle-splash/assets/protocols/lifi.png +0 -0
  117. package/public/oracle-splash/assets/protocols/magic-eden.png +0 -0
  118. package/public/oracle-splash/assets/protocols/morpho.png +0 -0
  119. package/public/oracle-splash/assets/protocols/odos.png +0 -0
  120. package/public/oracle-splash/assets/protocols/oneinch.png +0 -0
  121. package/public/oracle-splash/assets/protocols/opensea.png +0 -0
  122. package/public/oracle-splash/assets/protocols/pancakeswap.png +0 -0
  123. package/public/oracle-splash/assets/protocols/paragon.png +0 -0
  124. package/public/oracle-splash/assets/protocols/paraswap.png +0 -0
  125. package/public/oracle-splash/assets/protocols/pendle.png +0 -0
  126. package/public/oracle-splash/assets/protocols/polymarket.png +0 -0
  127. package/public/oracle-splash/assets/protocols/quickswap.png +0 -0
  128. package/public/oracle-splash/assets/protocols/relay.png +0 -0
  129. package/public/oracle-splash/assets/protocols/stargate.png +0 -0
  130. package/public/oracle-splash/assets/protocols/tradexyz.png +0 -0
  131. package/public/oracle-splash/assets/protocols/uniswap.png +0 -0
  132. package/public/oracle-splash/assets/protocols/velodrome.png +0 -0
  133. package/public/oracle-splash/assets/protocols/ventuals.png +0 -0
  134. package/public/oracle-splash/assets/wordmarks/across-icon.webp +0 -0
  135. package/public/oracle-splash/assets/wordmarks/across.svg +4 -0
  136. package/public/oracle-splash/assets/wordmarks/aerodrome.svg +23 -0
  137. package/public/oracle-splash/assets/wordmarks/balancer.svg +3 -0
  138. package/public/oracle-splash/assets/wordmarks/cowswap.svg +1 -0
  139. package/public/oracle-splash/assets/wordmarks/curve.png +0 -0
  140. package/public/oracle-splash/assets/wordmarks/gmx.svg +13 -0
  141. package/public/oracle-splash/assets/wordmarks/hop-icon.webp +0 -0
  142. package/public/oracle-splash/assets/wordmarks/hyena.svg +7 -0
  143. package/public/oracle-splash/assets/wordmarks/hyperliquid.svg +21 -0
  144. package/public/oracle-splash/assets/wordmarks/hyperswap.svg +13 -0
  145. package/public/oracle-splash/assets/wordmarks/jupiter.svg +35 -0
  146. package/public/oracle-splash/assets/wordmarks/kinetiq.svg +1 -0
  147. package/public/oracle-splash/assets/wordmarks/lfj.webp +0 -0
  148. package/public/oracle-splash/assets/wordmarks/lifi.png +0 -0
  149. package/public/oracle-splash/assets/wordmarks/magic-eden.svg +1 -0
  150. package/public/oracle-splash/assets/wordmarks/markets.svg +1 -0
  151. package/public/oracle-splash/assets/wordmarks/morpho.svg +1 -0
  152. package/public/oracle-splash/assets/wordmarks/odos.svg +3 -0
  153. package/public/oracle-splash/assets/wordmarks/oneinch-icon.webp +0 -0
  154. package/public/oracle-splash/assets/wordmarks/oneinch.svg +6 -0
  155. package/public/oracle-splash/assets/wordmarks/opensea-icon.svg +17 -0
  156. package/public/oracle-splash/assets/wordmarks/opensea.svg +1 -0
  157. package/public/oracle-splash/assets/wordmarks/outcome.svg +16 -0
  158. package/public/oracle-splash/assets/wordmarks/pancakeswap.svg +18 -0
  159. package/public/oracle-splash/assets/wordmarks/paragon.svg +9 -0
  160. package/public/oracle-splash/assets/wordmarks/paraswap.svg +16 -0
  161. package/public/oracle-splash/assets/wordmarks/pendle.png +0 -0
  162. package/public/oracle-splash/assets/wordmarks/polymarket.png +0 -0
  163. package/public/oracle-splash/assets/wordmarks/quickswap.png +0 -0
  164. package/public/oracle-splash/assets/wordmarks/relay.svg +8 -0
  165. package/public/oracle-splash/assets/wordmarks/satflow-icon.png +0 -0
  166. package/public/oracle-splash/assets/wordmarks/stargate-icon.webp +0 -0
  167. package/public/oracle-splash/assets/wordmarks/stargate.svg +15 -0
  168. package/public/oracle-splash/assets/wordmarks/uniswap.svg +18 -0
  169. package/public/oracle-splash/assets/wordmarks/velodrome.svg +84 -0
  170. package/public/oracle-splash/assets/wordmarks/xyz.svg +12 -0
  171. package/public/oracle-splash/assets/wordmarks/zerox-icon.webp +0 -0
  172. package/public/oracle-splash/brand/aave.webp +0 -0
  173. package/public/oracle-splash/brand/aavev2.webp +0 -0
  174. package/public/oracle-splash/brand/aborean.webp +0 -0
  175. package/public/oracle-splash/brand/across.webp +0 -0
  176. package/public/oracle-splash/brand/aerodrome.webp +0 -0
  177. package/public/oracle-splash/brand/afi.webp +0 -0
  178. package/public/oracle-splash/brand/arcus.webp +0 -0
  179. package/public/oracle-splash/brand/aster.webp +0 -0
  180. package/public/oracle-splash/brand/avant.webp +0 -0
  181. package/public/oracle-splash/brand/balancer.webp +0 -0
  182. package/public/oracle-splash/brand/beefy.webp +0 -0
  183. package/public/oracle-splash/brand/benqi.webp +0 -0
  184. package/public/oracle-splash/brand/bestinslot.ico +0 -0
  185. package/public/oracle-splash/brand/bitfi.webp +0 -0
  186. package/public/oracle-splash/brand/bonkswap.webp +0 -0
  187. package/public/oracle-splash/brand/bouncebit.webp +0 -0
  188. package/public/oracle-splash/brand/camelot.webp +0 -0
  189. package/public/oracle-splash/brand/compound.webp +0 -0
  190. package/public/oracle-splash/brand/concrete.webp +0 -0
  191. package/public/oracle-splash/brand/cow.webp +0 -0
  192. package/public/oracle-splash/brand/curve.webp +0 -0
  193. package/public/oracle-splash/brand/derive.webp +0 -0
  194. package/public/oracle-splash/brand/dolomite.webp +0 -0
  195. package/public/oracle-splash/brand/eigenlayer.webp +0 -0
  196. package/public/oracle-splash/brand/ekubo.webp +0 -0
  197. package/public/oracle-splash/brand/ethena.webp +0 -0
  198. package/public/oracle-splash/brand/etherfi.webp +0 -0
  199. package/public/oracle-splash/brand/etherfiborrow.webp +0 -0
  200. package/public/oracle-splash/brand/felix.webp +0 -0
  201. package/public/oracle-splash/brand/fluid.webp +0 -0
  202. package/public/oracle-splash/brand/fluxbeam.webp +0 -0
  203. package/public/oracle-splash/brand/folks.webp +0 -0
  204. package/public/oracle-splash/brand/fortyacres.webp +0 -0
  205. package/public/oracle-splash/brand/gainsnetwork.webp +0 -0
  206. package/public/oracle-splash/brand/gassss.webp +0 -0
  207. package/public/oracle-splash/brand/gmx.webp +0 -0
  208. package/public/oracle-splash/brand/harmonix.webp +0 -0
  209. package/public/oracle-splash/brand/hlorderbook.webp +0 -0
  210. package/public/oracle-splash/brand/hlp.webp +0 -0
  211. package/public/oracle-splash/brand/hop.webp +0 -0
  212. package/public/oracle-splash/brand/hyperbeat.webp +0 -0
  213. package/public/oracle-splash/brand/hyperlend.webp +0 -0
  214. package/public/oracle-splash/brand/hyperliquid.webp +0 -0
  215. package/public/oracle-splash/brand/hyperliquidhpl.webp +0 -0
  216. package/public/oracle-splash/brand/hyperliquidspot.webp +0 -0
  217. package/public/oracle-splash/brand/hyperswap.webp +0 -0
  218. package/public/oracle-splash/brand/hypha.webp +0 -0
  219. package/public/oracle-splash/brand/joedex.webp +0 -0
  220. package/public/oracle-splash/brand/jupiter.webp +0 -0
  221. package/public/oracle-splash/brand/kelp.webp +0 -0
  222. package/public/oracle-splash/brand/kinetiq.webp +0 -0
  223. package/public/oracle-splash/brand/kmhype.webp +0 -0
  224. package/public/oracle-splash/brand/kona.webp +0 -0
  225. package/public/oracle-splash/brand/konalend.webp +0 -0
  226. package/public/oracle-splash/brand/lfj.webp +0 -0
  227. package/public/oracle-splash/brand/lido.webp +0 -0
  228. package/public/oracle-splash/brand/lifi.webp +0 -0
  229. package/public/oracle-splash/brand/lighter.webp +0 -0
  230. package/public/oracle-splash/brand/lista.webp +0 -0
  231. package/public/oracle-splash/brand/loopedhype.webp +0 -0
  232. package/public/oracle-splash/brand/lorenzo.webp +0 -0
  233. package/public/oracle-splash/brand/magic-eden.webp +0 -0
  234. package/public/oracle-splash/brand/magiceden.webp +0 -0
  235. package/public/oracle-splash/brand/mempool.png +0 -0
  236. package/public/oracle-splash/brand/meteora.webp +0 -0
  237. package/public/oracle-splash/brand/morpho.webp +0 -0
  238. package/public/oracle-splash/brand/myriad.webp +0 -0
  239. package/public/oracle-splash/brand/noxa.webp +0 -0
  240. package/public/oracle-splash/brand/odos.webp +0 -0
  241. package/public/oracle-splash/brand/oneinch.webp +0 -0
  242. package/public/oracle-splash/brand/openbook.webp +0 -0
  243. package/public/oracle-splash/brand/opensea.webp +0 -0
  244. package/public/oracle-splash/brand/orca.webp +0 -0
  245. package/public/oracle-splash/brand/ordinals.png +0 -0
  246. package/public/oracle-splash/brand/ostium.webp +0 -0
  247. package/public/oracle-splash/brand/pancakeswap.webp +0 -0
  248. package/public/oracle-splash/brand/pendle.webp +0 -0
  249. package/public/oracle-splash/brand/perena.webp +0 -0
  250. package/public/oracle-splash/brand/pharaoh.webp +0 -0
  251. package/public/oracle-splash/brand/phoenix.webp +0 -0
  252. package/public/oracle-splash/brand/polymarket.webp +0 -0
  253. package/public/oracle-splash/brand/polynomial.webp +0 -0
  254. package/public/oracle-splash/brand/projectx.webp +0 -0
  255. package/public/oracle-splash/brand/pumpfun.webp +0 -0
  256. package/public/oracle-splash/brand/quickswap.webp +0 -0
  257. package/public/oracle-splash/brand/rain.webp +0 -0
  258. package/public/oracle-splash/brand/raydium.webp +0 -0
  259. package/public/oracle-splash/brand/relay.webp +0 -0
  260. package/public/oracle-splash/brand/rocketpool.webp +0 -0
  261. package/public/oracle-splash/brand/saber.webp +0 -0
  262. package/public/oracle-splash/brand/sakuraswap.webp +0 -0
  263. package/public/oracle-splash/brand/sanctum.webp +0 -0
  264. package/public/oracle-splash/brand/satflow.png +0 -0
  265. package/public/oracle-splash/brand/sierra.webp +0 -0
  266. package/public/oracle-splash/brand/sky.webp +0 -0
  267. package/public/oracle-splash/brand/solv.webp +0 -0
  268. package/public/oracle-splash/brand/spark.webp +0 -0
  269. package/public/oracle-splash/brand/sparksavings.webp +0 -0
  270. package/public/oracle-splash/brand/sphere.webp +0 -0
  271. package/public/oracle-splash/brand/ssv.webp +0 -0
  272. package/public/oracle-splash/brand/stabble.webp +0 -0
  273. package/public/oracle-splash/brand/stableswap.webp +0 -0
  274. package/public/oracle-splash/brand/stakewise.webp +0 -0
  275. package/public/oracle-splash/brand/stargate.webp +0 -0
  276. package/public/oracle-splash/brand/sthype.webp +0 -0
  277. package/public/oracle-splash/brand/sushiswap.webp +0 -0
  278. package/public/oracle-splash/brand/unisat.png +0 -0
  279. package/public/oracle-splash/brand/uniswap.webp +0 -0
  280. package/public/oracle-splash/brand/uniswapv2.webp +0 -0
  281. package/public/oracle-splash/brand/uniswapv4.webp +0 -0
  282. package/public/oracle-splash/brand/unit.webp +0 -0
  283. package/public/oracle-splash/brand/velodrome.webp +0 -0
  284. package/public/oracle-splash/brand/velora.webp +0 -0
  285. package/public/oracle-splash/brand/venus.webp +0 -0
  286. package/public/oracle-splash/brand/wbeth.webp +0 -0
  287. package/public/oracle-splash/brand/xsy.webp +0 -0
  288. package/public/oracle-splash/brand/yieldyak.webp +0 -0
  289. package/public/oracle-splash/brand/zerobase.webp +0 -0
  290. package/public/oracle-splash/brand/zerox.webp +0 -0
  291. package/public/oracle-splash/downloads/index.html +52 -0
  292. package/public/oracle-splash/favicon.ico +0 -0
  293. package/public/oracle-splash/favicon.svg +6 -0
  294. package/public/oracle-splash/index.html +2537 -0
  295. package/public/oracle-splash/mesh-graph.png +0 -0
  296. package/public/oracle-splash/mesh-graph.svg +216 -0
  297. package/scripts/adversarial-bench.mjs +114 -0
  298. package/scripts/build-dist.mjs +119 -0
  299. package/scripts/build-inscription.py +230 -0
  300. package/scripts/check-doc-drift.mjs +123 -0
  301. package/scripts/check-test-count.mjs +105 -0
  302. package/scripts/e2e-hl-markets.mjs +21 -0
  303. package/scripts/e2e-hl-perps.mjs +48 -0
  304. package/scripts/e2e-hypercore-staking.mjs +128 -0
  305. package/scripts/e2e-solana-bitcoin.mjs +183 -0
  306. package/scripts/guard-publish.mjs +22 -0
  307. package/scripts/protocol-template-gate.mjs +15 -0
  308. package/scripts/public-api-scan.mjs +23 -0
  309. package/scripts/publish-dist.mjs +67 -0
  310. package/scripts/record-hero-cli.sh +80 -0
  311. package/scripts/secret-scan.mjs +168 -0
  312. package/scripts/smoke-dist-bins.mjs +89 -0
  313. package/scripts/verify-dist.mjs +29 -0
  314. package/scripts/verify-v3-venues.mjs +233 -0
  315. package/skills/balance/SKILL.md +176 -0
  316. package/skills/bitcoin-l1.md +33 -0
  317. package/skills/chain-defi-ecosystem-profiling.md +27 -0
  318. package/skills/evm-contract-research.md +27 -0
  319. package/skills/hyperliquid.md +26 -0
  320. package/skills/multichain-exec-desk.md +33 -0
  321. package/skills/oracle-action-semantics/SKILL.md +40 -0
  322. package/skills/oracle-best-execution/SKILL.md +127 -0
  323. package/skills/oracle-best-execution.md +27 -0
  324. package/skills/oracle-bitcoin/SKILL.md +53 -0
  325. package/skills/oracle-chain-graphs-telegram-cards/SKILL.md +59 -0
  326. package/skills/oracle-chat/SKILL.md +61 -0
  327. package/skills/oracle-chat/chain.SKILL.md +31 -0
  328. package/skills/oracle-chat/setup.SKILL.md +37 -0
  329. package/skills/oracle-circuit-breaker/SKILL.md +51 -0
  330. package/skills/oracle-contract-research/SKILL.md +55 -0
  331. package/skills/oracle-desk/SKILL.md +58 -0
  332. package/skills/oracle-desk.md +27 -0
  333. package/skills/oracle-dex-launch/SKILL.md +38 -0
  334. package/skills/oracle-equities/SKILL.md +62 -0
  335. package/skills/oracle-grants/SKILL.md +69 -0
  336. package/skills/oracle-hypercore-staking/SKILL.md +57 -0
  337. package/skills/oracle-hyperliquid/SKILL.md +56 -0
  338. package/skills/oracle-meme-token-sniper/SKILL.md +73 -0
  339. package/skills/oracle-multichain-nft-launch/SKILL.md +338 -0
  340. package/skills/oracle-multichain-token-launch/SKILL.md +300 -0
  341. package/skills/oracle-nft-gacha-launch/SKILL.md +48 -0
  342. package/skills/oracle-nft-mint-gas-war/SKILL.md +63 -0
  343. package/skills/oracle-polymarket/SKILL.md +60 -0
  344. package/skills/oracle-protocol-builder/SKILL.md +59 -0
  345. package/skills/oracle-protocol-security/SKILL.md +60 -0
  346. package/skills/oracle-public-product/SKILL.md +44 -0
  347. package/skills/oracle-receipts/SKILL.md +52 -0
  348. package/skills/oracle-receipts.md +29 -0
  349. package/skills/oracle-rfq-tokenized-assets/SKILL.md +69 -0
  350. package/skills/oracle-smart-wallet-scanner/SKILL.md +49 -0
  351. package/skills/oracle-solana/SKILL.md +65 -0
  352. package/skills/oracle-solana-nft/SKILL.md +54 -0
  353. package/skills/oracle-token-research/SKILL.md +67 -0
  354. package/skills/solana.md +22 -0
  355. package/skins/oracle.yaml +56 -0
  356. package/src/action-receipts.mjs +265 -0
  357. package/src/action-semantics.mjs +62 -0
  358. package/src/address-book.mjs +208 -0
  359. package/src/agent-auth.mjs +206 -0
  360. package/src/approval-guard.mjs +282 -0
  361. package/src/attestation-secret.mjs +94 -0
  362. package/src/audit-log.mjs +196 -0
  363. package/src/auth/oauth.mjs +672 -0
  364. package/src/auto-slippage.mjs +378 -0
  365. package/src/capability-posture.mjs +125 -0
  366. package/src/cards.mjs +422 -0
  367. package/src/chains.mjs +62 -0
  368. package/src/cli/chain-catalog.mjs +215 -0
  369. package/src/cli/chain-state.mjs +74 -0
  370. package/src/cli/commands/auth.mjs +193 -0
  371. package/src/cli/commands/bootstrap.mjs +87 -0
  372. package/src/cli/commands/chain.mjs +143 -0
  373. package/src/cli/commands/chat.mjs +465 -0
  374. package/src/cli/commands/credential.mjs +9 -0
  375. package/src/cli/commands/data-mcp.mjs +18 -0
  376. package/src/cli/commands/data.mjs +75 -0
  377. package/src/cli/commands/doctor.mjs +136 -0
  378. package/src/cli/commands/equities.mjs +41 -0
  379. package/src/cli/commands/farm.mjs +129 -0
  380. package/src/cli/commands/fees.mjs +109 -0
  381. package/src/cli/commands/follow.mjs +130 -0
  382. package/src/cli/commands/harness.mjs +63 -0
  383. package/src/cli/commands/help.mjs +7 -0
  384. package/src/cli/commands/init.mjs +27 -0
  385. package/src/cli/commands/mcp.mjs +154 -0
  386. package/src/cli/commands/model.mjs +106 -0
  387. package/src/cli/commands/plugins.mjs +241 -0
  388. package/src/cli/commands/prepare.mjs +12 -0
  389. package/src/cli/commands/public.mjs +20 -0
  390. package/src/cli/commands/resolve.mjs +64 -0
  391. package/src/cli/commands/route.mjs +12 -0
  392. package/src/cli/commands/runner.mjs +9 -0
  393. package/src/cli/commands/scan.mjs +12 -0
  394. package/src/cli/commands/setup.mjs +294 -0
  395. package/src/cli/commands/sign.mjs +21 -0
  396. package/src/cli/commands/signer.mjs +9 -0
  397. package/src/cli/commands/swap.mjs +102 -0
  398. package/src/cli/commands/upgrade.mjs +12 -0
  399. package/src/cli/commands/vault.mjs +9 -0
  400. package/src/cli/commands/version.mjs +22 -0
  401. package/src/cli/first-run.mjs +23 -0
  402. package/src/cli/kernel.mjs +262 -0
  403. package/src/cli/mcp-targets/chatgpt.mjs +51 -0
  404. package/src/cli/mcp-targets/claude-code.mjs +39 -0
  405. package/src/cli/mcp-targets/claude-desktop.mjs +24 -0
  406. package/src/cli/mcp-targets/codex.mjs +41 -0
  407. package/src/cli/mcp-targets/cursor.mjs +32 -0
  408. package/src/cli/mcp-targets/shared.mjs +71 -0
  409. package/src/cli/mcp-targets/vscode.mjs +39 -0
  410. package/src/cli/messaging-platforms.mjs +217 -0
  411. package/src/cli/model-config.mjs +78 -0
  412. package/src/cli/operator-dispatch.mjs +257 -0
  413. package/src/cli/oracle-harness.py +415 -0
  414. package/src/cli/paths.mjs +107 -0
  415. package/src/cli/runtime.mjs +351 -0
  416. package/src/cli/setup-state.mjs +168 -0
  417. package/src/cli/spawn-child.mjs +43 -0
  418. package/src/data/catalog.mjs +858 -0
  419. package/src/data/desk-data.mjs +877 -0
  420. package/src/data/http.mjs +253 -0
  421. package/src/data/names.mjs +188 -0
  422. package/src/data/provider-endpoint.mjs +94 -0
  423. package/src/data/providers/aave-v3.mjs +139 -0
  424. package/src/data/providers/across-bridge.mjs +41 -0
  425. package/src/data/providers/aerodrome.mjs +245 -0
  426. package/src/data/providers/aevo.mjs +33 -0
  427. package/src/data/providers/approval-indexer.mjs +133 -0
  428. package/src/data/providers/approvals.mjs +594 -0
  429. package/src/data/providers/babylon-staking.mjs +149 -0
  430. package/src/data/providers/balancer.mjs +209 -0
  431. package/src/data/providers/beefy-yields.mjs +45 -0
  432. package/src/data/providers/birdeye-tokens.mjs +33 -0
  433. package/src/data/providers/bisq-markets.mjs +145 -0
  434. package/src/data/providers/bitcoin-esplora.mjs +216 -0
  435. package/src/data/providers/bitcoin-meta.mjs +378 -0
  436. package/src/data/providers/blockscout.mjs +14 -0
  437. package/src/data/providers/bob-rootstock.mjs +198 -0
  438. package/src/data/providers/braiins-insights.mjs +103 -0
  439. package/src/data/providers/bridge-aggregator.mjs +259 -0
  440. package/src/data/providers/bridges.mjs +242 -0
  441. package/src/data/providers/bungee.mjs +29 -0
  442. package/src/data/providers/celestia-da.mjs +38 -0
  443. package/src/data/providers/changenow.mjs +135 -0
  444. package/src/data/providers/compound.mjs +32 -0
  445. package/src/data/providers/connext.mjs +28 -0
  446. package/src/data/providers/convex.mjs +30 -0
  447. package/src/data/providers/cow-protocol.mjs +110 -0
  448. package/src/data/providers/cowswap.mjs +415 -0
  449. package/src/data/providers/curve.mjs +201 -0
  450. package/src/data/providers/das-assets.mjs +59 -0
  451. package/src/data/providers/debridge.mjs +109 -0
  452. package/src/data/providers/defillama.mjs +88 -0
  453. package/src/data/providers/dexscreener.mjs +43 -0
  454. package/src/data/providers/drift.mjs +32 -0
  455. package/src/data/providers/dydx.mjs +41 -0
  456. package/src/data/providers/evm-rpc.mjs +225 -0
  457. package/src/data/providers/farming.mjs +291 -0
  458. package/src/data/providers/geckoterminal.mjs +34 -0
  459. package/src/data/providers/gmx.mjs +496 -0
  460. package/src/data/providers/hiro-stacks.mjs +150 -0
  461. package/src/data/providers/hl-assets.mjs +165 -0
  462. package/src/data/providers/hl-info.mjs +108 -0
  463. package/src/data/providers/hl-markets.mjs +210 -0
  464. package/src/data/providers/hl-outcome.mjs +61 -0
  465. package/src/data/providers/hl-perps.mjs +419 -0
  466. package/src/data/providers/hl-staking.mjs +353 -0
  467. package/src/data/providers/hl-ws.mjs +119 -0
  468. package/src/data/providers/hyperevm-dex.mjs +49 -0
  469. package/src/data/providers/jito-mev.mjs +117 -0
  470. package/src/data/providers/jupiter-venues.mjs +119 -0
  471. package/src/data/providers/jupiter.mjs +315 -0
  472. package/src/data/providers/kamino-strategies.mjs +143 -0
  473. package/src/data/providers/l2beat-tvl.mjs +42 -0
  474. package/src/data/providers/lifi.mjs +166 -0
  475. package/src/data/providers/liquid-esplora.mjs +152 -0
  476. package/src/data/providers/magiceden-ordinals.mjs +141 -0
  477. package/src/data/providers/magiceden-sol.mjs +406 -0
  478. package/src/data/providers/mempool-lightning.mjs +144 -0
  479. package/src/data/providers/mempool-mining.mjs +142 -0
  480. package/src/data/providers/meteora-dlmm.mjs +168 -0
  481. package/src/data/providers/morpho.mjs +177 -0
  482. package/src/data/providers/nft-gallery.mjs +163 -0
  483. package/src/data/providers/nft-portfolio.mjs +494 -0
  484. package/src/data/providers/odos.mjs +156 -0
  485. package/src/data/providers/ondo.mjs +31 -0
  486. package/src/data/providers/oneinch.mjs +174 -0
  487. package/src/data/providers/opensea-multichain.mjs +136 -0
  488. package/src/data/providers/opensea-nft.mjs +371 -0
  489. package/src/data/providers/orca.mjs +29 -0
  490. package/src/data/providers/ordinals-runes.mjs +180 -0
  491. package/src/data/providers/pancakeswap.mjs +28 -0
  492. package/src/data/providers/paraswap.mjs +125 -0
  493. package/src/data/providers/pendle.mjs +188 -0
  494. package/src/data/providers/poly-clob.mjs +283 -0
  495. package/src/data/providers/poly-public.mjs +96 -0
  496. package/src/data/providers/poly-ws.mjs +103 -0
  497. package/src/data/providers/polygon-staking.mjs +227 -0
  498. package/src/data/providers/portfolio-history.mjs +394 -0
  499. package/src/data/providers/portfolio.mjs +600 -0
  500. package/src/data/providers/pyth-price-feeds.mjs +172 -0
  501. package/src/data/providers/raydium.mjs +35 -0
  502. package/src/data/providers/relayscan-mev.mjs +72 -0
  503. package/src/data/providers/rfq.mjs +15 -0
  504. package/src/data/providers/rh-agent.mjs +59 -0
  505. package/src/data/providers/sanctum-lst.mjs +180 -0
  506. package/src/data/providers/satflow.mjs +341 -0
  507. package/src/data/providers/signed-material-guard.mjs +108 -0
  508. package/src/data/providers/solana-rpc.mjs +197 -0
  509. package/src/data/providers/solend-lending.mjs +166 -0
  510. package/src/data/providers/spark-lend.mjs +42 -0
  511. package/src/data/providers/squid-router.mjs +29 -0
  512. package/src/data/providers/stargate.mjs +29 -0
  513. package/src/data/providers/sushiswap.mjs +30 -0
  514. package/src/data/providers/symbiotic-restaking.mjs +41 -0
  515. package/src/data/providers/thorchain.mjs +36 -0
  516. package/src/data/providers/traderjoe.mjs +28 -0
  517. package/src/data/providers/twap.mjs +152 -0
  518. package/src/data/providers/uniswap-v3.mjs +457 -0
  519. package/src/data/providers/uniswap-v4.mjs +414 -0
  520. package/src/data/providers/vertex.mjs +41 -0
  521. package/src/data/providers/wallet-watch.mjs +264 -0
  522. package/src/data/providers/wormhole.mjs +28 -0
  523. package/src/data/providers/yearn.mjs +31 -0
  524. package/src/data/providers/zerox.mjs +167 -0
  525. package/src/data/public-api-scan.mjs +61 -0
  526. package/src/data/quote-placeholder.mjs +31 -0
  527. package/src/desk/swap-prepare.mjs +194 -0
  528. package/src/equities/bridge.mjs +388 -0
  529. package/src/equities/fixtures/bridge_routes.json +159 -0
  530. package/src/equities/fixtures/dst_transitions.json +29 -0
  531. package/src/equities/fixtures/equity_dex_pools.json +154 -0
  532. package/src/equities/fixtures/hip3_l2books.json +2711 -0
  533. package/src/equities/fixtures/nyse_holidays.json +1 -0
  534. package/src/equities/fixtures/oracles.json +100 -0
  535. package/src/equities/fixtures/rh_pool_state.json +244 -0
  536. package/src/equities/fixtures/solana_xstocks.json +704 -0
  537. package/src/equities/fixtures/ton_xstocks.json +35 -0
  538. package/src/equities/fixtures/universe.json +411 -0
  539. package/src/equities/fixtures/venues.json +3542 -0
  540. package/src/equities/fixtures.mjs +405 -0
  541. package/src/equities/funding.mjs +142 -0
  542. package/src/equities/index.mjs +166 -0
  543. package/src/equities/liveness.mjs +148 -0
  544. package/src/equities/marketHours.mjs +249 -0
  545. package/src/equities/normalize.mjs +295 -0
  546. package/src/equities/num.mjs +146 -0
  547. package/src/equities/prepare.mjs +95 -0
  548. package/src/equities/rank.mjs +260 -0
  549. package/src/equities/sourceNum.mjs +69 -0
  550. package/src/equities/types.mjs +220 -0
  551. package/src/equities/venues/arcus-perp.mjs +84 -0
  552. package/src/equities/venues/arcus-spot.mjs +105 -0
  553. package/src/equities/venues/hyperliquid-hip3.mjs +224 -0
  554. package/src/equities/venues/rh-uniswap.mjs +216 -0
  555. package/src/equities/venues/solana-xstocks.mjs +139 -0
  556. package/src/equities/venues/ton-stonfi.mjs +139 -0
  557. package/src/exact-integer.mjs +72 -0
  558. package/src/exec-policy.mjs +419 -0
  559. package/src/flags.mjs +15 -0
  560. package/src/fresh-window.mjs +76 -0
  561. package/src/gmx-attestation.mjs +176 -0
  562. package/src/index.mjs +107 -0
  563. package/src/licensing/locals-only.mjs +25 -0
  564. package/src/nft-gas-war-guard.mjs +139 -0
  565. package/src/onboarding/agent-keys.mjs +161 -0
  566. package/src/onboarding/harness-configs.mjs +102 -0
  567. package/src/onboarding/index.mjs +18 -0
  568. package/src/onboarding/tiers.mjs +139 -0
  569. package/src/oracle-env.mjs +55 -0
  570. package/src/package-manifest.mjs +42 -0
  571. package/src/plugins/agent-plugin-loader.mjs +225 -0
  572. package/src/portfolio-risk.mjs +170 -0
  573. package/src/prepare-envelope.mjs +204 -0
  574. package/src/profile-upgrade.mjs +277 -0
  575. package/src/protocol-execution.mjs +84 -0
  576. package/src/protocol-templates/gate.mjs +179 -0
  577. package/src/protocol-templates/prepare-deploy.mjs +81 -0
  578. package/src/public-api/agent-grants.mjs +57 -0
  579. package/src/public-api/buzz-integration.mjs +267 -0
  580. package/src/public-api/connect-agent.mjs +424 -0
  581. package/src/public-api/grants.mjs +142 -0
  582. package/src/public-api/http.mjs +707 -0
  583. package/src/public-api/metering.mjs +111 -0
  584. package/src/public-control/aa-adapter.mjs +402 -0
  585. package/src/public-control/build-registry.mjs +227 -0
  586. package/src/public-control/bundler-client.mjs +357 -0
  587. package/src/public-control/grant-indexer.mjs +296 -0
  588. package/src/public-control/policy-render.mjs +69 -0
  589. package/src/public-control/policy-schema.mjs +322 -0
  590. package/src/public-control/runtime-config.mjs +275 -0
  591. package/src/public-control/session-key-model.mjs +379 -0
  592. package/src/public-control/session-orchestrator.mjs +418 -0
  593. package/src/rfq/intent.mjs +180 -0
  594. package/src/rfq/sources.mjs +181 -0
  595. package/src/route-attestation.mjs +132 -0
  596. package/src/router/best-execution.mjs +326 -0
  597. package/src/router/index.mjs +250 -0
  598. package/src/router/integrator-fee.mjs +135 -0
  599. package/src/router/prepare-bridge.mjs +293 -0
  600. package/src/router/prepare-route.mjs +398 -0
  601. package/src/router/proposal.mjs +311 -0
  602. package/src/router/risk-classifier.mjs +119 -0
  603. package/src/router/route-sources.mjs +364 -0
  604. package/src/scanner/chains.config.mjs +543 -0
  605. package/src/scanner/contract.mjs +270 -0
  606. package/src/scanner/evm-scanner.mjs +394 -0
  607. package/src/scanner/index.mjs +9 -0
  608. package/src/scanner/v2-venue.mjs +351 -0
  609. package/src/scanner/v3-venue.mjs +308 -0
  610. package/src/scopes.mjs +44 -0
  611. package/src/sell-simulation.mjs +167 -0
  612. package/src/signals/engine.mjs +146 -0
  613. package/src/signals/index.mjs +1 -0
  614. package/src/token-transfer-guard.mjs +188 -0
  615. package/src/tui/app.mjs +438 -0
  616. package/src/tui/backend.mjs +215 -0
  617. package/src/tui/format.mjs +272 -0
  618. package/src/tui/gateway-client.mjs +177 -0
  619. package/src/tui/input.mjs +501 -0
  620. package/src/tui/memory.mjs +105 -0
  621. package/src/tui/meta-learn.mjs +85 -0
  622. package/src/tui/renderer.mjs +443 -0
  623. package/src/tui/scheduler.mjs +205 -0
  624. package/src/tui/skills-loader.mjs +140 -0
  625. package/src/tui/standalone-client.mjs +752 -0
  626. package/src/tui/theme.mjs +81 -0
  627. package/src/vault-attestation.mjs +146 -0
  628. package/src/venues.mjs +206 -0
  629. package/src/watch-preferences.mjs +85 -0
@@ -0,0 +1,415 @@
1
+ #!/usr/bin/env python3
2
+ import importlib
3
+ import importlib.abc
4
+ import importlib.machinery
5
+ import json
6
+ import os
7
+ import shutil
8
+ import subprocess
9
+ import sys
10
+
11
+
12
+ WORDMARK = (
13
+ " ██████ ████████ ██████ ██████ ░███ ██████ ",
14
+ " ███░░███░░███░░███ ░░░░░███ ███░░███ ░███ ███░░███ ",
15
+ " ░███ ░███ ░███ ░░░ ███████ ░███ ░░░ ░███ ░███████ ",
16
+ " ░███ ░███ ░███ ███░░███ ░███ ███ ░███ ░███░░░ ",
17
+ " ░░██████ █████ ░░████████░░██████ █████░░██████ ",
18
+ " ░░░░░░ ░░░░░ ░░░░░░░░ ░░░░░░ ░░░░░ ░░░░░░ ",
19
+ )
20
+
21
+ SILENT_OUTPUT = {
22
+ "[anthropic_billing_bypass] Bypass installed",
23
+ "[anthropic_billing_bypass] Transport unwrap hook installed",
24
+ }
25
+
26
+
27
+ def _oracle_chain(command):
28
+ node = os.environ.get("ORACLE_NODE_BIN")
29
+ entry = os.environ.get("ORACLE_CLI_ENTRY")
30
+ if not node or not entry:
31
+ return False, "oracle chain is unavailable in this session"
32
+
33
+ parts = command.strip().split()[1:]
34
+ args = parts or ["list"]
35
+ try:
36
+ result = subprocess.run(
37
+ [node, entry, "chain", *args],
38
+ capture_output=True,
39
+ text=True,
40
+ timeout=15,
41
+ check=False,
42
+ )
43
+ except (OSError, subprocess.TimeoutExpired) as exc:
44
+ return False, f"oracle chain failed: {exc}"
45
+
46
+ output = "\n".join(
47
+ part.strip() for part in (result.stdout, result.stderr) if part.strip()
48
+ )
49
+ if result.returncode != 0:
50
+ return False, output or "oracle chain failed"
51
+
52
+ state = subprocess.run(
53
+ [node, entry, "chain", "show", "--json"],
54
+ capture_output=True,
55
+ text=True,
56
+ timeout=15,
57
+ check=False,
58
+ )
59
+ if state.returncode in (0, 1):
60
+ try:
61
+ active = json.loads(state.stdout).get("active") or {}
62
+ if active:
63
+ os.environ["ORACLE_ACTIVE_CHAIN"] = str(active.get("key", ""))
64
+ os.environ["ORACLE_ACTIVE_CHAIN_ID"] = str(active.get("chainId", ""))
65
+ os.environ["ORACLE_ACTIVE_AGENT"] = str(active.get("agent", ""))
66
+ else:
67
+ os.environ.pop("ORACLE_ACTIVE_CHAIN", None)
68
+ os.environ.pop("ORACLE_ACTIVE_CHAIN_ID", None)
69
+ os.environ.pop("ORACLE_ACTIVE_AGENT", None)
70
+ except (TypeError, ValueError):
71
+ pass
72
+ return True, output
73
+
74
+
75
+ class OracleOutput:
76
+ def __init__(self, wrapped):
77
+ self.wrapped = wrapped
78
+
79
+ def write(self, data):
80
+ kept = "".join(
81
+ line
82
+ for line in data.splitlines(keepends=True)
83
+ if line.rstrip("\r\n") not in SILENT_OUTPUT
84
+ )
85
+ kept = kept.replace("hermes model", "oracle model")
86
+ kept = kept.replace("hermes --resume", "oracle --resume")
87
+ kept = kept.replace("hermes -c", "oracle -c")
88
+ kept = kept.replace(" in ~/.hermes/.env", " through oracle model")
89
+ if kept:
90
+ self.wrapped.write(kept)
91
+ return len(data)
92
+
93
+ def flush(self):
94
+ return self.wrapped.flush()
95
+
96
+ def __getattr__(self, name):
97
+ return getattr(self.wrapped, name)
98
+
99
+
100
+ def patch_cli(module):
101
+ cls = getattr(module, "HermesCLI", None)
102
+ if cls is None or getattr(cls, "_oracle_patched", False):
103
+ return
104
+
105
+ original_style = getattr(cls, "_build_tui_style_dict", None)
106
+ original_process_command = cls.process_command
107
+
108
+ def show_banner(self):
109
+ from rich.align import Align
110
+ from rich.console import Group
111
+ from rich.panel import Panel
112
+ from rich.text import Text
113
+ from rich import box
114
+
115
+ self.console.clear()
116
+ width = shutil.get_terminal_size((100, 28)).columns
117
+
118
+ panel_width = max(36, min(width - 4, 76))
119
+ panel_left = (width - panel_width) // 2
120
+ content_left = panel_left + 3
121
+ inner = panel_width - 6
122
+
123
+ def pad_for(ink_width, ink_offset=0):
124
+ target = int(round((width - ink_width) / 2.0))
125
+ pad = target - ink_offset - content_left
126
+ return max(0, min(max(0, inner - ink_width - ink_offset), pad))
127
+
128
+ content = []
129
+ tagline = "THE FUTURE IS AGENTIC / by DEMI"
130
+
131
+ if width >= 72:
132
+ colors = (
133
+ "#B8F0FF",
134
+ "#B8F0FF",
135
+ "#ACDEEF",
136
+ "#A5D9EB",
137
+ "#9FCBDD",
138
+ "#B8F0FF",
139
+ )
140
+ span = max(len(row) for row in WORDMARK)
141
+ ink_cols = [
142
+ index
143
+ for index in range(span)
144
+ if any(index < len(row) and row[index] != " " for row in WORDMARK)
145
+ ]
146
+ ink_offset = ink_cols[0]
147
+ ink_width = ink_cols[-1] - ink_cols[0] + 1
148
+ pad = " " * pad_for(ink_width, ink_offset)
149
+ for index, line in enumerate(WORDMARK):
150
+ content.append(
151
+ Text(pad + line.rstrip(), style=f"bold {colors[index]}", no_wrap=True)
152
+ )
153
+ else:
154
+ content.append(Text(" " * pad_for(6) + "oracle", style="bold #B8F0FF"))
155
+
156
+ content.append(Text(""))
157
+ content.append(
158
+ Text(" " * pad_for(len(tagline)) + tagline, style="bold #EAF2F8", no_wrap=True)
159
+ )
160
+
161
+ panel = Panel(
162
+ Group(*content),
163
+ width=panel_width,
164
+ padding=(1, 2),
165
+ border_style="#3B4A56",
166
+ box=box.ROUNDED,
167
+ )
168
+ self.console.print(Align.center(panel))
169
+ self.console.print()
170
+
171
+ def prompt_fragments(self):
172
+ if getattr(self, "_voice_recording", False):
173
+ return [("class:voice-recording", "recording ")]
174
+ if getattr(self, "_voice_processing", False):
175
+ return [("class:voice-processing", "transcribing ")]
176
+ if getattr(self, "_sudo_state", None) or getattr(self, "_secret_state", None):
177
+ return [("class:sudo-prompt", "secure › ")]
178
+ if getattr(self, "_approval_state", None) or getattr(self, "_slash_confirm_state", None):
179
+ return [("class:prompt-working", "confirm › ")]
180
+ if getattr(self, "_clarify_freetext", False):
181
+ return [("class:clarify-selected", "answer › ")]
182
+ if getattr(self, "_clarify_state", None):
183
+ return [("class:prompt-working", "choose › ")]
184
+ if getattr(self, "_command_running", False):
185
+ return [("class:prompt-working", "working ")]
186
+ if getattr(self, "_agent_running", False):
187
+ return [("class:prompt-working", "thinking ")]
188
+ return [("class:prompt", " oracle › ")]
189
+
190
+ def status_fragments(self):
191
+ if not getattr(self, "_status_bar_visible", True) or getattr(self, "_model_picker_state", None):
192
+ return []
193
+ try:
194
+ snapshot = self._get_status_bar_snapshot()
195
+ width = self._get_tui_terminal_width()
196
+ model = snapshot.get("model_short") or "model"
197
+ percent = snapshot.get("context_percent") or 0
198
+ context_tokens = snapshot.get("context_tokens") or 0
199
+ context_length = snapshot.get("context_length") or 0
200
+ context_bar = self._build_context_bar(percent, width=8)
201
+
202
+ def compact_tokens(value):
203
+ if value >= 1_000_000:
204
+ return f"{value / 1_000_000:.1f}M"
205
+ if value >= 1_000:
206
+ return f"{value / 1_000:.0f}K"
207
+ return str(value)
208
+
209
+ usage = f"{compact_tokens(context_tokens)}/{compact_tokens(context_length)} " if context_length else ""
210
+ reasoning_config = getattr(self, "reasoning_config", None) or {}
211
+ if reasoning_config.get("enabled") is False:
212
+ effort = "none"
213
+ else:
214
+ effort = reasoning_config.get("effort") or "default"
215
+ thinking = snapshot.get("prompt_elapsed") or "0s"
216
+ thinking = thinking.replace("⏱ ", "").replace("⏲ ", "")
217
+ chain = os.environ.get("ORACLE_ACTIVE_CHAIN", "").strip()
218
+
219
+ def status_tail():
220
+ fragments = [
221
+ ("class:status-bar-dim", " / "),
222
+ ("class:status-bar-effort", effort),
223
+ ("class:status-bar-dim", " / "),
224
+ ("class:status-bar-time", thinking),
225
+ ]
226
+ if chain:
227
+ fragments.extend(
228
+ [
229
+ ("class:status-bar-dim", " / "),
230
+ ("class:status-bar-chain", chain),
231
+ ]
232
+ )
233
+ fragments.append(("class:status-bar", " "))
234
+ return fragments
235
+
236
+ if width < 48:
237
+ short_bar = self._build_context_bar(percent, width=4)
238
+ return [
239
+ ("class:status-bar", " "),
240
+ ("class:status-bar-context", f"ctx {short_bar} {percent}%"),
241
+ ] + status_tail()
242
+ if width < 70:
243
+ short_bar = self._build_context_bar(percent, width=4)
244
+ return [
245
+ ("class:status-bar", " "),
246
+ ("class:status-bar-context", f"ctx {short_bar} {percent}%"),
247
+ ] + status_tail()
248
+ if width < 92:
249
+ return [
250
+ ("class:status-bar", " "),
251
+ ("class:status-bar-strong", model),
252
+ ("class:status-bar-dim", " / "),
253
+ ("class:status-bar-context", f"ctx {context_bar} {usage}{percent}%"),
254
+ ] + status_tail()
255
+ return [
256
+ ("class:status-bar", " "),
257
+ ("class:status-bar-brand", "oracle"),
258
+ ("class:status-bar-dim", " / "),
259
+ ("class:status-bar-strong", model),
260
+ ("class:status-bar-dim", " / "),
261
+ ("class:status-bar-context", f"ctx {context_bar} {usage}{percent}%"),
262
+ ] + status_tail()
263
+ except Exception:
264
+ return [("class:status-bar-brand", " oracle ")]
265
+
266
+ def layout_children(
267
+ self,
268
+ *,
269
+ sudo_widget,
270
+ secret_widget,
271
+ approval_widget,
272
+ slash_confirm_widget=None,
273
+ clarify_widget,
274
+ model_picker_widget=None,
275
+ spinner_widget=None,
276
+ spacer,
277
+ status_bar,
278
+ input_rule_top,
279
+ image_bar,
280
+ input_area,
281
+ input_rule_bot,
282
+ voice_status_bar,
283
+ completions_menu,
284
+ ):
285
+ from prompt_toolkit.layout.containers import HSplit, VSplit, Window
286
+ from prompt_toolkit.widgets import Frame
287
+ from prompt_toolkit.widgets.base import Border
288
+
289
+ Border.TOP_LEFT = "╭"
290
+ Border.TOP_RIGHT = "╮"
291
+ Border.BOTTOM_LEFT = "╰"
292
+ Border.BOTTOM_RIGHT = "╯"
293
+
294
+ composer = VSplit(
295
+ [
296
+ Window(width=1),
297
+ Frame(
298
+ HSplit([item for item in (image_bar, input_area) if item is not None]),
299
+ style="class:oracle-composer",
300
+ ),
301
+ Window(width=1),
302
+ ]
303
+ )
304
+ return [
305
+ item
306
+ for item in (
307
+ Window(height=0),
308
+ sudo_widget,
309
+ secret_widget,
310
+ approval_widget,
311
+ slash_confirm_widget,
312
+ clarify_widget,
313
+ model_picker_widget,
314
+ spinner_widget,
315
+ spacer,
316
+ composer,
317
+ completions_menu,
318
+ voice_status_bar,
319
+ status_bar,
320
+ )
321
+ if item is not None
322
+ ]
323
+
324
+ def build_style(self):
325
+ style = original_style(self) if original_style else {}
326
+ style.update(
327
+ {
328
+ "frame": "bg:#0B0E11 #EAF2F8",
329
+ "frame.border": "#455867",
330
+ "frame.label": "bold #B8F0FF",
331
+ "oracle-composer": "bg:#0B0E11 #EAF2F8",
332
+ "input-area": "bg:#0B0E11 #EAF2F8",
333
+ "prompt": "bold #B8F0FF",
334
+ "prompt-working": "bold #91C2D7",
335
+ "status-bar": "bg:#11161B #91A2B1",
336
+ "status-bar-brand": "bg:#11161B bold #B8F0FF",
337
+ "status-bar-strong": "bg:#11161B #EAF2F8",
338
+ "status-bar-context": "bg:#11161B #A5D9EB",
339
+ "status-bar-effort": "bg:#11161B #C5B8FF",
340
+ "status-bar-time": "bg:#11161B #91A2B1",
341
+ "status-bar-chain": "bg:#11161B #B8F0FF",
342
+ "status-bar-dim": "bg:#11161B #60717F",
343
+ }
344
+ )
345
+ return style
346
+
347
+ def process_command(self, command):
348
+ parts = command.strip().lower().split(maxsplit=1)
349
+ if parts and parts[0] == "/chain":
350
+ ok, output = _oracle_chain(command)
351
+ prefix = "" if ok else "error: "
352
+ lines = output.splitlines() or [""]
353
+ for index, line in enumerate(lines):
354
+ module._cprint(f"{prefix if index == 0 else ''}{line}")
355
+ return True
356
+ return original_process_command(self, command)
357
+
358
+ setattr(cls, "show_banner", show_banner)
359
+ setattr(cls, "_get_tui_prompt_fragments", prompt_fragments)
360
+ setattr(cls, "_get_status_bar_fragments", status_fragments)
361
+ setattr(cls, "_build_tui_layout_children", layout_children)
362
+ setattr(cls, "_build_tui_style_dict", build_style)
363
+ setattr(cls, "process_command", process_command)
364
+ setattr(cls, "_oracle_patched", True)
365
+
366
+ try:
367
+ tips = importlib.import_module("hermes_cli.tips")
368
+
369
+ def no_tip():
370
+ raise LookupError("oracle quiet startup")
371
+
372
+ setattr(tips, "get_random_tip", no_tip)
373
+ except Exception:
374
+ pass
375
+
376
+
377
+ class OracleLoader(importlib.abc.Loader):
378
+ def __init__(self, wrapped):
379
+ self.wrapped = wrapped
380
+
381
+ def create_module(self, spec):
382
+ if hasattr(self.wrapped, "create_module"):
383
+ return self.wrapped.create_module(spec)
384
+ return None
385
+
386
+ def exec_module(self, module):
387
+ self.wrapped.exec_module(module)
388
+ patch_cli(module)
389
+
390
+
391
+ class OracleFinder(importlib.abc.MetaPathFinder):
392
+ def find_spec(self, fullname, path, target=None):
393
+ if fullname != "cli":
394
+ return None
395
+ try:
396
+ sys.meta_path.remove(self)
397
+ except ValueError:
398
+ pass
399
+ spec = importlib.machinery.PathFinder.find_spec(fullname, path)
400
+ if spec and spec.loader:
401
+ spec.loader = OracleLoader(spec.loader)
402
+ return spec
403
+
404
+
405
+ def main():
406
+ sys.stdout = OracleOutput(sys.stdout)
407
+ sys.stderr = OracleOutput(sys.stderr)
408
+ sys.meta_path.insert(0, OracleFinder())
409
+ from hermes_cli.main import main as hermes_main
410
+
411
+ return hermes_main()
412
+
413
+
414
+ if __name__ == "__main__":
415
+ raise SystemExit(main())
@@ -0,0 +1,107 @@
1
+ import fs from "node:fs";
2
+ import os from "node:os";
3
+ import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+
6
+ const HERE = path.dirname(fileURLToPath(import.meta.url));
7
+ export const PACKAGE_ROOT = path.resolve(HERE, "../..");
8
+
9
+ export function homeDir() {
10
+ return process.env.ORACLE_FAKE_HOME || os.homedir();
11
+ }
12
+
13
+ // In the packaged public desktop the app owns its own config root. Legacy
14
+ // fallbacks that reach into a private operator/desk directory on the host must
15
+ // resolve to the app-owned dir instead, so an operator install on the same
16
+ // machine can never be inherited by the desktop lane.
17
+ export function isPublicDesktop() {
18
+ return process.env.ORACLE_PUBLIC_DESKTOP === "1";
19
+ }
20
+
21
+ export function oracleConfigDir() {
22
+ if (isPublicDesktop()) {
23
+ return process.env.ORACLE_CONFIG_DIR || path.join(homeDir(), ".config", "oracle");
24
+ }
25
+ return path.join(homeDir(), ".config", "oracle");
26
+ }
27
+
28
+ export function oracleExecEnvPath() {
29
+ return path.join(oracleConfigDir(), "exec.env");
30
+ }
31
+
32
+ export function hermesRoot() {
33
+ if (process.env.HERMES_HOME) return path.resolve(process.env.HERMES_HOME);
34
+ return path.join(homeDir(), ".hermes");
35
+ }
36
+
37
+ export function claudeCodeUserConfigPath() {
38
+ return path.join(homeDir(), ".claude.json");
39
+ }
40
+
41
+ export function claudeCodeProjectMcpPath(cwd = process.cwd()) {
42
+ return path.join(cwd, ".mcp.json");
43
+ }
44
+
45
+ export function claudeDesktopConfigPath() {
46
+ if (process.platform === "darwin") {
47
+ return path.join(homeDir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
48
+ }
49
+ return path.join(homeDir(), ".config", "Claude", "claude_desktop_config.json");
50
+ }
51
+
52
+ export function codexConfigPath() {
53
+ return path.join(homeDir(), ".codex", "config.toml");
54
+ }
55
+
56
+ export function chatgptConnectorDir() {
57
+ return path.join(oracleConfigDir(), "connectors");
58
+ }
59
+
60
+ export function chatgptOpenApiPath() {
61
+ return path.join(chatgptConnectorDir(), "chatgpt-openapi.json");
62
+ }
63
+
64
+ export function activeChainPath() {
65
+ return path.join(oracleConfigDir(), "active-chain.json");
66
+ }
67
+
68
+ // Sibling bins move between `bin/` (source tree) and `dist/bin/` (published
69
+ // bundle), and PACKAGE_ROOT is computed from whichever file bundled paths.mjs
70
+ // in. When the kernel is entered through `dist/bin/oracle.mjs`, PACKAGE_ROOT
71
+ // lands on the package root and a fixed `bin/` join points at a directory that
72
+ // does not ship — so `oracle init`, `oracle scan`, `oracle route`, and every
73
+ // other dispatched subcommand died with MODULE_NOT_FOUND for every installer
74
+ // while the standalone `oracle-init` bin worked fine. Check both layouts.
75
+ export function packageBin(name) {
76
+ const candidates = [
77
+ path.join(PACKAGE_ROOT, "bin", name),
78
+ path.join(PACKAGE_ROOT, "dist", "bin", name),
79
+ path.join(PACKAGE_ROOT, "..", "bin", name),
80
+ ];
81
+ return candidates.find((candidate) => fs.existsSync(candidate)) || candidates[0];
82
+ }
83
+
84
+ export function ensureDir(dir) {
85
+ fs.mkdirSync(dir, { recursive: true });
86
+ return dir;
87
+ }
88
+
89
+ export const paths = {
90
+ homeDir,
91
+ isPublicDesktop,
92
+ oracleConfigDir,
93
+ oracleExecEnvPath,
94
+ hermesRoot,
95
+ activeChainPath,
96
+ claudeCodeUserConfigPath,
97
+ claudeCodeProjectMcpPath,
98
+ claudeDesktopConfigPath,
99
+ codexConfigPath,
100
+ chatgptConnectorDir,
101
+ chatgptOpenApiPath,
102
+ packageBin,
103
+ ensureDir,
104
+ PACKAGE_ROOT,
105
+ };
106
+
107
+ export default paths;