tenjin-cli 0.1.0-alpha.5 → 0.1.0-alpha.8

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 (121) hide show
  1. package/README.md +169 -199
  2. package/dist/{buy-YMXXVNFH.js → buy-K2G6XQY2.js} +20 -18
  3. package/dist/{candidate-H7FR4AU5.js → candidate-DJB2NNTG.js} +7 -8
  4. package/dist/{chunk-ZW3B5LWX.js → chunk-2YX6LTCD.js} +5 -5
  5. package/dist/{chunk-4WVKXKDK.js → chunk-6OE2IJMH.js} +29 -238
  6. package/dist/chunk-6OE2IJMH.js.map +1 -0
  7. package/dist/{chunk-ADJYSM45.js → chunk-6ZBZCBR7.js} +27 -13
  8. package/dist/chunk-6ZBZCBR7.js.map +1 -0
  9. package/dist/{chunk-HTDALK7M.js → chunk-B7YB4MMU.js} +15 -12
  10. package/dist/{chunk-HTDALK7M.js.map → chunk-B7YB4MMU.js.map} +1 -1
  11. package/dist/{chunk-NFSOVL3C.js → chunk-BBUYCDSG.js} +12 -3
  12. package/dist/chunk-BBUYCDSG.js.map +1 -0
  13. package/dist/chunk-C3S6725N.js +337 -0
  14. package/dist/chunk-C3S6725N.js.map +1 -0
  15. package/dist/chunk-CYRYVZPN.js +213 -0
  16. package/dist/chunk-CYRYVZPN.js.map +1 -0
  17. package/dist/{chunk-MDDGEGSW.js → chunk-DAJ56EUU.js} +3 -3
  18. package/dist/{chunk-IOPWPMT2.js → chunk-DH6D6QIO.js} +5 -5
  19. package/dist/{chunk-NJF2WENW.js → chunk-DQDGBWWH.js} +4 -2
  20. package/dist/chunk-DQDGBWWH.js.map +1 -0
  21. package/dist/chunk-EDENZN2Q.js +614 -0
  22. package/dist/chunk-EDENZN2Q.js.map +1 -0
  23. package/dist/chunk-GABYDXWL.js +190 -0
  24. package/dist/chunk-GABYDXWL.js.map +1 -0
  25. package/dist/{chunk-LAM66WFJ.js → chunk-GM4RZUVU.js} +6 -8
  26. package/dist/{chunk-LAM66WFJ.js.map → chunk-GM4RZUVU.js.map} +1 -1
  27. package/dist/{chunk-PAUXMRSF.js → chunk-J6CVKC4M.js} +73 -2
  28. package/dist/chunk-J6CVKC4M.js.map +1 -0
  29. package/dist/chunk-L6AV2Q73.js +105 -0
  30. package/dist/chunk-L6AV2Q73.js.map +1 -0
  31. package/dist/{chunk-PYNSGYBE.js → chunk-NVHQCTIC.js} +249 -552
  32. package/dist/chunk-NVHQCTIC.js.map +1 -0
  33. package/dist/{chunk-CVX6JNGD.js → chunk-OTDI5FXG.js} +3 -5
  34. package/dist/{chunk-CVX6JNGD.js.map → chunk-OTDI5FXG.js.map} +1 -1
  35. package/dist/{chunk-3IRDP7TN.js → chunk-P3FBESBB.js} +6 -4
  36. package/dist/{chunk-3IRDP7TN.js.map → chunk-P3FBESBB.js.map} +1 -1
  37. package/dist/{chunk-FU6MCSLG.js → chunk-PCLPVJ3J.js} +16 -78
  38. package/dist/chunk-PCLPVJ3J.js.map +1 -0
  39. package/dist/chunk-QB2NNV6C.js +143 -0
  40. package/dist/chunk-QB2NNV6C.js.map +1 -0
  41. package/dist/{chunk-C444K6MI.js → chunk-RGFBBNGP.js} +42 -17
  42. package/dist/{chunk-C444K6MI.js.map → chunk-RGFBBNGP.js.map} +1 -1
  43. package/dist/{chunk-TXPPMK4L.js → chunk-RGTTACP3.js} +5 -5
  44. package/dist/chunk-SGK2B724.js +67 -0
  45. package/dist/chunk-SGK2B724.js.map +1 -0
  46. package/dist/{chunk-ZDY2KY5X.js → chunk-URSGGRO4.js} +28 -11
  47. package/dist/chunk-URSGGRO4.js.map +1 -0
  48. package/dist/{chunk-5SCU253N.js → chunk-UYP7G3GZ.js} +2 -2
  49. package/dist/{chunk-ZIYVN4CD.js → chunk-VZ3AJCO5.js} +3 -5
  50. package/dist/{chunk-ZIYVN4CD.js.map → chunk-VZ3AJCO5.js.map} +1 -1
  51. package/dist/{chunk-QONTBYQW.js → chunk-WRWCDLVK.js} +4 -6
  52. package/dist/{chunk-QONTBYQW.js.map → chunk-WRWCDLVK.js.map} +1 -1
  53. package/dist/chunk-XBJ3VLWX.js +35 -0
  54. package/dist/chunk-XBJ3VLWX.js.map +1 -0
  55. package/dist/{chunk-RTJLLPFA.js → chunk-XFHZWORF.js} +123 -24
  56. package/dist/chunk-XFHZWORF.js.map +1 -0
  57. package/dist/{chunk-BIKAUVC2.js → chunk-ZA3RFDAV.js} +40 -6
  58. package/dist/chunk-ZA3RFDAV.js.map +1 -0
  59. package/dist/{cli-IW76QTN3.js → cli-KNCYWMAG.js} +237 -25
  60. package/dist/cli-KNCYWMAG.js.map +1 -0
  61. package/dist/{config-VCOS7P5K.js → config-SAQEQRFB.js} +5 -6
  62. package/dist/dist-U4M6QCKE.js +2842 -0
  63. package/dist/dist-U4M6QCKE.js.map +1 -0
  64. package/dist/{doctor-WS65JG3V.js → doctor-FBRQNOUQ.js} +10 -9
  65. package/dist/{publish-DSFWQRUN.js → edit-IZZ2HIMR.js} +20 -18
  66. package/dist/index.js +1 -1
  67. package/dist/{inspect-SFJWUQHO.js → inspect-BFWZ5XOP.js} +17 -16
  68. package/dist/{install-RVPQPCKH.js → install-QXZCHIBT.js} +400 -166
  69. package/dist/install-QXZCHIBT.js.map +1 -0
  70. package/dist/outcome-VXCBEGNC.js +20 -0
  71. package/dist/publish-5NTCRF2V.js +40 -0
  72. package/dist/read-T6OTMU72.js +158 -0
  73. package/dist/read-T6OTMU72.js.map +1 -0
  74. package/dist/{run-OMPKA43G.js → run-5OGX64IY.js} +106 -32
  75. package/dist/{run-OMPKA43G.js.map → run-5OGX64IY.js.map} +1 -1
  76. package/dist/search-LIIWUMWV.js +24 -0
  77. package/dist/{send-3G4C64HJ.js → send-ENE47KQE.js} +7 -7
  78. package/dist/session-HY4QIWHV.js +87 -0
  79. package/dist/session-HY4QIWHV.js.map +1 -0
  80. package/dist/{wallet-PP22LAX7.js → wallet-OCCGEH6H.js} +7 -7
  81. package/dist/{wallet-B7KJS2R5.js → wallet-RBDVNZVR.js} +5 -5
  82. package/dist/wallet-RBDVNZVR.js.map +1 -0
  83. package/docs/agent-permissions.md +255 -0
  84. package/package.json +3 -1
  85. package/skills/tenjin/SKILL.md +57 -13
  86. package/skills/tenjin-publish/SKILL.md +12 -4
  87. package/skills/tenjin-search/SKILL.md +68 -12
  88. package/dist/chunk-2JQ5JSG6.js +0 -68
  89. package/dist/chunk-2JQ5JSG6.js.map +0 -1
  90. package/dist/chunk-4WVKXKDK.js.map +0 -1
  91. package/dist/chunk-ADJYSM45.js.map +0 -1
  92. package/dist/chunk-BIKAUVC2.js.map +0 -1
  93. package/dist/chunk-FU6MCSLG.js.map +0 -1
  94. package/dist/chunk-L4IHCN6B.js +0 -63
  95. package/dist/chunk-L4IHCN6B.js.map +0 -1
  96. package/dist/chunk-NFSOVL3C.js.map +0 -1
  97. package/dist/chunk-NJF2WENW.js.map +0 -1
  98. package/dist/chunk-PAUXMRSF.js.map +0 -1
  99. package/dist/chunk-PYNSGYBE.js.map +0 -1
  100. package/dist/chunk-RTJLLPFA.js.map +0 -1
  101. package/dist/chunk-ZDY2KY5X.js.map +0 -1
  102. package/dist/cli-IW76QTN3.js.map +0 -1
  103. package/dist/install-RVPQPCKH.js.map +0 -1
  104. package/dist/outcome-GNYCSZ7J.js +0 -20
  105. package/dist/search-KOI6Y7P6.js +0 -24
  106. /package/dist/{buy-YMXXVNFH.js.map → buy-K2G6XQY2.js.map} +0 -0
  107. /package/dist/{candidate-H7FR4AU5.js.map → candidate-DJB2NNTG.js.map} +0 -0
  108. /package/dist/{chunk-ZW3B5LWX.js.map → chunk-2YX6LTCD.js.map} +0 -0
  109. /package/dist/{chunk-MDDGEGSW.js.map → chunk-DAJ56EUU.js.map} +0 -0
  110. /package/dist/{chunk-IOPWPMT2.js.map → chunk-DH6D6QIO.js.map} +0 -0
  111. /package/dist/{chunk-TXPPMK4L.js.map → chunk-RGTTACP3.js.map} +0 -0
  112. /package/dist/{chunk-5SCU253N.js.map → chunk-UYP7G3GZ.js.map} +0 -0
  113. /package/dist/{config-VCOS7P5K.js.map → config-SAQEQRFB.js.map} +0 -0
  114. /package/dist/{doctor-WS65JG3V.js.map → doctor-FBRQNOUQ.js.map} +0 -0
  115. /package/dist/{inspect-SFJWUQHO.js.map → edit-IZZ2HIMR.js.map} +0 -0
  116. /package/dist/{outcome-GNYCSZ7J.js.map → inspect-BFWZ5XOP.js.map} +0 -0
  117. /package/dist/{publish-DSFWQRUN.js.map → outcome-VXCBEGNC.js.map} +0 -0
  118. /package/dist/{search-KOI6Y7P6.js.map → publish-5NTCRF2V.js.map} +0 -0
  119. /package/dist/{wallet-B7KJS2R5.js.map → search-LIIWUMWV.js.map} +0 -0
  120. /package/dist/{send-3G4C64HJ.js.map → send-ENE47KQE.js.map} +0 -0
  121. /package/dist/{wallet-PP22LAX7.js.map → wallet-OCCGEH6H.js.map} +0 -0
@@ -1,15 +1,22 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
+ import {
3
+ isSessionPresentable,
4
+ readSessionFile
5
+ } from "./chunk-GABYDXWL.js";
2
6
  import {
3
7
  walletFileExists
4
- } from "./chunk-QONTBYQW.js";
8
+ } from "./chunk-WRWCDLVK.js";
5
9
  import {
6
10
  CLIENT_HEADER,
7
- fetchJson,
8
- trimSlash
9
- } from "./chunk-ZDY2KY5X.js";
11
+ fetchJson
12
+ } from "./chunk-URSGGRO4.js";
13
+ import {
14
+ trimSlash,
15
+ tryOriginOf
16
+ } from "./chunk-XBJ3VLWX.js";
10
17
  import {
11
18
  sanitizeForTerminal
12
- } from "./chunk-NFSOVL3C.js";
19
+ } from "./chunk-BBUYCDSG.js";
13
20
  import {
14
21
  CLI_SKILL_NAMES,
15
22
  HOSTED_SKILL_NAME,
@@ -27,11 +34,12 @@ import {
27
34
  resolveSettings,
28
35
  shadowedCliSkills,
29
36
  toMoney
30
- } from "./chunk-5SCU253N.js";
37
+ } from "./chunk-UYP7G3GZ.js";
31
38
  import {
32
39
  CliError,
33
- configPath
34
- } from "./chunk-PAUXMRSF.js";
40
+ configPath,
41
+ sessionPath
42
+ } from "./chunk-J6CVKC4M.js";
35
43
 
36
44
  // src/commands/doctor.ts
37
45
  import { styleText } from "util";
@@ -50,6 +58,11 @@ var ALWAYS_SAFE_ALLOWLIST = [
50
58
  command: "tenjin inspect",
51
59
  note: "Free pre-purchase card and preview. Never signs, never pays, never saves."
52
60
  },
