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.
- package/NOTICE.md +33 -0
- package/README.md +596 -79
- package/dist/{_esm-ZH2J4QEH.js → _esm-C5CRWCYU.js} +2 -2
- package/dist/_esm-N4KAVXQR.js +881 -0
- package/dist/buy-THMVOPUH.js +44 -0
- package/dist/ccip-RPPPKTJR.js +19 -0
- package/dist/{ccip-UCLT5VOW.js → ccip-ZGGWQN4X.js} +6 -5
- package/dist/chunk-2I4QTOLB.js +11 -0
- package/dist/chunk-2I4QTOLB.js.map +1 -0
- package/dist/chunk-2SDUV6MQ.js +352 -0
- package/dist/chunk-2SDUV6MQ.js.map +1 -0
- package/dist/chunk-3GSZUADW.js +199 -0
- package/dist/chunk-3GSZUADW.js.map +1 -0
- package/dist/{chunk-BRJHUQSY.js → chunk-47PP7TAG.js} +908 -812
- package/dist/chunk-47PP7TAG.js.map +1 -0
- package/dist/chunk-4NTZETIL.js +158 -0
- package/dist/chunk-4NTZETIL.js.map +1 -0
- package/dist/chunk-4TCU3YRD.js +130 -0
- package/dist/chunk-4TCU3YRD.js.map +1 -0
- package/dist/chunk-6BGYHARE.js +14620 -0
- package/dist/chunk-6BGYHARE.js.map +1 -0
- package/dist/chunk-6UY2UQMY.js +213 -0
- package/dist/chunk-6UY2UQMY.js.map +1 -0
- package/dist/{chunk-IPOWB3G3.js → chunk-7FK2UN2T.js} +3515 -507
- package/dist/chunk-7FK2UN2T.js.map +1 -0
- package/dist/chunk-ALUNME53.js +306 -0
- package/dist/chunk-ALUNME53.js.map +1 -0
- package/dist/{chunk-EXBMF5X7.js → chunk-CNUXRXI2.js} +526 -79
- package/dist/chunk-CNUXRXI2.js.map +1 -0
- package/dist/chunk-E6YOODH7.js +913 -0
- package/dist/chunk-E6YOODH7.js.map +1 -0
- package/dist/chunk-EDVI7RRD.js +317 -0
- package/dist/chunk-EDVI7RRD.js.map +1 -0
- package/dist/chunk-FKSAUOJU.js +137 -0
- package/dist/chunk-FKSAUOJU.js.map +1 -0
- package/dist/chunk-GKV6VZSZ.js +125 -0
- package/dist/chunk-GKV6VZSZ.js.map +1 -0
- package/dist/chunk-GUUAYR3K.js +175 -0
- package/dist/chunk-GUUAYR3K.js.map +1 -0
- package/dist/chunk-IAFYUFIC.js +1408 -0
- package/dist/chunk-IAFYUFIC.js.map +1 -0
- package/dist/chunk-IB63U6BM.js +185 -0
- package/dist/chunk-IB63U6BM.js.map +1 -0
- package/dist/chunk-IXTENA2H.js +235 -0
- package/dist/chunk-IXTENA2H.js.map +1 -0
- package/dist/chunk-JTYIX6OD.js +161 -0
- package/dist/chunk-JTYIX6OD.js.map +1 -0
- package/dist/chunk-KYQVEKP5.js +209 -0
- package/dist/chunk-KYQVEKP5.js.map +1 -0
- package/dist/chunk-KZAAWQNP.js +6199 -0
- package/dist/chunk-KZAAWQNP.js.map +1 -0
- package/dist/{chunk-T4LKNY7T.js → chunk-M2O56UK7.js} +225 -70
- package/dist/chunk-M2O56UK7.js.map +1 -0
- package/dist/chunk-MJZZTKCC.js +323 -0
- package/dist/chunk-MJZZTKCC.js.map +1 -0
- package/dist/chunk-NUF2PKJO.js +207 -0
- package/dist/chunk-NUF2PKJO.js.map +1 -0
- package/dist/chunk-O25VWJCG.js +1357 -0
- package/dist/chunk-O25VWJCG.js.map +1 -0
- package/dist/chunk-OCN27NJV.js +612 -0
- package/dist/chunk-OCN27NJV.js.map +1 -0
- package/dist/chunk-OZHJ3FLR.js +105 -0
- package/dist/chunk-OZHJ3FLR.js.map +1 -0
- package/dist/chunk-P74I3WH4.js +204 -0
- package/dist/chunk-P74I3WH4.js.map +1 -0
- package/dist/chunk-POJRB2AE.js +83 -0
- package/dist/chunk-POJRB2AE.js.map +1 -0
- package/dist/{chunk-YG2DO46P.js → chunk-PZRAAAY2.js} +107 -22
- package/dist/chunk-PZRAAAY2.js.map +1 -0
- package/dist/chunk-PZSUWDF2.js +35 -0
- package/dist/chunk-PZSUWDF2.js.map +1 -0
- package/dist/chunk-QW2Q2KAH.js +27 -0
- package/dist/chunk-QW2Q2KAH.js.map +1 -0
- package/dist/{chunk-CUWUHTIL.js → chunk-RBJPAZFI.js} +16 -202
- package/dist/chunk-RBJPAZFI.js.map +1 -0
- package/dist/chunk-RSBN67PA.js +152 -0
- package/dist/chunk-RSBN67PA.js.map +1 -0
- package/dist/chunk-S5RYMCV6.js +70 -0
- package/dist/chunk-S5RYMCV6.js.map +1 -0
- package/dist/chunk-SFGXAZ3M.js +316 -0
- package/dist/chunk-SFGXAZ3M.js.map +1 -0
- package/dist/chunk-SGK2B724.js +67 -0
- package/dist/chunk-SGK2B724.js.map +1 -0
- package/dist/chunk-TDDN5GXR.js +145 -0
- package/dist/chunk-TDDN5GXR.js.map +1 -0
- package/dist/{chunk-LPRVHM7P.js → chunk-U5S527PP.js} +1655 -114
- package/dist/chunk-U5S527PP.js.map +1 -0
- package/dist/chunk-UFPJBS4C.js +242 -0
- package/dist/chunk-UFPJBS4C.js.map +1 -0
- package/dist/chunk-UHTVXQ2O.js +140 -0
- package/dist/chunk-UHTVXQ2O.js.map +1 -0
- package/dist/chunk-UY6CGULW.js +83 -0
- package/dist/chunk-UY6CGULW.js.map +1 -0
- package/dist/chunk-VWY3U732.js +674 -0
- package/dist/chunk-VWY3U732.js.map +1 -0
- package/dist/{chunk-Q53IYV2G.js → chunk-W6R3HAAG.js} +20 -17
- package/dist/{chunk-Q53IYV2G.js.map → chunk-W6R3HAAG.js.map} +1 -1
- package/dist/chunk-XJN5WUKL.js +204 -0
- package/dist/chunk-XJN5WUKL.js.map +1 -0
- package/dist/chunk-XWHXX2BI.js +149 -0
- package/dist/chunk-XWHXX2BI.js.map +1 -0
- package/dist/{chunk-DXPYFVKG.js → chunk-Y7ERTA7D.js} +35 -15
- package/dist/chunk-Y7ERTA7D.js.map +1 -0
- package/dist/chunk-YLYINX2H.js +7806 -0
- package/dist/chunk-YLYINX2H.js.map +1 -0
- package/dist/chunk-ZE7KOO7A.js +233 -0
- package/dist/chunk-ZE7KOO7A.js.map +1 -0
- package/dist/chunk-ZQIQ55KK.js +51 -0
- package/dist/chunk-ZQIQ55KK.js.map +1 -0
- package/dist/{chunk-3IMLRUZE.js → chunk-ZXTAQYNA.js} +6 -2
- package/dist/{cli-WA65NP4Y.js → cli-Y2HBOSGK.js} +437 -175
- package/dist/cli-Y2HBOSGK.js.map +1 -0
- package/dist/config-WDGMZKHU.js +26 -0
- package/dist/config-WDGMZKHU.js.map +1 -0
- package/dist/dist-U4M6QCKE.js +2842 -0
- package/dist/dist-U4M6QCKE.js.map +1 -0
- package/dist/doctor-CSIWKWM2.js +27 -0
- package/dist/doctor-CSIWKWM2.js.map +1 -0
- package/dist/edit-E7N6F3OY.js +38 -0
- package/dist/edit-E7N6F3OY.js.map +1 -0
- package/dist/ethersCompat-Df4a6QIZ-WHYKB6HA.js +18 -0
- package/dist/ethersCompat-Df4a6QIZ-WHYKB6HA.js.map +1 -0
- package/dist/fund-OKK627GL.js +38 -0
- package/dist/fund-OKK627GL.js.map +1 -0
- package/dist/index.js +1 -1
- package/dist/inspect-573WHEV4.js +35 -0
- package/dist/inspect-573WHEV4.js.map +1 -0
- package/dist/install-SQAYMNQC.js +1134 -0
- package/dist/install-SQAYMNQC.js.map +1 -0
- package/dist/{mine.wasm-GQECMSGN.js → mine.wasm-6PIT3DK6.js} +2 -2
- package/dist/outcome-W3KYGF23.js +22 -0
- package/dist/outcome-W3KYGF23.js.map +1 -0
- package/dist/publish-N5U4XYVA.js +40 -0
- package/dist/publish-N5U4XYVA.js.map +1 -0
- package/dist/read-PJ7Z6UGF.js +158 -0
- package/dist/read-PJ7Z6UGF.js.map +1 -0
- package/dist/run-FSO3MMXN.js +16883 -0
- package/dist/run-FSO3MMXN.js.map +1 -0
- package/dist/search-ZWOP4EGK.js +23 -0
- package/dist/search-ZWOP4EGK.js.map +1 -0
- package/dist/{secp256k1-BEZS642W.js → secp256k1-XRPVBC6V.js} +5 -4
- package/dist/secp256k1-XRPVBC6V.js.map +1 -0
- package/dist/send-F34ZDXDZ.js +223 -0
- package/dist/send-F34ZDXDZ.js.map +1 -0
- package/dist/session-4N4ZT3AH.js +88 -0
- package/dist/session-4N4ZT3AH.js.map +1 -0
- package/dist/skill-heal-XBEK272G.js +85 -0
- package/dist/skill-heal-XBEK272G.js.map +1 -0
- package/dist/uninstall-BTKPHPDL.js +68 -0
- package/dist/uninstall-BTKPHPDL.js.map +1 -0
- package/dist/usdc-4VCDHFWX.js +38 -0
- package/dist/usdc-4VCDHFWX.js.map +1 -0
- package/dist/viemAdapter-By13KInL-TUQJBMHM.js +14 -0
- package/dist/viemAdapter-By13KInL-TUQJBMHM.js.map +1 -0
- package/dist/wallet-UL4P2JRO.js +42 -0
- package/dist/wallet-UL4P2JRO.js.map +1 -0
- package/dist/wallet-WJ6UP5OU.js +32 -0
- package/dist/wallet-WJ6UP5OU.js.map +1 -0
- package/docs/agent-permissions.md +294 -0
- package/package.json +25 -18
- package/skills/tenjin/SKILL.md +364 -0
- package/skills/tenjin-publish/SKILL.md +232 -0
- package/skills/tenjin-search/SKILL.md +341 -0
- package/dist/chunk-BRJHUQSY.js.map +0 -1
- package/dist/chunk-CUWUHTIL.js.map +0 -1
- package/dist/chunk-DXPYFVKG.js.map +0 -1
- package/dist/chunk-EXBMF5X7.js.map +0 -1
- package/dist/chunk-EZROUI5U.js +0 -135
- package/dist/chunk-EZROUI5U.js.map +0 -1
- package/dist/chunk-IPOWB3G3.js.map +0 -1
- package/dist/chunk-LPRVHM7P.js.map +0 -1
- package/dist/chunk-T4LKNY7T.js.map +0 -1
- package/dist/chunk-YBMMV4Y4.js +0 -51
- package/dist/chunk-YBMMV4Y4.js.map +0 -1
- package/dist/chunk-YG2DO46P.js.map +0 -1
- package/dist/chunk-ZPZFPVDN.js +0 -67
- package/dist/chunk-ZPZFPVDN.js.map +0 -1
- package/dist/cli-WA65NP4Y.js.map +0 -1
- package/dist/config-CEFTL5ZL.js +0 -164
- package/dist/config-CEFTL5ZL.js.map +0 -1
- package/dist/doctor-3QBYN46N.js +0 -338
- package/dist/doctor-3QBYN46N.js.map +0 -1
- package/dist/usdc-44R6XZF2.js +0 -18
- package/dist/wallet-ELBTBMXO.js +0 -20
- package/dist/wallet-XD576HF3.js +0 -173
- package/dist/wallet-XD576HF3.js.map +0 -1
- /package/dist/{_esm-ZH2J4QEH.js.map → _esm-C5CRWCYU.js.map} +0 -0
- /package/dist/{ccip-UCLT5VOW.js.map → _esm-N4KAVXQR.js.map} +0 -0
- /package/dist/{chunk-3IMLRUZE.js.map → buy-THMVOPUH.js.map} +0 -0
- /package/dist/{secp256k1-BEZS642W.js.map → ccip-RPPPKTJR.js.map} +0 -0
- /package/dist/{usdc-44R6XZF2.js.map → ccip-ZGGWQN4X.js.map} +0 -0
- /package/dist/{wallet-ELBTBMXO.js.map → chunk-ZXTAQYNA.js.map} +0 -0
- /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.
|
|
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
|
-
"@
|
|
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": "^
|
|
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
|
+
}
|