tenjin-cli 0.1.0-alpha.26 → 0.1.0-alpha.28

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 (139) hide show
  1. package/README.md +9 -20
  2. package/dist/alive-3J3CHOQP.js +21 -0
  3. package/dist/{chunk-WT7DHJNJ.js → chunk-3QJREVMX.js} +5 -7
  4. package/dist/{chunk-WT7DHJNJ.js.map → chunk-3QJREVMX.js.map} +1 -1
  5. package/dist/{chunk-BOAI23CX.js → chunk-6KA4HFX5.js} +21 -15
  6. package/dist/chunk-6KA4HFX5.js.map +1 -0
  7. package/dist/chunk-6W5GYG3W.js +128 -0
  8. package/dist/chunk-6W5GYG3W.js.map +1 -0
  9. package/dist/{chunk-W36HL4TB.js → chunk-7H3RN4WJ.js} +7 -9
  10. package/dist/{chunk-W36HL4TB.js.map → chunk-7H3RN4WJ.js.map} +1 -1
  11. package/dist/{chunk-4HAV6IFE.js → chunk-7R37M6WV.js} +5 -7
  12. package/dist/{chunk-4HAV6IFE.js.map → chunk-7R37M6WV.js.map} +1 -1
  13. package/dist/{chunk-LAIZ2AQA.js → chunk-A5H3E5QA.js} +2 -2
  14. package/dist/{update-QXVH2DE7.js → chunk-AO54FM4H.js} +147 -35
  15. package/dist/chunk-AO54FM4H.js.map +1 -0
  16. package/dist/{chunk-XMIVHQ35.js → chunk-B2L53TMK.js} +17 -2
  17. package/dist/{chunk-XMIVHQ35.js.map → chunk-B2L53TMK.js.map} +1 -1
  18. package/dist/{chunk-YTM7OURD.js → chunk-BRHREK7E.js} +2 -2
  19. package/dist/{chunk-YLCWI6ZR.js → chunk-DJYAPACT.js} +79 -36
  20. package/dist/chunk-DJYAPACT.js.map +1 -0
  21. package/dist/{chunk-OBPZ36HG.js → chunk-DYSDQE7S.js} +92 -5
  22. package/dist/chunk-DYSDQE7S.js.map +1 -0
  23. package/dist/{chunk-EJXIK6WY.js → chunk-FQ6DHINU.js} +80 -48
  24. package/dist/chunk-FQ6DHINU.js.map +1 -0
  25. package/dist/chunk-FZTSGQVK.js +52 -0
  26. package/dist/chunk-FZTSGQVK.js.map +1 -0
  27. package/dist/{chunk-QF4SSCQV.js → chunk-KAMRYUK2.js} +5 -4
  28. package/dist/chunk-KAMRYUK2.js.map +1 -0
  29. package/dist/{chunk-ALJRB7NG.js → chunk-MNTQMZJB.js} +8 -8
  30. package/dist/{chunk-XICKN3CH.js → chunk-QTND6XWJ.js} +160 -80
  31. package/dist/chunk-QTND6XWJ.js.map +1 -0
  32. package/dist/chunk-RLPLYUME.js +115 -0
  33. package/dist/chunk-RLPLYUME.js.map +1 -0
  34. package/dist/{chunk-ZLD6MJVJ.js → chunk-S4SAZ7OD.js} +1 -1
  35. package/dist/chunk-S4SAZ7OD.js.map +1 -0
  36. package/dist/{chunk-5HS54CLI.js → chunk-UEOWNDQG.js} +8 -10
  37. package/dist/{chunk-5HS54CLI.js.map → chunk-UEOWNDQG.js.map} +1 -1
  38. package/dist/{chunk-5INS5ZZF.js → chunk-UOW5JXYY.js} +5 -7
  39. package/dist/{chunk-5INS5ZZF.js.map → chunk-UOW5JXYY.js.map} +1 -1
  40. package/dist/chunk-VSUHGRVB.js +1455 -0
  41. package/dist/chunk-VSUHGRVB.js.map +1 -0
  42. package/dist/{chunk-Z7R2QDX2.js → chunk-W6JX4LYF.js} +50 -7
  43. package/dist/chunk-W6JX4LYF.js.map +1 -0
  44. package/dist/{chunk-UDWGT4FX.js → chunk-XVTD7UWR.js} +14 -8
  45. package/dist/chunk-XVTD7UWR.js.map +1 -0
  46. package/dist/{chunk-6JIYGYRB.js → chunk-YFJJYHVG.js} +2 -2
  47. package/dist/{chunk-DI7WHXOZ.js → chunk-ZG6ZZLO7.js} +898 -521
  48. package/dist/chunk-ZG6ZZLO7.js.map +1 -0
  49. package/dist/{chunk-OZ3LWLCI.js → chunk-ZO3X5NPG.js} +4 -6
  50. package/dist/{chunk-OZ3LWLCI.js.map → chunk-ZO3X5NPG.js.map} +1 -1
  51. package/dist/{chunk-5NUF4BHR.js → chunk-ZP5PV3JB.js} +4 -4
  52. package/dist/{chunk-HII5HOQV.js → chunk-ZP7AHN7Z.js} +6 -6
  53. package/dist/{cli-2U5JB7OQ.js → cli-234DNHN6.js} +53 -51
  54. package/dist/{cli-2U5JB7OQ.js.map → cli-234DNHN6.js.map} +1 -1
  55. package/dist/{config-44EGO636.js → config-IY2OJCAK.js} +11 -13
  56. package/dist/{doctor-BD42BBEG.js → doctor-2UZZF44A.js} +275 -250
  57. package/dist/doctor-2UZZF44A.js.map +1 -0
  58. package/dist/{env-proxy-KEGEMWKX.js → env-proxy-XL4P73MZ.js} +2 -2
  59. package/dist/{fund-WQOOUESE.js → fund-RZ2QFULK.js} +92 -36
  60. package/dist/{fund-WQOOUESE.js.map → fund-RZ2QFULK.js.map} +1 -1
  61. package/dist/hook-command-PZHKS7ES.js +31 -0
  62. package/dist/hosts/claude/.claude-plugin/marketplace.json +19 -0
  63. package/dist/hosts/claude/tenjin/.claude-plugin/plugin.json +14 -0
  64. package/dist/hosts/claude/tenjin/.mcp.json +11 -0
  65. package/dist/hosts/claude/tenjin/hooks/hooks.json +206 -0
  66. package/dist/index.js +15 -6
  67. package/dist/index.js.map +1 -1
  68. package/dist/install-O5FJ5EP3.js +48 -0
  69. package/dist/{install-identity-4RDWTLJ2.js → install-identity-QM44IQ6Z.js} +7 -7
  70. package/dist/{install-wallet-USHWL7AX.js → install-wallet-Z52EDLPB.js} +14 -14
  71. package/dist/{mcp-T5SYCLP7.js → mcp-33HAADDF.js} +557 -118
  72. package/dist/mcp-33HAADDF.js.map +1 -0
  73. package/dist/package-RT24HTTP.js +37 -0
  74. package/dist/{pay-276DSSYG.js → pay-IR2V76FX.js} +16 -16
  75. package/dist/{payments-TZYLJXK3.js → payments-GFV4HU5R.js} +10 -10
  76. package/dist/{send-YHDKZPED.js → send-PI4NUA7I.js} +13 -13
  77. package/dist/{status-X2INT6VD.js → status-ZUHTJK46.js} +10 -9
  78. package/dist/{status-X2INT6VD.js.map → status-ZUHTJK46.js.map} +1 -1
  79. package/dist/{status-line-QKDJYZGV.js → status-line-2G5JPQAE.js} +6 -6
  80. package/dist/uninstall-THKUH5ZT.js +136 -0
  81. package/dist/uninstall-THKUH5ZT.js.map +1 -0
  82. package/dist/update-NPZDP24E.js +18 -0
  83. package/dist/update-NPZDP24E.js.map +1 -0
  84. package/dist/{wallet-CKKB23D5.js → wallet-53EFH4M5.js} +11 -11
  85. package/dist/wallet-53EFH4M5.js.map +1 -0
  86. package/docs/agent-permissions.md +32 -21
  87. package/package.json +3 -3
  88. package/dist/chunk-65EJJVT3.js +0 -172
  89. package/dist/chunk-65EJJVT3.js.map +0 -1
  90. package/dist/chunk-BOAI23CX.js.map +0 -1
  91. package/dist/chunk-DI7WHXOZ.js.map +0 -1
  92. package/dist/chunk-EJXIK6WY.js.map +0 -1
  93. package/dist/chunk-GHR4BTNJ.js +0 -87
  94. package/dist/chunk-GHR4BTNJ.js.map +0 -1
  95. package/dist/chunk-H4BOQLWW.js +0 -99
  96. package/dist/chunk-H4BOQLWW.js.map +0 -1
  97. package/dist/chunk-JLEF5WHM.js +0 -132
  98. package/dist/chunk-JLEF5WHM.js.map +0 -1
  99. package/dist/chunk-OBPZ36HG.js.map +0 -1
  100. package/dist/chunk-PM2MOXJ3.js +0 -66
  101. package/dist/chunk-PM2MOXJ3.js.map +0 -1
  102. package/dist/chunk-QF4SSCQV.js.map +0 -1
  103. package/dist/chunk-TGLKKLQG.js +0 -11
  104. package/dist/chunk-TGLKKLQG.js.map +0 -1
  105. package/dist/chunk-UDWGT4FX.js.map +0 -1
  106. package/dist/chunk-VNT3CQFV.js +0 -940
  107. package/dist/chunk-VNT3CQFV.js.map +0 -1
  108. package/dist/chunk-XICKN3CH.js.map +0 -1
  109. package/dist/chunk-YHWBDCGS.js +0 -753
  110. package/dist/chunk-YHWBDCGS.js.map +0 -1
  111. package/dist/chunk-YLCWI6ZR.js.map +0 -1
  112. package/dist/chunk-Z7R2QDX2.js.map +0 -1
  113. package/dist/chunk-ZLD6MJVJ.js.map +0 -1
  114. package/dist/doctor-BD42BBEG.js.map +0 -1
  115. package/dist/hook-command-23LC5NRN.js +0 -32
  116. package/dist/install-REPLHNU7.js +0 -72
  117. package/dist/mcp-T5SYCLP7.js.map +0 -1
  118. package/dist/status-line-wiring-LW4HFRHB.js +0 -31
  119. package/dist/uninstall-NVTGU7JD.js +0 -175
  120. package/dist/uninstall-NVTGU7JD.js.map +0 -1
  121. package/dist/update-QXVH2DE7.js.map +0 -1
  122. /package/dist/{config-44EGO636.js.map → alive-3J3CHOQP.js.map} +0 -0
  123. /package/dist/{chunk-LAIZ2AQA.js.map → chunk-A5H3E5QA.js.map} +0 -0
  124. /package/dist/{chunk-YTM7OURD.js.map → chunk-BRHREK7E.js.map} +0 -0
  125. /package/dist/{chunk-ALJRB7NG.js.map → chunk-MNTQMZJB.js.map} +0 -0
  126. /package/dist/{chunk-6JIYGYRB.js.map → chunk-YFJJYHVG.js.map} +0 -0
  127. /package/dist/{chunk-5NUF4BHR.js.map → chunk-ZP5PV3JB.js.map} +0 -0
  128. /package/dist/{chunk-HII5HOQV.js.map → chunk-ZP7AHN7Z.js.map} +0 -0
  129. /package/dist/{env-proxy-KEGEMWKX.js.map → config-IY2OJCAK.js.map} +0 -0
  130. /package/dist/{hook-command-23LC5NRN.js.map → env-proxy-XL4P73MZ.js.map} +0 -0
  131. /package/dist/{install-REPLHNU7.js.map → hook-command-PZHKS7ES.js.map} +0 -0
  132. /package/dist/{install-identity-4RDWTLJ2.js.map → install-O5FJ5EP3.js.map} +0 -0
  133. /package/dist/{pay-276DSSYG.js.map → install-identity-QM44IQ6Z.js.map} +0 -0
  134. /package/dist/{install-wallet-USHWL7AX.js.map → install-wallet-Z52EDLPB.js.map} +0 -0
  135. /package/dist/{status-line-wiring-LW4HFRHB.js.map → package-RT24HTTP.js.map} +0 -0
  136. /package/dist/{wallet-CKKB23D5.js.map → pay-IR2V76FX.js.map} +0 -0
  137. /package/dist/{payments-TZYLJXK3.js.map → payments-GFV4HU5R.js.map} +0 -0
  138. /package/dist/{send-YHDKZPED.js.map → send-PI4NUA7I.js.map} +0 -0
  139. /package/dist/{status-line-QKDJYZGV.js.map → status-line-2G5JPQAE.js.map} +0 -0
package/README.md CHANGED
@@ -45,19 +45,19 @@ In Claude Code or Claude Desktop, paste:
45
45
  Install Tenjin from tenjin.sh
46
46
  ```
47
47
 
48
- Your agent installs it, asks you about spend limits in the session, and helps you fund the wallet.
48
+ Your agent installs it, asks you about spend limits in the session, and helps you fund the wallet. Then type `/reload-plugins`, or start a new session, and Tenjin is on (when upgrading from an earlier release, start a new session). It needs Claude Code 2.1.287 or newer.
49
49
 
50
- Or in a terminal (Node.js 24 or newer):
50
+ Or in a terminal (Node.js 22 or newer):
51
51
 
52
52
  ```bash
53
53
  npm i -g tenjin-cli
54
- tenjin install # sets up Claude Code and creates your wallet
54
+ tenjin install # adds the Tenjin plugin to Claude Code and creates your wallet
55
55
  tenjin wallet fund 2 # optional: add $2 with a card, via Coinbase
