tenjin-cli 0.1.0-alpha.3 → 0.1.0-alpha.30

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 (246) hide show
  1. package/NOTICE.md +54 -7
  2. package/README.md +149 -264
  3. package/dist/{_esm-FEASBWRP.js → _esm-CE7KNONL.js} +9 -10
  4. package/dist/alive-3J3CHOQP.js +21 -0
  5. package/dist/{ccip-NQXCEK2U.js → ccip-7RMRLAGV.js} +4 -4
  6. package/dist/{ccip-XR5NE5QK.js → ccip-NLCSCHKI.js} +5 -5
  7. package/dist/chunk-2SNUOHAT.js +75 -0
  8. package/dist/chunk-2SNUOHAT.js.map +1 -0
  9. package/dist/chunk-3O2BQIF6.js +2227 -0
  10. package/dist/chunk-3O2BQIF6.js.map +1 -0
  11. package/dist/{chunk-ZMHYXMO6.js → chunk-5IEP5EGE.js} +3 -3
  12. package/dist/chunk-5LJCEMFD.js +12700 -0
  13. package/dist/chunk-5LJCEMFD.js.map +1 -0
  14. package/dist/chunk-6W5GYG3W.js +128 -0
  15. package/dist/chunk-6W5GYG3W.js.map +1 -0
  16. package/dist/chunk-7EKYXMUO.js +7536 -0
  17. package/dist/chunk-7EKYXMUO.js.map +1 -0
  18. package/dist/chunk-7QKHZQKW.js +1680 -0
  19. package/dist/chunk-7QKHZQKW.js.map +1 -0
  20. package/dist/chunk-A36LQPHV.js +29 -0
  21. package/dist/chunk-A36LQPHV.js.map +1 -0
  22. package/dist/chunk-AEG2PXBP.js +192 -0
  23. package/dist/chunk-AEG2PXBP.js.map +1 -0
  24. package/dist/chunk-AKWGE6JQ.js +49 -0
  25. package/dist/chunk-AKWGE6JQ.js.map +1 -0
  26. package/dist/chunk-AWFUPKTM.js +238 -0
  27. package/dist/chunk-AWFUPKTM.js.map +1 -0
  28. package/dist/{chunk-UGX7YPX2.js → chunk-AWQPGIR6.js} +7 -9
  29. package/dist/{chunk-UGX7YPX2.js.map → chunk-AWQPGIR6.js.map} +1 -1
  30. package/dist/{chunk-5CLSD5YN.js → chunk-BPMWXTFX.js} +2 -2
  31. package/dist/chunk-EBVIKMCH.js +108 -0
  32. package/dist/chunk-EBVIKMCH.js.map +1 -0
  33. package/dist/{chunk-YALGASEU.js → chunk-EGELTSPU.js} +2 -2
  34. package/dist/{chunk-S3IGX57D.js → chunk-EL56RW2J.js} +166 -7237
  35. package/dist/chunk-EL56RW2J.js.map +1 -0
  36. package/dist/chunk-HE2MS4QO.js +256 -0
  37. package/dist/chunk-HE2MS4QO.js.map +1 -0
  38. package/dist/{chunk-CYOF7ROH.js → chunk-HPWO4O6S.js} +3 -3
  39. package/dist/chunk-IOODYAXL.js +324 -0
  40. package/dist/chunk-IOODYAXL.js.map +1 -0
  41. package/dist/chunk-JMM6YE7J.js +2174 -0
  42. package/dist/chunk-JMM6YE7J.js.map +1 -0
  43. package/dist/{chunk-QVX5MWJZ.js → chunk-JRGFKVAZ.js} +2 -2
  44. package/dist/{chunk-HIVZG55D.js → chunk-KG3D7FIF.js} +2 -2
  45. package/dist/chunk-KHE6L6TD.js +416 -0
  46. package/dist/chunk-KHE6L6TD.js.map +1 -0
  47. package/dist/chunk-KOGZDMHO.js +21 -0
  48. package/dist/chunk-KOGZDMHO.js.map +1 -0
  49. package/dist/chunk-KYFZTGMC.js +237 -0
  50. package/dist/chunk-KYFZTGMC.js.map +1 -0
  51. package/dist/chunk-LFZJM56J.js +159 -0
  52. package/dist/chunk-LFZJM56J.js.map +1 -0
  53. package/dist/chunk-LHHMV4GU.js +27 -0
  54. package/dist/chunk-LHHMV4GU.js.map +1 -0
  55. package/dist/{chunk-YBMMV4Y4.js → chunk-MEFB5KHA.js} +13 -5
  56. package/dist/chunk-MEFB5KHA.js.map +1 -0
  57. package/dist/{chunk-NCE5NSN6.js → chunk-N35E6CM2.js} +140 -10
  58. package/dist/chunk-N35E6CM2.js.map +1 -0
  59. package/dist/chunk-NZIP4PA2.js +114 -0
  60. package/dist/chunk-NZIP4PA2.js.map +1 -0
  61. package/dist/chunk-O2FRQ2L2.js +168 -0
  62. package/dist/chunk-O2FRQ2L2.js.map +1 -0
  63. package/dist/chunk-OK2TDZQU.js +404 -0
  64. package/dist/chunk-OK2TDZQU.js.map +1 -0
  65. package/dist/chunk-ORWL5BSN.js +269 -0
  66. package/dist/chunk-ORWL5BSN.js.map +1 -0
  67. package/dist/{chunk-Z6MFJV5Z.js → chunk-OSYTBCUC.js} +850 -499
  68. package/dist/chunk-OSYTBCUC.js.map +1 -0
  69. package/dist/chunk-P7LABKCW.js +90 -0
  70. package/dist/chunk-P7LABKCW.js.map +1 -0
  71. package/dist/chunk-PAYV4XUA.js +151 -0
  72. package/dist/chunk-PAYV4XUA.js.map +1 -0
  73. package/dist/{chunk-ZABPQJ3M.js → chunk-POUWHWID.js} +2 -2
  74. package/dist/chunk-QUVVWYJW.js +112 -0
  75. package/dist/chunk-QUVVWYJW.js.map +1 -0
  76. package/dist/chunk-RAULEAZ6.js +228 -0
  77. package/dist/chunk-RAULEAZ6.js.map +1 -0
  78. package/dist/chunk-S4SAZ7OD.js +30 -0
  79. package/dist/chunk-S4SAZ7OD.js.map +1 -0
  80. package/dist/chunk-SJLTEINJ.js +117 -0
  81. package/dist/chunk-SJLTEINJ.js.map +1 -0
  82. package/dist/chunk-SPAVAYSW.js +125 -0
  83. package/dist/chunk-SPAVAYSW.js.map +1 -0
  84. package/dist/chunk-TTBKWWTV.js +1605 -0
  85. package/dist/chunk-TTBKWWTV.js.map +1 -0
  86. package/dist/{chunk-RRN3YTK7.js → chunk-TTNESUPQ.js} +3 -3
  87. package/dist/chunk-U6YQ6FRI.js +378 -0
  88. package/dist/chunk-U6YQ6FRI.js.map +1 -0
  89. package/dist/chunk-VFMQTSXG.js +29 -0
  90. package/dist/chunk-VFMQTSXG.js.map +1 -0
  91. package/dist/chunk-VUFAK2LW.js +115 -0
  92. package/dist/chunk-VUFAK2LW.js.map +1 -0
  93. package/dist/chunk-VZGAONSJ.js +194 -0
  94. package/dist/chunk-VZGAONSJ.js.map +1 -0
  95. package/dist/{chunk-OYMYCW7J.js → chunk-WO5BJNIB.js} +682 -53
  96. package/dist/chunk-WO5BJNIB.js.map +1 -0
  97. package/dist/chunk-WVUSXNIE.js +39 -0
  98. package/dist/chunk-WVUSXNIE.js.map +1 -0
  99. package/dist/chunk-XKESD27X.js +10 -0
  100. package/dist/chunk-XKESD27X.js.map +1 -0
  101. package/dist/{chunk-HSDCI7OV.js → chunk-XZKD7DIF.js} +3 -3
  102. package/dist/{chunk-XJIW7USF.js → chunk-YFQOA5AU.js} +118 -9
  103. package/dist/chunk-YFQOA5AU.js.map +1 -0
  104. package/dist/chunk-YHKXNYTB.js +105 -0
  105. package/dist/chunk-YHKXNYTB.js.map +1 -0
  106. package/dist/{cli-SBXI5AMS.js → cli-O5SN7ZJ4.js} +382 -214
  107. package/dist/cli-O5SN7ZJ4.js.map +1 -0
  108. package/dist/config-OJQI27LT.js +45 -0
  109. package/dist/dist-3LOO6M4U.js +2842 -0
  110. package/dist/dist-3LOO6M4U.js.map +1 -0
  111. package/dist/doctor-IQQJHGGM.js +590 -0
  112. package/dist/doctor-IQQJHGGM.js.map +1 -0
  113. package/dist/env-proxy-XL4P73MZ.js +15 -0
  114. package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js → ethersCompat-Df4a6QIZ-THAVUGIJ.js} +5 -5
  115. package/dist/fund-WEV6DMTD.js +365 -0
  116. package/dist/fund-WEV6DMTD.js.map +1 -0
  117. package/dist/hook-command-D2P3ILRV.js +32 -0
  118. package/dist/hosts/claude/.claude-plugin/marketplace.json +19 -0
  119. package/dist/hosts/claude/tenjin/.claude-plugin/plugin.json +14 -0
  120. package/dist/hosts/claude/tenjin/.mcp.json +12 -0
  121. package/dist/hosts/claude/tenjin/hooks/hooks.json +221 -0
  122. package/dist/index.js +21 -2
  123. package/dist/index.js.map +1 -1
  124. package/dist/install-TUCRF32I.js +60 -0
  125. package/dist/install-identity-WHPNMNMQ.js +26 -0
  126. package/dist/install-wallet-MA27FTQ5.js +113 -0
  127. package/dist/install-wallet-MA27FTQ5.js.map +1 -0
  128. package/dist/mcp-QML7ZMPH.js +13427 -0
  129. package/dist/mcp-QML7ZMPH.js.map +1 -0
  130. package/dist/package-LGKYOEPV.js +37 -0
  131. package/dist/package-LGKYOEPV.js.map +1 -0
  132. package/dist/paths-POPTXJO6.js +61 -0
  133. package/dist/paths-POPTXJO6.js.map +1 -0
  134. package/dist/pay-2C2UBBXJ.js +51 -0
  135. package/dist/pay-2C2UBBXJ.js.map +1 -0
  136. package/dist/payments-C44QUFXU.js +106 -0
  137. package/dist/payments-C44QUFXU.js.map +1 -0
  138. package/dist/redact-6W23GGJC.js +15 -0
  139. package/dist/redact-6W23GGJC.js.map +1 -0
  140. package/dist/{secp256k1-N3ZHU7LB.js → secp256k1-ZZZT2CAX.js} +3 -3
  141. package/dist/secp256k1-ZZZT2CAX.js.map +1 -0
  142. package/dist/send-KVJX4XIR.js +222 -0
  143. package/dist/send-KVJX4XIR.js.map +1 -0
  144. package/dist/status-S7C3WMSH.js +115 -0
  145. package/dist/status-S7C3WMSH.js.map +1 -0
  146. package/dist/status-line-YR2T5HC4.js +86 -0
  147. package/dist/status-line-YR2T5HC4.js.map +1 -0
  148. package/dist/uninstall-HY6LKIIT.js +149 -0
  149. package/dist/uninstall-HY6LKIIT.js.map +1 -0
  150. package/dist/update-OJV22LR3.js +36 -0
  151. package/dist/update-OJV22LR3.js.map +1 -0
  152. package/dist/usdc-JK4RRFFQ.js +39 -0
  153. package/dist/usdc-JK4RRFFQ.js.map +1 -0
  154. package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js → viemAdapter-By13KInL-X2VY6CY3.js} +5 -5
  155. package/dist/viemAdapter-By13KInL-X2VY6CY3.js.map +1 -0
  156. package/dist/wallet-PD2IMZDU.js +39 -0
  157. package/dist/wallet-PD2IMZDU.js.map +1 -0
  158. package/dist/wallet-kdf-worker.mjs +980 -0
  159. package/docs/agent-permissions.md +180 -0
  160. package/docs/safety-model.md +59 -0
  161. package/docs/troubleshooting.md +13 -0
  162. package/package.json +28 -19
  163. package/LICENSE +0 -21
  164. package/dist/buy-EE6SEXP6.js +0 -1598
  165. package/dist/buy-EE6SEXP6.js.map +0 -1
  166. package/dist/candidate-ERMSYYQZ.js +0 -127
  167. package/dist/candidate-ERMSYYQZ.js.map +0 -1
  168. package/dist/chunk-3OV7E5G5.js +0 -18
  169. package/dist/chunk-3OV7E5G5.js.map +0 -1
  170. package/dist/chunk-4ONXEEQL.js +0 -152
  171. package/dist/chunk-4ONXEEQL.js.map +0 -1
  172. package/dist/chunk-662MSGZB.js +0 -286
  173. package/dist/chunk-662MSGZB.js.map +0 -1
  174. package/dist/chunk-7KUW4MJD.js +0 -59
  175. package/dist/chunk-7KUW4MJD.js.map +0 -1
  176. package/dist/chunk-AWPAWHNX.js +0 -333
  177. package/dist/chunk-AWPAWHNX.js.map +0 -1
  178. package/dist/chunk-DXTQ3CSI.js +0 -171
  179. package/dist/chunk-DXTQ3CSI.js.map +0 -1
  180. package/dist/chunk-ESPNTPQ2.js +0 -207
  181. package/dist/chunk-ESPNTPQ2.js.map +0 -1
  182. package/dist/chunk-FJPLRISB.js +0 -79
  183. package/dist/chunk-FJPLRISB.js.map +0 -1
  184. package/dist/chunk-GO75V3NZ.js +0 -160
  185. package/dist/chunk-GO75V3NZ.js.map +0 -1
  186. package/dist/chunk-JPHG2JW3.js +0 -96
  187. package/dist/chunk-JPHG2JW3.js.map +0 -1
  188. package/dist/chunk-MUBUQVC3.js +0 -67
  189. package/dist/chunk-MUBUQVC3.js.map +0 -1
  190. package/dist/chunk-NCE5NSN6.js.map +0 -1
  191. package/dist/chunk-OYMYCW7J.js.map +0 -1
  192. package/dist/chunk-RY4XKNV3.js +0 -140
  193. package/dist/chunk-RY4XKNV3.js.map +0 -1
  194. package/dist/chunk-S3IGX57D.js.map +0 -1
  195. package/dist/chunk-TLCMMYLY.js +0 -126
  196. package/dist/chunk-TLCMMYLY.js.map +0 -1
  197. package/dist/chunk-UO22YNY4.js +0 -69
  198. package/dist/chunk-UO22YNY4.js.map +0 -1
  199. package/dist/chunk-XHC6FCGZ.js +0 -261
  200. package/dist/chunk-XHC6FCGZ.js.map +0 -1
  201. package/dist/chunk-XJIW7USF.js.map +0 -1
  202. package/dist/chunk-YBMMV4Y4.js.map +0 -1
  203. package/dist/chunk-YN5SHIXQ.js +0 -126
  204. package/dist/chunk-YN5SHIXQ.js.map +0 -1
  205. package/dist/chunk-Z52RA3NC.js +0 -137
  206. package/dist/chunk-Z52RA3NC.js.map +0 -1
  207. package/dist/chunk-Z6MFJV5Z.js.map +0 -1
  208. package/dist/cli-SBXI5AMS.js.map +0 -1
  209. package/dist/config-VELDKLHY.js +0 -21
  210. package/dist/doctor-T3KWNNP2.js +0 -20
  211. package/dist/inspect-LMKOXE4Y.js +0 -96
  212. package/dist/inspect-LMKOXE4Y.js.map +0 -1
  213. package/dist/install-LEX3ENQ6.js +0 -387
  214. package/dist/install-LEX3ENQ6.js.map +0 -1
  215. package/dist/lookup-ZPN2Q67N.js +0 -129
  216. package/dist/lookup-ZPN2Q67N.js.map +0 -1
  217. package/dist/outcome-N7TAK6WR.js +0 -66
  218. package/dist/outcome-N7TAK6WR.js.map +0 -1
  219. package/dist/publish-BKBQQAW4.js +0 -1478
  220. package/dist/publish-BKBQQAW4.js.map +0 -1
  221. package/dist/usdc-JIAJW4SV.js +0 -22
  222. package/dist/wallet-CWEMYVIH.js +0 -179
  223. package/dist/wallet-CWEMYVIH.js.map +0 -1
  224. package/dist/wallet-PA54CRBL.js +0 -30
  225. package/skills/tenjin/SKILL.md +0 -199
  226. package/skills/tenjin-publish/SKILL.md +0 -111
  227. package/skills/tenjin-search/SKILL.md +0 -133
  228. /package/dist/{_esm-FEASBWRP.js.map → _esm-CE7KNONL.js.map} +0 -0
  229. /package/dist/{ccip-NQXCEK2U.js.map → alive-3J3CHOQP.js.map} +0 -0
  230. /package/dist/{ccip-XR5NE5QK.js.map → ccip-7RMRLAGV.js.map} +0 -0
  231. /package/dist/{config-VELDKLHY.js.map → ccip-NLCSCHKI.js.map} +0 -0
  232. /package/dist/{chunk-ZMHYXMO6.js.map → chunk-5IEP5EGE.js.map} +0 -0
  233. /package/dist/{chunk-5CLSD5YN.js.map → chunk-BPMWXTFX.js.map} +0 -0
  234. /package/dist/{chunk-YALGASEU.js.map → chunk-EGELTSPU.js.map} +0 -0
  235. /package/dist/{chunk-CYOF7ROH.js.map → chunk-HPWO4O6S.js.map} +0 -0
  236. /package/dist/{chunk-QVX5MWJZ.js.map → chunk-JRGFKVAZ.js.map} +0 -0
  237. /package/dist/{chunk-HIVZG55D.js.map → chunk-KG3D7FIF.js.map} +0 -0
  238. /package/dist/{chunk-ZABPQJ3M.js.map → chunk-POUWHWID.js.map} +0 -0
  239. /package/dist/{chunk-RRN3YTK7.js.map → chunk-TTNESUPQ.js.map} +0 -0
  240. /package/dist/{chunk-HSDCI7OV.js.map → chunk-XZKD7DIF.js.map} +0 -0
  241. /package/dist/{doctor-T3KWNNP2.js.map → config-OJQI27LT.js.map} +0 -0
  242. /package/dist/{ethersCompat-Df4a6QIZ-3YZIAXDK.js.map → env-proxy-XL4P73MZ.js.map} +0 -0
  243. /package/dist/{secp256k1-N3ZHU7LB.js.map → ethersCompat-Df4a6QIZ-THAVUGIJ.js.map} +0 -0
  244. /package/dist/{usdc-JIAJW4SV.js.map → hook-command-D2P3ILRV.js.map} +0 -0
  245. /package/dist/{viemAdapter-By13KInL-ZZE6UV4Y.js.map → install-TUCRF32I.js.map} +0 -0
  246. /package/dist/{wallet-PA54CRBL.js.map → install-identity-WHPNMNMQ.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 CLI's secret redaction rules 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,307 +1,192 @@
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. Tenjin picks the right tool when your agent needs one, and one wallet pays for every call.</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
+ <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>
12
+ <img src="https://img.shields.io/badge/works%20with-Claude%20Code-1C1A17" alt="Works with Claude Code">
13
+ <img src="https://img.shields.io/badge/payments-x402-8C9A7E" alt="Payments via x402">
14
+ </p>
6
15
 
7
- **No API keys. No accounts. Payment is the identity.**
16
+ <p align="center">
17
+ <a href="#quick-start">Quick start</a> ·
18
+ <a href="#what-it-can-do">Tools</a> ·
19
+ <a href="#wallet-and-payments">Wallet &amp; payments</a> ·
20
+ <a href="#request-a-tool">Request a tool</a>
21
+ </p>
8
22
 
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)
23
+ <p align="center">
24
+ <img src="./assets/demo.gif" alt="Tenjin in Claude Code: research, live crypto prices, company lookup, email verification, and computation" width="720">
25
+ </p>
12
26
 
