@oracle-agent/oracle 0.14.1 → 0.16.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 (450) hide show
  1. package/README.md +2 -2
  2. package/SETUP.md +4 -4
  3. package/dist/action-receipts.mjs +1 -0
  4. package/dist/action-semantics.mjs +1 -0
  5. package/dist/address-book.mjs +2 -0
  6. package/dist/bin/desk-server.mjs +60 -0
  7. package/dist/bin/oracle-data-mcp.mjs +9 -0
  8. package/dist/bin/oracle-equities.mjs +20 -0
  9. package/dist/bin/oracle-init.mjs +24 -0
  10. package/dist/bin/oracle-public-server.mjs +5 -0
  11. package/dist/bin/oracle-route.mjs +22 -0
  12. package/dist/bin/oracle-scan.mjs +18 -0
  13. package/dist/bin/oracle-upgrade.mjs +21 -0
  14. package/dist/bin/oracle.mjs +63 -0
  15. package/dist/chains.mjs +1 -0
  16. package/dist/cli/commands/auth.mjs +16 -0
  17. package/dist/cli/commands/bootstrap.mjs +18 -0
  18. package/dist/cli/commands/chain.mjs +21 -0
  19. package/dist/cli/commands/chat.mjs +45 -0
  20. package/dist/cli/commands/credential.mjs +1 -0
  21. package/dist/cli/commands/data-mcp.mjs +2 -0
  22. package/dist/cli/commands/data.mjs +12 -0
  23. package/dist/cli/commands/doctor.mjs +5 -0
  24. package/dist/cli/commands/equities.mjs +15 -0
  25. package/dist/cli/commands/farm.mjs +59 -0
  26. package/dist/cli/commands/fees.mjs +10 -0
  27. package/dist/cli/commands/follow.mjs +28 -0
  28. package/dist/cli/commands/harness.mjs +15 -0
  29. package/dist/cli/commands/help.mjs +1 -0
  30. package/dist/cli/commands/init.mjs +3 -0
  31. package/dist/cli/commands/mcp.mjs +36 -0
  32. package/dist/cli/commands/model.mjs +54 -0
  33. package/dist/cli/commands/plugins.mjs +43 -0
  34. package/dist/cli/commands/prepare.mjs +2 -0
  35. package/dist/cli/commands/public.mjs +3 -0
  36. package/dist/cli/commands/resolve.mjs +23 -0
  37. package/dist/cli/commands/route.mjs +2 -0
  38. package/dist/cli/commands/runner.mjs +1 -0
  39. package/dist/cli/commands/scan.mjs +2 -0
  40. package/dist/cli/commands/setup.mjs +34 -0
  41. package/dist/cli/commands/sign.mjs +4 -0
  42. package/dist/cli/commands/signer.mjs +1 -0
  43. package/dist/cli/commands/strategy.mjs +18 -0
  44. package/dist/cli/commands/swap.mjs +36 -0
  45. package/dist/cli/commands/upgrade.mjs +2 -0
  46. package/dist/cli/commands/vault.mjs +1 -0
  47. package/dist/cli/commands/version.mjs +2 -0
  48. package/dist/data/desk-data.mjs +55 -0
  49. package/dist/data/names.mjs +2 -0
  50. package/dist/data/providers/farming.mjs +2 -0
  51. package/dist/equities/index.mjs +1 -0
  52. package/dist/index.mjs +60 -0
  53. package/dist/nft-gas-war-guard.mjs +1 -0
  54. package/dist/onboarding/harness-configs.mjs +4 -0
  55. package/dist/portfolio-risk.mjs +1 -0
  56. package/dist/prepare-envelope.mjs +1 -0
  57. package/dist/public-api/agent-grants.mjs +3 -0
  58. package/dist/public-control/policy-schema.mjs +1 -0
  59. package/dist/router/index.mjs +2 -0
  60. package/dist/scanner/index.mjs +4 -0
  61. package/dist/signals/index.mjs +1 -0
  62. package/dist/strategy/index.mjs +3 -0
  63. package/dist/watch-preferences.mjs +1 -0
  64. package/package.json +33 -78
  65. package/public/oracle-splash/_variants/ice.html +5 -18
  66. package/public/oracle-splash/_variants/ivory.html +5 -18
  67. package/public/oracle-splash/downloads/index.html +4 -4
  68. package/public/oracle-splash/index.html +113 -34
  69. package/CONTRIBUTING.md +0 -99
  70. package/bin/desk-server.mjs +0 -473
  71. package/bin/oracle-data-mcp.mjs +0 -1252
  72. package/bin/oracle-equities.mjs +0 -168
  73. package/bin/oracle-init.mjs +0 -525
  74. package/bin/oracle-public-server.mjs +0 -36
  75. package/bin/oracle-route.mjs +0 -254
  76. package/bin/oracle-scan.mjs +0 -192
  77. package/bin/oracle-upgrade.mjs +0 -42
  78. package/bin/oracle.mjs +0 -34
  79. package/docs/adding-a-chain.md +0 -229
  80. package/docs/architecture.md +0 -139
  81. package/docs/buzz-integration.md +0 -115
  82. package/docs/cli.md +0 -143
  83. package/docs/connectors.md +0 -13
  84. package/docs/hyperliquid-builder-code.md +0 -50
  85. package/docs/locals-only-fee-waiver.md +0 -34
  86. package/docs/oracle-pack-standard.md +0 -29
  87. package/docs/profiles.md +0 -151
  88. package/docs/public-surface.md +0 -206
  89. package/examples/add-a-chain.mjs +0 -65
  90. package/examples/oracle-pack-template.mjs +0 -38
  91. package/examples/research-a-token.mjs +0 -70
  92. package/plugins/oracle-owner-gate/__init__.py +0 -288
  93. package/plugins/oracle-owner-gate/plugin.yaml +0 -9
  94. package/protocols/templates/safe-erc20/SECURITY.md +0 -16
  95. package/protocols/templates/safe-erc20/foundry.toml +0 -12
  96. package/protocols/templates/safe-erc20/remappings.txt +0 -2
  97. package/protocols/templates/safe-erc20/src/SafeERC20.sol +0 -53
  98. package/protocols/templates/safe-erc20/test/SafeERC20.t.sol +0 -72
  99. package/scripts/adversarial-bench.mjs +0 -114
  100. package/scripts/build-dist.mjs +0 -119
  101. package/scripts/build-inscription.py +0 -230
  102. package/scripts/check-doc-drift.mjs +0 -123
  103. package/scripts/check-test-count.mjs +0 -105
  104. package/scripts/e2e-hl-markets.mjs +0 -21
  105. package/scripts/e2e-hl-perps.mjs +0 -48
  106. package/scripts/e2e-hypercore-staking.mjs +0 -128
  107. package/scripts/e2e-solana-bitcoin.mjs +0 -183
  108. package/scripts/guard-publish.mjs +0 -22
  109. package/scripts/protocol-template-gate.mjs +0 -15
  110. package/scripts/public-api-scan.mjs +0 -23
  111. package/scripts/publish-dist.mjs +0 -67
  112. package/scripts/record-hero-cli.sh +0 -80
  113. package/scripts/secret-scan.mjs +0 -169
  114. package/scripts/smoke-dist-bins.mjs +0 -89
  115. package/scripts/verify-dist.mjs +0 -29
  116. package/scripts/verify-v3-venues.mjs +0 -233
  117. package/skins/oracle.yaml +0 -56
  118. package/src/action-receipts.mjs +0 -265
  119. package/src/action-semantics.mjs +0 -62
  120. package/src/address-book.mjs +0 -208
  121. package/src/agent-auth.mjs +0 -206
  122. package/src/approval-guard.mjs +0 -282
  123. package/src/attestation-secret.mjs +0 -94
  124. package/src/audit-log.mjs +0 -196
  125. package/src/auth/oauth.mjs +0 -672
  126. package/src/auto-slippage.mjs +0 -378
  127. package/src/capability-posture.mjs +0 -125
  128. package/src/cards.mjs +0 -422
  129. package/src/chains.mjs +0 -62
  130. package/src/cli/chain-catalog.mjs +0 -215
  131. package/src/cli/chain-state.mjs +0 -74
  132. package/src/cli/commands/auth.mjs +0 -193
  133. package/src/cli/commands/bootstrap.mjs +0 -87
  134. package/src/cli/commands/chain.mjs +0 -143
  135. package/src/cli/commands/chat.mjs +0 -465
  136. package/src/cli/commands/credential.mjs +0 -9
  137. package/src/cli/commands/data-mcp.mjs +0 -18
  138. package/src/cli/commands/data.mjs +0 -75
  139. package/src/cli/commands/doctor.mjs +0 -136
  140. package/src/cli/commands/equities.mjs +0 -41
  141. package/src/cli/commands/farm.mjs +0 -129
  142. package/src/cli/commands/fees.mjs +0 -109
  143. package/src/cli/commands/follow.mjs +0 -130
  144. package/src/cli/commands/harness.mjs +0 -63
  145. package/src/cli/commands/help.mjs +0 -7
  146. package/src/cli/commands/init.mjs +0 -27
  147. package/src/cli/commands/mcp.mjs +0 -154
  148. package/src/cli/commands/model.mjs +0 -106
  149. package/src/cli/commands/plugins.mjs +0 -275
  150. package/src/cli/commands/prepare.mjs +0 -12
  151. package/src/cli/commands/public.mjs +0 -20
  152. package/src/cli/commands/resolve.mjs +0 -64
  153. package/src/cli/commands/route.mjs +0 -12
  154. package/src/cli/commands/runner.mjs +0 -9
  155. package/src/cli/commands/scan.mjs +0 -12
  156. package/src/cli/commands/setup.mjs +0 -294
  157. package/src/cli/commands/sign.mjs +0 -21
  158. package/src/cli/commands/signer.mjs +0 -9
  159. package/src/cli/commands/swap.mjs +0 -102
  160. package/src/cli/commands/upgrade.mjs +0 -12
  161. package/src/cli/commands/vault.mjs +0 -9
  162. package/src/cli/commands/version.mjs +0 -22
  163. package/src/cli/first-run.mjs +0 -23
  164. package/src/cli/kernel.mjs +0 -262
  165. package/src/cli/mcp-targets/chatgpt.mjs +0 -51
  166. package/src/cli/mcp-targets/claude-code.mjs +0 -39
  167. package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
  168. package/src/cli/mcp-targets/codex.mjs +0 -41
  169. package/src/cli/mcp-targets/cursor.mjs +0 -32
  170. package/src/cli/mcp-targets/shared.mjs +0 -71
  171. package/src/cli/mcp-targets/vscode.mjs +0 -39
  172. package/src/cli/messaging-platforms.mjs +0 -217
  173. package/src/cli/model-config.mjs +0 -78
  174. package/src/cli/operator-dispatch.mjs +0 -194
  175. package/src/cli/oracle-harness.py +0 -415
  176. package/src/cli/paths.mjs +0 -107
  177. package/src/cli/runtime.mjs +0 -351
  178. package/src/cli/setup-state.mjs +0 -168
  179. package/src/cli/spawn-child.mjs +0 -43
  180. package/src/data/catalog.mjs +0 -858
  181. package/src/data/desk-data.mjs +0 -877
  182. package/src/data/http.mjs +0 -253
  183. package/src/data/names.mjs +0 -188
  184. package/src/data/provider-endpoint.mjs +0 -94
  185. package/src/data/providers/aave-v3.mjs +0 -139
  186. package/src/data/providers/across-bridge.mjs +0 -41
  187. package/src/data/providers/aerodrome.mjs +0 -245
  188. package/src/data/providers/aevo.mjs +0 -33
  189. package/src/data/providers/approval-indexer.mjs +0 -133
  190. package/src/data/providers/approvals.mjs +0 -594
  191. package/src/data/providers/babylon-staking.mjs +0 -149
  192. package/src/data/providers/balancer.mjs +0 -209
  193. package/src/data/providers/beefy-yields.mjs +0 -45
  194. package/src/data/providers/birdeye-tokens.mjs +0 -33
  195. package/src/data/providers/bisq-markets.mjs +0 -145
  196. package/src/data/providers/bitcoin-esplora.mjs +0 -216
  197. package/src/data/providers/bitcoin-meta.mjs +0 -378
  198. package/src/data/providers/blockscout.mjs +0 -14
  199. package/src/data/providers/bob-rootstock.mjs +0 -198
  200. package/src/data/providers/braiins-insights.mjs +0 -103
  201. package/src/data/providers/bridge-aggregator.mjs +0 -259
  202. package/src/data/providers/bridges.mjs +0 -242
  203. package/src/data/providers/bungee.mjs +0 -29
  204. package/src/data/providers/celestia-da.mjs +0 -38
  205. package/src/data/providers/changenow.mjs +0 -135
  206. package/src/data/providers/compound.mjs +0 -32
  207. package/src/data/providers/connext.mjs +0 -28
  208. package/src/data/providers/convex.mjs +0 -30
  209. package/src/data/providers/cow-protocol.mjs +0 -110
  210. package/src/data/providers/cowswap.mjs +0 -415
  211. package/src/data/providers/curve.mjs +0 -201
  212. package/src/data/providers/das-assets.mjs +0 -59
  213. package/src/data/providers/debridge.mjs +0 -109
  214. package/src/data/providers/defillama.mjs +0 -88
  215. package/src/data/providers/dexscreener.mjs +0 -43
  216. package/src/data/providers/drift.mjs +0 -32
  217. package/src/data/providers/dydx.mjs +0 -41
  218. package/src/data/providers/evm-rpc.mjs +0 -225
  219. package/src/data/providers/farming.mjs +0 -291
  220. package/src/data/providers/geckoterminal.mjs +0 -34
  221. package/src/data/providers/gmx.mjs +0 -496
  222. package/src/data/providers/hiro-stacks.mjs +0 -150
  223. package/src/data/providers/hl-assets.mjs +0 -165
  224. package/src/data/providers/hl-info.mjs +0 -108
  225. package/src/data/providers/hl-markets.mjs +0 -210
  226. package/src/data/providers/hl-outcome.mjs +0 -61
  227. package/src/data/providers/hl-perps.mjs +0 -419
  228. package/src/data/providers/hl-staking.mjs +0 -353
  229. package/src/data/providers/hl-ws.mjs +0 -119
  230. package/src/data/providers/hyperevm-dex.mjs +0 -49
  231. package/src/data/providers/jito-mev.mjs +0 -117
  232. package/src/data/providers/jupiter-venues.mjs +0 -119
  233. package/src/data/providers/jupiter.mjs +0 -315
  234. package/src/data/providers/kamino-strategies.mjs +0 -143
  235. package/src/data/providers/l2beat-tvl.mjs +0 -42
  236. package/src/data/providers/lifi.mjs +0 -166
  237. package/src/data/providers/liquid-esplora.mjs +0 -152
  238. package/src/data/providers/magiceden-ordinals.mjs +0 -141
  239. package/src/data/providers/magiceden-sol.mjs +0 -406
  240. package/src/data/providers/mempool-lightning.mjs +0 -144
  241. package/src/data/providers/mempool-mining.mjs +0 -142
  242. package/src/data/providers/meteora-dlmm.mjs +0 -168
  243. package/src/data/providers/morpho.mjs +0 -177
  244. package/src/data/providers/nft-gallery.mjs +0 -163
  245. package/src/data/providers/nft-portfolio.mjs +0 -494
  246. package/src/data/providers/odos.mjs +0 -156
  247. package/src/data/providers/ondo.mjs +0 -31
  248. package/src/data/providers/oneinch.mjs +0 -174
  249. package/src/data/providers/opensea-multichain.mjs +0 -136
  250. package/src/data/providers/opensea-nft.mjs +0 -371
  251. package/src/data/providers/orca.mjs +0 -29
  252. package/src/data/providers/ordinals-runes.mjs +0 -180
  253. package/src/data/providers/pancakeswap.mjs +0 -28
  254. package/src/data/providers/paraswap.mjs +0 -125
  255. package/src/data/providers/pendle.mjs +0 -188
  256. package/src/data/providers/poly-clob.mjs +0 -283
  257. package/src/data/providers/poly-public.mjs +0 -96
  258. package/src/data/providers/poly-ws.mjs +0 -103
  259. package/src/data/providers/polygon-staking.mjs +0 -227
  260. package/src/data/providers/portfolio-history.mjs +0 -394
  261. package/src/data/providers/portfolio.mjs +0 -600
  262. package/src/data/providers/pyth-price-feeds.mjs +0 -172
  263. package/src/data/providers/raydium.mjs +0 -35
  264. package/src/data/providers/relayscan-mev.mjs +0 -72
  265. package/src/data/providers/rfq.mjs +0 -15
  266. package/src/data/providers/rh-agent.mjs +0 -59
  267. package/src/data/providers/sanctum-lst.mjs +0 -180
  268. package/src/data/providers/satflow.mjs +0 -341
  269. package/src/data/providers/signed-material-guard.mjs +0 -108
  270. package/src/data/providers/solana-rpc.mjs +0 -197
  271. package/src/data/providers/solend-lending.mjs +0 -166
  272. package/src/data/providers/spark-lend.mjs +0 -42
  273. package/src/data/providers/squid-router.mjs +0 -29
  274. package/src/data/providers/stargate.mjs +0 -29
  275. package/src/data/providers/sushiswap.mjs +0 -30
  276. package/src/data/providers/symbiotic-restaking.mjs +0 -41
  277. package/src/data/providers/thorchain.mjs +0 -36
  278. package/src/data/providers/traderjoe.mjs +0 -28
  279. package/src/data/providers/twap.mjs +0 -152
  280. package/src/data/providers/uniswap-v3.mjs +0 -457
  281. package/src/data/providers/uniswap-v4.mjs +0 -414
  282. package/src/data/providers/vertex.mjs +0 -41
  283. package/src/data/providers/wallet-watch.mjs +0 -264
  284. package/src/data/providers/wormhole.mjs +0 -28
  285. package/src/data/providers/yearn.mjs +0 -31
  286. package/src/data/providers/zerox.mjs +0 -167
  287. package/src/data/public-api-scan.mjs +0 -61
  288. package/src/data/quote-placeholder.mjs +0 -31
  289. package/src/desk/swap-prepare.mjs +0 -194
  290. package/src/equities/bridge.mjs +0 -388
  291. package/src/equities/fixtures/bridge_routes.json +0 -159
  292. package/src/equities/fixtures/dst_transitions.json +0 -29
  293. package/src/equities/fixtures/equity_dex_pools.json +0 -154
  294. package/src/equities/fixtures/hip3_l2books.json +0 -2711
  295. package/src/equities/fixtures/nyse_holidays.json +0 -1
  296. package/src/equities/fixtures/oracles.json +0 -100
  297. package/src/equities/fixtures/rh_pool_state.json +0 -244
  298. package/src/equities/fixtures/solana_xstocks.json +0 -704
  299. package/src/equities/fixtures/ton_xstocks.json +0 -35
  300. package/src/equities/fixtures/universe.json +0 -411
  301. package/src/equities/fixtures/venues.json +0 -3542
  302. package/src/equities/fixtures.mjs +0 -405
  303. package/src/equities/funding.mjs +0 -142
  304. package/src/equities/index.mjs +0 -166
  305. package/src/equities/liveness.mjs +0 -148
  306. package/src/equities/marketHours.mjs +0 -249
  307. package/src/equities/normalize.mjs +0 -295
  308. package/src/equities/num.mjs +0 -146
  309. package/src/equities/prepare.mjs +0 -95
  310. package/src/equities/rank.mjs +0 -260
  311. package/src/equities/sourceNum.mjs +0 -69
  312. package/src/equities/types.mjs +0 -220
  313. package/src/equities/venues/arcus-perp.mjs +0 -84
  314. package/src/equities/venues/arcus-spot.mjs +0 -105
  315. package/src/equities/venues/hyperliquid-hip3.mjs +0 -224
  316. package/src/equities/venues/rh-uniswap.mjs +0 -216
  317. package/src/equities/venues/solana-xstocks.mjs +0 -139
  318. package/src/equities/venues/ton-stonfi.mjs +0 -139
  319. package/src/exact-integer.mjs +0 -72
  320. package/src/exec-policy.mjs +0 -419
  321. package/src/flags.mjs +0 -15
  322. package/src/fresh-window.mjs +0 -76
  323. package/src/gmx-attestation.mjs +0 -176
  324. package/src/index.mjs +0 -107
  325. package/src/licensing/locals-only.mjs +0 -25
  326. package/src/nft-gas-war-guard.mjs +0 -139
  327. package/src/onboarding/agent-keys.mjs +0 -161
  328. package/src/onboarding/harness-configs.mjs +0 -102
  329. package/src/onboarding/index.mjs +0 -18
  330. package/src/onboarding/tiers.mjs +0 -139
  331. package/src/oracle-env.mjs +0 -55
  332. package/src/package-manifest.mjs +0 -42
  333. package/src/plugins/agent-plugin-loader.mjs +0 -225
  334. package/src/portfolio-risk.mjs +0 -170
  335. package/src/prepare-envelope.mjs +0 -204
  336. package/src/profile-upgrade.mjs +0 -277
  337. package/src/protocol-execution.mjs +0 -84
  338. package/src/protocol-templates/gate.mjs +0 -179
  339. package/src/protocol-templates/prepare-deploy.mjs +0 -81
  340. package/src/public-api/agent-grants.mjs +0 -57
  341. package/src/public-api/buzz-integration.mjs +0 -267
  342. package/src/public-api/connect-agent.mjs +0 -424
  343. package/src/public-api/grants.mjs +0 -142
  344. package/src/public-api/http.mjs +0 -707
  345. package/src/public-api/metering.mjs +0 -111
  346. package/src/public-control/aa-adapter.mjs +0 -402
  347. package/src/public-control/build-registry.mjs +0 -227
  348. package/src/public-control/bundler-client.mjs +0 -357
  349. package/src/public-control/grant-indexer.mjs +0 -296
  350. package/src/public-control/policy-render.mjs +0 -69
  351. package/src/public-control/policy-schema.mjs +0 -322
  352. package/src/public-control/runtime-config.mjs +0 -275
  353. package/src/public-control/session-key-model.mjs +0 -379
  354. package/src/public-control/session-orchestrator.mjs +0 -418
  355. package/src/rfq/intent.mjs +0 -180
  356. package/src/rfq/sources.mjs +0 -181
  357. package/src/route-attestation.mjs +0 -132
  358. package/src/router/best-execution.mjs +0 -326
  359. package/src/router/index.mjs +0 -250
  360. package/src/router/integrator-fee.mjs +0 -135
  361. package/src/router/prepare-bridge.mjs +0 -293
  362. package/src/router/prepare-route.mjs +0 -398
  363. package/src/router/proposal.mjs +0 -311
  364. package/src/router/risk-classifier.mjs +0 -119
  365. package/src/router/route-sources.mjs +0 -364
  366. package/src/scanner/chains.config.mjs +0 -543
  367. package/src/scanner/contract.mjs +0 -270
  368. package/src/scanner/evm-scanner.mjs +0 -394
  369. package/src/scanner/index.mjs +0 -9
  370. package/src/scanner/v2-venue.mjs +0 -351
  371. package/src/scanner/v3-venue.mjs +0 -308
  372. package/src/scopes.mjs +0 -44
  373. package/src/sell-simulation.mjs +0 -167
  374. package/src/signals/engine.mjs +0 -146
  375. package/src/signals/index.mjs +0 -1
  376. package/src/token-transfer-guard.mjs +0 -188
  377. package/src/tui/app.mjs +0 -438
  378. package/src/tui/backend.mjs +0 -215
  379. package/src/tui/format.mjs +0 -272
  380. package/src/tui/gateway-client.mjs +0 -177
  381. package/src/tui/input.mjs +0 -501
  382. package/src/tui/memory.mjs +0 -105
  383. package/src/tui/meta-learn.mjs +0 -85
  384. package/src/tui/renderer.mjs +0 -443
  385. package/src/tui/scheduler.mjs +0 -205
  386. package/src/tui/skills-loader.mjs +0 -140
  387. package/src/tui/standalone-client.mjs +0 -752
  388. package/src/tui/theme.mjs +0 -81
  389. package/src/vault-attestation.mjs +0 -146
  390. package/src/venues.mjs +0 -206
  391. package/src/watch-preferences.mjs +0 -85
  392. /package/{profiles → dist/assets/profiles}/_template/SOUL.md +0 -0
  393. /package/{profiles → dist/assets/profiles}/_template/profile.json +0 -0
  394. /package/{profiles → dist/assets/profiles}/bitcoin-agent/SOUL.md +0 -0
  395. /package/{profiles → dist/assets/profiles}/bitcoin-agent/profile.json +0 -0
  396. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/SOUL.md +0 -0
  397. /package/{profiles → dist/assets/profiles}/hyperliquid-agent/profile.json +0 -0
  398. /package/{profiles → dist/assets/profiles}/oracle/SOUL.md +0 -0
  399. /package/{profiles → dist/assets/profiles}/oracle/profile.json +0 -0
  400. /package/{profiles → dist/assets/profiles}/polymarket-agent/SOUL.md +0 -0
  401. /package/{profiles → dist/assets/profiles}/polymarket-agent/profile.json +0 -0
  402. /package/{profiles → dist/assets/profiles}/profile.schema.json +0 -0
  403. /package/{profiles → dist/assets/profiles}/protocol-builder/SOUL.md +0 -0
  404. /package/{profiles → dist/assets/profiles}/protocol-builder/profile.json +0 -0
  405. /package/{profiles → dist/assets/profiles}/robinhood-agent/SOUL.md +0 -0
  406. /package/{profiles → dist/assets/profiles}/robinhood-agent/profile.json +0 -0
  407. /package/{profiles → dist/assets/profiles}/solana-agent/SOUL.md +0 -0
  408. /package/{profiles → dist/assets/profiles}/solana-agent/profile.json +0 -0
  409. /package/{profiles → dist/assets/profiles}/stable-agent/SOUL.md +0 -0
  410. /package/{profiles → dist/assets/profiles}/stable-agent/profile.json +0 -0
  411. /package/{skills → dist/assets/skills}/balance/SKILL.md +0 -0
  412. /package/{skills → dist/assets/skills}/bitcoin-l1.md +0 -0
  413. /package/{skills → dist/assets/skills}/chain-defi-ecosystem-profiling.md +0 -0
  414. /package/{skills → dist/assets/skills}/evm-contract-research.md +0 -0
  415. /package/{skills → dist/assets/skills}/hyperliquid.md +0 -0
  416. /package/{skills → dist/assets/skills}/multichain-exec-desk.md +0 -0
  417. /package/{skills → dist/assets/skills}/oracle-action-semantics/SKILL.md +0 -0
  418. /package/{skills → dist/assets/skills}/oracle-best-execution/SKILL.md +0 -0
  419. /package/{skills → dist/assets/skills}/oracle-best-execution.md +0 -0
  420. /package/{skills → dist/assets/skills}/oracle-bitcoin/SKILL.md +0 -0
  421. /package/{skills → dist/assets/skills}/oracle-chain-graphs-telegram-cards/SKILL.md +0 -0
  422. /package/{skills → dist/assets/skills}/oracle-chat/SKILL.md +0 -0
  423. /package/{skills → dist/assets/skills}/oracle-chat/chain.SKILL.md +0 -0
  424. /package/{skills → dist/assets/skills}/oracle-chat/setup.SKILL.md +0 -0
  425. /package/{skills → dist/assets/skills}/oracle-circuit-breaker/SKILL.md +0 -0
  426. /package/{skills → dist/assets/skills}/oracle-contract-research/SKILL.md +0 -0
  427. /package/{skills → dist/assets/skills}/oracle-desk/SKILL.md +0 -0
  428. /package/{skills → dist/assets/skills}/oracle-desk.md +0 -0
  429. /package/{skills → dist/assets/skills}/oracle-dex-launch/SKILL.md +0 -0
  430. /package/{skills → dist/assets/skills}/oracle-equities/SKILL.md +0 -0
  431. /package/{skills → dist/assets/skills}/oracle-grants/SKILL.md +0 -0
  432. /package/{skills → dist/assets/skills}/oracle-hypercore-staking/SKILL.md +0 -0
  433. /package/{skills → dist/assets/skills}/oracle-hyperliquid/SKILL.md +0 -0
  434. /package/{skills → dist/assets/skills}/oracle-meme-token-sniper/SKILL.md +0 -0
  435. /package/{skills → dist/assets/skills}/oracle-multichain-nft-launch/SKILL.md +0 -0
  436. /package/{skills → dist/assets/skills}/oracle-multichain-token-launch/SKILL.md +0 -0
  437. /package/{skills → dist/assets/skills}/oracle-nft-gacha-launch/SKILL.md +0 -0
  438. /package/{skills → dist/assets/skills}/oracle-nft-mint-gas-war/SKILL.md +0 -0
  439. /package/{skills → dist/assets/skills}/oracle-polymarket/SKILL.md +0 -0
  440. /package/{skills → dist/assets/skills}/oracle-protocol-builder/SKILL.md +0 -0
  441. /package/{skills → dist/assets/skills}/oracle-protocol-security/SKILL.md +0 -0
  442. /package/{skills → dist/assets/skills}/oracle-public-product/SKILL.md +0 -0
  443. /package/{skills → dist/assets/skills}/oracle-receipts/SKILL.md +0 -0
  444. /package/{skills → dist/assets/skills}/oracle-receipts.md +0 -0
  445. /package/{skills → dist/assets/skills}/oracle-rfq-tokenized-assets/SKILL.md +0 -0
  446. /package/{skills → dist/assets/skills}/oracle-smart-wallet-scanner/SKILL.md +0 -0
  447. /package/{skills → dist/assets/skills}/oracle-solana/SKILL.md +0 -0
  448. /package/{skills → dist/assets/skills}/oracle-solana-nft/SKILL.md +0 -0
  449. /package/{skills → dist/assets/skills}/oracle-token-research/SKILL.md +0 -0
  450. /package/{skills → dist/assets/skills}/solana.md +0 -0