56
56
  ```
57
57
 
58
58
  ## What it can do
59
59
 
60
- The router picks from a catalog we curate and maintain. When nothing in it fits, it can point your agent at a reviewed third-party pay-per-call service from the [Tenjin list](#tenjin-list-and-experimental-bazaar), and your agent decides whether to use it or to ask you first. Routing is free today: you pay the provider's price and nothing else. A flat [routing fee](#routing-fee) of $0.003 per routing call is coming, under the spend limits you approve at install.
60
+ The router picks from a catalog we curate and maintain. When nothing in it fits, it can point your agent at a reviewed third-party pay-per-call service from the [Tenjin list](#tenjin-list-and-experimental-bazaar), and your agent decides whether to use it or to ask you first. Each routing call costs a flat [routing fee](#routing-fee) of $0.003, on top of the provider's price, paid from channel deposits of up to $0.25 that count against the spend limits you approve at install.
61
61
 
62
62
  | Tool | What your agent gets | Price per call |
63
63
  | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------- |
@@ -99,11 +99,7 @@ flowchart LR
99
99
 
100
100
  The Tenjin router hooks into Claude Code at your prompt, before each web search or page fetch, when your agent hands work to a subagent, and around a question your agent asks you. At each point it asks Jev, a decision model from [TypeSafe](https://typesafe.ai), whether a tool in the catalog fits. When none does, Jev may pick one third-party service from a short list matching the step (the Tenjin list, plus the open Bazaar if you turned it on), or none. Either way Jev only chooses from a list, so it never writes a call or an instruction for your agent; a third-party listing's description is the seller's own, and your agent judges it.
101
101
 
102
- When one fits, your agent sees a one-line suggestion with the tool and its price, and calls it through Tenjin's `x402` MCP server: the offer's id alone shows the tool's inputs, an example and what it returns, and the id with the agent's input runs it. Tenjin builds the call, pays the provider from your wallet, within your limits, and hands back the result. Your status line shows the call as it happens:
103
-
104
- ```text
105
- x402 · request: calling pro-api.coinmarketcap.com/x402/v3/cryptocurrency/quotes/latest · {"query":{"symbol":"BTC,ETH"}}
106
- ```
102
+ When one fits, your agent sees a one-line suggestion with the tool and its price, and calls it through the Tenjin plugin's MCP server: the offer's id alone shows the tool's inputs, an example and what it returns, and the id with the agent's input runs it. Tenjin builds the call, pays the provider from your wallet, within your limits, and hands back the result.
107
103
 
108
104
  To pick a tool, the router sends your prompt and recent messages with secrets masked, plus the searches, URLs, subagent tasks and questions it routes; tool results stay on your machine. [What it sends, and everything install writes →](./docs/agent-permissions.md#what-the-hooks-send)
109
105
 
@@ -126,11 +122,11 @@ Tenjin pays for tools with [x402](https://www.x402.org), an open standard that b
126
122
 
127
123
  ### Routing fee
128
124
 
129
- Once Tenjin's server turns it on, each routing call costs a flat $0.003, paid over x402 `batch-settlement` by `tenjin mcp` from a channel deposit of up to $0.25 (less when your per-call limit is lower). A deposit is an automatic payment: it counts against the limits above, and approving them at install approves the fee. The fees come out of the deposit and are not counted again. When a call cannot be paid, it takes the free path, and Claude Code tells you once per session why and what fixes it; `tenjin doctor` says the same. Details are in [docs/agent-permissions.md](docs/agent-permissions.md#what-bounds-a-router-payment-on-top-of-that).
125
+ Each routing call costs a flat $0.003, paid over x402 `batch-settlement` by `tenjin mcp` from a channel deposit of up to $0.25 (less when your per-call limit is lower). A deposit is an automatic payment: it counts against the limits above, and approving them at install approves the fee. The fees come out of the deposit and are not counted again. When a call cannot be paid, it takes the free path, and Claude Code tells you once per session why and what fixes it; `tenjin doctor` says the same. Details are in [docs/agent-permissions.md](docs/agent-permissions.md#what-bounds-a-router-payment-on-top-of-that).
130
126
 
131
127
  ### Funding
132
128
 
133
- `tenjin wallet fund 2` opens a Coinbase Onramp checkout for your wallet: pay by card, or Apple Pay where your region supports it. Sign in to Coinbase or create an account during checkout. You can also send USDC on Base to the address `tenjin wallet address` prints; at a terminal it and `tenjin wallet fund` also draw that address as a QR code for a phone wallet to scan (`--no-qr` skips it).
129
+ `tenjin wallet fund 2` opens a Coinbase Onramp checkout for your wallet. In the US, Apple Pay or Google Pay with no Coinbase account. Elsewhere, your Coinbase account. You can also send USDC on Base to the address `tenjin wallet address` prints; at a terminal it and `tenjin wallet fund` also draw that address as a QR code for a phone wallet to scan (`--no-qr` skips it).
134
130
 
135
131
  $1–2 goes a long way. $2 covers about 280 web searches, 200 page reads or 100 Wolfram Alpha answers.
136
132
 
@@ -148,20 +144,13 @@ tenjin payments reconcile # settle paid lookups whose settlement was unknow
148
144
  tenjin update # newest version; wallet and settings stay
149
145
  tenjin config set router.enabled false # pause the router on this machine
150
146
  tenjin config set --project router.enabled false # ...or just in this repo
151
- tenjin uninstall # remove the Claude Code setup; your wallet stays
147
+ tenjin uninstall # remove the Claude Code plugin; your wallet stays
152
148
  ```
153
149
 
154
150
  Use `tenjin install --project` to set it up for a single project. Add `--json` to any command for machine-readable output.
155
151
 
156
152
  Every paid lookup is recorded on your machine, with the files and full results it returned. [Where they live, and what `payments reconcile` does →](./docs/agent-permissions.md#what-a-paid-lookup-leaves-on-your-machine)
157
153
 
158
- <details>
159
- <summary>Status line: keeping your own</summary>
160
-
161
- `tenjin install` sets Claude Code's [status line](https://code.claude.com/docs/en/statusline) only if you don't already have one. If you do, yours is left alone and the install prints a command that shows both; `tenjin install --status-line compose` writes it for you, and `--status-line skip` leaves the setting untouched. The status line reads local files only: no network, no wallet, and it can't affect a lookup or a payment.
162
-
163
- </details>
164
-
165
154
  <details>
166
155
  <summary>Spending limits: the fine print</summary>
167
156
 
@@ -182,7 +171,7 @@ Tenjin is in alpha, and the catalog grows with what people ask for. Missing a se
182
171
 
183
172
  - [How a lookup runs, what it sends, and what install writes](./docs/agent-permissions.md)
184
173
  - [Safety model](./docs/safety-model.md)
185
- - [Troubleshooting](./docs/troubleshooting.md), including a stray `x402` server in `~/.mcp.json` after `0.1.0-alpha.18`
174
+ - [Troubleshooting](./docs/troubleshooting.md)
186
175
 
187
176
  ## Developing
188
177
 
@@ -0,0 +1,21 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ aliveDir,
4
+ aliveMain,
5
+ markSessionServed,
6
+ readAliveStamp,
7
+ removeAliveState,
8
+ runAliveHook,
9
+ sessionServedByPlugin
10
+ } from "./chunk-6W5GYG3W.js";
11
+ import "./chunk-ZXTAQYNA.js";
12
+ export {
13
+ aliveDir,
14
+ aliveMain,
15
+ markSessionServed,
16
+ readAliveStamp,
17
+ removeAliveState,
18
+ runAliveHook,
19
+ sessionServedByPlugin
20
+ };
21
+ //# sourceMappingURL=alive-3J3CHOQP.js.map
@@ -1,21 +1,19 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  setTenjinIdentity
4
- } from "./chunk-5INS5ZZF.js";
4
+ } from "./chunk-UOW5JXYY.js";
5
5
  import {
6
6
  hasCode
7
7
  } from "./chunk-2I4QTOLB.js";
8
8
  import {
9
9
  isTeamModeConfig
10
- } from "./chunk-HII5HOQV.js";
10
+ } from "./chunk-ZP7AHN7Z.js";
11
11
  import {
12
12
  knownDeploymentOrigins,
13
13
  loadRawConfig,
14
- resolveSettings
15
- } from "./chunk-XICKN3CH.js";
16
- import {
14
+ resolveSettings,
17
15
  writeFileAtomicExclusive
18
- } from "./chunk-JLEF5WHM.js";
16
+ } from "./chunk-QTND6XWJ.js";
19
17
  import {
20
18
  installIdPath
21
19
  } from "./chunk-K6AXXYCG.js";
@@ -109,4 +107,4 @@ export {
109
107
  enableCliIdentity,
110
108
  enableDaemonIdentity
111
109
  };
