tenjin-cli 0.1.0-alpha.1 → 0.1.0-alpha.11

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 (193) hide show
  1. package/NOTICE.md +33 -0
  2. package/README.md +596 -79
  3. package/dist/{_esm-ZH2J4QEH.js → _esm-C5CRWCYU.js} +2 -2
  4. package/dist/_esm-N4KAVXQR.js +881 -0
  5. package/dist/buy-THMVOPUH.js +44 -0
  6. package/dist/ccip-RPPPKTJR.js +19 -0
  7. package/dist/{ccip-UCLT5VOW.js → ccip-ZGGWQN4X.js} +6 -5
  8. package/dist/chunk-2I4QTOLB.js +11 -0
  9. package/dist/chunk-2I4QTOLB.js.map +1 -0
  10. package/dist/chunk-2SDUV6MQ.js +352 -0
  11. package/dist/chunk-2SDUV6MQ.js.map +1 -0
  12. package/dist/chunk-3GSZUADW.js +199 -0
  13. package/dist/chunk-3GSZUADW.js.map +1 -0
  14. package/dist/{chunk-BRJHUQSY.js → chunk-47PP7TAG.js} +908 -812
  15. package/dist/chunk-47PP7TAG.js.map +1 -0
  16. package/dist/chunk-4NTZETIL.js +158 -0
  17. package/dist/chunk-4NTZETIL.js.map +1 -0
  18. package/dist/chunk-4TCU3YRD.js +130 -0
  19. package/dist/chunk-4TCU3YRD.js.map +1 -0
  20. package/dist/chunk-6BGYHARE.js +14620 -0
  21. package/dist/chunk-6BGYHARE.js.map +1 -0
  22. package/dist/chunk-6UY2UQMY.js +213 -0
  23. package/dist/chunk-6UY2UQMY.js.map +1 -0
  24. package/dist/{chunk-IPOWB3G3.js → chunk-7FK2UN2T.js} +3515 -507
  25. package/dist/chunk-7FK2UN2T.js.map +1 -0
  26. package/dist/chunk-ALUNME53.js +306 -0
  27. package/dist/chunk-ALUNME53.js.map +1 -0
  28. package/dist/{chunk-EXBMF5X7.js → chunk-CNUXRXI2.js} +526 -79
  29. package/dist/chunk-CNUXRXI2.js.map +1 -0
  30. package/dist/chunk-E6YOODH7.js +913 -0
  31. package/dist/chunk-E6YOODH7.js.map +1 -0
  32. package/dist/chunk-EDVI7RRD.js +317 -0
  33. package/dist/chunk-EDVI7RRD.js.map +1 -0
  34. package/dist/chunk-FKSAUOJU.js +137 -0
  35. package/dist/chunk-FKSAUOJU.js.map +1 -0
  36. package/dist/chunk-GKV6VZSZ.js +125 -0
  37. package/dist/chunk-GKV6VZSZ.js.map +1 -0
  38. package/dist/chunk-GUUAYR3K.js +175 -0
  39. package/dist/chunk-GUUAYR3K.js.map +1 -0
  40. package/dist/chunk-IAFYUFIC.js +1408 -0
  41. package/dist/chunk-IAFYUFIC.js.map +1 -0
  42. package/dist/chunk-IB63U6BM.js +185 -0
  43. package/dist/chunk-IB63U6BM.js.map +1 -0
  44. package/dist/chunk-IXTENA2H.js +235 -0
  45. package/dist/chunk-IXTENA2H.js.map +1 -0
  46. package/dist/chunk-JTYIX6OD.js +161 -0
  47. package/dist/chunk-JTYIX6OD.js.map +1 -0
  48. package/dist/chunk-KYQVEKP5.js +209 -0
  49. package/dist/chunk-KYQVEKP5.js.map +1 -0
  50. package/dist/chunk-KZAAWQNP.js +6199 -0
  51. package/dist/chunk-KZAAWQNP.js.map +1 -0
  52. package/dist/{chunk-T4LKNY7T.js → chunk-M2O56UK7.js} +225 -70
  53. package/dist/chunk-M2O56UK7.js.map +1 -0
  54. package/dist/chunk-MJZZTKCC.js +323 -0
  55. package/dist/chunk-MJZZTKCC.js.map +1 -0
  56. package/dist/chunk-NUF2PKJO.js +207 -0
  57. package/dist/chunk-NUF2PKJO.js.map +1 -0
  58. package/dist/chunk-O25VWJCG.js +1357 -0
  59. package/dist/chunk-O25VWJCG.js.map +1 -0
  60. package/dist/chunk-OCN27NJV.js +612 -0
  61. package/dist/chunk-OCN27NJV.js.map +1 -0
  62. package/dist/chunk-OZHJ3FLR.js +105 -0
  63. package/dist/chunk-OZHJ3FLR.js.map +1 -0
  64. package/dist/chunk-P74I3WH4.js +204 -0
  65. package/dist/chunk-P74I3WH4.js.map +1 -0
  66. package/dist/chunk-POJRB2AE.js +83 -0
  67. package/dist/chunk-POJRB2AE.js.map +1 -0
  68. package/dist/{chunk-YG2DO46P.js → chunk-PZRAAAY2.js} +107 -22
  69. package/dist/chunk-PZRAAAY2.js.map +1 -0
  70. package/dist/chunk-PZSUWDF2.js +35 -0
  71. package/dist/chunk-PZSUWDF2.js.map +1 -0
  72. package/dist/chunk-QW2Q2KAH.js +27 -0
  73. package/dist/chunk-QW2Q2KAH.js.map +1 -0
  74. package/dist/{chunk-CUWUHTIL.js → chunk-RBJPAZFI.js} +16 -202
  75. package/dist/chunk-RBJPAZFI.js.map +1 -0
  76. package/dist/chunk-RSBN67PA.js +152 -0
  77. package/dist/chunk-RSBN67PA.js.map +1 -0
  78. package/dist/chunk-S5RYMCV6.js +70 -0
  79. package/dist/chunk-S5RYMCV6.js.map +1 -0
  80. package/dist/chunk-SFGXAZ3M.js +316 -0
  81. package/dist/chunk-SFGXAZ3M.js.map +1 -0
  82. package/dist/chunk-SGK2B724.js +67 -0
  83. package/dist/chunk-SGK2B724.js.map +1 -0
  84. package/dist/chunk-TDDN5GXR.js +145 -0
  85. package/dist/chunk-TDDN5GXR.js.map +1 -0
  86. package/dist/{chunk-LPRVHM7P.js → chunk-U5S527PP.js} +1655 -114
  87. package/dist/chunk-U5S527PP.js.map +1 -0
  88. package/dist/chunk-UFPJBS4C.js +242 -0
  89. package/dist/chunk-UFPJBS4C.js.map +1 -0
  90. package/dist/chunk-UHTVXQ2O.js +140 -0
  91. package/dist/chunk-UHTVXQ2O.js.map +1 -0
  92. package/dist/chunk-UY6CGULW.js +83 -0
  93. package/dist/chunk-UY6CGULW.js.map +1 -0
  94. package/dist/chunk-VWY3U732.js +674 -0
  95. package/dist/chunk-VWY3U732.js.map +1 -0
  96. package/dist/{chunk-Q53IYV2G.js → chunk-W6R3HAAG.js} +20 -17
  97. package/dist/{chunk-Q53IYV2G.js.map → chunk-W6R3HAAG.js.map} +1 -1
  98. package/dist/chunk-XJN5WUKL.js +204 -0
  99. package/dist/chunk-XJN5WUKL.js.map +1 -0
  100. package/dist/chunk-XWHXX2BI.js +149 -0
  101. package/dist/chunk-XWHXX2BI.js.map +1 -0
  102. package/dist/{chunk-DXPYFVKG.js → chunk-Y7ERTA7D.js} +35 -15
  103. package/dist/chunk-Y7ERTA7D.js.map +1 -0
  104. package/dist/chunk-YLYINX2H.js +7806 -0
  105. package/dist/chunk-YLYINX2H.js.map +1 -0
  106. package/dist/chunk-ZE7KOO7A.js +233 -0
  107. package/dist/chunk-ZE7KOO7A.js.map +1 -0
  108. package/dist/chunk-ZQIQ55KK.js +51 -0
  109. package/dist/chunk-ZQIQ55KK.js.map +1 -0
  110. package/dist/{chunk-3IMLRUZE.js → chunk-ZXTAQYNA.js} +6 -2
  111. package/dist/{cli-WA65NP4Y.js → cli-Y2HBOSGK.js} +437 -175
  112. package/dist/cli-Y2HBOSGK.js.map +1 -0
  113. package/dist/config-WDGMZKHU.js +26 -0
  114. package/dist/config-WDGMZKHU.js.map +1 -0
  115. package/dist/dist-U4M6QCKE.js +2842 -0
  116. package/dist/dist-U4M6QCKE.js.map +1 -0
  117. package/dist/doctor-CSIWKWM2.js +27 -0
  118. package/dist/doctor-CSIWKWM2.js.map +1 -0
  119. package/dist/edit-E7N6F3OY.js +38 -0
  120. package/dist/edit-E7N6F3OY.js.map +1 -0
  121. package/dist/ethersCompat-Df4a6QIZ-WHYKB6HA.js +18 -0
  122. package/dist/ethersCompat-Df4a6QIZ-WHYKB6HA.js.map +1 -0
  123. package/dist/fund-OKK627GL.js +38 -0
  124. package/dist/fund-OKK627GL.js.map +1 -0
  125. package/dist/index.js +1 -1
  126. package/dist/inspect-573WHEV4.js +35 -0
  127. package/dist/inspect-573WHEV4.js.map +1 -0
  128. package/dist/install-SQAYMNQC.js +1134 -0
  129. package/dist/install-SQAYMNQC.js.map +1 -0
  130. package/dist/{mine.wasm-GQECMSGN.js → mine.wasm-6PIT3DK6.js} +2 -2
  131. package/dist/outcome-W3KYGF23.js +22 -0
  132. package/dist/outcome-W3KYGF23.js.map +1 -0
  133. package/dist/publish-N5U4XYVA.js +40 -0
  134. package/dist/publish-N5U4XYVA.js.map +1 -0
  135. package/dist/read-PJ7Z6UGF.js +158 -0
  136. package/dist/read-PJ7Z6UGF.js.map +1 -0
  137. package/dist/run-FSO3MMXN.js +16883 -0
  138. package/dist/run-FSO3MMXN.js.map +1 -0
  139. package/dist/search-ZWOP4EGK.js +23 -0
  140. package/dist/search-ZWOP4EGK.js.map +1 -0
  141. package/dist/{secp256k1-BEZS642W.js → secp256k1-XRPVBC6V.js} +5 -4
  142. package/dist/secp256k1-XRPVBC6V.js.map +1 -0
  143. package/dist/send-F34ZDXDZ.js +223 -0
  144. package/dist/send-F34ZDXDZ.js.map +1 -0
  145. package/dist/session-4N4ZT3AH.js +88 -0
  146. package/dist/session-4N4ZT3AH.js.map +1 -0
  147. package/dist/skill-heal-XBEK272G.js +85 -0
  148. package/dist/skill-heal-XBEK272G.js.map +1 -0
  149. package/dist/uninstall-BTKPHPDL.js +68 -0
  150. package/dist/uninstall-BTKPHPDL.js.map +1 -0
  151. package/dist/usdc-4VCDHFWX.js +38 -0
  152. package/dist/usdc-4VCDHFWX.js.map +1 -0
  153. package/dist/viemAdapter-By13KInL-TUQJBMHM.js +14 -0
  154. package/dist/viemAdapter-By13KInL-TUQJBMHM.js.map +1 -0
  155. package/dist/wallet-UL4P2JRO.js +42 -0
  156. package/dist/wallet-UL4P2JRO.js.map +1 -0
  157. package/dist/wallet-WJ6UP5OU.js +32 -0
  158. package/dist/wallet-WJ6UP5OU.js.map +1 -0
  159. package/docs/agent-permissions.md +294 -0
  160. package/package.json +25 -18
  161. package/skills/tenjin/SKILL.md +364 -0
  162. package/skills/tenjin-publish/SKILL.md +232 -0
  163. package/skills/tenjin-search/SKILL.md +341 -0
  164. package/dist/chunk-BRJHUQSY.js.map +0 -1
  165. package/dist/chunk-CUWUHTIL.js.map +0 -1
  166. package/dist/chunk-DXPYFVKG.js.map +0 -1
  167. package/dist/chunk-EXBMF5X7.js.map +0 -1
  168. package/dist/chunk-EZROUI5U.js +0 -135
  169. package/dist/chunk-EZROUI5U.js.map +0 -1
  170. package/dist/chunk-IPOWB3G3.js.map +0 -1
  171. package/dist/chunk-LPRVHM7P.js.map +0 -1
  172. package/dist/chunk-T4LKNY7T.js.map +0 -1
  173. package/dist/chunk-YBMMV4Y4.js +0 -51
  174. package/dist/chunk-YBMMV4Y4.js.map +0 -1
  175. package/dist/chunk-YG2DO46P.js.map +0 -1
  176. package/dist/chunk-ZPZFPVDN.js +0 -67
  177. package/dist/chunk-ZPZFPVDN.js.map +0 -1
  178. package/dist/cli-WA65NP4Y.js.map +0 -1
  179. package/dist/config-CEFTL5ZL.js +0 -164
  180. package/dist/config-CEFTL5ZL.js.map +0 -1
  181. package/dist/doctor-3QBYN46N.js +0 -338
  182. package/dist/doctor-3QBYN46N.js.map +0 -1
  183. package/dist/usdc-44R6XZF2.js +0 -18
  184. package/dist/wallet-ELBTBMXO.js +0 -20
  185. package/dist/wallet-XD576HF3.js +0 -173
  186. package/dist/wallet-XD576HF3.js.map +0 -1
  187. /package/dist/{_esm-ZH2J4QEH.js.map → _esm-C5CRWCYU.js.map} +0 -0
  188. /package/dist/{ccip-UCLT5VOW.js.map → _esm-N4KAVXQR.js.map} +0 -0
  189. /package/dist/{chunk-3IMLRUZE.js.map → buy-THMVOPUH.js.map} +0 -0
  190. /package/dist/{secp256k1-BEZS642W.js.map → ccip-RPPPKTJR.js.map} +0 -0
  191. /package/dist/{usdc-44R6XZF2.js.map → ccip-ZGGWQN4X.js.map} +0 -0
  192. /package/dist/{wallet-ELBTBMXO.js.map → chunk-ZXTAQYNA.js.map} +0 -0
  193. /package/dist/{mine.wasm-GQECMSGN.js.map → mine.wasm-6PIT3DK6.js.map} +0 -0