61
+ {
62
+ rule: "Bash(tenjin read:*)",
63
+ command: "tenjin read",
64
+ note: "Free-only delivery: free pieces, local-library re-reads, and pieces this wallet already owns when a read-scoped session key is cached. Cannot spend and cannot open the keystore \u2014 the wallet, payment, and session-MINTING modules are all absent from its import graph, so the key it may present is a P-256 delegation loaded from disk, which is the wrong curve to authorize a payment. TRANSMITS A CREDENTIAL: when a session key exists, a cold 402 sends that wallet-derived delegation to the server. It goes only to the origin the delegation was minted for, which is what stops a stray `--base-url` from redirecting it, and no scope on it limits what a holder could do with it. Not read-only: a freshly delivered piece is saved to the library."
65
+ },
53
66
  {
54
67
  rule: "Bash(tenjin outcome:*)",
55
68
  command: "tenjin outcome",
@@ -86,6 +99,11 @@ var OPT_IN_ALLOWLIST = [
86
99
  rule: "Bash(tenjin buy:*)",
87
100
  command: "tenjin buy",
88
101
  note: "SPENDS USDC on Base, unrefundably. This authorizes UNATTENDED purchases: `--yes` is an ordinary flag on the same allowlisted verb and it clears the confirm gate, so on the default config nothing stops a spend up to your wallet balance. Set a real ceiling first with `tenjin config set maxAutoSpend <usd>` and `tenjin config set sessionBudget <usd>` (sessionBudget 0 means NO ceiling, not a zero one). This line never raises a spend cap by itself, but do not read that as a human being on every purchase. Fund small."
102
+ },
103
+ {
104
+ rule: "Bash(tenjin session start:*)",
105
+ command: "tenjin session start",
106
+ note: "OPENS THE KEYSTORE (one wallet signature), but SPENDS NOTHING and cannot: it mints a \u226424h P-256 session key so `tenjin read` can recover pieces you already own without paying. The delegated key is the wrong curve for a payment authorization, so no session file can ever move money. Do NOT read the `read` scope as a bound on the rest: the file it leaves is a wallet-derived credential, and what limits it is that it expires in 24h, lives 0600, and is refused off the origin it was minted for \u2014 not its scope. What you are opting into is unattended keystore access: on an encrypted wallet the passphrase prompt is skipped or answered from the environment, and the `--base-url` caveat below bites hardest here, because a mint against an attacker-chosen host is a wallet signature you did not intend to make."
89
107
  }
90
108
  ];