112
- //# sourceMappingURL=chunk-WT7DHJNJ.js.map
110
+ //# sourceMappingURL=chunk-3QJREVMX.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/install-identity.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile } from 'node:fs/promises';\nimport { writeFileAtomicExclusive } from './atomic-json';\nimport { loadRawConfig, resolveSettings } from './config';\nimport { hasCode } from './errno';\nimport { setTenjinIdentity, type TenjinIdentity } from './http';\nimport { installIdPath } from './paths';\nimport { knownDeploymentOrigins } from './production-origin';\nimport { isTeamModeConfig } from './settings';\n\n/**\n * The install id the transport attaches to Tenjin-bound requests (see\n * `TenjinIdentity` in lib/http), and the rule for which origins are Tenjin's.\n *\n * Nothing here may fail a request: every read that goes wrong is an absent\n * header. There is no opt-out for alpha; the id is random, anonymous, and not a\n * credential.\n */\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction parseInstallId(raw: string): string | undefined {\n const id = raw.trim();\n return UUID_RE.test(id) ? id : undefined;\n}\n\n/**\n * This data dir's install id, minted on first need. Created no-clobber, so two\n * processes racing on a first run agree on the winner's id rather than each\n * keeping its own. A file that exists but does not hold a UUID is left alone and\n * sends nothing: overwriting it would be a new id for the same install.\n */\nexport async function readOrCreateInstallId(dir: string): Promise<string | undefined> {\n const path = installIdPath(dir);\n try {\n return parseInstallId(await readFile(path, 'utf8'));\n } catch (err) {\n if (!hasCode(err, 'ENOENT')) return undefined;\n }\n const id = randomUUID();\n try {\n await writeFileAtomicExclusive(path, `${id}\\n`, { mode: 0o600, dirMode: 0o700 });\n return id;\n } catch (err) {\n if (!hasCode(err, 'EEXIST')) return undefined;\n }\n try {\n return parseInstallId(await readFile(path, 'utf8'));\n } catch {\n return undefined;\n }\n}\n\nfunction tryOrigin(url: string): string | undefined {\n try {\n return new URL(url).origin;\n } catch {\n return undefined;\n }\n}\n\n/**\n * The origins that get the header: Tenjin's own deployments and the base URL\n * this run is pointed at, overrides included (a local dev server is Tenjin too).\n * Not `publicShelfUrl`: its default is already one of Tenjin's deployments, and\n * a custom one may be a host Tenjin does not run.\n *\n * NOT a team shelf. In team mode `baseUrl` is the team's own deployment, which\n * Tenjin does not operate, so on a team machine the base URL is left out unless\n * it is one of Tenjin's own origins anyway. `isTeamModeConfig` reads the file,\n * so a `--base-url` on one run cannot switch that exclusion off.\n */\nexport function tenjinOrigins(s: { baseUrl: string; teamMode: boolean }): string[] {\n const origins = new Set(knownDeploymentOrigins());\n const baseOrigin = tryOrigin(s.baseUrl);\n if (baseOrigin !== undefined && !s.teamMode) origins.add(baseOrigin);\n return [...origins];\n}\n\n/** An identity for one data dir. The install id is read once per process. */\nexport function identityFor(\n dir: string,\n origins: () => Promise<readonly string[]>,\n): TenjinIdentity {\n let install: Promise<string | undefined> | undefined;\n return {\n origins,\n installId: () => (install ??= readOrCreateInstallId(dir)),\n };\n}\n\n/**\n * The run's `--base-url`, recorded by the CLI once it has parsed the global\n * flags. The origins are resolved on the first request, which comes after that.\n */\nlet baseUrlFlag: string | undefined;\n\nexport function noteBaseUrlFlag(flag: string | undefined): void {\n baseUrlFlag = flag;\n}\n\n/**\n * Turn the header on for this CLI process. Called from the entry only, never\n * from `main`, so in-process tests of the command tree never mint an id.\n */\nexport function enableCliIdentity(dir: string, env: NodeJS.ProcessEnv = process.env): void {\n let origins: Promise<readonly string[]> | undefined;\n setTenjinIdentity(\n identityFor(dir, () => {\n origins ??= (async () => {\n const config = await loadRawConfig(dir);\n const s = resolveSettings({ config, flags: { baseUrl: baseUrlFlag }, env });\n return tenjinOrigins({\n baseUrl: s.baseUrl.value,\n teamMode: isTeamModeConfig(config),\n });\n })();\n return origins;\n }),\n );\n}\n\n/**\n * Turn the header on for the loop daemon. No flag or env layer, like the rest\n * of the daemon's config, and re-read per request because the daemon reloads\n * config.json when it changes.\n */\nexport function enableDaemonIdentity(\n dir: string,\n config: () => { baseUrl: string; publicShelfUrl: string; shelfBypassSecret: string },\n): void {\n setTenjinIdentity(\n identityFor(dir, async () => {\n const c = config();\n return tenjinOrigins({\n baseUrl: c.baseUrl,\n teamMode: isTeamModeConfig(c),\n });\n }),\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAkBzB,IAAM,UAAU;AAEhB,SAAS,eAAe,KAAiC;AACvD,QAAM,KAAK,IAAI,KAAK;AACpB,SAAO,QAAQ,KAAK,EAAE,IAAI,KAAK;AACjC;AAQA,eAAsB,sBAAsB,KAA0C;AACpF,QAAM,OAAO,cAAc,GAAG;AAC9B,MAAI;AACF,WAAO,eAAe,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,EACpD,SAAS,KAAK;AACZ,QAAI,CAAC,QAAQ,KAAK,QAAQ,EAAG,QAAO;AAAA,EACtC;AACA,QAAM,KAAK,WAAW;AACtB,MAAI;AACF,UAAM,yBAAyB,MAAM,GAAG,EAAE;AAAA,GAAM,EAAE,MAAM,KAAO,SAAS,IAAM,CAAC;AAC/E,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,QAAI,CAAC,QAAQ,KAAK,QAAQ,EAAG,QAAO;AAAA,EACtC;AACA,MAAI;AACF,WAAO,eAAe,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,EACpD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,UAAU,KAAiC;AAClD,MAAI;AACF,WAAO,IAAI,IAAI,GAAG,EAAE;AAAA,EACtB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAaO,SAAS,cAAc,GAAqD;AACjF,QAAM,UAAU,IAAI,IAAI,uBAAuB,CAAC;AAChD,QAAM,aAAa,UAAU,EAAE,OAAO;AACtC,MAAI,eAAe,UAAa,CAAC,EAAE,SAAU,SAAQ,IAAI,UAAU;AACnE,SAAO,CAAC,GAAG,OAAO;AACpB;AAGO,SAAS,YACd,KACA,SACgB;AAChB,MAAI;AACJ,SAAO;AAAA,IACL;AAAA,IACA,WAAW,MAAO,YAAY,sBAAsB,GAAG;AAAA,EACzD;AACF;AAMA,IAAI;AAEG,SAAS,gBAAgB,MAAgC;AAC9D,gBAAc;AAChB;AAMO,SAAS,kBAAkB,KAAa,MAAyB,QAAQ,KAAW;AACzF,MAAI;AACJ;AAAA,IACE,YAAY,KAAK,MAAM;AACrB,mBAAa,YAAY;AACvB,cAAM,SAAS,MAAM,cAAc,GAAG;AACtC,cAAM,IAAI,gBAAgB,EAAE,QAAQ,OAAO,EAAE,SAAS,YAAY,GAAG,IAAI,CAAC;AAC1E,eAAO,cAAc;AAAA,UACnB,SAAS,EAAE,QAAQ;AAAA,UACnB,UAAU,iBAAiB,MAAM;AAAA,QACnC,CAAC;AAAA,MACH,GAAG;AACH,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;AAOO,SAAS,qBACd,KACA,QACM;AACN;AAAA,IACE,YAAY,KAAK,YAAY;AAC3B,YAAM,IAAI,OAAO;AACjB,aAAO,cAAc;AAAA,QACnB,SAAS,EAAE;AAAA,QACX,UAAU,iBAAiB,CAAC;AAAA,MAC9B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;","names":[]}
1
+ {"version":3,"sources":["../src/lib/install-identity.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { readFile } from 'node:fs/promises';\nimport { writeFileAtomicExclusive } from './atomic-json';\nimport { loadRawConfig, resolveSettings } from './config';\nimport { hasCode } from './errno';\nimport { setTenjinIdentity, type TenjinIdentity } from './http';\nimport { installIdPath } from './paths';\nimport { knownDeploymentOrigins } from './production-origin';\nimport { isTeamModeConfig } from './settings';\n\n/**\n * The install id the transport attaches to Tenjin-bound requests (see\n * `TenjinIdentity` in lib/http), and the rule for which origins are Tenjin's.\n *\n * Nothing here may fail a request: every read that goes wrong is an absent\n * header. There is no opt-out for alpha; the id is random, anonymous, and not a\n * credential.\n */\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction parseInstallId(raw: string): string | undefined {\n const id = raw.trim();\n return UUID_RE.test(id) ? id : undefined;\n}\n\n/**\n * This data dir's install id, minted on first need. Created no-clobber, so two\n * processes racing on a first run agree on the winner's id rather than each\n * keeping its own. A file that exists but does not hold a UUID is left alone and\n * sends nothing: overwriting it would be a new id for the same install.\n */\nexport async function readOrCreateInstallId(dir: string): Promise<string | undefined> {\n const path = installIdPath(dir);\n try {\n return parseInstallId(await readFile(path, 'utf8'));\n } catch (err) {\n if (!hasCode(err, 'ENOENT')) return undefined;\n }\n const id = randomUUID();\n try {\n await writeFileAtomicExclusive(path, `${id}\\n`, { mode: 0o600, dirMode: 0o700 });\n return id;\n } catch (err) {\n if (!hasCode(err, 'EEXIST')) return undefined;\n }\n try {\n return parseInstallId(await readFile(path, 'utf8'));\n } catch {\n return undefined;\n }\n}\n\nfunction tryOrigin(url: string): string | undefined {\n try {\n return new URL(url).origin;\n } catch {\n return undefined;\n }\n}\n\n/**\n * The origins that get the header: Tenjin's own deployments and the base URL\n * this run is pointed at, overrides included (a local dev server is Tenjin too).\n * Not `publicShelfUrl`: its default is already one of Tenjin's deployments, and\n * a custom one may be a host Tenjin does not run.\n *\n * NOT a team shelf. In team mode `baseUrl` is the team's own deployment, which\n * Tenjin does not operate, so on a team machine the base URL is left out unless\n * it is one of Tenjin's own origins anyway. `isTeamModeConfig` reads the file,\n * so a `--base-url` on one run cannot switch that exclusion off.\n */\nexport function tenjinOrigins(s: { baseUrl: string; teamMode: boolean }): string[] {\n const origins = new Set(knownDeploymentOrigins());\n const baseOrigin = tryOrigin(s.baseUrl);\n if (baseOrigin !== undefined && !s.teamMode) origins.add(baseOrigin);\n return [...origins];\n}\n\n/** An identity for one data dir. The install id is read once per process. */\nexport function identityFor(\n dir: string,\n origins: () => Promise<readonly string[]>,\n): TenjinIdentity {\n let install: Promise<string | undefined> | undefined;\n return {\n origins,\n installId: () => (install ??= readOrCreateInstallId(dir)),\n };\n}\n\n/**\n * The run's `--base-url`, recorded by the CLI once it has parsed the global\n * flags. The origins are resolved on the first request, which comes after that.\n */\nlet baseUrlFlag: string | undefined;\n\nexport function noteBaseUrlFlag(flag: string | undefined): void {\n baseUrlFlag = flag;\n}\n\n/**\n * Turn the header on for this CLI process. Called from the entry only, never\n * from `main`, so in-process tests of the command tree never mint an id.\n */\nexport function enableCliIdentity(dir: string, env: NodeJS.ProcessEnv = process.env): void {\n let origins: Promise<readonly string[]> | undefined;\n setTenjinIdentity(\n identityFor(dir, () => {\n origins ??= (async () => {\n const config = await loadRawConfig(dir);\n const s = resolveSettings({ config, flags: { baseUrl: baseUrlFlag }, env });\n return tenjinOrigins({\n baseUrl: s.baseUrl.value,\n teamMode: isTeamModeConfig(config),\n });\n })();\n return origins;\n }),\n );\n}\n\n/**\n * Turn the header on for the loop daemon. No flag or env layer, like the rest\n * of the daemon's config, and re-read per request because the daemon reloads\n * config.json when it changes.\n */\nexport function enableDaemonIdentity(\n dir: string,\n config: () => { baseUrl: string; publicShelfUrl: string; shelfBypassSecret: string },\n): void {\n setTenjinIdentity(\n identityFor(dir, async () => {\n const c = config();\n return tenjinOrigins({\n baseUrl: c.baseUrl,\n teamMode: isTeamModeConfig(c),\n });\n }),\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAkBzB,IAAM,UAAU;AAEhB,SAAS,eAAe,KAAiC;AACvD,QAAM,KAAK,IAAI,KAAK;AACpB,SAAO,QAAQ,KAAK,EAAE,IAAI,KAAK;AACjC;AAQA,eAAsB,sBAAsB,KAA0C;AACpF,QAAM,OAAO,cAAc,GAAG;AAC9B,MAAI;AACF,WAAO,eAAe,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,EACpD,SAAS,KAAK;AACZ,QAAI,CAAC,QAAQ,KAAK,QAAQ,EAAG,QAAO;AAAA,EACtC;AACA,QAAM,KAAK,WAAW;AACtB,MAAI;AACF,UAAM,yBAAyB,MAAM,GAAG,EAAE;AAAA,GAAM,EAAE,MAAM,KAAO,SAAS,IAAM,CAAC;AAC/E,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,QAAI,CAAC,QAAQ,KAAK,QAAQ,EAAG,QAAO;AAAA,EACtC;AACA,MAAI;AACF,WAAO,eAAe,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,EACpD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,UAAU,KAAiC;AAClD,MAAI;AACF,WAAO,IAAI,IAAI,GAAG,EAAE;AAAA,EACtB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAaO,SAAS,cAAc,GAAqD;AACjF,QAAM,UAAU,IAAI,IAAI,uBAAuB,CAAC;AAChD,QAAM,aAAa,UAAU,EAAE,OAAO;AACtC,MAAI,eAAe,UAAa,CAAC,EAAE,SAAU,SAAQ,IAAI,UAAU;AACnE,SAAO,CAAC,GAAG,OAAO;AACpB;AAGO,SAAS,YACd,KACA,SACgB;AAChB,MAAI;AACJ,SAAO;AAAA,IACL;AAAA,IACA,WAAW,MAAO,YAAY,sBAAsB,GAAG;AAAA,EACzD;AACF;AAMA,IAAI;AAEG,SAAS,gBAAgB,MAAgC;AAC9D,gBAAc;AAChB;AAMO,SAAS,kBAAkB,KAAa,MAAyB,QAAQ,KAAW;AACzF,MAAI;AACJ;AAAA,IACE,YAAY,KAAK,MAAM;AACrB,mBAAa,YAAY;AACvB,cAAM,SAAS,MAAM,cAAc,GAAG;AACtC,cAAM,IAAI,gBAAgB,EAAE,QAAQ,OAAO,EAAE,SAAS,YAAY,GAAG,IAAI,CAAC;AAC1E,eAAO,cAAc;AAAA,UACnB,SAAS,EAAE,QAAQ;AAAA,UACnB,UAAU,iBAAiB,MAAM;AAAA,QACnC,CAAC;AAAA,MACH,GAAG;AACH,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;AAOO,SAAS,qBACd,KACA,QACM;AACN;AAAA,IACE,YAAY,KAAK,YAAY;AAC3B,YAAM,IAAI,OAAO;AACjB,aAAO,cAAc;AAAA,QACnB,SAAS,EAAE;AAAA,QACX,UAAU,iBAAiB,CAAC;AAAA,MAC9B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACF;","names":[]}
@@ -1,11 +1,12 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
- MCP_SERVER_NAME,
4
- REQUEST_TOOL
5
- } from "./chunk-TGLKKLQG.js";
3
+ LEGACY_MCP_SERVER_NAME,
4
+ LEGACY_REQUEST_TOOL,
5
+ requestToolName
6
+ } from "./chunk-DYSDQE7S.js";
6
7
  import {
7
8
  writeFileAtomic
8
- } from "./chunk-JLEF5WHM.js";
9
+ } from "./chunk-QTND6XWJ.js";
9
10
 
10
11
  // src/router/agent-tools.ts
11
12
  import { readdir, readFile } from "node:fs/promises";
@@ -17,30 +18,35 @@ var MCP_INHERITING_BUILTINS = /* @__PURE__ */ new Set([
17
18
  ]);
18
19
  var MAX_AGENT_FILE_BYTES = 256 * 1024;
19
20
  var TYPE_RE = /^[A-Za-z0-9_.:-]{1,200}$/;