@@ -0,0 +1,14 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ a,
4
+ s
5
+ } from "./chunk-S5RYMCV6.js";
6
+ import "./chunk-YLYINX2H.js";
7
+ import "./chunk-XJN5WUKL.js";
8
+ import "./chunk-KYQVEKP5.js";
9
+ import "./chunk-ZXTAQYNA.js";
10
+ export {
11
+ a as n,
12
+ s as t
13
+ };
14
+ //# sourceMappingURL=viemAdapter-By13KInL-TUQJBMHM.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,42 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ commitLocalWallet,
4
+ createLocalSpendAuthorizer,
5
+ createLocalWallet,
6
+ describeWallet,
7
+ parkOutgoingWallet,
8
+ prepareLocalWallet,
9
+ resolveSpendAuthorizer,
10
+ resolveWalletProvider,
11
+ restoreParkedWallet,
12
+ verifyAndPreserveOutgoingWallet,
13
+ verifyLocalWallet
14
+ } from "./chunk-CNUXRXI2.js";
15
+ import "./chunk-Y7ERTA7D.js";
16
+ import "./chunk-IB63U6BM.js";
17
+ import "./chunk-FKSAUOJU.js";
18
+ import "./chunk-ZQIQ55KK.js";
19
+ import "./chunk-2I4QTOLB.js";
20
+ import "./chunk-PZRAAAY2.js";
21
+ import "./chunk-M2O56UK7.js";
22
+ import "./chunk-UHTVXQ2O.js";
23
+ import "./chunk-W6R3HAAG.js";
24
+ import "./chunk-47PP7TAG.js";
25
+ import "./chunk-XJN5WUKL.js";
26
+ import "./chunk-RBJPAZFI.js";
27
+ import "./chunk-KYQVEKP5.js";
28
+ import "./chunk-ZXTAQYNA.js";
29
+ export {
30
+ commitLocalWallet,
31
+ createLocalSpendAuthorizer,
32
+ createLocalWallet,
33
+ describeWallet,
34
+ parkOutgoingWallet,
35
+ prepareLocalWallet,
36
+ resolveSpendAuthorizer,
37
+ resolveWalletProvider,
38
+ restoreParkedWallet,
39
+ verifyAndPreserveOutgoingWallet,
40
+ verifyLocalWallet
41
+ };
42
+ //# sourceMappingURL=wallet-UL4P2JRO.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,32 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ runWalletBalance,
4
+ runWalletCreate,
5
+ runWalletShow
6
+ } from "./chunk-UFPJBS4C.js";
7
+ import "./chunk-MJZZTKCC.js";
8
+ import "./chunk-CNUXRXI2.js";
9
+ import "./chunk-Y7ERTA7D.js";
10
+ import "./chunk-IB63U6BM.js";
11
+ import "./chunk-FKSAUOJU.js";
12
+ import "./chunk-ALUNME53.js";
13
+ import "./chunk-ZQIQ55KK.js";
14
+ import "./chunk-P74I3WH4.js";
15
+ import "./chunk-2I4QTOLB.js";
16
+ import "./chunk-PZRAAAY2.js";
17
+ import "./chunk-7FK2UN2T.js";
18
+ import "./chunk-M2O56UK7.js";
19
+ import "./chunk-UHTVXQ2O.js";
20
+ import "./chunk-W6R3HAAG.js";
21
+ import "./chunk-U5S527PP.js";
22
+ import "./chunk-47PP7TAG.js";
23
+ import "./chunk-XJN5WUKL.js";
24
+ import "./chunk-RBJPAZFI.js";
25
+ import "./chunk-KYQVEKP5.js";
26
+ import "./chunk-ZXTAQYNA.js";
27
+ export {
28
+ runWalletBalance,
29
+ runWalletCreate,
30
+ runWalletShow
31
+ };
32
+ //# sourceMappingURL=wallet-WJ6UP5OU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,294 @@
1
+ # Agent permissions
2
+
3
+ Coding harnesses running unattended ("auto mode", "full auto", YOLO) classify each
4
+ shell command before running it, and an unknown binary is denied by default. That
5
+ denies the free verbs too, which breaks the whole marketplace loop: the skills
6
+ forbid working around a denial, so a denied `tenjin search` just stops.
7
+
8
+ Pre-clearing the free verbs once fixes that. This page is the full reasoning
9
+ behind which verbs are on that list, which two are separate opt-ins, and which are
10
+ never recommended at all, and it is where `tenjin install` and `tenjin doctor`
11
+ send you. The [README](../README.md#auto-mode-permission-allowlist) carries the
12
+ paste block and the three-tier summary.
13
+
14
+ ## The free tier
15
+
16
+ The free tier is nine rules for the `permissions.allow` array of Claude Code's
17
+ `~/.claude/settings.json`. `tenjin install` can write them for you; see
18
+ [Getting the rules onto your machine](#getting-the-rules-onto-your-machine).
19
+
20
+ ```
21
+ Bash(tenjin search:*)
22
+ Bash(tenjin fund:*)
23
+ Bash(tenjin inspect:*)
24
+ Bash(tenjin read:*)
25
+ Bash(tenjin outcome:*)
26
+ Bash(tenjin doctor:*)
27
+ Bash(tenjin wallet show:*)
28
+ Bash(tenjin wallet balance:*)
29
+ Bash(tenjin config get:*)
30
+ ```
31
+
32
+ None of those can spend, and none can move your keys; `tenjin doctor` decrypts
33
+ locally to check your wallet still opens. That is the definition of
34
+ this tier, and it is deliberately narrower than "signs nothing": `tenjin read` can
35
+ present a session key that already exists, which is a signature — a P-256
36
+ delegation, the wrong curve to authorize a USDC transfer. It cannot mint one; that
37
+ needs the wallet.
38
+
39
+ ### What each verb actually does
40
+
41
+ | Rule | Why it is safe to pre-clear |
42
+ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
43
+ | `Bash(tenjin search:*)` | Free anonymous marketplace search. No wallet, no signing, no payment. POSTs the generalized question off-machine. |
44
+ | `Bash(tenjin fund:*)` | Owner call (2026-08-12): mints a card-funding checkout link for THIS wallet only; moves no money, origin-pinned (no `--base-url`). |
45
+ | `Bash(tenjin inspect:*)` | Free pre-purchase card and preview. Never signs, never pays, never saves. |
46
+ | `Bash(tenjin read:*)` | Free-only delivery. Cannot spend and cannot open the keystore, but transmits a cached session key when one exists (see below). |
47
+ | `Bash(tenjin outcome:*)` | Free honest outcome report on a past search. No wallet, no payment. POSTs a report that moves the marketplace's reuse signal. |
48
+ | `Bash(tenjin doctor:*)` | Local environment and API reachability diagnostics; decrypts the wallet locally to check it still opens. |
49
+ | `Bash(tenjin wallet show:*)` | Prints the wallet address and key source. Never prints the key. |
50
+ | `Bash(tenjin wallet balance:*)` | Read-only USDC balance query on Base. |
51
+ | `Bash(tenjin config get:*)` | Reads one effective config value. Note `config get rpcUrl` returns a URL that commonly embeds a provider API key. |
52
+
53
+ `tenjin doctor --json` emits the same per-verb notes under `permissions`, so an
54
+ agent can read them without this page.
55
+
56
+ ### Three free verbs are not read-only
57
+
58
+ Worth knowing before you pre-clear them: `tenjin search` POSTs your generalized
59
+ question off-machine, and `tenjin outcome` POSTs a report that moves the
60
+ marketplace's reuse signal — both unauthenticated and free, neither carrying a
61
+ credential — while `tenjin read` writes locally, saving a delivered piece to your
62
+ library.
63
+
64
+ ### `read` transmits a credential once a session key exists
65
+
66
+ Worth knowing before you paste the `read` line: once a session key exists, `read`
67
+ **transmits that wallet-derived credential** to the origin it was minted for. That
68
+ origin binding is what keeps a stray `--base-url` from redirecting it, and it is
69
+ the reason the binding exists rather than a nicety.
70
+
71
+ `read` itself can never mint one: it imports no wallet, payment, or
72
+ session-minting module, and its import graph is test-pinned to stay clear of all
73
+ three. It cannot unlock a keystore and never consults the spend policy.
74
+
75
+ ## Getting the rules onto your machine
76
+
77
+ `tenjin install` writes the nine rules into `~/.claude/settings.json` for you. It
78
+ is one of the four setup decisions, and at a terminal it asks:
79
+
80
+ > Let your agent search tenjin without permission popups? Adds 9 free commands to
81
+ > `~/.claude/settings.json`. None can spend USDC or move your keys; doctor may
82
+ > check your wallet still opens. Three send or store data (search, outcome,
83
+ > read). Full caveats:
84
+ > https://github.com/BackTrackCo/tenjin-agent/blob/main/docs/agent-permissions.md
85
+
86
+ Answer yes and it merges them in. The write is additive only: it appends the rules
87
+ that are missing and never removes, reorders, or rewrites an existing entry or any
88
+ other key in the file, so a re-run adds nothing. A settings file it cannot parse is
89
+ reported and left exactly as it is, never repaired. The rules it may write are a
90
+ fixed constant, so no flag or config value can widen it to `buy`, `publish`,
91
+ `session start`, or a blanket `Bash(tenjin:*)`.
92
+
93
+ A non-interactive install (piped, or under `--json`) does the same write BY
94
+ DEFAULT, with no flag: the machine most likely to be denied mid-task is the
95
+ headless one, and there is nobody there to answer. `--no-allow-free-verbs` opts
96
+ out; `--allow-free-verbs` states the default explicitly. Every run that writes
97
+ reports how many rules landed, in which file, and that deleting those lines undoes
98
+ it.
99
+
100
+ `tenjin doctor --json` carries this whole recommendation as data under
101
+ `permissions` — every rule, every per-verb note, both caveats, on the failure
102
+ envelope as well as the success one — so an agent that just got denied can point
103
+ you at the exact line. Its human render is the check list plus one link back
104
+ here.
105
+
106
+ ## A prefix rule pins the verb, not the flags
107
+
108
+ Every line above also clears `--base-url <url>` on that verb, because the CLI
109
+ accepts the global flags on every subcommand. `--base-url` is validated as a URL
110
+ and nothing more, and it wins settings precedence, so it moves where the question
111
+ goes, where `doctor` probes, and (with the `buy` line below) where a SIWX signature
112
+ and an EIP-3009 payment authorization are sent. The origin pin only checks that a
113
+ resource URL shares an origin with the _configured_ base, so an attacker-controlled
114
+ pair satisfies it.
115
+
116
+ There is no prefix syntax for "this verb but not that flag", so treat this as a
117
+ disclosed limit: set your base URL in config, and allowlist these verbs only if you
118
+ are content for an agent to be able to choose the destination host. The skills tell
119
+ agents never to pass `--base-url` on an allowlisted verb, but that is a convention
120
+ rather than an enforced boundary.
121
+
122
+ ## Opt-in: purchases
123
+
124
+ Purchases are a **separate, explicit opt-in**:
125
+
126
+ ```
127
+ Bash(tenjin buy:*)
128
+ ```
129
+
130
+ Read this before pasting it: **on the default config that line authorizes
131
+ unattended spending up to your wallet balance.** `--yes` is an ordinary flag on the
132
+ same allowlisted verb and it clears the confirm gate outright, so `confirm: always`
133
+ does not put a human on every purchase once the agent can pass `--yes`.
134
+
135
+ Walking the defaults:
136
+
137
+ - `allowlistCreators` is empty, so the creator gate is off.
138
+ - `maxAutoSpend` is `0` and `confirm` is `always`, which together only ask for a
139
+ confirmation that `--yes` satisfies.
140
+ - `sessionBudget` is `0`, which the policy reads as **no ceiling at all**, not a
141
+ zero one.
142
+
143
+ Set real values first:
144
+
145
+ ```bash
146
+ tenjin config set maxAutoSpend 0.25
147
+ tenjin config set sessionBudget 2.00
148
+ ```
149
+
150
+ The allowlist line itself never raises a spend cap. That is true, and it is not the
151
+ same as saying the caps stop an allowlisted `buy`.
152
+
153
+ ## Opt-in: minting a session key
154
+
155
+ Minting a session key is the **other** explicit opt-in. It spends nothing and
156
+ cannot spend, but it opens the keystore:
157
+
158
+ ```
159
+ Bash(tenjin session start:*)
160
+ ```
161
+
162
+ `tenjin session start --scope read` takes one wallet signature and leaves a ≤24h
163
+ P-256 delegation in `~/.tenjin/session.json` (0600), which `tenjin read` then
164
+ presents to recover pieces you already own. The key is the wrong curve to sign an
165
+ EIP-3009 payment authorization, so the line can never become a spend grant.
166
+
167
+ ### The `read` scope is not a containment boundary
168
+
169
+ Do not read the `read` scope as more than a scope. It is enforced only on the
170
+ request shape that carries a session signature alongside the delegation header; a
171
+ copy of the same delegation presented differently is not scope-checked, so treat
172
+ the file as a credential carrying your wallet's authority. Its real bounds are the
173
+ 24h expiry, the 0600 mode, and the origin binding.
174
+
175
+ ### What you are actually clearing
176
+
177
+ **Unattended keystore access.** On an encrypted wallet the passphrase comes from
178
+ the environment rather than from you, and the `--base-url` caveat above bites
179
+ hardest here, because a mint against a host an agent chose is a wallet signature
180
+ you did not intend to make. `tenjin doctor` reports whether a session exists, for
181
+ which origin, at what scope, and when it expires.
182
+
183
+ ## Never recommended
184
+
185
+ Deliberately **never** recommended, because each is a human decision:
186
+
187
+ | Verb | Why it stays a human decision |
188
+ | ---------------------- | ------------------------------------------------------------------------------------ |
189
+ | `tenjin send` | Moves USDC out of the wallet, and is not bounded by the buy spend policy. See below. |
190
+ | `tenjin publish` | Puts your content on a public marketplace under your identity. |
191
+ | `tenjin edit` | Edits live posts and prices; a prefix rule cannot clear its read half only. |
192
+ | `tenjin wallet create` | Creates the payment credential. |
193
+ | `tenjin config set` | It can widen the agent's own spend policy. |
194
+ | `tenjin install` | Writes into harness config and skills directories. |
195
+ | `tenjin mcp` | It re-exposes every command core, so clearing it clears everything. |
196
+
197
+ For the same reason, prefer the narrow rules above over a broad `Bash(tenjin:*)`,
198
+ `Bash(tenjin wallet:*)`, or `Bash(tenjin config:*)`, which would swallow them.
199
+
200
+ ### `tenjin fund`, free on both surfaces
201
+
202
+ Free by owner decision (2026-08-12), because on either surface the command just
203
+ opens the fund modal. Minting a checkout link moves no money: the destination is
204
+ pinned server-side to the wallet that signed the request, so a link an agent
205
+ mints can only ever fund your own wallet, the CLI refuses any checkout host but
206
+ `pay.coinbase.com`, and the payment itself happens behind Coinbase's own human
207
+ gate. The `--base-url` caveat that qualifies every other prefix rule does not
208
+ apply here: `fund` is pinned to the production origin and takes no override from
209
+ the flag, the environment, or config, so an allowlisted invocation cannot steer
210
+ where the wallet's SIWX proof goes. That pin is what separates `fund` from
211
+ `session start` (unattended keystore access, override surface intact), which
212
+ stays opt-in.
213
+
214
+ ### `tenjin send`, the escape hatch
215
+
216
+ `send` is human-invoked only: it is deliberately absent from the MCP toolset and
217
+ the harness skills, and nothing is signed until the previewed (checksummed)
218
+ recipient, amount, and network fee are confirmed, interactively at a TTY or
219
+ explicitly with `--yes` when headless. It refuses when the active wallet's
220
+ passphrase entry is missing. The `sendMaxAmount` hard per-send cap has no
221
+ default: `tenjin send` refuses until you run `tenjin config set sendMaxAmount
222
+ <usd|0|none>` (`0` disables the verb, `none` opts in to uncapped), and `--yes`
223
+ can never bypass the cap or the unset refusal. For routing FUTURE revenue away
224
+ from the agent wallet entirely, connect the agent to your own Tenjin account
225
+ instead (delegation); `send` exists for funds already sitting on the agent key.
226
+
227
+ ## Wallet passphrase storage
228
+
229
+ The signing passphrase resolves in order: `TENJIN_WALLET_PASSPHRASE`, then the
230
+ OS credential store, then an interactive prompt. On `wallet create` with no env
231
+ passphrase, a strong random one is generated and saved to the OS store so later
232
+ signing is transparent. Every stored entry is **per wallet**, keyed by the
233
+ wallet's own address, so replacing a wallet never touches the outgoing wallet's
234
+ passphrase. Installs from before per-wallet entries used one shared slot; the
235
+ first signing that proves ownership re-keys that slot under the owning wallet's
236
+ address, and the copy is verified before the old slot is removed.
237
+
238
+ Where entries land per platform:
239
+
240
+ - **macOS**: the login keychain, via the OS `security` tool (the same mechanism
241
+ the GitHub CLI uses): service `tenjin-cli`, account = the wallet address.
242
+ - **Windows**: a DPAPI-encrypted file per wallet (`passphrase.<address>.dpapi`),
243
+ decryptable only by the same user on the same machine, via built-in
244
+ PowerShell. The file holds ciphertext, not the passphrase.
245
+ - **Desktop Linux**: the Secret Service keyring, via `secret-tool` when
246
+ libsecret-tools is installed: service `tenjin-cli`, account = the wallet
247
+ address.
248
+ - **Headless or CI (any OS)**: no durable OS store, so set
249
+ `TENJIN_WALLET_PASSPHRASE`.
250
+
251
+ The passphrase reaches these tools over stdin, never on a command line, and the
252
+ key never leaves the machine.
253
+
254
+ ## Two gaps, both fail-closed
255
+
256
+ Both are denied, never wrongly allowed:
257
+
258
+ - Bare `tenjin config` is as read-only as `config get`, but no prefix rule reaches
259
+ it without also covering `config set`, so use `tenjin config get <key>`.
260
+ - Group-level flag forms like `tenjin wallet --json show` are not covered, so put
261
+ global flags after the leaf verb (`tenjin wallet show --json`).
262
+
263
+ ## Delegating to a subagent
264
+
265
+ The free tier is the answer to "what may a read-only subagent run", with nothing
266
+ subtracted. All nine are safe to hand over: `search`, `fund`, `inspect`, `read`,
267
+ `outcome`, `doctor`, `config get`, `wallet show`, `wallet balance`.
268
+ None can spend and none can move your keys; `fund` mints a checkout link only a
269
+ human can pay.
270
+
271
+ Everything that mutates stays in a mutation-capable, human-gated context:
272
+ `publish`, `edit`, `buy`, `send`,
273
+ `session start`, `wallet create`, `config set`, `install`. In particular, do not
274
+ delegate publishing what a subagent just derived: bring the finding back and
275
+ publish it from the context that can ask the user.
276
+
277
+ Two caveats travel with the safe set. "Read-only" describes your wallet and your
278
+ repo, not the network: `search` and `outcome` POST off-machine (a question, a
279
+ report) and `read` saves to the local library. And a delegated context is where a stray `--base-url` does the most
280
+ damage, so never pass one.
281
+
282
+ ## Running the local MCP server instead?
283
+
284
+ That is a different permission surface: the harness gates tools there, and these
285
+ Bash rules do not apply. If you follow the
286
+ [MCP section](../README.md#local-stdio-mcp-server) as well, leave
287
+ `mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`, and
288
+ `mcp__tenjin__tenjin_wallet` gated, and treat `mcp__tenjin__tenjin_buy` as the
289
+ same opt-in decision as the `buy` line above.
290
+
291
+ ## Not the same as `allowlistCreators`
292
+
293
+ This harness allowlist is unrelated to the `allowlistCreators` spend-policy key:
294
+ that one gates **who you may pay**, this one gates **which commands may run**.
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "tenjin-cli",
3
- "version": "0.1.0-alpha.1",
3
+ "version": "0.1.0-alpha.11",
4
+ "mcpName": "blog.tenjin/tenjin",
4
5
  "type": "module",
5
6
  "description": "Tenjin agent CLI for the x402 knowledge marketplace.",
6
7
  "license": "MIT",
@@ -31,27 +32,21 @@
31
32
  },
32
33
  "files": [
33
34
  "dist",
35
+ "docs",
36
+ "skills",
34
37
  "NOTICE.md"
35
38
  ],
36
- "packageManager": "pnpm@11.11.0",
37
- "scripts": {
38
- "build": "tsup",
39
- "test": "vitest run",
40
- "typecheck": "tsc --noEmit",
41
- "lint": "eslint .",
42
- "format": "prettier --write .",
43
- "format:check": "prettier --check .",
44
- "check": "pnpm run build && pnpm run test",
45
- "sync:skill": "node scripts/sync-skill.mjs",
46
- "pack-smoke": "bash scripts/pack-smoke.sh",
47
- "prepare": "git config core.hooksPath .githooks || true"
48
- },
49
- "dependencies": {},
50
39
  "devDependencies": {
51
- "@eslint/js": "^9",
40
+ "@changesets/cli": "^2.31.1",
41
+ "@clack/prompts": "^1.7.0",
42
+ "@eslint/js": "^10",
43
+ "@modelcontextprotocol/sdk": "1.29.0",
52
44
  "@types/node": "^25",
45
+ "@x402/core": "2.17.0",
46
+ "@x402/evm": "2.17.0",
47
+ "@x402/extensions": "2.17.0",
53
48
  "commander": "^14.0.1",
54
- "eslint": "^9",
49
+ "eslint": "^10",
55
50
  "eslint-config-prettier": "^10",
56
51
  "ox": "0.14.30",
57
52
  "prettier": "^3",
@@ -61,5 +56,17 @@
61
56
  "viem": "^2.53.1",
62
57
  "vitest": "^4.1.9",
63
58
  "zod": "^4.4.3"
59
+ },
60
+ "scripts": {
61
+ "build": "tsup",
62
+ "test": "vitest run",
63
+ "typecheck": "tsc --noEmit",
64
+ "lint": "eslint .",
65
+ "format": "prettier --write .",
66
+ "format:check": "prettier --check .",
67
+ "check": "pnpm run build && pnpm run test",
68
+ "sync:skill": "node scripts/sync-skill.mjs",
69
+ "pack-smoke": "bash scripts/pack-smoke.sh",
70
+ "changeset": "changeset"
64
71
  }
65
- }
72
+ }