@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,752 +0,0 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import { randomUUID } from "node:crypto";
4
- import { EventEmitter } from "node:events";
5
- import { spawnSync } from "node:child_process";
6
-
7
- import { PACKAGE_ROOT } from "../cli/paths.mjs";
8
- import { getMemoryBlock, addMemory, removeMemory, MEMORY_TOOLS } from "./memory.mjs";
9
- import { getSkillsBlock, loadSkill, createSkill, listSkills, SKILL_TOOLS } from "./skills-loader.mjs";
10
- import { createScheduler, listJobs, addJob, removeJob, CRON_TOOLS } from "./scheduler.mjs";
11
- import { recordTurn, analyzeForSkill, META_TOOLS } from "./meta-learn.mjs";
12
- import { envEnabled } from "../oracle-env.mjs";
13
-
14
- const ALLOWED_COMMANDS = new Set(["chain", "data", "scan", "route", "prepare"]);
15
- const ALLOWED_CHAIN = new Set(["list", "show"]);
16
- const ALLOWED_DATA = new Set(["call", "catalog", "health"]);
17
- const ALLOWED_ROUTE = new Set(["swap", "bridge", "prepare", "prepare-bridge"]);
18
- const OAUTH_BASE_URLS = Object.freeze({
19
- "anthropic-oauth": "https://api.anthropic.com/v1",
20
- "openai-codex": "https://chatgpt.com/backend-api/codex",
21
- "xai-oauth": "https://api.x.ai/v1",
22
- });
23
- const MAX_TOOL_OUTPUT = 20_000;
24
- const MAX_AGENT_STEPS = 6;
25
-
26
- const ORACLE_TOOL = Object.freeze({
27
- type: "function",
28
- function: {
29
- name: "oracle_cli",
30
- description: "Run a bounded read or prepare-only Oracle CLI command. It cannot sign or broadcast transactions.",
31
- parameters: {
32
- type: "object",
33
- properties: {
34
- argv: {
35
- type: "array",
36
- items: { type: "string" },
37
- minItems: 1,
38
- maxItems: 24,
39
- description: "Arguments after the oracle executable, for example [\"scan\",\"chains\"] or [\"data\",\"health\"].",
40
- },
41
- },
42
- required: ["argv"],
43
- additionalProperties: false,
44
- },
45
- },
46
- });
47
-
48
- /** All tools available to the standalone agent. */
49
- const ALL_TOOLS = Object.freeze([
50
- ORACLE_TOOL,
51
- ...MEMORY_TOOLS,
52
- ...SKILL_TOOLS,
53
- ...CRON_TOOLS,
54
- ...META_TOOLS,
55
- ]);
56
-
57
- function trimOutput(value) {
58
- const text = String(value || "");
59
- if (text.length <= MAX_TOOL_OUTPUT) return text;
60
- return `${text.slice(0, MAX_TOOL_OUTPUT)}\n[truncated ${text.length - MAX_TOOL_OUTPUT} chars]`;
61
- }
62
-
63
- async function dispatchTool(name, parsed, toolRunner) {
64
- switch (name) {
65
- case "oracle_cli":
66
- return toolRunner(parsed.argv);
67
- case "memory_add":
68
- addMemory(parsed.key, parsed.content);
69
- return { ok: true, stored: parsed.key };
70
- case "memory_remove":
71
- return removeMemory(parsed.key);
72
- case "skill_load": {
73
- const content = loadSkill(parsed.name);
74
- return content ? { ok: true, name: parsed.name, content } : { ok: false, error: `skill not found: ${parsed.name}` };
75
- }
76
- case "skill_create":
77
- createSkill(parsed.name, parsed.content);
78
- return { ok: true, created: parsed.name };
79
- case "skill_list": {
80
- const skills = listSkills();
81
- return { ok: true, skills: skills.map((s) => ({ name: s.name, description: s.description })) };
82
- }
83
- case "cron_add": {
84
- const job = addJob({ name: parsed.name, schedule: parsed.schedule, prompt: parsed.prompt, skills: parsed.skills || [], enabled: true });
85
- return { ok: true, job };
86
- }
87
- case "cron_list":
88
- return { ok: true, jobs: listJobs() };
89
- case "cron_remove":
90
- return { ok: removeJob(parsed.id), removed: parsed.id };
91
- case "meta_analyze": {
92
- const suggestion = analyzeForSkill();
93
- return { ok: true, ...(suggestion || { shouldCreate: false, suggestion: "No skill suggestions yet." }) };
94
- }
95
- default:
96
- return { ok: false, error: `unknown tool: ${name}` };
97
- }
98
- }
99
-
100
- function validateCommand(argv) {
101
- if (!Array.isArray(argv) || argv.length === 0 || argv.length > 24) {
102
- return "argv must contain 1 to 24 arguments";
103
- }
104
- if (argv.some((arg) => typeof arg !== "string" || arg.length > 1_000)) {
105
- return "every argument must be a string no longer than 1000 characters";
106
- }
107
- const command = argv[0];
108
- if (!ALLOWED_COMMANDS.has(command)) return `command not allowed: ${command}`;
109
- if (command === "chain" && !ALLOWED_CHAIN.has(argv[1] || "list")) {
110
- return `command not allowed: chain${argv[1] ? ` ${argv[1]}` : ""}`;
111
- }
112
- if (command === "data" && !ALLOWED_DATA.has(argv[1] || "")) {
113
- return `command not allowed: data${argv[1] ? ` ${argv[1]}` : ""}`;
114
- }
115
- if (command === "route" && !ALLOWED_ROUTE.has(argv[1] || "")) {
116
- return `command not allowed: route${argv[1] ? ` ${argv[1]}` : ""}`;
117
- }
118
- return null;
119
- }
120
-
121
- export async function runOracleCommand(argv, options = {}) {
122
- const invalid = validateCommand(argv);
123
- if (invalid) return { ok: false, error: invalid };
124
- const spawnFn = options.spawnFn || spawnSync;
125
- const root = options.packageRoot || PACKAGE_ROOT;
126
- const result = spawnFn(
127
- process.execPath,
128
- [path.join(root, "bin", "oracle.mjs"), ...argv],
129
- {
130
- encoding: "utf8",
131
- timeout: options.timeoutMs || 45_000,
132
- maxBuffer: 1024 * 1024,
133
- env: { ...process.env, ORACLE_CHAT_TOOL: "1" },
134
- },
135
- );
136
- if (result.error) return { ok: false, error: result.error.message };
137
- return {
138
- ok: result.status === 0,
139
- status: typeof result.status === "number" ? result.status : 1,
140
- stdout: trimOutput(result.stdout),
141
- stderr: trimOutput(result.stderr),
142
- };
143
- }
144
-
145
- function defaultPersona() {
146
- const file = path.join(PACKAGE_ROOT, "profiles", "oracle", "SOUL.md");
147
- const soul = fs.readFileSync(file, "utf8");
148
- const memory = getMemoryBlock();
149
- const skills = getSkillsBlock();
150
- const blocks = [soul.trim()];
151
- if (memory) blocks.push(memory);
152
- blocks.push(skills);
153
- blocks.push(
154
- "You have tools for Oracle CLI commands, durable memory, skills, cron scheduling, and meta-learning.",
155
- "Use memory_add to persist facts. Use skill_create to save successful workflows. Use cron_add to schedule recurring tasks.",
156
- );
157
- return blocks.join("\n\n");
158
- }
159
-
160
- function eventFrame(type, sessionId, payload = {}) {
161
- return {
162
- method: "event",
163
- params: {
164
- type,
165
- session_id: sessionId,
166
- payload,
167
- },
168
- };
169
- }
170
-
171
- async function responseError(response) {
172
- return new Error(`model request failed (HTTP ${response?.status || "unknown"})`);
173
- }
174
-
175
- async function* parseSse(response) {
176
- if (!response?.ok) throw await responseError(response);
177
- if (!response.body) throw new Error("model response had no body");
178
- const reader = response.body.getReader();
179
- const decoder = new TextDecoder();
180
- let buffer = "";
181
- while (true) {
182
- const { value, done } = await reader.read();
183
- buffer += decoder.decode(value || new Uint8Array(), { stream: !done });
184
- const blocks = buffer.split(/\r?\n\r?\n/);
185
- buffer = blocks.pop() || "";
186
- for (const block of blocks) {
187
- const data = block
188
- .split(/\r?\n/)
189
- .filter((line) => line.startsWith("data:"))
190
- .map((line) => line.slice(5).trimStart())
191
- .join("\n");
192
- if (!data || data === "[DONE]") continue;
193
- yield JSON.parse(data);
194
- }
195
- if (done) break;
196
- }
197
- const tail = buffer.trim();
198
- if (tail.startsWith("data:")) {
199
- const data = tail.slice(5).trim();
200
- if (data && data !== "[DONE]") yield JSON.parse(data);
201
- }
202
- }
203
-
204
- function mergeToolDelta(map, delta) {
205
- const index = Number(delta.index || 0);
206
- const current = map.get(index) || {
207
- id: "",
208
- type: "function",
209
- function: { name: "", arguments: "" },
210
- };
211
- if (delta.id) current.id += delta.id;
212
- if (delta.type) current.type = delta.type;
213
- if (delta.function?.name) current.function.name += delta.function.name;
214
- if (delta.function?.arguments) current.function.arguments += delta.function.arguments;
215
- map.set(index, current);
216
- }
217
-
218
- function usagePayload(usage, contextLength) {
219
- const input = Number(usage?.prompt_tokens || usage?.input_tokens || 0);
220
- const output = Number(usage?.completion_tokens || usage?.output_tokens || 0);
221
- return {
222
- context_used: input,
223
- context_max: contextLength,
224
- context_percent: contextLength > 0 ? Math.round((input / contextLength) * 100) : 0,
225
- input,
226
- output,
227
- };
228
- }
229
-
230
- function allResponseTools() {
231
- return ALL_TOOLS.map((t) => ({
232
- type: "function",
233
- name: t.function.name,
234
- description: t.function.description,
235
- parameters: t.function.parameters,
236
- strict: false,
237
- }));
238
- }
239
-
240
- function allAnthropicTools() {
241
- return ALL_TOOLS.map((t) => ({
242
- name: t.function.name,
243
- description: t.function.description,
244
- input_schema: t.function.parameters,
245
- }));
246
- }
247
-
248
- function appendAnthropicMessage(output, role, blocks) {
249
- const normalized = Array.isArray(blocks) ? blocks : [{ type: "text", text: String(blocks || "") }];
250
- const previous = output.at(-1);
251
- if (previous?.role === role) previous.content.push(...normalized);
252
- else output.push({ role, content: normalized });
253
- }
254
-
255
- function toAnthropicMessages(messages) {
256
- const output = [];
257
- for (const message of messages) {
258
- if (message.role === "system") continue;
259
- if (message.role === "user") {
260
- appendAnthropicMessage(output, "user", [{ type: "text", text: String(message.content || "") }]);
261
- continue;
262
- }
263
- if (message.role === "assistant") {
264
- const blocks = [];
265
- if (message.content) blocks.push({ type: "text", text: String(message.content) });
266
- for (const call of message.tool_calls || []) {
267
- let input = {};
268
- try { input = JSON.parse(call.function?.arguments || "{}"); } catch {}
269
- blocks.push({
270
- type: "tool_use",
271
- id: call.id,
272
- name: call.function?.name,
273
- input,
274
- });
275
- }
276
- if (blocks.length) appendAnthropicMessage(output, "assistant", blocks);
277
- continue;
278
- }
279
- if (message.role === "tool") {
280
- appendAnthropicMessage(output, "user", [{
281
- type: "tool_result",
282
- tool_use_id: message.tool_call_id,
283
- content: String(message.content || ""),
284
- }]);
285
- }
286
- }
287
- return output;
288
- }
289
-
290
- function toResponsesInput(messages) {
291
- const output = [];
292
- for (const message of messages) {
293
- if (message.role === "system") continue;
294
- if (message.role === "user") {
295
- output.push({ role: "user", content: [{ type: "input_text", text: String(message.content || "") }] });
296
- continue;
297
- }
298
- if (message.role === "assistant") {
299
- if (message.content) {
300
- output.push({
301
- role: "assistant",
302
- status: "completed",
303
- content: [{ type: "output_text", text: String(message.content) }],
304
- });
305
- }
306
- for (const call of message.tool_calls || []) {
307
- output.push({
308
- type: "function_call",
309
- id: call.response_item_id || undefined,
310
- call_id: call.id,
311
- name: call.function?.name,
312
- arguments: call.function?.arguments || "{}",
313
- });
314
- }
315
- continue;
316
- }
317
- if (message.role === "tool") {
318
- output.push({
319
- type: "function_call_output",
320
- call_id: message.tool_call_id,
321
- output: String(message.content || ""),
322
- });
323
- }
324
- }
325
- return output.map((item) => Object.fromEntries(Object.entries(item).filter(([, value]) => value !== undefined)));
326
- }
327
-
328
- function accountIdFromJwt(token) {
329
- try {
330
- const payload = JSON.parse(Buffer.from(String(token).split(".")[1], "base64url").toString("utf8"));
331
- return String(payload?.["https://api.openai.com/auth"]?.chatgpt_account_id || "");
332
- } catch {
333
- return "";
334
- }
335
- }
336
-
337
- async function chatCompletionStep({ config, messages, fetchFn, signal, onText }) {
338
- const response = await fetchFn(`${config.baseUrl}/chat/completions`, {
339
- method: "POST",
340
- headers: {
341
- "content-type": "application/json",
342
- ...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),
343
- ...(config.provider === "openrouter" ? {
344
- "HTTP-Referer": "https://oracle-agent.dev",
345
- "X-Title": "Oracle CLI",
346
- } : {}),
347
- },
348
- body: JSON.stringify({
349
- model: config.model,
350
- messages,
351
- tools: ALL_TOOLS,
352
- tool_choice: "auto",
353
- stream: true,
354
- stream_options: { include_usage: true },
355
- }),
356
- signal,
357
- });
358
- const toolDeltas = new Map();
359
- let text = "";
360
- let usage = null;
361
- for await (const frame of parseSse(response)) {
362
- if (frame.usage) usage = frame.usage;
363
- const delta = frame.choices?.[0]?.delta || {};
364
- if (typeof delta.content === "string" && delta.content) {
365
- text += delta.content;
366
- onText(delta.content);
367
- }
368
- for (const toolDelta of delta.tool_calls || []) mergeToolDelta(toolDeltas, toolDelta);
369
- }
370
- return {
371
- text,
372
- usage,
373
- toolCalls: [...toolDeltas.entries()].sort(([a], [b]) => a - b).map(([, value]) => value),
374
- };
375
- }
376
-
377
- async function anthropicStep({ config, messages, persona, credential, fetchFn, signal, onText }) {
378
- const response = await fetchFn(`${config.baseUrl}/messages`, {
379
- method: "POST",
380
- headers: {
381
- "content-type": "application/json",
382
- accept: "text/event-stream",
383
- Authorization: `Bearer ${credential.accessToken}`,
384
- "anthropic-version": "2023-06-01",
385
- "anthropic-beta": "interleaved-thinking-2025-05-14,fine-grained-tool-streaming-2025-05-14,claude-code-20250219,oauth-2025-04-20",
386
- "user-agent": `claude-code/${process.env.ORACLE_CLAUDE_CODE_VERSION || "2.1.220"} (external, cli)`,
387
- "x-app": "cli",
388
- },
389
- body: JSON.stringify({
390
- model: config.model,
391
- max_tokens: Number(config.maxOutputTokens || 8192),
392
- system: [
393
- { type: "text", text: "You are Claude Code, Anthropic's official CLI for Claude." },
394
- { type: "text", text: persona },
395
- ],
396
- messages: toAnthropicMessages(messages),
397
- tools: allAnthropicTools(),
398
- tool_choice: { type: "auto" },
399
- stream: true,
400
- }),
401
- signal,
402
- });
403
- const toolCalls = new Map();
404
- let text = "";
405
- let usage = null;
406
- for await (const frame of parseSse(response)) {
407
- if (frame.type === "message_start") usage = { ...(usage || {}), ...(frame.message?.usage || {}) };
408
- if (frame.type === "message_delta") usage = { ...(usage || {}), ...(frame.usage || {}) };
409
- if (frame.type === "content_block_start" && frame.content_block?.type === "tool_use") {
410
- const block = frame.content_block;
411
- toolCalls.set(Number(frame.index || 0), {
412
- id: block.id,
413
- type: "function",
414
- function: {
415
- name: block.name,
416
- arguments: block.input && Object.keys(block.input).length ? JSON.stringify(block.input) : "",
417
- },
418
- });
419
- }
420
- if (frame.type === "content_block_delta" && frame.delta?.type === "text_delta") {
421
- text += frame.delta.text || "";
422
- if (frame.delta.text) onText(frame.delta.text);
423
- }
424
- if (frame.type === "content_block_delta" && frame.delta?.type === "input_json_delta") {
425
- const index = Number(frame.index || 0);
426
- const call = toolCalls.get(index);
427
- if (call) call.function.arguments += frame.delta.partial_json || "";
428
- }
429
- if (frame.type === "error") throw new Error(frame.error?.message || "Claude stream failed");
430
- }
431
- return {
432
- text,
433
- usage,
434
- toolCalls: [...toolCalls.entries()].sort(([a], [b]) => a - b).map(([, value]) => {
435
- if (!value.function.arguments) value.function.arguments = "{}";
436
- return value;
437
- }),
438
- };
439
- }
440
-
441
- async function responsesStep({ config, messages, persona, sessionId, credential, fetchFn, signal, onText }) {
442
- const isCodex = config.provider === "openai-codex";
443
- const accountId = isCodex ? accountIdFromJwt(credential.accessToken) : "";
444
- const headers = {
445
- "content-type": "application/json",
446
- accept: "text/event-stream",
447
- Authorization: `Bearer ${credential.accessToken}`,
448
- ...(isCodex ? {
449
- "user-agent": "codex_cli_rs/0.0.0 (Oracle CLI)",
450
- originator: "codex_cli_rs",
451
- ...(accountId ? { "ChatGPT-Account-ID": accountId } : {}),
452
- session_id: sessionId,
453
- "x-client-request-id": sessionId,
454
- } : {
455
- "x-grok-conv-id": sessionId,
456
- }),
457
- };
458
- const body = {
459
- model: config.model,
460
- instructions: persona,
461
- input: toResponsesInput(messages),
462
- tools: allResponseTools(),
463
- tool_choice: "auto",
464
- parallel_tool_calls: true,
465
- store: false,
466
- stream: true,
467
- ...(isCodex ? { reasoning: { effort: config.reasoningEffort || "high", summary: "auto" } } : {}),
468
- };
469
- const response = await fetchFn(`${config.baseUrl}/responses`, {
470
- method: "POST",
471
- headers,
472
- body: JSON.stringify(body),
473
- signal,
474
- });
475
- const toolCalls = new Map();
476
- let text = "";
477
- let usage = null;
478
- for await (const frame of parseSse(response)) {
479
- if (frame.type === "response.output_text.delta" && typeof frame.delta === "string") {
480
- text += frame.delta;
481
- onText(frame.delta);
482
- }
483
- const item = frame.item;
484
- if ((frame.type === "response.output_item.added" || frame.type === "response.output_item.done") && item?.type === "function_call") {
485
- const key = String(item.call_id || item.id || frame.output_index || toolCalls.size);
486
- toolCalls.set(key, {
487
- id: item.call_id || item.id,
488
- response_item_id: item.id,
489
- type: "function",
490
- function: { name: item.name, arguments: item.arguments || "{}" },
491
- });
492
- }
493
- if (frame.type === "response.function_call_arguments.delta") {
494
- const key = String(frame.call_id || frame.item_id || frame.output_index || "");
495
- const call = toolCalls.get(key);
496
- if (call) call.function.arguments += frame.delta || "";
497
- }
498
- if (frame.type === "response.completed") usage = frame.response?.usage || usage;
499
- if (frame.type === "response.failed" || frame.type === "error") {
500
- throw new Error(frame.response?.error?.message || frame.error?.message || "Responses stream failed");
501
- }
502
- }
503
- return { text, usage, toolCalls: [...toolCalls.values()] };
504
- }
505
-
506
- export function createStandaloneClient(options = {}) {
507
- const config = options.config;
508
- if (!config?.baseUrl || !config?.model) throw new Error("standalone model configuration is incomplete");
509
- if (config.authType === "oauth") {
510
- const expected = OAUTH_BASE_URLS[config.provider];
511
- const actual = String(config.baseUrl).replace(/\/+$/, "");
512
- if (!expected || actual !== expected) throw new Error(`${config.provider || "unknown"} OAuth endpoint is not trusted`);
513
- }
514
- const emitter = new EventEmitter();
515
- const fetchFn = options.fetchFn || globalThis.fetch;
516
- const toolRunner = options.toolRunner || ((argv) => runOracleCommand(argv, options));
517
- const credentialProvider = options.credentialProvider || (async (provider) => {
518
- const { resolveOAuthCredentials } = await import("../auth/oauth.mjs");
519
- return resolveOAuthCredentials(provider);
520
- });
521
- const persona = options.persona || defaultPersona();
522
- const sessionId = options.sessionId || `oracle-${randomUUID()}`;
523
- let history = [];
524
- let controller = null;
525
- let stopped = false;
526
- let active = false;
527
-
528
- const scheduler = createScheduler(async (prompt, skills) => {
529
- if (stopped) return;
530
- const skillBlocks = (skills || []).map((name) => {
531
- const content = loadSkill(name);
532
- return content ? `## Skill: ${name}\n${content}` : null;
533
- }).filter(Boolean);
534
- const skillContext = skillBlocks.length > 0 ? `\n\n${skillBlocks.join("\n\n")}` : "";
535
- await performTurn(`${prompt}${skillContext}`);
536
- });
537
- if (envEnabled("ORACLE_CRON_ENABLED", "MAD_CRON_ENABLED", true)) {
538
- scheduler.on("run", (evt) => emitEvent("cron.run", evt));
539
- scheduler.on("complete", (evt) => emitEvent("cron.complete", evt));
540
- scheduler.on("error", (evt) => emitEvent("cron.error", evt));
541
- scheduler.start();
542
- }
543
-
544
- function emitEvent(type, payload = {}) {
545
- emitter.emit("event", eventFrame(type, sessionId, payload));
546
- }
547
-
548
- function emitError(error) {
549
- emitEvent("error", { message: error?.message || String(error) });
550
- if (emitter.listenerCount("error") > 0) emitter.emit("error", error);
551
- }
552
-
553
- async function performTurn(text) {
554
- active = true;
555
- controller = new AbortController();
556
- const messages = [
557
- { role: "system", content: persona },
558
- ...history,
559
- { role: "user", content: text },
560
- ];
561
- let finalText = "";
562
- let usage = null;
563
- let messageStarted = false;
564
-
565
- try {
566
- for (let step = 0; step < MAX_AGENT_STEPS; step += 1) {
567
- const credential = config.authType === "oauth"
568
- ? await credentialProvider(config.provider)
569
- : null;
570
- const onText = (delta) => {
571
- if (!messageStarted) {
572
- emitEvent("message.start", {});
573
- messageStarted = true;
574
- }
575
- finalText += delta;
576
- emitEvent("message.delta", { text: delta });
577
- };
578
- const request = {
579
- config,
580
- messages,
581
- persona,
582
- sessionId,
583
- credential,
584
- fetchFn,
585
- signal: controller.signal,
586
- onText,
587
- };
588
- const result = config.protocol === "anthropic-messages"
589
- ? await anthropicStep(request)
590
- : config.protocol === "responses"
591
- ? await responsesStep(request)
592
- : await chatCompletionStep(request);
593
- const stepText = result.text;
594
- const toolCalls = result.toolCalls;
595
- usage = result.usage || usage;
596
-
597
- if (toolCalls.length === 0) {
598
- messages.push({ role: "assistant", content: stepText });
599
- history = messages.slice(1);
600
- if (!messageStarted) emitEvent("message.start", {});
601
- emitEvent("message.complete", {
602
- text: finalText,
603
- usage: usagePayload(usage, config.contextLength),
604
- });
605
- return;
606
- }
607
-
608
- messages.push({ role: "assistant", content: stepText || null, tool_calls: toolCalls });
609
- let toolCallCount = toolCalls.length;
610
- let toolErrors = 0;
611
- for (const call of toolCalls) {
612
- let result;
613
- try {
614
- const parsed = JSON.parse(call.function.arguments || "{}");
615
- result = await dispatchTool(call.function.name, parsed, toolRunner);
616
- } catch (error) {
617
- result = { ok: false, error: `invalid tool arguments: ${error.message}` };
618
- toolErrors++;
619
- }
620
- if (!result.ok) toolErrors++;
621
- messages.push({
622
- role: "tool",
623
- tool_call_id: call.id || `call_${randomUUID()}`,
624
- content: JSON.stringify(result),
625
- });
626
- }
627
- recordTurn({
628
- userMessage: text,
629
- toolCalls: toolCallCount,
630
- errors: toolErrors,
631
- recovered: toolErrors > 0 ? Boolean(toolCalls.length) : false,
632
- durationMs: 0,
633
- });
634
- }
635
- throw new Error(`agent exceeded ${MAX_AGENT_STEPS} tool steps`);
636
- } catch (error) {
637
- if (error?.name !== "AbortError") emitError(error);
638
- } finally {
639
- active = false;
640
- controller = null;
641
- }
642
- }
643
-
644
- async function start() {
645
- if (stopped) throw new Error("standalone client is stopped");
646
- }
647
-
648
- async function request(method, params = {}) {
649
- if (stopped) throw new Error("standalone client is stopped");
650
- if (method === "session.create") {
651
- emitEvent("session.info", {
652
- model: params.model || config.model,
653
- reasoning_effort: config.reasoningEffort,
654
- usage: { context_max: config.contextLength },
655
- backend: "standalone",
656
- });
657
- return {
658
- session_id: sessionId,
659
- info: {
660
- model: params.model || config.model,
661
- reasoning_effort: config.reasoningEffort,
662
- usage: { context_max: config.contextLength },
663
- backend: "standalone",
664
- },
665
- };
666
- }
667
- if (method === "prompt.submit") {
668
- if (active) throw new Error("a turn is already active");
669
- const text = String(params.text || "").trim();
670
- if (!text) throw new Error("prompt text is required");
671
- queueMicrotask(() => { performTurn(text).catch(emitError); });
672
- return { accepted: true };
673
- }
674
- if (method === "session.interrupt") {
675
- const interrupted = Boolean(controller && active);
676
- controller?.abort();
677
- return { interrupted };
678
- }
679
- if (method === "session.usage") {
680
- return { calls: 0, input: 0, output: 0, total: 0 };
681
- }
682
- throw new Error(`unsupported standalone method: ${method}`);
683
- }
684
-
685
- async function stop() {
686
- if (stopped) return;
687
- stopped = true;
688
- controller?.abort();
689
- scheduler.stop();
690
- }
691
-
692
- return Object.freeze({
693
- start,
694
- request,
695
- stop,
696
- on: emitter.on.bind(emitter),
697
- off: emitter.off.bind(emitter),
698
- });
699
- }
700
-
701
- export async function runStandaloneQuery({
702
- client,
703
- text,
704
- stdout = process.stdout,
705
- stderr = process.stderr,
706
- } = {}) {
707
- if (!client) throw new Error("standalone client is required");
708
- await client.start();
709
- const session = await client.request("session.create", { source: "cli" });
710
- let written = "";
711
- let settled = false;
712
-
713
- try {
714
- return await new Promise((resolve, reject) => {
715
- const handle = (frame) => {
716
- const type = frame?.params?.type;
717
- const payload = frame?.params?.payload || {};
718
- if (type === "message.delta" && typeof payload.text === "string") {
719
- written += payload.text;
720
- stdout.write(payload.text);
721
- return;
722
- }
723
- if (type === "message.complete") {
724
- if (!written && payload.text) stdout.write(String(payload.text));
725
- stdout.write("\n");
726
- settled = true;
727
- resolve(0);
728
- return;
729
- }
730
- if (type === "error") {
731
- const message = payload.message || payload.text || "standalone chat failed";
732
- stderr.write(`oracle chat: ${message}\n`);
733
- settled = true;
734
- reject(new Error(message));
735
- }
736
- };
737
- client.on("event", handle);
738
- client.request("prompt.submit", {
739
- session_id: session.session_id,
740
- text,
741
- }).catch((error) => {
742
- if (settled) return;
743
- settled = true;
744
- reject(error);
745
- });
746
- });
747
- } finally {
748
- await client.stop();
749
- }
750
- }
751
-
752
- export default { createStandaloneClient, runOracleCommand, runStandaloneQuery };