20
- async function requestToolAccess(agentType, lookup) {
21
+ async function requestToolAccess(agentType, lookup, tool = requestToolName()) {
21
22
  if (agentType === void 0 || !TYPE_RE.test(agentType)) return "unknown";
22
23
  try {
23
24
  const text = await findDefinition(agentType, lookup);
24
- if (text !== null) return accessOf(text);
25
+ if (text !== null) return accessOf(text, tool);
25
26
  return MCP_INHERITING_BUILTINS.has(agentType) ? "allowed" : "unknown";
26
27
  } catch {
27
28
  return "unknown";
28
29
  }
29
30
  }
30
- function accessOf(definition) {
31
+ function accessOf(definition, tool = requestToolName()) {
31
32
  const frontmatter = frontmatterOf(definition);
32
33
  if (frontmatter === null) return "unknown";
33
34
  const disallowed = listField(frontmatter, "disallowedTools");
34
- if (disallowed !== void 0 && disallowed.some(namesRequestTool)) return "excluded";
35
+ if (disallowed !== void 0 && disallowed.some((entry) => namesRequestTool(entry, tool) || namesLegacyTool(entry))) {
36
+ return "excluded";
37
+ }
35
38
  const tools = listField(frontmatter, "tools");
36
39
  if (tools === void 0) return "allowed";
37
- return tools.some(namesRequestTool) ? "allowed" : "excluded";
40
+ return tools.some((entry) => namesRequestTool(entry, tool)) ? "allowed" : "excluded";
41
+ }
42
+ function namesRequestTool(entry, tool) {
43
+ if (entry === tool || entry === tool.replace(/__request$/, "")) return true;
44
+ return entry.endsWith("*") && tool.startsWith(entry.slice(0, -1));
38
45
  }
39
- function namesRequestTool(tool) {
40
- if (tool === REQUEST_TOOL || tool === `mcp__${MCP_SERVER_NAME}`) return true;
41
- return tool.endsWith("*") && REQUEST_TOOL.startsWith(tool.slice(0, -1));
46
+ function namesLegacyTool(entry) {
47
+ return namesRequestTool(entry, LEGACY_REQUEST_TOOL) || entry === `mcp__${LEGACY_MCP_SERVER_NAME}`;
42
48
  }
43
- async function agentsWithoutRequestTool(lookup) {
49
+ async function agentsWithoutRequestTool(lookup, tool = requestToolName()) {
44
50
  const found = [];
45
51
  const seen = /* @__PURE__ */ new Set();
46
52
  for (const directory of agentDirs(lookup)) {
@@ -48,7 +54,7 @@ async function agentsWithoutRequestTool(lookup) {
48
54
  const type = nameOf(text) ?? name;
49
55
  if (seen.has(type)) continue;
50
56
  seen.add(type);
51
- if (accessOf(text) === "excluded") found.push(type);
57
+ if (accessOf(text, tool) === "excluded") found.push(type);
52
58
  }
53
59
  }
54
60
  return found.sort();
@@ -219,4 +225,4 @@ export {
219
225
  writeRouterMemo,
220
226
  clearRouterMemo
221
227
  };
222
- //# sourceMappingURL=chunk-BOAI23CX.js.map
228
+ //# sourceMappingURL=chunk-6KA4HFX5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/router/agent-tools.ts","../src/router/router-memo.ts"],"sourcesContent":["import { readdir, readFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport { LEGACY_MCP_SERVER_NAME, LEGACY_REQUEST_TOOL, requestToolName } from './names';\n\n/**\n * CAN THIS SUBAGENT CALL `request` AT ALL? An offer to an agent whose definition\n * leaves the tool out is a line it cannot act on, and a router call spent to\n * write it. Claude Code defines a custom agent in a Markdown file whose\n * frontmatter may carry `tools:` (an allowlist) and `disallowedTools:`; this\n * reads that, and nothing else, and never writes to it.\n *\n * ONLY `allowed` IS ACTED ON. A subagent is redirected or offered a lookup\n * only when this KNOWS it can make the call: a definition whose tools cover\n * the request tool (or that has no `tools:` and so inherits everything), or a\n * built-in in {@link MCP_INHERITING_BUILTINS}. Every other built-in, and any\n * type with no definition this can find or read, is `unknown`, and `unknown`\n * gets no router call: `claude-code-guide` ships with Bash, Read, WebFetch and\n * WebSearch and no MCP tools, and denying its WebFetch would strand it exactly\n * as #377 reported.\n *\n * WHERE A DEFINITION LIVES, in the harness's own precedence: the project's\n * `.claude/agents` (from `cwd` up to the filesystem root, nearest first), then\n * `~/.claude/agents`, then an installed plugin's `agents/` for a `plugin:agent`\n * type. A file is found by its name first and by its frontmatter `name:`\n * second, because the type is the `name:` and the file name only usually\n * matches it.\n */\n\nexport type RequestToolAccess = 'allowed' | 'excluded' | 'unknown';\n\n/**\n * The built-in agent types that have no definition file and still inherit MCP\n * tools, so can call the request tool. From Claude Code's own Agent tool\n * listing (2.1.28x): `general-purpose` has every tool, and `Explore` and `Plan`\n * exclude only editing and agent tools, never MCP. Built-ins with a fixed tool\n * list, such as `claude-code-guide` (Bash, Read, WebFetch, WebSearch) and\n * `statusline-setup` (Read, Edit), are deliberately absent.\n */\nexport const MCP_INHERITING_BUILTINS: ReadonlySet<string> = new Set([\n 'general-purpose',\n 'Explore',\n 'Plan',\n]);\n\nexport interface AgentLookup {\n cwd?: string;\n homeDir: string;\n}\n\nconst MAX_AGENT_FILE_BYTES = 256 * 1024;\nconst TYPE_RE = /^[A-Za-z0-9_.:-]{1,200}$/;\n\nexport async function requestToolAccess(\n agentType: string | undefined,\n lookup: AgentLookup,\n tool: string = requestToolName(),\n): Promise<RequestToolAccess> {\n if (agentType === undefined || !TYPE_RE.test(agentType)) return 'unknown';\n try {\n const text = await findDefinition(agentType, lookup);\n if (text !== null) return accessOf(text, tool);\n return MCP_INHERITING_BUILTINS.has(agentType) ? 'allowed' : 'unknown';\n } catch {\n return 'unknown';\n }\n}\n\n/**\n * What one definition's frontmatter says about the request tool, named as the\n * leg's harness exposes it (`tool`).\n *\n * THE OLD NAME, AFTER THE RENAME. An agent whose `tools:` names only\n * `mcp__x402__request` cannot call the plugin's tool, so it counts as excluded\n * and doctor names the new name to add. One whose `disallowedTools:` names the\n * old tool or server meant to keep paid lookups out, so it stays excluded.\n * SHIM: the old-name branch goes on or after 2026-12-01.\n */\nexport function accessOf(definition: string, tool: string = requestToolName()): RequestToolAccess {\n const frontmatter = frontmatterOf(definition);\n if (frontmatter === null) return 'unknown';\n const disallowed = listField(frontmatter, 'disallowedTools');\n if (\n disallowed !== undefined &&\n disallowed.some((entry) => namesRequestTool(entry, tool) || namesLegacyTool(entry))\n ) {\n return 'excluded';\n }\n const tools = listField(frontmatter, 'tools');\n if (tools === undefined) return 'allowed';\n return tools.some((entry) => namesRequestTool(entry, tool)) ? 'allowed' : 'excluded';\n}\n\n/**\n * Does one `tools:` or `disallowedTools:` entry cover the request tool? The\n * tool itself, its bare server (`mcp__plugin_tenjin_router`), or any\n * `*`-suffixed pattern the tool's name starts with: `*`, `mcp__*`,\n * `mcp__plugin_tenjin_router__*` and every prefix between.\n */\nfunction namesRequestTool(entry: string, tool: string): boolean {\n if (entry === tool || entry === tool.replace(/__request$/, '')) return true;\n return entry.endsWith('*') && tool.startsWith(entry.slice(0, -1));\n}\n\n/** The settings install's tool or server, by literal or wildcard. */\nfunction namesLegacyTool(entry: string): boolean {\n return namesRequestTool(entry, LEGACY_REQUEST_TOOL) || entry === `mcp__${LEGACY_MCP_SERVER_NAME}`;\n}\n\n/**\n * Every custom agent this project and this user define whose tools leave the\n * request tool out, for `doctor` to name. Plugin agents are not listed: their\n * files are not the user's to edit.\n */\nexport async function agentsWithoutRequestTool(\n lookup: AgentLookup,\n tool: string = requestToolName(),\n): Promise<string[]> {\n const found: string[] = [];\n const seen = new Set<string>();\n for (const directory of agentDirs(lookup)) {\n for (const { name, text } of await definitionsIn(directory)) {\n const type = nameOf(text) ?? name;\n if (seen.has(type)) continue;\n seen.add(type);\n if (accessOf(text, tool) === 'excluded') found.push(type);\n }\n }\n return found.sort();\n}\n\nasync function findDefinition(agentType: string, lookup: AgentLookup): Promise<string | null> {\n for (const directory of agentDirs(lookup)) {\n const text = await definitionIn(directory, agentType);\n if (text !== null) return text;\n }\n const colon = agentType.indexOf(':');\n if (colon > 0) {\n const plugin = agentType.slice(0, colon);\n const agent = agentType.slice(colon + 1);\n for (const root of await pluginRoots(plugin, lookup.homeDir)) {\n const text = await definitionIn(join(root, 'agents'), agent);\n if (text !== null) return text;\n }\n }\n return null;\n}\n\nfunction agentDirs(lookup: AgentLookup): string[] {\n const dirs: string[] = [];\n if (lookup.cwd !== undefined && lookup.cwd.length > 0) {\n let current = resolve(lookup.cwd);\n for (;;) {\n dirs.push(join(current, '.claude', 'agents'));\n const parent = dirname(current);\n if (parent === current) break;\n current = parent;\n }\n }\n const user = join(resolve(lookup.homeDir), '.claude', 'agents');\n // The user's directory is also an ancestor of most projects; it counts once,\n // in its own place in the order.\n return [...dirs.filter((d) => d !== user), user];\n}\n\nasync function definitionIn(directory: string, agentType: string): Promise<string | null> {\n const direct = await readBounded(join(directory, `${agentType}.md`));\n if (direct !== null && (nameOf(direct) ?? agentType) === agentType) return direct;\n for (const { text } of await definitionsIn(directory)) {\n if (nameOf(text) === agentType) return text;\n }\n return null;\n}\n\nasync function definitionsIn(directory: string): Promise<{ name: string; text: string }[]> {\n let names: string[];\n try {\n names = (await readdir(directory)).filter((n) => n.endsWith('.md')).slice(0, 200);\n } catch {\n return [];\n }\n const out: { name: string; text: string }[] = [];\n for (const file of names) {\n const text = await readBounded(join(directory, file));\n if (text !== null) out.push({ name: file.slice(0, -3), text });\n }\n return out;\n}\n\n/** Install paths `installed_plugins.json` records for `<plugin>@<marketplace>`. */\nasync function pluginRoots(plugin: string, homeDir: string): Promise<string[]> {\n const raw = await readBounded(join(homeDir, '.claude', 'plugins', 'installed_plugins.json'));\n if (raw === null) return [];\n const parsed = JSON.parse(raw) as { plugins?: Record<string, unknown> };\n const roots: string[] = [];\n for (const [key, entries] of Object.entries(parsed.plugins ?? {})) {\n if (key.split('@')[0] !== plugin || !Array.isArray(entries)) continue;\n for (const entry of entries) {\n const path = (entry as { installPath?: unknown }).installPath;\n if (typeof path === 'string' && path.length > 0) roots.push(path);\n }\n }\n return roots;\n}\n\nasync function readBounded(path: string): Promise<string | null> {\n try {\n const text = await readFile(path, 'utf8');\n return text.length > MAX_AGENT_FILE_BYTES ? null : text;\n } catch {\n return null;\n }\n}\n\nfunction frontmatterOf(text: string): string[] | null {\n const lines = text.replace(/^\\uFEFF/, '').split(/\\r?\\n/);\n const open = lines.findIndex((l) => l.trim().length > 0);\n if (open === -1 || lines[open]?.trim() !== '---') return null;\n const end = lines.findIndex((l, i) => i > open && l.trim() === '---');\n return end === -1 ? null : lines.slice(open + 1, end);\n}\n\nfunction nameOf(text: string): string | null {\n const frontmatter = frontmatterOf(text);\n if (frontmatter === null) return null;\n const line = frontmatter.find((l) => /^name\\s*:/.test(l));\n const value = line === undefined ? '' : unquote(line.slice(line.indexOf(':') + 1).trim());\n return value.length > 0 ? value : null;\n}\n\n/**\n * A top-level list field in the three spellings agent files use: `a, b, c`,\n * `[a, b]`, or a block of `- a` lines. `undefined` when the key is absent.\n */\nfunction listField(frontmatter: string[], key: string): string[] | undefined {\n const index = frontmatter.findIndex((l) => new RegExp(`^${key}\\\\s*:`).test(l));\n if (index === -1) return undefined;\n const line = frontmatter[index]!;\n const inline = line.slice(line.indexOf(':') + 1).trim();\n if (inline.length > 0) {\n const body = inline.startsWith('[') && inline.endsWith(']') ? inline.slice(1, -1) : inline;\n return body\n .split(',')\n .map((part) => unquote(part.trim()))\n .filter((part) => part.length > 0);\n }\n const items: string[] = [];\n for (const next of frontmatter.slice(index + 1)) {\n const item = /^\\s+-\\s*(.*)$/.exec(next);\n if (item === null) {\n if (next.trim().length === 0) continue;\n break;\n }\n const value = unquote(item[1]!.trim());\n if (value.length > 0) items.push(value);\n }\n return items;\n}\n\nfunction unquote(value: string): string {\n const quoted = /^(['\"])(.*)\\1$/.exec(value);\n return quoted === null ? value : quoted[2]!;\n}\n","import { createHash } from 'node:crypto';\nimport { readFile, rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { writeFileAtomic } from '../lib/atomic-json';\n\n/**\n * ONE MEMO FOR \"DO NOT ASK THE ROUTER YET\", per machine and per router origin,\n * in the data dir, so every hook leg and every `tenjin mcp` process reads the\n * same answer. Two facts use it:\n *\n * - `unreachable`: a routing leg's call could not reach the router (DNS, TLS,\n * a refused connection, a proxy refusing the tunnel; see `isUnreachable`). For\n * {@link UNREACHABLE_BACKOFF_MS} every leg skips the router and the native\n * tool runs at once, instead of each prompt and search waiting out the gate.\n * Doctor's probe ends it early when it reaches the router.\n * - `paid-path-absent`: the router answered no paid path (the fee is off), so\n * calls take the free path without asking for an hour, or until the free\n * path answers `fee_required`.\n *\n * A memo is a file written atomically and read with the clock: one older than\n * its window, or dated in the future, reads as absent, so nothing cleans up\n * after it. An unreadable file reads as absent too: the cost of a lost memo is\n * one more call to the router.\n */\nexport type RouterMemoKind = 'unreachable' | 'paid-path-absent';\n\nexport interface RouterMemo {\n /** When it was written, in epoch ms. */\n at: number;\n /** When it ends, in epoch ms. */\n until: number;\n /** What happened, for doctor. */\n detail?: string;\n}\n\n/** How long routing legs skip a router that did not answer. */\nexport const UNREACHABLE_BACKOFF_MS = 60_000;\n\nfunction memoPath(dataDir: string, kind: RouterMemoKind, baseUrl: string): string {\n const origin = new URL(baseUrl).origin;\n const key = createHash('sha256').update(origin).digest('hex').slice(0, 16);\n return join(dataDir, 'router-memo', `${kind}-${key}.json`);\n}\n\n/** The memo in force at `now`, or null. Never throws. */\nexport async function readRouterMemo(\n dataDir: string,\n kind: RouterMemoKind,\n baseUrl: string,\n now: number,\n): Promise<RouterMemo | null> {\n try {\n const raw = JSON.parse(await readFile(memoPath(dataDir, kind, baseUrl), 'utf8')) as unknown;\n if (raw === null || typeof raw !== 'object') return null;\n const { at, until, detail } = raw as Record<string, unknown>;\n if (typeof at !== 'number' || typeof until !== 'number') return null;\n if (at > now || until <= now) return null;\n return { at, until, ...(typeof detail === 'string' ? { detail } : {}) };\n } catch {\n return null;\n }\n}\n\n/** Starts a memo of `ttlMs` from `now`. Never throws. */\nexport async function writeRouterMemo(\n dataDir: string,\n kind: RouterMemoKind,\n baseUrl: string,\n memo: { now: number; ttlMs: number; detail?: string },\n): Promise<void> {\n const body: RouterMemo = {\n at: memo.now,\n until: memo.now + memo.ttlMs,\n ...(memo.detail !== undefined ? { detail: memo.detail.slice(0, 300) } : {}),\n };\n try {\n await writeFileAtomic(memoPath(dataDir, kind, baseUrl), `${JSON.stringify(body)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n } catch {\n // Best effort: a memo that did not land costs one more call.\n }\n}\n\n/** Ends a memo before its window does. Never throws. */\nexport async function clearRouterMemo(\n dataDir: string,\n kind: RouterMemoKind,\n baseUrl: string,\n): Promise<void> {\n try {\n await rm(memoPath(dataDir, kind, baseUrl), { force: true });\n } catch {\n // Best effort: the window ends it anyway.\n }\n}\n"],"mappings":"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","names":["readFile","join","join","readFile"]}
@@ -0,0 +1,128 @@
1
+ import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+
3
+ // src/router/alive.ts
4
+ import { createHash } from "node:crypto";
5
+ import { mkdir, readdir, readFile, rm, rmdir, stat, writeFile } from "node:fs/promises";
6
+ import { join } from "node:path";
7
+ var MARKER_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
8
+ var STAMP = "plugin-loaded.json";
9
+ var MAX_SESSION_ID = 200;
10
+ function aliveDir(dataDir) {
11
+ return join(dataDir, "alive");
12
+ }
13
+ function markerName(sessionId) {
14
+ return createHash("sha256").update(sessionId).digest("hex").slice(0, 32);
15
+ }
16
+ function sessionIdOf(event) {
17
+ if (event === null || typeof event !== "object") return null;
18
+ const id = event.session_id;
19
+ return typeof id === "string" && id.length > 0 && id.length <= MAX_SESSION_ID ? id : null;
20
+ }
21
+ async function runAliveHook(event, opts) {
22
+ const sessionId = sessionIdOf(event);
23
+ const now = opts.now ?? Date.now();
24
+ const dir = aliveDir(opts.dataDir);
25
+ try {
26
+ await mkdir(dir, { recursive: true, mode: 448 });
27
+ if (sessionId !== null) {
28
+ await writeFile(join(dir, markerName(sessionId)), `${new Date(now).toISOString()}
29
+ `);
30
+ }
31
+ const stamp = { at: new Date(now).toISOString(), version: opts.version };
32
+ await writeFile(join(dir, STAMP), `${JSON.stringify(stamp)}
33
+ `);
34
+ await pruneMarkers(dir, now);
35
+ } catch {
36
+ }
37
+ }
38
+ async function pruneMarkers(dir, now) {
39
+ for (const name of await readdir(dir).catch(() => [])) {
40
+ if (!/^[0-9a-f]{32}$/.test(name)) continue;
41
+ const path = join(dir, name);
42
+ const s = await stat(path).catch(() => null);
43
+ if (s !== null && now - s.mtimeMs > MARKER_TTL_MS) await rm(path, { force: true });
44
+ }
45
+ }
46
+ async function sessionServedByPlugin(dataDir, event) {
47
+ const sessionId = sessionIdOf(event);
48
+ if (sessionId === null) return false;
49
+ return await stat(join(aliveDir(dataDir), markerName(sessionId))).catch(() => null) !== null;
50
+ }
51
+ async function readAliveStamp(dataDir) {
52
+ try {
53
+ const parsed = JSON.parse(await readFile(join(aliveDir(dataDir), STAMP), "utf8"));
54
+ if (parsed === null || typeof parsed !== "object") return null;
55
+ const { at, version } = parsed;
56
+ return typeof at === "string" && typeof version === "string" ? { at, version } : null;
57
+ } catch {
58
+ return null;
59
+ }
60
+ }
61
+ async function removeAliveState(dataDir) {
62
+ const dir = aliveDir(dataDir);
63
+ const existed = await stat(dir).catch(() => null) !== null;
64
+ if (!existed) return false;
65
+ for (const name of await readdir(dir).catch(() => [])) {
66
+ if (name === STAMP || /^[0-9a-f]{32}$/.test(name)) await rm(join(dir, name), { force: true });
67
+ }
68
+ await rmdir(dir).catch(() => void 0);
69
+ return true;
70
+ }
71
+ async function aliveMain(opts) {
72
+ const raw = await readStdin(1e3).catch(() => "");
73
+ await runAliveHook(parseEvent(raw), opts);
74
+ }
75
+ function parseEvent(raw) {
76
+ try {
77
+ return JSON.parse(raw);
78
+ } catch {
79
+ return null;
80
+ }
81
+ }
82
+ function readStdin(timeoutMs) {
83
+ return new Promise((resolve, reject) => {
84
+ const chunks = [];
85
+ let size = 0;
86
+ const timer = setTimeout(() => reject(new Error("no harness event")), timeoutMs);
87
+ process.stdin.on("data", (chunk) => {
88
+ size += chunk.length;
89
+ if (size > 1e6) {
90
+ clearTimeout(timer);
91
+ reject(new Error("harness event too large"));
92
+ return;
93
+ }
94
+ chunks.push(chunk);
95
+ });
96
+ process.stdin.once("end", () => {
97
+ clearTimeout(timer);
98
+ resolve(Buffer.concat(chunks).toString("utf8"));
99
+ });
100
+ process.stdin.once("error", () => {
101
+ clearTimeout(timer);
102
+ reject(new Error("harness event unreadable"));
103
+ });
104
+ });
105
+ }
106
+ async function markSessionServed(dataDir, event) {
107
+ const sessionId = sessionIdOf(event);
108
+ if (sessionId === null) return;
109
+ const path = join(aliveDir(dataDir), markerName(sessionId));
110
+ if (await stat(path).catch(() => null) !== null) return;
111
+ try {
112
+ await mkdir(aliveDir(dataDir), { recursive: true, mode: 448 });
113
+ await writeFile(path, `${(/* @__PURE__ */ new Date()).toISOString()}
114
+ `);
115
+ } catch {
116
+ }
117
+ }
118
+
119
+ export {
120
+ aliveDir,
121
+ runAliveHook,
122
+ sessionServedByPlugin,
123
+ readAliveStamp,
124
+ removeAliveState,
125
+ aliveMain,
126
+ markSessionServed
127
+ };
128
+ //# sourceMappingURL=chunk-6W5GYG3W.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/router/alive.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdir, readdir, readFile, rm, rmdir, stat, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n/**\n * THE PLUGIN SAYS IT IS HERE. While a machine carries both the plugin and the\n * settings install it replaces, every event would run two sets of routing legs\n * and offer the same lookup twice. The plugin's `SessionStart` entry runs\n * `tenjin hook alive` before any other event of the session, and it writes:\n *\n * - a per-session marker, which every leg a settings install launched checks\n * first, staying silent in a session the plugin serves;\n * - a per-machine stamp, the proof the guarded migration waits for: the plugin\n * has loaded in a real session on this machine at least once, so the\n * settings install can be removed without leaving the machine unrouted.\n *\n * Outside `progress/`, whose files are pruned after ten minutes. Markers are\n * pruned here after a week, which outlasts any session that still matters.\n *\n * SHIM: the per-session check goes on or after 2026-12-01, the first release\n * cut 30 or more days after the plugin PR 2 ships; the stamp stays for doctor.\n */\n\nconst MARKER_TTL_MS = 7 * 24 * 60 * 60 * 1000;\nconst STAMP = 'plugin-loaded.json';\n/** A session id names a file only through its hash, so any string is safe. */\nconst MAX_SESSION_ID = 200;\n\nexport function aliveDir(dataDir: string): string {\n return join(dataDir, 'alive');\n}\n\nfunction markerName(sessionId: string): string {\n return createHash('sha256').update(sessionId).digest('hex').slice(0, 32);\n}\n\nfunction sessionIdOf(event: unknown): string | null {\n if (event === null || typeof event !== 'object') return null;\n const id = (event as { session_id?: unknown }).session_id;\n return typeof id === 'string' && id.length > 0 && id.length <= MAX_SESSION_ID ? id : null;\n}\n\nexport interface AliveStamp {\n at: string;\n /** The CLI version whose plugin loaded. */\n version: string;\n}\n\n/**\n * The `alive` leg: marker, stamp, prune. It prints nothing, because a\n * `SessionStart` hook's stdout is added to the session's context, and it never\n * fails the session: every error is swallowed.\n */\nexport async function runAliveHook(\n event: unknown,\n opts: { dataDir: string; version: string; now?: number },\n): Promise<void> {\n const sessionId = sessionIdOf(event);\n const now = opts.now ?? Date.now();\n const dir = aliveDir(opts.dataDir);\n try {\n await mkdir(dir, { recursive: true, mode: 0o700 });\n if (sessionId !== null) {\n await writeFile(join(dir, markerName(sessionId)), `${new Date(now).toISOString()}\\n`);\n }\n const stamp: AliveStamp = { at: new Date(now).toISOString(), version: opts.version };\n await writeFile(join(dir, STAMP), `${JSON.stringify(stamp)}\\n`);\n await pruneMarkers(dir, now);\n } catch {\n // A marker that could not be written costs only a duplicate offer.\n }\n}\n\nasync function pruneMarkers(dir: string, now: number): Promise<void> {\n for (const name of await readdir(dir).catch(() => [] as string[])) {\n if (!/^[0-9a-f]{32}$/.test(name)) continue;\n const path = join(dir, name);\n const s = await stat(path).catch(() => null);\n if (s !== null && now - s.mtimeMs > MARKER_TTL_MS) await rm(path, { force: true });\n }\n}\n\n/** Has the plugin's `alive` leg marked this session? False on any doubt. */\nexport async function sessionServedByPlugin(dataDir: string, event: unknown): Promise<boolean> {\n const sessionId = sessionIdOf(event);\n if (sessionId === null) return false;\n return (await stat(join(aliveDir(dataDir), markerName(sessionId))).catch(() => null)) !== null;\n}\n\n/** The machine's stamp, or null when the plugin has never loaded here. */\nexport async function readAliveStamp(dataDir: string): Promise<AliveStamp | null> {\n try {\n const parsed = JSON.parse(await readFile(join(aliveDir(dataDir), STAMP), 'utf8')) as unknown;\n if (parsed === null || typeof parsed !== 'object') return null;\n const { at, version } = parsed as { at?: unknown; version?: unknown };\n return typeof at === 'string' && typeof version === 'string' ? { at, version } : null;\n } catch {\n return null;\n }\n}\n\n/** `uninstall`: the markers and the stamp, and nothing else under the data dir. */\nexport async function removeAliveState(dataDir: string): Promise<boolean> {\n const dir = aliveDir(dataDir);\n const existed = (await stat(dir).catch(() => null)) !== null;\n if (!existed) return false;\n for (const name of await readdir(dir).catch(() => [] as string[])) {\n if (name === STAMP || /^[0-9a-f]{32}$/.test(name)) await rm(join(dir, name), { force: true });\n }\n // Only when empty: a file somebody else put there keeps the folder.\n await rmdir(dir).catch(() => undefined);\n return true;\n}\n\n/** The command form's entry, read off stdin: `tenjin hook alive`. */\nexport async function aliveMain(opts: { dataDir: string; version: string }): Promise<void> {\n const raw = await readStdin(1_000).catch(() => '');\n await runAliveHook(parseEvent(raw), opts);\n}\n\nfunction parseEvent(raw: string): unknown {\n try {\n return JSON.parse(raw) as unknown;\n } catch {\n return null;\n }\n}\n\nfunction readStdin(timeoutMs: number): Promise<string> {\n return new Promise((resolve, reject) => {\n const chunks: Buffer[] = [];\n let size = 0;\n const timer = setTimeout(() => reject(new Error('no harness event')), timeoutMs);\n process.stdin.on('data', (chunk: Buffer) => {\n size += chunk.length;\n if (size > 1_000_000) {\n clearTimeout(timer);\n reject(new Error('harness event too large'));\n return;\n }\n chunks.push(chunk);\n });\n process.stdin.once('end', () => {\n clearTimeout(timer);\n resolve(Buffer.concat(chunks).toString('utf8'));\n });\n process.stdin.once('error', () => {\n clearTimeout(timer);\n reject(new Error('harness event unreadable'));\n });\n });\n}\n\n/**\n * A plugin leg marks its own session too, for a session that loaded the plugin\n * without a `SessionStart` (a `/reload-plugins` mid-session): from the next\n * event on, the settings install's legs there stay silent. A stat when the\n * marker is already there.\n */\nexport async function markSessionServed(dataDir: string, event: unknown): Promise<void> {\n const sessionId = sessionIdOf(event);\n if (sessionId === null) return;\n const path = join(aliveDir(dataDir), markerName(sessionId));\n if ((await stat(path).catch(() => null)) !== null) return;\n try {\n await mkdir(aliveDir(dataDir), { recursive: true, mode: 0o700 });\n await writeFile(path, `${new Date().toISOString()}\\n`);\n } catch {\n // Costs only a duplicate offer.\n }\n}\n"],"mappings":"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","names":[]}
@@ -1,20 +1,18 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  emitNotice
4
- } from "./chunk-UDWGT4FX.js";
5
- import {
6
- package_default
7
- } from "./chunk-GHR4BTNJ.js";
4
+ } from "./chunk-XVTD7UWR.js";
8
5
  import {
9
6
  external_exports,
10
- loadConfig
11
- } from "./chunk-XICKN3CH.js";
12
- import {
7
+ loadConfig,
13
8
  writeFileAtomic
14
- } from "./chunk-JLEF5WHM.js";
9
+ } from "./chunk-QTND6XWJ.js";
15
10
  import {
16
11
  updateCheckPath
17
12
  } from "./chunk-K6AXXYCG.js";
13
+ import {
14
+ package_default
15
+ } from "./chunk-RLPLYUME.js";
18
16
 
19
17
  // src/lib/update-check.ts
20
18
  import { readFile } from "node:fs/promises";
@@ -191,4 +189,4 @@ export {
191
189
  fetchDistTags,
192
190
  isNewer
193
191
  };
194
- //# sourceMappingURL=chunk-W36HL4TB.js.map
192
+ //# sourceMappingURL=chunk-7H3RN4WJ.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/update-check.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { z } from 'zod';\nimport pkg from '../../package.json';\nimport { writeFileAtomic } from './atomic-json';\nimport { loadConfig } from './config';\nimport type { UpdateMode } from './config';\nimport { emitNotice } from './output';\nimport type { Io } from './output';\nimport type { UpdateAvailable } from '../schemas';\nimport { updateCheckPath } from './paths';\n\n/**\n * \"A newer tenjin-cli exists\", asked of npm at most once a day and reported\n * three ways: one dim stderr line for a human at a terminal, `updateAvailable`\n * on the JSON envelope, and a line on the generated hook scripts' output.\n *\n * It REPORTS and never installs. A CLI that starts a fresh process per\n * invocation has no deferred-activation window to hide a binary swap in — \"next\n * start\" is \"mid-session\" for whatever is driving it — so the decision to run\n * `tenjin update` belongs to the agent or the human, not to this check.\n *\n * Everything here is subordinate to the command that ran: the fetch happens\n * AFTER the envelope is written, it never touches stdout, it never changes an\n * exit code, and every failure it can have (offline, slow registry, junk JSON, a\n * tag that does not exist) is swallowed. CI skips the whole thing: a build log\n * can act on none of it. `update.mode off` is the opt-out and silences all three\n * surfaces, including the request to npm.\n */\n\n/**\n * Silences this check for one process, cache write and registry request\n * included. Set by `update` on the `install --refresh` children it spawns: their\n * data dirs come out of a settings file this CLI does not own, and this check is\n * the one thing in a refresh that would CREATE such a directory — `writeCache`\n * mkdirs the tree — where the refresh itself only converges what exists.\n *\n * A separate switch rather than `CI`, which would also stand the skills heal\n * down (lib/skill-heal) and so gut the refresh it was set for.\n */\nexport const NUDGE_OPT_OUT = 'TENJIN_NO_UPDATE_CHECK';\n\nconst CHECK_INTERVAL_MS = 86_400_000; // 24h\nconst FETCH_TIMEOUT_MS = 1500;\nconst DIST_TAGS_URL = 'https://registry.npmjs.org/-/package/tenjin-cli/dist-tags';\n\n/** What is known about ONE dist-tag: when it was asked, and what it said. */\nconst TagEntrySchema = z.object({\n checkedAtMs: z.number(),\n /** The version the tag named. Absent when the answer was unusable. */\n latest: z.string().optional(),\n /** When the nudge was last PRINTED for this tag. Absent until one has been. */\n notifiedAtMs: z.number().optional(),\n});\n\n/**\n * The cache is a pure optimization, so a bad one is re-fetched, never repaired.\n * Keyed by dist-tag: an entry this build did not ask about is carried forward\n * untouched rather than evicted.\n */\nconst CacheSchema = z.object({\n schemaVersion: z.literal(1),\n tags: z.record(z.string(), TagEntrySchema),\n /**\n * The resolved \"you could upgrade\" fact, written whenever it changes and\n * cleared when it stops being true.\n *\n * Denormalized from `tags` on purpose: the generated hook scripts are\n * standalone .mjs that cannot import this module and do not know which\n * version is running, so a per-tag entry would leave them unable to tell an\n * upgrade from a match. Storing the comparison's ANSWER is what lets a hook\n * report it without reimplementing any of it.\n */\n signal: z.object({ current: z.string(), latest: z.string() }).optional(),\n});\ntype Cache = z.infer<typeof CacheSchema>;\n\n/** `{\"latest\":\"1.2.3\",\"alpha\":\"1.3.0-alpha.1\"}` — tag names are not fixed. */\nconst DistTagsSchema = z.record(z.string(), z.string());\n\nexport interface UpdateCheckDeps {\n dir: string;\n io: Io;\n /** The global --json flag; ANDed with io.isTTY exactly as the emit path does. */\n json: boolean;\n env?: NodeJS.ProcessEnv;\n /** Clock seam (ms since epoch) for deterministic TTL tests. */\n now?: () => number;\n /** Override global fetch (tests inject a stub returning canned Responses). */\n fetchImpl?: typeof fetch;\n /** The running version; defaults to this build's. Injectable for tests. */\n currentVersion?: string;\n /** Resolved update.mode; defaults to reading the config file. */\n mode?: UpdateMode;\n}\n\n/**\n * Print the update nudge if one is due. NEVER rejects — the caller awaits it\n * between a command's output and its exit, so a throw here would replace a\n * finished command's result with an internal error.\n */\nexport async function maybeUpdate(deps: UpdateCheckDeps): Promise<void> {\n try {\n const env = deps.env ?? process.env;\n // Never in CI, in either mode: a build log cannot act on a nudge, and a\n // build machine must not silently acquire a different binary mid-pipeline.\n if (env.CI !== undefined && env.CI.length > 0) return;\n if (env[NUDGE_OPT_OUT] === '1') return;\n\n const mode = deps.mode ?? (await loadConfig(deps.dir)).update.mode;\n if (mode === 'off') return;\n\n const nowMs = (deps.now ?? Date.now)();\n const current = deps.currentVersion ?? pkg.version;\n const path = updateCheckPath(deps.dir);\n const tag = channelTag(current);\n if (tag === null) return; // a version this build cannot parse follows no channel\n\n // Only this tag's entry answers this binary's question; the other channel's\n // is neither used nor disturbed.\n const cached = await readCache(path);\n const entry = cached?.tags[tag];\n const fresh = entry !== undefined && nowMs - entry.checkedAtMs < CHECK_INTERVAL_MS;\n\n // Resolved through the same function `tenjin update` uses, so the nudge can\n // never advertise a version the command would decline to install, nor stay\n // quiet about one it would.\n //\n // Only a registry that could not be ASKED returns without caching; an answer\n // this build cannot use has still been answered, and moves the clock below.\n let latest: string | null;\n if (fresh) {\n latest = entry.latest ?? null;\n } else {\n const answer = await resolveLatest(current, deps);\n if (answer === null) return;\n latest = answer.latest;\n }\n\n const upgradeable = latest !== null && isNewer(latest, current);\n\n // Once a day means once a day, not once per FETCH: a fresh cache would\n // otherwise repeat the same line on every command for 24h. The two clocks are\n // separate because they answer separate questions — when we last asked npm,\n // and when we last interrupted the human.\n //\n // `human` is part of `due` for the second of those: this code now runs on\n // every surface, to feed the envelope signal, so without it an agent run\n // would stamp the nudge clock having printed nothing and leave a shared\n // machine's terminal quiet for 24h.\n const human = deps.io.isTTY && !deps.json;\n const notifiedAtMs = entry?.notifiedAtMs;\n const due =\n human &&\n upgradeable &&\n (notifiedAtMs === undefined || nowMs - notifiedAtMs >= CHECK_INTERVAL_MS);\n\n // Carried forward when nothing is printed: the day since the last nudge does\n // not restart just because the registry was asked again.\n const nudgedAtMs = due ? nowMs : notifiedAtMs;\n\n // Carries the agent-visible half of the answer, so a hook or an envelope can\n // report it without knowing which version is running.\n const signal = upgradeable && latest !== null ? { current, latest } : undefined;\n const signalChanged =\n cached?.signal?.current !== signal?.current || cached?.signal?.latest !== signal?.latest;\n\n // Nothing learned and nothing said means nothing to write. Deliberately NOT\n // locked: two concurrent CLI processes can both nudge, and one duplicated\n // line is cheaper than a lock on the exit path of every command.\n if (!fresh || due || signalChanged) {\n await writeCache(path, {\n schemaVersion: 1,\n ...(signal !== undefined ? { signal } : {}),\n // Read-modify-write: the tag this run did not ask about keeps whatever it\n // knew, including its own nudge clock.\n tags: {\n ...cached?.tags,\n [tag]: {\n checkedAtMs: fresh ? entry.checkedAtMs : nowMs,\n ...(latest !== null ? { latest } : {}),\n ...(nudgedAtMs !== undefined ? { notifiedAtMs: nudgedAtMs } : {}),\n },\n },\n });\n }\n\n // Named as the command, not the npm invocation it wraps: `update` prints the\n // right instructions itself for an install it cannot perform (a source\n // checkout, a yarn global), so this line is correct everywhere.\n if (due && latest !== null) {\n emitNotice(\n deps.io,\n `tenjin-cli ${latest} is available (you have ${current}). Update: run tenjin update`,\n { json: deps.json },\n );\n }\n } catch {\n // Unreachable by construction (every step below is already guarded); here so\n // that staying invisible does not depend on that remaining true.\n }\n}\n\n/**\n * What the last check learned, for the envelope. Cache only: this runs before\n * every command's output, so it may not fetch, may not block, and may not throw.\n * Null when nothing newer is known, when the cache is absent or stale-shaped, or\n * when `update.mode` is `off` — off silences BOTH surfaces, not just the line a\n * human sees.\n *\n * Reporting rather than installing is the whole design. A CLI that starts a\n * fresh process per invocation has no deferred-activation moment to hide a\n * binary swap in, so the agent is told and decides for itself.\n */\nexport async function readUpdateSignal(\n dir: string,\n currentVersion?: string,\n): Promise<UpdateAvailable | null> {\n try {\n const current = currentVersion ?? pkg.version;\n const tag = channelTag(current);\n if (tag === null) return null;\n if ((await loadConfig(dir)).update.mode === 'off') return null;\n const cached = await readCache(updateCheckPath(dir));\n const latest = cached?.tags[tag]?.latest;\n if (latest === undefined || !isNewer(latest, current)) return null;\n return { current, latest };\n } catch {\n return null; // never the command's business\n }\n}\n\n/**\n * Which dist-tag this build follows, or null for a version string this package\n * has no channel for. Null rather than a default, because every caller's right\n * answer differs: the nudge goes quiet, and `tenjin update` refuses instead of\n * silently reporting a foreign build \"up to date\" against a tag it never\n * belonged to.\n *\n * Every build follows `latest`; see RELEASING.md, which changes with this.\n */\nexport function channelTag(version: string): 'latest' | null {\n return parseVersion(version) === null ? null : 'latest';\n}\n\n/**\n * The version this build can move to: whatever sits on the tag it follows.\n * Consulting a second tag added no reachable version and one way to be wrong: a\n * tag sitting ahead of `latest` could redirect the self-update to a build the\n * release line never promoted. Null both when that tag is absent and when it\n * names a version VERSION_RE rejects; `runUpdate` separates those, and neither\n * means the registry was unreachable.\n */\nexport function resolveTarget(current: string, tags: Record<string, string>): string | null {\n const channel = channelTag(current);\n if (channel === null) return null;\n const candidate = tags[channel];\n // Unparseable counts as absent: isNewer loses every comparison against junk,\n // so admitting one would read as \"up to date\" forever.\n if (candidate === undefined || parseVersion(candidate) === null) return null;\n return candidate;\n}\n\n/**\n * Ask the registry for tenjin-cli's whole dist-tag map. Returns null for every\n * failure there is, INCLUDING a response that arrives too late — the AbortSignal\n * is what bounds the delay a finished command can suffer. Nothing is written\n * here: a failed check caches nothing, so the next command retries rather than\n * going quiet for 24h over one dropped packet. The nudge passes its own short\n * budget; `tenjin update` passes the run's request timeout, because there the\n * fetch IS the command rather than a stowaway on someone else's exit path.\n *\n * The whole map rather than one tag, so a caller can tell an unreachable\n * registry (null) from one that answered without the tag it asked for (a map\n * that lacks the key) — two failures with two different fixes.\n */\nexport async function fetchDistTags(opts: {\n fetchImpl?: typeof fetch;\n timeoutMs: number;\n}): Promise<Record<string, string> | null> {\n const doFetch = opts.fetchImpl ?? fetch;\n let json: unknown;\n try {\n const res = await doFetch(DIST_TAGS_URL, { signal: AbortSignal.timeout(opts.timeoutMs) });\n if (!res.ok) return null;\n json = await res.json();\n } catch {\n return null;\n }\n const parsed = DistTagsSchema.safeParse(json);\n return parsed.success ? parsed.data : null;\n}\n\n/**\n * The nudge's one-shot: fetch, then resolve. Null when the registry could not be\n * asked; `{ latest: null }` when it answered with nothing usable.\n */\nasync function resolveLatest(\n current: string,\n deps: UpdateCheckDeps,\n): Promise<{ latest: string | null } | null> {\n const tags = await fetchDistTags({ fetchImpl: deps.fetchImpl, timeoutMs: FETCH_TIMEOUT_MS });\n return tags === null ? null : { latest: resolveTarget(current, tags) };\n}\n\nasync function writeCache(path: string, cache: Cache): Promise<void> {\n await writeFileAtomic(path, `${JSON.stringify(cache, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n}\n\nasync function readCache(path: string): Promise<Cache | null> {\n try {\n const parsed = CacheSchema.safeParse(JSON.parse(await readFile(path, 'utf8')));\n return parsed.success ? parsed.data : null;\n } catch {\n return null;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Version comparison: this package's shape only, no semver dependency.\n// ---------------------------------------------------------------------------\n\n/** `major.minor.patch` with an optional `-alpha.N` — every version tenjin-cli\n * has ever published. Anything else is unparseable ON PURPOSE (see isNewer). */\nconst VERSION_RE = /^(\\d+)\\.(\\d+)\\.(\\d+)(?:-alpha\\.(\\d+))?$/;\n\ninterface Version {\n major: number;\n minor: number;\n patch: number;\n /** null = a release; a number = that prerelease counter. */\n alpha: number | null;\n}\n\nfunction parseVersion(raw: string): Version | null {\n const m = VERSION_RE.exec(raw);\n if (m === null) return null;\n const [, major, minor, patch, alpha] = m;\n if (major === undefined || minor === undefined || patch === undefined) return null;\n return {\n major: Number(major),\n minor: Number(minor),\n patch: Number(patch),\n alpha: alpha !== undefined ? Number(alpha) : null,\n };\n}\n\n/**\n * Is `candidate` newer than `current`? An unparseable version on EITHER side is\n * \"not newer\": the registry is untrusted input, and the failure mode of guessing\n * is nagging every single command with a line the user cannot act on. A true\n * return therefore also certifies that BOTH sides parse, which is what lets\n * `tenjin update` splice the candidate into an npm argv without re-validating.\n */\nexport function isNewer(candidate: string, current: string): boolean {\n const a = parseVersion(candidate);\n const b = parseVersion(current);\n if (a === null || b === null) return false;\n if (a.major !== b.major) return a.major > b.major;\n if (a.minor !== b.minor) return a.minor > b.minor;\n if (a.patch !== b.patch) return a.patch > b.patch;\n // Same release triple: semver says a prerelease precedes its own release, so\n // 0.1.0 beats 0.1.0-alpha.9 and never the other way around.\n if (a.alpha === null) return b.alpha !== null;\n if (b.alpha === null) return false;\n return a.alpha > b.alpha;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AAuClB,IAAM,gBAAgB;AAE7B,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AACzB,IAAM,gBAAgB;AAGtB,IAAM,iBAAiB,iBAAE,OAAO;AAAA,EAC9B,aAAa,iBAAE,OAAO;AAAA;AAAA,EAEtB,QAAQ,iBAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAE5B,cAAc,iBAAE,OAAO,EAAE,SAAS;AACpC,CAAC;AAOD,IAAM,cAAc,iBAAE,OAAO;AAAA,EAC3B,eAAe,iBAAE,QAAQ,CAAC;AAAA,EAC1B,MAAM,iBAAE,OAAO,iBAAE,OAAO,GAAG,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWzC,QAAQ,iBAAE,OAAO,EAAE,SAAS,iBAAE,OAAO,GAAG,QAAQ,iBAAE,OAAO,EAAE,CAAC,EAAE,SAAS;AACzE,CAAC;AAID,IAAM,iBAAiB,iBAAE,OAAO,iBAAE,OAAO,GAAG,iBAAE,OAAO,CAAC;AAuBtD,eAAsB,YAAY,MAAsC;AACtE,MAAI;AACF,UAAM,MAAM,KAAK,OAAO,QAAQ;AAGhC,QAAI,IAAI,OAAO,UAAa,IAAI,GAAG,SAAS,EAAG;AAC/C,QAAI,IAAI,aAAa,MAAM,IAAK;AAEhC,UAAM,OAAO,KAAK,SAAS,MAAM,WAAW,KAAK,GAAG,GAAG,OAAO;AAC9D,QAAI,SAAS,MAAO;AAEpB,UAAM,SAAS,KAAK,OAAO,KAAK,KAAK;AACrC,UAAM,UAAU,KAAK,kBAAkB,gBAAI;AAC3C,UAAM,OAAO,gBAAgB,KAAK,GAAG;AACrC,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,QAAQ,KAAM;AAIlB,UAAM,SAAS,MAAM,UAAU,IAAI;AACnC,UAAM,QAAQ,QAAQ,KAAK,GAAG;AAC9B,UAAM,QAAQ,UAAU,UAAa,QAAQ,MAAM,cAAc;AAQjE,QAAI;AACJ,QAAI,OAAO;AACT,eAAS,MAAM,UAAU;AAAA,IAC3B,OAAO;AACL,YAAM,SAAS,MAAM,cAAc,SAAS,IAAI;AAChD,UAAI,WAAW,KAAM;AACrB,eAAS,OAAO;AAAA,IAClB;AAEA,UAAM,cAAc,WAAW,QAAQ,QAAQ,QAAQ,OAAO;AAW9D,UAAM,QAAQ,KAAK,GAAG,SAAS,CAAC,KAAK;AACrC,UAAM,eAAe,OAAO;AAC5B,UAAM,MACJ,SACA,gBACC,iBAAiB,UAAa,QAAQ,gBAAgB;AAIzD,UAAM,aAAa,MAAM,QAAQ;AAIjC,UAAM,SAAS,eAAe,WAAW,OAAO,EAAE,SAAS,OAAO,IAAI;AACtE,UAAM,gBACJ,QAAQ,QAAQ,YAAY,QAAQ,WAAW,QAAQ,QAAQ,WAAW,QAAQ;AAKpF,QAAI,CAAC,SAAS,OAAO,eAAe;AAClC,YAAM,WAAW,MAAM;AAAA,QACrB,eAAe;AAAA,QACf,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;AAAA;AAAA;AAAA,QAGzC,MAAM;AAAA,UACJ,GAAG,QAAQ;AAAA,UACX,CAAC,GAAG,GAAG;AAAA,YACL,aAAa,QAAQ,MAAM,cAAc;AAAA,YACzC,GAAI,WAAW,OAAO,EAAE,OAAO,IAAI,CAAC;AAAA,YACpC,GAAI,eAAe,SAAY,EAAE,cAAc,WAAW,IAAI,CAAC;AAAA,UACjE;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAKA,QAAI,OAAO,WAAW,MAAM;AAC1B;AAAA,QACE,KAAK;AAAA,QACL,cAAc,MAAM,2BAA2B,OAAO;AAAA,QACtD,EAAE,MAAM,KAAK,KAAK;AAAA,MACpB;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAGR;AACF;AAaA,eAAsB,iBACpB,KACA,gBACiC;AACjC,MAAI;AACF,UAAM,UAAU,kBAAkB,gBAAI;AACtC,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,QAAQ,KAAM,QAAO;AACzB,SAAK,MAAM,WAAW,GAAG,GAAG,OAAO,SAAS,MAAO,QAAO;AAC1D,UAAM,SAAS,MAAM,UAAU,gBAAgB,GAAG,CAAC;AACnD,UAAM,SAAS,QAAQ,KAAK,GAAG,GAAG;AAClC,QAAI,WAAW,UAAa,CAAC,QAAQ,QAAQ,OAAO,EAAG,QAAO;AAC9D,WAAO,EAAE,SAAS,OAAO;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,SAAS,WAAW,SAAkC;AAC3D,SAAO,aAAa,OAAO,MAAM,OAAO,OAAO;AACjD;AAUO,SAAS,cAAc,SAAiB,MAA6C;AAC1F,QAAM,UAAU,WAAW,OAAO;AAClC,MAAI,YAAY,KAAM,QAAO;AAC7B,QAAM,YAAY,KAAK,OAAO;AAG9B,MAAI,cAAc,UAAa,aAAa,SAAS,MAAM,KAAM,QAAO;AACxE,SAAO;AACT;AAeA,eAAsB,cAAc,MAGO;AACzC,QAAM,UAAU,KAAK,aAAa;AAClC,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,eAAe,EAAE,QAAQ,YAAY,QAAQ,KAAK,SAAS,EAAE,CAAC;AACxF,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,WAAO,MAAM,IAAI,KAAK;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,eAAe,UAAU,IAAI;AAC5C,SAAO,OAAO,UAAU,OAAO,OAAO;AACxC;AAMA,eAAe,cACb,SACA,MAC2C;AAC3C,QAAM,OAAO,MAAM,cAAc,EAAE,WAAW,KAAK,WAAW,WAAW,iBAAiB,CAAC;AAC3F,SAAO,SAAS,OAAO,OAAO,EAAE,QAAQ,cAAc,SAAS,IAAI,EAAE;AACvE;AAEA,eAAe,WAAW,MAAc,OAA6B;AACnE,QAAM,gBAAgB,MAAM,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA,GAAM;AAAA,IACjE,MAAM;AAAA,IACN,SAAS;AAAA,EACX,CAAC;AACH;AAEA,eAAe,UAAU,MAAqC;AAC5D,MAAI;AACF,UAAM,SAAS,YAAY,UAAU,KAAK,MAAM,MAAM,SAAS,MAAM,MAAM,CAAC,CAAC;AAC7E,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQA,IAAM,aAAa;AAUnB,SAAS,aAAa,KAA6B;AACjD,QAAM,IAAI,WAAW,KAAK,GAAG;AAC7B,MAAI,MAAM,KAAM,QAAO;AACvB,QAAM,CAAC,EAAE,OAAO,OAAO,OAAO,KAAK,IAAI;AACvC,MAAI,UAAU,UAAa,UAAU,UAAa,UAAU,OAAW,QAAO;AAC9E,SAAO;AAAA,IACL,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,UAAU,SAAY,OAAO,KAAK,IAAI;AAAA,EAC/C;AACF;AASO,SAAS,QAAQ,WAAmB,SAA0B;AACnE,QAAM,IAAI,aAAa,SAAS;AAChC,QAAM,IAAI,aAAa,OAAO;AAC9B,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAG5C,MAAI,EAAE,UAAU,KAAM,QAAO,EAAE,UAAU;AACzC,MAAI,EAAE,UAAU,KAAM,QAAO;AAC7B,SAAO,EAAE,QAAQ,EAAE;AACrB;","names":[]}
1
+ {"version":3,"sources":["../src/lib/update-check.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { z } from 'zod';\nimport pkg from '../../package.json';\nimport { writeFileAtomic } from './atomic-json';\nimport { loadConfig } from './config';\nimport type { UpdateMode } from './config';\nimport { emitNotice } from './output';\nimport type { Io } from './output';\nimport type { UpdateAvailable } from '../schemas';\nimport { updateCheckPath } from './paths';\n\n/**\n * \"A newer tenjin-cli exists\", asked of npm at most once a day and reported\n * three ways: one dim stderr line for a human at a terminal, `updateAvailable`\n * on the JSON envelope, and a line on the generated hook scripts' output.\n *\n * It REPORTS and never installs. A CLI that starts a fresh process per\n * invocation has no deferred-activation window to hide a binary swap in — \"next\n * start\" is \"mid-session\" for whatever is driving it — so the decision to run\n * `tenjin update` belongs to the agent or the human, not to this check.\n *\n * Everything here is subordinate to the command that ran: the fetch happens\n * AFTER the envelope is written, it never touches stdout, it never changes an\n * exit code, and every failure it can have (offline, slow registry, junk JSON, a\n * tag that does not exist) is swallowed. CI skips the whole thing: a build log\n * can act on none of it. `update.mode off` is the opt-out and silences all three\n * surfaces, including the request to npm.\n */\n\n/**\n * Silences this check for one process, cache write and registry request\n * included. Set by `update` on the `install --refresh` children it spawns: their\n * data dirs come out of a settings file this CLI does not own, and this check is\n * the one thing in a refresh that would CREATE such a directory — `writeCache`\n * mkdirs the tree — where the refresh itself only converges what exists.\n *\n * A separate switch rather than `CI`, which would also stand the skills heal\n * down (lib/skill-heal) and so gut the refresh it was set for.\n */\nexport const NUDGE_OPT_OUT = 'TENJIN_NO_UPDATE_CHECK';\n\nconst CHECK_INTERVAL_MS = 86_400_000; // 24h\nconst FETCH_TIMEOUT_MS = 1500;\nconst DIST_TAGS_URL = 'https://registry.npmjs.org/-/package/tenjin-cli/dist-tags';\n\n/** What is known about ONE dist-tag: when it was asked, and what it said. */\nconst TagEntrySchema = z.object({\n checkedAtMs: z.number(),\n /** The version the tag named. Absent when the answer was unusable. */\n latest: z.string().optional(),\n /** When the nudge was last PRINTED for this tag. Absent until one has been. */\n notifiedAtMs: z.number().optional(),\n});\n\n/**\n * The cache is a pure optimization, so a bad one is re-fetched, never repaired.\n * Keyed by dist-tag: an entry this build did not ask about is carried forward\n * untouched rather than evicted.\n */\nconst CacheSchema = z.object({\n schemaVersion: z.literal(1),\n tags: z.record(z.string(), TagEntrySchema),\n /**\n * The resolved \"you could upgrade\" fact, written whenever it changes and\n * cleared when it stops being true.\n *\n * Denormalized from `tags` on purpose: the generated hook scripts are\n * standalone .mjs that cannot import this module and do not know which\n * version is running, so a per-tag entry would leave them unable to tell an\n * upgrade from a match. Storing the comparison's ANSWER is what lets a hook\n * report it without reimplementing any of it.\n */\n signal: z.object({ current: z.string(), latest: z.string() }).optional(),\n});\ntype Cache = z.infer<typeof CacheSchema>;\n\n/** `{\"latest\":\"1.2.3\",\"alpha\":\"1.3.0-alpha.1\"}` — tag names are not fixed. */\nconst DistTagsSchema = z.record(z.string(), z.string());\n\nexport interface UpdateCheckDeps {\n dir: string;\n io: Io;\n /** The global --json flag; ANDed with io.isTTY exactly as the emit path does. */\n json: boolean;\n env?: NodeJS.ProcessEnv;\n /** Clock seam (ms since epoch) for deterministic TTL tests. */\n now?: () => number;\n /** Override global fetch (tests inject a stub returning canned Responses). */\n fetchImpl?: typeof fetch;\n /** The running version; defaults to this build's. Injectable for tests. */\n currentVersion?: string;\n /** Resolved update.mode; defaults to reading the config file. */\n mode?: UpdateMode;\n}\n\n/**\n * Print the update nudge if one is due. NEVER rejects — the caller awaits it\n * between a command's output and its exit, so a throw here would replace a\n * finished command's result with an internal error.\n */\nexport async function maybeUpdate(deps: UpdateCheckDeps): Promise<void> {\n try {\n const env = deps.env ?? process.env;\n // Never in CI, in either mode: a build log cannot act on a nudge, and a\n // build machine must not silently acquire a different binary mid-pipeline.\n if (env.CI !== undefined && env.CI.length > 0) return;\n if (env[NUDGE_OPT_OUT] === '1') return;\n\n const mode = deps.mode ?? (await loadConfig(deps.dir)).update.mode;\n if (mode === 'off') return;\n\n const nowMs = (deps.now ?? Date.now)();\n const current = deps.currentVersion ?? pkg.version;\n const path = updateCheckPath(deps.dir);\n const tag = channelTag(current);\n if (tag === null) return; // a version this build cannot parse follows no channel\n\n // Only this tag's entry answers this binary's question; the other channel's\n // is neither used nor disturbed.\n const cached = await readCache(path);\n const entry = cached?.tags[tag];\n const fresh = entry !== undefined && nowMs - entry.checkedAtMs < CHECK_INTERVAL_MS;\n\n // Resolved through the same function `tenjin update` uses, so the nudge can\n // never advertise a version the command would decline to install, nor stay\n // quiet about one it would.\n //\n // Only a registry that could not be ASKED returns without caching; an answer\n // this build cannot use has still been answered, and moves the clock below.\n let latest: string | null;\n if (fresh) {\n latest = entry.latest ?? null;\n } else {\n const answer = await resolveLatest(current, deps);\n if (answer === null) return;\n latest = answer.latest;\n }\n\n const upgradeable = latest !== null && isNewer(latest, current);\n\n // Once a day means once a day, not once per FETCH: a fresh cache would\n // otherwise repeat the same line on every command for 24h. The two clocks are\n // separate because they answer separate questions — when we last asked npm,\n // and when we last interrupted the human.\n //\n // `human` is part of `due` for the second of those: this code now runs on\n // every surface, to feed the envelope signal, so without it an agent run\n // would stamp the nudge clock having printed nothing and leave a shared\n // machine's terminal quiet for 24h.\n const human = deps.io.isTTY && !deps.json;\n const notifiedAtMs = entry?.notifiedAtMs;\n const due =\n human &&\n upgradeable &&\n (notifiedAtMs === undefined || nowMs - notifiedAtMs >= CHECK_INTERVAL_MS);\n\n // Carried forward when nothing is printed: the day since the last nudge does\n // not restart just because the registry was asked again.\n const nudgedAtMs = due ? nowMs : notifiedAtMs;\n\n // Carries the agent-visible half of the answer, so a hook or an envelope can\n // report it without knowing which version is running.\n const signal = upgradeable && latest !== null ? { current, latest } : undefined;\n const signalChanged =\n cached?.signal?.current !== signal?.current || cached?.signal?.latest !== signal?.latest;\n\n // Nothing learned and nothing said means nothing to write. Deliberately NOT\n // locked: two concurrent CLI processes can both nudge, and one duplicated\n // line is cheaper than a lock on the exit path of every command.\n if (!fresh || due || signalChanged) {\n await writeCache(path, {\n schemaVersion: 1,\n ...(signal !== undefined ? { signal } : {}),\n // Read-modify-write: the tag this run did not ask about keeps whatever it\n // knew, including its own nudge clock.\n tags: {\n ...cached?.tags,\n [tag]: {\n checkedAtMs: fresh ? entry.checkedAtMs : nowMs,\n ...(latest !== null ? { latest } : {}),\n ...(nudgedAtMs !== undefined ? { notifiedAtMs: nudgedAtMs } : {}),\n },\n },\n });\n }\n\n // Named as the command, not the npm invocation it wraps: `update` prints the\n // right instructions itself for an install it cannot perform (a source\n // checkout, a yarn global), so this line is correct everywhere.\n if (due && latest !== null) {\n emitNotice(\n deps.io,\n `tenjin-cli ${latest} is available (you have ${current}). Update: run tenjin update`,\n { json: deps.json },\n );\n }\n } catch {\n // Unreachable by construction (every step below is already guarded); here so\n // that staying invisible does not depend on that remaining true.\n }\n}\n\n/**\n * What the last check learned, for the envelope. Cache only: this runs before\n * every command's output, so it may not fetch, may not block, and may not throw.\n * Null when nothing newer is known, when the cache is absent or stale-shaped, or\n * when `update.mode` is `off` — off silences BOTH surfaces, not just the line a\n * human sees.\n *\n * Reporting rather than installing is the whole design. A CLI that starts a\n * fresh process per invocation has no deferred-activation moment to hide a\n * binary swap in, so the agent is told and decides for itself.\n */\nexport async function readUpdateSignal(\n dir: string,\n currentVersion?: string,\n): Promise<UpdateAvailable | null> {\n try {\n const current = currentVersion ?? pkg.version;\n const tag = channelTag(current);\n if (tag === null) return null;\n if ((await loadConfig(dir)).update.mode === 'off') return null;\n const cached = await readCache(updateCheckPath(dir));\n const latest = cached?.tags[tag]?.latest;\n if (latest === undefined || !isNewer(latest, current)) return null;\n return { current, latest };\n } catch {\n return null; // never the command's business\n }\n}\n\n/**\n * Which dist-tag this build follows, or null for a version string this package\n * has no channel for. Null rather than a default, because every caller's right\n * answer differs: the nudge goes quiet, and `tenjin update` refuses instead of\n * silently reporting a foreign build \"up to date\" against a tag it never\n * belonged to.\n *\n * Every build follows `latest`; see RELEASING.md, which changes with this.\n */\nexport function channelTag(version: string): 'latest' | null {\n return parseVersion(version) === null ? null : 'latest';\n}\n\n/**\n * The version this build can move to: whatever sits on the tag it follows.\n * Consulting a second tag added no reachable version and one way to be wrong: a\n * tag sitting ahead of `latest` could redirect the self-update to a build the\n * release line never promoted. Null both when that tag is absent and when it\n * names a version VERSION_RE rejects; `runUpdate` separates those, and neither\n * means the registry was unreachable.\n */\nexport function resolveTarget(current: string, tags: Record<string, string>): string | null {\n const channel = channelTag(current);\n if (channel === null) return null;\n const candidate = tags[channel];\n // Unparseable counts as absent: isNewer loses every comparison against junk,\n // so admitting one would read as \"up to date\" forever.\n if (candidate === undefined || parseVersion(candidate) === null) return null;\n return candidate;\n}\n\n/**\n * Ask the registry for tenjin-cli's whole dist-tag map. Returns null for every\n * failure there is, INCLUDING a response that arrives too late — the AbortSignal\n * is what bounds the delay a finished command can suffer. Nothing is written\n * here: a failed check caches nothing, so the next command retries rather than\n * going quiet for 24h over one dropped packet. The nudge passes its own short\n * budget; `tenjin update` passes the run's request timeout, because there the\n * fetch IS the command rather than a stowaway on someone else's exit path.\n *\n * The whole map rather than one tag, so a caller can tell an unreachable\n * registry (null) from one that answered without the tag it asked for (a map\n * that lacks the key) — two failures with two different fixes.\n */\nexport async function fetchDistTags(opts: {\n fetchImpl?: typeof fetch;\n timeoutMs: number;\n}): Promise<Record<string, string> | null> {\n const doFetch = opts.fetchImpl ?? fetch;\n let json: unknown;\n try {\n const res = await doFetch(DIST_TAGS_URL, { signal: AbortSignal.timeout(opts.timeoutMs) });\n if (!res.ok) return null;\n json = await res.json();\n } catch {\n return null;\n }\n const parsed = DistTagsSchema.safeParse(json);\n return parsed.success ? parsed.data : null;\n}\n\n/**\n * The nudge's one-shot: fetch, then resolve. Null when the registry could not be\n * asked; `{ latest: null }` when it answered with nothing usable.\n */\nasync function resolveLatest(\n current: string,\n deps: UpdateCheckDeps,\n): Promise<{ latest: string | null } | null> {\n const tags = await fetchDistTags({ fetchImpl: deps.fetchImpl, timeoutMs: FETCH_TIMEOUT_MS });\n return tags === null ? null : { latest: resolveTarget(current, tags) };\n}\n\nasync function writeCache(path: string, cache: Cache): Promise<void> {\n await writeFileAtomic(path, `${JSON.stringify(cache, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n}\n\nasync function readCache(path: string): Promise<Cache | null> {\n try {\n const parsed = CacheSchema.safeParse(JSON.parse(await readFile(path, 'utf8')));\n return parsed.success ? parsed.data : null;\n } catch {\n return null;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Version comparison: this package's shape only, no semver dependency.\n// ---------------------------------------------------------------------------\n\n/** `major.minor.patch` with an optional `-alpha.N` — every version tenjin-cli\n * has ever published. Anything else is unparseable ON PURPOSE (see isNewer). */\nconst VERSION_RE = /^(\\d+)\\.(\\d+)\\.(\\d+)(?:-alpha\\.(\\d+))?$/;\n\ninterface Version {\n major: number;\n minor: number;\n patch: number;\n /** null = a release; a number = that prerelease counter. */\n alpha: number | null;\n}\n\nfunction parseVersion(raw: string): Version | null {\n const m = VERSION_RE.exec(raw);\n if (m === null) return null;\n const [, major, minor, patch, alpha] = m;\n if (major === undefined || minor === undefined || patch === undefined) return null;\n return {\n major: Number(major),\n minor: Number(minor),\n patch: Number(patch),\n alpha: alpha !== undefined ? Number(alpha) : null,\n };\n}\n\n/**\n * Is `candidate` newer than `current`? An unparseable version on EITHER side is\n * \"not newer\": the registry is untrusted input, and the failure mode of guessing\n * is nagging every single command with a line the user cannot act on. A true\n * return therefore also certifies that BOTH sides parse, which is what lets\n * `tenjin update` splice the candidate into an npm argv without re-validating.\n */\nexport function isNewer(candidate: string, current: string): boolean {\n const a = parseVersion(candidate);\n const b = parseVersion(current);\n if (a === null || b === null) return false;\n if (a.major !== b.major) return a.major > b.major;\n if (a.minor !== b.minor) return a.minor > b.minor;\n if (a.patch !== b.patch) return a.patch > b.patch;\n // Same release triple: semver says a prerelease precedes its own release, so\n // 0.1.0 beats 0.1.0-alpha.9 and never the other way around.\n if (a.alpha === null) return b.alpha !== null;\n if (b.alpha === null) return false;\n return a.alpha > b.alpha;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AAuClB,IAAM,gBAAgB;AAE7B,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AACzB,IAAM,gBAAgB;AAGtB,IAAM,iBAAiB,iBAAE,OAAO;AAAA,EAC9B,aAAa,iBAAE,OAAO;AAAA;AAAA,EAEtB,QAAQ,iBAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAE5B,cAAc,iBAAE,OAAO,EAAE,SAAS;AACpC,CAAC;AAOD,IAAM,cAAc,iBAAE,OAAO;AAAA,EAC3B,eAAe,iBAAE,QAAQ,CAAC;AAAA,EAC1B,MAAM,iBAAE,OAAO,iBAAE,OAAO,GAAG,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWzC,QAAQ,iBAAE,OAAO,EAAE,SAAS,iBAAE,OAAO,GAAG,QAAQ,iBAAE,OAAO,EAAE,CAAC,EAAE,SAAS;AACzE,CAAC;AAID,IAAM,iBAAiB,iBAAE,OAAO,iBAAE,OAAO,GAAG,iBAAE,OAAO,CAAC;AAuBtD,eAAsB,YAAY,MAAsC;AACtE,MAAI;AACF,UAAM,MAAM,KAAK,OAAO,QAAQ;AAGhC,QAAI,IAAI,OAAO,UAAa,IAAI,GAAG,SAAS,EAAG;AAC/C,QAAI,IAAI,aAAa,MAAM,IAAK;AAEhC,UAAM,OAAO,KAAK,SAAS,MAAM,WAAW,KAAK,GAAG,GAAG,OAAO;AAC9D,QAAI,SAAS,MAAO;AAEpB,UAAM,SAAS,KAAK,OAAO,KAAK,KAAK;AACrC,UAAM,UAAU,KAAK,kBAAkB,gBAAI;AAC3C,UAAM,OAAO,gBAAgB,KAAK,GAAG;AACrC,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,QAAQ,KAAM;AAIlB,UAAM,SAAS,MAAM,UAAU,IAAI;AACnC,UAAM,QAAQ,QAAQ,KAAK,GAAG;AAC9B,UAAM,QAAQ,UAAU,UAAa,QAAQ,MAAM,cAAc;AAQjE,QAAI;AACJ,QAAI,OAAO;AACT,eAAS,MAAM,UAAU;AAAA,IAC3B,OAAO;AACL,YAAM,SAAS,MAAM,cAAc,SAAS,IAAI;AAChD,UAAI,WAAW,KAAM;AACrB,eAAS,OAAO;AAAA,IAClB;AAEA,UAAM,cAAc,WAAW,QAAQ,QAAQ,QAAQ,OAAO;AAW9D,UAAM,QAAQ,KAAK,GAAG,SAAS,CAAC,KAAK;AACrC,UAAM,eAAe,OAAO;AAC5B,UAAM,MACJ,SACA,gBACC,iBAAiB,UAAa,QAAQ,gBAAgB;AAIzD,UAAM,aAAa,MAAM,QAAQ;AAIjC,UAAM,SAAS,eAAe,WAAW,OAAO,EAAE,SAAS,OAAO,IAAI;AACtE,UAAM,gBACJ,QAAQ,QAAQ,YAAY,QAAQ,WAAW,QAAQ,QAAQ,WAAW,QAAQ;AAKpF,QAAI,CAAC,SAAS,OAAO,eAAe;AAClC,YAAM,WAAW,MAAM;AAAA,QACrB,eAAe;AAAA,QACf,GAAI,WAAW,SAAY,EAAE,OAAO,IAAI,CAAC;AAAA;AAAA;AAAA,QAGzC,MAAM;AAAA,UACJ,GAAG,QAAQ;AAAA,UACX,CAAC,GAAG,GAAG;AAAA,YACL,aAAa,QAAQ,MAAM,cAAc;AAAA,YACzC,GAAI,WAAW,OAAO,EAAE,OAAO,IAAI,CAAC;AAAA,YACpC,GAAI,eAAe,SAAY,EAAE,cAAc,WAAW,IAAI,CAAC;AAAA,UACjE;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAKA,QAAI,OAAO,WAAW,MAAM;AAC1B;AAAA,QACE,KAAK;AAAA,QACL,cAAc,MAAM,2BAA2B,OAAO;AAAA,QACtD,EAAE,MAAM,KAAK,KAAK;AAAA,MACpB;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAGR;AACF;AAaA,eAAsB,iBACpB,KACA,gBACiC;AACjC,MAAI;AACF,UAAM,UAAU,kBAAkB,gBAAI;AACtC,UAAM,MAAM,WAAW,OAAO;AAC9B,QAAI,QAAQ,KAAM,QAAO;AACzB,SAAK,MAAM,WAAW,GAAG,GAAG,OAAO,SAAS,MAAO,QAAO;AAC1D,UAAM,SAAS,MAAM,UAAU,gBAAgB,GAAG,CAAC;AACnD,UAAM,SAAS,QAAQ,KAAK,GAAG,GAAG;AAClC,QAAI,WAAW,UAAa,CAAC,QAAQ,QAAQ,OAAO,EAAG,QAAO;AAC9D,WAAO,EAAE,SAAS,OAAO;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,SAAS,WAAW,SAAkC;AAC3D,SAAO,aAAa,OAAO,MAAM,OAAO,OAAO;AACjD;AAUO,SAAS,cAAc,SAAiB,MAA6C;AAC1F,QAAM,UAAU,WAAW,OAAO;AAClC,MAAI,YAAY,KAAM,QAAO;AAC7B,QAAM,YAAY,KAAK,OAAO;AAG9B,MAAI,cAAc,UAAa,aAAa,SAAS,MAAM,KAAM,QAAO;AACxE,SAAO;AACT;AAeA,eAAsB,cAAc,MAGO;AACzC,QAAM,UAAU,KAAK,aAAa;AAClC,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,MAAM,QAAQ,eAAe,EAAE,QAAQ,YAAY,QAAQ,KAAK,SAAS,EAAE,CAAC;AACxF,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,WAAO,MAAM,IAAI,KAAK;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,eAAe,UAAU,IAAI;AAC5C,SAAO,OAAO,UAAU,OAAO,OAAO;AACxC;AAMA,eAAe,cACb,SACA,MAC2C;AAC3C,QAAM,OAAO,MAAM,cAAc,EAAE,WAAW,KAAK,WAAW,WAAW,iBAAiB,CAAC;AAC3F,SAAO,SAAS,OAAO,OAAO,EAAE,QAAQ,cAAc,SAAS,IAAI,EAAE;AACvE;AAEA,eAAe,WAAW,MAAc,OAA6B;AACnE,QAAM,gBAAgB,MAAM,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA,GAAM;AAAA,IACjE,MAAM;AAAA,IACN,SAAS;AAAA,EACX,CAAC;AACH;AAEA,eAAe,UAAU,MAAqC;AAC5D,MAAI;AACF,UAAM,SAAS,YAAY,UAAU,KAAK,MAAM,MAAM,SAAS,MAAM,MAAM,CAAC,CAAC;AAC7E,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQA,IAAM,aAAa;AAUnB,SAAS,aAAa,KAA6B;AACjD,QAAM,IAAI,WAAW,KAAK,GAAG;AAC7B,MAAI,MAAM,KAAM,QAAO;AACvB,QAAM,CAAC,EAAE,OAAO,OAAO,OAAO,KAAK,IAAI;AACvC,MAAI,UAAU,UAAa,UAAU,UAAa,UAAU,OAAW,QAAO;AAC9E,SAAO;AAAA,IACL,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,OAAO,KAAK;AAAA,IACnB,OAAO,UAAU,SAAY,OAAO,KAAK,IAAI;AAAA,EAC/C;AACF;AASO,SAAS,QAAQ,WAAmB,SAA0B;AACnE,QAAM,IAAI,aAAa,SAAS;AAChC,QAAM,IAAI,aAAa,OAAO;AAC9B,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAC5C,MAAI,EAAE,UAAU,EAAE,MAAO,QAAO,EAAE,QAAQ,EAAE;AAG5C,MAAI,EAAE,UAAU,KAAM,QAAO,EAAE,UAAU;AACzC,MAAI,EAAE,UAAU,KAAM,QAAO;AAC7B,SAAO,EAAE,QAAQ,EAAE;AACrB;","names":[]}
@@ -1,10 +1,10 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  createLocalSpendAuthorizer
4
- } from "./chunk-5NUF4BHR.js";
4
+ } from "./chunk-ZP5PV3JB.js";
5
5
  import {
6
6
  emitNotice
7
- } from "./chunk-UDWGT4FX.js";
7
+ } from "./chunk-XVTD7UWR.js";
8
8
  import {
9
9
  hashAuthorization,
10
10
  hashMessage,
@@ -49,15 +49,13 @@ import {
49
49
  import {
50
50
  hasCode
51
51
  } from "./chunk-2I4QTOLB.js";
52
- import {
53
- external_exports
54
- } from "./chunk-XICKN3CH.js";
55
52
  import {
56
53
  CliError,
54
+ external_exports,
57
55
  fsyncDir,
58
56
  writeFileAtomic,
59
57
  writeFileAtomicExclusive
60
- } from "./chunk-JLEF5WHM.js";
58
+ } from "./chunk-QTND6XWJ.js";
61
59
  import {
62
60
  archivedWalletPath,
63
61
  passphraseBlobPath,
@@ -1678,4 +1676,4 @@ export {
1678
1676
  @noble/ciphers/esm/utils.js:
1679
1677
  (*! noble-ciphers - MIT License (c) 2023 Paul Miller (paulmillr.com) *)
1680
1678
  */
1681
- //# sourceMappingURL=chunk-4HAV6IFE.js.map
1679
+ //# sourceMappingURL=chunk-7R37M6WV.js.map