tenjin-cli 0.1.0-alpha.2 → 0.1.0-alpha.21

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 (219) hide show
  1. package/NOTICE.md +54 -7
  2. package/README.md +175 -256
  3. package/dist/{_esm-FEASBWRP.js → _esm-CE7KNONL.js} +9 -10
  4. package/dist/{ccip-NQXCEK2U.js → ccip-7RMRLAGV.js} +4 -4
  5. package/dist/{ccip-XR5NE5QK.js → ccip-NLCSCHKI.js} +5 -5
  6. package/dist/chunk-2AQO4YDI.js +291 -0
  7. package/dist/chunk-2AQO4YDI.js.map +1 -0
  8. package/dist/chunk-2QYORQBF.js +55 -0
  9. package/dist/chunk-2QYORQBF.js.map +1 -0
  10. package/dist/chunk-3EUTWC2B.js +194 -0
  11. package/dist/chunk-3EUTWC2B.js.map +1 -0
  12. package/dist/{chunk-ZMHYXMO6.js → chunk-5IEP5EGE.js} +3 -3
  13. package/dist/chunk-7QKHZQKW.js +1680 -0
  14. package/dist/chunk-7QKHZQKW.js.map +1 -0
  15. package/dist/chunk-A36LQPHV.js +29 -0
  16. package/dist/chunk-A36LQPHV.js.map +1 -0
  17. package/dist/{chunk-XJIW7USF.js → chunk-AQRUD5GQ.js} +115 -11
  18. package/dist/chunk-AQRUD5GQ.js.map +1 -0
  19. package/dist/{chunk-UGX7YPX2.js → chunk-AWQPGIR6.js} +7 -9
  20. package/dist/{chunk-UGX7YPX2.js.map → chunk-AWQPGIR6.js.map} +1 -1
  21. package/dist/{chunk-5CLSD5YN.js → chunk-BPMWXTFX.js} +2 -2
  22. package/dist/chunk-C363JZN2.js +127 -0
  23. package/dist/chunk-C363JZN2.js.map +1 -0
  24. package/dist/{chunk-YALGASEU.js → chunk-EGELTSPU.js} +2 -2
  25. package/dist/chunk-ETW2ASBP.js +10562 -0
  26. package/dist/chunk-ETW2ASBP.js.map +1 -0
  27. package/dist/chunk-GHTPYKDT.js +112 -0
  28. package/dist/chunk-GHTPYKDT.js.map +1 -0
  29. package/dist/{chunk-CYOF7ROH.js → chunk-HPWO4O6S.js} +3 -3
  30. package/dist/chunk-IOB7URFH.js +242 -0
  31. package/dist/chunk-IOB7URFH.js.map +1 -0
  32. package/dist/chunk-IOIHYOU4.js +1784 -0
  33. package/dist/chunk-IOIHYOU4.js.map +1 -0
  34. package/dist/chunk-JLEF5WHM.js +132 -0
  35. package/dist/chunk-JLEF5WHM.js.map +1 -0
  36. package/dist/chunk-JN7TMXVF.js +172 -0
  37. package/dist/chunk-JN7TMXVF.js.map +1 -0
  38. package/dist/{chunk-QVX5MWJZ.js → chunk-JRGFKVAZ.js} +2 -2
  39. package/dist/chunk-K6AXXYCG.js +109 -0
  40. package/dist/chunk-K6AXXYCG.js.map +1 -0
  41. package/dist/{chunk-HIVZG55D.js → chunk-KG3D7FIF.js} +2 -2
  42. package/dist/chunk-LAIZ2AQA.js +107 -0
  43. package/dist/chunk-LAIZ2AQA.js.map +1 -0
  44. package/dist/chunk-LHHMV4GU.js +27 -0
  45. package/dist/chunk-LHHMV4GU.js.map +1 -0
  46. package/dist/{chunk-YBMMV4Y4.js → chunk-MEFB5KHA.js} +13 -5
  47. package/dist/chunk-MEFB5KHA.js.map +1 -0
  48. package/dist/{chunk-NCE5NSN6.js → chunk-N35E6CM2.js} +140 -10
  49. package/dist/chunk-N35E6CM2.js.map +1 -0
  50. package/dist/chunk-N4DJEQAF.js +190 -0
  51. package/dist/chunk-N4DJEQAF.js.map +1 -0
  52. package/dist/chunk-O2JYBOUO.js +47 -0
  53. package/dist/chunk-O2JYBOUO.js.map +1 -0
  54. package/dist/chunk-OSUD6YZZ.js +451 -0
  55. package/dist/chunk-OSUD6YZZ.js.map +1 -0
  56. package/dist/chunk-OTPEH3AH.js +926 -0
  57. package/dist/chunk-OTPEH3AH.js.map +1 -0
  58. package/dist/chunk-PJEG2JIJ.js +242 -0
  59. package/dist/chunk-PJEG2JIJ.js.map +1 -0
  60. package/dist/{chunk-ZABPQJ3M.js → chunk-POUWHWID.js} +2 -2
  61. package/dist/chunk-QF4SSCQV.js +377 -0
  62. package/dist/chunk-QF4SSCQV.js.map +1 -0
  63. package/dist/chunk-QHILSA6G.js +82 -0
  64. package/dist/chunk-QHILSA6G.js.map +1 -0
  65. package/dist/chunk-QRFONFRW.js +231 -0
  66. package/dist/chunk-QRFONFRW.js.map +1 -0
  67. package/dist/{chunk-N62ROTMC.js → chunk-RCJQARZF.js} +14 -10
  68. package/dist/chunk-RCJQARZF.js.map +1 -0
  69. package/dist/{chunk-S3IGX57D.js → chunk-RGVOODF4.js} +7703 -7475
  70. package/dist/chunk-RGVOODF4.js.map +1 -0
  71. package/dist/chunk-S2NRVRPF.js +171 -0
  72. package/dist/chunk-S2NRVRPF.js.map +1 -0
  73. package/dist/chunk-SRVDXR6B.js +337 -0
  74. package/dist/chunk-SRVDXR6B.js.map +1 -0
  75. package/dist/chunk-TGLKKLQG.js +11 -0
  76. package/dist/chunk-TGLKKLQG.js.map +1 -0
  77. package/dist/{chunk-RRN3YTK7.js → chunk-TTNESUPQ.js} +3 -3
  78. package/dist/chunk-U2ATFMKZ.js +164 -0
  79. package/dist/chunk-U2ATFMKZ.js.map +1 -0
  80. package/dist/chunk-UY2TOI3B.js +208 -0
  81. package/dist/chunk-UY2TOI3B.js.map +1 -0
  82. package/dist/{chunk-OYMYCW7J.js → chunk-W3LVZ2EN.js} +605 -97
  83. package/dist/chunk-W3LVZ2EN.js.map +1 -0
  84. package/dist/{chunk-HSDCI7OV.js → chunk-XZKD7DIF.js} +3 -3
  85. package/dist/{chunk-Z6MFJV5Z.js → chunk-YVODPFTL.js} +851 -500
  86. package/dist/chunk-YVODPFTL.js.map +1 -0
  87. package/dist/{cli-4NNBEQYH.js → cli-7KJ4QLUU.js} +367 -216
  88. package/dist/cli-7KJ4QLUU.js.map +1 -0
  89. package/dist/config-MSN6H4MD.js +41 -0
  90. package/dist/dist-3LOO6M4U.js +2842 -0
  91. package/dist/dist-3LOO6M4U.js.map +1 -0
  92. package/dist/doctor-ITUCKN6C.js +453 -0
  93. package/dist/doctor-ITUCKN6C.js.map +1 -0
  94. package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js → ethersCompat-Df4a6QIZ-THAVUGIJ.js} +5 -5
  95. package/dist/fund-XPB4IIG5.js +298 -0
  96. package/dist/fund-XPB4IIG5.js.map +1 -0
  97. package/dist/hook-command-VVV2Q23L.js +1265 -0
  98. package/dist/hook-command-VVV2Q23L.js.map +1 -0
  99. package/dist/index.js +11 -3
  100. package/dist/index.js.map +1 -1
  101. package/dist/install-OSJRM2ME.js +63 -0
  102. package/dist/install-identity-YIWKQOUD.js +27 -0
  103. package/dist/install-wallet-BWJO2SUC.js +107 -0
  104. package/dist/install-wallet-BWJO2SUC.js.map +1 -0
  105. package/dist/mcp-KE5YKPS2.js +10174 -0
  106. package/dist/mcp-KE5YKPS2.js.map +1 -0
  107. package/dist/paths-MUXHUOCM.js +57 -0
  108. package/dist/pay-MUV2U232.js +46 -0
  109. package/dist/payments-4D27K4L2.js +48 -0
  110. package/dist/payments-4D27K4L2.js.map +1 -0
  111. package/dist/redact-6W23GGJC.js +15 -0
  112. package/dist/{secp256k1-N3ZHU7LB.js → secp256k1-ZZZT2CAX.js} +3 -3
  113. package/dist/secp256k1-ZZZT2CAX.js.map +1 -0
  114. package/dist/send-BXHFKDBF.js +225 -0
  115. package/dist/send-BXHFKDBF.js.map +1 -0
  116. package/dist/status-3Z3YPRSE.js +71 -0
  117. package/dist/status-3Z3YPRSE.js.map +1 -0
  118. package/dist/status-line-CKRMGZ3Q.js +87 -0
  119. package/dist/status-line-CKRMGZ3Q.js.map +1 -0
  120. package/dist/status-line-wiring-GECLIIBT.js +29 -0
  121. package/dist/status-line-wiring-GECLIIBT.js.map +1 -0
  122. package/dist/tenjin-daemon.mjs +20598 -0
  123. package/dist/tenjin-shim.mjs +251 -0
  124. package/dist/tenjin-vitest-reporter.mjs +49 -0
  125. package/dist/uninstall-BZTVWJ7W.js +165 -0
  126. package/dist/uninstall-BZTVWJ7W.js.map +1 -0
  127. package/dist/update-IQQTEOI5.js +433 -0
  128. package/dist/update-IQQTEOI5.js.map +1 -0
  129. package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js → viemAdapter-By13KInL-X2VY6CY3.js} +5 -5
  130. package/dist/viemAdapter-By13KInL-X2VY6CY3.js.map +1 -0
  131. package/dist/wallet-UFXQ57TZ.js +33 -0
  132. package/dist/wallet-UFXQ57TZ.js.map +1 -0
  133. package/dist/wallet-kdf-worker.mjs +980 -0
  134. package/docs/agent-permissions.md +141 -0
  135. package/docs/safety-model.md +70 -0
  136. package/package.json +14 -9
  137. package/LICENSE +0 -21
  138. package/dist/buy-U35DQ6XM.js +0 -1598
  139. package/dist/buy-U35DQ6XM.js.map +0 -1
  140. package/dist/candidate-RLYCQMF5.js +0 -127
  141. package/dist/candidate-RLYCQMF5.js.map +0 -1
  142. package/dist/chunk-27ONARHV.js +0 -171
  143. package/dist/chunk-27ONARHV.js.map +0 -1
  144. package/dist/chunk-3OV7E5G5.js +0 -18
  145. package/dist/chunk-3OV7E5G5.js.map +0 -1
  146. package/dist/chunk-7KUW4MJD.js +0 -59
  147. package/dist/chunk-7KUW4MJD.js.map +0 -1
  148. package/dist/chunk-7PHSZKQS.js +0 -333
  149. package/dist/chunk-7PHSZKQS.js.map +0 -1
  150. package/dist/chunk-IYLHQMT5.js +0 -211
  151. package/dist/chunk-IYLHQMT5.js.map +0 -1
  152. package/dist/chunk-JPHG2JW3.js +0 -96
  153. package/dist/chunk-JPHG2JW3.js.map +0 -1
  154. package/dist/chunk-MUBUQVC3.js +0 -67
  155. package/dist/chunk-MUBUQVC3.js.map +0 -1
  156. package/dist/chunk-N62ROTMC.js.map +0 -1
  157. package/dist/chunk-NCE5NSN6.js.map +0 -1
  158. package/dist/chunk-OYMYCW7J.js.map +0 -1
  159. package/dist/chunk-QNP7H47L.js +0 -152
  160. package/dist/chunk-QNP7H47L.js.map +0 -1
  161. package/dist/chunk-RY4XKNV3.js +0 -140
  162. package/dist/chunk-RY4XKNV3.js.map +0 -1
  163. package/dist/chunk-S3IGX57D.js.map +0 -1
  164. package/dist/chunk-TFGSOPWR.js +0 -261
  165. package/dist/chunk-TFGSOPWR.js.map +0 -1
  166. package/dist/chunk-TLCMMYLY.js +0 -126
  167. package/dist/chunk-TLCMMYLY.js.map +0 -1
  168. package/dist/chunk-UO22YNY4.js +0 -69
  169. package/dist/chunk-UO22YNY4.js.map +0 -1
  170. package/dist/chunk-UPIEAMGH.js +0 -160
  171. package/dist/chunk-UPIEAMGH.js.map +0 -1
  172. package/dist/chunk-XJIW7USF.js.map +0 -1
  173. package/dist/chunk-YBMMV4Y4.js.map +0 -1
  174. package/dist/chunk-YIYQ2ZNT.js +0 -286
  175. package/dist/chunk-YIYQ2ZNT.js.map +0 -1
  176. package/dist/chunk-YN5SHIXQ.js +0 -126
  177. package/dist/chunk-YN5SHIXQ.js.map +0 -1
  178. package/dist/chunk-Z52RA3NC.js +0 -137
  179. package/dist/chunk-Z52RA3NC.js.map +0 -1
  180. package/dist/chunk-Z6MFJV5Z.js.map +0 -1
  181. package/dist/cli-4NNBEQYH.js.map +0 -1
  182. package/dist/config-2VSXWWHK.js +0 -21
  183. package/dist/doctor-JJPNIBYH.js +0 -20
  184. package/dist/inspect-JGYJWFDP.js +0 -96
  185. package/dist/inspect-JGYJWFDP.js.map +0 -1
  186. package/dist/install-ZQRMSRGW.js +0 -378
  187. package/dist/install-ZQRMSRGW.js.map +0 -1
  188. package/dist/lookup-WYVTOMVY.js +0 -113
  189. package/dist/lookup-WYVTOMVY.js.map +0 -1
  190. package/dist/outcome-HKKT6QIA.js +0 -66
  191. package/dist/outcome-HKKT6QIA.js.map +0 -1
  192. package/dist/publish-D76B3MBK.js +0 -1480
  193. package/dist/publish-D76B3MBK.js.map +0 -1
  194. package/dist/usdc-JIAJW4SV.js +0 -22
  195. package/dist/wallet-6QKS6UHW.js +0 -179
  196. package/dist/wallet-6QKS6UHW.js.map +0 -1
  197. package/dist/wallet-PA54CRBL.js +0 -30
  198. package/skills/tenjin/SKILL.md +0 -199
  199. package/skills/tenjin-publish/SKILL.md +0 -96
  200. package/skills/tenjin-search/SKILL.md +0 -122
  201. /package/dist/{_esm-FEASBWRP.js.map → _esm-CE7KNONL.js.map} +0 -0
  202. /package/dist/{ccip-NQXCEK2U.js.map → ccip-7RMRLAGV.js.map} +0 -0
  203. /package/dist/{ccip-XR5NE5QK.js.map → ccip-NLCSCHKI.js.map} +0 -0
  204. /package/dist/{chunk-ZMHYXMO6.js.map → chunk-5IEP5EGE.js.map} +0 -0
  205. /package/dist/{chunk-5CLSD5YN.js.map → chunk-BPMWXTFX.js.map} +0 -0
  206. /package/dist/{chunk-YALGASEU.js.map → chunk-EGELTSPU.js.map} +0 -0
  207. /package/dist/{chunk-CYOF7ROH.js.map → chunk-HPWO4O6S.js.map} +0 -0
  208. /package/dist/{chunk-QVX5MWJZ.js.map → chunk-JRGFKVAZ.js.map} +0 -0
  209. /package/dist/{chunk-HIVZG55D.js.map → chunk-KG3D7FIF.js.map} +0 -0
  210. /package/dist/{chunk-ZABPQJ3M.js.map → chunk-POUWHWID.js.map} +0 -0
  211. /package/dist/{chunk-RRN3YTK7.js.map → chunk-TTNESUPQ.js.map} +0 -0
  212. /package/dist/{chunk-HSDCI7OV.js.map → chunk-XZKD7DIF.js.map} +0 -0
  213. /package/dist/{config-2VSXWWHK.js.map → config-MSN6H4MD.js.map} +0 -0
  214. /package/dist/{doctor-JJPNIBYH.js.map → ethersCompat-Df4a6QIZ-THAVUGIJ.js.map} +0 -0
  215. /package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js.map → install-OSJRM2ME.js.map} +0 -0
  216. /package/dist/{secp256k1-N3ZHU7LB.js.map → install-identity-YIWKQOUD.js.map} +0 -0
  217. /package/dist/{usdc-JIAJW4SV.js.map → paths-MUXHUOCM.js.map} +0 -0
  218. /package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js.map → pay-MUV2U232.js.map} +0 -0
  219. /package/dist/{wallet-PA54CRBL.js.map → redact-6W23GGJC.js.map} +0 -0
