@oracle-agent/oracle 0.13.1 → 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 (449) hide show
  1. package/CONTRIBUTING.md +99 -0
  2. package/README.md +20 -14
  3. package/SECURITY.md +6 -8
  4. package/SETUP.md +25 -27
  5. package/bin/desk-server.mjs +473 -0
  6. package/bin/oracle-data-mcp.mjs +1252 -0
  7. package/bin/oracle-equities.mjs +168 -0
  8. package/bin/oracle-init.mjs +525 -0
  9. package/bin/oracle-public-server.mjs +36 -0
  10. package/bin/oracle-route.mjs +254 -0
  11. package/bin/oracle-scan.mjs +192 -0
  12. package/bin/oracle-upgrade.mjs +42 -0
  13. package/bin/oracle.mjs +34 -0
  14. package/docs/adding-a-chain.md +229 -0
  15. package/docs/architecture.md +139 -0
  16. package/docs/buzz-integration.md +115 -0
  17. package/docs/cli.md +143 -0
  18. package/docs/connectors.md +13 -0
  19. package/docs/hyperliquid-builder-code.md +50 -0
  20. package/docs/locals-only-fee-waiver.md +34 -0
  21. package/docs/oracle-pack-standard.md +29 -0
  22. package/docs/profiles.md +151 -0
  23. package/docs/public-surface.md +206 -0
  24. package/examples/add-a-chain.mjs +65 -0
  25. package/examples/oracle-pack-template.mjs +38 -0
  26. package/examples/research-a-token.mjs +70 -0
  27. package/package.json +78 -32
  28. package/plugins/oracle-owner-gate/__init__.py +288 -0
  29. package/plugins/oracle-owner-gate/plugin.yaml +9 -0
  30. package/{dist/assets/profiles → profiles}/oracle/SOUL.md +0 -14
  31. package/protocols/templates/safe-erc20/SECURITY.md +16 -0
  32. package/protocols/templates/safe-erc20/foundry.toml +12 -0
  33. package/protocols/templates/safe-erc20/remappings.txt +2 -0
  34. package/protocols/templates/safe-erc20/src/SafeERC20.sol +53 -0
  35. package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +72 -0
  36. package/public/oracle-splash/_variants/ice.html +3 -3
  37. package/public/oracle-splash/_variants/ivory.html +3 -3
  38. package/public/oracle-splash/downloads/index.html +34 -223
  39. package/public/oracle-splash/index.html +11 -11
  40. package/scripts/adversarial-bench.mjs +114 -0
  41. package/scripts/build-dist.mjs +119 -0
  42. package/scripts/build-inscription.py +230 -0
  43. package/scripts/check-doc-drift.mjs +123 -0
  44. package/scripts/check-test-count.mjs +105 -0
  45. package/scripts/e2e-hl-markets.mjs +21 -0
  46. package/scripts/e2e-hl-perps.mjs +48 -0
  47. package/scripts/e2e-hypercore-staking.mjs +128 -0
  48. package/scripts/e2e-solana-bitcoin.mjs +183 -0
  49. package/scripts/guard-publish.mjs +22 -0
  50. package/scripts/protocol-template-gate.mjs +15 -0
  51. package/scripts/public-api-scan.mjs +23 -0
  52. package/scripts/publish-dist.mjs +67 -0
  53. package/scripts/record-hero-cli.sh +80 -0
  54. package/scripts/secret-scan.mjs +168 -0
  55. package/scripts/smoke-dist-bins.mjs +89 -0
  56. package/scripts/verify-dist.mjs +29 -0
  57. package/scripts/verify-v3-venues.mjs +233 -0
  58. package/skins/oracle.yaml +56 -0
  59. package/src/action-receipts.mjs +265 -0
  60. package/src/action-semantics.mjs +62 -0
  61. package/src/address-book.mjs +208 -0
  62. package/src/agent-auth.mjs +206 -0
  63. package/src/approval-guard.mjs +282 -0
  64. package/src/attestation-secret.mjs +94 -0
  65. package/src/audit-log.mjs +196 -0
  66. package/src/auth/oauth.mjs +672 -0
  67. package/src/auto-slippage.mjs +378 -0
  68. package/src/capability-posture.mjs +125 -0
  69. package/src/cards.mjs +422 -0
  70. package/src/chains.mjs +62 -0
  71. package/src/cli/chain-catalog.mjs +215 -0
  72. package/src/cli/chain-state.mjs +74 -0
  73. package/src/cli/commands/auth.mjs +193 -0
  74. package/src/cli/commands/bootstrap.mjs +87 -0
  75. package/src/cli/commands/chain.mjs +143 -0
  76. package/src/cli/commands/chat.mjs +465 -0
  77. package/src/cli/commands/credential.mjs +9 -0
  78. package/src/cli/commands/data-mcp.mjs +18 -0
  79. package/src/cli/commands/data.mjs +75 -0
  80. package/src/cli/commands/doctor.mjs +136 -0
  81. package/src/cli/commands/equities.mjs +41 -0
  82. package/src/cli/commands/farm.mjs +129 -0
  83. package/src/cli/commands/fees.mjs +109 -0
  84. package/src/cli/commands/follow.mjs +130 -0
  85. package/src/cli/commands/harness.mjs +63 -0
  86. package/src/cli/commands/help.mjs +7 -0
  87. package/src/cli/commands/init.mjs +27 -0
  88. package/src/cli/commands/mcp.mjs +154 -0
  89. package/src/cli/commands/model.mjs +106 -0
  90. package/src/cli/commands/plugins.mjs +241 -0
  91. package/src/cli/commands/prepare.mjs +12 -0
  92. package/src/cli/commands/public.mjs +20 -0
  93. package/src/cli/commands/resolve.mjs +64 -0
  94. package/src/cli/commands/route.mjs +12 -0
  95. package/src/cli/commands/runner.mjs +9 -0
  96. package/src/cli/commands/scan.mjs +12 -0
  97. package/src/cli/commands/setup.mjs +294 -0
  98. package/src/cli/commands/sign.mjs +21 -0
  99. package/src/cli/commands/signer.mjs +9 -0
  100. package/src/cli/commands/swap.mjs +102 -0
  101. package/src/cli/commands/upgrade.mjs +12 -0
  102. package/src/cli/commands/vault.mjs +9 -0
  103. package/src/cli/commands/version.mjs +22 -0
  104. package/src/cli/first-run.mjs +23 -0
  105. package/src/cli/kernel.mjs +262 -0
  106. package/src/cli/mcp-targets/chatgpt.mjs +51 -0
  107. package/src/cli/mcp-targets/claude-code.mjs +39 -0
  108. package/src/cli/mcp-targets/claude-desktop.mjs +24 -0
  109. package/src/cli/mcp-targets/codex.mjs +41 -0
  110. package/src/cli/mcp-targets/cursor.mjs +32 -0
  111. package/src/cli/mcp-targets/shared.mjs +71 -0
  112. package/src/cli/mcp-targets/vscode.mjs +39 -0
  113. package/src/cli/messaging-platforms.mjs +217 -0
  114. package/src/cli/model-config.mjs +78 -0
  115. package/src/cli/operator-dispatch.mjs +257 -0
  116. package/src/cli/oracle-harness.py +415 -0
  117. package/src/cli/paths.mjs +107 -0
  118. package/src/cli/runtime.mjs +351 -0
  119. package/src/cli/setup-state.mjs +168 -0
  120. package/src/cli/spawn-child.mjs +43 -0
  121. package/src/data/catalog.mjs +858 -0
  122. package/src/data/desk-data.mjs +877 -0
  123. package/src/data/http.mjs +253 -0
  124. package/src/data/names.mjs +188 -0
  125. package/src/data/provider-endpoint.mjs +94 -0
  126. package/src/data/providers/aave-v3.mjs +139 -0
  127. package/src/data/providers/across-bridge.mjs +41 -0
  128. package/src/data/providers/aerodrome.mjs +245 -0
  129. package/src/data/providers/aevo.mjs +33 -0
  130. package/src/data/providers/approval-indexer.mjs +133 -0
  131. package/src/data/providers/approvals.mjs +594 -0
  132. package/src/data/providers/babylon-staking.mjs +149 -0
  133. package/src/data/providers/balancer.mjs +209 -0
  134. package/src/data/providers/beefy-yields.mjs +45 -0
  135. package/src/data/providers/birdeye-tokens.mjs +33 -0
  136. package/src/data/providers/bisq-markets.mjs +145 -0
  137. package/src/data/providers/bitcoin-esplora.mjs +216 -0
  138. package/src/data/providers/bitcoin-meta.mjs +378 -0
  139. package/src/data/providers/blockscout.mjs +14 -0
  140. package/src/data/providers/bob-rootstock.mjs +198 -0
  141. package/src/data/providers/braiins-insights.mjs +103 -0
  142. package/src/data/providers/bridge-aggregator.mjs +259 -0
  143. package/src/data/providers/bridges.mjs +242 -0
  144. package/src/data/providers/bungee.mjs +29 -0
  145. package/src/data/providers/celestia-da.mjs +38 -0
  146. package/src/data/providers/changenow.mjs +135 -0
  147. package/src/data/providers/compound.mjs +32 -0
  148. package/src/data/providers/connext.mjs +28 -0
  149. package/src/data/providers/convex.mjs +30 -0
  150. package/src/data/providers/cow-protocol.mjs +110 -0
  151. package/src/data/providers/cowswap.mjs +415 -0
  152. package/src/data/providers/curve.mjs +201 -0
  153. package/src/data/providers/das-assets.mjs +59 -0
  154. package/src/data/providers/debridge.mjs +109 -0
  155. package/src/data/providers/defillama.mjs +88 -0
  156. package/src/data/providers/dexscreener.mjs +43 -0
  157. package/src/data/providers/drift.mjs +32 -0
  158. package/src/data/providers/dydx.mjs +41 -0
  159. package/src/data/providers/evm-rpc.mjs +225 -0
  160. package/src/data/providers/farming.mjs +291 -0
  161. package/src/data/providers/geckoterminal.mjs +34 -0
  162. package/src/data/providers/gmx.mjs +496 -0
  163. package/src/data/providers/hiro-stacks.mjs +150 -0
  164. package/src/data/providers/hl-assets.mjs +165 -0
  165. package/src/data/providers/hl-info.mjs +108 -0
  166. package/src/data/providers/hl-markets.mjs +210 -0
  167. package/src/data/providers/hl-outcome.mjs +61 -0
  168. package/src/data/providers/hl-perps.mjs +419 -0
  169. package/src/data/providers/hl-staking.mjs +353 -0
  170. package/src/data/providers/hl-ws.mjs +119 -0
  171. package/src/data/providers/hyperevm-dex.mjs +49 -0
  172. package/src/data/providers/jito-mev.mjs +117 -0
  173. package/src/data/providers/jupiter-venues.mjs +119 -0
  174. package/src/data/providers/jupiter.mjs +315 -0
  175. package/src/data/providers/kamino-strategies.mjs +143 -0
  176. package/src/data/providers/l2beat-tvl.mjs +42 -0
  177. package/src/data/providers/lifi.mjs +166 -0
  178. package/src/data/providers/liquid-esplora.mjs +152 -0
  179. package/src/data/providers/magiceden-ordinals.mjs +141 -0
  180. package/src/data/providers/magiceden-sol.mjs +406 -0
  181. package/src/data/providers/mempool-lightning.mjs +144 -0
  182. package/src/data/providers/mempool-mining.mjs +142 -0
  183. package/src/data/providers/meteora-dlmm.mjs +168 -0
  184. package/src/data/providers/morpho.mjs +177 -0
  185. package/src/data/providers/nft-gallery.mjs +163 -0
  186. package/src/data/providers/nft-portfolio.mjs +494 -0
  187. package/src/data/providers/odos.mjs +156 -0
  188. package/src/data/providers/ondo.mjs +31 -0
  189. package/src/data/providers/oneinch.mjs +174 -0
  190. package/src/data/providers/opensea-multichain.mjs +136 -0
  191. package/src/data/providers/opensea-nft.mjs +371 -0
  192. package/src/data/providers/orca.mjs +29 -0
  193. package/src/data/providers/ordinals-runes.mjs +180 -0
  194. package/src/data/providers/pancakeswap.mjs +28 -0
  195. package/src/data/providers/paraswap.mjs +125 -0
  196. package/src/data/providers/pendle.mjs +188 -0
  197. package/src/data/providers/poly-clob.mjs +283 -0
  198. package/src/data/providers/poly-public.mjs +96 -0
  199. package/src/data/providers/poly-ws.mjs +103 -0
  200. package/src/data/providers/polygon-staking.mjs +227 -0
  201. package/src/data/providers/portfolio-history.mjs +394 -0
  202. package/src/data/providers/portfolio.mjs +600 -0
  203. package/src/data/providers/pyth-price-feeds.mjs +172 -0
  204. package/src/data/providers/raydium.mjs +35 -0
  205. package/src/data/providers/relayscan-mev.mjs +72 -0
  206. package/src/data/providers/rfq.mjs +15 -0
  207. package/src/data/providers/rh-agent.mjs +59 -0
  208. package/src/data/providers/sanctum-lst.mjs +180 -0
  209. package/src/data/providers/satflow.mjs +341 -0
  210. package/src/data/providers/signed-material-guard.mjs +108 -0
  211. package/src/data/providers/solana-rpc.mjs +197 -0
  212. package/src/data/providers/solend-lending.mjs +166 -0
  213. package/src/data/providers/spark-lend.mjs +42 -0
  214. package/src/data/providers/squid-router.mjs +29 -0
  215. package/src/data/providers/stargate.mjs +29 -0
  216. package/src/data/providers/sushiswap.mjs +30 -0
  217. package/src/data/providers/symbiotic-restaking.mjs +41 -0
  218. package/src/data/providers/thorchain.mjs +36 -0
  219. package/src/data/providers/traderjoe.mjs +28 -0
  220. package/src/data/providers/twap.mjs +152 -0
  221. package/src/data/providers/uniswap-v3.mjs +457 -0
  222. package/src/data/providers/uniswap-v4.mjs +414 -0
  223. package/src/data/providers/vertex.mjs +41 -0
  224. package/src/data/providers/wallet-watch.mjs +264 -0
  225. package/src/data/providers/wormhole.mjs +28 -0
  226. package/src/data/providers/yearn.mjs +31 -0
  227. package/src/data/providers/zerox.mjs +167 -0
  228. package/src/data/public-api-scan.mjs +61 -0
  229. package/src/data/quote-placeholder.mjs +31 -0
  230. package/src/desk/swap-prepare.mjs +194 -0
  231. package/src/equities/bridge.mjs +388 -0
  232. package/src/equities/fixtures/bridge_routes.json +159 -0
  233. package/src/equities/fixtures/dst_transitions.json +29 -0
  234. package/src/equities/fixtures/equity_dex_pools.json +154 -0
  235. package/src/equities/fixtures/hip3_l2books.json +2711 -0
  236. package/src/equities/fixtures/nyse_holidays.json +1 -0
  237. package/src/equities/fixtures/oracles.json +100 -0
  238. package/src/equities/fixtures/rh_pool_state.json +244 -0
  239. package/src/equities/fixtures/solana_xstocks.json +704 -0
  240. package/src/equities/fixtures/ton_xstocks.json +35 -0
  241. package/src/equities/fixtures/universe.json +411 -0
  242. package/src/equities/fixtures/venues.json +3542 -0
  243. package/src/equities/fixtures.mjs +405 -0
  244. package/src/equities/funding.mjs +142 -0
  245. package/src/equities/index.mjs +166 -0
  246. package/src/equities/liveness.mjs +148 -0
  247. package/src/equities/marketHours.mjs +249 -0
  248. package/src/equities/normalize.mjs +295 -0
  249. package/src/equities/num.mjs +146 -0
  250. package/src/equities/prepare.mjs +95 -0
  251. package/src/equities/rank.mjs +260 -0
  252. package/src/equities/sourceNum.mjs +69 -0
  253. package/src/equities/types.mjs +220 -0
  254. package/src/equities/venues/arcus-perp.mjs +84 -0
  255. package/src/equities/venues/arcus-spot.mjs +105 -0
  256. package/src/equities/venues/hyperliquid-hip3.mjs +224 -0
  257. package/src/equities/venues/rh-uniswap.mjs +216 -0
  258. package/src/equities/venues/solana-xstocks.mjs +139 -0
  259. package/src/equities/venues/ton-stonfi.mjs +139 -0
  260. package/src/exact-integer.mjs +72 -0
  261. package/src/exec-policy.mjs +419 -0
  262. package/src/flags.mjs +15 -0
  263. package/src/fresh-window.mjs +76 -0
  264. package/src/gmx-attestation.mjs +176 -0
  265. package/src/index.mjs +107 -0
  266. package/src/licensing/locals-only.mjs +25 -0
  267. package/src/nft-gas-war-guard.mjs +139 -0
  268. package/src/onboarding/agent-keys.mjs +161 -0
  269. package/src/onboarding/harness-configs.mjs +102 -0
  270. package/src/onboarding/index.mjs +18 -0
  271. package/src/onboarding/tiers.mjs +139 -0
  272. package/src/oracle-env.mjs +55 -0
  273. package/src/package-manifest.mjs +42 -0
  274. package/src/plugins/agent-plugin-loader.mjs +225 -0
  275. package/src/portfolio-risk.mjs +170 -0
  276. package/src/prepare-envelope.mjs +204 -0
  277. package/src/profile-upgrade.mjs +277 -0
  278. package/src/protocol-execution.mjs +84 -0
  279. package/src/protocol-templates/gate.mjs +179 -0
  280. package/src/protocol-templates/prepare-deploy.mjs +81 -0
  281. package/src/public-api/agent-grants.mjs +57 -0
  282. package/src/public-api/buzz-integration.mjs +267 -0
  283. package/src/public-api/connect-agent.mjs +424 -0
  284. package/src/public-api/grants.mjs +142 -0
  285. package/src/public-api/http.mjs +707 -0
  286. package/src/public-api/metering.mjs +111 -0
  287. package/src/public-control/aa-adapter.mjs +402 -0
  288. package/src/public-control/build-registry.mjs +227 -0
  289. package/src/public-control/bundler-client.mjs +357 -0
  290. package/src/public-control/grant-indexer.mjs +296 -0
  291. package/src/public-control/policy-render.mjs +69 -0
  292. package/src/public-control/policy-schema.mjs +322 -0
  293. package/src/public-control/runtime-config.mjs +275 -0
  294. package/src/public-control/session-key-model.mjs +379 -0
  295. package/src/public-control/session-orchestrator.mjs +418 -0
  296. package/src/rfq/intent.mjs +180 -0
  297. package/src/rfq/sources.mjs +181 -0
  298. package/src/route-attestation.mjs +132 -0
  299. package/src/router/best-execution.mjs +326 -0
  300. package/src/router/index.mjs +250 -0
  301. package/src/router/integrator-fee.mjs +135 -0
  302. package/src/router/prepare-bridge.mjs +293 -0
  303. package/src/router/prepare-route.mjs +398 -0
  304. package/src/router/proposal.mjs +311 -0
  305. package/src/router/risk-classifier.mjs +119 -0
  306. package/src/router/route-sources.mjs +364 -0
  307. package/src/scanner/chains.config.mjs +543 -0
  308. package/src/scanner/contract.mjs +270 -0
  309. package/src/scanner/evm-scanner.mjs +394 -0
  310. package/src/scanner/index.mjs +9 -0
  311. package/src/scanner/v2-venue.mjs +351 -0
  312. package/src/scanner/v3-venue.mjs +308 -0
  313. package/src/scopes.mjs +44 -0
  314. package/src/sell-simulation.mjs +167 -0
  315. package/src/signals/engine.mjs +146 -0
  316. package/src/signals/index.mjs +1 -0
  317. package/src/token-transfer-guard.mjs +188 -0
  318. package/src/tui/app.mjs +438 -0
  319. package/src/tui/backend.mjs +215 -0
  320. package/src/tui/format.mjs +272 -0
  321. package/src/tui/gateway-client.mjs +177 -0
  322. package/src/tui/input.mjs +501 -0
  323. package/src/tui/memory.mjs +105 -0
  324. package/src/tui/meta-learn.mjs +85 -0
  325. package/src/tui/renderer.mjs +443 -0
  326. package/src/tui/scheduler.mjs +205 -0
  327. package/src/tui/skills-loader.mjs +140 -0
  328. package/src/tui/standalone-client.mjs +752 -0
  329. package/src/tui/theme.mjs +81 -0
  330. package/src/vault-attestation.mjs +146 -0
  331. package/src/venues.mjs +206 -0
  332. package/src/watch-preferences.mjs +85 -0
  333. package/dist/action-receipts.mjs +0 -1
  334. package/dist/action-semantics.mjs +0 -1
  335. package/dist/address-book.mjs +0 -2
  336. package/dist/bin/desk-server.mjs +0 -59
  337. package/dist/bin/oracle-data-mcp.mjs +0 -8
  338. package/dist/bin/oracle-equities.mjs +0 -20
  339. package/dist/bin/oracle-init.mjs +0 -24
  340. package/dist/bin/oracle-public-server.mjs +0 -5
  341. package/dist/bin/oracle-route.mjs +0 -22
  342. package/dist/bin/oracle-scan.mjs +0 -18
  343. package/dist/bin/oracle-upgrade.mjs +0 -21
  344. package/dist/bin/oracle.mjs +0 -76
  345. package/dist/chains.mjs +0 -1
  346. package/dist/cli/commands/auth.mjs +0 -16
  347. package/dist/cli/commands/bootstrap.mjs +0 -18
  348. package/dist/cli/commands/chain.mjs +0 -21
  349. package/dist/cli/commands/chat.mjs +0 -45
  350. package/dist/cli/commands/credential.mjs +0 -1
  351. package/dist/cli/commands/data-mcp.mjs +0 -2
  352. package/dist/cli/commands/data.mjs +0 -12
  353. package/dist/cli/commands/doctor.mjs +0 -5
  354. package/dist/cli/commands/equities.mjs +0 -15
  355. package/dist/cli/commands/farm.mjs +0 -59
  356. package/dist/cli/commands/follow.mjs +0 -28
  357. package/dist/cli/commands/gate.mjs +0 -13
  358. package/dist/cli/commands/harness.mjs +0 -15
  359. package/dist/cli/commands/help.mjs +0 -1
  360. package/dist/cli/commands/init.mjs +0 -3
  361. package/dist/cli/commands/mcp.mjs +0 -60
  362. package/dist/cli/commands/model.mjs +0 -54
  363. package/dist/cli/commands/plugins.mjs +0 -38
  364. package/dist/cli/commands/prepare.mjs +0 -2
  365. package/dist/cli/commands/public.mjs +0 -3
  366. package/dist/cli/commands/resolve.mjs +0 -23
  367. package/dist/cli/commands/route.mjs +0 -2
  368. package/dist/cli/commands/runner.mjs +0 -1
  369. package/dist/cli/commands/scan.mjs +0 -2
  370. package/dist/cli/commands/setup.mjs +0 -34
  371. package/dist/cli/commands/sign.mjs +0 -21
  372. package/dist/cli/commands/signer.mjs +0 -1
  373. package/dist/cli/commands/swap.mjs +0 -36
  374. package/dist/cli/commands/upgrade.mjs +0 -2
  375. package/dist/cli/commands/vault.mjs +0 -1
  376. package/dist/cli/commands/version.mjs +0 -2
  377. package/dist/data/desk-data.mjs +0 -55
  378. package/dist/data/names.mjs +0 -2
  379. package/dist/data/providers/farming.mjs +0 -2
  380. package/dist/equities/index.mjs +0 -1
  381. package/dist/index.mjs +0 -60
  382. package/dist/nft-gas-war-guard.mjs +0 -1
  383. package/dist/onboarding/harness-configs.mjs +0 -4
  384. package/dist/portfolio-risk.mjs +0 -1
  385. package/dist/prepare-envelope.mjs +0 -1
  386. package/dist/public-api/agent-grants.mjs +0 -3
  387. package/dist/public-control/policy-schema.mjs +0 -1
  388. package/dist/router/index.mjs +0 -2
  389. package/dist/scanner/index.mjs +0 -4
  390. package/dist/signals/index.mjs +0 -1
  391. package/dist/watch-preferences.mjs +0 -1
  392. /package/{dist/assets/profiles → profiles}/_template/SOUL.md +0 -0
  393. /package/{dist/assets/profiles → profiles}/_template/profile.json +0 -0
  394. /package/{dist/assets/profiles → profiles}/bitcoin-agent/SOUL.md +0 -0
  395. /package/{dist/assets/profiles → profiles}/bitcoin-agent/profile.json +0 -0
  396. /package/{dist/assets/profiles → profiles}/hyperliquid-agent/SOUL.md +0 -0
  397. /package/{dist/assets/profiles → profiles}/hyperliquid-agent/profile.json +0 -0
  398. /package/{dist/assets/profiles → profiles}/oracle/profile.json +0 -0
  399. /package/{dist/assets/profiles → profiles}/polymarket-agent/SOUL.md +0 -0
  400. /package/{dist/assets/profiles → profiles}/polymarket-agent/profile.json +0 -0
  401. /package/{dist/assets/profiles → profiles}/profile.schema.json +0 -0
  402. /package/{dist/assets/profiles → profiles}/protocol-builder/SOUL.md +0 -0
  403. /package/{dist/assets/profiles → profiles}/protocol-builder/profile.json +0 -0
  404. /package/{dist/assets/profiles → profiles}/robinhood-agent/SOUL.md +0 -0
  405. /package/{dist/assets/profiles → profiles}/robinhood-agent/profile.json +0 -0
  406. /package/{dist/assets/profiles → profiles}/solana-agent/SOUL.md +0 -0
  407. /package/{dist/assets/profiles → profiles}/solana-agent/profile.json +0 -0
  408. /package/{dist/assets/profiles → profiles}/stable-agent/SOUL.md +0 -0
  409. /package/{dist/assets/profiles → profiles}/stable-agent/profile.json +0 -0
  410. /package/{dist/assets/skills → skills}/balance/SKILL.md +0 -0
  411. /package/{dist/assets/skills → skills}/bitcoin-l1.md +0 -0
  412. /package/{dist/assets/skills → skills}/chain-defi-ecosystem-profiling.md +0 -0
  413. /package/{dist/assets/skills → skills}/evm-contract-research.md +0 -0
  414. /package/{dist/assets/skills → skills}/hyperliquid.md +0 -0
  415. /package/{dist/assets/skills → skills}/multichain-exec-desk.md +0 -0
  416. /package/{dist/assets/skills → skills}/oracle-action-semantics/SKILL.md +0 -0
  417. /package/{dist/assets/skills → skills}/oracle-best-execution/SKILL.md +0 -0
  418. /package/{dist/assets/skills → skills}/oracle-best-execution.md +0 -0
  419. /package/{dist/assets/skills → skills}/oracle-bitcoin/SKILL.md +0 -0
  420. /package/{dist/assets/skills → skills}/oracle-chain-graphs-telegram-cards/SKILL.md +0 -0
  421. /package/{dist/assets/skills → skills}/oracle-chat/SKILL.md +0 -0
  422. /package/{dist/assets/skills → skills}/oracle-chat/chain.SKILL.md +0 -0
  423. /package/{dist/assets/skills → skills}/oracle-chat/setup.SKILL.md +0 -0
  424. /package/{dist/assets/skills → skills}/oracle-circuit-breaker/SKILL.md +0 -0
  425. /package/{dist/assets/skills → skills}/oracle-contract-research/SKILL.md +0 -0
  426. /package/{dist/assets/skills → skills}/oracle-desk/SKILL.md +0 -0
  427. /package/{dist/assets/skills → skills}/oracle-desk.md +0 -0
  428. /package/{dist/assets/skills → skills}/oracle-dex-launch/SKILL.md +0 -0
  429. /package/{dist/assets/skills → skills}/oracle-equities/SKILL.md +0 -0
  430. /package/{dist/assets/skills → skills}/oracle-grants/SKILL.md +0 -0
  431. /package/{dist/assets/skills → skills}/oracle-hypercore-staking/SKILL.md +0 -0
  432. /package/{dist/assets/skills → skills}/oracle-hyperliquid/SKILL.md +0 -0
  433. /package/{dist/assets/skills → skills}/oracle-meme-token-sniper/SKILL.md +0 -0
  434. /package/{dist/assets/skills → skills}/oracle-multichain-nft-launch/SKILL.md +0 -0
  435. /package/{dist/assets/skills → skills}/oracle-multichain-token-launch/SKILL.md +0 -0
  436. /package/{dist/assets/skills → skills}/oracle-nft-gacha-launch/SKILL.md +0 -0
  437. /package/{dist/assets/skills → skills}/oracle-nft-mint-gas-war/SKILL.md +0 -0
  438. /package/{dist/assets/skills → skills}/oracle-polymarket/SKILL.md +0 -0
  439. /package/{dist/assets/skills → skills}/oracle-protocol-builder/SKILL.md +0 -0
  440. /package/{dist/assets/skills → skills}/oracle-protocol-security/SKILL.md +0 -0
  441. /package/{dist/assets/skills → skills}/oracle-public-product/SKILL.md +0 -0
  442. /package/{dist/assets/skills → skills}/oracle-receipts/SKILL.md +0 -0
  443. /package/{dist/assets/skills → skills}/oracle-receipts.md +0 -0
  444. /package/{dist/assets/skills → skills}/oracle-rfq-tokenized-assets/SKILL.md +0 -0
  445. /package/{dist/assets/skills → skills}/oracle-smart-wallet-scanner/SKILL.md +0 -0
  446. /package/{dist/assets/skills → skills}/oracle-solana/SKILL.md +0 -0
  447. /package/{dist/assets/skills → skills}/oracle-solana-nft/SKILL.md +0 -0
  448. /package/{dist/assets/skills → skills}/oracle-token-research/SKILL.md +0 -0
  449. /package/{dist/assets/skills → skills}/solana.md +0 -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;