13
- </div>
27
+ ---
14
28
 
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.
29
+ ## Why
19
30
 
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.
31
+ Giving your agent good tools is a chore today:
27
32
 
28
- ## Use Tenjin today, zero install
33
+ - **A key for every tool.** Sign up, pick a plan, paste an API key into a config file. Five tools, five accounts.
34
+ - **MCP servers crowd the context.** Every server you install loads its tool definitions into every session, needed or not.
35
+ - **Your agent forgets anyway.** It reaches for plain web search out of habit, so you write rules to remind it, and it still slips.
36
+ - **Some tools you need once.** Installing something permanent for a one-off lookup isn't worth the setup.
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
+ 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, the tasks it hands to subagents, and the questions it asks you. 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.
39
39
 
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`.
40
+ ## Quick start
45
41
 
46
- ### Install the skills: `npx tenjin-cli install`
42
+ In Claude Code or Claude Desktop, paste:
47
43
 
48
- ```bash
49
- npx tenjin-cli install
44
+ ```text
45
+ Install Tenjin from tenjin.sh
50
46
  ```
51
47
 
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.
57
-
58
- Where the skills land:
48
+ Your agent asks you about spend limits, installs it, then asks whether to add funds now; you never type a command. Then type `/reload-plugins`, or start a new session, and Tenjin is on (when upgrading from an earlier release, start a new session). It needs Claude Code 2.1.287 or newer.
59
49
 
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:
50
+ Or in a terminal (Node.js 22 or newer):
68
51
 
