tenjin-cli 0.1.0-alpha.13 → 0.1.0-alpha.15

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 (182) hide show
  1. package/README.md +51 -3
  2. package/dist/buy-VIRNSYGN.js +47 -0
  3. package/dist/{chunk-OC3EIDCP.js → chunk-2MYQN7HM.js} +71 -26
  4. package/dist/chunk-2MYQN7HM.js.map +1 -0
  5. package/dist/{chunk-XXY77EZJ.js → chunk-2RF2GIJQ.js} +57 -226
  6. package/dist/chunk-2RF2GIJQ.js.map +1 -0
  7. package/dist/chunk-3GL2Z5QK.js +57 -0
  8. package/dist/chunk-3GL2Z5QK.js.map +1 -0
  9. package/dist/{chunk-OXUJ3FXU.js → chunk-4CQIDQOT.js} +41 -8
  10. package/dist/chunk-4CQIDQOT.js.map +1 -0
  11. package/dist/{chunk-YMUJZWHB.js → chunk-4KG27W2S.js} +10 -10
  12. package/dist/chunk-4KG27W2S.js.map +1 -0
  13. package/dist/{chunk-SPUORKD7.js → chunk-5QQTYWEU.js} +13 -13
  14. package/dist/chunk-5QQTYWEU.js.map +1 -0
  15. package/dist/chunk-65DTCCJ7.js +21 -0
  16. package/dist/chunk-65DTCCJ7.js.map +1 -0
  17. package/dist/{chunk-BRAVLUGI.js → chunk-A5DKHMUN.js} +28 -13
  18. package/dist/chunk-A5DKHMUN.js.map +1 -0
  19. package/dist/chunk-B63XPWQ4.js +246 -0
  20. package/dist/chunk-B63XPWQ4.js.map +1 -0
  21. package/dist/{chunk-47YKYDOF.js → chunk-CAR6FHK6.js} +5 -5
  22. package/dist/{chunk-JVBMPU5G.js → chunk-CPCX67TI.js} +22 -22
  23. package/dist/{chunk-TXVC46SA.js → chunk-CQBVCYI2.js} +40 -53
  24. package/dist/chunk-CQBVCYI2.js.map +1 -0
  25. package/dist/chunk-DBU5CXBV.js +4731 -0
  26. package/dist/chunk-DBU5CXBV.js.map +1 -0
  27. package/dist/chunk-DHJD77OW.js +81 -0
  28. package/dist/chunk-DHJD77OW.js.map +1 -0
  29. package/dist/{chunk-XGZ5EVMB.js → chunk-EDZSNPE5.js} +2 -2
  30. package/dist/{chunk-736DW4V3.js → chunk-EFWZPUTC.js} +2 -2
  31. package/dist/chunk-EPFL6CTE.js +448 -0
  32. package/dist/chunk-EPFL6CTE.js.map +1 -0
  33. package/dist/{chunk-3P3ES4XU.js → chunk-GHLVXVZD.js} +3 -5
  34. package/dist/{chunk-3P3ES4XU.js.map → chunk-GHLVXVZD.js.map} +1 -1
  35. package/dist/{chunk-UUARTUY2.js → chunk-H3SOOJ2I.js} +264 -33
  36. package/dist/chunk-H3SOOJ2I.js.map +1 -0
  37. package/dist/{chunk-OUJDDY5L.js → chunk-HPJGOLTN.js} +32 -32
  38. package/dist/chunk-HPJGOLTN.js.map +1 -0
  39. package/dist/{chunk-J6FUAIRR.js → chunk-HRGBS2PA.js} +4 -6
  40. package/dist/{chunk-J6FUAIRR.js.map → chunk-HRGBS2PA.js.map} +1 -1
  41. package/dist/{chunk-NKN4YC5C.js → chunk-ITUXPJIS.js} +55 -58
  42. package/dist/chunk-ITUXPJIS.js.map +1 -0
  43. package/dist/{chunk-CA3JV7FX.js → chunk-JBIKAAT3.js} +2 -2
  44. package/dist/{chunk-CA3JV7FX.js.map → chunk-JBIKAAT3.js.map} +1 -1
  45. package/dist/{chunk-6JKD46OJ.js → chunk-KAJZHIQ4.js} +13 -10
  46. package/dist/chunk-KAJZHIQ4.js.map +1 -0
  47. package/dist/{chunk-OWVVI4VQ.js → chunk-KINZ23CV.js} +107 -4535
  48. package/dist/chunk-KINZ23CV.js.map +1 -0
  49. package/dist/{chunk-WMFRCSNC.js → chunk-LRYV3SK7.js} +9 -7
  50. package/dist/{chunk-WMFRCSNC.js.map → chunk-LRYV3SK7.js.map} +1 -1
  51. package/dist/{chunk-T4UWMVKV.js → chunk-NIKXHWOL.js} +11 -13
  52. package/dist/{chunk-T4UWMVKV.js.map → chunk-NIKXHWOL.js.map} +1 -1
  53. package/dist/chunk-OKDRDT74.js +209 -0
  54. package/dist/chunk-OKDRDT74.js.map +1 -0
  55. package/dist/chunk-OKYSNAS3.js +2144 -0
  56. package/dist/chunk-OKYSNAS3.js.map +1 -0
  57. package/dist/{chunk-B676GPS2.js → chunk-OLWTRUTS.js} +7 -3
  58. package/dist/{chunk-B676GPS2.js.map → chunk-OLWTRUTS.js.map} +1 -1
  59. package/dist/{chunk-WU5CZPLD.js → chunk-QQ6ELLSA.js} +6 -8
  60. package/dist/{chunk-WU5CZPLD.js.map → chunk-QQ6ELLSA.js.map} +1 -1
  61. package/dist/{chunk-WVHPGQH5.js → chunk-QZ6ROAJU.js} +8 -4
  62. package/dist/chunk-QZ6ROAJU.js.map +1 -0
  63. package/dist/{chunk-L4XNT3UW.js → chunk-R7RSCBI7.js} +167 -52
  64. package/dist/chunk-R7RSCBI7.js.map +1 -0
  65. package/dist/{chunk-ELVDOTU7.js → chunk-U6VPKMGC.js} +128 -28
  66. package/dist/chunk-U6VPKMGC.js.map +1 -0
  67. package/dist/{chunk-FKSAUOJU.js → chunk-UO22YNY4.js} +1 -69
  68. package/dist/chunk-UO22YNY4.js.map +1 -0
  69. package/dist/{chunk-IAR25V2E.js → chunk-US456VUI.js} +6 -6
  70. package/dist/{chunk-IKAJSA7E.js → chunk-V44J2MXV.js} +80 -34
  71. package/dist/chunk-V44J2MXV.js.map +1 -0
  72. package/dist/{chunk-IFPKA32J.js → chunk-VJQKL3YH.js} +10 -7
  73. package/dist/{chunk-IFPKA32J.js.map → chunk-VJQKL3YH.js.map} +1 -1
  74. package/dist/{chunk-GCGMXA2O.js → chunk-VJSQSLBM.js} +52 -20
  75. package/dist/chunk-VJSQSLBM.js.map +1 -0
  76. package/dist/{chunk-IGHSLJUF.js → chunk-VYOJOX4Z.js} +9 -7
  77. package/dist/chunk-VYOJOX4Z.js.map +1 -0
  78. package/dist/chunk-WY2K35OL.js +269 -0
  79. package/dist/chunk-WY2K35OL.js.map +1 -0
  80. package/dist/{chunk-PAOVPSP6.js → chunk-ZFJJ3EXC.js} +53 -5
  81. package/dist/chunk-ZFJJ3EXC.js.map +1 -0
  82. package/dist/chunk-ZOBNS7CX.js +73 -0
  83. package/dist/chunk-ZOBNS7CX.js.map +1 -0
  84. package/dist/{cli-XK5JZWU6.js → cli-KKRKBU5T.js} +76 -47
  85. package/dist/{cli-XK5JZWU6.js.map → cli-KKRKBU5T.js.map} +1 -1
  86. package/dist/config-JMRUNYE6.js +37 -0
  87. package/dist/discover-B5HF6SHM.js +102 -0
  88. package/dist/discover-B5HF6SHM.js.map +1 -0
  89. package/dist/doctor-ZBG7X66D.js +32 -0
  90. package/dist/edit-PZJIILQE.js +40 -0
  91. package/dist/{fund-JF6A76YS.js → fund-EUDH5KPA.js} +19 -17
  92. package/dist/index.js +1 -1
  93. package/dist/inspect-QC6WEQPN.js +37 -0
  94. package/dist/{install-YQVM3SUW.js → install-GNK2W3PI.js} +286 -447
  95. package/dist/install-GNK2W3PI.js.map +1 -0
  96. package/dist/outcome-KSGWZHUS.js +24 -0
  97. package/dist/pay-BC4UICPA.js +361 -0
  98. package/dist/pay-BC4UICPA.js.map +1 -0
  99. package/dist/publish-LXWFDIKF.js +42 -0
  100. package/dist/{read-UF7QVQOU.js → read-JMNUQ56P.js} +22 -20
  101. package/dist/{read-UF7QVQOU.js.map → read-JMNUQ56P.js.map} +1 -1
  102. package/dist/{run-GDZWHNWZ.js → run-XYTQ5TWQ.js} +54 -45
  103. package/dist/{run-GDZWHNWZ.js.map → run-XYTQ5TWQ.js.map} +1 -1
  104. package/dist/search-TSQAB45E.js +25 -0
  105. package/dist/{send-SI254H3R.js → send-G746D7PQ.js} +14 -14
  106. package/dist/{session-GJZJEXLJ.js → session-JBKWMJ24.js} +18 -17
  107. package/dist/{session-GJZJEXLJ.js.map → session-JBKWMJ24.js.map} +1 -1
  108. package/dist/{skill-heal-BPFT22XS.js → skill-heal-WKD67SLJ.js} +17 -9
  109. package/dist/skill-heal-WKD67SLJ.js.map +1 -0
  110. package/dist/skill-placement-RIU4AMC2.js +20 -0
  111. package/dist/{uninstall-7ZZG6WQ5.js → uninstall-5E263VTS.js} +15 -9
  112. package/dist/uninstall-5E263VTS.js.map +1 -0
  113. package/dist/{update-FPSBITLB.js → update-R76LHOZW.js} +18 -16
  114. package/dist/update-R76LHOZW.js.map +1 -0
  115. package/dist/{wallet-NS7TYWNN.js → wallet-TQ7D5EQ7.js} +7 -7
  116. package/dist/{wallet-TZVD2M4I.js → wallet-ZAVXWLWP.js} +11 -11
  117. package/dist/wallet-ZAVXWLWP.js.map +1 -0
  118. package/docs/agent-permissions.md +117 -18
  119. package/docs/command-reference.md +102 -50
  120. package/docs/safety-model.md +9 -0
  121. package/package.json +1 -1
  122. package/skills/tenjin/SKILL.md +38 -29
  123. package/skills/tenjin-pay/SKILL.md +76 -0
  124. package/skills/tenjin-publish/SKILL.md +184 -205
  125. package/skills/tenjin-publish/references/maintain.md +39 -0
  126. package/skills/tenjin-search/SKILL.md +92 -280
  127. package/skills/tenjin-search/references/permissions.md +112 -0
  128. package/dist/buy-X4VPHFUA.js +0 -44
  129. package/dist/chunk-3NZCU6SD.js +0 -125
  130. package/dist/chunk-3NZCU6SD.js.map +0 -1
  131. package/dist/chunk-6JKD46OJ.js.map +0 -1
  132. package/dist/chunk-BRAVLUGI.js.map +0 -1
  133. package/dist/chunk-ELVDOTU7.js.map +0 -1
  134. package/dist/chunk-FKSAUOJU.js.map +0 -1
  135. package/dist/chunk-GCGMXA2O.js.map +0 -1
  136. package/dist/chunk-IGHSLJUF.js.map +0 -1
  137. package/dist/chunk-IKAJSA7E.js.map +0 -1
  138. package/dist/chunk-L4XNT3UW.js.map +0 -1
  139. package/dist/chunk-NKN4YC5C.js.map +0 -1
  140. package/dist/chunk-OC3EIDCP.js.map +0 -1
  141. package/dist/chunk-OE36HRWG.js +0 -939
  142. package/dist/chunk-OE36HRWG.js.map +0 -1
  143. package/dist/chunk-OUJDDY5L.js.map +0 -1
  144. package/dist/chunk-OWVVI4VQ.js.map +0 -1
  145. package/dist/chunk-OXUJ3FXU.js.map +0 -1
  146. package/dist/chunk-PAOVPSP6.js.map +0 -1
  147. package/dist/chunk-SPUORKD7.js.map +0 -1
  148. package/dist/chunk-TXVC46SA.js.map +0 -1
  149. package/dist/chunk-UUARTUY2.js.map +0 -1
  150. package/dist/chunk-WVHPGQH5.js.map +0 -1
  151. package/dist/chunk-XXY77EZJ.js.map +0 -1
  152. package/dist/chunk-YMUJZWHB.js.map +0 -1
  153. package/dist/chunk-ZQIQ55KK.js +0 -51
  154. package/dist/chunk-ZQIQ55KK.js.map +0 -1
  155. package/dist/config-CNK7MYUR.js +0 -26
  156. package/dist/doctor-R7N7FUX5.js +0 -27
  157. package/dist/edit-QSUEG7CL.js +0 -38
  158. package/dist/inspect-NFNAA4LA.js +0 -35
  159. package/dist/install-YQVM3SUW.js.map +0 -1
  160. package/dist/outcome-IUSYFJTN.js +0 -22
  161. package/dist/publish-O2I6IAEL.js +0 -40
  162. package/dist/search-JVOHEF3E.js +0 -23
  163. package/dist/skill-heal-BPFT22XS.js.map +0 -1
  164. package/dist/uninstall-7ZZG6WQ5.js.map +0 -1
  165. package/dist/update-FPSBITLB.js.map +0 -1
  166. /package/dist/{buy-X4VPHFUA.js.map → buy-VIRNSYGN.js.map} +0 -0
  167. /package/dist/{chunk-47YKYDOF.js.map → chunk-CAR6FHK6.js.map} +0 -0
  168. /package/dist/{chunk-JVBMPU5G.js.map → chunk-CPCX67TI.js.map} +0 -0
  169. /package/dist/{chunk-XGZ5EVMB.js.map → chunk-EDZSNPE5.js.map} +0 -0
  170. /package/dist/{chunk-736DW4V3.js.map → chunk-EFWZPUTC.js.map} +0 -0
  171. /package/dist/{chunk-IAR25V2E.js.map → chunk-US456VUI.js.map} +0 -0
  172. /package/dist/{config-CNK7MYUR.js.map → config-JMRUNYE6.js.map} +0 -0
  173. /package/dist/{doctor-R7N7FUX5.js.map → doctor-ZBG7X66D.js.map} +0 -0
  174. /package/dist/{edit-QSUEG7CL.js.map → edit-PZJIILQE.js.map} +0 -0
  175. /package/dist/{fund-JF6A76YS.js.map → fund-EUDH5KPA.js.map} +0 -0
  176. /package/dist/{inspect-NFNAA4LA.js.map → inspect-QC6WEQPN.js.map} +0 -0
  177. /package/dist/{outcome-IUSYFJTN.js.map → outcome-KSGWZHUS.js.map} +0 -0
  178. /package/dist/{publish-O2I6IAEL.js.map → publish-LXWFDIKF.js.map} +0 -0
  179. /package/dist/{search-JVOHEF3E.js.map → search-TSQAB45E.js.map} +0 -0
  180. /package/dist/{send-SI254H3R.js.map → send-G746D7PQ.js.map} +0 -0
  181. /package/dist/{wallet-NS7TYWNN.js.map → skill-placement-RIU4AMC2.js.map} +0 -0
  182. /package/dist/{wallet-TZVD2M4I.js.map → wallet-TQ7D5EQ7.js.map} +0 -0
