@oracle-agent/oracle 0.11.0 → 0.12.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 (308) hide show
  1. package/LICENSE +115 -201
  2. package/README.md +66 -84
  3. package/SECURITY.md +37 -12
  4. package/SETUP.md +207 -272
  5. package/dist/action-receipts.mjs +1 -0
  6. package/dist/action-semantics.mjs +1 -0
  7. package/dist/address-book.mjs +2 -0
  8. package/dist/bin/desk-server.mjs +14 -0
  9. package/dist/bin/oracle-data-mcp.mjs +8 -0
  10. package/dist/bin/oracle-init.mjs +24 -0
  11. package/dist/bin/oracle-public-server.mjs +5 -0
  12. package/dist/bin/oracle-route.mjs +22 -0
  13. package/dist/bin/oracle-scan.mjs +18 -0
  14. package/dist/bin/oracle-upgrade.mjs +21 -0
  15. package/dist/bin/oracle.mjs +68 -0
  16. package/dist/chains.mjs +1 -0
  17. package/dist/cli/commands/auth.mjs +16 -0
  18. package/dist/cli/commands/bootstrap.mjs +18 -0
  19. package/dist/cli/commands/chain.mjs +21 -0
  20. package/dist/cli/commands/chat.mjs +35 -0
  21. package/dist/cli/commands/credential.mjs +1 -0
  22. package/dist/cli/commands/data-mcp.mjs +2 -0
  23. package/dist/cli/commands/data.mjs +12 -0
  24. package/dist/cli/commands/doctor.mjs +5 -0
  25. package/dist/cli/commands/gate.mjs +13 -0
  26. package/dist/cli/commands/help.mjs +1 -0
  27. package/dist/cli/commands/init.mjs +3 -0
  28. package/dist/cli/commands/mcp.mjs +33 -0
  29. package/dist/cli/commands/model.mjs +44 -0
  30. package/dist/cli/commands/prepare.mjs +2 -0
  31. package/dist/cli/commands/public.mjs +3 -0
  32. package/dist/cli/commands/route.mjs +2 -0
  33. package/dist/cli/commands/runner.mjs +1 -0
  34. package/dist/cli/commands/scan.mjs +2 -0
  35. package/dist/cli/commands/setup.mjs +34 -0
  36. package/dist/cli/commands/sign.mjs +4 -0
  37. package/dist/cli/commands/signer.mjs +1 -0
  38. package/dist/cli/commands/upgrade.mjs +2 -0
  39. package/dist/cli/commands/vault.mjs +1 -0
  40. package/dist/cli/commands/version.mjs +2 -0
  41. package/dist/data/desk-data.mjs +12 -0
  42. package/dist/index.mjs +17 -0
  43. package/dist/nft-gas-war-guard.mjs +1 -0
  44. package/dist/onboarding/harness-configs.mjs +4 -0
  45. package/dist/portfolio-risk.mjs +1 -0
  46. package/dist/prepare-envelope.mjs +1 -0
  47. package/dist/public-control/policy-schema.mjs +1 -0
  48. package/dist/router/index.mjs +2 -0
  49. package/dist/scanner/index.mjs +4 -0
  50. package/dist/signals/index.mjs +1 -0
  51. package/dist/watch-preferences.mjs +1 -0
  52. package/package.json +27 -65
  53. package/public/oracle-splash/index.html +11 -1
  54. package/CONTRIBUTING.md +0 -98
  55. package/bin/desk-server.mjs +0 -440
  56. package/bin/oracle-data-mcp.mjs +0 -1019
  57. package/bin/oracle-init.mjs +0 -496
  58. package/bin/oracle-public-server.mjs +0 -36
  59. package/bin/oracle-route.mjs +0 -254
  60. package/bin/oracle-scan.mjs +0 -192
  61. package/bin/oracle-upgrade.mjs +0 -42
  62. package/bin/oracle.mjs +0 -33
  63. package/docs/adding-a-chain.md +0 -229
  64. package/docs/architecture.md +0 -138
  65. package/docs/cli.md +0 -47
  66. package/docs/connectors.md +0 -13
  67. package/docs/oracle-pack-standard.md +0 -29
  68. package/docs/profiles.md +0 -151
  69. package/docs/public-surface.md +0 -133
  70. package/examples/add-a-chain.mjs +0 -65
  71. package/examples/oracle-pack-template.mjs +0 -38
  72. package/examples/research-a-token.mjs +0 -70
  73. package/plugins/oracle-owner-gate/__init__.py +0 -227
  74. package/plugins/oracle-owner-gate/plugin.yaml +0 -9
  75. package/profiles/_template/SOUL.md +0 -54
  76. package/profiles/_template/profile.json +0 -22
  77. package/profiles/bitcoin-agent/SOUL.md +0 -31
  78. package/profiles/bitcoin-agent/profile.json +0 -32
  79. package/profiles/hyperliquid-agent/SOUL.md +0 -34
  80. package/profiles/hyperliquid-agent/profile.json +0 -37
  81. package/profiles/oracle/SOUL.md +0 -107
  82. package/profiles/oracle/profile.json +0 -39
  83. package/profiles/polymarket-agent/SOUL.md +0 -35
  84. package/profiles/polymarket-agent/profile.json +0 -34
  85. package/profiles/profile.schema.json +0 -90
  86. package/profiles/protocol-builder/SOUL.md +0 -57
  87. package/profiles/protocol-builder/profile.json +0 -39
  88. package/profiles/robinhood-agent/SOUL.md +0 -53
  89. package/profiles/robinhood-agent/profile.json +0 -40
  90. package/profiles/solana-agent/SOUL.md +0 -37
  91. package/profiles/solana-agent/profile.json +0 -37
  92. package/profiles/stable-agent/SOUL.md +0 -43
  93. package/profiles/stable-agent/profile.json +0 -37
  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-inscription.py +0 -230
  101. package/scripts/check-doc-drift.mjs +0 -123
  102. package/scripts/check-test-count.mjs +0 -105
  103. package/scripts/e2e-hl-markets.mjs +0 -21
  104. package/scripts/e2e-hl-perps.mjs +0 -48
  105. package/scripts/e2e-hypercore-staking.mjs +0 -128
  106. package/scripts/e2e-solana-bitcoin.mjs +0 -183
  107. package/scripts/protocol-template-gate.mjs +0 -15
  108. package/scripts/public-api-scan.mjs +0 -23
  109. package/scripts/secret-scan.mjs +0 -181
  110. package/scripts/verify-v3-venues.mjs +0 -192
  111. package/skills/balance/SKILL.md +0 -176
  112. package/skills/oracle-action-semantics/SKILL.md +0 -40
  113. package/skills/oracle-best-execution/SKILL.md +0 -127
  114. package/skills/oracle-bitcoin/SKILL.md +0 -53
  115. package/skills/oracle-chain-graphs-telegram-cards/SKILL.md +0 -59
  116. package/skills/oracle-chat/SKILL.md +0 -61
  117. package/skills/oracle-chat/chain.SKILL.md +0 -31
  118. package/skills/oracle-chat/setup.SKILL.md +0 -37
  119. package/skills/oracle-circuit-breaker/SKILL.md +0 -51
  120. package/skills/oracle-contract-research/SKILL.md +0 -55
  121. package/skills/oracle-desk/SKILL.md +0 -58
  122. package/skills/oracle-dex-launch/SKILL.md +0 -38
  123. package/skills/oracle-grants/SKILL.md +0 -69
  124. package/skills/oracle-hypercore-staking/SKILL.md +0 -57
  125. package/skills/oracle-hyperliquid/SKILL.md +0 -56
  126. package/skills/oracle-meme-token-sniper/SKILL.md +0 -73
  127. package/skills/oracle-multichain-nft-launch/SKILL.md +0 -338
  128. package/skills/oracle-multichain-token-launch/SKILL.md +0 -300
  129. package/skills/oracle-nft-gacha-launch/SKILL.md +0 -48
  130. package/skills/oracle-nft-mint-gas-war/SKILL.md +0 -63
  131. package/skills/oracle-polymarket/SKILL.md +0 -60
  132. package/skills/oracle-protocol-builder/SKILL.md +0 -59
  133. package/skills/oracle-protocol-security/SKILL.md +0 -60
  134. package/skills/oracle-public-product/SKILL.md +0 -44
  135. package/skills/oracle-receipts/SKILL.md +0 -52
  136. package/skills/oracle-rfq-tokenized-assets/SKILL.md +0 -69
  137. package/skills/oracle-smart-wallet-scanner/SKILL.md +0 -49
  138. package/skills/oracle-solana/SKILL.md +0 -65
  139. package/skills/oracle-solana-nft/SKILL.md +0 -54
  140. package/skills/oracle-token-research/SKILL.md +0 -67
  141. package/skins/oracle.yaml +0 -56
  142. package/src/action-receipts.mjs +0 -265
  143. package/src/action-semantics.mjs +0 -62
  144. package/src/address-book.mjs +0 -208
  145. package/src/agent-auth.mjs +0 -206
  146. package/src/approval-guard.mjs +0 -282
  147. package/src/attestation-secret.mjs +0 -88
  148. package/src/audit-log.mjs +0 -196
  149. package/src/auth/oauth.mjs +0 -672
  150. package/src/auto-slippage.mjs +0 -378
  151. package/src/capability-posture.mjs +0 -125
  152. package/src/chains.mjs +0 -62
  153. package/src/cli/chain-catalog.mjs +0 -215
  154. package/src/cli/chain-state.mjs +0 -74
  155. package/src/cli/commands/auth.mjs +0 -193
  156. package/src/cli/commands/bootstrap.mjs +0 -87
  157. package/src/cli/commands/chain.mjs +0 -143
  158. package/src/cli/commands/chat.mjs +0 -434
  159. package/src/cli/commands/credential.mjs +0 -9
  160. package/src/cli/commands/data-mcp.mjs +0 -18
  161. package/src/cli/commands/data.mjs +0 -75
  162. package/src/cli/commands/doctor.mjs +0 -136
  163. package/src/cli/commands/help.mjs +0 -7
  164. package/src/cli/commands/init.mjs +0 -27
  165. package/src/cli/commands/mcp.mjs +0 -142
  166. package/src/cli/commands/model.mjs +0 -99
  167. package/src/cli/commands/prepare.mjs +0 -12
  168. package/src/cli/commands/public.mjs +0 -20
  169. package/src/cli/commands/route.mjs +0 -12
  170. package/src/cli/commands/runner.mjs +0 -9
  171. package/src/cli/commands/scan.mjs +0 -12
  172. package/src/cli/commands/setup.mjs +0 -275
  173. package/src/cli/commands/sign.mjs +0 -21
  174. package/src/cli/commands/signer.mjs +0 -9
  175. package/src/cli/commands/upgrade.mjs +0 -12
  176. package/src/cli/commands/vault.mjs +0 -9
  177. package/src/cli/commands/version.mjs +0 -22
  178. package/src/cli/first-run.mjs +0 -23
  179. package/src/cli/kernel.mjs +0 -239
  180. package/src/cli/mcp-targets/chatgpt.mjs +0 -51
  181. package/src/cli/mcp-targets/claude-code.mjs +0 -39
  182. package/src/cli/mcp-targets/claude-desktop.mjs +0 -24
  183. package/src/cli/mcp-targets/codex.mjs +0 -41
  184. package/src/cli/mcp-targets/shared.mjs +0 -61
  185. package/src/cli/messaging-platforms.mjs +0 -209
  186. package/src/cli/model-config.mjs +0 -70
  187. package/src/cli/operator-dispatch.mjs +0 -258
  188. package/src/cli/oracle-harness.py +0 -415
  189. package/src/cli/paths.mjs +0 -83
  190. package/src/cli/runtime.mjs +0 -351
  191. package/src/cli/setup-state.mjs +0 -168
  192. package/src/cli/spawn-child.mjs +0 -43
  193. package/src/data/catalog.mjs +0 -585
  194. package/src/data/desk-data.mjs +0 -695
  195. package/src/data/http.mjs +0 -253
  196. package/src/data/provider-endpoint.mjs +0 -94
  197. package/src/data/providers/aerodrome.mjs +0 -245
  198. package/src/data/providers/balancer.mjs +0 -209
  199. package/src/data/providers/bitcoin-esplora.mjs +0 -216
  200. package/src/data/providers/bitcoin-meta.mjs +0 -378
  201. package/src/data/providers/blockscout.mjs +0 -14
  202. package/src/data/providers/bridges.mjs +0 -242
  203. package/src/data/providers/cowswap.mjs +0 -415
  204. package/src/data/providers/curve.mjs +0 -201
  205. package/src/data/providers/defillama.mjs +0 -88
  206. package/src/data/providers/dexscreener.mjs +0 -43
  207. package/src/data/providers/evm-rpc.mjs +0 -225
  208. package/src/data/providers/geckoterminal.mjs +0 -34
  209. package/src/data/providers/gmx.mjs +0 -496
  210. package/src/data/providers/hl-assets.mjs +0 -165
  211. package/src/data/providers/hl-info.mjs +0 -108
  212. package/src/data/providers/hl-markets.mjs +0 -210
  213. package/src/data/providers/hl-outcome.mjs +0 -61
  214. package/src/data/providers/hl-perps.mjs +0 -387
  215. package/src/data/providers/hl-staking.mjs +0 -353
  216. package/src/data/providers/hl-ws.mjs +0 -119
  217. package/src/data/providers/hyperevm-dex.mjs +0 -49
  218. package/src/data/providers/jupiter-venues.mjs +0 -119
  219. package/src/data/providers/jupiter.mjs +0 -315
  220. package/src/data/providers/lifi.mjs +0 -151
  221. package/src/data/providers/magiceden-sol.mjs +0 -406
  222. package/src/data/providers/morpho.mjs +0 -177
  223. package/src/data/providers/nft-gallery.mjs +0 -163
  224. package/src/data/providers/nft-portfolio.mjs +0 -494
  225. package/src/data/providers/odos.mjs +0 -156
  226. package/src/data/providers/oneinch.mjs +0 -174
  227. package/src/data/providers/opensea-multichain.mjs +0 -136
  228. package/src/data/providers/opensea-nft.mjs +0 -371
  229. package/src/data/providers/paraswap.mjs +0 -118
  230. package/src/data/providers/pendle.mjs +0 -188
  231. package/src/data/providers/poly-clob.mjs +0 -283
  232. package/src/data/providers/poly-public.mjs +0 -96
  233. package/src/data/providers/poly-ws.mjs +0 -103
  234. package/src/data/providers/portfolio-history.mjs +0 -394
  235. package/src/data/providers/portfolio.mjs +0 -594
  236. package/src/data/providers/rfq.mjs +0 -15
  237. package/src/data/providers/rh-agent.mjs +0 -59
  238. package/src/data/providers/satflow.mjs +0 -341
  239. package/src/data/providers/signed-material-guard.mjs +0 -108
  240. package/src/data/providers/solana-rpc.mjs +0 -197
  241. package/src/data/providers/uniswap-v3.mjs +0 -349
  242. package/src/data/providers/uniswap-v4.mjs +0 -414
  243. package/src/data/providers/zerox.mjs +0 -167
  244. package/src/data/public-api-scan.mjs +0 -61
  245. package/src/data/quote-placeholder.mjs +0 -31
  246. package/src/exact-integer.mjs +0 -72
  247. package/src/exec-policy.mjs +0 -455
  248. package/src/flags.mjs +0 -15
  249. package/src/fresh-window.mjs +0 -76
  250. package/src/gmx-attestation.mjs +0 -176
  251. package/src/index.mjs +0 -100
  252. package/src/nft-gas-war-guard.mjs +0 -139
  253. package/src/onboarding/agent-keys.mjs +0 -161
  254. package/src/onboarding/harness-configs.mjs +0 -102
  255. package/src/onboarding/index.mjs +0 -18
  256. package/src/onboarding/tiers.mjs +0 -139
  257. package/src/oracle-env.mjs +0 -47
  258. package/src/portfolio-risk.mjs +0 -170
  259. package/src/prepare-envelope.mjs +0 -204
  260. package/src/profile-upgrade.mjs +0 -277
  261. package/src/protocol-execution.mjs +0 -84
  262. package/src/protocol-templates/gate.mjs +0 -179
  263. package/src/protocol-templates/prepare-deploy.mjs +0 -81
  264. package/src/public-api/buzz-integration.mjs +0 -256
  265. package/src/public-api/connect-agent.mjs +0 -416
  266. package/src/public-api/grants.mjs +0 -142
  267. package/src/public-api/http.mjs +0 -389
  268. package/src/public-control/aa-adapter.mjs +0 -402
  269. package/src/public-control/build-registry.mjs +0 -227
  270. package/src/public-control/bundler-client.mjs +0 -357
  271. package/src/public-control/grant-indexer.mjs +0 -296
  272. package/src/public-control/policy-render.mjs +0 -69
  273. package/src/public-control/policy-schema.mjs +0 -318
  274. package/src/public-control/runtime-config.mjs +0 -275
  275. package/src/public-control/session-key-model.mjs +0 -374
  276. package/src/public-control/session-orchestrator.mjs +0 -412
  277. package/src/rfq/intent.mjs +0 -180
  278. package/src/rfq/sources.mjs +0 -181
  279. package/src/route-attestation.mjs +0 -132
  280. package/src/router/best-execution.mjs +0 -326
  281. package/src/router/index.mjs +0 -226
  282. package/src/router/prepare-bridge.mjs +0 -289
  283. package/src/router/prepare-route.mjs +0 -398
  284. package/src/router/proposal.mjs +0 -311
  285. package/src/router/risk-classifier.mjs +0 -119
  286. package/src/router/route-sources.mjs +0 -364
  287. package/src/scanner/chains.config.mjs +0 -430
  288. package/src/scanner/contract.mjs +0 -270
  289. package/src/scanner/evm-scanner.mjs +0 -394
  290. package/src/scanner/index.mjs +0 -9
  291. package/src/scanner/v2-venue.mjs +0 -335
  292. package/src/scanner/v3-venue.mjs +0 -290
  293. package/src/scopes.mjs +0 -44
  294. package/src/sell-simulation.mjs +0 -167
  295. package/src/signals/engine.mjs +0 -146
  296. package/src/signals/index.mjs +0 -1
  297. package/src/token-transfer-guard.mjs +0 -188
  298. package/src/tui/app.mjs +0 -438
  299. package/src/tui/backend.mjs +0 -145
  300. package/src/tui/format.mjs +0 -272
  301. package/src/tui/gateway-client.mjs +0 -177
  302. package/src/tui/input.mjs +0 -501
  303. package/src/tui/renderer.mjs +0 -443
  304. package/src/tui/standalone-client.mjs +0 -666
  305. package/src/tui/theme.mjs +0 -81
  306. package/src/vault-attestation.mjs +0 -146
  307. package/src/venues.mjs +0 -206
  308. package/src/watch-preferences.mjs +0 -85