69
- ```toml
70
- [sandbox_workspace_write]
71
- network_access = true
72
- ```
52
+ ```bash
53
+ npm i -g tenjin-cli
54
+ tenjin install # adds the Tenjin plugin to Claude Code and creates your wallet
55
+ tenjin wallet fund 5 # optional: add $5 with a card, via Coinbase
56
+ ```
73
57
 
74
- - **Nothing detected**: the installer falls back to `~/.agents/skills/`, so a
75
- harness installed later still finds the skills.
58
+ ## What it can do
76
59
 
77
- The repo ships three skills:
60
+ 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. Each routing call costs a flat [routing fee](#routing-fee) of $0.003, on top of the provider's price, paid from channel deposits of up to $0.25 that count against the spend limits you approve at install.
78
61
 
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.
62
+ | Tool | What your agent gets | Price per call |
63
+ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------- |
64
+ | **Docs lookup** · [Context7](https://context7.com) | Current, version-specific docs for a library or API | **Free** |
65
+ | **Web research** · [Exa](https://exa.ai) | Search results with the page content, not just links | $0.007 |
66
+ | **Read a page** · [Firecrawl](https://firecrawl.dev) | One exact page as clean text, even when a plain fetch fails | $0.01 |
67
+ | **Crypto prices** · [CoinMarketCap](https://coinmarketcap.com) | Live quotes for any coin | $0.01 |
68
+ | **Compute** · [Wolfram Alpha](https://www.wolframalpha.com) | Math, unit conversions, science and data questions | $0.02 |
69
+ | **Email check** · [Hunter](https://hunter.io) | Whether an address is real and deliverable | $0.008 |
70
+ | **Person lookup** · [Apollo](https://www.apollo.io) | A professional profile and work email from a name and company, a LinkedIn URL or an email | $0.01 |
71
+ | **Company profile** · [Apollo](https://www.apollo.io) | Industry, headcount, revenue and funding from a domain | $0.01 |
72
+ | **Company match** · [CompanyEnrich](https://companyenrich.com) | The company behind a name or a social URL | $0.01225 |
73
+ | **X posts** · [glim](https://glim.sh) | Posts matching a search, or one post with its thread | $0.005 |
74
+ | **Reddit** · [glim](https://glim.sh) | Posts matching a search, or one thread with its comments | $0.01 / $0.005 |
88
75
 
89
- A funded wallet is only needed for paid reads and publishing.
76
+ Every tool, including the Tenjin list, with current prices: [tenjin.sh/tools](https://tenjin.sh/tools). More are added by demand: [tell us what you want](#request-a-tool).
90
77
 
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.
78
+ ### Tenjin list and experimental Bazaar
93
79
 
94
- ### Add the remote MCP server
80
+ **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
81
 
96
- **Claude Code**
82
+ **The open Bazaar is experimental and off by default.** Turn it on with:
97
83
 
98
- ```bash
99
- claude mcp add --transport http tenjin https://tenjin.blog/api/mcp
84
+ ```sh
85
+ tenjin config set experimental.bazaar on
100
86
  ```
101
87
 
102
- **Cursor** (`.cursor/mcp.json`)
88
+ 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`.
89
+
90
+ ## How it works
103
91
 
104
- ```json
105
- {
106
- "mcpServers": {
107
- "tenjin": { "url": "https://tenjin.blog/api/mcp" }
108
- }
109
- }
92
+ ```mermaid
93
+ flowchart LR
94
+ A["Your prompt,<br>a web search,<br>or a subagent task"] --> B{"Tenjin<br>router"}
95
+ B -- "a tool fits" --> C["Agent calls it<br>through x402"]
96
+ C --> D["Wallet pays the provider,<br>result comes back"]
97
+ B -- "nothing better" --> E["Agent carries on"]
110
98
  ```
111
99
 
112
- **OpenClaw**
100
+ 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
101
 
114
- ```bash
115
- openclaw mcp add tenjin --url https://tenjin.blog/api/mcp --transport streamable-http
116
- ```
102
+ When one fits, your agent sees a one-line suggestion with the tool and its price, and calls it through the Tenjin plugin's MCP server: the offer's id alone shows the tool's inputs, an example and what it returns, and the id with the agent's input runs it. Tenjin builds the call, pays the provider from your wallet, within your limits, and hands back the result.
117
103
 
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.
104
+ To pick a tool, the router sends your prompt and recent messages with secrets masked, plus the searches, URLs, subagent tasks and questions it routes; tool results stay on your machine. [What it sends, and everything install writes →](./docs/agent-permissions.md#what-the-hooks-send)
122
105
 
123
- ## The CLI: `tenjin-cli`
106
+ ## Wallet and payments
124
107
 
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.
108
+ 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).
129
109
 
130
- ```bash
131
- npm install -g tenjin-cli@next # pre-release channel
132
- tenjin doctor # verify Node floor, API reachability, contract, wallet
133
- ```
110
+ ### Your wallet
111
+
112
+ `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.
113
+
114
+ ### Limits
115
+
116
+ | Limit | Default | Change it |
117
+ | -------- | ------- | ------------------------------------- |
118
+ | Per day | $5 | `tenjin config set sessionBudget 2` |
119
+ | Per call | $0.25 | `tenjin config set maxAutoSpend 0.50` |
120
+
121
+ The daily budget is the control, the per-call limit is the runaway guard, and your wallet balance is the hard stop. Both defaults hold from the moment you install. `tenjin install` asks once, or tells your agent to ask you when the agent runs it: use the defaults, or set your own limits. The per-call limit cannot go below $0.25, the routing deposit. To turn the router off, run `tenjin config set router.enabled false`.
122
+
123
+ A call that would pay more than the per-call limit (all its payments together, such as five takes of a video; today two video models at $0.42 and $0.45, hosting at $0.50 and research at $0.60 are priced above it) pays nothing on its own: your assistant tells you what it costs, and in Claude Code it asks you through Claude Code's own permission prompt and runs it once you say yes. [How the limits work →](./docs/agent-permissions.md#what-bounds-a-payment)
124
+
125
+ ### Routing fee
126
+
127
+ Each routing call costs a flat $0.003, paid over x402 `batch-settlement` by `tenjin mcp` from a channel deposit of up to $0.25. A deposit is an automatic payment: it counts against the limits above, and approving them at install approves the fee. The fees come out of the deposit and are not counted again. When a deposit is taken, Claude Code says so once; `tenjin status` shows it as prepaid routing credit, apart from what lookups cost, and `tenjin wallet balance` adds the credit still left. When a call cannot be paid, it takes the free path, and Claude Code tells you once per session why and what fixes it; `tenjin doctor` says the same. Details are in [docs/agent-permissions.md](docs/agent-permissions.md#what-bounds-a-router-payment-on-top-of-that).
128
+
129
+ ### Funding
130
+
131
+ `tenjin wallet fund 5` opens a Coinbase Onramp checkout for your wallet. In the US, Apple Pay or Google Pay with no Coinbase account. Elsewhere, your Coinbase account. You can also send USDC on Base to the address `tenjin wallet address` prints; at a terminal it and `tenjin wallet fund` also draw that address as a QR code for a phone wallet to scan (`--no-qr` skips it).
134
132
 
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.mode` governs ALL publishing uniformly. A piece you asked for and a
177
- reusable answer your agent derived after a lookup both go through it, after a
178
- deterministic local scan (secrets, keys, PII, wallet addresses) that runs in
179
- every mode:
180
-
181
- - **`review`** (the default) asks a one-click yes/no for every publish, even a
182
- clean scan. This is the safe default: nothing leaves your machine unseen.
183
- - **`auto`** publishes a clean scan immediately, including answers your agent
184
- derives; any warning finding stops and asks; a hard block (a live secret or
185
- private key) always refuses.
186
- - **`full-auto`** does not stop for warnings, only for hard blocks. It is honored
187
- from your global config, an env var, a flag, or a gitignored `.tenjin.json`. Only
188
- a committed `.tenjin.json` asking for `full-auto` is downgraded to `auto`, so
189
- cloning a repo can never enable silent auto-publishing.
190
-
191
- `--yes` clears the warning findings and the review confirm; it never clears a hard
192
- block. Set the mode with `tenjin config set publish.mode <mode>`, or per run with
193
- `--mode`. `tenjin install` asks once on an interactive setup and otherwise leaves
194
- the default (review); change it any time with `tenjin config set publish.mode`.
195
-
196
- Pricing: `--price` (or a frontmatter `price:`) wins, otherwise `publish.defaultPrice`
197
- (default $0.10). A card never auto-prices; the `tenjin-publish` skill's rubric is
198
- what actually chooses a price before it calls the command.
199
-
200
- Instead of a file, `publish --candidate <id>` publishes a parked candidate (see
201
- `tenjin candidate`) from its stored `draft.md`, prefilling the card's question from
202
- the candidate. It runs the same scan and consent flow and clears the candidate only
203
- on a successful publish; a file and `--candidate` are mutually exclusive.
204
-
205
- Next: a Claude Code plugin marketplace in this repo, and `tenjin mcp` (local
206
- stdio server over the same core).
207
-
208
- ### Output contract
209
-
210
- Every invocation prints exactly one JSON envelope to stdout
211
- (`{schemaVersion, command, ok, data | error}`); human rendering goes to stderr
212
- only. Exit codes: `0` success (including an honest MISS), `1` runtime/network,
213
- `2` usage, `3` policy refusal (spend cap, allowlist, missing approval), `4`
214
- payment failure after approval.
215
-
216
- ### Safety model
217
-
218
- - Default maximum automatic spend is **zero**. Nothing pays without explicit
219
- approval or an explicitly configured policy.
220
- - Keys are generated locally and stored **encrypted at rest** in
221
- `~/.tenjin/wallet.json` (Keystore v3, scrypt), mode `0600`. The plaintext key
222
- is never written to disk. The wallet address stays readable, so `show`,
223
- `balance`, and `doctor` work without a passphrase; only signing decrypts.
224
- Signing is local and the CLI talks only to the configured base URL.
225
- - The signing passphrase resolves in order: `TENJIN_WALLET_PASSPHRASE`, then the
226
- OS credential store, then an interactive prompt. On `wallet create` with no env
227
- passphrase, a strong random one is generated and saved to the OS store so later
228
- signing is transparent. Where it lands per platform:
229
- - **macOS**: the login keychain, via the OS `security` tool (the same
230
- mechanism the GitHub CLI uses).
231
- - **Windows**: a DPAPI-encrypted file (`passphrase.dpapi`), decryptable only by
232
- the same user on the same machine, via built-in PowerShell. The file holds
233
- ciphertext, not the passphrase.
234
- - **Desktop Linux**: the Secret Service keyring, via `secret-tool` when
235
- libsecret-tools is installed.
236
- - **Headless or CI (any OS)**: no durable OS store, so set
237
- `TENJIN_WALLET_PASSPHRASE`.
238
-
239
- The passphrase reaches these tools over stdin, never on a command line, and the
240
- key never leaves the machine.
241
-
242
- - Fund small: this is a pocket-money wallet by design.
243
- - Purchased content is untrusted data, never instructions.
244
-
245
- ## Development
133
+ $5, the Apple Pay and Google Pay minimum, covers about 700 web searches, 500 page reads or 250 Wolfram Alpha answers.
134
+
135
+ ### Withdrawing
136
+
137
+ `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.
138
+
139
+ ## Everyday commands
246
140
 
247
141
  ```bash
248
- pnpm install
249
- pnpm check # build + test
250
- pnpm lint && pnpm typecheck && pnpm format:check
251
- pnpm pack-smoke # exercises the packed npm artifact
142
+ tenjin status # what you've spent today
143
+ tenjin wallet balance # what's left
144
+ tenjin wallet fund 5 # top up
145
+ tenjin payments # the paid lookups this machine made
146
+ tenjin payments reconcile # settle paid lookups whose settlement was unknown
147
+ tenjin update # newest version; wallet and settings stay
148
+ tenjin config set router.enabled false # pause the router on this machine
149
+ tenjin config set --project router.enabled false # ...or just in this repo
150
+ tenjin uninstall # remove the Claude Code plugin; your wallet stays
252
151
  ```
253
152
 
254
- ## Release
153
+ Use `tenjin install --project` to set it up for a single project; `tenjin doctor` run in that project checks it, and `tenjin update` refreshes it with the rest. Add `--json` to any command for machine-readable output.
255
154
 
256
- Publishing to npm uses **Changesets** + **npm Trusted Publishing (OIDC)**,
257
- driven by the two-job `workflow_dispatch`-only `.github/workflows/release.yml`.
258
- This mirrors the house template in `BackTrackCo/x402r-sdk`. Nothing auto-fires
259
- from a push or a tag: a maintainer clicks Run workflow at each step.
155
+ The CLI asks npm at most once a day whether a newer version exists and says so; it never updates itself, so `tenjin update` is yours to run. `tenjin config set update.mode off` turns that check off, the request to npm included, and `TENJIN_NO_UPDATE_CHECK=1` in the environment does the same wherever it is set.
260
156
 
261
- Day to day, add a changeset in the same PR as any shippable change:
157
+ Every paid lookup is recorded on your machine, with the files and full results it returned. [Where they live, and what `payments reconcile` does →](./docs/agent-permissions.md#what-a-paid-lookup-leaves-on-your-machine)
262
158
 
263
- ```sh
264
- pnpm changeset # pick the bump type, write a summary; commit the .md
265
- ```
159
+ <details>
160
+ <summary>Spending limits: the fine print</summary>
161
+
162
+ 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 the daily limit to `0` blocks automatic payments; `tenjin config set sessionBudget none` removes the daily ceiling only.
163
+
164
+ `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).
165
+
166
+ </details>
167
+
168
+ ## Request a tool
266
169
 
267
- To cut a release (two clicks):
268
-
269
- 1. **Dispatch (click 1)**: Actions -> Release -> Run workflow -> `main`. The
270
- `version` job runs `changeset version` (consumes `.changeset/*.md`, bumps
271
- `package.json`, regenerates `CHANGELOG.md`) and opens the
272
- **"chore(release): version packages"** PR. Nothing is published yet.
273
- 2. **Review and merge** that PR (its final state is what ships; edit the
274
- version or changelog directly if needed).
275
- 3. **Dispatch (click 2)**: same path. With no pending changesets, the `publish`
276
- job builds, runs the check suite + `pnpm audit` + the packed-artifact smoke
277
- as a pre-publish gate, then `changeset publish` ships `tenjin-cli` with
278
- provenance and creates the GitHub release. Prereleases use Changesets' pre
279
- mode (`pnpm changeset pre enter alpha`) and publish to that dist-tag; stable
280
- goes to `latest`.
281
-
282
- Auth is npm Trusted Publishing (OIDC): each publish mints a short-lived,
283
- per-run token, so there is **no `NPM_TOKEN`** to store or rotate.
284
-
285
- ### One-time owner setup
286
-
287
- `tenjin-cli` already exists on npm (published `0.1.0-alpha.1`), so no manual
288
- first publish is needed. The owner must, one time:
289
-
290
- 1. **Install the release-bot GitHub App on `BackTrackCo/tenjin-agent`** (the
291
- same `x402r-release-bot` App used by `x402r-sdk`, or an equivalent), then
292
- set repo **variable** `RELEASE_APP_CLIENT_ID` and repo **secret**
293
- `RELEASE_APP_PRIVATE_KEY`. Required because Changesets' version PR must be
294
- opened by an App identity to trigger CI (the default `GITHUB_TOKEN` cannot,
295
- by GitHub's anti-recursion rule). Neither the variable nor the secret is
296
- set on this repo yet, so `release.yml` will fail at the token step until
297
- they exist.
298
- 2. **Add a Trusted Publisher** to `tenjin-cli` on npmjs.com: provider GitHub
299
- Actions, organization `BackTrackCo`, repository `tenjin-agent`, workflow
300
- filename `release.yml`, environment `npm-publish`.
301
- 3. **Create a GitHub Environment named `npm-publish`** (Settings ->
302
- Environments), optionally with required reviewers to gate each publish.
303
-
304
- ## License
305
-
306
- MIT. See [NOTICE.md](./NOTICE.md) for third-party attributions (wallet-safety
307
- patterns adapted from BlockRun MCP via the archived `tenjin-mcp` prototype).
170
+ 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.
171
+
172
+ - **[Request a tool →](https://github.com/BackTrackCo/tenjin-agent/issues/new?title=Tool%20request%3A%20&labels=enhancement)**
173
+ - **[Report a bug →](https://github.com/BackTrackCo/tenjin-agent/issues/new?labels=bug)**
174
+
175
+ ## Learn more
176
+
177
+ - [How a lookup runs, what it sends, and what install writes](./docs/agent-permissions.md)
178
+ - [Safety model](./docs/safety-model.md)
179
+ - [Troubleshooting](./docs/troubleshooting.md)
180
+
181
+ ## Developing
182
+
183
+ Before contributing, read [CONTRIBUTING.md](./CONTRIBUTING.md) for the contributor agreement.
184
+
185
+ ```bash
186
+ pnpm install
187
+ pnpm run githooks # once, to use the repo's git hooks
188
+ pnpm run build
189
+ pnpm run test
190
+ pnpm run typecheck
191
+ pnpm run lint
192
+ ```
@@ -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
@@ -0,0 +1,21 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ aliveDir,
4
+ aliveMain,
5
+ markSessionServed,
6
+ readAliveStamp,
7
+ removeAliveState,
8
+ runAliveHook,
9
+ sessionServedByPlugin
10
+ } from "./chunk-6W5GYG3W.js";
11
+ import "./chunk-ZXTAQYNA.js";
12
+ export {
13
+ aliveDir,
14
+ aliveMain,
15
+ markSessionServed,
16
+ readAliveStamp,
17
+ removeAliveState,
18
+ runAliveHook,
19
+ sessionServedByPlugin
20
+ };
21
+ //# sourceMappingURL=alive-3J3CHOQP.js.map