@@ -1,125 +0,0 @@
1
- import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
- import {
3
- latestSearch,
4
- loadSearches,
5
- markSearchResolved
6
- } from "./chunk-BRAVLUGI.js";
7
- import {
8
- buildOutcomeItem,
9
- postOutcomes
10
- } from "./chunk-NKN4YC5C.js";
11
- import {
12
- sanitizeForTerminal
13
- } from "./chunk-B676GPS2.js";
14
- import {
15
- resolveContextSettings
16
- } from "./chunk-IGHSLJUF.js";
17
- import {
18
- isPaidPrice
19
- } from "./chunk-736DW4V3.js";
20
- import {
21
- CliError
22
- } from "./chunk-PAOVPSP6.js";
23
-
24
- // src/commands/outcome.ts
25
- async function runOutcome(args, ctx, deps = {}) {
26
- const target = await resolveTarget(args, ctx);
27
- const item = buildOutcomeItem({
28
- status: args.status,
29
- ...args.resource !== void 0 ? { resourceId: args.resource } : {},
30
- ...args.contentHash !== void 0 ? { contentHash: args.contentHash } : {}
31
- });
32
- if (target.stored !== null) assertOutcomeCoherent(item.status, target.stored, item.resourceId);
33
- const { searchId } = target;
34
- const question = target.stored !== null ? echoQuestion(target.stored.question) : void 0;
35
- const settings = await resolveContextSettings(ctx);
36
- const result = await postOutcomes(searchId, [item], {
37
- baseUrl: settings.baseUrl,
38
- timeoutMs: ctx.flags.timeout,
39
- ...deps.fetchImpl !== void 0 ? { fetchImpl: deps.fetchImpl } : {}
40
- });
41
- await markSearchResolved(ctx.dataDir, searchId, "outcome");
42
- return {
43
- data: {
44
- searchId,
45
- status: item.status,
46
- accepted: result.accepted,
47
- ...question !== void 0 ? { question } : {}
48
- },
49
- humanLines: [
50
- `Reported ${item.status} for search ${searchId}${question !== void 0 ? ` "${sanitizeForTerminal(question)}"` : ""} (accepted ${result.accepted}).`
51
- ]
52
- };
53
- }
54
- async function resolveTarget(args, ctx) {
55
- if (args.searchId !== void 0 && args.last === true) {
56
- throw new CliError("USAGE", "Pass either --search-id or --last, not both.", {
57
- fix: "Use --search-id <id> for a specific search, or --last for the most recent."
58
- });
59
- }
60
- if (args.searchId !== void 0) {
61
- const searches = await loadSearches(ctx.dataDir);
62
- return {
63
- searchId: args.searchId,
64
- stored: searches.find((s) => s.searchId === args.searchId) ?? null
65
- };
66
- }
67
- if (args.last === true) {
68
- const latest = await latestSearch(ctx.dataDir);
69
- if (latest === null) {
70
- throw new CliError("SEARCH_NOT_FOUND", "No local search to target with --last.", {
71
- fix: "Run `tenjin search` first, or pass --search-id <id>."
72
- });
73
- }
74
- return { searchId: latest.searchId, stored: latest };
75
- }
76
- throw new CliError("USAGE", "An outcome needs a search to report against.", {
77
- fix: "Pass --search-id <id> or --last."
78
- });
79
- }
80
- var QUESTION_ECHO_MAX = 80;
81
- function echoQuestion(question) {
82
- return question.length > QUESTION_ECHO_MAX ? `${question.slice(0, QUESTION_ECHO_MAX - 1)}\u2026` : question;
83
- }
84
- function assertOutcomeCoherent(status, stored, resourceId) {
85
- const named = resourceId !== void 0 ? stored.candidates.find((c) => c.resourceId === resourceId) : void 0;
86
- if (resourceId !== void 0 && named === void 0 && stored.decision === "CANDIDATES") {
87
- throw new CliError(
88
- "USAGE",
89
- `Search ${stored.searchId} "${echoQuestion(stored.question)}" surfaced no candidate ${resourceId}, so an outcome naming it would not be recorded.`,
90
- {
91
- fix: "Pass a resourceId from this search, or drop --resource to report on the search as a whole."
92
- }
93
- );
94
- }
95
- if (status !== "purchase_declined") return;
96
- if (named !== void 0) {
97
- if (isPaidPrice(named.price) !== false) return;
98
- throw new CliError(
99
- "USAGE",
100
- `Search ${stored.searchId} "${echoQuestion(stored.question)}" listed ${resourceId} at no cost, so purchase_declined cannot describe it.`,
101
- {
102
- fix: "A free piece is reported as used, partially_used, rejected or regenerated; pass the --resource you actually declined to buy."
103
- }
104
- );
105
- }
106
- if (offeredSomethingToBuy(stored) !== false) return;
107
- throw new CliError(
108
- "USAGE",
109
- `Search ${stored.searchId} "${echoQuestion(stored.question)}" was a ${stored.decision} that offered nothing to buy, so purchase_declined cannot describe it.`,
110
- {
111
- fix: "Report used, partially_used, rejected or regenerated for this search, or pass --search-id <id> for the search you meant to report against."
112
- }
113
- );
114
- }
115
- function offeredSomethingToBuy(stored) {
116
- if (stored.candidates.some((c) => isPaidPrice(c.price) === true)) return true;
117
- if (stored.candidates.some((c) => isPaidPrice(c.price) === null)) return null;
118
- if (stored.paidBrowseCount === void 0) return null;
119
- return stored.paidBrowseCount > 0;
120
- }
121
-
122
- export {
123
- runOutcome
124
- };
125
- //# sourceMappingURL=chunk-3NZCU6SD.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/outcome.ts"],"sourcesContent":["import { CliError } from '../lib/errors';\nimport { resolveContextSettings } from '../lib/settings';\nimport { buildOutcomeItem, postOutcomes } from '../lib/agent-api';\nimport {\n latestSearch,\n loadSearches,\n markSearchResolved,\n type StoredSearch,\n} from '../lib/search-store';\nimport { isPaidPrice } from '../lib/money';\nimport { sanitizeForTerminal } from '../lib/output';\nimport type { CommandContext, CommandResult } from '../context';\n\n/**\n * `tenjin outcome --search-id <id> --status <s>`, POST to\n * /api/searches/:id/outcomes, closing the reuse loop (used / partially_used\n * / rejected / regenerated / purchase_declined). The searchId is the capability,\n * so no wallet is needed; `--last` sugar targets the most recent DELIBERATE\n * search — entries the WebSearch hook rode along with are skipped, or every web\n * search in auto mode would silently re-aim the report (a hook entry is reached\n * by explicit --search-id, which is what the Stop hook's reminder names).\n *\n * `--last` binds to whatever search ran most recently, which in a multi-search\n * session is often not the one the agent means (issue #100). Two guards, both\n * local: the targeted search's question is echoed back in the success line and in\n * the machine data, so a misfire is visible in the same breath as the report; and\n * an outcome that could not describe that search, whether by its status or by\n * naming a resource the search never surfaced, is refused before the request.\n */\n\nexport interface OutcomeArgs {\n searchId?: string;\n last?: boolean;\n status: string;\n resource?: string;\n contentHash?: string;\n}\n\nexport interface OutcomeDeps {\n fetchImpl?: typeof fetch;\n}\n\nexport async function runOutcome(\n args: OutcomeArgs,\n ctx: CommandContext,\n deps: OutcomeDeps = {},\n): Promise<CommandResult> {\n const target = await resolveTarget(args, ctx);\n // Status name first, so an unknown status still fails as an unknown status\n // rather than as an incoherent one.\n const item = buildOutcomeItem({\n status: args.status,\n ...(args.resource !== undefined ? { resourceId: args.resource } : {}),\n ...(args.contentHash !== undefined ? { contentHash: args.contentHash } : {}),\n });\n if (target.stored !== null) assertOutcomeCoherent(item.status, target.stored, item.resourceId);\n const { searchId } = target;\n const question = target.stored !== null ? echoQuestion(target.stored.question) : undefined;\n\n const settings = await resolveContextSettings(ctx);\n const result = await postOutcomes(searchId, [item], {\n baseUrl: settings.baseUrl,\n timeoutMs: ctx.flags.timeout,\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n });\n\n // The loop is closed, so the Stop hook has nothing left to raise about it.\n // AFTER the post, so a refused or failed report leaves the loop open. Local\n // bookkeeping only, and it never throws: see markSearchResolved.\n await markSearchResolved(ctx.dataDir, searchId, 'outcome');\n\n // The question rides both renderings, so the misfire this guards against is\n // visible whether a human is reading the line or an agent is reading the JSON.\n // Sanitized on the human line only: the envelope is machine data and keeps the\n // bytes it was given (see output.ts).\n return {\n data: {\n searchId,\n status: item.status,\n accepted: result.accepted,\n ...(question !== undefined ? { question } : {}),\n },\n humanLines: [\n `Reported ${item.status} for search ${searchId}${\n question !== undefined ? ` \"${sanitizeForTerminal(question)}\"` : ''\n } (accepted ${result.accepted}).`,\n ],\n };\n}\n\n/** The search this report will land on, plus the local record of it when there is\n * one. `stored` is null for a `--search-id` from another machine or an evicted\n * entry: unknown, so neither echoed nor checked. */\ninterface OutcomeTarget {\n searchId: string;\n stored: StoredSearch | null;\n}\n\nasync function resolveTarget(args: OutcomeArgs, ctx: CommandContext): Promise<OutcomeTarget> {\n if (args.searchId !== undefined && args.last === true) {\n throw new CliError('USAGE', 'Pass either --search-id or --last, not both.', {\n fix: 'Use --search-id <id> for a specific search, or --last for the most recent.',\n });\n }\n if (args.searchId !== undefined) {\n const searches = await loadSearches(ctx.dataDir);\n return {\n searchId: args.searchId,\n stored: searches.find((s) => s.searchId === args.searchId) ?? null,\n };\n }\n if (args.last === true) {\n const latest = await latestSearch(ctx.dataDir);\n if (latest === null) {\n throw new CliError('SEARCH_NOT_FOUND', 'No local search to target with --last.', {\n fix: 'Run `tenjin search` first, or pass --search-id <id>.',\n });\n }\n return { searchId: latest.searchId, stored: latest };\n }\n throw new CliError('USAGE', 'An outcome needs a search to report against.', {\n fix: 'Pass --search-id <id> or --last.',\n });\n}\n\n/** Long enough to tell two searches apart on one line, short enough not to bury\n * the searchId next to it. The ellipsis is part of the echo: a question cut with\n * no marker reads as a shorter question that was never asked. */\nconst QUESTION_ECHO_MAX = 80;\n\nfunction echoQuestion(question: string): string {\n return question.length > QUESTION_ECHO_MAX\n ? `${question.slice(0, QUESTION_ECHO_MAX - 1)}…`\n : question;\n}\n\n/**\n * Refuse an outcome that could not describe the search it is aimed at. Two\n * independent checks, because they answer to different rules.\n *\n * MEMBERSHIP, for any status that names a `--resource`: the id has to be one this\n * search surfaced. On a CANDIDATES decision that is provable, since browse\n * pointers are MISS-only by contract AND truncateResponse deletes the array\n * outright on CANDIDATES rather than trust the server, so `candidates` is the\n * entire payable set the agent was shown and `search` records all of it. A uuid\n * outside it is a typo or another search's, and the server drops the item behind\n * its 202 (tenjin#641) whatever the status says, leaving the CLI to report\n * success for an outcome nobody stored. A MISS keeps the fail-open: its browse\n * tail is payable and deliberately unrecorded, so an absent id there is\n * unknowable rather than wrong. So does any other decision value.\n *\n * PAYABILITY, for `purchase_declined` alone. The status matrix is deliberately\n * one-sided: four of the five describe ANY search, so only this one has a\n * precondition.\n *\n * used, partially_used always. A MISS's browse tail is readable, and a free\n * piece is used without any purchase, so \"used\" on a\n * MISS, or on a free candidate, is a real report and not\n * a mistake (issue #100).\n * rejected, regenerated always. \"Nothing here helped, I wrote it myself\" is\n * exactly what a MISS deserves to record.\n * purchase_declined needs the search to have offered something to buy, or,\n * when `--resource` names a candidate the store knows,\n * needs THAT candidate to have cost money. Declining a\n * purchase nobody offered cannot have happened, and that\n * is the shape the dogfooding misfire took: a\n * purchase_declined aimed at a bare MISS.\n *\n * Local knowledge only, and fail-open by construction: an unknown is never a\n * refusal. The server owns the checks this cannot make.\n */\nfunction assertOutcomeCoherent(status: string, stored: StoredSearch, resourceId?: string): void {\n const named =\n resourceId !== undefined\n ? stored.candidates.find((c) => c.resourceId === resourceId)\n : undefined;\n\n if (resourceId !== undefined && named === undefined && stored.decision === 'CANDIDATES') {\n throw new CliError(\n 'USAGE',\n `Search ${stored.searchId} \"${echoQuestion(stored.question)}\" surfaced no candidate ${resourceId}, so an outcome naming it would not be recorded.`,\n {\n fix: 'Pass a resourceId from this search, or drop --resource to report on the search as a whole.',\n },\n );\n }\n\n if (status !== 'purchase_declined') return;\n\n // A named candidate the store knows answers for itself. A piece that was free\n // is not made purchasable by a paid sibling in the same result, so the specific\n // claim is checked against the specific price rather than the search's total.\n if (named !== undefined) {\n if (isPaidPrice(named.price) !== false) return;\n throw new CliError(\n 'USAGE',\n `Search ${stored.searchId} \"${echoQuestion(stored.question)}\" listed ${resourceId} at no cost, so purchase_declined cannot describe it.`,\n {\n fix: 'A free piece is reported as used, partially_used, rejected or regenerated; pass the --resource you actually declined to buy.',\n },\n );\n }\n\n if (offeredSomethingToBuy(stored) !== false) return;\n throw new CliError(\n 'USAGE',\n `Search ${stored.searchId} \"${echoQuestion(stored.question)}\" was a ${stored.decision} that offered nothing to buy, so purchase_declined cannot describe it.`,\n {\n fix: 'Report used, partially_used, rejected or regenerated for this search, or pass --search-id <id> for the search you meant to report against.',\n },\n );\n}\n\n/**\n * Whether the search put anything payable in front of the agent. Priced at zero\n * does not count: `read` delivers a free piece with no payment, so a result that\n * was free end to end offered no purchase to decline, however many rows it had.\n * Null when the stored entry cannot say: it predates `paidBrowseCount`, so an\n * all-free candidate list might still have sat above a payable browse tail.\n */\nfunction offeredSomethingToBuy(stored: StoredSearch): boolean | null {\n if (stored.candidates.some((c) => isPaidPrice(c.price) === true)) return true;\n // A price the store cannot parse is not evidence that the result was free.\n if (stored.candidates.some((c) => isPaidPrice(c.price) === null)) return null;\n if (stored.paidBrowseCount === undefined) return null;\n return stored.paidBrowseCount > 0;\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/lib/open-url.ts","../src/commands/fund.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\n\n/**\n * Open a URL in the platform's default browser, best-effort. Follows the\n * passphrase.ts subprocess rules: an argv array (never a shell), a hard\n * timeout, and failure as a return value rather than a throw — callers print\n * the URL first, so a machine without an opener degrades to copy/paste.\n * Windows uses rundll32's FileProtocolHandler because `start` exists only\n * inside cmd.exe, and spawning a shell around an attacker-influenced string is\n * the injection shape this module exists to avoid.\n */\n\nexport interface OpenUrlOptions {\n platform?: NodeJS.Platform;\n execFileImpl?: typeof execFile;\n}\n\nconst OPEN_TIMEOUT_MS = 5000;\n\nexport function openerFor(platform: NodeJS.Platform): { cmd: string; args: string[] } {\n if (platform === 'darwin') return { cmd: 'open', args: [] };\n if (platform === 'win32') return { cmd: 'rundll32', args: ['url.dll,FileProtocolHandler'] };\n return { cmd: 'xdg-open', args: [] };\n}\n\nexport async function openInBrowser(url: string, opts: OpenUrlOptions = {}): Promise<boolean> {\n const { cmd, args } = openerFor(opts.platform ?? process.platform);\n const run = opts.execFileImpl ?? execFile;\n return await new Promise((resolve) => {\n run(cmd, [...args, url], { timeout: OPEN_TIMEOUT_MS, windowsHide: true }, (err) =>\n resolve(err === null),\n );\n });\n}\n","import { getAddress, isAddress } from 'viem';\nimport { CliError } from '../lib/errors';\nimport { loadRawConfig, resolveSettings } from '../lib/config';\nimport { httpRequest, fetchFailureToCliError, type HttpRequestOptions } from '../lib/http';\nimport { buildSiwxHeader, SIWX_HEADER } from '../lib/siwx';\nimport { SESSION_CHAIN_ID } from '../lib/session-key';\nimport {\n describeWallet,\n resolveWalletProvider,\n type ResolveWalletProviderOptions,\n} from '../lib/wallet';\nimport { getUsdcBalance } from '../lib/usdc';\nimport { toMoney } from '../lib/money';\nimport { emitNotice, emitWriteNotice } from '../lib/output';\nimport { openInBrowser } from '../lib/open-url';\nimport type { CommandContext, CommandResult } from '../context';\n\n/*\n * `tenjin fund`: card-fund THIS wallet via Coinbase Onramp. The CLI signs a\n * SIWX proof with the wallet's own key and asks the Tenjin backend to mint a\n * Coinbase-hosted checkout URL for that same address (the server refuses any\n * other address, per Coinbase's onboarding-verified auth model). The money\n * moves entirely on Coinbase's side; the minted session grants no spending\n * power over the wallet. Two Coinbase properties shape the UX here: the URL is\n * single-use and expires in ~5 minutes (mint fresh per run, open immediately,\n * never persist), and it is bound to this machine's public IP at mint time, so\n * it must be opened in a browser on this machine/network.\n */\n\n/** The only host a minted checkout URL may point at; anything else is refused unopened. */\nconst CHECKOUT_HOST = 'pay.coinbase.com';\n/**\n * fund talks to production, full stop (owner decision, 2026-08-12): the mint\n * signs with the wallet key, so this path takes no override -- not `--base-url`,\n * not the env, not config. Cutting the surface entirely is what lets the verb\n * sit in the free allowlist tier with nothing to caveat.\n */\nconst FUND_ORIGIN = 'https://tenjin.blog';\n/** Matches the server's presetAmount bound (app/api/cdp/session bodySchema). */\nconst MAX_PRESET_USD = 100_000;\nconst POLL_INTERVAL_MS = 5_000;\nconst POLL_TIMEOUT_MS = 600_000;\n\n/**\n * Why the run is not reporting an arrival, kept distinct in the envelope because\n * three different outcomes otherwise collapse into `funded: false`: the run never\n * waited, it wanted to but could not read a baseline balance, or it waited and\n * the deadline won. Only `timed-out` says anything about the purchase.\n */\nexport type FundPollStatus = 'skipped' | 'unavailable' | 'timed-out' | 'arrived';\n\nexport interface FundOptions extends ResolveWalletProviderOptions {\n /** Optional USD preset forwarded to Coinbase (clamped upward to its own floor there). */\n amountUsd?: string;\n /** Skip the browser open (still prints the URL). */\n open?: boolean;\n /** Poll the balance after issuing the link. Defaults to ON at a TTY, OFF otherwise. */\n wait?: boolean;\n fetchImpl?: typeof fetch;\n openUrl?: typeof openInBrowser;\n /** Poll seams so tests never sleep for real. */\n sleep?: (ms: number) => Promise<void>;\n pollIntervalMs?: number;\n pollTimeoutMs?: number;\n}\n\nexport async function runFund(ctx: CommandContext, opts: FundOptions = {}): Promise<CommandResult> {\n const preset = parsePreset(opts.amountUsd);\n\n const provider = resolveWalletProvider(ctx, opts);\n const desc = await describeWallet(provider);\n const address = checksummed(desc.address);\n const signer = await provider.getSigner();\n\n const config = await loadRawConfig(ctx.dataDir);\n const settings = resolveSettings({ config, flags: {}, env: process.env });\n const baseUrl = FUND_ORIGIN;\n const rpcUrl = settings.rpcUrl.value;\n\n // Waiting is an INTERACTIVE posture: a human is standing at the terminal with\n // a browser open. Piped, --json, and MCP runs default to not waiting, because\n // the envelope carrying the link is written only after runFund returns, and a\n // link that expires in ~5 minutes is worthless after a 10-minute poll.\n const shouldWait = opts.wait ?? ctx.io.isTTY;\n\n // Read the balance BEFORE minting so the poll has a baseline; an RPC flake\n // here only disables the wait, it never blocks funding.\n const startBalance = shouldWait ? await balanceOrUndefined(desc, rpcUrl) : undefined;\n\n const siwxHeader = await buildSiwxHeader(signer, { baseUrl, chainId: SESSION_CHAIN_ID });\n const request: HttpRequestOptions = {\n method: 'POST',\n timeoutMs: ctx.flags.timeout,\n headers: { [SIWX_HEADER]: siwxHeader },\n jsonBody: {\n mode: 'onramp',\n address,\n ...(preset !== undefined ? { presetAmount: preset } : {}),\n },\n ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),\n };\n const res = await httpRequest(`${baseUrl}/api/cdp/session`, request);\n if (!res.ok) {\n throw fetchFailureToCliError(res, {\n fix: 'Check your network, then retry.',\n });\n }\n const url = checkoutUrlFrom(res.status, res.json);\n\n // The link goes out on EVERY surface and before any waiting: it is single-use\n // with a ~5 minute expiry, and the stdout envelope that also carries it is\n // written only after this function returns. A piped or agent-driven run is\n // exactly the case that must not get the link after it has died, so these\n // three lines are write-notices (stderr, no TTY gate, no --json gate) rather\n // than human-mode notices. stdout stays exactly one JSON object.\n emitWriteNotice(ctx.io, `Coinbase Onramp checkout for ${address}:`);\n emitWriteNotice(ctx.io, ` ${url}`);\n emitWriteNotice(\n ctx.io,\n 'The link is single-use, expires in ~5 minutes, and only works in a browser on this machine (it is bound to this network). A Coinbase account is required.',\n );\n\n let opened = false;\n if (opts.open !== false && ctx.io.isTTY) {\n opened = await (opts.openUrl ?? openInBrowser)(url);\n emitNotice(\n ctx.io,\n opened ? 'Opened in your default browser.' : 'Could not open a browser; use the link above.',\n { json: ctx.flags.json },\n );\n }\n\n const funded =\n shouldWait && startBalance !== undefined\n ? await pollForFunds(ctx, desc, rpcUrl, startBalance, opts)\n : undefined;\n if (funded !== undefined) {\n emitWriteNotice(ctx.io, 'USDC arrived - you can close the checkout tab.');\n }\n const pollStatus: FundPollStatus = !shouldWait\n ? 'skipped'\n : startBalance === undefined\n ? 'unavailable'\n : funded !== undefined\n ? 'arrived'\n : 'timed-out';\n\n const balanceAtomic = funded ?? startBalance;\n return {\n data: {\n address,\n checkoutUrl: url,\n opened,\n ...(preset !== undefined ? { presetAmount: preset } : {}),\n funded: funded !== undefined,\n pollStatus,\n ...(balanceAtomic !== undefined ? { balance: toMoney(balanceAtomic.toString()) } : {}),\n },\n humanLines:\n funded !== undefined\n ? [`Funded: balance is now ${toMoney(funded.toString()).usd} USDC on Base.`]\n : [\n 'Checkout link issued (printed above).',\n ...(pollStatus === 'unavailable'\n ? ['Could not read the balance to wait on it; the link is unaffected.']\n : []),\n 'Confirm arrival later with `tenjin wallet balance`.',\n ],\n };\n}\n\n/**\n * The route parses the destination with strict EIP-55 (`checksummedAddress`) but\n * the local wallet store accepts any casing, so an imported or hand-edited wallet\n * file would earn an unactionable 400 on a purely local condition. Normalize here\n * instead, as `send` does for its recipient.\n */\nfunction checksummed(address: string): string {\n if (!isAddress(address, { strict: false })) {\n throw new CliError(\n 'USAGE',\n `The active wallet address is not a valid EVM address: ${address}`,\n {\n fix: 'Check the wallet file, or create a fresh wallet with `tenjin wallet create`.',\n },\n );\n }\n return getAddress(address);\n}\n\nfunction parsePreset(raw: string | undefined): number | undefined {\n if (raw === undefined) return undefined;\n const n = Number(raw);\n if (!Number.isFinite(n) || n <= 0 || n > MAX_PRESET_USD) {\n throw new CliError('USAGE', `Amount must be a positive USD number up to ${MAX_PRESET_USD}.`, {\n fix: 'Example: tenjin fund 5',\n });\n }\n return n;\n}\n\n/**\n * Map the mint response to either the checkout URL or the coded refusal. The\n * URL is opened by this process, so it is validated as https on Coinbase's\n * checkout host before anything else sees it: a compromised or misconfigured\n * server must not be able to steer the user's browser anywhere else.\n */\nfunction checkoutUrlFrom(status: number, json: unknown): string {\n if (status === 200) {\n const url =\n typeof json === 'object' && json !== null ? (json as { url?: unknown }).url : undefined;\n if (typeof url === 'string') {\n let parsed: URL | undefined;\n try {\n parsed = new URL(url);\n } catch {\n parsed = undefined;\n }\n if (parsed !== undefined && parsed.protocol === 'https:' && parsed.host === CHECKOUT_HOST) {\n return url;\n }\n }\n throw new CliError(\n 'CONTRACT_MISMATCH',\n `The server's checkout URL was missing or not https://${CHECKOUT_HOST}; refusing to open it.`,\n );\n }\n const code = errorCode(json);\n if (status === 403 && code === 'region_not_supported') {\n throw new CliError('REFUSED', 'Coinbase Onramp is not available in your region.');\n }\n // A rejected proof is a local condition (\"retry\" never fixes it): the signed\n // window is clock-relative, and the domain is always the pinned production origin.\n if (status === 401) {\n throw new CliError('REFUSED', 'The funding endpoint rejected the signed proof.', {\n fix: 'Check this machine’s clock, then retry.',\n });\n }\n if (status === 429) {\n throw new CliError('RATE_LIMITED', 'The funding endpoint is rate limited right now.', {\n fix: 'Wait a minute and retry.',\n });\n }\n if (status === 503) {\n throw new CliError(\n 'API_UNREACHABLE',\n 'Production has no Coinbase Onramp configured right now.',\n {\n fix: 'Retry later.',\n },\n );\n }\n throw new CliError(\n 'API_UNREACHABLE',\n `The funding endpoint returned ${status}${code !== undefined ? ` (${code})` : ''}.`,\n { fix: 'Retry; if it persists, check the service status.' },\n );\n}\n\n/** The `error.code` of the withApi failure envelope, when the server sent one. */\nfunction errorCode(json: unknown): string | undefined {\n if (typeof json !== 'object' || json === null) return undefined;\n const err = (json as { error?: unknown }).error;\n if (typeof err !== 'object' || err === null) return undefined;\n const code = (err as { code?: unknown }).code;\n return typeof code === 'string' ? code : undefined;\n}\n\nasync function balanceOrUndefined(\n desc: { address: string },\n rpcUrl: string,\n): Promise<bigint | undefined> {\n try {\n return await getUsdcBalance(desc.address as `0x${string}`, rpcUrl);\n } catch {\n return undefined;\n }\n}\n\n/**\n * Wait for the purchased USDC to land: any balance above the pre-mint baseline\n * counts (Coinbase clamps presets, so an exact-amount check would be wrong).\n * RPC flakes mid-poll are tolerated; the deadline is the only exit besides\n * arrival, and timing out is a normal outcome (the human may still be paying),\n * not an error.\n */\nasync function pollForFunds(\n ctx: CommandContext,\n desc: { address: string },\n rpcUrl: string,\n startBalance: bigint,\n opts: FundOptions,\n): Promise<bigint | undefined> {\n const sleep =\n opts.sleep ?? ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));\n const interval = opts.pollIntervalMs ?? POLL_INTERVAL_MS;\n const deadline = Date.now() + (opts.pollTimeoutMs ?? POLL_TIMEOUT_MS);\n emitNotice(ctx.io, 'Waiting for the USDC to arrive (Ctrl-C is safe; the purchase is not).', {\n json: ctx.flags.json,\n });\n while (Date.now() < deadline) {\n await sleep(interval);\n const balance = await balanceOrUndefined(desc, rpcUrl);\n if (balance !== undefined && balance > startBalance) return balance;\n }\n return undefined;\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
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":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/lib/config.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { z } from 'zod';\nimport { CliError } from './errors';\nimport { configPath } from './paths';\nimport { HARNESS_TARGETS } from './skill-wiring';\nimport { writeFileAtomic } from './atomic-json';\n\n/** A non-negative integer string in USDC atomic units (6-decimal base). */\nconst atomicString = z.string().regex(/^\\d+$/, 'expected an atomic USDC integer string');\n\n/** The publish consent mode (B3, D38). `full-auto` is loosening-gated, below. */\nexport const PublishModeSchema = z.enum(['review', 'auto', 'full-auto']);\nexport type PublishMode = z.infer<typeof PublishModeSchema>;\n\n/**\n * Validate a publish-mode value at a command edge (`--mode`, `--publish-mode`):\n * an unrecognized value is USAGE (exit 2), never silently dropped. `flagName` is\n * woven into the message so the failing flag is named.\n */\nexport function parsePublishModeFlag(value: string, flagName: string): PublishMode {\n const parsed = PublishModeSchema.safeParse(value);\n if (parsed.success) return parsed.data;\n throw new CliError('USAGE', `Invalid ${flagName} ${JSON.stringify(value)}`, {\n fix: 'Use \"review\", \"auto\", or \"full-auto\".',\n });\n}\n\n/**\n * The publish block (B3): `mode` governs the confirm cascade a `publish` runs,\n * `defaultPrice` is the atomic USDC price a card is published at when no\n * per-publish price is given. Stored atomic like the spend keys.\n */\nconst PublishConfigSchema = z.object({\n mode: PublishModeSchema,\n defaultPrice: atomicString,\n});\n\n/**\n * What the harness WebSearch hook does when the agent is about to search the web\n * (see lib/hook-scripts.ts). `auto` asks Tenjin first and mentions a tested\n * answer when one exists, `remind` says the marketplace is there without sending\n * the query anywhere, `off` leaves the installed hook inert.\n */\nexport const SearchHookModeSchema = z.enum(['auto', 'remind', 'off']);\nexport type SearchHookMode = z.infer<typeof SearchHookModeSchema>;\n\n/**\n * Validate a search-hook mode at a command edge (`--search-hooks`), the same way\n * publish-mode values are validated: an unrecognized value is USAGE, never a\n * silent fallback to the default.\n */\nexport function parseSearchHookModeFlag(value: string, flagName: string): SearchHookMode {\n const parsed = SearchHookModeSchema.safeParse(value);\n if (parsed.success) return parsed.data;\n throw new CliError('USAGE', `Invalid ${flagName} ${JSON.stringify(value)}`, {\n fix: 'Use \"auto\", \"remind\", or \"off\".',\n });\n}\n\n/** Whether the Stop hook may raise an open loop at the end of a turn. */\nexport const StopNagModeSchema = z.enum(['on', 'off']);\nexport type StopNagMode = z.infer<typeof StopNagModeSchema>;\n\nexport function parseStopNagFlag(value: string, flagName: string): StopNagMode {\n const parsed = StopNagModeSchema.safeParse(value);\n if (parsed.success) return parsed.data;\n throw new CliError('USAGE', `Invalid ${flagName} ${JSON.stringify(value)}`, {\n fix: 'Use \"on\" or \"off\".',\n });\n}\n\n/**\n * The harness-hook block. BOTH keys are read by the installed scripts at run\n * time, which is what makes them runtime toggles rather than install-time\n * choices: `tenjin config set hooks.searchMode off` or `hooks.stopNag off`\n * silences a hook immediately, with no re-install and nothing to unwire. The\n * scripts stay registered and no-op, which is also what lets turning one back on\n * be a single `config set`.\n */\nconst HooksConfigSchema = z.object({\n searchMode: SearchHookModeSchema,\n stopNag: StopNagModeSchema,\n});\n\n/**\n * What the daily update check is allowed to do about a newer version.\n *\n * `nudge` reports it — one dim line for a human at a terminal, and an\n * `updateAvailable` field on the JSON envelope for everyone else, which is how\n * an agent learns to run `tenjin update` itself. `off` reports neither and stops\n * asking npm entirely.\n *\n * There is deliberately no mode that installs on its own. Replacing the binary\n * under a running agent has no safe moment in a CLI that starts a fresh process\n * per invocation: \"next start\" IS \"mid-session\". Reporting is the part that was\n * missing, so reporting is what this key controls.\n */\nexport const UpdateModeSchema = z.enum(['nudge', 'off']);\nexport type UpdateMode = z.infer<typeof UpdateModeSchema>;\n\nconst UpdateConfigSchema = z.object({\n mode: UpdateModeSchema,\n});\n\nexport function parseUpdateModeFlag(value: string, flagName: string): UpdateMode {\n const parsed = UpdateModeSchema.safeParse(value);\n if (parsed.success) return parsed.data;\n throw new CliError('USAGE', `Invalid ${flagName} ${JSON.stringify(value)}`, {\n fix: 'Use \"nudge\" or \"off\".',\n });\n}\n\n/**\n * What `install` recorded about its OWN targets. `harness` is the explicit\n * `--harness` set of the last install that passed the flag, and it exists so\n * `doctor` keeps judging a directory the user named by hand: detection cannot see a\n * harness this CLI does not probe for, and without the record such a directory is a\n * target for one run and invisible to every later check. Written by `install`, not a\n * `config set` key.\n */\nconst InstallConfigSchema = z.object({\n harness: z.array(z.enum(HARNESS_TARGETS)),\n});\n\n/**\n * The persisted config shape. Spend keys are stored atomic (accepted as decimal\n * USD at the command edge, see lib/money); `confirm` is the stored form\n * \"always\" | \"above:<atomic>\". These are client-enforced guardrails, not a\n * security boundary — any process that runs the CLI can also edit this file.\n */\nexport const ConfigSchema = z.object({\n maxAutoSpend: atomicString,\n sessionBudget: atomicString,\n confirm: z.union([z.literal('always'), z.string().regex(/^above:\\d+$/)]),\n /**\n * Hard per-send cap for `tenjin send`, NOT satisfiable by --yes or a prompt\n * (the spend-policy posture): an atomic amount caps each send, \"0\" disables\n * the verb entirely, and \"none\" = explicitly uncapped (send exists to drain\n * the wallet, but uncapped is an opt-in, never a default). The key has NO\n * usable default: absent from config.json, `tenjin send` refuses until it is\n * set (see resolveSendMaxAmount). Client-enforced like every spend key (see\n * the note above).\n */\n sendMaxAmount: z.union([z.literal('none'), atomicString]),\n allowlistCreators: z.array(z.string()),\n baseUrl: z.url(),\n rpcUrl: z.url(),\n /**\n * Evaluation-cohort opt-in (spec 09 §3): when true, search sends\n * X-Tenjin-Eval-Cohort: 1 and the server stores the generalized question for\n * 90 days. Off by default; no query text is retained server-side without it.\n */\n evalCohort: z.boolean(),\n publish: PublishConfigSchema,\n install: InstallConfigSchema,\n hooks: HooksConfigSchema,\n update: UpdateConfigSchema,\n});\nexport type Config = z.infer<typeof ConfigSchema>;\n\n/**\n * Values as they may appear in config.json — every known key optional; absent =\n * default. `.passthrough()` PRESERVES unknown keys through load + persist: without\n * it an older binary's `config set` would strip (and re-serialize away) any newer\n * block a later CLI wrote, e.g. B3's `publish.*`. Known keys are still validated;\n * unknown keys ride along untouched.\n */\nexport const RawConfigSchema = ConfigSchema.partial()\n // The publish block is itself partial + passthrough: `config set publish.mode`\n // writes only the one subkey, and a subkey a newer CLI adds (e.g. publish.*\n // beyond mode/defaultPrice) survives an older binary's set, same reason the\n // outer object passes unknown keys through.\n .extend({\n publish: PublishConfigSchema.partial().passthrough().optional(),\n install: InstallConfigSchema.partial().passthrough().optional(),\n hooks: HooksConfigSchema.partial().passthrough().optional(),\n update: UpdateConfigSchema.partial().passthrough().optional(),\n })\n .passthrough();\nexport type PartialConfig = z.infer<typeof RawConfigSchema>;\n\n/**\n * The resolved-view sentinel for an absent sendMaxAmount. Never a persistable\n * value (ConfigSchema rejects it, and `config set` has no way to produce it);\n * while the resolved value is this sentinel, `tenjin send` refuses —\n * require-set-before-first-send.\n */\nexport const SEND_MAX_UNSET = 'unset';\n\nexport const CONFIG_DEFAULTS: Config = {\n maxAutoSpend: '0',\n sessionBudget: '0',\n confirm: 'always',\n // A type placeholder only, never honored: Config requires every key (and\n // CONFIG_KEYS derives from these). resolveSendMaxAmount never reads it — an\n // absent key resolves to SEND_MAX_UNSET and `tenjin send` refuses until the\n // cap is set. '0' (send disabled) rather than 'none' (uncapped) so that if a\n // future caller ever DOES read the cap through loadConfig/fileOrDefault, the\n // leak fails closed instead of silently running uncapped.\n sendMaxAmount: '0',\n allowlistCreators: [],\n baseUrl: 'https://tenjin.blog',\n rpcUrl: 'https://mainnet.base.org',\n evalCohort: false,\n publish: { mode: 'review', defaultPrice: '100000' },\n install: { harness: [] },\n // `auto` is the default because the hook exists to be useful without being\n // asked for; the disclosure and the undo ride the install output, and `off`\n // leaves the installed script inert without touching settings.json.\n hooks: { searchMode: 'auto', stopNag: 'on' },\n update: { mode: 'nudge' },\n};\n\n/**\n * Scalar keys `config get/set/list` render one line each. The nested blocks are\n * excluded: `publish` and `hooks` are addressed by their dotted keys (see\n * PUBLISH_CONFIG_KEYS / HOOKS_CONFIG_KEYS), and `install` is a record `install`\n * writes about itself rather than a setting to hand-edit, so none is ever a bare\n * scalar.\n */\nexport type ScalarConfigKey = Exclude<keyof Config, 'publish' | 'install' | 'hooks' | 'update'>;\nconst NESTED_CONFIG_KEYS: ReadonlySet<string> = new Set(['publish', 'install', 'hooks', 'update']);\nexport const CONFIG_KEYS = (Object.keys(CONFIG_DEFAULTS) as Array<keyof Config>).filter(\n (key): key is ScalarConfigKey => !NESTED_CONFIG_KEYS.has(key),\n);\n\n/** The dotted keys `config get/set` accept for the nested publish block. */\nexport const PUBLISH_CONFIG_KEYS = ['publish.mode', 'publish.defaultPrice'] as const;\nexport type PublishConfigKey = (typeof PUBLISH_CONFIG_KEYS)[number];\n\n/** The dotted keys `config get/set` accept for the nested hooks block. */\nexport const HOOKS_CONFIG_KEYS = ['hooks.searchMode', 'hooks.stopNag'] as const;\nexport type HooksConfigKey = (typeof HOOKS_CONFIG_KEYS)[number];\n\n/** The dotted key `config get/set` accepts for the nested update block. */\nexport const UPDATE_CONFIG_KEYS = ['update.mode'] as const;\nexport type UpdateConfigKey = (typeof UPDATE_CONFIG_KEYS)[number];\n\n/**\n * Read and validate config.json WITHOUT applying defaults, so provenance can\n * distinguish \"present in file\" from \"absent\". Missing file is fine (returns\n * {}); malformed JSON or a failed schema is CONFIG_INVALID with a fix.\n */\nexport async function loadRawConfig(dir: string): Promise<PartialConfig> {\n const path = configPath(dir);\n let raw: string;\n try {\n raw = await readFile(path, 'utf8');\n } catch (err) {\n if (isNotFound(err)) return {};\n throw new CliError('CONFIG_INVALID', `Could not read config at ${path}`, {\n fix: `Check file permissions on ${path}.`,\n cause: err,\n });\n }\n let json: unknown;\n try {\n json = JSON.parse(raw);\n } catch (err) {\n throw new CliError('CONFIG_INVALID', `Config at ${path} is not valid JSON`, {\n fix: `Fix the JSON syntax in ${path}, or delete it to restore defaults.`,\n cause: err,\n });\n }\n const parsed = RawConfigSchema.safeParse(json);\n if (!parsed.success) {\n throw new CliError('CONFIG_INVALID', `Config at ${path} is invalid`, {\n fix: `Correct the reported keys in ${path}, or delete it to restore defaults.`,\n details: parsed.error.issues,\n });\n }\n return parsed.data;\n}\n\n/** File values merged over defaults — the effective persisted config. The nested\n * publish block is merged per-subkey so a file that sets only publish.mode keeps\n * the default defaultPrice (a shallow spread would drop it). */\nexport async function loadConfig(dir: string): Promise<Config> {\n const raw = await loadRawConfig(dir);\n return {\n ...CONFIG_DEFAULTS,\n ...raw,\n publish: {\n mode: raw.publish?.mode ?? CONFIG_DEFAULTS.publish.mode,\n defaultPrice: raw.publish?.defaultPrice ?? CONFIG_DEFAULTS.publish.defaultPrice,\n },\n install: { harness: raw.install?.harness ?? CONFIG_DEFAULTS.install.harness },\n hooks: {\n searchMode: raw.hooks?.searchMode ?? CONFIG_DEFAULTS.hooks.searchMode,\n stopNag: raw.hooks?.stopNag ?? CONFIG_DEFAULTS.hooks.stopNag,\n },\n update: { mode: raw.update?.mode ?? CONFIG_DEFAULTS.update.mode },\n };\n}\n\nexport type Provenance = 'default' | 'file' | 'project' | 'env' | 'flag';\n\nexport interface ResolvedSetting<T> {\n value: T;\n source: Provenance;\n}\n\n/**\n * The per-project `.tenjin.json` layer (B3, D38): publish overrides discovered by\n * walking up from cwd, plus whether that file is gitignored. `gitignored` gates\n * `full-auto` — a committed file requesting it is downgraded (loosening gate).\n */\nexport interface ProjectPublishLayer {\n publish?: { mode?: PublishMode; defaultPrice?: string };\n gitignored: boolean;\n}\n\n/** publish.mode resolution: value, source, and the downgrade warning (if any). */\nexport interface PublishModeResolution {\n value: PublishMode;\n source: Provenance;\n /** Set when a committed `.tenjin.json`'s `full-auto` was downgraded to `auto`. */\n downgradedWarning?: string;\n}\n\n/** Effective value + where it came from, per key. What `config` (bare) renders. */\nexport interface EffectiveSettings {\n maxAutoSpend: ResolvedSetting<string>;\n sessionBudget: ResolvedSetting<string>;\n confirm: ResolvedSetting<string>;\n sendMaxAmount: ResolvedSetting<string>;\n allowlistCreators: ResolvedSetting<string[]>;\n baseUrl: ResolvedSetting<string>;\n rpcUrl: ResolvedSetting<string>;\n evalCohort: ResolvedSetting<boolean>;\n publishMode: PublishModeResolution;\n publishDefaultPrice: ResolvedSetting<string>;\n hooksSearchMode: ResolvedSetting<SearchHookMode>;\n hooksStopNag: ResolvedSetting<StopNagMode>;\n updateMode: ResolvedSetting<UpdateMode>;\n}\n\n/** CLI flags that participate in settings precedence (`--base-url`). */\nexport interface SettingsFlags {\n baseUrl?: string;\n}\n\nexport interface ResolveSettingsInput {\n /** Raw file values (present keys only) — from loadRawConfig, not loadConfig. */\n config: PartialConfig;\n flags: SettingsFlags;\n env: NodeJS.ProcessEnv;\n /** The nearest `.tenjin.json` layer, when one was found (see publish-settings). */\n project?: ProjectPublishLayer;\n}\n\n/**\n * Apply precedence flag > env > file > default per key, returning each effective\n * value with its source. In B1 only baseUrl has flag/env overrides\n * (`--base-url`, TENJIN_BASE_URL); the rest resolve file-or-default. B3 adds the\n * publish keys, which additionally fold in the per-project `.tenjin.json` layer.\n */\nexport function resolveSettings(input: ResolveSettingsInput): EffectiveSettings {\n const { config, flags, env, project } = input;\n return {\n maxAutoSpend: fileOrDefault('maxAutoSpend', config),\n sessionBudget: fileOrDefault('sessionBudget', config),\n confirm: fileOrDefault('confirm', config),\n sendMaxAmount: resolveSendMaxAmount(config),\n allowlistCreators: fileOrDefault('allowlistCreators', config),\n baseUrl: resolveBaseUrl(config, flags, env),\n rpcUrl: fileOrDefault('rpcUrl', config),\n evalCohort: fileOrDefault('evalCohort', config),\n publishMode: resolvePublishMode({ config, project, env }),\n publishDefaultPrice: resolvePublishDefaultPrice({ config, project }),\n hooksSearchMode: resolveHooksSearchMode(config),\n hooksStopNag: resolveHooksStopNag(config),\n updateMode: resolveUpdateMode(config),\n };\n}\n\n/** update.mode: file or default, no env or flag. Every surface that reports a\n * newer version reads this one resolved value, so they cannot disagree. */\nfunction resolveUpdateMode(config: PartialConfig): ResolvedSetting<UpdateMode> {\n const fromFile = config.update?.mode;\n if (fromFile !== undefined) return { value: fromFile, source: 'file' };\n return { value: CONFIG_DEFAULTS.update.mode, source: 'default' };\n}\n\n/** hooks.stopNag: file or default, same shape as hooks.searchMode. */\nfunction resolveHooksStopNag(config: PartialConfig): ResolvedSetting<StopNagMode> {\n const fromFile = config.hooks?.stopNag;\n if (fromFile !== undefined) return { value: fromFile, source: 'file' };\n return { value: CONFIG_DEFAULTS.hooks.stopNag, source: 'default' };\n}\n\n/** hooks.searchMode: file or default. No env, flag, or project layer, because the\n * installed hook script reads the global file directly and has no CLI edge. */\nfunction resolveHooksSearchMode(config: PartialConfig): ResolvedSetting<SearchHookMode> {\n const fromFile = config.hooks?.searchMode;\n if (fromFile !== undefined) return { value: fromFile, source: 'file' };\n return { value: CONFIG_DEFAULTS.hooks.searchMode, source: 'default' };\n}\n\n/**\n * The loosening gate (D38): a committed (not-gitignored) `.tenjin.json` requesting\n * `full-auto` is downgraded to `auto`, never silently honored — cloning a repo\n * must not enable auto-publish. `full-auto` from global config / env / flag (all\n * inherently local, not cloned) is always honored.\n */\nconst FULL_AUTO_DOWNGRADE_WARNING =\n 'Ignoring publish.mode \"full-auto\" from a committed .tenjin.json (cloning a repo must not enable auto-publish); using \"auto\". Add .tenjin.json to .gitignore to opt in.';\n\nfunction coercePublishMode(raw: string | undefined): PublishMode | undefined {\n if (raw === undefined || raw.length === 0) return undefined;\n const parsed = PublishModeSchema.safeParse(raw);\n return parsed.success ? parsed.data : undefined;\n}\n\n/**\n * Resolve publish.mode through global file < project `.tenjin.json` < env\n * (TENJIN_PUBLISH_MODE) < flag (`--mode`). Total: an invalid env/flag value is\n * ignored (validation lives at the command edge, like baseUrl). The project\n * layer's `full-auto` is gated on that file being gitignored.\n */\nexport function resolvePublishMode(input: {\n config: PartialConfig;\n project?: ProjectPublishLayer;\n env: NodeJS.ProcessEnv;\n flag?: string;\n}): PublishModeResolution {\n const { config, project, env, flag } = input;\n let winner: PublishModeResolution = { value: CONFIG_DEFAULTS.publish.mode, source: 'default' };\n\n const fromFile = config.publish?.mode;\n if (fromFile !== undefined) winner = { value: fromFile, source: 'file' };\n\n if (project !== undefined && project.publish?.mode !== undefined) {\n const fromProject = project.publish.mode;\n if (fromProject === 'full-auto' && !project.gitignored) {\n winner = { value: 'auto', source: 'project', downgradedWarning: FULL_AUTO_DOWNGRADE_WARNING };\n } else {\n winner = { value: fromProject, source: 'project' };\n }\n }\n\n const fromEnv = coercePublishMode(env.TENJIN_PUBLISH_MODE);\n if (fromEnv !== undefined) winner = { value: fromEnv, source: 'env' };\n\n const fromFlag = coercePublishMode(flag);\n if (fromFlag !== undefined) winner = { value: fromFlag, source: 'flag' };\n\n return winner;\n}\n\n/** Resolve publish.defaultPrice (atomic) through global file < project < default. */\nexport function resolvePublishDefaultPrice(input: {\n config: PartialConfig;\n project?: ProjectPublishLayer;\n}): ResolvedSetting<string> {\n const { config, project } = input;\n let result: ResolvedSetting<string> = {\n value: CONFIG_DEFAULTS.publish.defaultPrice,\n source: 'default',\n };\n if (config.publish?.defaultPrice !== undefined) {\n result = { value: config.publish.defaultPrice, source: 'file' };\n }\n if (project?.publish?.defaultPrice !== undefined) {\n result = { value: project.publish.defaultPrice, source: 'project' };\n }\n return result;\n}\n\n/** Persist a full, validated config via the atomic writer (0700 dir, 0644 file). */\nexport async function writeConfig(dir: string, config: Config): Promise<void> {\n const validated = ConfigSchema.parse(config);\n await writeFileAtomic(configPath(dir), `${JSON.stringify(validated, null, 2)}\\n`, {\n mode: 0o644,\n dirMode: 0o700,\n });\n}\n\n/**\n * sendMaxAmount deliberately bypasses fileOrDefault: it has no usable default\n * (the operator's require-set-before-first-send posture). Absent from\n * config.json it resolves to the SEND_MAX_UNSET sentinel with source 'default',\n * which `tenjin send` refuses outright — the cap must be set to an amount, \"0\"\n * (disable), or an explicit \"none\" (uncapped opt-in) before the first send.\n */\nfunction resolveSendMaxAmount(config: PartialConfig): ResolvedSetting<string> {\n if (config.sendMaxAmount !== undefined) return { value: config.sendMaxAmount, source: 'file' };\n return { value: SEND_MAX_UNSET, source: 'default' };\n}\n\nfunction fileOrDefault<K extends keyof Config>(\n key: K,\n config: PartialConfig,\n): ResolvedSetting<Config[K]> {\n const fromFile = config[key];\n // PartialConfig[K] is Config[K] | undefined; narrowing an indexed access of a\n // type parameter doesn't refine K, so assert the excluded-undefined type.\n if (fromFile !== undefined) return { value: fromFile as Config[K], source: 'file' };\n return { value: CONFIG_DEFAULTS[key], source: 'default' };\n}\n\nfunction resolveBaseUrl(\n config: PartialConfig,\n flags: SettingsFlags,\n env: NodeJS.ProcessEnv,\n): ResolvedSetting<string> {\n if (flags.baseUrl !== undefined && flags.baseUrl.length > 0) {\n return { value: flags.baseUrl, source: 'flag' };\n }\n const fromEnv = env.TENJIN_BASE_URL;\n if (fromEnv !== undefined && fromEnv.length > 0) {\n return { value: fromEnv, source: 'env' };\n }\n if (config.baseUrl !== undefined) return { value: config.baseUrl, source: 'file' };\n return { value: CONFIG_DEFAULTS.baseUrl, source: 'default' };\n}\n\nfunction isNotFound(err: unknown): boolean {\n return (\n typeof err === 'object' &&\n err !== null &&\n 'code' in err &&\n (err as { code?: unknown }).code === 'ENOENT'\n );\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/lib/lock.ts","../src/lib/policy.ts"],"sourcesContent":["import { mkdirSync, rmSync } from 'node:fs';\nimport { writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n/**\n * Locks this process currently holds. Ownership starts the instant `mkdir`\n * succeeds and ends when the release has removed the directory, so there is no\n * window where a lock is on disk and unaccounted for. A removal that FAILS keeps\n * the lock owned: the directory is still on disk, no successor can claim the path\n * while it exists, and a signal-time release gets another attempt. The one place\n * ownership is dropped without a successful removal is `releaseOwnedLocks`, which\n * runs only as the process exits, where a claim held by a dying process helps\n * nobody.\n *\n * It exists because the default signal action terminates WITHOUT running\n * `finally`: without this, one Ctrl-C leaves a lock nothing will ever clean and\n * every later run of the same command times out on it.\n */\nconst owned = new Set<string>();\n\n/** Does this process hold any lock right now? */\nexport function ownsAnyLock(): boolean {\n return owned.size > 0;\n}\n\n/**\n * Synchronously attempt to release every lock this process holds. BEST EFFORT: a\n * path that refuses to be removed is left on disk and the next run's timeout names\n * it. Safe to call from a signal handler, and a no-op when this process holds\n * none, so a run merely QUEUED behind another cannot remove that other run's lock.\n */\nexport function releaseOwnedLocks(): void {\n for (const path of owned) {\n // NEVER throws. This runs inside a signal handler, and a throw there is an\n // uncaught exception: the process dies with code 1 and a stack trace instead\n // of the diagnostic and exit 130 the handler promises. One lock we could not\n // remove must not cost the report, or the exit code, or the other locks.\n try {\n rmSync(path, { recursive: true, force: true });\n } catch {\n // Left behind; the next run's timeout names the path.\n }\n }\n owned.clear();\n}\n\nexport interface FileLockOptions {\n /** Give up acquiring after this long (ms). */\n timeoutMs?: number;\n /** Poll interval between acquisition attempts (ms). */\n retryMs?: number;\n /**\n * Called when the lock could not be removed on release. The protected work\n * succeeded, so this is not a failure of the command; it is a leftover that will\n * block later runs, and the caller is the only one able to say so.\n */\n onReleaseError?: (lockPath: string, err: unknown) => void;\n}\n\nconst DEFAULTS = { timeoutMs: 5000, retryMs: 25 };\n\n/** Thrown when the lock cannot be acquired within `timeoutMs`. Carries the lock\n * path so a caller can surface the manual-recovery step in its own error contract. */\nexport class LockTimeoutError extends Error {\n readonly lockPath: string;\n constructor(lockPath: string, timeoutMs: number) {\n super(\n `Timed out waiting for lock at ${lockPath} after ${timeoutMs}ms; if no other tenjin process is running, remove that directory and retry.`,\n );\n this.name = 'LockTimeoutError';\n this.lockPath = lockPath;\n }\n}\n\n/**\n * Minimal cross-process mutex: the lock IS a directory, and mkdir is atomic, so a\n * second holder gets EEXIST and retries with backoff until `timeoutMs`, then\n * throws LockTimeoutError. There is deliberately NO auto-steal of a \"stale\" lock:\n * concurrent waiters each judging a lock stale could remove a fresh holder's\n * directory and lose its update. A crashed holder's lock is recovered by hand (the\n * timeout error names the path); the pid+acquiredAt meta exists only to make that\n * manual call diagnosable. Always released in the finally.\n *\n * ⚠ MIRRORED, MUST UPDATE TOGETHER. The generated WebSearch hook script in\n * lib/hook-scripts.ts (`withStoreLock`) reimplements this protocol byte for byte,\n * because it runs as a standalone .mjs outside the CLI and cannot import this\n * module, yet writes the same searches.json. If you change what the lock IS\n * (directory vs file), where it lives, or the no-stale-steal rule, change it\n * there too. Two writers of one file that disagree about the mutex have no mutex.\n * lib/hook-scripts.test.ts pins the two together and fails loudly on drift.\n */\nexport async function withFileLock<T>(\n lockPath: string,\n fn: () => Promise<T>,\n opts: FileLockOptions = {},\n): Promise<T> {\n const { timeoutMs, retryMs } = { ...DEFAULTS, ...opts };\n const metaPath = join(lockPath, 'meta');\n const deadline = Date.now() + timeoutMs;\n for (;;) {\n try {\n // SYNCHRONOUS, for the same reason the release is: `await mkdir` finishes the\n // syscall before the continuation records ownership, so between the two the\n // directory is on disk and unclaimed. A signal there exits without removing\n // it and, with no stale recovery, nothing ever will. mkdirSync and the add\n // are one uninterruptible step.\n mkdirSync(lockPath);\n owned.add(lockPath); // owned from here, released only in the finally below\n break; // acquired\n } catch (err) {\n if (!isEexist(err)) throw err;\n if (Date.now() >= deadline) throw new LockTimeoutError(lockPath, timeoutMs);\n await delay(retryMs);\n }\n }\n await writeFile(metaPath, JSON.stringify({ pid: process.pid, acquiredAt: Date.now() })).catch(\n () => undefined,\n );\n try {\n return await fn();\n } finally {\n // SYNCHRONOUS, and in this order, because both are load-bearing. A signal\n // handler cannot run between two synchronous statements, so there is no instant\n // where the lock is on disk but unclaimed (a signal would exit without removing\n // it, and with no stale recovery nothing ever would) nor one where it is\n // claimed after release (a signal would remove whatever SUCCESSOR had since\n // acquired the path). An `await` here reopens the first window: `rm` yields, the\n // handler runs, sees no ownership, and leaves the directory behind.\n //\n // With no stealing, nothing else ever removes or replaces this directory, so\n // the lock here is provably the one we created — the unconditional rm is sound.\n try {\n rmSync(lockPath, { recursive: true, force: true });\n owned.delete(lockPath);\n } catch (err) {\n // KEEP ownership when the removal fails: the successor-steal risk only\n // exists once the directory is gone and someone else can take the path, so a\n // removal that failed leaves it on disk and still ours, and a signal-time\n // release gets another attempt. That only helps while THIS process lives,\n // though; once it exits normally the leftover blocks every later run, so the\n // caller is told rather than left to discover it as a timeout.\n opts.onReleaseError?.(lockPath, err);\n }\n }\n}\n\nfunction isEexist(err: unknown): boolean {\n return typeof err === 'object' && err !== null && (err as { code?: unknown }).code === 'EEXIST';\n}\n\nfunction delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","/**\n * Spend-policy evaluation, pure and provider-agnostic. The wallet provider layer\n * (lib/wallet/spend.ts) owns the ledger and calls this; a future hosted provider\n * (Privy, B5) reuses the same decision rules, so the knobs live in exactly one\n * place. Nothing here does IO, the caller supplies the already-spent total and\n * decides how to satisfy a `confirm` decision (a `--yes`, a TTY prompt, or a\n * non-interactive refusal).\n */\n\n/** How a `confirm` gate is configured (parsed from the stored config string). */\nexport type ConfirmPolicy = { mode: 'always' } | { mode: 'above'; thresholdAtomic: bigint };\n\nexport interface SpendPolicy {\n /** Amounts at or below this auto-approve WITHOUT a prompt (still subject to the\n * confirm gate below). Default 0 → nothing auto-approves. */\n maxAutoSpendAtomic: bigint;\n /** Rolling local ceiling on cumulative session spend. 0 = disabled (no ceiling). */\n sessionBudgetAtomic: bigint;\n /** When a human confirmation is requested. */\n confirm: ConfirmPolicy;\n /** Creators (handle or 0x-address, lowercased) auto-payment is restricted to.\n * Empty = no restriction. A non-empty list is a hard gate: a non-member is\n * denied even with `--yes`. */\n allowlistCreators: string[];\n}\n\nexport interface SpendRequest {\n amountAtomic: bigint;\n /** Creator identity from the 402 preview / candidate, handle or 0x address. */\n creator: string;\n /** The caller's `--max-price` cap, if given. A hard ceiling, never bypassable. */\n maxPriceAtomic?: bigint;\n /** Cumulative spend already recorded in this rolling session window. */\n sessionSpentAtomic: bigint;\n}\n\n/**\n * `allow`: within policy, proceed silently. `confirm`: an approval is required ,\n * the caller satisfies it with `--yes`, an interactive prompt, or refuses. `deny`:\n * a hard gate blocked it (price cap, allowlist, session budget); NOT satisfiable\n * by `--yes` or a prompt.\n */\nexport type SpendDecision = 'allow' | 'confirm' | 'deny';\n\nexport type PolicyReason =\n | 'within_policy'\n | 'price_cap_exceeded'\n | 'not_allowlisted'\n | 'session_budget_exceeded'\n | 'above_auto_spend'\n | 'confirm_always'\n | 'above_confirm_threshold';\n\nexport interface PolicyEvaluation {\n decision: SpendDecision;\n reason: PolicyReason;\n message: string;\n}\n\n/** Normalize a creator identity for allowlist comparison (case-insensitive; a\n * word-handle and a 0x address are both single tokens). */\nfunction normCreator(value: string): string {\n return value.trim().toLowerCase();\n}\n\n/**\n * Evaluate one spend against the policy. Hard gates run first (price cap →\n * allowlist → session budget); only if all pass is the confirm gate consulted. A\n * spend at or below `maxAutoSpend` that the confirm policy would not prompt for is\n * the only `allow`; everything else within the hard gates is `confirm`.\n */\nexport function evaluateSpendPolicy(policy: SpendPolicy, req: SpendRequest): PolicyEvaluation {\n if (req.maxPriceAtomic !== undefined && req.amountAtomic > req.maxPriceAtomic) {\n return {\n decision: 'deny',\n reason: 'price_cap_exceeded',\n message: `Price ${req.amountAtomic} exceeds the --max-price cap ${req.maxPriceAtomic}.`,\n };\n }\n\n if (policy.allowlistCreators.length > 0) {\n const allowed = policy.allowlistCreators.map(normCreator);\n if (!allowed.includes(normCreator(req.creator))) {\n return {\n decision: 'deny',\n reason: 'not_allowlisted',\n message: `Creator \"${req.creator}\" is not in allowlistCreators.`,\n };\n }\n }\n\n if (policy.sessionBudgetAtomic > 0n) {\n const projected = req.sessionSpentAtomic + req.amountAtomic;\n if (projected > policy.sessionBudgetAtomic) {\n return {\n decision: 'deny',\n reason: 'session_budget_exceeded',\n message: `This spend would bring the session total to ${projected}, over sessionBudget ${policy.sessionBudgetAtomic}.`,\n };\n }\n }\n\n if (req.amountAtomic > policy.maxAutoSpendAtomic) {\n return {\n decision: 'confirm',\n reason: 'above_auto_spend',\n message: `Price ${req.amountAtomic} is above maxAutoSpend ${policy.maxAutoSpendAtomic}; confirmation required.`,\n };\n }\n\n if (policy.confirm.mode === 'always') {\n return {\n decision: 'confirm',\n reason: 'confirm_always',\n message: 'confirm policy is \"always\"; confirmation required.',\n };\n }\n\n if (req.amountAtomic > policy.confirm.thresholdAtomic) {\n return {\n decision: 'confirm',\n reason: 'above_confirm_threshold',\n message: `Price ${req.amountAtomic} is above the confirm threshold ${policy.confirm.thresholdAtomic}; confirmation required.`,\n };\n }\n\n return { decision: 'allow', reason: 'within_policy', message: 'within spend policy' };\n}\n\n/** Parse the stored `confirm` config value (\"always\" | \"above:<atomic>\"). */\nexport function parseConfirmPolicy(stored: string): ConfirmPolicy {\n if (stored === 'always') return { mode: 'always' };\n const m = /^above:(\\d+)$/.exec(stored);\n if (m && m[1] !== undefined) return { mode: 'above', thresholdAtomic: BigInt(m[1]) };\n // The config schema already constrains this; a malformed value here is a bug,\n // so fail closed to the safest interpretation rather than throwing mid-buy.\n return { mode: 'always' };\n}\n"],"mappings":"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","names":[]}