package/NOTICE.md CHANGED
@@ -43,12 +43,17 @@ BlockRun MCP is licensed under the MIT License:
43
43
 
44
44
  ## gitleaks
45
45
 
46
- The provider secret-token shape patterns in the publish redaction scan
47
- (`src/lib/scan.ts`: AWS access keys, GitHub/Slack/Stripe tokens, JWTs, and the
48
- PEM private-key marker) are adapted from the
49
- [gitleaks](https://github.com/gitleaks/gitleaks) ruleset (MIT), by Zachary Rice.
50
- The regexes are vendored and adapted inline; gitleaks is not a runtime
51
- dependency (the scan is pure and offline by design).
46
+ The provider secret-token shape patterns in the publish redaction scan are
47
+ adapted from the [gitleaks](https://github.com/gitleaks/gitleaks) ruleset (MIT),
48
+ by Zachary Rice: AWS access keys, GitHub classic and fine-grained tokens,
49
+ Slack/Stripe/npm/Anthropic/OpenAI/Google/Supabase/Twilio/SendGrid/Hugging Face
50
+ tokens, JWTs, and the PEM private-key marker. They live as data in
51
+ `src/lib/redact-rules.json`, one entry per detector, each naming its gitleaks rule
52
+ in its `source` field; `src/lib/redact.ts` compiles that data. The regexes are
53
+ vendored and adapted, not imported: gitleaks is not a runtime dependency (the
54
+ scan is pure and offline by design).
55
+
56
+ Nothing in this scan derives from TruffleHog, which is AGPL-licensed.
52
57
 
53
58
  gitleaks is licensed under the MIT License:
54
59
 
@@ -74,6 +79,48 @@ gitleaks is licensed under the MIT License:
74
79
  > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
75
80
  > SOFTWARE.
76
81
 
82
+ ## secretlint
83
+
84
+ The gitleaks port above was diffed against
85
+ [secretlint](https://github.com/secretlint/secretlint)'s
86
+ `@secretlint/secretlint-rule-preset-recommend` (MIT), by azu. Eight token shapes
87
+ present there and absent from the gitleaks subset are adapted from its rule
88
+ packages, each credited in its `source` field in `src/lib/redact-rules.json`:
89
+ Vercel platform tokens, Notion, Linear, Figma, GitLab, Docker Hub, Cloudflare,
90
+ and Databricks. secretlint is not a runtime dependency.
91
+
92
+ secretlint is licensed under the MIT License:
93
+
94
+ > MIT License
95
+ >
96
+ > Copyright (c) 2020 azu
97
+ >
98
+ > Permission is hereby granted, free of charge, to any person obtaining a copy
99
+ > of this software and associated documentation files (the "Software"), to deal
100
+ > in the Software without restriction, including without limitation the rights
101
+ > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
102
+ > copies of the Software, and to permit persons to whom the Software is
103
+ > furnished to do so, subject to the following conditions:
104
+ >
105
+ > The above copyright notice and this permission notice shall be included in all
106
+ > copies or substantial portions of the Software.
107
+ >
108
+ > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
109
+ > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
110
+ > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
111
+ > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
112
+ > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
113
+ > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
114
+ > SOFTWARE.
115
+
116
+ ## BIP-39 English wordlist
117
+
118
+ `src/lib/bip39-wordlist.json` vendors the 2048-word English wordlist from
119
+ [BIP-0039](https://github.com/bitcoin/bips/blob/master/bip-0039/english.txt), as
120
+ distributed by [@scure/bip39](https://github.com/paulmillr/scure-bip39) (MIT,
121
+ Copyright (c) 2022 Paul Miller). It is data for the `bip39-seed-phrase`
122
+ detector; no BIP-39 implementation is used or bundled.
123
+
77
124
  ## tenjin-mcp
78
125
 
79
126
  This repository absorbs, with credit, patterns from the archived
@@ -82,4 +129,4 @@ standalone MCP server (MIT), whose Tenjin-specific modifications are
82
129
  Copyright (c) 2026 Tenjin contributors.
83
130
 
84
131
  Tenjin-specific code in this repository is Copyright (c) 2026 BackTrackCo and
85
- Tenjin contributors, licensed under this project's MIT License.
132
+ Tenjin contributors.
package/README.md CHANGED
@@ -1,304 +1,223 @@
1
- <div align="center">
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="./assets/logo-dark.svg">
4
+ <img src="./assets/logo-light.svg" alt="Tenjin" width="220">
5
+ </picture>
6
+ </p>
2
7
 
3
- # tenjin-agent
8
+ <h3 align="center">The tool router for coding agents.</h3>
4
9
 
5
- ### Agent tooling for [Tenjin](https://tenjin.blog): discover, read, buy, and publish knowledge with USDC on Base.
10
+ <p align="center">
11
+ Give your agent superpowers once. Tenjin hands it the right tool when it helps, and you keep working like before.<br>
12
+ No API keys. No pile of MCP servers. No rules to write.
13
+ </p>
6
14
 
7
- **No API keys. No accounts. Payment is the identity.**
15
+ <p align="center">
16
+ <a href="https://www.npmjs.com/package/tenjin-cli"><img src="https://img.shields.io/npm/v/tenjin-cli?color=C85A3B&label=npm" alt="npm version"></a>
17
+ <img src="https://img.shields.io/badge/works%20with-Claude%20Code-1C1A17" alt="Works with Claude Code">
18
+ <img src="https://img.shields.io/badge/payments-x402-8C9A7E" alt="Payments via x402">
19
+ </p>
8
20
 
9
- [![MCP](https://img.shields.io/badge/MCP-remote-000000?style=flat-square)](https://tenjin.blog/api/mcp)
10
- [![x402](https://img.shields.io/badge/x402-USDC_on_Base-6f5cff?style=flat-square)](https://x402.org)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=flat-square)](./LICENSE)
21
+ <p align="center">
22
+ <a href="#quick-start">Quick start</a> ·
23
+ <a href="#what-it-can-do">Tools</a> ·
24
+ <a href="#wallet-and-payments">Wallet &amp; payments</a> ·
25
+ <a href="#request-a-tool">Request a tool</a>
26
+ </p>
12
27
 
13
- </div>
28
+ <p align="center">
29
+ <img src="./assets/demo.gif" alt="Tenjin in Claude Code: research, live crypto prices, company lookup, email verification, and computation" width="720">
30
+ </p>
14
31
 
15
- Tenjin is an x402-native knowledge marketplace. Agents search work that has
16
- already been produced, read free essays, buy valuable answers with USDC, and
17
- publish their own reusable research. This repo is the home of the `tenjin-cli`
18
- npm package and, soon, the Claude Code plugin and agent skills that wrap it.
32
+ ---
19
33
 
20
- > **Status: early preview.** The CLI ships `install`, `doctor`, `config`, and
21
- > `wallet` today. `lookup`, `inspect`, `buy`, and `outcome` are implemented but require the
22
- > marketplace lookup API (Track A2) to be deployed to the base URL you point at;
23
- > against a deploy without it, `doctor` shows a `lookup-contract` warning and those
24
- > commands will not work yet. `publish` writes a piece with an optional answer
25
- > card, gated by a local secrets scan and your `publish.mode` consent. Everything
26
- > under "zero install" below is complete and live now; start there.
34
+ ## Why
27
35
 
28
- ## Use Tenjin today, zero install
36
+ Giving your agent good tools is a chore today:
29
37
 
30
- | Surface | URL |
31
- | -------------------------------------------- | -------------------------------------------------------------------- |
32
- | Remote MCP server (Streamable HTTP, keyless) | `https://tenjin.blog/api/mcp` |
33
- | Agent guide | [tenjin.blog/llms.txt](https://tenjin.blog/llms.txt) |
34
- | Full API reference | [tenjin.blog/llms-full.txt](https://tenjin.blog/llms-full.txt) |
35
- | OpenAPI 3.1 | [tenjin.blog/openapi.json](https://tenjin.blog/openapi.json) |
36
- | Agent skill | [tenjin.blog/skills.md](https://tenjin.blog/skills.md) |
37
- | x402 discovery | [tenjin.blog/.well-known/x402](https://tenjin.blog/.well-known/x402) |
38
- | Human onboarding | [tenjin.blog/agents](https://tenjin.blog/agents) |
38
+ - **A key for every tool.** Sign up, pick a plan, paste an API key into a config file. Five tools, five accounts.
39
+ - **MCP servers crowd the context.** Every server you install loads its tool definitions into every session, needed or not.
40
+ - **Your agent forgets anyway.** It reaches for plain web search out of habit, so you write rules to remind it, and it still slips.
41
+ - **Some tools you need once.** Installing something permanent for a one-off lookup isn't worth the setup.
39
42
 
40
- The remote MCP server is keyless and stateless: search, tags, previews, and
41
- free essays cost nothing. Paid tools accept wallet-signed headers produced on
42
- your machine; Tenjin never receives a private key. It is listed in the
43
- [official MCP registry](https://registry.modelcontextprotocol.io) as
44
- `blog.tenjin/tenjin`.
43
+ Tenjin handles all of it. Install it once and keep working. The Tenjin router watches the moments where a tool could help: your prompt, your agent's web searches and page fetches, and the tasks it hands to subagents. When a curated tool beats what your agent was about to do, the router suggests it and your agent calls it. Your wallet pays for each call through [x402](#wallet-and-payments), so you manage no keys and install nothing new.
45
44
 
46
- ### Install the skills: `npx tenjin-cli install`
45
+ ## Quick start
46
+
47
+ Requires Node.js 24 or newer and [Claude Code](https://code.claude.com). Codex support is on the way.
47
48
 
48
49
  ```bash
49
- npx tenjin-cli install
50
+ npm i -g tenjin-cli
51
+ tenjin install # sets up Claude Code and creates your wallet
52
+ tenjin wallet fund 2 # optional: add $2 with a card, via Coinbase
53
+ ```
54
+
55
+ ```text
56
+ ✓ Tenjin is set up for Claude Code
57
+ ✓ Wallet created: 0x3c0D84055994c3062819Ce8730869D0aDeA4c3Bf
58
+ Automatic router: up to $0.25 per call; daily limit $5 a day
59
+
60
+ Next: tenjin wallet fund, then restart Claude Code
50
61
  ```
51
62
 
52
- One command auto-detects your harness (Claude Code, Codex, or any
53
- Agent-Skills-compatible setup), copies the three Tenjin skills into place, and
54
- then runs the `doctor` checks as its last step. It is idempotent: re-run any
55
- time, `--dry-run` previews the changes without writing, and
56
- `--harness claude|codex|shared` (repeatable) targets a specific one.
63
+ Restart Claude Code. That's it.
57
64
 
58
- Where the skills land:
65
+ Then work as usual. Try:
59
66
 
60
- - **Claude Code** (`~/.claude` present or `claude` on PATH):
61
- `~/.claude/skills/`. The Claude Code plugin marketplace (a later release)
62
- will supersede this path for Claude users.
63
- - **Codex** (`~/.codex` present or `codex` on PATH): `~/.agents/skills/`, the
64
- harness-shared Agent Skills location. The installer also appends a one-line
65
- pointer to your AGENTS.md and prints the `config.toml` rule Codex needs,
66
- because its default `workspace-write` sandbox blocks network and would
67
- otherwise break every paid call:
67
+ ```text
68
+ > What are BTC and ETH trading at?
69
+ > How do I paginate list results with the Stripe Node SDK?
70
+ > Is ada@example.com a deliverable address?
71
+ > Integrate x^2 sin(x) dx from 0 to pi.
72
+ ```
68
73
 
69
- ```toml
70
- [sandbox_workspace_write]
71
- network_access = true
72
- ```
74
+ Each answer names the provider and the price. Your agent keeps its own tools, and the router steps in only when it has something better.
73
75
 
74
- - **Nothing detected**: the installer falls back to `~/.agents/skills/`, so a
75
- harness installed later still finds the skills.
76
+ ## What it can do
76
77
 
77
- The repo ships three skills:
78
+ The router picks from a catalog we curate and maintain. When nothing in it fits, it can point your agent at a reviewed third-party pay-per-call service from the [Tenjin list](#tenjin-list-and-experimental-bazaar), and your agent decides whether to use it or to ask you first. Routing is free: you pay the provider's price and nothing else.
78
79
 
79
- - **`tenjin`**: the zero-install curriculum, a synced copy of the canonical
80
- [tenjin.blog/skills.md](https://tenjin.blog/skills.md). Teaches the raw
81
- HTTP/MCP surface; works with no CLI and no account. Use this when the CLI is
82
- not installed.
83
- - **`tenjin-search`**: thin adapter over `tenjin lookup/inspect/buy/outcome`
84
- with a deliberately narrow trigger (public, durable, costly-to-reproduce
85
- questions). Requires the CLI below.
86
- - **`tenjin-publish`**: explicit-invocation-only publishing rubric and
87
- `tenjin publish` adapter. Never triggers on its own.
80
+ | Tool | What your agent gets | Price per call |
81
+ | ---------------------------------------------------------------- | ----------------------------------------------------------- | -------------- |
82
+ | **Docs lookup** · [Context7](https://context7.com) | Current, version-specific docs for a library or API | **Free** |
83
+ | **Web research** · [Exa](https://exa.ai) | Search results with the page content, not just links | $0.007 |
84
+ | **Read a page** · [Firecrawl](https://firecrawl.dev) | One exact page as clean text, even when a plain fetch fails | $0.01 |
85
+ | **Crypto prices** · [CoinMarketCap](https://coinmarketcap.com) | Live quotes for any coin | $0.01 |
86
+ | **Compute** · [Wolfram Alpha](https://www.wolframalpha.com) | Math, unit conversions, science and data questions | $0.02 |
87
+ | **Email check** · [Hunter](https://hunter.io) | Whether an address is real and deliverable | $0.03 |
88
+ | **Person lookup** · Minerva | A professional profile from a name or email | $0.05 |
89
+ | **Company profile** · [CompanyEnrich](https://companyenrich.com) | Size, industry, funding and socials from a domain or name | $0.06 |
88
90
 
89
- A funded wallet is only needed for paid reads and publishing.
91
+ Free tools run without a funded wallet. Twitter, Reddit and more are next, added by demand: [tell us what you want](#request-a-tool).
90
92
 
91
- > Prefer no CLI? `npx skills add BackTrackCo/tenjin-agent` installs the same
92
- > skills into any Agent-Skills-compatible harness without the `tenjin` binary.
93
+ ### Tenjin list and experimental Bazaar
93
94
 
94
- ### Add the remote MCP server
95
+ **The Tenjin list is on by default.** When nothing in the catalog fits a step (such as generating a sound effect), the router may suggest one third-party pay-per-call x402 service that Tenjin has reviewed. The suggestion names the seller, the URL, the price and the input it takes, and your agent judges whether to use it or to ask you first. It is paid like any lookup, under your spend limits.
95
96
 
96
- **Claude Code**
97
+ **The open Bazaar is experimental and off by default.** Turn it on with:
97
98
 
98
- ```bash
99
- claude mcp add --transport http tenjin https://tenjin.blog/api/mcp
99
+ ```sh
100
+ tenjin config set experimental.bazaar on
100
101
  ```
101
102
 
102
- **Cursor** (`.cursor/mcp.json`)
103
+ With it on, the router may also suggest sellers from Coinbase's open x402 Bazaar, and to find them, short snippets of your prompts are sent to Coinbase's public Bazaar search. Those sellers are unreviewed third parties, matches can be noisy, prices can vary with the input, and payments are real, under your spend limits. `tenjin config` and `tenjin doctor` show both settings. Turn it off with `tenjin config set experimental.bazaar off`.
104
+
105
+ ## How it works
103
106
 
104
- ```json
105
- {
106
- "mcpServers": {
107
- "tenjin": { "url": "https://tenjin.blog/api/mcp" }
108
- }
109
- }
107
+ ```mermaid
108
+ flowchart LR
109
+ A["Your prompt,<br>a web search,<br>or a subagent task"] --> B{"Tenjin<br>router"}
110
+ B -- "a tool fits" --> C["Agent calls it<br>through x402"]
111
+ C --> D["Wallet pays the provider,<br>result comes back"]
112
+ B -- "nothing better" --> E["Agent carries on"]
110
113
  ```
111
114
 
112
- **OpenClaw**
115
+ The Tenjin router hooks into Claude Code at your prompt, before each web search or page fetch, when your agent hands work to a subagent, and around a question your agent asks you. At each point it asks Jev, a decision model from [TypeSafe](https://typesafe.ai), whether a tool in the catalog fits. When none does, Jev may pick one third-party service from a short list matching the step (the Tenjin list, plus the open Bazaar if you turned it on), or none. Either way Jev only chooses from a list, so it never writes a call or an instruction for your agent; a third-party listing's description is the seller's own, and your agent judges it.
113
116
 
114
- ```bash
115
- openclaw mcp add tenjin --url https://tenjin.blog/api/mcp --transport streamable-http
117
+ When one fits, your agent sees a one-line suggestion with the tool and its price, and calls it through Tenjin's `x402` MCP server. Tenjin pays the provider from your wallet, within your limits, and hands back the result. Your status line shows the call as it happens:
118
+
119
+ ```text
120
+ x402 · request: calling pro-api.coinmarketcap.com/x402/v3/cryptocurrency/quotes/latest · {"query":{"symbol":"BTC,ETH"}}
116
121
  ```
117
122
 
118
- **Codex and other harnesses**: point the agent at
119
- [tenjin.blog/skills.md](https://tenjin.blog/skills.md) (Agent Skills spec) or
120
- [tenjin.blog/llms.txt](https://tenjin.blog/llms.txt); a local stdio MCP entry
121
- point (`tenjin mcp`) over this CLI is on the roadmap.
123
+ To pick a tool, the router sends your current turn and up to six recent messages, with keys, passwords and seed phrases masked. Tool results and page contents stay on your machine, and the packet expires after 15 minutes. `tenjin config set router.context turn` sends only the current message. [Full details, and everything install writes →](./docs/agent-permissions.md)
124
+
125
+ ## Wallet and payments
122
126
 
123
- ## The CLI: `tenjin-cli`
127
+ Tenjin pays for tools with [x402](https://www.x402.org), an open standard that builds payments into HTTP. A paid endpoint answers `402 Payment Required` with its price, the client signs a payment for that amount, and the endpoint returns the result. Neither side needs an account or an API key. Read more: [x402.org](https://www.x402.org) · [whitepaper](https://www.x402.org/x402-whitepaper.pdf) · [Coinbase docs](https://docs.cdp.coinbase.com/x402/welcome) · [spec and SDKs](https://github.com/coinbase/x402).
124
128
 
125
- A thin, deterministic layer over Tenjin's public HTTP contract. It makes zero
126
- model calls and owns exactly what a hosted server cannot: local wallet custody
127
- and signing, spend policy, local delivery of purchased content, and outcome
128
- reporting.
129
+ ### Your wallet
130
+
131
+ `tenjin install` creates a wallet on your machine that holds [USDC](https://www.circle.com/usdc) on [Base](https://base.org). Tenjin encrypts the private key, unlocks it through your OS keychain, and never sends it anywhere. Tenjin never holds or moves your funds. Paying a provider costs no gas.
132
+
133
+ ### Limits
134
+
135
+ | Limit | Default | Change it |
136
+ | ---------- | ------- | ------------------------------------- |
137
+ | Per lookup | $0.25 | `tenjin config set maxAutoSpend 0.10` |
138
+ | Per day | $5 | `tenjin config set sessionBudget 2` |
139
+
140
+ Tenjin refuses any payment over either limit before it signs anything.
141
+
142
+ ### Funding
143
+
144
+ `tenjin wallet fund 2` opens a Coinbase Onramp checkout for your wallet: pay by card, or Apple Pay where your region supports it. Sign in to Coinbase or create an account during checkout. You can also send USDC on Base to the address `tenjin wallet show` prints.
145
+
146
+ $1–2 goes a long way. $2 covers about 280 web searches, 200 page reads or 100 Wolfram Alpha answers.
147
+
148
+ ### Withdrawing
149
+
150
+ `tenjin wallet send <amount> USDC <address>` sends funds to any address. It's a regular onchain transfer, so it needs a little ETH on Base for gas.
151
+
152
+ ## Everyday commands
129
153
 
130
154
  ```bash
131
- npm install -g tenjin-cli@next # pre-release channel
132
- tenjin doctor # verify Node floor, API reachability, contract, wallet
155
+ tenjin status # what you've spent today
156
+ tenjin wallet balance # what's left
157
+ tenjin wallet fund 5 # top up
158
+ tenjin payments reconcile # settle paid lookups whose settlement was unknown
159
+ tenjin update # newest version; wallet and settings stay
160
+ tenjin config set router.enabled false # pause the router on this machine
161
+ tenjin config set --project router.enabled false # ...or just in this repo
162
+ tenjin uninstall # remove the Claude Code setup; your wallet stays
133
163
  ```
134
164
 
135
- Shipping today (no backend dependency):
136
-
137
- | Command | Purpose |
138
- | --------------------------------------- | -------------------------------------------------------------------- |
139
- | `tenjin install` | Auto-detect harnesses, wire the skills, then run the doctor checks |
140
- | `tenjin doctor` | Environment, API reachability, contract, and wallet checks |
141
- | `tenjin config [get\|set]` | Spend policy: `maxAutoSpend`, `sessionBudget`, `confirm`, allowlists |
142
- | `tenjin wallet [create\|show\|balance]` | Local Base wallet; the key never leaves the machine |
143
-
144
- Marketplace commands (need the Track A2 lookup API deployed to your `--base-url`):
145
-
146
- | Command | Purpose |
147
- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
148
- | `tenjin lookup "<question>"` | Ask for payable candidates or an honest MISS; prints the compact JSON verbatim |
149
- | `tenjin inspect <url-or-id>` | Show a candidate's pre-purchase card from the 402 body; never pays |
150
- | `tenjin buy <url-or-id> [--max-price <usd>] [--yes]` | Entitlement re-check (free re-read if owned), then x402 exact payment |
151
- | `tenjin outcome --lookup-id <id> --status <s>` | Report `used` / `partially_used` / `rejected` / `regenerated` / `purchase_declined` |
152
- | `tenjin publish <file.md> [--price <usd>] [--yes]` | Publish a Markdown piece with an optional answer card, gated by a local scan and your consent mode |
153
- | `tenjin publish --candidate <id>` | Publish a parked candidate (its draft.md); clears it on success |
154
-
155
- `buy` re-reads an entitled resource for free before ever paying, re-delivers
156
- already-bought content from the local library without paying again, and refuses to
157
- sign if the price rose since it first saw the 402. Spend policy is enforced in the
158
- wallet provider layer before any payment. The default output carries a heading
159
- outline, never the body: `--print-body` includes it, and `--sections <tokens>`
160
- includes the leading sections within a token budget (a deterministic heading
161
- split, no model calls).
162
-
163
- The lookup question must be **generalized public text**: derive the smallest
164
- public phrasing of your task and never include secrets or private context. By
165
- default the server stores no query text at all; `tenjin config set evalCohort
166
- true` opts into 90-day retention of the question for retrieval evaluation.
167
-
168
- > **Money units.** `--max-price` (and the spend-policy config values) are entered
169
- > in **decimal USD** at the CLI edge (e.g. `--max-price 0.10`), and emitted in
170
- > machine output as both atomic and USD. This is a deliberate deviation from the
171
- > atomic-unit flags in CLI spec 10, per plan 12 decision O1 (humans think in
172
- > dollars; agents read the atomic value in the JSON).
173
-
174
- ### Consent modes and pricing
175
-
176
- `publish` runs a deterministic local scan (secrets, keys, PII, wallet addresses)
177
- on every publish, then applies your `publish.mode`:
178
-
179
- - **`review`** always asks first, even on a clean scan.
180
- - **`auto`** (the default) publishes a clean scan immediately; any warning
181
- finding stops and asks; a hard block (a live secret or private key) always
182
- refuses.
183
- - **`full-auto`** does not stop for warnings, only for hard blocks. It is honored
184
- from your global config, an env var, a flag, or a gitignored `.tenjin.json`. Only
185
- a committed `.tenjin.json` asking for `full-auto` is downgraded to `auto`, so
186
- cloning a repo can never enable silent auto-publishing.
187
-
188
- `--yes` clears the warning findings and the review confirm; it never clears a hard
189
- block. Set the mode with `tenjin config set publish.mode <mode>`, or per run with
190
- `--mode`. `tenjin install` asks once on an interactive setup and otherwise leaves
191
- the default (auto); change it any time with `tenjin config set publish.mode`.
192
-
193
- Pricing: `--price` (or a frontmatter `price:`) wins, otherwise `publish.defaultPrice`
194
- (default $0.10). A card never auto-prices; the `tenjin-publish` skill's rubric is
195
- what actually chooses a price before it calls the command.
196
-
197
- Instead of a file, `publish --candidate <id>` publishes a parked candidate (see
198
- `tenjin candidate`) from its stored `draft.md`, prefilling the card's question from
199
- the candidate. It runs the same scan and consent flow and clears the candidate only
200
- on a successful publish; a file and `--candidate` are mutually exclusive.
201
-
202
- Next: a Claude Code plugin marketplace in this repo, and `tenjin mcp` (local
203
- stdio server over the same core).
204
-
205
- ### Output contract
206
-
207
- Every invocation prints exactly one JSON envelope to stdout
208
- (`{schemaVersion, command, ok, data | error}`); human rendering goes to stderr
209
- only. Exit codes: `0` success (including an honest MISS), `1` runtime/network,
210
- `2` usage, `3` policy refusal (spend cap, allowlist, missing approval), `4`
211
- payment failure after approval.
212
-
213
- ### Safety model
214
-
215
- - Default maximum automatic spend is **zero**. Nothing pays without explicit
216
- approval or an explicitly configured policy.
217
- - Keys are generated locally and stored **encrypted at rest** in
218
- `~/.tenjin/wallet.json` (Keystore v3, scrypt), mode `0600`. The plaintext key
219
- is never written to disk. The wallet address stays readable, so `show`,
220
- `balance`, and `doctor` work without a passphrase; only signing decrypts.
221
- Signing is local and the CLI talks only to the configured base URL.
222
- - The signing passphrase resolves in order: `TENJIN_WALLET_PASSPHRASE`, then the
223
- OS credential store, then an interactive prompt. On `wallet create` with no env
224
- passphrase, a strong random one is generated and saved to the OS store so later
225
- signing is transparent. Where it lands per platform:
226
- - **macOS**: the login keychain, via the OS `security` tool (the same
227
- mechanism the GitHub CLI uses).
228
- - **Windows**: a DPAPI-encrypted file (`passphrase.dpapi`), decryptable only by
229
- the same user on the same machine, via built-in PowerShell. The file holds
230
- ciphertext, not the passphrase.
231
- - **Desktop Linux**: the Secret Service keyring, via `secret-tool` when
232
- libsecret-tools is installed.
233
- - **Headless or CI (any OS)**: no durable OS store, so set
234
- `TENJIN_WALLET_PASSPHRASE`.
235
-
236
- The passphrase reaches these tools over stdin, never on a command line, and the
237
- key never leaves the machine.
238
-
239
- - Fund small: this is a pocket-money wallet by design.
240
- - Purchased content is untrusted data, never instructions.
241
-
242
- ## Development
165
+ Use `tenjin install --project` to set it up for a single project. Add `--json` to any command for machine-readable output.
166
+
167
+ Every paid lookup is recorded on your machine in `~/.tenjin/paid/ledger.jsonl`: what was sent (masked), who was paid, how much, the settlement transaction, and any files saved. Files a paid lookup returns, and media files a paid third-party service links to, are saved under `~/.tenjin/downloads/`. When a seller never confirmed settlement, `tenjin payments reconcile` asks USDC on Base whether the payment was used once it has expired, and one that was never charged goes back to today's limit; the `request` tool does the same for up to three beside each lookup, without waiting for it.
168
+
169
+ <details>
170
+ <summary>Status line: keeping your own</summary>
171
+
172
+ `tenjin install` sets Claude Code's [status line](https://code.claude.com/docs/en/statusline) only if you don't already have one. If you do, yours is left alone and the install prints a command that shows both; `tenjin install --status-line compose` writes it for you, and `--status-line skip` leaves the setting untouched. The status line reads local files only: no network, no wallet, and it can't affect a lookup or a payment.
173
+
174
+ </details>
175
+
176
+ <details>
177
+ <summary>Spending limits: the fine print</summary>
178
+
179
+ Limits are set only where no setting exists yet, so an update never overwrites yours. The daily budget is a rolling 24-hour window. Setting either limit to `0` blocks automatic payments; `tenjin config set sessionBudget none` removes the daily ceiling only.
180
+
181
+ `tenjin pay <url>` pays any x402 endpoint you name. It ignores the automatic limits and always asks for your consent to the quoted price, interactively or with `--yes`. It is never used as a workaround when the router refuses. See the [safety model](./docs/safety-model.md).
182
+
183
+ </details>
184
+
185
+ <details>
186
+ <summary>Troubleshooting: Claude Code asks about a new project MCP server named <code>x402</code></summary>
187
+
188
+ Updating to `0.1.0-alpha.18` could accidentally register the server in `~/.mcp.json` while refreshing a user install. After upgrading to a release with the fix, check that file. If its `x402` entry runs `tenjin mcp` and you didn't install at project scope in your home directory on purpose, remove just that registration:
243
189
 
244
190
  ```bash
245
- pnpm install
246
- pnpm check # build + test
247
- pnpm lint && pnpm typecheck && pnpm format:check
248
- pnpm pack-smoke # exercises the packed npm artifact
191
+ (cd ~ && claude mcp remove x402 -s project)
249
192
  ```
250
193
 
251
- ## Release
194
+ This keeps your other MCP entries and the user registration in `~/.claude.json`. Run `tenjin install`, then restart Claude Code. Don't use `tenjin uninstall --project` from home for this: its settings path is also the user settings path.
252
195
 
253
- Publishing to npm uses **Changesets** + **npm Trusted Publishing (OIDC)**,
254
- driven by the two-job `workflow_dispatch`-only `.github/workflows/release.yml`.
255
- This mirrors the house template in `BackTrackCo/x402r-sdk`. Nothing auto-fires
256
- from a push or a tag: a maintainer clicks Run workflow at each step.
196
+ When refreshing from home, Tenjin keeps the existing user registration if there is one, or preserves a project-only registration; with neither, it defaults to user scope. `tenjin install --refresh --project` selects project scope explicitly.
257
197
 
258
- Day to day, add a changeset in the same PR as any shippable change:
198
+ </details>
259
199
 
260
- ```sh
261
- pnpm changeset # pick the bump type, write a summary; commit the .md
262
- ```
200
+ ## Request a tool
201
+
202
+ Tenjin is in alpha, and the catalog grows with what people ask for. Missing a service your agent keeps needing? Hit a lookup that went to the wrong place? We want to hear it.
203
+
204
+ - **[Request a tool →](https://github.com/BackTrackCo/tenjin-agent/issues/new?title=Tool%20request%3A%20&labels=enhancement)**
205
+ - **[Report a bug →](https://github.com/BackTrackCo/tenjin-agent/issues/new?labels=bug)**
206
+
207
+ ## Learn more
208
+
209
+ - [How a lookup runs, what it sends, and what install writes](./docs/agent-permissions.md)
210
+ - [Safety model](./docs/safety-model.md)
263
211
 
264
- To cut a release (two clicks):
265
-
266
- 1. **Dispatch (click 1)**: Actions -> Release -> Run workflow -> `main`. The
267
- `version` job runs `changeset version` (consumes `.changeset/*.md`, bumps
268
- `package.json`, regenerates `CHANGELOG.md`) and opens the
269
- **"chore(release): version packages"** PR. Nothing is published yet.
270
- 2. **Review and merge** that PR (its final state is what ships; edit the
271
- version or changelog directly if needed).
272
- 3. **Dispatch (click 2)**: same path. With no pending changesets, the `publish`
273
- job builds, runs the check suite + `pnpm audit` + the packed-artifact smoke
274
- as a pre-publish gate, then `changeset publish` ships `tenjin-cli` with
275
- provenance and creates the GitHub release. Prereleases use Changesets' pre
276
- mode (`pnpm changeset pre enter alpha`) and publish to that dist-tag; stable
277
- goes to `latest`.
278
-
279
- Auth is npm Trusted Publishing (OIDC): each publish mints a short-lived,
280
- per-run token, so there is **no `NPM_TOKEN`** to store or rotate.
281
-
282
- ### One-time owner setup
283
-
284
- `tenjin-cli` already exists on npm (published `0.1.0-alpha.1`), so no manual
285
- first publish is needed. The owner must, one time:
286
-
287
- 1. **Install the release-bot GitHub App on `BackTrackCo/tenjin-agent`** (the
288
- same `x402r-release-bot` App used by `x402r-sdk`, or an equivalent), then
289
- set repo **variable** `RELEASE_APP_CLIENT_ID` and repo **secret**
290
- `RELEASE_APP_PRIVATE_KEY`. Required because Changesets' version PR must be
291
- opened by an App identity to trigger CI (the default `GITHUB_TOKEN` cannot,
292
- by GitHub's anti-recursion rule). Neither the variable nor the secret is
293
- set on this repo yet, so `release.yml` will fail at the token step until
294
- they exist.
295
- 2. **Add a Trusted Publisher** to `tenjin-cli` on npmjs.com: provider GitHub
296
- Actions, organization `BackTrackCo`, repository `tenjin-agent`, workflow
297
- filename `release.yml`, environment `npm-publish`.
298
- 3. **Create a GitHub Environment named `npm-publish`** (Settings ->
299
- Environments), optionally with required reviewers to gate each publish.
300
-
301
- ## License
302
-
303
- MIT. See [NOTICE.md](./NOTICE.md) for third-party attributions (wallet-safety
304
- patterns adapted from BlockRun MCP via the archived `tenjin-mcp` prototype).
212
+ ## Developing
213
+
214
+ Before contributing, read [CONTRIBUTING.md](./CONTRIBUTING.md) for the contributor agreement.
215
+
216
+ ```bash
217
+ pnpm install
218
+ pnpm run githooks # once, to use the repo's git hooks
219
+ pnpm run build
220
+ pnpm run test
221
+ pnpm run typecheck
222
+ pnpm run lint
223
+ ```
@@ -93,7 +93,7 @@ import {
93
93
  withTimeout,
94
94
  zeroAddress,
95
95
  zeroHash
96
- } from "./chunk-UGX7YPX2.js";
96
+ } from "./chunk-AWQPGIR6.js";
97
97
  import {
98
98
  InvalidDomainError,
99
99
  InvalidPrimaryTypeError,
@@ -121,15 +121,14 @@ import {
121
121
  serializeSignature,
122
122
  serializeTransaction,
123
123
  serializeTypedData,
124
- sha256,
124
+ sha2562 as sha256,
125
125
  toBlobSidecars,
126
126
  toBlobs,
127
127
  toPrefixedMessage,
128
128
  toRlp,
129
129
  validateTypedData
130
- } from "./chunk-NCE5NSN6.js";
131
- import "./chunk-RY4XKNV3.js";
132
- import "./chunk-QVX5MWJZ.js";
130
+ } from "./chunk-N35E6CM2.js";
131
+ import "./chunk-JRGFKVAZ.js";
133
132
  import {
134
133
  AccountStateConflictError,
135
134
  AtomicReadyWalletRejectedUpgradeError,
@@ -230,7 +229,7 @@ import {
230
229
  toFunctionSelector,
231
230
  toSignature,
232
231
  toSignatureHash
233
- } from "./chunk-ZMHYXMO6.js";
232
+ } from "./chunk-5IEP5EGE.js";
234
233
  import {
235
234
  AbiConstructorNotFoundError,
236
235
  AbiConstructorParamsNotFoundError,
@@ -433,10 +432,10 @@ import {
433
432
  toHex,
434
433
  trim,
435
434
  weiUnits
436
- } from "./chunk-YALGASEU.js";
437
- import "./chunk-HIVZG55D.js";
435
+ } from "./chunk-EGELTSPU.js";
436
+ import "./chunk-KG3D7FIF.js";
438
437
  import "./chunk-RBJPAZFI.js";
439
- import "./chunk-5CLSD5YN.js";
438
+ import "./chunk-BPMWXTFX.js";
440
439
  import "./chunk-ZXTAQYNA.js";
441
440
  export {
442
441
  AbiConstructorNotFoundError,
@@ -878,4 +877,4 @@ export {
878
877
  zeroAddress,
879
878
  zeroHash
880
879
  };
881
- //# sourceMappingURL=_esm-FEASBWRP.js.map
880
+ //# sourceMappingURL=_esm-CE7KNONL.js.map