@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
package/src/tui/input.mjs DELETED
@@ -1,501 +0,0 @@
1
- const EMPTY = Buffer.alloc(0);
2
-
3
- const SPECIAL_NAMES = new Set([
4
- "return",
5
- "backspace",
6
- "tab",
7
- "escape",
8
- "up",
9
- "down",
10
- "left",
11
- "right",
12
- "home",
13
- "end",
14
- "delete",
15
- "insert",
16
- "pageup",
17
- "pagedown",
18
- "unknown",
19
- ]);
20
-
21
- const CSI_FINALS = {
22
- A: "up",
23
- B: "down",
24
- C: "right",
25
- D: "left",
26
- H: "home",
27
- F: "end",
28
- P: "f1",
29
- Q: "f2",
30
- R: "f3",
31
- S: "f4",
32
- };
33
-
34
- const TILDE_CODES = {
35
- 1: "home",
36
- 2: "insert",
37
- 3: "delete",
38
- 4: "end",
39
- 5: "pageup",
40
- 6: "pagedown",
41
- 7: "home",
42
- 8: "end",
43
- };
44
-
45
- function makeKey({ name = null, ctrl = false, meta = false, shift = false, sequence = "" }) {
46
- return { name, ctrl, meta, shift, sequence };
47
- }
48
-
49
- function utf8Length(lead) {
50
- if (lead < 0x80) return 1;
51
- if (lead >= 0xf0) return 4;
52
- if (lead >= 0xe0) return 3;
53
- if (lead >= 0xc0) return 2;
54
- return 1;
55
- }
56
-
57
- function isFinalByte(b) {
58
- return b >= 0x40 && b <= 0x7e;
59
- }
60
-
61
- function charKey(text) {
62
- const lower = text.toLowerCase();
63
- return makeKey({
64
- name: lower,
65
- shift: text !== lower,
66
- sequence: text,
67
- });
68
- }
69
-
70
- function controlKey(b) {
71
- if (b === 0x0d) return makeKey({ name: "return", sequence: "\r" });
72
- if (b === 0x0a) return makeKey({ name: "return", sequence: "\n" });
73
- if (b === 0x09) return makeKey({ name: "tab", sequence: "\t" });
74
- if (b === 0x7f) return makeKey({ name: "backspace", sequence: "\u007f" });
75
- if (b === 0x08) return makeKey({ name: "backspace", sequence: "\b" });
76
- if (b >= 0x01 && b <= 0x1a) {
77
- return makeKey({
78
- name: String.fromCharCode(b + 0x60),
79
- ctrl: true,
80
- sequence: String.fromCharCode(b),
81
- });
82
- }
83
- return makeKey({ name: "unknown", sequence: String.fromCharCode(b) });
84
- }
85
-
86
- function csiKey(sequence) {
87
- const match = /^\u001b[\[O](\d*)(?:;(\d+))?(.)$/s.exec(sequence);
88
- if (!match) return makeKey({ name: "unknown", sequence });
89
- const first = match[1] === "" ? null : Number(match[1]);
90
- const second = match[2] === undefined ? null : Number(match[2]);
91
- const final = match[3];
92
-
93
- let name = null;
94
- let modifier = second;
95
- if (final === "~") {
96
- name = TILDE_CODES[first] ?? null;
97
- } else {
98
- name = CSI_FINALS[final] ?? null;
99
- if (modifier === null && first !== null && first > 1) modifier = first;
100
- }
101
- if (!name) return makeKey({ name: "unknown", sequence });
102
-
103
- const bits = modifier === null ? 0 : Math.max(0, modifier - 1);
104
- return makeKey({
105
- name,
106
- shift: (bits & 1) !== 0,
107
- meta: (bits & 2) !== 0,
108
- ctrl: (bits & 4) !== 0,
109
- sequence,
110
- });
111
- }
112
-
113
- function decodeEscape(buf, start, keys, flush) {
114
- const escape = () => {
115
- keys.push(makeKey({ name: "escape", sequence: "\u001b" }));
116
- return 1;
117
- };
118
- if (start + 1 >= buf.length) return flush ? escape() : 0;
119
-
120
- const next = buf[start + 1];
121
- if (next === 0x5b || next === 0x4f) {
122
- let j = start + 2;
123
- while (j < buf.length && !isFinalByte(buf[j])) j += 1;
124
- if (j >= buf.length) return flush ? escape() : 0;
125
- keys.push(csiKey(buf.toString("utf8", start, j + 1)));
126
- return j + 1 - start;
127
- }
128
- if (next === 0x1b) return escape();
129
-
130
- const width = utf8Length(next);
131
- if (start + 1 + width > buf.length) return flush ? escape() : 0;
132
- const text = buf.toString("utf8", start + 1, start + 1 + width);
133
- const lower = text.toLowerCase();
134
- keys.push(makeKey({
135
- name: lower,
136
- meta: true,
137
- shift: text !== lower,
138
- sequence: `\u001b${text}`,
139
- }));
140
- return 1 + width;
141
- }
142
-
143
- function decodeChunk(buf, flush) {
144
- const keys = [];
145
- let i = 0;
146
- while (i < buf.length) {
147
- const b = buf[i];
148
- if (b === 0x1b) {
149
- const consumed = decodeEscape(buf, i, keys, flush);
150
- if (consumed === 0) return { keys, rest: Buffer.from(buf.subarray(i)) };
151
- i += consumed;
152
- continue;
153
- }
154
- if (b < 0x20 || b === 0x7f) {
155
- keys.push(controlKey(b));
156
- i += 1;
157
- continue;
158
- }
159
- const width = utf8Length(b);
160
- if (i + width > buf.length) {
161
- if (!flush) return { keys, rest: Buffer.from(buf.subarray(i)) };
162
- keys.push(charKey(buf.toString("utf8", i)));
163
- return { keys, rest: EMPTY };
164
- }
165
- keys.push(charKey(buf.toString("utf8", i, i + width)));
166
- i += width;
167
- }
168
- return { keys, rest: EMPTY };
169
- }
170
-
171
- function toBuffer(chunk) {
172
- if (Buffer.isBuffer(chunk)) return chunk;
173
- if (chunk === null || chunk === undefined) return EMPTY;
174
- if (typeof chunk === "string") return Buffer.from(chunk, "utf8");
175
- return Buffer.from(chunk);
176
- }
177
-
178
- let decodeKeysPending = EMPTY;
179
-
180
- export function decodeKeys(chunk) {
181
- const buf = decodeKeysPending.length === 0
182
- ? toBuffer(chunk)
183
- : Buffer.concat([decodeKeysPending, toBuffer(chunk)]);
184
- const { keys, rest } = decodeChunk(buf, false);
185
- if (rest.length === 1 && rest[0] === 0x1b) {
186
- decodeKeysPending = EMPTY;
187
- return [...keys, makeKey({ name: "escape", sequence: "\u001b" })];
188
- }
189
- decodeKeysPending = rest;
190
- return keys;
191
- }
192
-
193
- export function createDecoder() {
194
- let pending = EMPTY;
195
- return {
196
- push(chunk) {
197
- const buf = pending.length === 0
198
- ? toBuffer(chunk)
199
- : Buffer.concat([pending, toBuffer(chunk)]);
200
- const { keys, rest } = decodeChunk(buf, false);
201
- pending = rest;
202
- return keys;
203
- },
204
- flush() {
205
- if (pending.length === 0) return [];
206
- const { keys } = decodeChunk(pending, true);
207
- pending = EMPTY;
208
- return keys;
209
- },
210
- get pending() {
211
- return pending.length;
212
- },
213
- };
214
- }
215
-
216
- export function createEditorState({ history = [] } = {}) {
217
- const entries = [...history];
218
- return {
219
- buffer: "",
220
- cursor: 0,
221
- history: entries,
222
- historyIndex: entries.length,
223
- draft: "",
224
- };
225
- }
226
-
227
- function stepLeft(text, index) {
228
- if (index <= 0) return 0;
229
- const prev = index - 1;
230
- const code = text.charCodeAt(prev);
231
- if (code >= 0xdc00 && code <= 0xdfff && prev > 0) {
232
- const lead = text.charCodeAt(prev - 1);
233
- if (lead >= 0xd800 && lead <= 0xdbff) return prev - 1;
234
- }
235
- return prev;
236
- }
237
-
238
- function stepRight(text, index) {
239
- if (index >= text.length) return text.length;
240
- const code = text.charCodeAt(index);
241
- if (code >= 0xd800 && code <= 0xdbff && index + 1 < text.length) return index + 2;
242
- return index + 1;
243
- }
244
-
245
- function next(state, patch) {
246
- return { ...state, ...patch };
247
- }
248
-
249
- function live(state, patch) {
250
- return next(state, { ...patch, historyIndex: state.history.length, draft: "" });
251
- }
252
-
253
- function isPrintable(key) {
254
- if (key.ctrl || key.meta) return false;
255
- if (!key.sequence) return false;
256
- if (SPECIAL_NAMES.has(key.name)) return false;
257
- for (const ch of key.sequence) {
258
- const code = ch.codePointAt(0);
259
- if (code < 0x20 || code === 0x7f) return false;
260
- }
261
- return true;
262
- }
263
-
264
- function killPrevWord(text, cursor) {
265
- let i = cursor;
266
- while (i > 0 && /\s/.test(text[i - 1])) i -= 1;
267
- while (i > 0 && !/\s/.test(text[i - 1])) i -= 1;
268
- return i;
269
- }
270
-
271
- function historyUp(state) {
272
- if (state.historyIndex <= 0) return { state: next(state, {}), action: null };
273
- const atLive = state.historyIndex >= state.history.length;
274
- const index = state.historyIndex - 1;
275
- const buffer = state.history[index] ?? "";
276
- return {
277
- state: next(state, {
278
- buffer,
279
- cursor: buffer.length,
280
- historyIndex: index,
281
- draft: atLive ? state.buffer : state.draft,
282
- }),
283
- action: null,
284
- };
285
- }
286
-
287
- function historyDown(state) {
288
- if (state.historyIndex >= state.history.length) return { state: next(state, {}), action: null };
289
- const index = state.historyIndex + 1;
290
- const restored = index >= state.history.length;
291
- const buffer = restored ? state.draft : (state.history[index] ?? "");
292
- return {
293
- state: next(state, {
294
- buffer,
295
- cursor: buffer.length,
296
- historyIndex: index,
297
- draft: restored ? "" : state.draft,
298
- }),
299
- action: null,
300
- };
301
- }
302
-
303
- function submit(state) {
304
- const value = state.buffer.trim();
305
- if (value === "") {
306
- return {
307
- state: live(state, { buffer: "", cursor: 0 }),
308
- action: null,
309
- };
310
- }
311
- const history = state.history[state.history.length - 1] === value
312
- ? [...state.history]
313
- : [...state.history, value];
314
- return {
315
- state: next(state, {
316
- buffer: "",
317
- cursor: 0,
318
- history,
319
- historyIndex: history.length,
320
- draft: "",
321
- }),
322
- action: { type: "submit", value },
323
- };
324
- }
325
-
326
- export function applyKey(state, key) {
327
- if (!key) return { state: next(state, {}), action: null };
328
- const { buffer, cursor } = state;
329
-
330
- if (key.ctrl && !key.meta) {
331
- switch (key.name) {
332
- case "c":
333
- return { state: live(state, { buffer: "", cursor: 0 }), action: { type: "cancel" } };
334
- case "d":
335
- if (buffer === "") return { state: next(state, {}), action: { type: "eof" } };
336
- return { state: next(state, {}), action: null };
337
- case "l":
338
- return { state: next(state, {}), action: { type: "clear" } };
339
- case "a":
340
- return { state: next(state, { cursor: 0 }), action: null };
341
- case "e":
342
- return { state: next(state, { cursor: buffer.length }), action: null };
343
- case "u":
344
- return {
345
- state: next(state, { buffer: buffer.slice(cursor), cursor: 0 }),
346
- action: null,
347
- };
348
- case "k":
349
- return { state: next(state, { buffer: buffer.slice(0, cursor) }), action: null };
350
- case "w": {
351
- const start = killPrevWord(buffer, cursor);
352
- return {
353
- state: next(state, {
354
- buffer: buffer.slice(0, start) + buffer.slice(cursor),
355
- cursor: start,
356
- }),
357
- action: null,
358
- };
359
- }
360
- case "b":
361
- return { state: next(state, { cursor: stepLeft(buffer, cursor) }), action: null };
362
- case "f":
363
- return { state: next(state, { cursor: stepRight(buffer, cursor) }), action: null };
364
- default:
365
- return { state: next(state, {}), action: null };
366
- }
367
- }
368
-
369
- switch (key.name) {
370
- case "return":
371
- return submit(state);
372
- case "left":
373
- return { state: next(state, { cursor: stepLeft(buffer, cursor) }), action: null };
374
- case "right":
375
- return { state: next(state, { cursor: stepRight(buffer, cursor) }), action: null };
376
- case "home":
377
- return { state: next(state, { cursor: 0 }), action: null };
378
- case "end":
379
- return { state: next(state, { cursor: buffer.length }), action: null };
380
- case "up":
381
- return historyUp(state);
382
- case "down":
383
- return historyDown(state);
384
- case "backspace": {
385
- if (cursor === 0) return { state: next(state, {}), action: null };
386
- const start = stepLeft(buffer, cursor);
387
- return {
388
- state: next(state, {
389
- buffer: buffer.slice(0, start) + buffer.slice(cursor),
390
- cursor: start,
391
- }),
392
- action: null,
393
- };
394
- }
395
- case "delete": {
396
- if (cursor >= buffer.length) return { state: next(state, {}), action: null };
397
- const end = stepRight(buffer, cursor);
398
- return {
399
- state: next(state, { buffer: buffer.slice(0, cursor) + buffer.slice(end) }),
400
- action: null,
401
- };
402
- }
403
- default:
404
- break;
405
- }
406
-
407
- if (isPrintable(key)) {
408
- const text = key.sequence;
409
- return {
410
- state: next(state, {
411
- buffer: buffer.slice(0, cursor) + text + buffer.slice(cursor),
412
- cursor: cursor + text.length,
413
- }),
414
- action: null,
415
- };
416
- }
417
-
418
- return { state: next(state, {}), action: null };
419
- }
420
-
421
- export function createInput(options = {}) {
422
- const {
423
- stdin,
424
- stdout,
425
- history = [],
426
- onSubmit,
427
- onCancel,
428
- onEof,
429
- onClear,
430
- onRender,
431
- } = options;
432
-
433
- const input = stdin ?? process.stdin;
434
- const output = stdout ?? process.stdout;
435
- const decoder = createDecoder();
436
- const handlers = {
437
- submit: onSubmit,
438
- cancel: onCancel,
439
- eof: onEof,
440
- clear: onClear,
441
- };
442
-
443
- let state = createEditorState({ history });
444
- let started = false;
445
- let rawApplied = false;
446
- let priorRaw = false;
447
-
448
- const emit = (action) => {
449
- if (!action) return;
450
- const handler = handlers[action.type];
451
- if (typeof handler === "function") handler(action.value, state);
452
- };
453
-
454
- const onData = (chunk) => {
455
- for (const key of decoder.push(chunk)) {
456
- const result = applyKey(state, key);
457
- state = result.state;
458
- emit(result.action);
459
- if (typeof onRender === "function") onRender(state);
460
- }
461
- };
462
-
463
- return {
464
- start() {
465
- if (started) return;
466
- started = true;
467
- if (input.isTTY && typeof input.setRawMode === "function") {
468
- priorRaw = input.isRaw === true;
469
- input.setRawMode(true);
470
- rawApplied = true;
471
- }
472
- if (typeof input.resume === "function") input.resume();
473
- input.on("data", onData);
474
- if (typeof onRender === "function") onRender(state);
475
- },
476
- stop() {
477
- if (!started) return;
478
- started = false;
479
- if (typeof input.off === "function") input.off("data", onData);
480
- else if (typeof input.removeListener === "function") input.removeListener("data", onData);
481
- if (rawApplied && typeof input.setRawMode === "function") {
482
- input.setRawMode(priorRaw);
483
- rawApplied = false;
484
- }
485
- if (typeof input.pause === "function") input.pause();
486
- },
487
- getState() {
488
- return state;
489
- },
490
- setState(nextState) {
491
- state = nextState;
492
- return state;
493
- },
494
- write(text) {
495
- if (output && typeof output.write === "function") output.write(text);
496
- },
497
- get isRunning() {
498
- return started;
499
- },
500
- };
501
- }