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