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,158 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ withFileLock
4
+ } from "./chunk-FKSAUOJU.js";
5
+ import {
6
+ external_exports,
7
+ writeFileAtomic
8
+ } from "./chunk-PZRAAAY2.js";
9
+
10
+ // src/lib/search-store.ts
11
+ import { mkdir, readFile } from "fs/promises";
12
+ import { join } from "path";
13
+ var MAX_ENTRIES = 50;
14
+ var StoredCandidateSchema = external_exports.object({
15
+ resourceId: external_exports.string(),
16
+ url: external_exports.string(),
17
+ title: external_exports.string(),
18
+ price: external_exports.string()
19
+ });
20
+ var SearchResolutionSchema = external_exports.enum(["outcome", "publish", "candidate"]);
21
+ var SearchSourceSchema = external_exports.enum(["cli", "websearch-hook"]);
22
+ var StoredSearchSchema = external_exports.object({
23
+ searchId: external_exports.string(),
24
+ at: external_exports.string(),
25
+ question: external_exports.string(),
26
+ decision: external_exports.string(),
27
+ candidates: external_exports.array(StoredCandidateSchema),
28
+ /** Absent until something closes the loop; see {@link markSearchResolved}. */
29
+ resolved: external_exports.object({ by: SearchResolutionSchema, at: external_exports.string() }).optional(),
30
+ /** Absent on entries written before sources existed; see {@link SearchSourceSchema}. */
31
+ source: SearchSourceSchema.optional(),
32
+ /**
33
+ * The harness session this search was run in, when anything could attribute it.
34
+ * This ledger is MACHINE-GLOBAL, so without it the Stop hook nags whichever
35
+ * session happens to stop next about open loops belonging to a sibling session,
36
+ * which that session cannot act on. The hook scopes on this when both the entry
37
+ * and the turn-end payload name a session, and stays global otherwise, so an
38
+ * unstamped entry is still raised everywhere rather than nowhere.
39
+ *
40
+ * OPTIONAL: the WebSearch hook is handed one by the harness (`session_id` on
41
+ * its stdin payload), and a deliberate `tenjin search` reads the same value
42
+ * from CLAUDE_CODE_SESSION_ID (or an operator's TENJIN_SESSION_ID). Absent on
43
+ * entries written before this field existed, and on any harness that exports
44
+ * neither.
45
+ */
46
+ sessionId: external_exports.string().optional(),
47
+ // How many of the search's browse pointers cost money, and NOT the pointers
48
+ // themselves: keeping them out of the store is what makes `buy <resourceId>`
49
+ // unable to reach one (see the browse comment in agent-api.ts), and a count
50
+ // cannot undo that. It exists so `outcome` can tell "this search offered
51
+ // nothing to buy" from "this search offered a payable browse tail", which the
52
+ // candidates array alone cannot say. Counts only PAID pointers because a
53
+ // zero-priced piece is delivered by `read` with no purchase to decline.
54
+ // Optional because entries written before this field existed have no answer,
55
+ // and `undefined` must read as unknown rather than as zero.
56
+ paidBrowseCount: external_exports.number().int().nonnegative().optional()
57
+ });
58
+ var StoreSchema = external_exports.object({
59
+ schemaVersion: external_exports.literal(1),
60
+ searches: external_exports.array(StoredSearchSchema)
61
+ });
62
+ function searchStorePath(dataDir) {
63
+ return join(dataDir, "searches.json");
64
+ }
65
+ function storePath(dataDir) {
66
+ return searchStorePath(dataDir);
67
+ }
68
+ async function loadSearches(dataDir) {
69
+ let raw;
70
+ try {
71
+ raw = await readFile(storePath(dataDir), "utf8");
72
+ } catch {
73
+ return [];
74
+ }
75
+ let json;
76
+ try {
77
+ json = JSON.parse(raw);
78
+ } catch {
79
+ return [];
80
+ }
81
+ const parsed = StoreSchema.safeParse(json);
82
+ return parsed.success ? parsed.data.searches : [];
83
+ }
84
+ async function recordSearch(dataDir, entry) {
85
+ await mkdir(dataDir, { recursive: true, mode: 448 });
86
+ const lockPath = `${storePath(dataDir)}.lock`;
87
+ await withFileLock(lockPath, async () => {
88
+ const existing = await loadSearches(dataDir);
89
+ const searches = [entry, ...existing.filter((l) => l.searchId !== entry.searchId)].slice(
90
+ 0,
91
+ MAX_ENTRIES
92
+ );
93
+ await writeFileAtomic(
94
+ storePath(dataDir),
95
+ `${JSON.stringify({ schemaVersion: 1, searches }, null, 2)}
96
+ `,
97
+ { mode: 420, dirMode: 448 }
98
+ );
99
+ });
100
+ }
101
+ async function markSearchResolved(dataDir, searchId, by, at = (/* @__PURE__ */ new Date()).toISOString()) {
102
+ try {
103
+ const lockPath = `${storePath(dataDir)}.lock`;
104
+ let outcome = "not-found";
105
+ await withFileLock(lockPath, async () => {
106
+ const existing = await loadSearches(dataDir);
107
+ const target = existing.find((s) => s.searchId === searchId);
108
+ if (target === void 0) return;
109
+ if (target.resolved !== void 0) {
110
+ outcome = "already-resolved";
111
+ return;
112
+ }
113
+ const searches = existing.map(
114
+ (s) => s.searchId === searchId ? { ...s, resolved: { by, at } } : s
115
+ );
116
+ await writeFileAtomic(
117
+ storePath(dataDir),
118
+ `${JSON.stringify({ schemaVersion: 1, searches }, null, 2)}
119
+ `,
120
+ { mode: 420, dirMode: 448 }
121
+ );
122
+ outcome = "resolved";
123
+ });
124
+ return outcome;
125
+ } catch {
126
+ return "failed";
127
+ }
128
+ }
129
+ async function latestSearch(dataDir) {
130
+ const searches = await loadSearches(dataDir);
131
+ return searches.find((s) => s.source !== "websearch-hook") ?? null;
132
+ }
133
+ async function findStoredCandidate(dataDir, resourceId) {
134
+ for (const search of await loadSearches(dataDir)) {
135
+ const hit = search.candidates.find((c) => c.resourceId === resourceId);
136
+ if (hit) return hit;
137
+ }
138
+ return null;
139
+ }
140
+ async function findSearchForResource(dataDir, match) {
141
+ for (const search of await loadSearches(dataDir)) {
142
+ const hit = search.candidates.some(
143
+ (c) => match.resourceId !== void 0 && c.resourceId === match.resourceId || match.url !== void 0 && c.url === match.url
144
+ );
145
+ if (hit) return search.searchId;
146
+ }
147
+ return null;
148
+ }
149
+
150
+ export {
151
+ loadSearches,
152
+ recordSearch,
153
+ markSearchResolved,
154
+ latestSearch,
155
+ findStoredCandidate,
156
+ findSearchForResource
157
+ };
158
+ //# sourceMappingURL=chunk-4NTZETIL.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/search-store.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { z } from 'zod';\nimport { writeFileAtomic } from './atomic-json';\nimport { withFileLock } from './lock';\n\n/**\n * A small local ledger of recent searches so `outcome --last` can target the most\n * recent one and `buy <resourceId>` can resolve the payable read URL a candidate\n * carried (the read route is keyed by handle/slug, not id, so an id alone can't\n * build the URL). Bounded and best-effort: a corrupt file reads as empty rather\n * than blocking a command. NOT an entitlement record, that is the library receipt.\n */\n\nconst MAX_ENTRIES = 50;\n\nconst StoredCandidateSchema = z.object({\n resourceId: z.string(),\n url: z.string(),\n title: z.string(),\n price: z.string(),\n});\nexport type StoredCandidate = z.infer<typeof StoredCandidateSchema>;\n\n/**\n * What closed an open loop. The Stop hook stays quiet once any of these is\n * recorded: `outcome` (the loop was reported) or `publish` (the answer went back\n * to the marketplace).\n *\n * `candidate` is RETAINED but never written. It is what the removed candidate\n * pen recorded, and an older `searches.json` still carries it; dropping the\n * member would make those entries fail to parse and read as an empty store,\n * which would resurrect loops their owner already closed.\n */\nexport const SearchResolutionSchema = z.enum(['outcome', 'publish', 'candidate']);\nexport type SearchResolution = z.infer<typeof SearchResolutionSchema>;\n\n/**\n * Who ran the search. `cli` is a deliberate `tenjin search`: the agent decided\n * the question was worth looking up, so an unanswered one is a strong signal.\n * `websearch-hook` is the PreToolUse hook riding along with a WebSearch the agent\n * was going to run anyway, which is a much weaker signal, because nobody judged\n * the question suitable for the marketplace before it was sent.\n *\n * The distinction exists because the Stop hook must not treat them alike: an\n * unanswered deliberate search deserves being named on its own, while a batch of\n * hook searches deserves one line the agent can dismiss at a glance. Keeping both\n * in ONE store is what makes the hook's misses reachable by explicit\n * `outcome --search-id`, `buy <resourceId>`, and the open-loop reminder at all\n * (`--last` deliberately skips hook entries; see {@link latestSearch}).\n *\n * OPTIONAL, and absent means `cli`: a store written by an earlier version has no\n * source field, and those entries were all explicit searches.\n */\nexport const SearchSourceSchema = z.enum(['cli', 'websearch-hook']);\nexport type SearchSource = z.infer<typeof SearchSourceSchema>;\n\nconst StoredSearchSchema = z.object({\n searchId: z.string(),\n at: z.string(),\n question: z.string(),\n decision: z.string(),\n candidates: z.array(StoredCandidateSchema),\n /** Absent until something closes the loop; see {@link markSearchResolved}. */\n resolved: z.object({ by: SearchResolutionSchema, at: z.string() }).optional(),\n /** Absent on entries written before sources existed; see {@link SearchSourceSchema}. */\n source: SearchSourceSchema.optional(),\n /**\n * The harness session this search was run in, when anything could attribute it.\n * This ledger is MACHINE-GLOBAL, so without it the Stop hook nags whichever\n * session happens to stop next about open loops belonging to a sibling session,\n * which that session cannot act on. The hook scopes on this when both the entry\n * and the turn-end payload name a session, and stays global otherwise, so an\n * unstamped entry is still raised everywhere rather than nowhere.\n *\n * OPTIONAL: the WebSearch hook is handed one by the harness (`session_id` on\n * its stdin payload), and a deliberate `tenjin search` reads the same value\n * from CLAUDE_CODE_SESSION_ID (or an operator's TENJIN_SESSION_ID). Absent on\n * entries written before this field existed, and on any harness that exports\n * neither.\n */\n sessionId: z.string().optional(),\n // How many of the search's browse pointers cost money, and NOT the pointers\n // themselves: keeping them out of the store is what makes `buy <resourceId>`\n // unable to reach one (see the browse comment in agent-api.ts), and a count\n // cannot undo that. It exists so `outcome` can tell \"this search offered\n // nothing to buy\" from \"this search offered a payable browse tail\", which the\n // candidates array alone cannot say. Counts only PAID pointers because a\n // zero-priced piece is delivered by `read` with no purchase to decline.\n // Optional because entries written before this field existed have no answer,\n // and `undefined` must read as unknown rather than as zero.\n paidBrowseCount: z.number().int().nonnegative().optional(),\n});\nexport type StoredSearch = z.infer<typeof StoredSearchSchema>;\n\nconst StoreSchema = z.object({\n schemaVersion: z.literal(1),\n searches: z.array(StoredSearchSchema),\n});\n\n/**\n * The store and its lock. Both paths are EXPORTED because the installed hook\n * scripts write this same file from outside the CLI process: they cannot import\n * this module, so they reimplement the lock protocol against this exact path.\n * Two writers of one file must at least agree on where the mutex lives, and a\n * test pins the script's protocol against this one.\n */\nexport function searchStorePath(dataDir: string): string {\n return join(dataDir, 'searches.json');\n}\n\nexport function searchStoreLockPath(dataDir: string): string {\n return `${searchStorePath(dataDir)}.lock`;\n}\n\nfunction storePath(dataDir: string): string {\n return searchStorePath(dataDir);\n}\n\nexport async function loadSearches(dataDir: string): Promise<StoredSearch[]> {\n let raw: string;\n try {\n raw = await readFile(storePath(dataDir), 'utf8');\n } catch {\n return [];\n }\n let json: unknown;\n try {\n json = JSON.parse(raw);\n } catch {\n return [];\n }\n const parsed = StoreSchema.safeParse(json);\n return parsed.success ? parsed.data.searches : [];\n}\n\n/** Prepend a search (newest first), cap to MAX_ENTRIES, persist under a lock so\n * concurrent searches don't drop each other's entry. */\nexport async function recordSearch(dataDir: string, entry: StoredSearch): Promise<void> {\n await mkdir(dataDir, { recursive: true, mode: 0o700 });\n const lockPath = `${storePath(dataDir)}.lock`;\n await withFileLock(lockPath, async () => {\n const existing = await loadSearches(dataDir);\n const searches = [entry, ...existing.filter((l) => l.searchId !== entry.searchId)].slice(\n 0,\n MAX_ENTRIES,\n );\n await writeFileAtomic(\n storePath(dataDir),\n `${JSON.stringify({ schemaVersion: 1, searches }, null, 2)}\\n`,\n { mode: 0o644, dirMode: 0o700 },\n );\n });\n}\n\n/**\n * What a {@link markSearchResolved} call actually did. Returned rather than\n * swallowed because a caller may REPORT the close to its own user, and \"I tried\"\n * is not \"it happened\": a lock timeout or an unwritable store still leaves the\n * loop open and the reminder due, so a receipt claiming otherwise would be a\n * confident lie. `already-resolved` is a success for anyone asking about the\n * LOOP (something closed it), and a no-op for anyone asking about this call.\n */\nexport type ResolutionOutcome = 'resolved' | 'already-resolved' | 'not-found' | 'failed';\n\n/**\n * Record that something closed the loop on `searchId`, so the Stop hook stops\n * raising it. Best-effort and it NEVER throws: an unknown id (the search aged\n * past MAX_ENTRIES, or came from another machine) writes nothing, and a failure\n * to persist costs one stale nag rather than the command the caller actually\n * ran. The FIRST resolution wins, so a publish after an outcome report does not\n * rewrite who closed it.\n */\nexport async function markSearchResolved(\n dataDir: string,\n searchId: string,\n by: SearchResolution,\n at: string = new Date().toISOString(),\n): Promise<ResolutionOutcome> {\n try {\n const lockPath = `${storePath(dataDir)}.lock`;\n let outcome: ResolutionOutcome = 'not-found';\n await withFileLock(lockPath, async () => {\n const existing = await loadSearches(dataDir);\n const target = existing.find((s) => s.searchId === searchId);\n if (target === undefined) return;\n if (target.resolved !== undefined) {\n outcome = 'already-resolved';\n return;\n }\n const searches = existing.map((s) =>\n s.searchId === searchId ? { ...s, resolved: { by, at } } : s,\n );\n await writeFileAtomic(\n storePath(dataDir),\n `${JSON.stringify({ schemaVersion: 1, searches }, null, 2)}\\n`,\n { mode: 0o644, dirMode: 0o700 },\n );\n outcome = 'resolved';\n });\n return outcome;\n } catch {\n // Bookkeeping for a hook nudge. It must never fail the verb that ran — but\n // the caller is told, so nothing reports a close that did not happen.\n return 'failed';\n }\n}\n\n/**\n * The most recent DELIBERATE search: `--last` means \"the search I just ran\", and\n * in auto mode the WebSearch hook prepends a ridealong entry on every web search,\n * so an unfiltered head would routinely re-target `outcome --last` at a query the\n * agent never chose to make (found in dogfooding). Hook entries stay reachable by\n * explicit `--search-id`, which is what the Stop hook's reminder names.\n */\nexport async function latestSearch(dataDir: string): Promise<StoredSearch | null> {\n const searches = await loadSearches(dataDir);\n return searches.find((s) => s.source !== 'websearch-hook') ?? null;\n}\n\n/** The stored candidate for a resourceId across recent searches (newest first). */\nexport async function findStoredCandidate(\n dataDir: string,\n resourceId: string,\n): Promise<StoredCandidate | null> {\n for (const search of await loadSearches(dataDir)) {\n const hit = search.candidates.find((c) => c.resourceId === resourceId);\n if (hit) return hit;\n }\n return null;\n}\n\n/** The most recent searchId that surfaced this resource (by id or url), for\n * purchase attribution (`X-Tenjin-Search-Id`). Null when no local search did. */\nexport async function findSearchForResource(\n dataDir: string,\n match: { resourceId?: string; url?: string },\n): Promise<string | null> {\n for (const search of await loadSearches(dataDir)) {\n const hit = search.candidates.some(\n (c) =>\n (match.resourceId !== undefined && c.resourceId === match.resourceId) ||\n (match.url !== undefined && c.url === match.url),\n );\n if (hit) return search.searchId;\n }\n return null;\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,130 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+
3
+ // src/lib/permissions.ts
4
+ var ALWAYS_SAFE_ALLOWLIST = [
5
+ {
6
+ rule: "Bash(tenjin search:*)",
7
+ command: "tenjin search",
8
+ note: "Free anonymous marketplace search. No wallet, no signing, no payment. Not read-only: it POSTs the generalized question off-machine and records the search locally."
9
+ },
10
+ {
11
+ rule: "Bash(tenjin fund:*)",
12
+ command: "tenjin fund",
13
+ note: "Owner call (2026-08-12): free on both surfaces, because the command just opens the fund modal. Minting moves no money: the destination is server-pinned to the wallet that signed, the CLI refuses any checkout host but pay.coinbase.com, and payment happens behind Coinbase\u2019s own human gate. The usual --base-url caveat does not apply: fund is pinned to the production origin and takes no override from flag, env, or config."
14
+ },
15
+ {
16
+ rule: "Bash(tenjin inspect:*)",
17
+ command: "tenjin inspect",
18
+ note: "Free pre-purchase card and preview. Never signs, never pays, never saves."
19
+ },
20
+ {
21
+ rule: "Bash(tenjin read:*)",
22
+ command: "tenjin read",
23
+ note: "Free-only delivery: free pieces, local-library re-reads, and pieces this wallet already owns when a read-scoped session key is cached. Cannot spend and cannot open the keystore \u2014 the wallet, payment, and session-MINTING modules are all absent from its import graph, so the key it may present is a P-256 delegation loaded from disk, which is the wrong curve to authorize a payment. TRANSMITS A CREDENTIAL: when a session key exists, a cold 402 sends that wallet-derived delegation to the server. It goes only to the origin the delegation was minted for, which is what stops a stray `--base-url` from redirecting it, and no scope on it limits what a holder could do with it. Not read-only: a freshly delivered piece is saved to the library."
24
+ },
25
+ {
26
+ rule: "Bash(tenjin outcome:*)",
27
+ command: "tenjin outcome",
28
+ note: "Free honest outcome report on a past search. No wallet, no payment. Not read-only: it POSTs a report that moves the marketplace reuse signal."
29
+ },
30
+ {
31
+ rule: "Bash(tenjin doctor:*)",
32
+ command: "tenjin doctor",
33
+ note: "Local environment and API reachability diagnostics. Decrypts the wallet locally to check it still opens; signs nothing and sends nothing."
34
+ },
35
+ {
36
+ rule: "Bash(tenjin wallet show:*)",
37
+ command: "tenjin wallet show",
38
+ note: "Prints the wallet address and key source. Never prints the key."
39
+ },
40
+ {
41
+ rule: "Bash(tenjin wallet balance:*)",
42
+ command: "tenjin wallet balance",
43
+ note: "Read-only USDC balance query on Base."
44
+ },
45
+ {
46
+ rule: "Bash(tenjin config get:*)",
47
+ command: "tenjin config get",
48
+ note: "Reads one effective config value. `config set` is excluded on purpose. Note `config get rpcUrl` returns your RPC URL, which commonly embeds a provider API key: no wallet secret, but a credential-adjacent read."
49
+ }
50
+ ];
51
+ var OPT_IN_ALLOWLIST = [
52
+ {
53
+ rule: "Bash(tenjin buy:*)",
54
+ command: "tenjin buy",
55
+ note: "SPENDS USDC on Base, unrefundably. This authorizes UNATTENDED purchases: `--yes` is an ordinary flag on the same allowlisted verb and it clears the confirm gate, so on the default config nothing stops a spend up to your wallet balance. Set a real ceiling first with `tenjin config set maxAutoSpend <usd>` and `tenjin config set sessionBudget <usd>` (sessionBudget 0 means NO ceiling, not a zero one). This line never raises a spend cap by itself, but do not read that as a human being on every purchase. Fund small."
56
+ },
57
+ {
58
+ rule: "Bash(tenjin session start:*)",
59
+ command: "tenjin session start",
60
+ note: "OPENS THE KEYSTORE (one wallet signature), but SPENDS NOTHING and cannot: it mints a \u226424h P-256 session key so `tenjin read` can recover pieces you already own without paying. The delegated key is the wrong curve for a payment authorization, so no session file can ever move money. Do NOT read the `read` scope as a bound on the rest: the file it leaves is a wallet-derived credential, and what limits it is that it expires in 24h, lives 0600, and is refused off the origin it was minted for \u2014 not its scope. What you are opting into is unattended keystore access: on an encrypted wallet the passphrase prompt is skipped or answered from the environment, and the `--base-url` caveat below bites hardest here, because a mint against an attacker-chosen host is a wallet signature you did not intend to make."
61
+ }
62
+ ];
63
+ var NEVER_ALLOWLISTED = [
64
+ {
65
+ command: "tenjin send",
66
+ reason: "Moves USDC out of the wallet to an arbitrary address (the escape hatch, #40). Irreversible and not bounded by the buy spend policy. Always a human decision."
67
+ },
68
+ {
69
+ command: "tenjin publish",
70
+ reason: "Puts your content on a public marketplace under your identity."
71
+ },
72
+ {
73
+ command: "tenjin edit",
74
+ reason: "Write-capable despite the no-flag form reading as a pure show: it edits live posts and answer cards under your identity, and moves prices. A prefix rule pins the verb, not the flags, so no rule can clear the read half without clearing the write half."
75
+ },
76
+ {
77
+ command: "tenjin wallet create",
78
+ reason: "Creates the payment credential; a stray run is a wallet you did not mean to have."
79
+ },
80
+ {
81
+ command: "tenjin config set",
82
+ reason: "Can raise maxAutoSpend / sessionBudget / confirm, i.e. widen the agent\u2019s own spend policy."
83
+ },
84
+ {
85
+ command: "tenjin install",
86
+ reason: "Writes into harness config and skills directories."
87
+ },
88
+ {
89
+ command: "tenjin mcp",
90
+ reason: "Long-running server that re-exposes every command core over stdio; clearing it would indirectly clear everything above."
91
+ }
92
+ ];
93
+ var FLAG_CAVEAT = [
94
+ "Caveat: a prefix rule pins the VERB, not the flags. Every line above also clears",
95
+ "`--base-url <url>` on that verb, which re-points where the question, the probe, the",
96
+ "session key `read` may present, and (for buy) the signature and payment go. Signed",
97
+ "and credential-bearing traffic is NOT confined to the paying verb: `read` is in the",
98
+ "safe tier and still transmits a wallet-derived delegation once one is cached, which is",
99
+ "why that delegation is bound to the origin it was minted for and refused elsewhere.",
100
+ "Allowlist these verbs only if you are content for the agent to choose the destination",
101
+ "host, and set the base URL in config instead of letting it be an argument. The skills",
102
+ "tell agents never to pass --base-url on an allowlisted verb, but that is a convention,",
103
+ "not an enforced boundary."
104
+ ];
105
+ var MCP_CAVEAT = [
106
+ "Running the local MCP server (`tenjin mcp`) instead? That is a different permission",
107
+ "surface: the harness gates TOOLS there, and these Bash rules do not apply. Leave",
108
+ "`mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`, and",
109
+ "`mcp__tenjin__tenjin_wallet` gated. `tenjin_buy` is the same opt-in decision as the",
110
+ "buy line above."
111
+ ];
112
+ function recommendedPermissions() {
113
+ return {
114
+ alwaysSafe: ALWAYS_SAFE_ALLOWLIST.map((e) => ({ ...e })),
115
+ optIn: OPT_IN_ALLOWLIST.map((e) => ({ ...e })),
116
+ neverAllowlisted: NEVER_ALLOWLISTED.map((e) => ({ ...e })),
117
+ caveats: { flags: [...FLAG_CAVEAT], mcp: [...MCP_CAVEAT] }
118
+ };
119
+ }
120
+ var PERMISSIONS_DOC_URL = "https://github.com/BackTrackCo/tenjin-agent/blob/main/docs/agent-permissions.md";
121
+ function permissionsPointer() {
122
+ return `Auto-mode permission allowlist and subagent delegation (${ALWAYS_SAFE_ALLOWLIST.length} free verbs, ${OPT_IN_ALLOWLIST.length} opt-ins, the --base-url caveat): ${PERMISSIONS_DOC_URL}`;
123
+ }
124
+
125
+ export {
126
+ recommendedPermissions,
127
+ PERMISSIONS_DOC_URL,
128
+ permissionsPointer
129
+ };
130
+ //# sourceMappingURL=chunk-4TCU3YRD.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/permissions.ts"],"sourcesContent":["/**\n * The recommended HARNESS permission allowlist: the exact rule lines an operator\n * pastes into Claude Code (or an equivalent harness) so auto mode stops denying\n * the free Tenjin verbs, and so the one paying verb is cleared deliberately\n * rather than by accident.\n *\n * This is a HARNESS-side allowlist (which shell commands the agent may run at\n * all). It is NOT the CLI's spend policy and shares nothing with it: the shipped\n * `allowlistCreators` config key gates WHO you may pay, this file gates WHICH\n * COMMANDS the harness will run without a prompt. The two are deliberately kept\n * apart in name and in code — clearing `Bash(tenjin buy:*)` here never raises a\n * spend cap. That is a claim about this file, NOT a claim that the spend policy\n * stops an allowlisted `buy`: `--yes` is an ordinary flag on an allowlisted verb\n * and `confirmSpend` returns true on it before any TTY check\n * (src/commands/buy.ts), so under CONFIG_DEFAULTS nothing denies. See\n * OPT_IN_ALLOWLIST's note for the walk-through.\n *\n * These are static, shipped constants on purpose: there is NO config key for\n * them. An operator-editable \"which commands may run\" list stored next to the\n * spend policy would be a second, weaker copy of a control the harness already\n * owns, and a CLI that could widen its own permission grant is exactly the shape\n * this file exists to avoid.\n *\n * Scope: `tenjin mcp` exposes the same command cores over MCP, where the harness\n * gates TOOLS, not Bash lines. These rules say nothing about that surface, which\n * is why `tenjin mcp` is itself never recommended here: clearing it would route\n * around every rule below. MCP_CAVEAT names the tools to leave gated for an\n * operator who runs the server anyway.\n *\n * LIMIT OF A PREFIX RULE, read this before adding an entry: the rule constrains\n * the VERB and nothing else. `addGlobalFlags` (src/cli.ts) puts `--json`,\n * `--timeout`, and `--base-url` on every leaf command, so every rule below also\n * clears `--base-url <url>` in trailing position. `--base-url` is validated as a\n * URL and nothing more, and it wins settings precedence, so it re-points the\n * trust boundary itself: the `search` question goes to that host, `doctor` probes\n * it, and `assertOnBaseOrigin` only checks that a resource URL shares an origin\n * with the CONFIGURED base, so an attacker-controlled pair satisfies the pin. No\n * prefix syntax expresses \"this verb but not that flag\", so the mitigation is\n * disclosure rather than a narrower rule: FLAG_CAVEAT rides the `--json` payload\n * and docs/agent-permissions.md, every human surface points at that page, and the\n * skills tell the agent never to pass `--base-url` on an allowlisted verb. Pinning\n * the paying path to a constant origin instead is the real fix and is an\n * x402/payments-semantics change, tracked separately.\n */\n\n/** One pasteable allowlist rule plus why it is safe (or what it costs). */\nexport interface AllowlistEntry {\n /** The exact line to add to the harness permission allowlist. */\n rule: string;\n /** The verb it clears. */\n command: string;\n /** Why it is safe to pre-clear, or what the operator is opting into. */\n note: string;\n}\n\n/** A verb deliberately kept OUT of the recommended allowlist, and why. */\nexport interface ExcludedVerb {\n command: string;\n reason: string;\n}\n\n/**\n * FREE verbs: they CANNOT SPEND AND CANNOT MOVE YOUR KEYS. That is the whole\n * definition of this tier, and it is deliberately narrower than the older \"no\n * wallet, no signing, no payment\" — which stopped being true the moment `read`\n * gained the ability to PRESENT a cached session key. `read` signs, with a P-256\n * delegation loaded from disk; it cannot mint one (that needs the wallet, and its\n * import graph is test-pinned clear of it) and cannot produce the\n * secp256k1/EIP-712 signature a payment authorization needs (wrong curve). Money\n * stays out of reach; a signature as such no longer does, so the tier says what\n * it means. `doctor` decrypts locally to check the wallet still opens.\n *\n * What the tier does NOT claim, because it is not true: that the read scope\n * limits what a leaked delegation is worth. Scope is enforced only on the request\n * shape that carries both a session signature and the delegation header; the same\n * delegation replayed as a plain `SIGN-IN-WITH-X` takes a different server path\n * where no scope logic runs. So a session file is a wallet-derived credential\n * with the authority of the wallet behind it, and the mitigations that actually\n * hold are the ones in this repo: it is 0600, short-lived (≤24h, server-clamped),\n * bound to the origin it was minted for, and never presented off that origin.\n * Treat \"read is allowlisted\" as \"read may transmit that credential to the\n * configured origin\", and see FLAG_CAVEAT for why the configured origin is not\n * automatically the one you configured.\n *\n * Not all of them are read-only, and the difference is disclosed rather than\n * papered over — `search` POSTs the (generalized, anonymous) question off-machine\n * and records it locally, `outcome` POSTs a report that moves the marketplace's\n * reuse signal (both unauthenticated remote writes), and `read` writes locally,\n * saving a delivered piece to the library, and `doctor` decrypts the keystore\n * locally to check it opens. Pre-clearing them is defensible because they cost\n * nothing and none of it leaves the machine; calling them read-only to justify it\n * would not be.\n *\n * Rules are PREFIX rules: `Bash(tenjin search:*)` clears commands that start with\n * `tenjin search` and nothing else. The narrow `wallet show` / `wallet balance` /\n * The `config get` form is deliberate: a `Bash(tenjin wallet:*)`\n * or `Bash(tenjin config:*)` rule would silently swallow `wallet create` and\n * `config set`, and `config set` can raise the spend caps.\n *\n * Two known gaps, both fail-closed (denied, never wrongly allowed):\n * - Bare `tenjin config` (runConfigList) is as read-only as `config get`, but no\n * prefix rule reaches it without also covering `config set`, so it stays out.\n * Use `tenjin config get <key>`, which is a different supported command rather\n * than a reworded one.\n * - Group-level flag forms like `tenjin wallet --json show` are not covered.\n * Put global flags AFTER the leaf verb (`tenjin wallet show --json`); the\n * CLI parses either, and only the trailing form matches these rules.\n */\nexport const ALWAYS_SAFE_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin search:*)',\n command: 'tenjin search',\n note:\n 'Free anonymous marketplace search. No wallet, no signing, no payment. ' +\n 'Not read-only: it POSTs the generalized question off-machine and records ' +\n 'the search locally.',\n },\n {\n rule: 'Bash(tenjin fund:*)',\n command: 'tenjin fund',\n note:\n 'Owner call (2026-08-12): free on both surfaces, because the command just opens the ' +\n 'fund modal. Minting moves no money: the destination is server-pinned to the wallet ' +\n 'that signed, the CLI refuses any checkout host but pay.coinbase.com, and payment ' +\n 'happens behind Coinbase\\u2019s own human gate. The usual --base-url caveat does not ' +\n 'apply: fund is pinned to the production origin and takes no override from flag, ' +\n 'env, or config.',\n },\n {\n rule: 'Bash(tenjin inspect:*)',\n command: 'tenjin inspect',\n note: 'Free pre-purchase card and preview. Never signs, never pays, never saves.',\n },\n {\n rule: 'Bash(tenjin read:*)',\n command: 'tenjin read',\n note:\n 'Free-only delivery: free pieces, local-library re-reads, and pieces this ' +\n 'wallet already owns when a read-scoped session key is cached. Cannot spend ' +\n 'and cannot open the keystore — the wallet, payment, and session-MINTING ' +\n 'modules are all absent from its import graph, so the key it may present is ' +\n 'a P-256 delegation loaded from disk, which is the wrong curve to authorize ' +\n 'a payment. TRANSMITS A CREDENTIAL: when a session key exists, a cold 402 ' +\n 'sends that wallet-derived delegation to the server. It goes only to the ' +\n 'origin the delegation was minted for, which is what stops a stray ' +\n '`--base-url` from redirecting it, and no scope on it limits what a holder ' +\n 'could do with it. Not read-only: a freshly delivered piece is saved to the ' +\n 'library.',\n },\n {\n rule: 'Bash(tenjin outcome:*)',\n command: 'tenjin outcome',\n note:\n 'Free honest outcome report on a past search. No wallet, no payment. ' +\n 'Not read-only: it POSTs a report that moves the marketplace reuse signal.',\n },\n {\n rule: 'Bash(tenjin doctor:*)',\n command: 'tenjin doctor',\n note:\n 'Local environment and API reachability diagnostics. Decrypts the wallet ' +\n 'locally to check it still opens; signs nothing and sends nothing.',\n },\n {\n rule: 'Bash(tenjin wallet show:*)',\n command: 'tenjin wallet show',\n note: 'Prints the wallet address and key source. Never prints the key.',\n },\n {\n rule: 'Bash(tenjin wallet balance:*)',\n command: 'tenjin wallet balance',\n note: 'Read-only USDC balance query on Base.',\n },\n {\n rule: 'Bash(tenjin config get:*)',\n command: 'tenjin config get',\n note:\n 'Reads one effective config value. `config set` is excluded on purpose. ' +\n 'Note `config get rpcUrl` returns your RPC URL, which commonly embeds a ' +\n 'provider API key: no wallet secret, but a credential-adjacent read.',\n },\n];\n\n/**\n * The verbs offered as EXPLICIT opt-in lines rather than shipped in the safe set:\n * the one that spends, and the one that opens the keystore.\n *\n * Read the buy note carefully before pasting the line: on the DEFAULT config this\n * rule authorizes unattended spending up to the wallet balance. Walking\n * evaluateSpendPolicy (lib/policy.ts) against CONFIG_DEFAULTS with an agent that\n * passes `--yes` (which this repo's own skill snippet offers):\n * - `maxPriceAtomic` is unset unless the agent chooses to pass `--max-price`;\n * - `allowlistCreators` is empty, so the creator gate is off;\n * - `sessionBudget` is '0', which `if (policy.sessionBudgetAtomic > 0n)` reads\n * as DISABLED, not as a zero ceiling;\n * - `maxAutoSpend` '0' and `confirm` 'always' both land on `confirm`, and\n * `confirmSpend` returns true on `--yes` before any TTY check.\n * Nothing denies. Note the asymmetry that makes the pair read safer than it is:\n * `maxAutoSpend: '0'` means \"auto-approve nothing\" while `sessionBudget: '0'`\n * means \"no ceiling at all\".\n */\nexport const OPT_IN_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin buy:*)',\n command: 'tenjin buy',\n note:\n 'SPENDS USDC on Base, unrefundably. This authorizes UNATTENDED purchases: ' +\n '`--yes` is an ordinary flag on the same allowlisted verb and it clears the ' +\n 'confirm gate, so on the default config nothing stops a spend up to your ' +\n 'wallet balance. Set a real ceiling first with ' +\n '`tenjin config set maxAutoSpend <usd>` and ' +\n '`tenjin config set sessionBudget <usd>` (sessionBudget 0 means NO ceiling, ' +\n 'not a zero one). This line never raises a spend cap by itself, but do not ' +\n 'read that as a human being on every purchase. Fund small.',\n },\n {\n rule: 'Bash(tenjin session start:*)',\n command: 'tenjin session start',\n note:\n 'OPENS THE KEYSTORE (one wallet signature), but SPENDS NOTHING and cannot: ' +\n 'it mints a ≤24h P-256 session key so `tenjin read` can recover pieces you ' +\n 'already own without paying. The delegated key is the wrong curve for a ' +\n 'payment authorization, so no session file can ever move money. Do NOT read ' +\n 'the `read` scope as a bound on the rest: the file it leaves is a ' +\n 'wallet-derived credential, and what limits it is that it expires in 24h, ' +\n 'lives 0600, and is refused off the origin it was minted for — not its ' +\n 'scope. What you are opting into is unattended keystore access: on an ' +\n 'encrypted wallet the passphrase prompt is skipped or answered from the ' +\n 'environment, and the `--base-url` caveat below bites hardest here, because ' +\n 'a mint against an attacker-chosen host is a wallet signature you did not ' +\n 'intend to make.',\n },\n];\n\n/**\n * Verbs that must NEVER appear in the recommended allowlist, with the reason each\n * one is a human decision. `tenjin send` is the wallet escape hatch (tenjin-agent\n * #40) and heads this list: it moves USDC to an arbitrary address, outside the\n * spend policy that bounds `buy`. Naming it here is load-bearing even in versions\n * where the verb does not exist yet — the exclusion ships before the verb does.\n */\nexport const NEVER_ALLOWLISTED: readonly ExcludedVerb[] = [\n {\n command: 'tenjin send',\n reason:\n 'Moves USDC out of the wallet to an arbitrary address (the escape hatch, #40). ' +\n 'Irreversible and not bounded by the buy spend policy. Always a human decision.',\n },\n {\n command: 'tenjin publish',\n reason: 'Puts your content on a public marketplace under your identity.',\n },\n {\n command: 'tenjin edit',\n reason:\n 'Write-capable despite the no-flag form reading as a pure show: it edits live posts ' +\n 'and answer cards under your identity, and moves prices. A prefix rule pins the verb, ' +\n 'not the flags, so no rule can clear the read half without clearing the write half.',\n },\n {\n command: 'tenjin wallet create',\n reason: 'Creates the payment credential; a stray run is a wallet you did not mean to have.',\n },\n {\n command: 'tenjin config set',\n reason:\n 'Can raise maxAutoSpend / sessionBudget / confirm, i.e. widen the agent’s own spend policy.',\n },\n {\n command: 'tenjin install',\n reason: 'Writes into harness config and skills directories.',\n },\n {\n command: 'tenjin mcp',\n reason:\n 'Long-running server that re-exposes every command core over stdio; ' +\n 'clearing it would indirectly clear everything above.',\n },\n];\n\n/**\n * The flag-surface caveat. A prefix rule pins the verb, never the flags, and the\n * flag that matters is `--base-url`: it is accepted on every leaf, validated only\n * as a URL, and it wins settings precedence, so it moves the destination of every\n * allowlisted verb. Printed with the rules everywhere they are printed, because\n * an operator who only reads the verb list would never learn it.\n */\nexport const FLAG_CAVEAT: readonly string[] = [\n 'Caveat: a prefix rule pins the VERB, not the flags. Every line above also clears',\n '`--base-url <url>` on that verb, which re-points where the question, the probe, the',\n 'session key `read` may present, and (for buy) the signature and payment go. Signed',\n 'and credential-bearing traffic is NOT confined to the paying verb: `read` is in the',\n 'safe tier and still transmits a wallet-derived delegation once one is cached, which is',\n 'why that delegation is bound to the origin it was minted for and refused elsewhere.',\n 'Allowlist these verbs only if you are content for the agent to choose the destination',\n 'host, and set the base URL in config instead of letting it be an argument. The skills',\n 'tell agents never to pass --base-url on an allowlisted verb, but that is a convention,',\n 'not an enforced boundary.',\n];\n\n/**\n * The MCP caveat. `tenjin mcp` is never recommended as a Bash rule, but an\n * operator who registers the server anyway is on a different permission surface\n * (tools, not command strings) where three excluded verbs come back.\n */\nexport const MCP_CAVEAT: readonly string[] = [\n 'Running the local MCP server (`tenjin mcp`) instead? That is a different permission',\n 'surface: the harness gates TOOLS there, and these Bash rules do not apply. Leave',\n '`mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`, and',\n '`mcp__tenjin__tenjin_wallet` gated. `tenjin_buy` is the same opt-in decision as the',\n 'buy line above.',\n];\n\n/** The machine shape emitted by `tenjin doctor --json` and `tenjin install --json`. */\nexport interface RecommendedPermissions {\n alwaysSafe: AllowlistEntry[];\n optIn: AllowlistEntry[];\n neverAllowlisted: ExcludedVerb[];\n /** Caveats that qualify the rules above; never omit them when rendering. */\n caveats: { flags: string[]; mcp: string[] };\n}\n\nexport function recommendedPermissions(): RecommendedPermissions {\n return {\n alwaysSafe: ALWAYS_SAFE_ALLOWLIST.map((e) => ({ ...e })),\n optIn: OPT_IN_ALLOWLIST.map((e) => ({ ...e })),\n neverAllowlisted: NEVER_ALLOWLISTED.map((e) => ({ ...e })),\n caveats: { flags: [...FLAG_CAVEAT], mcp: [...MCP_CAVEAT] },\n };\n}\n\n/** Every rule this module recommends adding (safe + opt-in). */\nexport function recommendedRules(): string[] {\n return [...ALWAYS_SAFE_ALLOWLIST, ...OPT_IN_ALLOWLIST].map((e) => e.rule);\n}\n\n/**\n * The permission caveats' one home. `doctor` used to print the whole thing —\n * nine rules, both opt-in notes, every exclusion, the flag caveat and the MCP\n * caveat, ~60 lines ahead of the check list it was actually run for. No doctor\n * command in the wider ecosystem carries security prose, and an operator reading\n * a wall of it in a terminal cannot paste from it, search it, or link a colleague\n * to a section. The page can do all three, so it is where the caveats live and\n * where every human surface points; `--json` still carries them as data\n * (`recommendedPermissions`), which is what an agent reads.\n */\nexport const PERMISSIONS_DOC_URL =\n 'https://github.com/BackTrackCo/tenjin-agent/blob/main/docs/agent-permissions.md';\n\n/**\n * The single line that replaced the block: what is on the page, and its URL. It\n * names the counts rather than the rules so the operator knows whether the page\n * answers their question before they open it.\n *\n * Subagent delegation is named here rather than on a second line, because doctor\n * deliberately closes with ONE pointer (#81) and the operator deciding what to\n * hand a subagent is reading exactly this line. The free tier IS the\n * subagent-safe set, so the counts already answer the question; which verbs stay\n * human-gated lives on the page with every other caveat.\n */\nexport function permissionsPointer(): string {\n return (\n `Auto-mode permission allowlist and subagent delegation (${ALWAYS_SAFE_ALLOWLIST.length} free verbs, ` +\n `${OPT_IN_ALLOWLIST.length} opt-ins, the --base-url caveat): ${PERMISSIONS_DOC_URL}`\n );\n}\n"],"mappings":";;;AA4GO,IAAM,wBAAmD;AAAA,EAC9D;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAGJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAMJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAWJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAEJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAEJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAGJ;AACF;AAoBO,IAAM,mBAA8C;AAAA,EACzD;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAQJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAYJ;AACF;AASO,IAAM,oBAA6C;AAAA,EACxD;AAAA,IACE,SAAS;AAAA,IACT,QACE;AAAA,EAEJ;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QACE;AAAA,EAGJ;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QACE;AAAA,EACJ;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,SAAS;AAAA,IACT,QACE;AAAA,EAEJ;AACF;AASO,IAAM,cAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,IAAM,aAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAWO,SAAS,yBAAiD;AAC/D,SAAO;AAAA,IACL,YAAY,sBAAsB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAAA,IACvD,OAAO,iBAAiB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAAA,IAC7C,kBAAkB,kBAAkB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAAA,IACzD,SAAS,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,UAAU,EAAE;AAAA,EAC3D;AACF;AAiBO,IAAM,sBACX;AAaK,SAAS,qBAA6B;AAC3C,SACE,2DAA2D,sBAAsB,MAAM,gBACpF,iBAAiB,MAAM,qCAAqC,mBAAmB;AAEtF;","names":[]}