@@ -1,672 +0,0 @@
1
- import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
2
- import fs from "node:fs";
3
- import os from "node:os";
4
- import path from "node:path";
5
- import readline from "node:readline/promises";
6
- import { spawn, spawnSync } from "node:child_process";
7
-
8
- import { ensureDir, oracleConfigDir } from "../cli/paths.mjs";
9
-
10
- const PROVIDERS = Object.freeze({
11
- "anthropic-oauth": {
12
- aliases: ["anthropic-oauth", "anthropic", "claude", "claude-oauth"],
13
- clientId: "9d1c250a-e61b-44d9-88ed-5944d1962f5e",
14
- authorizeUrl: "https://claude.ai/oauth/authorize",
15
- tokenUrl: "https://platform.claude.com/v1/oauth/token",
16
- redirectUri: "https://console.anthropic.com/oauth/code/callback",
17
- scope: "org:create_api_key user:profile user:inference",
18
- baseUrl: "https://api.anthropic.com/v1",
19
- model: "claude-sonnet-4-6",
20
- protocol: "anthropic-messages",
21
- },
22
- "openai-codex": {
23
- aliases: ["openai-codex", "openai-oauth", "codex", "codex-oauth"],
24
- clientId: "app_EMoamEEZ73f0CkXaXp7hrann",
25
- issuer: "https://auth.openai.com",
26
- tokenUrl: "https://auth.openai.com/oauth/token",
27
- baseUrl: "https://chatgpt.com/backend-api/codex",
28
- model: "gpt-5.6-sol",
29
- protocol: "responses",
30
- },
31
- "xai-oauth": {
32
- aliases: ["xai-oauth", "xai", "grok", "grok-oauth"],
33
- clientId: "b1a00492-073a-47ea-816f-4c329264a828",
34
- issuer: "https://auth.x.ai",
35
- discoveryUrl: "https://auth.x.ai/.well-known/openid-configuration",
36
- deviceUrl: "https://auth.x.ai/oauth2/device/code",
37
- scope: "openid profile email offline_access grok-cli:access api:access",
38
- baseUrl: "https://api.x.ai/v1",
39
- model: "grok-4.5",
40
- protocol: "responses",
41
- },
42
- });
43
-
44
- const REFRESH_SKEW_MS = 120_000;
45
-
46
- function nowMs(options = {}) {
47
- return typeof options.now === "function" ? Number(options.now()) : Date.now();
48
- }
49
-
50
- function providerConfig(value) {
51
- return PROVIDERS[oauthProviderId(value)];
52
- }
53
-
54
- export function oauthProviderId(value) {
55
- const needle = String(value || "").trim().toLowerCase();
56
- for (const [id, config] of Object.entries(PROVIDERS)) {
57
- if (config.aliases.includes(needle)) return id;
58
- }
59
- throw new Error(`unsupported OAuth provider: ${value || "(empty)"}`);
60
- }
61
-
62
- export function oauthProviderConfig(value) {
63
- const id = oauthProviderId(value);
64
- return { id, ...PROVIDERS[id] };
65
- }
66
-
67
- function readJson(file, fallback = {}) {
68
- if (!fs.existsSync(file)) return fallback;
69
- try {
70
- const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
71
- if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("invalid object");
72
- return parsed;
73
- } catch {
74
- throw new Error(`credential store is unreadable or corrupt: ${path.basename(file)}`);
75
- }
76
- }
77
-
78
- function ensurePrivateDir(dir) {
79
- ensureDir(dir);
80
- if (process.platform !== "win32") fs.chmodSync(dir, 0o700);
81
- }
82
-
83
- function atomicJsonWrite(file, value) {
84
- ensurePrivateDir(path.dirname(file));
85
- const temp = `${file}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`;
86
- fs.writeFileSync(temp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
87
- fs.renameSync(temp, file);
88
- if (process.platform !== "win32") fs.chmodSync(file, 0o600);
89
- }
90
-
91
- function linuxSecretToolAvailable(spawnFn) {
92
- if (process.platform !== "linux") return false;
93
- const result = spawnFn("secret-tool", ["--version"], {
94
- encoding: "utf8",
95
- stdio: ["ignore", "pipe", "ignore"],
96
- });
97
- return !result.error && result.status === 0;
98
- }
99
-
100
- function normalizeApiKeyProvider(value) {
101
- const provider = String(value || "").trim().toLowerCase();
102
- if (!/^[a-z0-9][a-z0-9._-]*$/.test(provider)) throw new Error(`invalid API-key provider: ${value || "(empty)"}`);
103
- return provider;
104
- }
105
-
106
- function normalizeCredential(credential = {}) {
107
- const accessToken = String(credential.accessToken || credential.access_token || "").trim();
108
- const refreshToken = String(credential.refreshToken || credential.refresh_token || "").trim();
109
- const expiresAt = Number(credential.expiresAt || credential.expires_at || 0);
110
- if (!accessToken) throw new Error("OAuth credential is missing access token");
111
- return {
112
- accessToken,
113
- refreshToken,
114
- expiresAt: Number.isFinite(expiresAt) ? expiresAt : 0,
115
- tokenType: String(credential.tokenType || credential.token_type || "Bearer"),
116
- source: String(credential.source || "oracle"),
117
- ...(credential.discovery ? { discovery: credential.discovery } : {}),
118
- ...(credential.scope ? { scope: credential.scope } : {}),
119
- ...(credential.idToken || credential.id_token ? { idToken: String(credential.idToken || credential.id_token) } : {}),
120
- };
121
- }
122
-
123
- export function createOAuthStore(options = {}) {
124
- const file = options.file || path.join(oracleConfigDir(), "oauth.json");
125
- const metadataFile = options.metadataFile || path.join(path.dirname(file), "oauth-meta.json");
126
- const spawnFn = options.spawnFn || spawnSync;
127
- const useSecretTool = options.keychain !== false &&
128
- process.env.ORACLE_AUTH_FILE_STORE !== "1" &&
129
- linuxSecretToolAvailable(spawnFn);
130
- const storage = useSecretTool ? "linux-secret-service" : "private-file";
131
- const lockFile = `${file}.lock`;
132
-
133
- async function withLock(fn) {
134
- ensurePrivateDir(path.dirname(lockFile));
135
- let descriptor;
136
- for (let attempt = 0; attempt < 400; attempt += 1) {
137
- try {
138
- descriptor = fs.openSync(lockFile, "wx", 0o600);
139
- break;
140
- } catch (error) {
141
- if (error?.code !== "EEXIST") throw error;
142
- try {
143
- if (Date.now() - fs.statSync(lockFile).mtimeMs > 300_000) fs.unlinkSync(lockFile);
144
- } catch {}
145
- await new Promise((resolve) => setTimeout(resolve, 25));
146
- }
147
- }
148
- if (descriptor === undefined) throw new Error("timed out waiting for OAuth credential lock");
149
- try {
150
- return await fn();
151
- } finally {
152
- try { fs.closeSync(descriptor); } catch {}
153
- try { fs.unlinkSync(lockFile); } catch {}
154
- }
155
- }
156
-
157
- function secretArgs(provider, kind = "oauth") {
158
- return ["application", "oracle", "kind", kind, "provider", provider];
159
- }
160
-
161
- function get(providerValue) {
162
- const provider = oauthProviderId(providerValue);
163
- if (useSecretTool) {
164
- const result = spawnFn("secret-tool", ["lookup", ...secretArgs(provider)], {
165
- encoding: "utf8",
166
- stdio: ["ignore", "pipe", "ignore"],
167
- });
168
- if (result.error || result.status !== 0 || !String(result.stdout || "").trim()) return null;
169
- try {
170
- return normalizeCredential(JSON.parse(String(result.stdout).trim()));
171
- } catch {
172
- return null;
173
- }
174
- }
175
- const state = readJson(file, { providers: {} });
176
- const value = state.providers?.[provider];
177
- if (!value) return null;
178
- try {
179
- return normalizeCredential(value);
180
- } catch {
181
- return null;
182
- }
183
- }
184
-
185
- function set(providerValue, credential) {
186
- const provider = oauthProviderId(providerValue);
187
- const normalized = normalizeCredential(credential);
188
- if (useSecretTool) {
189
- const result = spawnFn("secret-tool", ["store", `--label=Oracle ${provider} OAuth`, ...secretArgs(provider)], {
190
- input: JSON.stringify(normalized),
191
- encoding: "utf8",
192
- stdio: ["pipe", "ignore", "pipe"],
193
- });
194
- if (result.error || result.status !== 0) throw new Error("OS credential store rejected OAuth credential");
195
- const metadata = readJson(metadataFile, { providers: {} });
196
- metadata.providers ||= {};
197
- metadata.providers[provider] = {
198
- expiresAt: normalized.expiresAt,
199
- source: normalized.source,
200
- };
201
- atomicJsonWrite(metadataFile, metadata);
202
- return normalized;
203
- }
204
- const state = readJson(file, { providers: {} });
205
- state.providers ||= {};
206
- state.providers[provider] = normalized;
207
- atomicJsonWrite(file, state);
208
- return normalized;
209
- }
210
-
211
- function remove(providerValue) {
212
- const provider = oauthProviderId(providerValue);
213
- if (useSecretTool) {
214
- const result = spawnFn("secret-tool", ["clear", ...secretArgs(provider)], {
215
- encoding: "utf8",
216
- stdio: ["ignore", "ignore", "pipe"],
217
- });
218
- const metadata = readJson(metadataFile, { providers: {} });
219
- if (metadata.providers) delete metadata.providers[provider];
220
- atomicJsonWrite(metadataFile, metadata);
221
- return !result.error && result.status === 0;
222
- }
223
- const state = readJson(file, { providers: {} });
224
- const existed = Boolean(state.providers?.[provider]);
225
- if (state.providers) delete state.providers[provider];
226
- atomicJsonWrite(file, state);
227
- return existed;
228
- }
229
-
230
- function getApiKey(providerValue) {
231
- const provider = normalizeApiKeyProvider(providerValue);
232
- if (useSecretTool) {
233
- const result = spawnFn("secret-tool", ["lookup", ...secretArgs(provider, "api-key")], {
234
- encoding: "utf8",
235
- stdio: ["ignore", "pipe", "ignore"],
236
- });
237
- return result.error || result.status !== 0 ? "" : String(result.stdout || "").trim();
238
- }
239
- return String(readJson(file, { apiKeys: {} }).apiKeys?.[provider] || "").trim();
240
- }
241
-
242
- function setApiKey(providerValue, apiKeyValue) {
243
- const provider = normalizeApiKeyProvider(providerValue);
244
- const apiKey = String(apiKeyValue || "").trim();
245
- if (!apiKey) throw new Error("API key is empty");
246
- if (useSecretTool) {
247
- const result = spawnFn("secret-tool", ["store", `--label=Oracle ${provider} API key`, ...secretArgs(provider, "api-key")], {
248
- input: apiKey,
249
- encoding: "utf8",
250
- stdio: ["pipe", "ignore", "pipe"],
251
- });
252
- if (result.error || result.status !== 0) throw new Error("OS credential store rejected API key");
253
- const metadata = readJson(metadataFile, { providers: {}, apiKeys: {} });
254
- metadata.apiKeys ||= {};
255
- metadata.apiKeys[provider] = { configured: true };
256
- atomicJsonWrite(metadataFile, metadata);
257
- return true;
258
- }
259
- const state = readJson(file, { providers: {}, apiKeys: {} });
260
- state.apiKeys ||= {};
261
- state.apiKeys[provider] = apiKey;
262
- atomicJsonWrite(file, state);
263
- return true;
264
- }
265
-
266
- function removeApiKey(providerValue) {
267
- const provider = normalizeApiKeyProvider(providerValue);
268
- if (useSecretTool) {
269
- const result = spawnFn("secret-tool", ["clear", ...secretArgs(provider, "api-key")], {
270
- encoding: "utf8",
271
- stdio: ["ignore", "ignore", "pipe"],
272
- });
273
- const metadata = readJson(metadataFile, { providers: {}, apiKeys: {} });
274
- if (metadata.apiKeys) delete metadata.apiKeys[provider];
275
- atomicJsonWrite(metadataFile, metadata);
276
- return !result.error && result.status === 0;
277
- }
278
- const state = readJson(file, { providers: {}, apiKeys: {} });
279
- const existed = Boolean(state.apiKeys?.[provider]);
280
- if (state.apiKeys) delete state.apiKeys[provider];
281
- atomicJsonWrite(file, state);
282
- return existed;
283
- }
284
-
285
- function status() {
286
- const providers = {};
287
- const apiKeys = {};
288
- if (useSecretTool) {
289
- const metadata = readJson(metadataFile, { providers: {}, apiKeys: {} });
290
- for (const [provider, value] of Object.entries(metadata.providers || {})) {
291
- providers[provider] = {
292
- loggedIn: Boolean(get(provider)),
293
- expiresAt: Number(value.expiresAt || 0),
294
- source: String(value.source || "oracle"),
295
- storage,
296
- };
297
- }
298
- for (const provider of Object.keys(metadata.apiKeys || {})) {
299
- apiKeys[provider] = { configured: Boolean(getApiKey(provider)), storage };
300
- }
301
- } else {
302
- const state = readJson(file, { providers: {}, apiKeys: {} });
303
- for (const [provider, value] of Object.entries(state.providers || {})) {
304
- providers[provider] = {
305
- loggedIn: Boolean(value?.accessToken),
306
- expiresAt: Number(value?.expiresAt || 0),
307
- source: String(value?.source || "oracle"),
308
- storage,
309
- };
310
- }
311
- for (const [provider, value] of Object.entries(state.apiKeys || {})) {
312
- apiKeys[provider] = { configured: Boolean(value), storage };
313
- }
314
- }
315
- return { storage, providers, apiKeys };
316
- }
317
-
318
- return Object.freeze({
319
- file,
320
- storage,
321
- get,
322
- set,
323
- remove,
324
- getApiKey,
325
- setApiKey,
326
- removeApiKey,
327
- status,
328
- withLock,
329
- });
330
- }
331
-
332
- let defaultStore;
333
- export function getOAuthStore() {
334
- defaultStore ||= createOAuthStore();
335
- return defaultStore;
336
- }
337
-
338
- function base64url(input) {
339
- return Buffer.from(input).toString("base64url");
340
- }
341
-
342
- function generatePkce() {
343
- const verifier = base64url(randomBytes(32));
344
- return {
345
- verifier,
346
- challenge: base64url(createHash("sha256").update(verifier).digest()),
347
- state: base64url(randomBytes(24)),
348
- };
349
- }
350
-
351
- function sameState(left, right) {
352
- const a = Buffer.from(String(left || ""));
353
- const b = Buffer.from(String(right || ""));
354
- return a.length === b.length && timingSafeEqual(a, b);
355
- }
356
-
357
- function openBrowser(url) {
358
- const target = String(url);
359
- const spec = process.platform === "darwin"
360
- ? ["open", [target]]
361
- : process.platform === "win32"
362
- ? ["cmd.exe", ["/d", "/s", "/c", "start", "", target]]
363
- : ["xdg-open", [target]];
364
- try {
365
- const child = spawn(spec[0], spec[1], { detached: true, stdio: "ignore" });
366
- child.unref();
367
- return true;
368
- } catch {
369
- return false;
370
- }
371
- }
372
-
373
- function formBody(value) {
374
- return new URLSearchParams(value).toString();
375
- }
376
-
377
- async function responseJson(response, label) {
378
- if (!response?.ok) {
379
- let code = "";
380
- try {
381
- code = String((await response.json())?.error || "");
382
- } catch {}
383
- throw new Error(`${label} failed (HTTP ${response?.status || "unknown"}${code ? `, ${code}` : ""})`);
384
- }
385
- const payload = await response.json();
386
- if (!payload || typeof payload !== "object") throw new Error(`${label} returned invalid JSON`);
387
- return payload;
388
- }
389
-
390
- async function readAuthorizationCode(inputFn) {
391
- if (inputFn) return String(await inputFn()).trim();
392
- const io = readline.createInterface({ input: process.stdin, output: process.stdout });
393
- try {
394
- return String(await io.question("Authorization code: ")).trim();
395
- } finally {
396
- io.close();
397
- }
398
- }
399
-
400
- function credentialFromTokenPayload(payload, options = {}) {
401
- const accessToken = String(payload.access_token || "").trim();
402
- const refreshToken = String(payload.refresh_token || options.refreshToken || "").trim();
403
- if (!accessToken) throw new Error("OAuth token response is missing access token");
404
- const ttlSeconds = Number(payload.expires_in || 3600);
405
- return normalizeCredential({
406
- accessToken,
407
- refreshToken,
408
- expiresAt: nowMs(options) + Math.max(1, ttlSeconds) * 1000,
409
- tokenType: payload.token_type || "Bearer",
410
- idToken: payload.id_token,
411
- source: "oracle",
412
- ...(options.discovery ? { discovery: options.discovery } : {}),
413
- ...(payload.scope ? { scope: payload.scope } : {}),
414
- });
415
- }
416
-
417
- async function loginClaude(options) {
418
- const config = PROVIDERS["anthropic-oauth"];
419
- const pkce = options.pkce || generatePkce();
420
- const params = new URLSearchParams({
421
- code: "true",
422
- client_id: config.clientId,
423
- response_type: "code",
424
- redirect_uri: config.redirectUri,
425
- scope: config.scope,
426
- code_challenge: pkce.challenge,
427
- code_challenge_method: "S256",
428
- state: pkce.state,
429
- });
430
- const authorizeUrl = `${config.authorizeUrl}?${params}`;
431
- options.output(`Open: ${authorizeUrl}`);
432
- options.openFn(authorizeUrl);
433
- const returned = await readAuthorizationCode(options.inputFn);
434
- const [code, state] = returned.split("#", 2);
435
- if (!code || !sameState(state, pkce.state)) throw new Error("Claude OAuth state mismatch");
436
- const response = await options.fetchFn(config.tokenUrl, {
437
- method: "POST",
438
- headers: {
439
- "content-type": "application/json",
440
- "user-agent": "axios/1.7.9",
441
- },
442
- body: JSON.stringify({
443
- grant_type: "authorization_code",
444
- client_id: config.clientId,
445
- code,
446
- state,
447
- redirect_uri: config.redirectUri,
448
- code_verifier: pkce.verifier,
449
- }),
450
- });
451
- return credentialFromTokenPayload(await responseJson(response, "Claude OAuth token exchange"), options);
452
- }
453
-
454
- async function loginCodex(options) {
455
- const config = PROVIDERS["openai-codex"];
456
- const device = await responseJson(await options.fetchFn(`${config.issuer}/api/accounts/deviceauth/usercode`, {
457
- method: "POST",
458
- headers: { "content-type": "application/json" },
459
- body: JSON.stringify({ client_id: config.clientId }),
460
- }), "Codex device authorization");
461
- if (!device.user_code || !device.device_auth_id) throw new Error("Codex device authorization returned incomplete data");
462
- const verifyUrl = `${config.issuer}/codex/device`;
463
- options.output(`Open: ${verifyUrl}`);
464
- options.output(`Code: ${device.user_code}`);
465
- options.openFn(verifyUrl);
466
- const interval = Math.max(3, Number(device.interval || 5));
467
- let authorization;
468
- for (let attempt = 0; attempt < Math.ceil(900 / interval); attempt += 1) {
469
- await options.sleepFn(interval * 1000);
470
- const response = await options.fetchFn(`${config.issuer}/api/accounts/deviceauth/token`, {
471
- method: "POST",
472
- headers: { "content-type": "application/json" },
473
- body: JSON.stringify({ device_auth_id: device.device_auth_id, user_code: device.user_code }),
474
- });
475
- if (response.ok) {
476
- authorization = await responseJson(response, "Codex device authorization");
477
- break;
478
- }
479
- if (![403, 404].includes(response.status)) throw new Error(`Codex device authorization failed (HTTP ${response.status})`);
480
- }
481
- if (!authorization) throw new Error("Codex device authorization timed out");
482
- const response = await options.fetchFn(config.tokenUrl, {
483
- method: "POST",
484
- headers: { "content-type": "application/x-www-form-urlencoded" },
485
- body: formBody({
486
- grant_type: "authorization_code",
487
- code: authorization.authorization_code,
488
- redirect_uri: `${config.issuer}/deviceauth/callback`,
489
- client_id: config.clientId,
490
- code_verifier: authorization.code_verifier,
491
- }),
492
- });
493
- return credentialFromTokenPayload(await responseJson(response, "Codex OAuth token exchange"), options);
494
- }
495
-
496
- function validateXaiUrl(value) {
497
- const url = new URL(String(value));
498
- const host = url.hostname.toLowerCase();
499
- if (url.protocol !== "https:" || (host !== "x.ai" && !host.endsWith(".x.ai"))) {
500
- throw new Error("xAI OAuth discovery returned an untrusted endpoint");
501
- }
502
- return url.toString();
503
- }
504
-
505
- async function loginGrok(options) {
506
- const config = PROVIDERS["xai-oauth"];
507
- const discovery = await responseJson(await options.fetchFn(config.discoveryUrl, {
508
- headers: { accept: "application/json" },
509
- }), "xAI OAuth discovery");
510
- validateXaiUrl(discovery.authorization_endpoint);
511
- const tokenEndpoint = validateXaiUrl(discovery.token_endpoint);
512
- const device = await responseJson(await options.fetchFn(config.deviceUrl, {
513
- method: "POST",
514
- headers: {
515
- "content-type": "application/x-www-form-urlencoded",
516
- accept: "application/json",
517
- },
518
- body: formBody({ client_id: config.clientId, scope: config.scope }),
519
- }), "xAI device authorization");
520
- if (!device.device_code || !device.user_code || !device.verification_uri) {
521
- throw new Error("xAI device authorization returned incomplete data");
522
- }
523
- const verifyUrl = validateXaiUrl(device.verification_uri_complete || device.verification_uri);
524
- options.output(`Open: ${verifyUrl}`);
525
- options.output(`Code: ${device.user_code}`);
526
- options.openFn(verifyUrl);
527
- const interval = Math.max(1, Number(device.interval || 5));
528
- const attempts = Math.ceil(Math.max(1, Number(device.expires_in || 600)) / interval);
529
- for (let attempt = 0; attempt < attempts; attempt += 1) {
530
- const response = await options.fetchFn(tokenEndpoint, {
531
- method: "POST",
532
- headers: {
533
- "content-type": "application/x-www-form-urlencoded",
534
- accept: "application/json",
535
- },
536
- body: formBody({
537
- grant_type: "urn:ietf:params:oauth:grant-type:device_code",
538
- client_id: config.clientId,
539
- device_code: device.device_code,
540
- }),
541
- });
542
- if (response.ok) {
543
- const payload = await responseJson(response, "xAI OAuth token exchange");
544
- return credentialFromTokenPayload(payload, {
545
- ...options,
546
- discovery: {
547
- authorization_endpoint: validateXaiUrl(discovery.authorization_endpoint),
548
- token_endpoint: tokenEndpoint,
549
- },
550
- });
551
- }
552
- let code = "";
553
- try {
554
- code = String((await response.json())?.error || "");
555
- } catch {}
556
- if (code === "slow_down") await options.sleepFn((interval + 1) * 1000);
557
- else if (code === "authorization_pending") await options.sleepFn(interval * 1000);
558
- else throw new Error(`xAI OAuth token exchange failed (HTTP ${response.status}${code ? `, ${code}` : ""})`);
559
- }
560
- throw new Error("xAI device authorization timed out");
561
- }
562
-
563
- export async function loginOAuth(providerValue, options = {}) {
564
- const provider = oauthProviderId(providerValue);
565
- const normalized = {
566
- fetchFn: options.fetchFn || globalThis.fetch,
567
- inputFn: options.inputFn,
568
- sleepFn: options.sleepFn || ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
569
- openFn: options.openFn || openBrowser,
570
- output: options.output || ((line) => process.stdout.write(`${line}\n`)),
571
- now: options.now,
572
- pkce: options.pkce,
573
- };
574
- if (provider === "anthropic-oauth") return loginClaude(normalized);
575
- if (provider === "openai-codex") return loginCodex(normalized);
576
- return loginGrok(normalized);
577
- }
578
-
579
- export async function refreshOAuthCredentials(providerValue, credential, options = {}) {
580
- const provider = oauthProviderId(providerValue);
581
- const config = PROVIDERS[provider];
582
- const current = normalizeCredential(credential);
583
- if (!current.refreshToken) throw new Error(`${provider} OAuth credential cannot refresh; run oracle auth login`);
584
- let discovery = current.discovery;
585
- let endpoint;
586
- const fetchFn = options.fetchFn || globalThis.fetch;
587
- if (provider === "xai-oauth") {
588
- if (!discovery?.token_endpoint) {
589
- const discoveryResponse = await fetchFn(config.discoveryUrl);
590
- const discovered = await responseJson(discoveryResponse, "xAI OAuth discovery");
591
- discovery = {
592
- ...(discovered.authorization_endpoint
593
- ? { authorization_endpoint: validateXaiUrl(discovered.authorization_endpoint) }
594
- : {}),
595
- token_endpoint: validateXaiUrl(discovered.token_endpoint),
596
- };
597
- }
598
- endpoint = validateXaiUrl(discovery.token_endpoint);
599
- } else {
600
- endpoint = config.tokenUrl;
601
- }
602
- const response = await fetchFn(endpoint, {
603
- method: "POST",
604
- headers: {
605
- "content-type": "application/x-www-form-urlencoded",
606
- accept: "application/json",
607
- ...(provider === "anthropic-oauth" ? { "user-agent": "axios/1.7.9" } : {}),
608
- },
609
- body: formBody({
610
- grant_type: "refresh_token",
611
- refresh_token: current.refreshToken,
612
- client_id: config.clientId,
613
- }),
614
- });
615
- const payload = await responseJson(response, `${provider} OAuth refresh`);
616
- return credentialFromTokenPayload(payload, {
617
- ...options,
618
- refreshToken: current.refreshToken,
619
- discovery,
620
- });
621
- }
622
-
623
- export async function resolveOAuthCredentials(providerValue, options = {}) {
624
- const provider = oauthProviderId(providerValue);
625
- const store = options.store || getOAuthStore();
626
- const credential = store.get(provider);
627
- if (!credential) throw new Error(`${provider} OAuth is not logged in; run oracle auth login ${providerValue}`);
628
- const now = nowMs(options);
629
- if (!credential.expiresAt || credential.expiresAt > now + REFRESH_SKEW_MS) return credential;
630
- const refresh = async () => {
631
- const current = store.get(provider);
632
- if (!current) throw new Error(`${provider} OAuth is not logged in; run oracle auth login ${providerValue}`);
633
- const checkedAt = nowMs(options);
634
- if (!current.expiresAt || current.expiresAt > checkedAt + REFRESH_SKEW_MS) return current;
635
- const refreshed = await refreshOAuthCredentials(provider, current, options);
636
- store.set(provider, refreshed);
637
- return refreshed;
638
- };
639
- return typeof store.withLock === "function" ? store.withLock(refresh) : refresh();
640
- }
641
-
642
- export function hasOAuthCredentials(providerValue, options = {}) {
643
- try {
644
- return Boolean((options.store || getOAuthStore()).get(providerValue)?.accessToken);
645
- } catch {
646
- return false;
647
- }
648
- }
649
-
650
- export function oauthRuntimeConfig(providerValue) {
651
- const config = oauthProviderConfig(providerValue);
652
- return {
653
- kind: "standalone",
654
- provider: config.id,
655
- model: config.model,
656
- baseUrl: config.baseUrl,
657
- authType: "oauth",
658
- protocol: config.protocol,
659
- };
660
- }
661
-
662
- export default {
663
- createOAuthStore,
664
- getOAuthStore,
665
- hasOAuthCredentials,
666
- loginOAuth,
667
- oauthProviderConfig,
668
- oauthProviderId,
669
- oauthRuntimeConfig,
670
- refreshOAuthCredentials,
671
- resolveOAuthCredentials,
672
- };