91
109
  var NEVER_ALLOWLISTED = [
@@ -97,6 +115,10 @@ var NEVER_ALLOWLISTED = [
97
115
  command: "tenjin publish",
98
116
  reason: "Puts your content on a public marketplace under your identity."
99
117
  },
118
+ {
119
+ command: "tenjin edit",
120
+ reason: "Write-capable despite the no-flag form reading as a pure show: it edits live posts and answer cards under your identity, and moves prices. A prefix rule pins the verb, not the flags, so no rule can clear the read half without clearing the write half."
121
+ },
100
122
  {
101
123
  command: "tenjin wallet create",
102
124
  reason: "Creates the payment credential; a stray run is a wallet you did not mean to have."
@@ -120,18 +142,22 @@ var NEVER_ALLOWLISTED = [
120
142
  ];
121
143
  var FLAG_CAVEAT = [
122
144
  "Caveat: a prefix rule pins the VERB, not the flags. Every line above also clears",
123
- "`--base-url <url>` on that verb, which re-points where the question, the probe, and",
124
- "(for buy) the signature and payment go. Allowlist these verbs only if you are content",
125
- "for the agent to choose the destination host, and set the base URL in config instead of",
126
- "letting it be an argument. The skills tell agents never to pass --base-url on an",
127
- "allowlisted verb, but that is a convention, not an enforced boundary."
145
+ "`--base-url <url>` on that verb, which re-points where the question, the probe, the",
146
+ "session key `read` may present, and (for buy) the signature and payment go. Signed",
147
+ "and credential-bearing traffic is NOT confined to the paying verb: `read` is in the",
148
+ "safe tier and still transmits a wallet-derived delegation once one is cached, which is",
149
+ "why that delegation is bound to the origin it was minted for and refused elsewhere.",
150
+ "Allowlist these verbs only if you are content for the agent to choose the destination",
151
+ "host, and set the base URL in config instead of letting it be an argument. The skills",
152
+ "tell agents never to pass --base-url on an allowlisted verb, but that is a convention,",
153
+ "not an enforced boundary."
128
154
  ];
129
155
  var MCP_CAVEAT = [
130
156
  "Running the local MCP server (`tenjin mcp`) instead? That is a different permission",
131
157
  "surface: the harness gates TOOLS there, and these Bash rules do not apply. Leave",
132
- "`mcp__tenjin__tenjin_publish` and `mcp__tenjin__tenjin_wallet` gated, and treat",
133
- "`mcp__tenjin__tenjin_candidate` as gated for its add/drop actions. `tenjin_buy` is the",
134
- "same opt-in decision as the buy line above."
158
+ "`mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`, and",
159
+ "`mcp__tenjin__tenjin_wallet` gated, and treat `mcp__tenjin__tenjin_candidate` as gated",
160
+ "for its add/drop actions. `tenjin_buy` is the same opt-in decision as the buy line above."
135
161
  ];
136
162
  function recommendedPermissions() {
137
163
  return {
@@ -146,12 +172,16 @@ function renderPermissionsBlock() {
146
172
  "Auto-mode permission allowlist (add these once, then agents stop being denied):"
147
173
  ];
148
174
  for (const e of ALWAYS_SAFE_ALLOWLIST) lines.push(` ${e.rule}`);
149
- lines.push(" Free: no wallet, no signing, no payment. Not all read-only, though:");
150
- lines.push(" `search` and `outcome` POST to the marketplace (a question, a report).");
175
+ lines.push(" Free: cannot spend and cannot open the keystore. Not all read-only, though:");
176
+ lines.push(" `search` and `outcome` POST to the marketplace (a question, a report),");
177
+ lines.push(" and `read` saves a delivered piece to your local library. `read` may also");
178
+ lines.push(" PRESENT a cached session key \u2014 a wallet-derived credential \u2014 to the origin it");
179
+ lines.push(" was minted for. It cannot mint one and cannot sign a payment with it (wrong");
180
+ lines.push(" curve), but treat the file itself as sensitive: its scope is not a bound.");
151
181
  lines.push("");
152
182
  lines.push(...FLAG_CAVEAT.map((l) => ` ${l}`));
153
183
  lines.push("");
154
- lines.push("Opt in separately, only if you want unattended purchases:");
184
+ lines.push("Opt in separately (unattended purchases; unattended keystore access):");
155
185
  for (const e of OPT_IN_ALLOWLIST) {
156
186
  lines.push(` ${e.rule}`);
157
187
  lines.push(` ${e.note}`);
@@ -187,7 +217,8 @@ async function collectDoctorChecks(ctx, deps = {}) {
187
217
  deps.homeDir ?? homedir(),
188
218
  deps.which ?? ((bin) => onPath(bin, env)),
189
219
  config.install?.harness ?? []
190
- )
220
+ ),
221
+ await checkSession(ctx.dataDir, deps.now ?? Date.now, tryOriginOf(baseUrl))
191
222
  ];
192
223
  for (const result of await checkWallet(ctx, deps, env, settings.rpcUrl.value)) {
193
224
  built.push({ result });
@@ -436,6 +467,75 @@ var POSTURE = {
436
467
  shadowed: "at least one CLI skill present but not model-invocable",
437
468
  wired: "CLI skills wired, take precedence over the hosted mirror"
438
469
  };
470
+ async function checkSession(dataDir, now, origin) {
471
+ const warn = (detail, data2) => ({
472
+ result: {
473
+ name: "session",
474
+ status: "warn",
475
+ required: false,
476
+ detail,
477
+ fix: "tenjin session start --scope read",
478
+ ...data2 !== void 0 ? { data: data2 } : {}
479
+ }
480
+ });
481
+ const state = await readSessionFile(dataDir);
482
+ if (state.kind === "absent") {
483
+ return {
484
+ result: {
485
+ name: "session",
486
+ status: "ok",
487
+ required: false,
488
+ detail: "No session key; `tenjin read` delivers free and locally-cached pieces (`tenjin session start --scope read` adds owned-piece recovery)"
489
+ }
490
+ };
491
+ }
492
+ if (state.kind === "loosened") {
493
+ return warn(
494
+ `Session key at ${sessionPath(dataDir)} is mode 0${state.mode.toString(8)}, not 0600, so it is refused; it holds a wallet-derived credential and was changed out of band. Delete it and re-mint`
495
+ );
496
+ }
497
+ if (state.kind === "corrupt") {
498
+ return warn(`Session key at ${sessionPath(dataDir)} could not be parsed (${state.reason})`);
499
+ }
500
+ if (state.kind === "unreadable") {
501
+ return warn(`Session key at ${sessionPath(dataDir)} could not be read: ${state.message}`);
502
+ }
503
+ const file = state.file;
504
+ if (origin === null) {
505
+ return {
506
+ result: {
507
+ name: "session",
508
+ status: "warn",
509
+ required: false,
510
+ detail: `Session key was minted for ${file.origin}, but the configured base URL is not an http(s) origin, so it cannot be matched`,
511
+ fix: "Set an absolute http(s) base URL: `tenjin config set baseUrl <url>`.",
512
+ data: { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp }
513
+ }
514
+ };
515
+ }
516
+ const data = { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp };
517
+ if (file.origin !== origin) {
518
+ return warn(
519
+ `Session key was minted for ${file.origin}, but the configured base URL is ${origin}; it is not presented off its own origin`,
520
+ data
521
+ );
522
+ }
523
+ if (!isSessionPresentable(file, now(), "read", origin)) {
524
+ return warn(
525
+ `Session key for ${file.address} is expired or out of scope (scope ${file.scope}, exp ${file.exp})`,
526
+ data
527
+ );
528
+ }
529
+ return {
530
+ result: {
531
+ name: "session",
532
+ status: "ok",
533
+ required: false,
534
+ detail: `Session key ${file.address}, scope ${file.scope}, for ${file.origin}, expires ${file.exp}`,
535
+ data
536
+ }
537
+ };
538
+ }
439
539
  async function checkReadPath(baseUrl, timeoutMs, fetchImpl) {
440
540
  const url = `${trimSlash(baseUrl)}/api/articles?limit=1`;
441
541
  const res = await fetchJson(url, {
@@ -475,7 +575,7 @@ async function checkReadPath(baseUrl, timeoutMs, fetchImpl) {
475
575
  async function checkWallet(ctx, deps, env, rpcUrl) {
476
576
  const provider = deps.provider ?? await resolveLocalProviderOrNull(ctx, env);
477
577
  if (provider === null) return [noWalletCheck()];
478
- const { describeWallet } = await import("./wallet-B7KJS2R5.js");
578
+ const { describeWallet } = await import("./wallet-RBDVNZVR.js");
479
579
  let desc;
480
580
  try {
481
581
  desc = await describeWallet(provider);
@@ -501,7 +601,7 @@ async function resolveLocalProviderOrNull(ctx, env) {
501
601
  const envKey = env.TENJIN_WALLET_KEY;
502
602
  const envKeySet = typeof envKey === "string" && envKey.length > 0;
503
603
  if (!envKeySet && !await walletFileExists(ctx.dataDir)) return null;
504
- const { resolveWalletProvider } = await import("./wallet-B7KJS2R5.js");
604
+ const { resolveWalletProvider } = await import("./wallet-RBDVNZVR.js");
505
605
  return resolveWalletProvider(ctx);
506
606
  }
507
607
  function noWalletCheck() {
@@ -591,9 +691,8 @@ function isRecord(value) {
591
691
 
592
692
  export {
593
693
  recommendedPermissions,
594
- renderPermissionsBlock,
595
694
  collectDoctorChecks,
596
695
  runDoctor,
597
696
  renderDoctorHuman
598
697
  };
599
- //# sourceMappingURL=chunk-RTJLLPFA.js.map
698
+ //# sourceMappingURL=chunk-XFHZWORF.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/commands/doctor.ts","../src/lib/permissions.ts"],"sourcesContent":["import { styleText } from 'node:util';\nimport { Stream } from 'node:stream';\nimport { homedir } from 'node:os';\nimport { CliError } from '../lib/errors';\nimport {\n CLI_SKILL_NAMES,\n HOSTED_SKILL_NAME,\n anyTenjinSkill,\n cliSkillsWired,\n detectHarnesses,\n harnessFlagFor,\n harnessInPlay,\n harnessReads,\n harnessRequested,\n missingCliSkills,\n onPath,\n readAllWiring,\n shadowedCliSkills,\n} from '../lib/skill-wiring';\nimport type {\n DirState,\n HarnessTarget,\n HarnessWiring,\n NotInvocableReason,\n} from '../lib/skill-wiring';\nimport { fetchJson } from '../lib/http';\nimport { CLIENT_HEADER } from '../lib/client-meta';\nimport { loadRawConfig, resolveSettings } from '../lib/config';\nimport { tryOriginOf, trimSlash } from '../lib/url';\nimport { configPath, sessionPath } from '../lib/paths';\nimport { toMoney } from '../lib/money';\nimport { walletFileExists } from '../lib/wallet/store';\nimport { isSessionPresentable, readSessionFile } from '../lib/session-present';\nimport { sanitizeForTerminal } from '../lib/output';\nimport { recommendedPermissions, renderPermissionsBlock } from '../lib/permissions';\nimport type { PartialConfig } from '../lib/config';\nimport type { ErrorCode } from '../schemas';\nimport type { Io } from '../lib/output';\nimport type { WalletDescription, WalletProvider } from '../lib/wallet';\nimport type { CommandContext, CommandResult } from '../context';\n\n/**\n * One environment/reachability check. The doctor agent builds the check list\n * against this shape without changing it: `required` drives the exit code (exit\n * 0 iff every required check is ok), `status` drives the TTY rendering, and a\n * `fix` is mandatory on every failure (spec 10). Warn-level checks never fail\n * the command.\n */\nexport interface CheckResult {\n name: string;\n status: 'ok' | 'warn' | 'fail';\n required: boolean;\n detail: string;\n fix?: string;\n /**\n * Optional structured payload for machine consumers, so `--json` carries the\n * check's findings as data instead of only as the prose in `detail`. Additive\n * and per-check; the human renderer ignores it.\n */\n data?: unknown;\n}\n\n/** ~$20 in atomic USDC (6 decimals). Above this, the pocket-money wallet warns. */\nconst POCKET_MONEY_CEILING_ATOMIC = 20_000_000n;\n\n/**\n * `doctor` is an allowlisted verb an unattended agent runs on its own, and its\n * `fix:` lines reach that agent both on the TTY and in `error.details.checks`.\n * So they name the CONFIGURED base URL and the operator command that changes it,\n * never `--base-url`: the flag rides every allowlisted verb (see FLAG_CAVEAT in\n * lib/permissions), and a fix line telling the agent to pass it would be the CLI\n * coaching the exact move the skills forbid. `config set` is not allowlisted, so\n * pointing there routes the change through the operator by construction.\n */\nconst FIX_POINT_AT_TENJIN_API =\n 'Point the configured base URL at a Tenjin API (expected an OpenAPI document): `tenjin config set baseUrl <url>`.';\nconst FIX_CHECK_NETWORK_AND_BASE_URL =\n 'Check your network connection and the configured base URL (`tenjin config get baseUrl`).';\n\n/**\n * A CheckResult plus the error code to raise if it is a *required* failure. Only\n * required checks carry a `failCode`; the outcome step raises the first one, so\n * the failure envelope's `error.code` names what actually broke (api-contract\n * unreachable vs malformed differ) while still carrying the whole check list.\n */\ninterface BuiltCheck {\n result: CheckResult;\n failCode?: ErrorCode;\n}\n\nexport interface DoctorDeps {\n /** Environment for wallet-key detection and settings precedence. */\n env?: NodeJS.ProcessEnv;\n /** Injected fetch for the reachability checks; tests pass a canned stub. */\n fetchImpl?: typeof fetch;\n /** Inject the active wallet provider. When set, NO local fs/env is consulted —\n * the provider owns its own describe() and diagnostics(), so a remote provider's\n * checks can't be contaminated by a stale local wallet file. */\n provider?: WalletProvider;\n /** Home directory root for the skill-wiring check. Defaults to os.homedir(); tests\n * (and `install`, which reuses these checks) inject their own. */\n homeDir?: string;\n /** PATH probe for the `claude`/`codex` binaries, half of harness detection. Defaults\n * to probing `env.PATH`, so a test passing `env: {}` detects neither. */\n which?: (bin: string) => boolean;\n /** Clock seam (ms since epoch) for the session-expiry check. */\n now?: () => number;\n}\n\n/**\n * The full check list plus the first required failure, if any. `install` reuses\n * this to run the doctor checks as its last step and EMBED the summary without\n * throwing (D39: doctor is diagnostics, it never blocks the caller); `runDoctor`\n * wraps it and turns a required failure into the thrown failure envelope.\n */\nexport interface DoctorChecks {\n checks: CheckResult[];\n failure?: { code: ErrorCode; result: CheckResult };\n}\n\nexport async function collectDoctorChecks(\n ctx: CommandContext,\n deps: DoctorDeps = {},\n): Promise<DoctorChecks> {\n const env = deps.env ?? process.env;\n const { config, check: configCheck } = await loadConfigForDoctor(ctx.dataDir);\n const settings = resolveSettings({ config, flags: { baseUrl: ctx.flags.baseUrl }, env });\n const baseUrl = settings.baseUrl.value;\n\n const built: BuiltCheck[] = [\n checkNode(),\n configCheck,\n await checkApiContract(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkReadPath(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkSearchContract(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkSkills(\n deps.homeDir ?? homedir(),\n deps.which ?? ((bin) => onPath(bin, env)),\n config.install?.harness ?? [],\n ),\n await checkSession(ctx.dataDir, deps.now ?? Date.now, tryOriginOf(baseUrl)),\n ];\n\n // The wallet/custody/balance checks all come from the ACTIVE provider: it owns\n // describe() and diagnostics(), so doctor never runs its own fs/env probe.\n for (const result of await checkWallet(ctx, deps, env, settings.rpcUrl.value)) {\n built.push({ result });\n }\n\n const checks = built.map((b) => b.result);\n const firstFail = built.find((b) => b.result.required && b.result.status === 'fail');\n if (firstFail === undefined) return { checks };\n return { checks, failure: { code: firstFail.failCode ?? 'INTERNAL', result: firstFail.result } };\n}\n\nexport async function runDoctor(\n ctx: CommandContext,\n deps: DoctorDeps = {},\n): Promise<CommandResult> {\n const { checks, failure } = await collectDoctorChecks(ctx, deps);\n if (failure !== undefined) {\n const r = failure.result;\n // The allowlist rides on the FAILURE envelope too. An operator whose fresh\n // install is broken is the likeliest one to be reading doctor output at all,\n // and the earlier version dropped the block on exactly that path while the\n // comment below claimed otherwise. The human failure path still renders only\n // the error and its fix (that is emitFailure's contract, not doctor's), so\n // the machine payload is where this has to land.\n throw new CliError(failure.code, r.detail, {\n ...(r.fix !== undefined ? { fix: r.fix } : {}),\n details: { checks, permissions: recommendedPermissions() },\n });\n }\n\n // The discoverability surface for the auto-mode denial problem (#33): an\n // operator whose agent just got denied runs doctor and gets the exact lines to\n // paste, without having to already know they exist. It reports nothing about the\n // local machine, so it is deliberately NOT a check: it can never pass or fail.\n return {\n data: { status: 'pass', checks, permissions: recommendedPermissions() },\n humanLines: [...renderDoctorHuman(ctx.io, checks), '', ...renderPermissionsBlock()],\n };\n}\n\nfunction checkNode(): BuiltCheck {\n const version = process.versions.node;\n const major = Number.parseInt(version.split('.')[0] ?? '0', 10);\n if (major >= 22) {\n return { result: { name: 'node', status: 'ok', required: true, detail: `Node ${version}` } };\n }\n return {\n result: {\n name: 'node',\n status: 'fail',\n required: true,\n detail: `Node ${version} is unsupported (need >= 22)`,\n fix: 'Install Node 22 or newer',\n },\n failCode: 'NODE_UNSUPPORTED',\n };\n}\n\n/**\n * loadRawConfig throws CONFIG_INVALID on a bad file (which we convert into a\n * failing check) but the config value is also needed for baseUrl/rpcUrl\n * resolution; an invalid file falls back to {} so the reachability checks still\n * run and appear in the list, and config is reported as the first required fail.\n */\nasync function loadConfigForDoctor(\n dataDir: string,\n): Promise<{ config: PartialConfig; check: BuiltCheck }> {\n try {\n const config = await loadRawConfig(dataDir);\n const detail =\n Object.keys(config).length === 0\n ? 'No config file; using defaults'\n : `Config at ${configPath(dataDir)} is valid`;\n return { config, check: { result: { name: 'config', status: 'ok', required: true, detail } } };\n } catch (err) {\n if (err instanceof CliError && err.code === 'CONFIG_INVALID') {\n return {\n config: {},\n check: {\n result: {\n name: 'config',\n status: 'fail',\n required: true,\n detail: err.message,\n ...(err.fix !== undefined ? { fix: err.fix } : {}),\n },\n failCode: 'CONFIG_INVALID',\n },\n };\n }\n throw err;\n }\n}\n\nasync function checkApiContract(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n const url = `${trimSlash(baseUrl)}/openapi.json`;\n const res = await fetchJson(url, {\n timeoutMs,\n fetchImpl,\n headers: { 'x-tenjin-client': CLIENT_HEADER },\n });\n if (!res.ok) {\n const malformed = res.kind === 'invalid-json';\n return {\n result: {\n name: 'api-contract',\n status: 'fail',\n required: true,\n detail: malformed\n ? `OpenAPI document at ${url} was not valid JSON`\n : `Could not reach the Tenjin API at ${url}: ${res.message}`,\n fix: malformed ? FIX_POINT_AT_TENJIN_API : FIX_CHECK_NETWORK_AND_BASE_URL,\n },\n failCode: malformed ? 'CONTRACT_MISMATCH' : 'API_UNREACHABLE',\n };\n }\n const version = infoVersion(res.json);\n if (version === undefined) {\n return {\n result: {\n name: 'api-contract',\n status: 'fail',\n required: true,\n detail: `OpenAPI document at ${url} is missing a string info.version`,\n fix: FIX_POINT_AT_TENJIN_API,\n },\n failCode: 'CONTRACT_MISMATCH',\n };\n }\n return {\n result: {\n name: 'api-contract',\n status: 'ok',\n required: true,\n detail: `Tenjin API ${version} at ${baseUrl}`,\n },\n };\n}\n\n/**\n * WARN-level (never fails doctor): is the A2 search endpoint advertised in the\n * OpenAPI doc? Absent means the deployment predates A2 (the buy/search path will\n * not work against it yet). Warn-only because doctor's job is a working READ path,\n * and search is additive.\n */\nasync function checkSearchContract(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n const url = `${trimSlash(baseUrl)}/openapi.json`;\n const res = await fetchJson(url, {\n timeoutMs,\n fetchImpl,\n headers: { 'x-tenjin-client': CLIENT_HEADER },\n });\n if (!res.ok) {\n return {\n result: {\n name: 'search-contract',\n status: 'warn',\n required: false,\n detail: `Could not confirm the search endpoint at ${url}`,\n fix: 'Check the configured base URL (`tenjin config get baseUrl`); search/buy need the A2 endpoints deployed.',\n },\n };\n }\n const present = hasSearchPath(res.json);\n return {\n result: present\n ? {\n name: 'search-contract',\n status: 'ok',\n required: false,\n detail: 'Search endpoint advertised',\n }\n : {\n name: 'search-contract',\n status: 'warn',\n required: false,\n detail: 'This deployment does not advertise POST /api/agent/search (A2 not deployed)',\n fix: 'search/buy need A2 deployed; point the configured base URL at a deploy that has it (`tenjin config set baseUrl <url>`).',\n },\n };\n}\n\nfunction hasSearchPath(json: unknown): boolean {\n if (!isRecord(json)) return false;\n const paths = json.paths;\n return isRecord(paths) && '/api/agent/search' in paths;\n}\n\n/**\n * WARN-level (never fails doctor): is the harness skill wiring usable? #35 was\n * invisible without a screen recording, because the publish skill was on disk yet\n * the model never saw it and only the hosted skill answered publish asks.\n *\n * Verdicts are per DIRECTORY, never unioned across them — in EITHER direction.\n * Unioning the problems contradicts itself on a real machine: a Claude-only install\n * leaves a stray hosted skill in ~/.agents/skills, and flat-mapping announced both\n * CLI skills \"missing\" in the same sentence that listed them wired. Unioning the\n * successes is the same bug inverted, and worse: Claude Code reads ~/.claude/skills\n * and Codex reads ~/.agents/skills, so a wired .agents cannot answer for .claude,\n * and asking whether SOME directory is wired reported `ok` on a machine where\n * `tenjin-publish` was unreachable from Claude Code — exactly the #35 shape.\n *\n * So each directory is judged alone, and only when a harness on this machine\n * actually reads it (`harnessReads`, the probes `install` picks targets with). That\n * gate is what keeps a leftover mirror quiet: a hosted-only ~/.agents/skills with no\n * Codex is nobody's problem, while a hosted-only ~/.claude/skills with Claude Code\n * installed is the bug.\n *\n * Warn and never required: a CI or server machine legitimately has no harness, so\n * this must not move the exit code.\n */\n/**\n * `requested` is the `--harness` set a past `install` recorded (config `install.harness`).\n * It joins detection in deciding which directories are in play, and rides in the data as\n * its own field so `harnessPresent` keeps meaning \"a harness detected here reads this\".\n */\nasync function checkSkills(\n home: string,\n which: (bin: string) => boolean,\n requested: readonly HarnessTarget[],\n): Promise<BuiltCheck> {\n const present = detectHarnesses(home, which);\n const wiring = await readAllWiring(home);\n const data = {\n directories: wiring.map((w) => ({\n ...w,\n harnessPresent: harnessReads(home, w.dir, present),\n requested: harnessRequested(home, w.dir, requested),\n })),\n };\n const inPlay = wiring.filter((w) => anyTenjinSkill(w));\n\n if (inPlay.length === 0) {\n // Same fixFor path every other branch uses, over the same harnessInPlay\n // predicate (detected OR requested) — filtering on `requested` alone named\n // only the recorded directory and left a DETECTED one unwired, which just\n // swapped which directory the first command missed. Gated on\n // `requested.length > 0` so a machine with no record at all keeps the plain\n // `tenjin install` rather than newly spelling out a detected harness that\n // nobody asked to see named.\n const targeted =\n requested.length > 0\n ? wiring.filter((w) => harnessInPlay(home, w.dir, present, requested))\n : [];\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `No Tenjin skills wired under ${home} (looked in .claude/skills and .agents/skills)`,\n fix: targeted.length > 0 ? fixFor(home, targeted) : 'tenjin install',\n data,\n },\n };\n }\n\n // Every directory in play must carry BOTH CLI skills, model-invocable. Anything less\n // is the defect, whether it is shadowed, half-installed, hosted-only or absent; a\n // directory neither detected nor asked for is described but never warned about.\n const broken = wiring.filter(\n (w) => harnessInPlay(home, w.dir, present, requested) && !cliSkillsWired(w),\n );\n if (broken.length > 0) {\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `${broken.map(describeProblem).join('; ')}. Full state: ${describeWiring(inPlay)}`,\n fix: fixFor(home, broken),\n data,\n },\n };\n }\n\n return {\n result: {\n name: 'skills',\n status: 'ok',\n required: false,\n detail: `${CLI_SKILL_NAMES.join(' + ')} wired: ${describeWiring(inPlay)}`,\n data,\n },\n };\n}\n\n/** What is wrong in ONE directory, naming the directory and the skills. */\nfunction describeProblem(w: HarnessWiring): string {\n const shadowed = shadowedCliSkills(w);\n const missing = missingCliSkills(w);\n const parts: string[] = [];\n // Grouped BY REASON, not into one clause: the two claims differ in strength. A\n // readable file with the flag set is a fact; an unreadable one is a disjunction,\n // because the whole reason we cannot assert the flag is that we could not read it.\n // Merging them would spread that hedge onto a skill we know the answer for.\n const unreadable = shadowed.filter((n) => reasonFor(w, n) === 'unreadable');\n const disabled = shadowed.filter((n) => reasonFor(w, n) !== 'unreadable');\n if (disabled.length > 0) {\n parts.push(\n `${disabled.join(', ')} installed but not model-invocable (disable-model-invocation: true)`,\n );\n }\n if (unreadable.length > 0) {\n parts.push(\n `${unreadable.join(', ')} installed but not model-invocable (unreadable or disable-model-invocation: true)`,\n );\n }\n // Naming both by name reads as a half-install; when NEITHER is there the state is\n // \"this harness has no CLI skills at all\", which is a different sentence.\n if (missing.length === CLI_SKILL_NAMES.length) {\n parts.push(\n w.state === 'hosted-only'\n ? `the hosted ${HOSTED_SKILL_NAME} skill is here but neither CLI skill is wired`\n : 'neither CLI skill is wired',\n );\n } else if (missing.length > 0) parts.push(`${missing.join(', ')} missing`);\n return `${w.dir}: ${parts.join(' and ')}`;\n}\n\nfunction reasonFor(w: HarnessWiring, name: string): NotInvocableReason | undefined {\n return w.skills.find((s) => s.name === name)?.reason;\n}\n\n/** Is the hosted zero-install mirror in THIS directory? */\nfunction hostedHere(w: HarnessWiring): boolean {\n return w.skills.find((s) => s.name === HOSTED_SKILL_NAME)?.present === true;\n}\n\n/**\n * A fix that can actually clear the warning. A bare `tenjin install` only targets\n * the directories detection picks, so a problem in ~/.agents/skills on a\n * Claude-only machine needs `--harness shared` spelled out.\n */\nfunction fixFor(home: string, dirs: HarnessWiring[]): string {\n const flags = [...new Set(dirs.map((w) => harnessFlagFor(home, w.dir)))];\n return `tenjin install ${flags.map((f) => `--harness ${f}`).join(' ')}`;\n}\n\n/** One-line per-directory summary: `<dir> -> <skills> (<posture>)`. */\nfunction describeWiring(wiring: HarnessWiring[]): string {\n return wiring\n .map((w) => {\n const parts = w.skills\n .filter((s) => s.present)\n .map((s) =>\n s.modelInvocable === false ? `${s.name} [${s.reason ?? 'shadowed'}]` : s.name,\n );\n return `${w.dir} -> ${parts.join(', ')} (${posture(w)})`;\n })\n .join('; ');\n}\n\n/**\n * The precedence half of the `wired` posture is only true when there is a mirror\n * here to take precedence OVER. `classify` keys `wired` off the two CLI skills\n * alone, so a directory whose mirror was deleted is `wired` with no `tenjin` in it,\n * and the unconditional string claimed a file the same line had just not listed.\n */\nfunction posture(w: HarnessWiring): string {\n if (w.state !== 'wired') return POSTURE[w.state];\n return hostedHere(w)\n ? 'CLI skills wired, take precedence over the hosted mirror'\n : 'CLI skills wired';\n}\n\nconst POSTURE: Record<DirState, string> = {\n empty: 'no Tenjin skills',\n 'hosted-only': 'hosted skill only, no CLI skills here',\n partial: 'only one CLI skill',\n // \"at least one\": a directory with one CLI skill shadowed and the other absent\n // classifies as `shadowed` too, and \"CLI skills present\" would be false there.\n shadowed: 'at least one CLI skill present but not model-invocable',\n wired: 'CLI skills wired, take precedence over the hosted mirror',\n};\n\n/**\n * The delegated session key `tenjin read` presents to recover a piece this wallet\n * already owns (`tenjin session start --scope read` mints it). Never required and\n * never a fail — `read` works without one — so ABSENT is `ok`: the normal\n * posture, not a defect.\n *\n * Everything else warns, and the states are kept apart on purpose. A 0600 file\n * that is now group-readable, or one whose contents no longer parse, is a TAMPER\n * signal on a wallet-derived credential; `loadSessionFile` fails closed on both\n * and collapses them to \"no session\", which is the right instruction for a caller\n * that can re-mint and exactly the wrong report for the verb an operator runs\n * when something looks wrong. `readSessionFile` keeps them distinguishable and\n * this is the one caller that needs them.\n *\n * An unreadable file (EACCES after a `sudo` run, EIO) warns rather than throwing:\n * doctor is diagnostics, and a session cache nobody asked about must never take\n * down the run that was going to explain the rest of the machine.\n *\n * Reports address / origin / scope / expiry and nothing else. The delegation and\n * the private JWK never reach this output — doctor's payload is the single most\n * likely thing in this CLI to be pasted into an issue.\n */\nasync function checkSession(\n dataDir: string,\n now: () => number,\n origin: string | null,\n): Promise<BuiltCheck> {\n const warn = (detail: string, data?: unknown): BuiltCheck => ({\n result: {\n name: 'session',\n status: 'warn',\n required: false,\n detail,\n fix: 'tenjin session start --scope read',\n ...(data !== undefined ? { data } : {}),\n },\n });\n\n const state = await readSessionFile(dataDir);\n if (state.kind === 'absent') {\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail:\n 'No session key; `tenjin read` delivers free and locally-cached pieces (`tenjin session start --scope read` adds owned-piece recovery)',\n },\n };\n }\n if (state.kind === 'loosened') {\n return warn(\n `Session key at ${sessionPath(dataDir)} is mode 0${state.mode.toString(8)}, not 0600, so it is refused; it holds a wallet-derived credential and was changed out of band. Delete it and re-mint`,\n );\n }\n if (state.kind === 'corrupt') {\n return warn(`Session key at ${sessionPath(dataDir)} could not be parsed (${state.reason})`);\n }\n if (state.kind === 'unreadable') {\n return warn(`Session key at ${sessionPath(dataDir)} could not be read: ${state.message}`);\n }\n\n const file = state.file;\n // A base URL that is not an http(s) origin cannot be compared against, and this\n // is the diagnostic verb: it reports that and keeps going. The `config` check\n // above owns the fix for the value itself.\n if (origin === null) {\n return {\n result: {\n name: 'session',\n status: 'warn',\n required: false,\n detail: `Session key was minted for ${file.origin}, but the configured base URL is not an http(s) origin, so it cannot be matched`,\n fix: 'Set an absolute http(s) base URL: `tenjin config set baseUrl <url>`.',\n data: { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp },\n },\n };\n }\n const data = { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp };\n if (file.origin !== origin) {\n return warn(\n `Session key was minted for ${file.origin}, but the configured base URL is ${origin}; it is not presented off its own origin`,\n data,\n );\n }\n if (!isSessionPresentable(file, now(), 'read', origin)) {\n return warn(\n `Session key for ${file.address} is expired or out of scope (scope ${file.scope}, exp ${file.exp})`,\n data,\n );\n }\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail: `Session key ${file.address}, scope ${file.scope}, for ${file.origin}, expires ${file.exp}`,\n data,\n },\n };\n}\n\nasync function checkReadPath(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n // The shipped public read path. The A2 search-contract check is a B2 follow-up.\n // Probe the UNFILTERED listing: the server logs every nonblank first-page `q`\n // as agent search demand, so a `q` here would fabricate that demand into the\n // experiment this CLI exists to measure. Never add a `q` to this probe.\n const url = `${trimSlash(baseUrl)}/api/articles?limit=1`;\n const res = await fetchJson(url, {\n timeoutMs,\n fetchImpl,\n headers: { 'x-tenjin-client': CLIENT_HEADER },\n });\n if (!res.ok) {\n return {\n result: {\n name: 'read-path',\n status: 'fail',\n required: true,\n detail: `Read path ${url} failed: ${res.message}`,\n fix: FIX_CHECK_NETWORK_AND_BASE_URL,\n },\n failCode: 'API_UNREACHABLE',\n };\n }\n const items = isRecord(res.json) ? res.json.items : undefined;\n if (!Array.isArray(items)) {\n return {\n result: {\n name: 'read-path',\n status: 'fail',\n required: true,\n detail: `Read path ${url} did not return an items array`,\n fix: 'Point the configured base URL at a Tenjin API: `tenjin config set baseUrl <url>`.',\n },\n failCode: 'API_UNREACHABLE',\n };\n }\n return {\n result: { name: 'read-path', status: 'ok', required: true, detail: `Read path OK at ${url}` },\n };\n}\n\n/**\n * Diagnose the wallet the CLI would actually use, entirely through the ACTIVE\n * provider. An injected provider owns everything — no local file or env is touched.\n * With no injected provider we do ONE cheap fs/env probe purely to decide whether\n * any credential exists: none → emit the \"no wallet\" warn WITHOUT importing the\n * wallet lib (that import statically pulls viem, and a no-wallet run must not parse\n * it). Otherwise the provider describes itself (address + source), reports its own\n * custody warnings, and the balance probes describe()'s address. A custody problem\n * (bad key, provider refusal) is warn-level, never a hard fail.\n */\nasync function checkWallet(\n ctx: CommandContext,\n deps: DoctorDeps,\n env: NodeJS.ProcessEnv,\n rpcUrl: string,\n): Promise<CheckResult[]> {\n const provider = deps.provider ?? (await resolveLocalProviderOrNull(ctx, env));\n if (provider === null) return [noWalletCheck()];\n\n const { describeWallet } = await import('../lib/wallet');\n let desc: WalletDescription;\n try {\n desc = await describeWallet(provider);\n } catch (err) {\n if (err instanceof CliError && err.code === 'WALLET_MISSING') return [noWalletCheck()];\n return [walletWarn(err)];\n }\n\n const checks: CheckResult[] = [\n {\n name: 'wallet',\n status: 'ok',\n required: false,\n detail: `Wallet ${desc.address} (${desc.credentialSource})`,\n },\n ];\n // Custody warnings are the provider's own (perms, env-shadow for the local\n // provider; none for a remote one). Render each as a warn check; the fix text,\n // when there is one, is carried inline in the warning string.\n for (const warning of (await provider.diagnostics()).warnings) {\n checks.push({ name: 'wallet-custody', status: 'warn', required: false, detail: warning });\n }\n checks.push(await checkBalance(desc.address, rpcUrl));\n return checks;\n}\n\n/**\n * The active local provider, or null when no credential exists at all. The null\n * path never imports the wallet lib, keeping a no-wallet doctor run off viem.\n */\nasync function resolveLocalProviderOrNull(\n ctx: CommandContext,\n env: NodeJS.ProcessEnv,\n): Promise<WalletProvider | null> {\n const envKey = env.TENJIN_WALLET_KEY;\n const envKeySet = typeof envKey === 'string' && envKey.length > 0;\n if (!envKeySet && !(await walletFileExists(ctx.dataDir))) return null;\n const { resolveWalletProvider } = await import('../lib/wallet');\n return resolveWalletProvider(ctx);\n}\n\nfunction noWalletCheck(): CheckResult {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: 'No wallet; needed only for buy/publish',\n fix: 'tenjin wallet create',\n };\n}\n\nfunction walletWarn(err: unknown): CheckResult {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: err instanceof Error ? err.message : String(err),\n ...(err instanceof CliError && err.fix !== undefined ? { fix: err.fix } : {}),\n };\n}\n\n/**\n * Balance is best-effort: a zero balance is a fundable warning and an RPC flake\n * must never fail doctor. viem loads only here, via a lazy import, so a doctor\n * run without a wallet never parses the viem chunk.\n */\nasync function checkBalance(address: string, rpcUrl: string): Promise<CheckResult> {\n try {\n const { getUsdcBalance } = await import('../lib/usdc');\n const balance = await getUsdcBalance(address as `0x${string}`, rpcUrl);\n if (balance === 0n) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: 'Wallet USDC balance is 0',\n fix: 'Send USDC on Base. $5 covers ~50 typical resources.',\n };\n }\n const money = toMoney(balance.toString());\n // Pocket-money posture (roadmap B2): a plaintext-adjacent local key should\n // hold only small change, so a balance over ~$20 is a warn, not an error.\n if (balance > POCKET_MONEY_CEILING_ATOMIC) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: `Balance ${money.usd} USDC is above the ~$20 pocket-money ceiling`,\n fix: 'Keep only small change in the CLI wallet; sweep the excess to cold storage.',\n };\n }\n return {\n name: 'balance',\n status: 'ok',\n required: false,\n detail: `Balance ${money.usd} USDC (${money.atomic} atomic)`,\n };\n } catch (err) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: `Could not read balance: ${err instanceof Error ? err.message : String(err)}`,\n fix: 'Check rpcUrl or retry; a balance read failure never fails doctor.',\n };\n }\n}\n\nexport function renderDoctorHuman(io: Io, checks: CheckResult[]): string[] {\n const nameWidth = Math.max(...checks.map((c) => c.name.length));\n const lines: string[] = [];\n for (const c of checks) {\n const icon =\n c.status === 'ok'\n ? paint(io, 'green', '✓')\n : c.status === 'warn'\n ? paint(io, 'yellow', '!')\n : paint(io, 'red', '✗');\n // `detail` and `fix` interpolate SERVER-sourced strings (the OpenAPI\n // info.version, a provider's error text). doctor now prints them directly\n // above the allowlist block the operator is told to paste, so a newline or\n // ANSI in a hostile deployment's version string could forge a second, wider\n // \"allowlist\" section in the terminal. Sanitize at the render seam: output.ts\n // exempts doctor on the assumption it only paints its OWN text, which stopped\n // being true the moment these lines sat next to a copy-paste block.\n lines.push(\n `${icon} ${c.name.padEnd(nameWidth)} ${paint(io, 'dim', sanitizeForTerminal(c.detail))}`,\n );\n if (c.status !== 'ok' && c.fix !== undefined) {\n lines.push(` ${paint(io, 'dim', `fix: ${sanitizeForTerminal(c.fix)}`)}`);\n }\n }\n return lines;\n}\n\n/**\n * Color for stderr, honoring NO_COLOR and the target's color depth: styleText\n * takes the stderr stream when it is a genuine Stream (it throws on anything\n * else, so a test/redirected sink falls back to the default plain check).\n */\nfunction paint(io: Io, format: Parameters<typeof styleText>[0], text: string): string {\n if (io.stdout instanceof Stream) return styleText(format, text, { stream: io.stdout });\n return styleText(format, text);\n}\n\nfunction infoVersion(json: unknown): string | undefined {\n if (!isRecord(json)) return undefined;\n const info = json.info;\n if (!isRecord(info)) return undefined;\n return typeof info.version === 'string' ? info.version : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null;\n}\n","/**\n * The recommended HARNESS permission allowlist: the exact rule lines an operator\n * pastes into Claude Code (or an equivalent harness) so auto mode stops denying\n * the free Tenjin verbs, and so the one paying verb is cleared deliberately\n * rather than by accident.\n *\n * This is a HARNESS-side allowlist (which shell commands the agent may run at\n * all). It is NOT the CLI's spend policy and shares nothing with it: the shipped\n * `allowlistCreators` config key gates WHO you may pay, this file gates WHICH\n * COMMANDS the harness will run without a prompt. The two are deliberately kept\n * apart in name and in code — clearing `Bash(tenjin buy:*)` here never raises a\n * spend cap. That is a claim about this file, NOT a claim that the spend policy\n * stops an allowlisted `buy`: `--yes` is an ordinary flag on an allowlisted verb\n * and `confirmSpend` returns true on it before any TTY check\n * (src/commands/buy.ts), so under CONFIG_DEFAULTS nothing denies. See\n * OPT_IN_ALLOWLIST's note for the walk-through.\n *\n * These are static, shipped constants on purpose: there is NO config key for\n * them. An operator-editable \"which commands may run\" list stored next to the\n * spend policy would be a second, weaker copy of a control the harness already\n * owns, and a CLI that could widen its own permission grant is exactly the shape\n * this file exists to avoid.\n *\n * Scope: `tenjin mcp` exposes the same command cores over MCP, where the harness\n * gates TOOLS, not Bash lines. These rules say nothing about that surface, which\n * is why `tenjin mcp` is itself never recommended here: clearing it would route\n * around every rule below. MCP_CAVEAT names the tools to leave gated for an\n * operator who runs the server anyway.\n *\n * LIMIT OF A PREFIX RULE, read this before adding an entry: the rule constrains\n * the VERB and nothing else. `addGlobalFlags` (src/cli.ts) puts `--json`,\n * `--timeout`, and `--base-url` on every leaf command, so every rule below also\n * clears `--base-url <url>` in trailing position. `--base-url` is validated as a\n * URL and nothing more, and it wins settings precedence, so it re-points the\n * trust boundary itself: the `search` question goes to that host, `doctor` probes\n * it, and `assertOnBaseOrigin` only checks that a resource URL shares an origin\n * with the CONFIGURED base, so an attacker-controlled pair satisfies the pin. No\n * prefix syntax expresses \"this verb but not that flag\", so the mitigation is\n * disclosure rather than a narrower rule: FLAG_CAVEAT prints alongside the rules\n * on every surface, and the skills tell the agent never to pass `--base-url` on\n * an allowlisted verb. Pinning the paying path to a constant origin instead is\n * the real fix and is an x402/payments-semantics change, tracked separately.\n */\n\n/** One pasteable allowlist rule plus why it is safe (or what it costs). */\nexport interface AllowlistEntry {\n /** The exact line to add to the harness permission allowlist. */\n rule: string;\n /** The verb it clears. */\n command: string;\n /** Why it is safe to pre-clear, or what the operator is opting into. */\n note: string;\n}\n\n/** A verb deliberately kept OUT of the recommended allowlist, and why. */\nexport interface ExcludedVerb {\n command: string;\n reason: string;\n}\n\n/**\n * FREE verbs: they CANNOT SPEND AND CANNOT OPEN THE KEYSTORE. That is the whole\n * definition of this tier, and it is deliberately narrower than the older \"no\n * wallet, no signing, no payment\" — which stopped being true the moment `read`\n * gained the ability to PRESENT a cached session key. `read` signs, with a P-256\n * delegation loaded from disk; it cannot mint one (that needs the wallet, and its\n * import graph is test-pinned clear of it) and cannot produce the\n * secp256k1/EIP-712 signature a payment authorization needs (wrong curve). Money\n * and key material stay out of reach; a signature as such no longer does, so the\n * tier says what it means.\n *\n * What the tier does NOT claim, because it is not true: that the read scope\n * limits what a leaked delegation is worth. Scope is enforced only on the request\n * shape that carries both a session signature and the delegation header; the same\n * delegation replayed as a plain `SIGN-IN-WITH-X` takes a different server path\n * where no scope logic runs. So a session file is a wallet-derived credential\n * with the authority of the wallet behind it, and the mitigations that actually\n * hold are the ones in this repo: it is 0600, short-lived (≤24h, server-clamped),\n * bound to the origin it was minted for, and never presented off that origin.\n * Treat \"read is allowlisted\" as \"read may transmit that credential to the\n * configured origin\", and see FLAG_CAVEAT for why the configured origin is not\n * automatically the one you configured.\n *\n * Not all of them are read-only, and the difference is disclosed rather than\n * papered over — `search` POSTs the (generalized, anonymous) question off-machine\n * and records it locally, `outcome` POSTs a report that moves the marketplace's\n * reuse signal (both unauthenticated remote writes), and `read` writes locally,\n * saving a delivered piece to the library. Pre-clearing them is defensible\n * because they cost nothing and cannot reach the key; calling them read-only to\n * justify it would not be.\n *\n * Rules are PREFIX rules: `Bash(tenjin search:*)` clears commands that start with\n * `tenjin search` and nothing else. The narrow `wallet show` / `wallet balance` /\n * `config get` / `candidate list` forms are deliberate: a `Bash(tenjin wallet:*)`\n * or `Bash(tenjin config:*)` rule would silently swallow `wallet create` and\n * `config set`, and `config set` can raise the spend caps.\n *\n * Two known gaps, both fail-closed (denied, never wrongly allowed):\n * - Bare `tenjin config` (runConfigList) is as read-only as `config get`, but no\n * prefix rule reaches it without also covering `config set`, so it stays out.\n * Use `tenjin config get <key>`, which is a different supported command rather\n * than a reworded one.\n * - Group-level flag forms like `tenjin wallet --json show` are not covered.\n * Put global flags AFTER the leaf verb (`tenjin wallet show --json`); the\n * CLI parses either, and only the trailing form matches these rules.\n */\nexport const ALWAYS_SAFE_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin search:*)',\n command: 'tenjin search',\n note:\n 'Free anonymous marketplace search. No wallet, no signing, no payment. ' +\n 'Not read-only: it POSTs the generalized question off-machine and records ' +\n 'the search locally.',\n },\n {\n rule: 'Bash(tenjin inspect:*)',\n command: 'tenjin inspect',\n note: 'Free pre-purchase card and preview. Never signs, never pays, never saves.',\n },\n {\n rule: 'Bash(tenjin read:*)',\n command: 'tenjin read',\n note:\n 'Free-only delivery: free pieces, local-library re-reads, and pieces this ' +\n 'wallet already owns when a read-scoped session key is cached. Cannot spend ' +\n 'and cannot open the keystore — the wallet, payment, and session-MINTING ' +\n 'modules are all absent from its import graph, so the key it may present is ' +\n 'a P-256 delegation loaded from disk, which is the wrong curve to authorize ' +\n 'a payment. TRANSMITS A CREDENTIAL: when a session key exists, a cold 402 ' +\n 'sends that wallet-derived delegation to the server. It goes only to the ' +\n 'origin the delegation was minted for, which is what stops a stray ' +\n '`--base-url` from redirecting it, and no scope on it limits what a holder ' +\n 'could do with it. Not read-only: a freshly delivered piece is saved to the ' +\n 'library.',\n },\n {\n rule: 'Bash(tenjin outcome:*)',\n command: 'tenjin outcome',\n note:\n 'Free honest outcome report on a past search. No wallet, no payment. ' +\n 'Not read-only: it POSTs a report that moves the marketplace reuse signal.',\n },\n {\n rule: 'Bash(tenjin doctor:*)',\n command: 'tenjin doctor',\n note: 'Read-only local environment and API reachability diagnostics.',\n },\n {\n rule: 'Bash(tenjin wallet show:*)',\n command: 'tenjin wallet show',\n note: 'Prints the wallet address and key source. Never prints the key.',\n },\n {\n rule: 'Bash(tenjin wallet balance:*)',\n command: 'tenjin wallet balance',\n note: 'Read-only USDC balance query on Base.',\n },\n {\n rule: 'Bash(tenjin config get:*)',\n command: 'tenjin config get',\n note:\n 'Reads one effective config value. `config set` is excluded on purpose. ' +\n 'Note `config get rpcUrl` returns your RPC URL, which commonly embeds a ' +\n 'provider API key: no wallet secret, but a credential-adjacent read.',\n },\n {\n rule: 'Bash(tenjin candidate list:*)',\n command: 'tenjin candidate list',\n note: 'Lists local parked drafts. Candidates are local files; nothing uploads.',\n },\n];\n\n/**\n * The verbs offered as EXPLICIT opt-in lines rather than shipped in the safe set:\n * the one that spends, and the one that opens the keystore.\n *\n * Read the buy note carefully before pasting the line: on the DEFAULT config this\n * rule authorizes unattended spending up to the wallet balance. Walking\n * evaluateSpendPolicy (lib/policy.ts) against CONFIG_DEFAULTS with an agent that\n * passes `--yes` (which this repo's own skill snippet offers):\n * - `maxPriceAtomic` is unset unless the agent chooses to pass `--max-price`;\n * - `allowlistCreators` is empty, so the creator gate is off;\n * - `sessionBudget` is '0', which `if (policy.sessionBudgetAtomic > 0n)` reads\n * as DISABLED, not as a zero ceiling;\n * - `maxAutoSpend` '0' and `confirm` 'always' both land on `confirm`, and\n * `confirmSpend` returns true on `--yes` before any TTY check.\n * Nothing denies. Note the asymmetry that makes the pair read safer than it is:\n * `maxAutoSpend: '0'` means \"auto-approve nothing\" while `sessionBudget: '0'`\n * means \"no ceiling at all\".\n */\nexport const OPT_IN_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin buy:*)',\n command: 'tenjin buy',\n note:\n 'SPENDS USDC on Base, unrefundably. This authorizes UNATTENDED purchases: ' +\n '`--yes` is an ordinary flag on the same allowlisted verb and it clears the ' +\n 'confirm gate, so on the default config nothing stops a spend up to your ' +\n 'wallet balance. Set a real ceiling first with ' +\n '`tenjin config set maxAutoSpend <usd>` and ' +\n '`tenjin config set sessionBudget <usd>` (sessionBudget 0 means NO ceiling, ' +\n 'not a zero one). This line never raises a spend cap by itself, but do not ' +\n 'read that as a human being on every purchase. Fund small.',\n },\n {\n rule: 'Bash(tenjin session start:*)',\n command: 'tenjin session start',\n note:\n 'OPENS THE KEYSTORE (one wallet signature), but SPENDS NOTHING and cannot: ' +\n 'it mints a ≤24h P-256 session key so `tenjin read` can recover pieces you ' +\n 'already own without paying. The delegated key is the wrong curve for a ' +\n 'payment authorization, so no session file can ever move money. Do NOT read ' +\n 'the `read` scope as a bound on the rest: the file it leaves is a ' +\n 'wallet-derived credential, and what limits it is that it expires in 24h, ' +\n 'lives 0600, and is refused off the origin it was minted for — not its ' +\n 'scope. What you are opting into is unattended keystore access: on an ' +\n 'encrypted wallet the passphrase prompt is skipped or answered from the ' +\n 'environment, and the `--base-url` caveat below bites hardest here, because ' +\n 'a mint against an attacker-chosen host is a wallet signature you did not ' +\n 'intend to make.',\n },\n];\n\n/**\n * Verbs that must NEVER appear in the recommended allowlist, with the reason each\n * one is a human decision. `tenjin send` is the wallet escape hatch (tenjin-agent\n * #40) and heads this list: it moves USDC to an arbitrary address, outside the\n * spend policy that bounds `buy`. Naming it here is load-bearing even in versions\n * where the verb does not exist yet — the exclusion ships before the verb does.\n */\nexport const NEVER_ALLOWLISTED: readonly ExcludedVerb[] = [\n {\n command: 'tenjin send',\n reason:\n 'Moves USDC out of the wallet to an arbitrary address (the escape hatch, #40). ' +\n 'Irreversible and not bounded by the buy spend policy. Always a human decision.',\n },\n {\n command: 'tenjin publish',\n reason: 'Puts your content on a public marketplace under your identity.',\n },\n {\n command: 'tenjin edit',\n reason:\n 'Write-capable despite the no-flag form reading as a pure show: it edits live posts ' +\n 'and answer cards under your identity, and moves prices. A prefix rule pins the verb, ' +\n 'not the flags, so no rule can clear the read half without clearing the write half.',\n },\n {\n command: 'tenjin wallet create',\n reason: 'Creates the payment credential; a stray run is a wallet you did not mean to have.',\n },\n {\n command: 'tenjin config set',\n reason:\n 'Can raise maxAutoSpend / sessionBudget / confirm, i.e. widen the agent’s own spend policy.',\n },\n {\n command: 'tenjin candidate add / tenjin candidate drop',\n reason: 'Writes or discards local drafts; `candidate list` is the read-only half.',\n },\n {\n command: 'tenjin install',\n reason: 'Writes into harness config and skills directories.',\n },\n {\n command: 'tenjin mcp',\n reason:\n 'Long-running server that re-exposes every command core over stdio; ' +\n 'clearing it would indirectly clear everything above.',\n },\n];\n\n/**\n * The flag-surface caveat. A prefix rule pins the verb, never the flags, and the\n * flag that matters is `--base-url`: it is accepted on every leaf, validated only\n * as a URL, and it wins settings precedence, so it moves the destination of every\n * allowlisted verb. Printed with the rules everywhere they are printed, because\n * an operator who only reads the verb list would never learn it.\n */\nexport const FLAG_CAVEAT: readonly string[] = [\n 'Caveat: a prefix rule pins the VERB, not the flags. Every line above also clears',\n '`--base-url <url>` on that verb, which re-points where the question, the probe, the',\n 'session key `read` may present, and (for buy) the signature and payment go. Signed',\n 'and credential-bearing traffic is NOT confined to the paying verb: `read` is in the',\n 'safe tier and still transmits a wallet-derived delegation once one is cached, which is',\n 'why that delegation is bound to the origin it was minted for and refused elsewhere.',\n 'Allowlist these verbs only if you are content for the agent to choose the destination',\n 'host, and set the base URL in config instead of letting it be an argument. The skills',\n 'tell agents never to pass --base-url on an allowlisted verb, but that is a convention,',\n 'not an enforced boundary.',\n];\n\n/**\n * The MCP caveat. `tenjin mcp` is never recommended as a Bash rule, but an\n * operator who registers the server anyway is on a different permission surface\n * (tools, not command strings) where three excluded verbs come back.\n */\nexport const MCP_CAVEAT: readonly string[] = [\n 'Running the local MCP server (`tenjin mcp`) instead? That is a different permission',\n 'surface: the harness gates TOOLS there, and these Bash rules do not apply. Leave',\n '`mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`, and',\n '`mcp__tenjin__tenjin_wallet` gated, and treat `mcp__tenjin__tenjin_candidate` as gated',\n 'for its add/drop actions. `tenjin_buy` is the same opt-in decision as the buy line above.',\n];\n\n/** The machine shape emitted by `tenjin doctor --json` and `tenjin install --json`. */\nexport interface RecommendedPermissions {\n alwaysSafe: AllowlistEntry[];\n optIn: AllowlistEntry[];\n neverAllowlisted: ExcludedVerb[];\n /** Caveats that qualify the rules above; never omit them when rendering. */\n caveats: { flags: string[]; mcp: string[] };\n}\n\nexport function recommendedPermissions(): RecommendedPermissions {\n return {\n alwaysSafe: ALWAYS_SAFE_ALLOWLIST.map((e) => ({ ...e })),\n optIn: OPT_IN_ALLOWLIST.map((e) => ({ ...e })),\n neverAllowlisted: NEVER_ALLOWLISTED.map((e) => ({ ...e })),\n caveats: { flags: [...FLAG_CAVEAT], mcp: [...MCP_CAVEAT] },\n };\n}\n\n/** Every rule this module recommends adding (safe + opt-in). */\nexport function recommendedRules(): string[] {\n return [...ALWAYS_SAFE_ALLOWLIST, ...OPT_IN_ALLOWLIST].map((e) => e.rule);\n}\n\n/**\n * The human block both `doctor` and `install` print. Plain lines; the caller\n * decides how (or whether) to paint them.\n */\nexport function renderPermissionsBlock(): string[] {\n const lines: string[] = [\n 'Auto-mode permission allowlist (add these once, then agents stop being denied):',\n ];\n for (const e of ALWAYS_SAFE_ALLOWLIST) lines.push(` ${e.rule}`);\n lines.push(' Free: cannot spend and cannot open the keystore. Not all read-only, though:');\n lines.push(' `search` and `outcome` POST to the marketplace (a question, a report),');\n lines.push(' and `read` saves a delivered piece to your local library. `read` may also');\n lines.push(' PRESENT a cached session key — a wallet-derived credential — to the origin it');\n lines.push(' was minted for. It cannot mint one and cannot sign a payment with it (wrong');\n lines.push(' curve), but treat the file itself as sensitive: its scope is not a bound.');\n lines.push('');\n lines.push(...FLAG_CAVEAT.map((l) => ` ${l}`));\n lines.push('');\n lines.push('Opt in separately (unattended purchases; unattended keystore access):');\n for (const e of OPT_IN_ALLOWLIST) {\n lines.push(` ${e.rule}`);\n lines.push(` ${e.note}`);\n }\n lines.push('');\n lines.push('Never recommended (each one is a human decision):');\n for (const e of NEVER_ALLOWLISTED) lines.push(` ${e.command} - ${e.reason}`);\n lines.push('');\n lines.push(...MCP_CAVEAT.map((l) => ` ${l}`));\n lines.push('');\n lines.push(\n 'Claude Code: add the lines to the \"permissions.allow\" array in .claude/settings.json.',\n );\n return lines;\n}\n"],"mappings":"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","names":["data"]}
@@ -3,10 +3,10 @@ import {
3
3
  SIWX_HEADER,
4
4
  decodePaymentRequiredHeader,
5
5
  decodePaymentResponseHeader
6
- } from "./chunk-FU6MCSLG.js";
6
+ } from "./chunk-PCLPVJ3J.js";
7
7
  import {
8
8
  rateLimitError
9
- } from "./chunk-3IRDP7TN.js";
9
+ } from "./chunk-P3FBESBB.js";
10
10
  import {
11
11
  SLUG_RE,
12
12
  UUID_RE
@@ -14,11 +14,11 @@ import {
14
14
  import {
15
15
  CLIENT_HEADER,
16
16
  httpRequest
17
- } from "./chunk-ZDY2KY5X.js";
17
+ } from "./chunk-URSGGRO4.js";
18
18
  import {
19
19
  CliError,
20
20
  external_exports
21
- } from "./chunk-PAUXMRSF.js";
21
+ } from "./chunk-J6CVKC4M.js";
22
22
 
23
23
  // src/lib/read-client.ts
24
24
  var PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
@@ -86,14 +86,39 @@ async function fetchRead(url, opts) {
86
86
  };
87
87
  if (opts.searchId !== void 0) headers["x-tenjin-search-id"] = opts.searchId;
88
88
  if (opts.siwxHeader !== void 0) headers[SIWX_HEADER] = opts.siwxHeader;
89
+ if (opts.sessionHeaders !== void 0) Object.assign(headers, opts.sessionHeaders);
89
90
  if (opts.paymentHeaders !== void 0) Object.assign(headers, opts.paymentHeaders);
90
91
  const res = await httpRequest(url, {
91
92
  method: "GET",
92
93
  timeoutMs: opts.timeoutMs,
93
94
  headers,
94
- fetchImpl: opts.fetchImpl
95
+ fetchImpl: opts.fetchImpl,
96
+ // Pinned even when UNSIGNED (the first probe): a 200 from this route is
97
+ // written to the library by `deliverFresh` as an entitlement record under
98
+ // the server-chosen id/slug, and `findDeliveredByUrl` later matches saved
99
+ // receipts by handle+slug alone — so a followed cross-origin redirect
100
+ // would let another host's bytes short-circuit future buys as owned.
101
+ // `assertOnBaseOrigin` cannot catch this; it checks only the URL asked for.
102
+ //
103
+ // Refused for ANY 3xx, same-origin hops included. The transport failing closed
104
+ // on the whole class is the point: an exemption for "benign" redirects is a
105
+ // second origin check living in the one place that already proved it cannot see
106
+ // enough to make one. Keeping a canonical URL is the CALLER's job instead, and
107
+ // `resolveResourceRef` does it for every verb that gets here.
108
+ blockRedirects: true
95
109
  });
96
110
  if (!res.ok) {
111
+ if (res.kind === "blocked-redirect") {
112
+ throw new CliError("CONTRACT_MISMATCH", `${url}: ${res.message}`, {
113
+ // The origin half of this hint deliberately does NOT name the base-URL
114
+ // flag. `read` is meant to be allowlistable, the skill tells the agent
115
+ // never to pass that flag on an allowlisted verb, and a `fix:` naming it
116
+ // would coach exactly the move the skill forbids. `doctor` is the
117
+ // allowlisted verb that owns the question — its `checkReadPath` probes
118
+ // this route and its own copy names the config command when it should.
119
+ fix: "Ask for the URL in the spelling `tenjin search` or `tenjin inspect` reports. If every read hops, `tenjin doctor` checks the configured origin."
120
+ });
121
+ }
97
122
  const code = res.kind === "network" || res.kind === "timeout" ? "NETWORK_ERROR" : "API_UNREACHABLE";
98
123
  throw new CliError(code, `${url}: ${res.message}`, {
99
124
  fix: "Check the resource URL and your network, then retry."
@@ -155,6 +180,10 @@ async function fetchRead(url, opts) {
155
180
  ...sentUnparsableCard(res.json, preview) ? { cardError: true } : {}
156
181
  };
157
182
  }
183
+ if (res.status === 401 && opts.sessionHeaders !== void 0) {
184
+ const code = readCode(res.json);
185
+ return { kind: "session_rejected", ...code !== void 0 ? { code } : {} };
186
+ }
158
187
  if (res.status === 409) {
159
188
  return { kind: "already_purchased", message: readMessage(res.json) ?? "Already purchased." };
160
189
  }
@@ -187,6 +216,11 @@ function decodeSettlement(header) {
187
216
  return void 0;
188
217
  }
189
218
  }
219
+ function readCode(json) {
220
+ if (typeof json !== "object" || json === null) return void 0;
221
+ const code = json.code;
222
+ return typeof code === "string" ? code : void 0;
223
+ }
190
224
  function readMessage(json) {
191
225
  if (typeof json === "object" && json !== null) {
192
226
  const rec = json;
@@ -200,4 +234,4 @@ function readMessage(json) {
200
234
  export {
201
235
  fetchRead
202
236
  };
203
- //# sourceMappingURL=chunk-BIKAUVC2.js.map
237
+ //# sourceMappingURL=chunk-ZA3RFDAV.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/read-client.ts"],"sourcesContent":["import { z } from 'zod';\nimport { decodePaymentRequiredHeader, decodePaymentResponseHeader } from '@x402/core/http';\nimport type { PaymentRequired } from '@x402/core/types';\nimport { CliError } from './errors';\nimport { rateLimitError } from './agent-api';\nimport { httpRequest } from './http';\nimport { CLIENT_HEADER } from './client-meta';\nimport { SIWX_HEADER } from './siwx';\n\n/**\n * The read-route (`GET /api/read/<handle>/<slug>`) client, always JSON/x402, so\n * it is the robust agent target (llms-full). It surfaces the three outcomes the\n * buy flow branches on: `entitled` (200 with the full body, free post, SIWX\n * re-read, or freshly paid), `payment_required` (402 with the decoded\n * PAYMENT-REQUIRED header + the leak-safe preview body), and `already_purchased`\n * (409 owned-re-pay gate, nothing charged). Purchase attribution rides\n * `X-Tenjin-Client` always and `X-Tenjin-Search-Id` when a search preceded the buy.\n */\n\nconst PAYMENT_REQUIRED_HEADER = 'PAYMENT-REQUIRED';\nconst PAYMENT_RESPONSE_HEADER = 'PAYMENT-RESPONSE';\n\n// id/slug become filesystem path segments (the local library), so they are\n// validated as a uuid + the server's slug charset HERE, at the trust boundary, so\n// a hostile id='../../evil' or slug fails as CONTRACT_MISMATCH before delivery.\nimport { SLUG_RE, UUID_RE as RESOURCE_ID_RE } from './ids';\n\n/** The full essay body a 200 returns (loose: require what the CLI reads, keep the rest). */\nconst readBodySchema = z\n .object({\n id: z.string().regex(RESOURCE_ID_RE, 'resource id must be a uuid'),\n slug: z.string().regex(SLUG_RE, 'unsafe slug').max(80),\n title: z.string(),\n bodyMd: z.string(),\n price: z.string(),\n creator: z\n .object({\n handle: z.string().nullish(),\n walletAddress: z.string().nullish(),\n })\n .passthrough(),\n })\n .passthrough();\n\nexport type ReadBody = z.infer<typeof readBodySchema>;\n\n/**\n * The public half of the piece's answer card, carried on the 402 body when the\n * piece has one. The key is ABSENT (never null) on an uncarded piece, so callers\n * branch on presence; the projection emits every field whenever it emits the card\n * at all, so a present card is never partial. Nullable fields carry null.\n *\n * This is the depth half of the search/inspect split: the card left the search\n * candidate in search v2 and lives here, one free unpaid GET away.\n */\nexport const previewCardSchema = z\n .object({\n artifactType: z.string(),\n temporalMode: z.string(),\n asOf: z.string().nullable(),\n validUntil: z.string().nullable(),\n questionsAnswered: z.array(z.string()),\n tasksSupported: z.array(z.string()),\n appliesTo: z.record(z.string(), z.array(z.string())),\n scope: z.string().nullable(),\n exclusions: z.string().nullable(),\n provenanceSummary: z.string().nullable(),\n methodologySummary: z.string().nullable(),\n maintenanceCadence: z.string().nullable(),\n })\n .passthrough();\n\nexport type PreviewCard = z.infer<typeof previewCardSchema>;\n\n/** The leak-safe 402 preview body, never the paid content. */\nconst previewSchema = z\n .object({\n id: z.string().optional(),\n title: z.string().optional(),\n price: z.string().optional(),\n creator: z.record(z.string(), z.unknown()).optional(),\n // `.catch` keeps a botched card from taking the rest of the preview with it:\n // every other preview field is optional, so before the card existed a parse\n // failure here was near-impossible, and a server that half-fills the card\n // should still not cost the caller the title and the price it came for.\n // The drop is NOT silent: see `cardError` on the result below.\n card: previewCardSchema.optional().catch(undefined),\n // Set by the SERVER when the piece has a card it could not load, so an absent\n // card is never ambiguous: no flag means uncarded, this flag means temporarily\n // unreadable. Never false and never sent beside `card` (tenjin#500), and the\n // same fail-soft as above so a bogus `false` drops the flag rather than the\n // whole preview.\n cardUnavailable: z.literal(true).optional().catch(undefined),\n })\n .passthrough();\n\nexport type Preview = z.infer<typeof previewSchema>;\n\n// The decoded PAYMENT-REQUIRED is money-path input: validate the fields the pay\n// path consumes (amount as an atomic integer, CAIP-2 network, 0x asset/payTo)\n// at THIS boundary instead of trusting raw base64 JSON. Loose otherwise so new\n// server fields never break an older CLI.\nconst ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;\nconst paymentRequiredSchema = z\n .object({\n x402Version: z.literal(2),\n accepts: z.array(\n z\n .object({\n scheme: z.string(),\n network: z.string().regex(/^eip155:\\d+$/, 'network must be CAIP-2 eip155'),\n asset: z.string().regex(ADDRESS_RE, 'asset must be a 0x address'),\n amount: z.string().regex(/^\\d{1,39}$/, 'amount must be an atomic integer string'),\n payTo: z.string().regex(ADDRESS_RE, 'payTo must be a 0x address'),\n })\n .passthrough(),\n ),\n })\n .passthrough();\n\nexport type ReadResult =\n | { kind: 'entitled'; body: ReadBody; settlementTxHash?: string }\n | {\n kind: 'payment_required';\n paymentRequired: PaymentRequired;\n preview: Preview;\n /** The 402 carried a `card` this CLI could not parse, so `preview.card` is\n * absent for a reason that is NOT \"the piece is uncarded\". The two must\n * stay distinguishable: an uncarded piece is a real signal a buyer acts\n * on, and this 402 is the only pre-purchase depth there is. */\n cardError?: true;\n }\n | { kind: 'already_purchased'; message: string };\n\n/**\n * The extra outcome a SESSION-SIGNED read can have: a 401 saying the delegation is\n * expired, revoked, or bound to a key this server will not accept.\n *\n * It is a value rather than a thrown API_UNREACHABLE because the caller has a\n * defined answer for it — `read` falls to its ordinary exit-3 refusal, never a\n * retry loop, because re-establishing needs a wallet it cannot reach. And it is\n * kept OUT of `ReadResult` because an unsigned or SIWX 401 has no such contract:\n * widening the shared union would make `buy` and `inspect` branch on a state they\n * can never produce, and a \"cannot happen\" branch is where wrong handling hides.\n */\nexport type SessionReadResult = ReadResult | { kind: 'session_rejected'; code?: string };\n\nexport interface ReadRequestOptions {\n timeoutMs: number;\n fetchImpl?: typeof fetch;\n /** A `SIGN-IN-WITH-X` header for the entitled free re-read. */\n siwxHeader?: string;\n /** The `PAYMENT-SIGNATURE` header(s) for a paid request. */\n paymentHeaders?: Record<string, string>;\n /**\n * RFC 9421 session-key headers (`Tenjin-Session-Delegation`, `Signature-Input`,\n * `Signature`) proving an entitlement without a wallet and without paying. A\n * bodyless GET carries no `Content-Digest`, so the covered set is method+URI.\n */\n sessionHeaders?: Record<string, string>;\n /** Attribute a following purchase to the search that surfaced it. */\n searchId?: string;\n}\n\n/**\n * One transport, two result types, selected by whether the caller actually\n * presented a session key. The `session_rejected` arm is reachable only when\n * `sessionHeaders` were sent, so the overloads say exactly that instead of\n * leaving every caller to prove it by inspection.\n */\nexport async function fetchRead(\n url: string,\n opts: ReadRequestOptions & { sessionHeaders: Record<string, string> },\n): Promise<SessionReadResult>;\nexport async function fetchRead(url: string, opts: ReadRequestOptions): Promise<ReadResult>;\nexport async function fetchRead(url: string, opts: ReadRequestOptions): Promise<SessionReadResult> {\n const headers: Record<string, string> = {\n accept: 'application/json',\n 'x-tenjin-client': CLIENT_HEADER,\n };\n if (opts.searchId !== undefined) headers['x-tenjin-search-id'] = opts.searchId;\n if (opts.siwxHeader !== undefined) headers[SIWX_HEADER] = opts.siwxHeader;\n if (opts.sessionHeaders !== undefined) Object.assign(headers, opts.sessionHeaders);\n if (opts.paymentHeaders !== undefined) Object.assign(headers, opts.paymentHeaders);\n\n const res = await httpRequest(url, {\n method: 'GET',\n timeoutMs: opts.timeoutMs,\n headers,\n fetchImpl: opts.fetchImpl,\n // Pinned even when UNSIGNED (the first probe): a 200 from this route is\n // written to the library by `deliverFresh` as an entitlement record under\n // the server-chosen id/slug, and `findDeliveredByUrl` later matches saved\n // receipts by handle+slug alone — so a followed cross-origin redirect\n // would let another host's bytes short-circuit future buys as owned.\n // `assertOnBaseOrigin` cannot catch this; it checks only the URL asked for.\n //\n // Refused for ANY 3xx, same-origin hops included. The transport failing closed\n // on the whole class is the point: an exemption for \"benign\" redirects is a\n // second origin check living in the one place that already proved it cannot see\n // enough to make one. Keeping a canonical URL is the CALLER's job instead, and\n // `resolveResourceRef` does it for every verb that gets here.\n blockRedirects: true,\n });\n if (!res.ok) {\n // A redirect refused mid-flight is a URL-shape problem, not a flaky network:\n // retrying a signed request re-sends the same signature into the same\n // redirect, and retrying the unsigned probe re-fetches bytes the library must\n // never record as this origin's. The `fix` names the URL, not the route: the\n // route is allowed to redirect (canonicalizing a path is what a redirect is\n // FOR), and pointing an agent at the base URL for a hop the base URL did not\n // cause spends two useless steps and still does not read the piece.\n // `resolveResourceRef` canonicalizes what it can (the trailing slash); what\n // reaches here is a spelling it could not.\n if (res.kind === 'blocked-redirect') {\n throw new CliError('CONTRACT_MISMATCH', `${url}: ${res.message}`, {\n // The origin half of this hint deliberately does NOT name the base-URL\n // flag. `read` is meant to be allowlistable, the skill tells the agent\n // never to pass that flag on an allowlisted verb, and a `fix:` naming it\n // would coach exactly the move the skill forbids. `doctor` is the\n // allowlisted verb that owns the question — its `checkReadPath` probes\n // this route and its own copy names the config command when it should.\n fix:\n 'Ask for the URL in the spelling `tenjin search` or `tenjin inspect` ' +\n 'reports. If every read hops, `tenjin doctor` checks the configured origin.',\n });\n }\n const code =\n res.kind === 'network' || res.kind === 'timeout' ? 'NETWORK_ERROR' : 'API_UNREACHABLE';\n throw new CliError(code, `${url}: ${res.message}`, {\n fix: 'Check the resource URL and your network, then retry.',\n });\n }\n\n if (res.status === 200) {\n const parsed = readBodySchema.safeParse(res.json);\n if (!parsed.success) {\n throw new CliError(\n 'CONTRACT_MISMATCH',\n 'The read response did not match the expected contract',\n {\n fix: 'Update tenjin-cli; the read contract may have changed.',\n details: parsed.error.issues,\n },\n );\n }\n const settlement = decodeSettlement(res.header(PAYMENT_RESPONSE_HEADER));\n return {\n kind: 'entitled',\n body: parsed.data,\n ...(settlement !== undefined ? { settlementTxHash: settlement } : {}),\n };\n }\n\n if (res.status === 402) {\n const encoded = res.header(PAYMENT_REQUIRED_HEADER);\n if (encoded === undefined) {\n throw new CliError('CONTRACT_MISMATCH', 'The 402 carried no PAYMENT-REQUIRED header', {\n fix: 'The server may be misconfigured; try another resource or update tenjin-cli.',\n });\n }\n let decoded: PaymentRequired;\n try {\n decoded = decodePaymentRequiredHeader(encoded);\n } catch (err) {\n throw new CliError('CONTRACT_MISMATCH', 'Could not decode the PAYMENT-REQUIRED header', {\n fix: 'Update tenjin-cli; the x402 header format may have changed.',\n cause: err,\n });\n }\n const validated = paymentRequiredSchema.safeParse(decoded);\n if (!validated.success) {\n throw new CliError(\n 'CONTRACT_MISMATCH',\n 'The 402 challenge is not a valid x402 v2 payment declaration.',\n {\n fix: 'Update tenjin-cli, or check the configured base URL (`tenjin config get baseUrl`) points at a Tenjin deployment.',\n details: validated.error.issues,\n },\n );\n }\n const paymentRequired = decoded;\n const parsed = previewSchema.safeParse(res.json);\n const preview = parsed.success ? parsed.data : {};\n return {\n kind: 'payment_required',\n paymentRequired,\n preview,\n ...(sentUnparsableCard(res.json, preview) ? { cardError: true as const } : {}),\n };\n }\n\n // Narrow on purpose: only a request that actually presented a session key gets\n // the soft outcome. Widening this to every 401 would quietly turn buy's SIWX\n // re-check failure into a value the caller has to remember to branch on.\n if (res.status === 401 && opts.sessionHeaders !== undefined) {\n const code = readCode(res.json);\n return { kind: 'session_rejected', ...(code !== undefined ? { code } : {}) };\n }\n\n if (res.status === 409) {\n // The owned-re-pay gate: a payment for a post this wallet already bought is\n // refused, nothing charged. The caller falls back to a SIWX free re-read.\n return { kind: 'already_purchased', message: readMessage(res.json) ?? 'Already purchased.' };\n }\n\n if (res.status === 404) {\n throw new CliError('RESOURCE_NOT_FOUND', `No resource at ${url}`, {\n fix: 'Check the handle/slug or resource id.',\n });\n }\n\n // 429 on the paid-read path is a recoverable pause, not an outage: surface\n // RATE_LIMITED + retryAfterSeconds like postSearch/postOutcomes do, so a looping\n // agent (the caller most likely to hit this) can back off instead of treating it\n // as API_UNREACHABLE.\n if (res.status === 429) throw rateLimitError(url, (n) => res.header(n));\n\n throw new CliError(\n 'API_UNREACHABLE',\n readMessage(res.json) ?? `Unexpected status ${res.status} from ${url}`,\n {\n fix: 'Retry; if it persists the resource may be unavailable.',\n details: res.json,\n },\n );\n}\n\n/** The server sent a `card` key but nothing survived the parse. Distinguishes a\n * DROPPED card from an absent one, which the `.catch` above otherwise makes\n * look identical. */\nfunction sentUnparsableCard(json: unknown, preview: Preview): boolean {\n if (typeof json !== 'object' || json === null) return false;\n return 'card' in json && preview.card === undefined;\n}\n\nfunction decodeSettlement(header: string | undefined): string | undefined {\n if (header === undefined) return undefined;\n try {\n const settle = decodePaymentResponseHeader(header);\n const tx = (settle as { transaction?: unknown }).transaction;\n return typeof tx === 'string' ? tx : undefined;\n } catch {\n return undefined;\n }\n}\n\n/** The server's machine `code` on an auth failure (`session_expired`, …), if any. */\nfunction readCode(json: unknown): string | undefined {\n if (typeof json !== 'object' || json === null) return undefined;\n const code = (json as Record<string, unknown>).code;\n return typeof code === 'string' ? code : undefined;\n}\n\nfunction readMessage(json: unknown): string | undefined {\n if (typeof json === 'object' && json !== null) {\n const rec = json as Record<string, unknown>;\n if (typeof rec.message === 'string') return rec.message;\n if (typeof rec.error === 'string') return rec.error;\n if (typeof rec.code === 'string') return rec.code;\n }\n return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmBA,IAAM,0BAA0B;AAChC,IAAM,0BAA0B;AAQhC,IAAM,iBAAiB,iBACpB,OAAO;AAAA,EACN,IAAI,iBAAE,OAAO,EAAE,MAAM,SAAgB,4BAA4B;AAAA,EACjE,MAAM,iBAAE,OAAO,EAAE,MAAM,SAAS,aAAa,EAAE,IAAI,EAAE;AAAA,EACrD,OAAO,iBAAE,OAAO;AAAA,EAChB,QAAQ,iBAAE,OAAO;AAAA,EACjB,OAAO,iBAAE,OAAO;AAAA,EAChB,SAAS,iBACN,OAAO;AAAA,IACN,QAAQ,iBAAE,OAAO,EAAE,QAAQ;AAAA,IAC3B,eAAe,iBAAE,OAAO,EAAE,QAAQ;AAAA,EACpC,CAAC,EACA,YAAY;AACjB,CAAC,EACA,YAAY;AAaR,IAAM,oBAAoB,iBAC9B,OAAO;AAAA,EACN,cAAc,iBAAE,OAAO;AAAA,EACvB,cAAc,iBAAE,OAAO;AAAA,EACvB,MAAM,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,YAAY,iBAAE,OAAO,EAAE,SAAS;AAAA,EAChC,mBAAmB,iBAAE,MAAM,iBAAE,OAAO,CAAC;AAAA,EACrC,gBAAgB,iBAAE,MAAM,iBAAE,OAAO,CAAC;AAAA,EAClC,WAAW,iBAAE,OAAO,iBAAE,OAAO,GAAG,iBAAE,MAAM,iBAAE,OAAO,CAAC,CAAC;AAAA,EACnD,OAAO,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,YAAY,iBAAE,OAAO,EAAE,SAAS;AAAA,EAChC,mBAAmB,iBAAE,OAAO,EAAE,SAAS;AAAA,EACvC,oBAAoB,iBAAE,OAAO,EAAE,SAAS;AAAA,EACxC,oBAAoB,iBAAE,OAAO,EAAE,SAAS;AAC1C,CAAC,EACA,YAAY;AAKf,IAAM,gBAAgB,iBACnB,OAAO;AAAA,EACN,IAAI,iBAAE,OAAO,EAAE,SAAS;AAAA,EACxB,OAAO,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,OAAO,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,SAAS,iBAAE,OAAO,iBAAE,OAAO,GAAG,iBAAE,QAAQ,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpD,MAAM,kBAAkB,SAAS,EAAE,MAAM,MAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlD,iBAAiB,iBAAE,QAAQ,IAAI,EAAE,SAAS,EAAE,MAAM,MAAS;AAC7D,CAAC,EACA,YAAY;AAQf,IAAM,aAAa;AACnB,IAAM,wBAAwB,iBAC3B,OAAO;AAAA,EACN,aAAa,iBAAE,QAAQ,CAAC;AAAA,EACxB,SAAS,iBAAE;AAAA,IACT,iBACG,OAAO;AAAA,MACN,QAAQ,iBAAE,OAAO;AAAA,MACjB,SAAS,iBAAE,OAAO,EAAE,MAAM,gBAAgB,+BAA+B;AAAA,MACzE,OAAO,iBAAE,OAAO,EAAE,MAAM,YAAY,4BAA4B;AAAA,MAChE,QAAQ,iBAAE,OAAO,EAAE,MAAM,cAAc,yCAAyC;AAAA,MAChF,OAAO,iBAAE,OAAO,EAAE,MAAM,YAAY,4BAA4B;AAAA,IAClE,CAAC,EACA,YAAY;AAAA,EACjB;AACF,CAAC,EACA,YAAY;AAyDf,eAAsB,UAAU,KAAa,MAAsD;AACjG,QAAM,UAAkC;AAAA,IACtC,QAAQ;AAAA,IACR,mBAAmB;AAAA,EACrB;AACA,MAAI,KAAK,aAAa,OAAW,SAAQ,oBAAoB,IAAI,KAAK;AACtE,MAAI,KAAK,eAAe,OAAW,SAAQ,WAAW,IAAI,KAAK;AAC/D,MAAI,KAAK,mBAAmB,OAAW,QAAO,OAAO,SAAS,KAAK,cAAc;AACjF,MAAI,KAAK,mBAAmB,OAAW,QAAO,OAAO,SAAS,KAAK,cAAc;AAEjF,QAAM,MAAM,MAAM,YAAY,KAAK;AAAA,IACjC,QAAQ;AAAA,IACR,WAAW,KAAK;AAAA,IAChB;AAAA,IACA,WAAW,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAahB,gBAAgB;AAAA,EAClB,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AAUX,QAAI,IAAI,SAAS,oBAAoB;AACnC,YAAM,IAAI,SAAS,qBAAqB,GAAG,GAAG,KAAK,IAAI,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOhE,KACE;AAAA,MAEJ,CAAC;AAAA,IACH;AACA,UAAM,OACJ,IAAI,SAAS,aAAa,IAAI,SAAS,YAAY,kBAAkB;AACvE,UAAM,IAAI,SAAS,MAAM,GAAG,GAAG,KAAK,IAAI,OAAO,IAAI;AAAA,MACjD,KAAK;AAAA,IACP,CAAC;AAAA,EACH;AAEA,MAAI,IAAI,WAAW,KAAK;AACtB,UAAM,SAAS,eAAe,UAAU,IAAI,IAAI;AAChD,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,UACE,KAAK;AAAA,UACL,SAAS,OAAO,MAAM;AAAA,QACxB;AAAA,MACF;AAAA,IACF;AACA,UAAM,aAAa,iBAAiB,IAAI,OAAO,uBAAuB,CAAC;AACvE,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM,OAAO;AAAA,MACb,GAAI,eAAe,SAAY,EAAE,kBAAkB,WAAW,IAAI,CAAC;AAAA,IACrE;AAAA,EACF;AAEA,MAAI,IAAI,WAAW,KAAK;AACtB,UAAM,UAAU,IAAI,OAAO,uBAAuB;AAClD,QAAI,YAAY,QAAW;AACzB,YAAM,IAAI,SAAS,qBAAqB,8CAA8C;AAAA,QACpF,KAAK;AAAA,MACP,CAAC;AAAA,IACH;AACA,QAAI;AACJ,QAAI;AACF,gBAAU,4BAA4B,OAAO;AAAA,IAC/C,SAAS,KAAK;AACZ,YAAM,IAAI,SAAS,qBAAqB,gDAAgD;AAAA,QACtF,KAAK;AAAA,QACL,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AACA,UAAM,YAAY,sBAAsB,UAAU,OAAO;AACzD,QAAI,CAAC,UAAU,SAAS;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,UACE,KAAK;AAAA,UACL,SAAS,UAAU,MAAM;AAAA,QAC3B;AAAA,MACF;AAAA,IACF;AACA,UAAM,kBAAkB;AACxB,UAAM,SAAS,cAAc,UAAU,IAAI,IAAI;AAC/C,UAAM,UAAU,OAAO,UAAU,OAAO,OAAO,CAAC;AAChD,WAAO;AAAA,MACL,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA,GAAI,mBAAmB,IAAI,MAAM,OAAO,IAAI,EAAE,WAAW,KAAc,IAAI,CAAC;AAAA,IAC9E;AAAA,EACF;AAKA,MAAI,IAAI,WAAW,OAAO,KAAK,mBAAmB,QAAW;AAC3D,UAAM,OAAO,SAAS,IAAI,IAAI;AAC9B,WAAO,EAAE,MAAM,oBAAoB,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC,EAAG;AAAA,EAC7E;AAEA,MAAI,IAAI,WAAW,KAAK;AAGtB,WAAO,EAAE,MAAM,qBAAqB,SAAS,YAAY,IAAI,IAAI,KAAK,qBAAqB;AAAA,EAC7F;AAEA,MAAI,IAAI,WAAW,KAAK;AACtB,UAAM,IAAI,SAAS,sBAAsB,kBAAkB,GAAG,IAAI;AAAA,MAChE,KAAK;AAAA,IACP,CAAC;AAAA,EACH;AAMA,MAAI,IAAI,WAAW,IAAK,OAAM,eAAe,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC;AAEtE,QAAM,IAAI;AAAA,IACR;AAAA,IACA,YAAY,IAAI,IAAI,KAAK,qBAAqB,IAAI,MAAM,SAAS,GAAG;AAAA,IACpE;AAAA,MACE,KAAK;AAAA,MACL,SAAS,IAAI;AAAA,IACf;AAAA,EACF;AACF;AAKA,SAAS,mBAAmB,MAAe,SAA2B;AACpE,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,SAAO,UAAU,QAAQ,QAAQ,SAAS;AAC5C;AAEA,SAAS,iBAAiB,QAAgD;AACxE,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI;AACF,UAAM,SAAS,4BAA4B,MAAM;AACjD,UAAM,KAAM,OAAqC;AACjD,WAAO,OAAO,OAAO,WAAW,KAAK;AAAA,EACvC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,SAAS,MAAmC;AACnD,MAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO;AACtD,QAAM,OAAQ,KAAiC;AAC/C,SAAO,OAAO,SAAS,WAAW,OAAO;AAC3C;AAEA,SAAS,YAAY,MAAmC;AACtD,MAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAC7C,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,YAAY,SAAU,QAAO,IAAI;AAChD,QAAI,OAAO,IAAI,UAAU,SAAU,QAAO,IAAI;AAC9C,QAAI,OAAO,IAAI,SAAS,SAAU,QAAO,IAAI;AAAA,EAC/C;AACA,SAAO;AACT;","names":[]}