@@ -1,168 +0,0 @@
1
- #!/usr/bin/env node
2
- // Crossbook product bin — separate Oracle product for on-chain equities best-ex.
3
- // HIP-3 / Arcus / RH / Solana / TON. Offline fixtures by default. Never signs.
4
-
5
- import { realpathSync } from 'node:fs';
6
- import { fileURLToPath } from 'node:url';
7
- import {
8
- bestEquityRoute,
9
- equityVenues,
10
- prepareEquityRoute,
11
- toJsonSafe,
12
- } from '../src/equities/index.mjs';
13
- import { toString } from '../src/equities/num.mjs';
14
-
15
- function usage() {
16
- return `oracle equities <command>
17
-
18
- Commands:
19
- venues inventory + tiers + liveness snapshot
20
- quote <TICKER> [options] rank venues for a ticker (HIP-3, Arcus, RH, Solana, TON)
21
- prepare <TICKER> --recipient 0x... prepare unsigned RH Uniswap artifact
22
-
23
- Options:
24
- --size <usd> notional size for impact model
25
- --horizon <hours> enable funding-adjusted heterogeneous ranking
26
- --json machine readable output
27
- --fixtures offline mode (default in v1)
28
- `;
29
- }
30
-
31
- function parseArgs(argv) {
32
- const args = { _: [] };
33
- for (let i = 0; i < argv.length; i += 1) {
34
- const a = argv[i];
35
- if (a === '--json') args.json = true;
36
- else if (a === '--fixtures') args.fixtures = true;
37
- else if (a === '--size') args.size = argv[++i];
38
- else if (a === '--horizon') args.horizon = argv[++i];
39
- else if (a === '--recipient') args.recipient = argv[++i];
40
- else if (a.startsWith('--')) throw new Error(`unknown flag ${a}`);
41
- else args._.push(a);
42
- }
43
- return args;
44
- }
45
-
46
- function printHumanRank(result) {
47
- const lines = [];
48
- lines.push(`oracle equities quote ${result.ticker}`);
49
- if (result.darkWindow) {
50
- lines.push(`WARNING: ${result.darkWindow.warning} (session=${result.darkWindow.session})`);
51
- }
52
- lines.push(`rankedOn=${result.rankedOn} mix=${result.instrumentMix}`);
53
- lines.push(
54
- `sources answered/tried=${result.sourcesAnswered}/${result.sourcesTried} excluded=${result.excluded?.length ?? 0} failed=${result.failed?.length ?? 0}`,
55
- );
56
- if (result.winner) {
57
- lines.push(
58
- `WINNER ${result.winner.venue} ${result.winner.instrument} tier=${result.winner.tier} net=${toString(result.winner.net)} costAccounted=${result.winner.costAccounted}`,
59
- );
60
- } else {
61
- lines.push('WINNER (none)');
62
- }
63
- for (const r of (result.runnersUp || []).slice(0, 5)) {
64
- lines.push(
65
- ` runner ${r.venue} ${r.instrument} tier=${r.tier} net=${toString(r.net)} costAccounted=${r.costAccounted}`,
66
- );
67
- }
68
- if (result.improvementBps !== null && result.improvementBps !== undefined) {
69
- lines.push(`improvementBps=${result.improvementBps}`);
70
- } else {
71
- lines.push('improvementBps=null (no honest same-class costed comparison)');
72
- }
73
- if (result.bestPreparable) {
74
- lines.push(
75
- `bestPreparable ${result.bestPreparable.venue} net=${toString(result.bestPreparable.net)}`,
76
- );
77
- } else {
78
- lines.push('bestPreparable (none)');
79
- }
80
- if (result.excluded?.length) {
81
- const byReason = {};
82
- for (const e of result.excluded) byReason[e.reason] = (byReason[e.reason] ?? 0) + 1;
83
- lines.push(`excluded: ${JSON.stringify(byReason)}`);
84
- }
85
- return lines.join('\n');
86
- }
87
-
88
- function cmdVenues(args) {
89
- const payload = equityVenues();
90
- if (args.json) return JSON.stringify(payload, null, 2);
91
- return [
92
- 'oracle equities venues',
93
- ...payload.inventory.map(
94
- (v) => ` ${v.venue.padEnd(22)} tier=${v.tier.padEnd(11)} chain=${String(v.chain).padEnd(16)} n=${v.n}`,
95
- ),
96
- `liveness survivors=${payload.liveness.survivors} excluded=${payload.liveness.excluded} ${JSON.stringify(payload.liveness.byReason)}`,
97
- ].join('\n');
98
- }
99
-
100
- function cmdQuote(args) {
101
- const ticker = args._[1];
102
- if (!ticker) throw new Error('usage: quote <TICKER>');
103
- const result = bestEquityRoute({
104
- ticker,
105
- sizeUsd: args.size,
106
- horizonHours: args.horizon,
107
- });
108
- if (args.json) return JSON.stringify(toJsonSafe(result), null, 2);
109
- return printHumanRank(result);
110
- }
111
-
112
- function cmdPrepare(args) {
113
- const ticker = args._[1];
114
- if (!ticker) throw new Error('usage: prepare <TICKER> --recipient 0x...');
115
- if (!args.recipient) throw new Error('--recipient is required');
116
- const out = prepareEquityRoute({
117
- ticker,
118
- sizeUsd: args.size,
119
- recipient: args.recipient,
120
- });
121
- if (args.json) return JSON.stringify(toJsonSafe(out), null, 2);
122
- if (!out.ok) {
123
- return `prepare ${ticker.toUpperCase()} FAILED (${out.failureKind}): ${out.error || out.note}`;
124
- }
125
- const art = out.artifact;
126
- return [
127
- `prepare ${ticker.toUpperCase()}`,
128
- ` chainId=${art.chainId} to=${art.to}`,
129
- ` requiresWalletSignature=${art.requiresWalletSignature} backendSigner=${art.backendSigner}`,
130
- ` approval spender=${art.requiresApproval?.spender} token=${art.requiresApproval?.token}`,
131
- ` quoteAgeMs=${art.quoteAgeMs}`,
132
- ...(art.notes || []).map((n) => ` note: ${n}`),
133
- ].join('\n');
134
- }
135
-
136
- export function main(argv = process.argv.slice(2)) {
137
- if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
138
- process.stdout.write(usage());
139
- return 0;
140
- }
141
- const args = parseArgs(argv);
142
- const cmd = args._[0];
143
- let out;
144
- if (cmd === 'venues') out = cmdVenues(args);
145
- else if (cmd === 'quote') out = cmdQuote(args);
146
- else if (cmd === 'prepare') out = cmdPrepare(args);
147
- else throw new Error(`unknown command ${cmd}\n${usage()}`);
148
- process.stdout.write(out + '\n');
149
- return 0;
150
- }
151
-
152
- function runningAsMain() {
153
- if (!process.argv[1]) return false;
154
- try {
155
- return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]);
156
- } catch {
157
- return false;
158
- }
159
- }
160
-
161
- if (runningAsMain()) {
162
- try {
163
- process.exit(main());
164
- } catch (error) {
165
- process.stderr.write(String(error.message || error) + '\n');
166
- process.exit(1);
167
- }
168
- }
@@ -1,525 +0,0 @@
1
- #!/usr/bin/env node
2
- // oracle-init -- install Oracle's agent lanes into Hermes.
3
- //
4
- // Reads profiles/<lane>/profile.json, validates each against the shipped schema,
5
- // then creates the Hermes profile, installs its SOUL.md, registers the repo's
6
- // skills, and wires the oracle-data MCP server.
7
- //
8
- // Deliberate omissions:
9
- // * No model or provider is written. Oracle makes no model calls; each lane
10
- // inherits whatever the operator's Hermes already serves. profile.json carries
11
- // a capability CLASS ("strong-reasoner"), never a model id, so this installer
12
- // never pins a vendor.
13
- // * No grant is armed. Every lane lands DISARMED. Arming is a signed, scoped,
14
- // expiring act the user performs later.
15
- //
16
- // Default is a DRY RUN. Pass --apply to make changes.
17
-
18
- import fs from "node:fs";
19
- import path from "node:path";
20
- import os from "node:os";
21
- import { randomBytes } from "node:crypto";
22
- import { execFileSync } from "node:child_process";
23
- import { fileURLToPath } from "node:url";
24
- import { packageAssetDir } from "../src/package-manifest.mjs";
25
-
26
- // Sibling bins live next to this file in both layouts (bin/ in source,
27
- // dist/bin/ in the published bundle), so resolve them from here, not the root.
28
- const BIN_DIR = path.dirname(fileURLToPath(import.meta.url));
29
- const PROFILES_DIR = packageAssetDir("profiles", import.meta.url);
30
- const SKILLS_DIR = packageAssetDir("skills", import.meta.url);
31
-
32
- const args = process.argv.slice(2);
33
- const APPLY = args.includes("--apply");
34
- const FORCE = args.includes("--force");
35
- const JSON_OUT = args.includes("--json");
36
- const only = (() => {
37
- const i = args.indexOf("--only");
38
- return i >= 0 ? args[i + 1] : null;
39
- })();
40
-
41
- const log = (...m) => {
42
- if (!JSON_OUT) console.log(...m);
43
- };
44
-
45
- // ---------------------------------------------------------------- validation
46
-
47
- function loadSchema() {
48
- return JSON.parse(
49
- fs.readFileSync(path.join(PROFILES_DIR, "profile.schema.json"), "utf8"),
50
- );
51
- }
52
-
53
- // Focused validator for the fields we actually depend on. Not a general JSON
54
- // Schema engine -- pulling one in for eight files would add a dependency to a
55
- // zero-dependency installer.
56
- function validateProfile(def, schema, skillNames) {
57
- const errors = [];
58
- const req = schema.required || [];
59
- for (const k of req) {
60
- if (def[k] === undefined) errors.push(`missing required field: ${k}`);
61
- }
62
- if (def.id && !/^[a-z_][a-z0-9-]*$/.test(def.id)) {
63
- errors.push(`id "${def.id}" must be lowercase, no dots (Hermes rejects dots)`);
64
- }
65
- const roles = schema.properties.role.enum;
66
- if (def.role && !roles.includes(def.role)) {
67
- errors.push(`role "${def.role}" not one of ${roles.join(", ")}`);
68
- }
69
- const p = def.posture || {};
70
- if (p.default !== "DISARMED") {
71
- errors.push("posture.default must be DISARMED -- a lane that ships armed is a bug");
72
- }
73
- if (p.signing && !["none", "user-wallet"].includes(p.signing)) {
74
- errors.push(`posture.signing "${p.signing}" invalid -- Oracle holds no keys`);
75
- }
76
- const allowedActions =
77
- schema.properties.posture.properties.grantActions.items.enum;
78
- for (const a of p.grantActions || []) {
79
- if (!allowedActions.includes(a)) {
80
- errors.push(`grantAction "${a}" not allowed (broadcast/sign actions are forbidden)`);
81
- }
82
- }
83
- if (typeof p.rationale === "string" && p.rationale.length < 20) {
84
- errors.push("posture.rationale too short -- justify the grant");
85
- }
86
- // Every named skill must actually exist. This is the check that would have
87
- // caught the phantom-skill problem in the original pack manifest.
88
- for (const s of def.skills || []) {
89
- if (!skillNames.has(s)) errors.push(`skill "${s}" does not exist in skills/`);
90
- }
91
- return errors;
92
- }
93
-
94
- // ---------------------------------------------------------------- discovery
95
-
96
- function discoverSkills() {
97
- if (!fs.existsSync(SKILLS_DIR)) return new Map();
98
- const out = new Map();
99
- for (const e of fs.readdirSync(SKILLS_DIR, { withFileTypes: true })) {
100
- if (!e.isDirectory()) continue;
101
- const skillFile = path.join(SKILLS_DIR, e.name, "SKILL.md");
102
- if (fs.existsSync(skillFile)) out.set(e.name, skillFile);
103
- }
104
- return out;
105
- }
106
-
107
- function discoverProfiles() {
108
- if (!fs.existsSync(PROFILES_DIR)) return [];
109
- const out = [];
110
- for (const e of fs.readdirSync(PROFILES_DIR, { withFileTypes: true })) {
111
- if (!e.isDirectory()) continue;
112
- const f = path.join(PROFILES_DIR, e.name, "profile.json");
113
- if (!fs.existsSync(f)) continue;
114
- const def = JSON.parse(fs.readFileSync(f, "utf8"));
115
- def.__dir = path.join(PROFILES_DIR, e.name);
116
- out.push(def);
117
- }
118
- return out;
119
- }
120
-
121
- // ---------------------------------------------------------------- hermes glue
122
-
123
- function hermesAvailable() {
124
- try {
125
- execFileSync("hermes", ["--version"], { stdio: "pipe", timeout: 20_000 });
126
- return true;
127
- } catch {
128
- return false;
129
- }
130
- }
131
-
132
- // Resolve the GLOBAL Hermes root, not a profile-scoped one.
133
- //
134
- // Trap worth knowing: when this runs inside an agent session that is itself
135
- // profile-scoped, HERMES_HOME points at ~/.hermes/profiles/<name>, not ~/.hermes.
136
- // Using it verbatim writes ~/.hermes/profiles/<name>/profiles/<lane>/SOUL.md --
137
- // a nested path Hermes never reads, so the install silently does nothing.
138
- // Detect that shape and walk back up to the real root.
139
- function hermesRoot() {
140
- const env = (process.env.HERMES_HOME || "").trim();
141
- if (env) {
142
- const parts = env.split(path.sep);
143
- const i = parts.lastIndexOf("profiles");
144
- // ".../profiles/<name>" -> strip the last two segments
145
- if (i > 0 && i === parts.length - 2) {
146
- return parts.slice(0, i).join(path.sep);
147
- }
148
- return env;
149
- }
150
- return path.join(os.homedir(), ".hermes");
151
- }
152
-
153
- function profileExists(id) {
154
- try {
155
- const out = execFileSync("hermes", ["profile", "list"], {
156
- encoding: "utf8",
157
- timeout: 30_000,
158
- });
159
- return new RegExp(`(^|\\s)${id}(\\s|$)`, "m").test(out);
160
- } catch {
161
- return false;
162
- }
163
- }
164
-
165
- const actions = [];
166
- const skipped = [];
167
- const mcpManual = [];
168
-
169
- function sameFile(a, b) {
170
- try {
171
- return fs.readFileSync(a, "utf8") === fs.readFileSync(b, "utf8");
172
- } catch {
173
- return false;
174
- }
175
- }
176
-
177
- function record(kind, detail) {
178
- actions.push({ kind, detail, applied: APPLY });
179
- log(`${APPLY ? " ✔" : " ·"} ${kind}: ${detail}`);
180
- }
181
-
182
- // Write Hermes mcp_servers.oracle-data directly into the profile config.
183
- // Prefer this over `hermes mcp add`: current Hermes takes --command and --args
184
- // as separate tokens, prompts interactively for tool enablement, and the old
185
- // installer form `--command "node <path>"` silently no-ops under execFileSync.
186
- function yamlScalar(value) {
187
- if (
188
- value === "" ||
189
- /[:#\[\]{},&*!|>'"%@`\s]/.test(value) ||
190
- /^(?:null|true|false|\d+)$/i.test(value)
191
- ) {
192
- return JSON.stringify(value);
193
- }
194
- return value;
195
- }
196
-
197
- function mcpServerBlock(serverName, scriptPath) {
198
- return [
199
- ` ${serverName}:`,
200
- " command: node",
201
- " args:",
202
- ` - ${yamlScalar(scriptPath)}`,
203
- " enabled: true",
204
- ].join("\n");
205
- }
206
-
207
- function wireMcpIntoConfig(configPath, serverName, scriptPath) {
208
- const entry = mcpServerBlock(serverName, scriptPath);
209
- if (!fs.existsSync(configPath)) {
210
- fs.writeFileSync(configPath, `mcp_servers:\n${entry}\n`, "utf8");
211
- return "created";
212
- }
213
-
214
- let txt = fs.readFileSync(configPath, "utf8");
215
- if (
216
- txt.includes(scriptPath) &&
217
- new RegExp(`^\\s*${serverName}:\\s*$`, "m").test(txt)
218
- ) {
219
- return "present";
220
- }
221
-
222
- // Replace an existing server block of the same name (simple indented map).
223
- const serverRe = new RegExp(
224
- `^([ \\t]*)${serverName}:\\s*\\n(?:\\1[ \\t]+.*\\n)*`,
225
- "m",
226
- );
227
- if (serverRe.test(txt)) {
228
- txt = txt.replace(serverRe, `${entry}\n`);
229
- fs.writeFileSync(configPath, txt, "utf8");
230
- return "updated";
231
- }
232
-
233
- if (/^mcp_servers:\s*$/m.test(txt) || /^mcp_servers:\s*\n/m.test(txt)) {
234
- txt = txt.replace(/^(mcp_servers:\s*\n)/m, `$1${entry}\n`);
235
- } else if (/^_config_version:.*$/m.test(txt)) {
236
- txt = txt.replace(
237
- /^(_config_version:.*\n)/m,
238
- `$1mcp_servers:\n${entry}\n`,
239
- );
240
- } else {
241
- txt = `mcp_servers:\n${entry}\n${txt}`;
242
- }
243
- fs.writeFileSync(configPath, txt, "utf8");
244
- return "wired";
245
- }
246
-
247
- // ---------------------------------------------------------------- main
248
-
249
- const schema = loadSchema();
250
- const skills = discoverSkills();
251
- const skillNames = new Set(skills.keys());
252
- let profiles = discoverProfiles();
253
-
254
- // The template is documentation, not a lane to install.
255
- profiles = profiles.filter((p) => !p.template);
256
- if (only) profiles = profiles.filter((p) => p.id === only);
257
-
258
- log(`oracle-init ${APPLY ? "(APPLY)" : "(dry run -- pass --apply to install)"}`);
259
- log(` profiles: ${profiles.length} skills: ${skills.size}`);
260
-
261
- // 1. validate everything BEFORE touching the system. A partial install across a
262
- // profile mesh is worse than no install.
263
- const invalid = [];
264
- for (const def of profiles) {
265
- const errs = validateProfile(def, schema, skillNames);
266
- if (errs.length) invalid.push({ id: def.id, errors: errs });
267
- }
268
- if (invalid.length) {
269
- if (JSON_OUT) {
270
- process.stdout.write(`${JSON.stringify({ ok: false, invalid }, null, 2)}\n`);
271
- } else {
272
- console.error("\nvalidation failed:");
273
- for (const v of invalid) {
274
- console.error(` ${v.id}:`);
275
- for (const e of v.errors) console.error(` - ${e}`);
276
- }
277
- }
278
- process.exit(1);
279
- }
280
- log(" validation: ok");
281
-
282
- // Ensure a route/slippage attestation secret exists for fresh installs.
283
- // Without it, swap sign/broadcast fails closed (unsigned guards are refused).
284
- // Never overwrite an existing secret.
285
- {
286
- const cfgDir = path.join(os.homedir(), ".config", "oracle");
287
- const envPath = path.join(cfgDir, "exec.env");
288
- let hasSecret = Boolean(
289
- process.env.ORACLE_ROUTE_ATTESTATION_SECRET || process.env.MAD_ROUTE_ATTESTATION_SECRET
290
- );
291
- if (!hasSecret && fs.existsSync(envPath)) {
292
- try {
293
- const txt = fs.readFileSync(envPath, "utf8");
294
- hasSecret = /^ORACLE_ROUTE_ATTESTATION_SECRET=.+$/m.test(txt) || /^MAD_ROUTE_ATTESTATION_SECRET=.+$/m.test(txt);
295
- } catch {
296
- /* treat as missing */
297
- }
298
- }
299
- if (hasSecret) {
300
- record("attestation secret", "present");
301
- } else {
302
- record("attestation secret", `generate -> ${path.relative(os.homedir(), envPath)}`);
303
- if (APPLY) {
304
- fs.mkdirSync(cfgDir, { recursive: true, mode: 0o700 });
305
- try {
306
- fs.chmodSync(cfgDir, 0o700);
307
- } catch {
308
- /* best-effort */
309
- }
310
- const secret = randomBytes(32).toString("hex");
311
- const line = `ORACLE_ROUTE_ATTESTATION_SECRET=${secret}\n`;
312
- if (fs.existsSync(envPath)) {
313
- const prev = fs.readFileSync(envPath, "utf8");
314
- if (!/ORACLE_ROUTE_ATTESTATION_SECRET=/.test(prev) && !/MAD_ROUTE_ATTESTATION_SECRET=/.test(prev)) {
315
- fs.appendFileSync(envPath, prev.endsWith("\n") || prev.length === 0 ? line : `\n${line}`, { mode: 0o600 });
316
- }
317
- } else {
318
- fs.writeFileSync(envPath, line, { mode: 0o600 });
319
- }
320
- try {
321
- fs.chmodSync(envPath, 0o600);
322
- } catch {
323
- /* best-effort */
324
- }
325
- }
326
- }
327
- }
328
-
329
- const hermes = hermesAvailable();
330
- // The hermes CLI is a CONVENIENCE, not a requirement.
331
- //
332
- // Verified behaviour: Hermes discovers any profile directory under
333
- // <root>/profiles/<name>/, so writing SOUL.md and skills/ is sufficient to create a
334
- // working lane. `hermes profile create` only pre-seeds boilerplate, and
335
- // `hermes mcp add` only edits that profile's config.
336
- //
337
- // Making the CLI mandatory would mean this installer -- and its tests -- could only
338
- // run on a machine with Hermes already installed, which is both a worse contributor
339
- // experience and untestable in CI. So: install files always, use the CLI when it is
340
- // there, and say plainly what was skipped when it is not.
341
- if (!hermes) {
342
- log(
343
- " hermes CLI: not found -- installing profile files directly.\n" +
344
- " (Hermes discovers any directory under <root>/profiles/, so this works.\n" +
345
- " MCP wiring is the one step that needs the CLI; instructions printed at the end.)",
346
- );
347
- } else {
348
- log(" hermes CLI: found");
349
- }
350
-
351
- // 2. install
352
- for (const def of profiles) {
353
- log(`\n${def.label} (${def.id})`);
354
-
355
- // Snapshot what exists BEFORE we create anything. This is the reliable signal
356
- // for the no-clobber guard below.
357
- //
358
- // Why not just check for the file later: `hermes profile create` writes its own
359
- // boilerplate SOUL.md, so after creation a SOUL.md always exists. Treating that
360
- // as "the user's file" would make the guard refuse to install the lane persona,
361
- // the install would silently no-op, and every lane would run generic Hermes.
362
- // Only a file that predates our run can hold work worth protecting.
363
- const laneDir = path.join(hermesRoot(), "profiles", def.id);
364
- const soulDest = path.join(laneDir, "SOUL.md");
365
- const soulExistedBefore = fs.existsSync(soulDest);
366
- const skillExistedBefore = new Map(
367
- (def.skills || []).map((s) => [
368
- s,
369
- fs.existsSync(path.join(laneDir, "skills", s, "SKILL.md")),
370
- ]),
371
- );
372
-
373
- const preExisting = hermes ? profileExists(def.id) : fs.existsSync(laneDir);
374
- if (preExisting) {
375
- record("profile exists", def.id);
376
- } else if (hermes) {
377
- record("create profile", def.id);
378
- if (APPLY) {
379
- try {
380
- execFileSync("hermes", ["profile", "create", def.id], {
381
- stdio: "pipe",
382
- timeout: 120_000,
383
- });
384
- } catch (err) {
385
- // Not fatal: writing the directory below is what actually creates the lane.
386
- record("create note", `hermes profile create failed for ${def.id}; writing files directly`);
387
- }
388
- }
389
- } else {
390
- record("create profile dir", def.id);
391
- if (APPLY) fs.mkdirSync(laneDir, { recursive: true });
392
- }
393
-
394
- // SOUL.md -- never clobber a persona the user wrote.
395
- const soulSrc = path.join(def.__dir, "SOUL.md");
396
- if (fs.existsSync(soulSrc)) {
397
- const collision = soulExistedBefore && !sameFile(soulSrc, soulDest);
398
- if (collision && !FORCE) {
399
- record(
400
- "SKIP SOUL.md (exists)",
401
- `${path.relative(os.homedir(), soulDest)} -- kept yours; --force to overwrite`,
402
- );
403
- skipped.push({ lane: def.id, file: "SOUL.md", reason: "already exists" });
404
- } else {
405
- record("install SOUL.md", path.relative(os.homedir(), soulDest));
406
- if (APPLY) {
407
- fs.mkdirSync(path.dirname(soulDest), { recursive: true });
408
- if (collision) {
409
- const bak = `${soulDest}.bak-oracle-init-${Date.now()}`;
410
- fs.copyFileSync(soulDest, bak);
411
- record("backed up", path.relative(os.homedir(), bak));
412
- }
413
- fs.copyFileSync(soulSrc, soulDest);
414
- }
415
- }
416
- }
417
-
418
- // skills -- same discipline
419
- for (const s of def.skills || []) {
420
- const dest = path.join(laneDir, "skills", s, "SKILL.md");
421
- const collision = skillExistedBefore.get(s) && !sameFile(skills.get(s), dest);
422
- if (collision && !FORCE) {
423
- record("SKIP skill (exists)", `${s} -> ${def.id}`);
424
- skipped.push({ lane: def.id, file: `skills/${s}`, reason: "already exists" });
425
- continue;
426
- }
427
- record("install skill", `${s} -> ${def.id}`);
428
- if (APPLY) {
429
- fs.mkdirSync(path.dirname(dest), { recursive: true });
430
- fs.copyFileSync(skills.get(s), dest);
431
- }
432
- }
433
-
434
- // MCP: write Hermes config directly. CLI is optional convenience only.
435
- for (const m of def.mcp || []) {
436
- const scriptPath = path.join(BIN_DIR, "oracle-data-mcp.mjs");
437
- const configPath = path.join(laneDir, "config.yaml");
438
- const manual = `hermes -p ${def.id} mcp add ${m} --command node --args ${scriptPath}`;
439
-
440
- if (m !== "oracle-data") {
441
- record("mcp manual", manual);
442
- mcpManual.push({ lane: def.id, server: m, command: manual });
443
- continue;
444
- }
445
-
446
- record(
447
- "wire mcp",
448
- `${m} (${def.id}) -> ${path.relative(os.homedir(), configPath)}`,
449
- );
450
- if (APPLY) {
451
- try {
452
- fs.mkdirSync(laneDir, { recursive: true });
453
- const how = wireMcpIntoConfig(configPath, m, scriptPath);
454
- record(
455
- "mcp config",
456
- `${how}: ${path.relative(os.homedir(), configPath)}`,
457
- );
458
- } catch (err) {
459
- record("mcp note", `could not write ${configPath}: ${err.message}`);
460
- mcpManual.push({ lane: def.id, server: m, command: manual });
461
- }
462
- }
463
- }
464
-
465
- record("posture", `DISARMED (${(def.posture.grantActions || []).join(", ")})`);
466
- }
467
-
468
- // ── Standalone agent skills ──
469
- // Copy shipped skill .md files to ~/.config/oracle/skills/ so the
470
- // standalone agent (skills-loader.mjs) finds them on first chat.
471
- const standaloneSkillsDir = path.join(os.homedir(), ".config", "oracle", "skills");
472
- const shippedSkillsDir = SKILLS_DIR;
473
- if (APPLY && fs.existsSync(shippedSkillsDir)) {
474
- fs.mkdirSync(standaloneSkillsDir, { recursive: true });
475
- let copied = 0;
476
- for (const entry of fs.readdirSync(shippedSkillsDir, { withFileTypes: true })) {
477
- if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
478
- const src = path.join(shippedSkillsDir, entry.name);
479
- const dst = path.join(standaloneSkillsDir, entry.name);
480
- if (!FORCE && fs.existsSync(dst)) {
481
- skipped.push({ lane: "standalone", file: entry.name });
482
- continue;
483
- }
484
- try {
485
- fs.copyFileSync(src, dst);
486
- copied++;
487
- } catch (err) {
488
- record("skill copy", `failed ${entry.name}: ${err.message}`);
489
- }
490
- }
491
- if (copied) log(` standalone skills: ${copied} installed to ${standaloneSkillsDir}`);
492
- }
493
-
494
- const summary = {
495
- ok: true,
496
- applied: APPLY,
497
- profiles: profiles.map((p) => p.id),
498
- skills: [...skillNames],
499
- actions: actions.length,
500
- skipped,
501
- mcpManual,
502
- hermesDetected: hermes,
503
- hermesRoot: hermesRoot(),
504
- };
505
-
506
- if (JSON_OUT) {
507
- process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
508
- } else {
509
- log(`\n${APPLY ? "installed" : "would install"} ${profiles.length} lanes.`);
510
- if (skipped.length) {
511
- log(`${skipped.length} file(s) already existed and were kept:`);
512
- for (const s of skipped) log(` - ${s.lane}/${s.file}`);
513
- log("pass --force to overwrite (a timestamped .bak is written first).");
514
- }
515
- if (mcpManual.length) {
516
- log("\nMCP wiring needed a manual follow-up:");
517
- for (const m of mcpManual) log(` ${m.command}`);
518
- }
519
- if (!APPLY) log("re-run with --apply to make changes.");
520
- log("\nEvery lane is DISARMED. Start the read plane, then chat a lane:");
521
- log(" npx oracle-data # 127.0.0.1:8787 — MCP tools need this");
522
- log(" hermes -p oracle chat");
523
- log("\nSet each lane's model in:");
524
- log(` ${path.join(hermesRoot(), "profiles", "<lane>", "config.yaml")}`);
525
- }