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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. package/README.md +51 -3
  2. package/dist/buy-VIRNSYGN.js +47 -0
  3. package/dist/{chunk-OC3EIDCP.js → chunk-2MYQN7HM.js} +71 -26
  4. package/dist/chunk-2MYQN7HM.js.map +1 -0
  5. package/dist/{chunk-XXY77EZJ.js → chunk-2RF2GIJQ.js} +57 -226
  6. package/dist/chunk-2RF2GIJQ.js.map +1 -0
  7. package/dist/chunk-3GL2Z5QK.js +57 -0
  8. package/dist/chunk-3GL2Z5QK.js.map +1 -0
  9. package/dist/{chunk-OXUJ3FXU.js → chunk-4CQIDQOT.js} +41 -8
  10. package/dist/chunk-4CQIDQOT.js.map +1 -0
  11. package/dist/{chunk-YMUJZWHB.js → chunk-4KG27W2S.js} +10 -10
  12. package/dist/chunk-4KG27W2S.js.map +1 -0
  13. package/dist/{chunk-SPUORKD7.js → chunk-5QQTYWEU.js} +13 -13
  14. package/dist/chunk-5QQTYWEU.js.map +1 -0
  15. package/dist/chunk-65DTCCJ7.js +21 -0
  16. package/dist/chunk-65DTCCJ7.js.map +1 -0
  17. package/dist/{chunk-BRAVLUGI.js → chunk-A5DKHMUN.js} +28 -13
  18. package/dist/chunk-A5DKHMUN.js.map +1 -0
  19. package/dist/chunk-B63XPWQ4.js +246 -0
  20. package/dist/chunk-B63XPWQ4.js.map +1 -0
  21. package/dist/{chunk-47YKYDOF.js → chunk-CAR6FHK6.js} +5 -5
  22. package/dist/{chunk-JVBMPU5G.js → chunk-CPCX67TI.js} +22 -22
  23. package/dist/{chunk-TXVC46SA.js → chunk-CQBVCYI2.js} +40 -53
  24. package/dist/chunk-CQBVCYI2.js.map +1 -0
  25. package/dist/chunk-DBU5CXBV.js +4731 -0
  26. package/dist/chunk-DBU5CXBV.js.map +1 -0
  27. package/dist/chunk-DHJD77OW.js +81 -0
  28. package/dist/chunk-DHJD77OW.js.map +1 -0
  29. package/dist/{chunk-XGZ5EVMB.js → chunk-EDZSNPE5.js} +2 -2
  30. package/dist/{chunk-736DW4V3.js → chunk-EFWZPUTC.js} +2 -2
  31. package/dist/chunk-EPFL6CTE.js +448 -0
  32. package/dist/chunk-EPFL6CTE.js.map +1 -0
  33. package/dist/{chunk-3P3ES4XU.js → chunk-GHLVXVZD.js} +3 -5
  34. package/dist/{chunk-3P3ES4XU.js.map → chunk-GHLVXVZD.js.map} +1 -1
  35. package/dist/{chunk-UUARTUY2.js → chunk-H3SOOJ2I.js} +264 -33
  36. package/dist/chunk-H3SOOJ2I.js.map +1 -0
  37. package/dist/{chunk-OUJDDY5L.js → chunk-HPJGOLTN.js} +32 -32
  38. package/dist/chunk-HPJGOLTN.js.map +1 -0
  39. package/dist/{chunk-J6FUAIRR.js → chunk-HRGBS2PA.js} +4 -6
  40. package/dist/{chunk-J6FUAIRR.js.map → chunk-HRGBS2PA.js.map} +1 -1
  41. package/dist/{chunk-NKN4YC5C.js → chunk-ITUXPJIS.js} +55 -58
  42. package/dist/chunk-ITUXPJIS.js.map +1 -0
  43. package/dist/{chunk-CA3JV7FX.js → chunk-JBIKAAT3.js} +2 -2
  44. package/dist/{chunk-CA3JV7FX.js.map → chunk-JBIKAAT3.js.map} +1 -1
  45. package/dist/{chunk-6JKD46OJ.js → chunk-KAJZHIQ4.js} +13 -10
  46. package/dist/chunk-KAJZHIQ4.js.map +1 -0
  47. package/dist/{chunk-OWVVI4VQ.js → chunk-KINZ23CV.js} +107 -4535
  48. package/dist/chunk-KINZ23CV.js.map +1 -0
  49. package/dist/{chunk-WMFRCSNC.js → chunk-LRYV3SK7.js} +9 -7
  50. package/dist/{chunk-WMFRCSNC.js.map → chunk-LRYV3SK7.js.map} +1 -1
  51. package/dist/{chunk-T4UWMVKV.js → chunk-NIKXHWOL.js} +11 -13
  52. package/dist/{chunk-T4UWMVKV.js.map → chunk-NIKXHWOL.js.map} +1 -1
  53. package/dist/chunk-OKDRDT74.js +209 -0
  54. package/dist/chunk-OKDRDT74.js.map +1 -0
  55. package/dist/chunk-OKYSNAS3.js +2144 -0
  56. package/dist/chunk-OKYSNAS3.js.map +1 -0
  57. package/dist/{chunk-B676GPS2.js → chunk-OLWTRUTS.js} +7 -3
  58. package/dist/{chunk-B676GPS2.js.map → chunk-OLWTRUTS.js.map} +1 -1
  59. package/dist/{chunk-WU5CZPLD.js → chunk-QQ6ELLSA.js} +6 -8
  60. package/dist/{chunk-WU5CZPLD.js.map → chunk-QQ6ELLSA.js.map} +1 -1
  61. package/dist/{chunk-WVHPGQH5.js → chunk-QZ6ROAJU.js} +8 -4
  62. package/dist/chunk-QZ6ROAJU.js.map +1 -0
  63. package/dist/{chunk-L4XNT3UW.js → chunk-R7RSCBI7.js} +167 -52
  64. package/dist/chunk-R7RSCBI7.js.map +1 -0
  65. package/dist/{chunk-ELVDOTU7.js → chunk-U6VPKMGC.js} +128 -28
  66. package/dist/chunk-U6VPKMGC.js.map +1 -0
  67. package/dist/{chunk-FKSAUOJU.js → chunk-UO22YNY4.js} +1 -69
  68. package/dist/chunk-UO22YNY4.js.map +1 -0
  69. package/dist/{chunk-IAR25V2E.js → chunk-US456VUI.js} +6 -6
  70. package/dist/{chunk-IKAJSA7E.js → chunk-V44J2MXV.js} +80 -34
  71. package/dist/chunk-V44J2MXV.js.map +1 -0
  72. package/dist/{chunk-IFPKA32J.js → chunk-VJQKL3YH.js} +10 -7
  73. package/dist/{chunk-IFPKA32J.js.map → chunk-VJQKL3YH.js.map} +1 -1
  74. package/dist/{chunk-GCGMXA2O.js → chunk-VJSQSLBM.js} +52 -20
  75. package/dist/chunk-VJSQSLBM.js.map +1 -0
  76. package/dist/{chunk-IGHSLJUF.js → chunk-VYOJOX4Z.js} +9 -7
  77. package/dist/chunk-VYOJOX4Z.js.map +1 -0
  78. package/dist/chunk-WY2K35OL.js +269 -0
  79. package/dist/chunk-WY2K35OL.js.map +1 -0
  80. package/dist/{chunk-PAOVPSP6.js → chunk-ZFJJ3EXC.js} +53 -5
  81. package/dist/chunk-ZFJJ3EXC.js.map +1 -0
  82. package/dist/chunk-ZOBNS7CX.js +73 -0
  83. package/dist/chunk-ZOBNS7CX.js.map +1 -0
  84. package/dist/{cli-XK5JZWU6.js → cli-KKRKBU5T.js} +76 -47
  85. package/dist/{cli-XK5JZWU6.js.map → cli-KKRKBU5T.js.map} +1 -1
  86. package/dist/config-JMRUNYE6.js +37 -0
  87. package/dist/discover-B5HF6SHM.js +102 -0
  88. package/dist/discover-B5HF6SHM.js.map +1 -0
  89. package/dist/doctor-ZBG7X66D.js +32 -0
  90. package/dist/edit-PZJIILQE.js +40 -0
  91. package/dist/{fund-JF6A76YS.js → fund-EUDH5KPA.js} +19 -17
  92. package/dist/index.js +1 -1
  93. package/dist/inspect-QC6WEQPN.js +37 -0
  94. package/dist/{install-YQVM3SUW.js → install-GNK2W3PI.js} +286 -447
  95. package/dist/install-GNK2W3PI.js.map +1 -0
  96. package/dist/outcome-KSGWZHUS.js +24 -0
  97. package/dist/pay-BC4UICPA.js +361 -0
  98. package/dist/pay-BC4UICPA.js.map +1 -0
  99. package/dist/publish-LXWFDIKF.js +42 -0
  100. package/dist/{read-UF7QVQOU.js → read-JMNUQ56P.js} +22 -20
  101. package/dist/{read-UF7QVQOU.js.map → read-JMNUQ56P.js.map} +1 -1
  102. package/dist/{run-GDZWHNWZ.js → run-XYTQ5TWQ.js} +54 -45
  103. package/dist/{run-GDZWHNWZ.js.map → run-XYTQ5TWQ.js.map} +1 -1
  104. package/dist/search-TSQAB45E.js +25 -0
  105. package/dist/{send-SI254H3R.js → send-G746D7PQ.js} +14 -14
  106. package/dist/{session-GJZJEXLJ.js → session-JBKWMJ24.js} +18 -17
  107. package/dist/{session-GJZJEXLJ.js.map → session-JBKWMJ24.js.map} +1 -1
  108. package/dist/{skill-heal-BPFT22XS.js → skill-heal-WKD67SLJ.js} +17 -9
  109. package/dist/skill-heal-WKD67SLJ.js.map +1 -0
  110. package/dist/skill-placement-RIU4AMC2.js +20 -0
  111. package/dist/{uninstall-7ZZG6WQ5.js → uninstall-5E263VTS.js} +15 -9
  112. package/dist/uninstall-5E263VTS.js.map +1 -0
  113. package/dist/{update-FPSBITLB.js → update-R76LHOZW.js} +18 -16
  114. package/dist/update-R76LHOZW.js.map +1 -0
  115. package/dist/{wallet-NS7TYWNN.js → wallet-TQ7D5EQ7.js} +7 -7
  116. package/dist/{wallet-TZVD2M4I.js → wallet-ZAVXWLWP.js} +11 -11
  117. package/dist/wallet-ZAVXWLWP.js.map +1 -0
  118. package/docs/agent-permissions.md +117 -18
  119. package/docs/command-reference.md +102 -50
  120. package/docs/safety-model.md +9 -0
  121. package/package.json +1 -1
  122. package/skills/tenjin/SKILL.md +38 -29
  123. package/skills/tenjin-pay/SKILL.md +76 -0
  124. package/skills/tenjin-publish/SKILL.md +184 -205
  125. package/skills/tenjin-publish/references/maintain.md +39 -0
  126. package/skills/tenjin-search/SKILL.md +92 -280
  127. package/skills/tenjin-search/references/permissions.md +112 -0
  128. package/dist/buy-X4VPHFUA.js +0 -44
  129. package/dist/chunk-3NZCU6SD.js +0 -125
  130. package/dist/chunk-3NZCU6SD.js.map +0 -1
  131. package/dist/chunk-6JKD46OJ.js.map +0 -1
  132. package/dist/chunk-BRAVLUGI.js.map +0 -1
  133. package/dist/chunk-ELVDOTU7.js.map +0 -1
  134. package/dist/chunk-FKSAUOJU.js.map +0 -1
  135. package/dist/chunk-GCGMXA2O.js.map +0 -1
  136. package/dist/chunk-IGHSLJUF.js.map +0 -1
  137. package/dist/chunk-IKAJSA7E.js.map +0 -1
  138. package/dist/chunk-L4XNT3UW.js.map +0 -1
  139. package/dist/chunk-NKN4YC5C.js.map +0 -1
  140. package/dist/chunk-OC3EIDCP.js.map +0 -1
  141. package/dist/chunk-OE36HRWG.js +0 -939
  142. package/dist/chunk-OE36HRWG.js.map +0 -1
  143. package/dist/chunk-OUJDDY5L.js.map +0 -1
  144. package/dist/chunk-OWVVI4VQ.js.map +0 -1
  145. package/dist/chunk-OXUJ3FXU.js.map +0 -1
  146. package/dist/chunk-PAOVPSP6.js.map +0 -1
  147. package/dist/chunk-SPUORKD7.js.map +0 -1
  148. package/dist/chunk-TXVC46SA.js.map +0 -1
  149. package/dist/chunk-UUARTUY2.js.map +0 -1
  150. package/dist/chunk-WVHPGQH5.js.map +0 -1
  151. package/dist/chunk-XXY77EZJ.js.map +0 -1
  152. package/dist/chunk-YMUJZWHB.js.map +0 -1
  153. package/dist/chunk-ZQIQ55KK.js +0 -51
  154. package/dist/chunk-ZQIQ55KK.js.map +0 -1
  155. package/dist/config-CNK7MYUR.js +0 -26
  156. package/dist/doctor-R7N7FUX5.js +0 -27
  157. package/dist/edit-QSUEG7CL.js +0 -38
  158. package/dist/inspect-NFNAA4LA.js +0 -35
  159. package/dist/install-YQVM3SUW.js.map +0 -1
  160. package/dist/outcome-IUSYFJTN.js +0 -22
  161. package/dist/publish-O2I6IAEL.js +0 -40
  162. package/dist/search-JVOHEF3E.js +0 -23
  163. package/dist/skill-heal-BPFT22XS.js.map +0 -1
  164. package/dist/uninstall-7ZZG6WQ5.js.map +0 -1
  165. package/dist/update-FPSBITLB.js.map +0 -1
  166. /package/dist/{buy-X4VPHFUA.js.map → buy-VIRNSYGN.js.map} +0 -0
  167. /package/dist/{chunk-47YKYDOF.js.map → chunk-CAR6FHK6.js.map} +0 -0
  168. /package/dist/{chunk-JVBMPU5G.js.map → chunk-CPCX67TI.js.map} +0 -0
  169. /package/dist/{chunk-XGZ5EVMB.js.map → chunk-EDZSNPE5.js.map} +0 -0
  170. /package/dist/{chunk-736DW4V3.js.map → chunk-EFWZPUTC.js.map} +0 -0
  171. /package/dist/{chunk-IAR25V2E.js.map → chunk-US456VUI.js.map} +0 -0
  172. /package/dist/{config-CNK7MYUR.js.map → config-JMRUNYE6.js.map} +0 -0
  173. /package/dist/{doctor-R7N7FUX5.js.map → doctor-ZBG7X66D.js.map} +0 -0
  174. /package/dist/{edit-QSUEG7CL.js.map → edit-PZJIILQE.js.map} +0 -0
  175. /package/dist/{fund-JF6A76YS.js.map → fund-EUDH5KPA.js.map} +0 -0
  176. /package/dist/{inspect-NFNAA4LA.js.map → inspect-QC6WEQPN.js.map} +0 -0
  177. /package/dist/{outcome-IUSYFJTN.js.map → outcome-KSGWZHUS.js.map} +0 -0
  178. /package/dist/{publish-O2I6IAEL.js.map → publish-LXWFDIKF.js.map} +0 -0
  179. /package/dist/{search-JVOHEF3E.js.map → search-TSQAB45E.js.map} +0 -0
  180. /package/dist/{send-SI254H3R.js.map → send-G746D7PQ.js.map} +0 -0
  181. /package/dist/{wallet-NS7TYWNN.js.map → skill-placement-RIU4AMC2.js.map} +0 -0
  182. /package/dist/{wallet-TZVD2M4I.js.map → wallet-TQ7D5EQ7.js.map} +0 -0
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/lib/session-key.ts"],"sourcesContent":["import { webcrypto } from 'node:crypto';\nimport { sessionPath } from './paths';\nimport { writeFileAtomic } from './atomic-json';\nimport { buildSiwxHeader } from './siwx';\nimport { originOf } from './url';\nimport {\n isSessionUsable,\n loadSessionFile,\n signWithSession,\n type SessionFile,\n type SessionKeyDeps,\n type SessionScope,\n type SignableRequest,\n} from './session-present';\nimport type { TenjinSigner } from './wallet/provider';\n\n/**\n * Session-key delegation (RFC 9421 signed HTTP, RFC 9530-shaped Content-Digest),\n * verified byte-for-byte against the live \"Auth — session keys\" contract in\n * https://tenjin.blog/llms-full.txt (D35).\n *\n * The point: a plain SIWX write burns a single-use nonce, so every write needs a\n * fresh WALLET signature. A session key trades that for ONE wallet signature per\n * session: generate a P-256 keypair, wallet-sign a SIWX message binding its\n * pubkey/exp/scope, then sign each subsequent write with the P-256 key (no wallet\n * popup) until the delegation expires. The delegated key is short-lived (≤24h,\n * server-clamped) and cached 0600, address-bound so a wallet change invalidates it.\n *\n * This module is the MINT half — everything that needs a wallet signer, i.e.\n * `establishSession`, the cache writer, and the two `WriteAuth` implementations.\n * The present-only half (load a file, sign one request with it) lives in\n * `session-present.ts` and is re-exported below, so `posts-api`/`publish`/`edit`\n * keep importing one module while `read` can import the present half ALONE and\n * stay structurally unable to open a keystore. Do not move a signer-touching\n * function down into `session-present.ts`: read's import-graph pin is what makes\n * \"read cannot mint and cannot pay\" a property of the code rather than a promise.\n *\n * A minted delegation is a wallet-derived credential, so it is bound to the\n * ORIGIN it was minted against and every presenter re-checks that binding.\n *\n * Never hand-rolls crypto: P-256 keygen is node:crypto webcrypto (subtle) and the\n * wallet delegation reuses the siwx.ts seam.\n */\n\nexport {\n contentDigest,\n isSessionPresentable,\n readSessionFile,\n isSessionUsable,\n keyidFor,\n loadSessionFile,\n scopeSatisfies,\n signatureBase,\n signatureParams,\n signWithSession,\n targetUri,\n} from './session-present';\nexport type {\n SessionFile,\n SessionFileState,\n SessionKeyDeps,\n SessionScope,\n SignableRequest,\n SignatureParamsInput,\n} from './session-present';\n\n/**\n * The chain a session delegation is signed over. Writes require Base mainnet per\n * the server's SIWX chain constraint, and a session covers reads and writes\n * alike, so there is exactly ONE session chain id rather than a per-caller\n * choice: `session start` and the write path must mint against the same chain or\n * the file they share would flip between two delegations.\n */\nexport const SESSION_CHAIN_ID = 'eip155:8453';\n\nconst SESSION_TTL_MS = 24 * 60 * 60 * 1000; // 24h; the server clamps to ≤24h.\n\n/**\n * The write-auth seam a posts client signs through. `headersFor` attaches the\n * signature headers (establishing the session lazily on first use); `recover`\n * reacts to a 401 by returning whether a retry is worthwhile.\n */\nexport interface WriteAuth {\n headersFor(req: SignableRequest): Promise<Record<string, string>>;\n /** React to a write's 401 `code`; true ⇒ the next headersFor retry may succeed. */\n recover(code: string | undefined): Promise<boolean>;\n}\n\nexport interface SessionKeyConfig {\n signer: TenjinSigner;\n baseUrl: string;\n chainId: string;\n dataDir: string;\n /**\n * The scope this session is minted at, and the scope a cached session must\n * cover to be reused. Required, not defaulted: over-granting silently is the\n * failure mode worth making impossible, so every caller states what it needs.\n */\n scope: SessionScope;\n}\n\nconst subtle = webcrypto.subtle;\n\nfunction generateP256KeyPair(): Promise<webcrypto.CryptoKeyPair> {\n return subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, [\n 'sign',\n 'verify',\n ]) as Promise<webcrypto.CryptoKeyPair>;\n}\n\n/** base64url (no padding) of raw bytes — the pubkey/keyid encoding. */\nfunction toBase64Url(bytes: Uint8Array): string {\n return Buffer.from(bytes).toString('base64url');\n}\n\n/** The three URNs bound into the delegation's SIWX `resources` array (D35). */\nexport function delegationResources(\n publicKeyRaw: string,\n expIso: string,\n scope: SessionScope,\n): string[] {\n return [\n `urn:tenjin:session:pubkey:p256:${publicKeyRaw}`,\n `urn:tenjin:session:exp:${expIso}`,\n `urn:tenjin:session:scope:${scope}`,\n ];\n}\n\n/**\n * Establish a session with ONE wallet signature: generate a P-256 keypair, bind\n * its pubkey/exp/scope into a SIWX message, wallet-sign it, and cache the result\n * 0600 address-bound. The returned file's `delegation` is the constant\n * `Tenjin-Session-Delegation` header for the session's life.\n */\nexport async function establishSession(\n config: SessionKeyConfig,\n deps: SessionKeyDeps = {},\n): Promise<SessionFile> {\n const now = deps.now ?? Date.now;\n const pair = await generateP256KeyPair();\n const rawPub = new Uint8Array(await subtle.exportKey('raw', pair.publicKey));\n const publicKeyRaw = toBase64Url(rawPub);\n const jwk = (await subtle.exportKey('jwk', pair.privateKey)) as SessionFile['privateKeyJwk'];\n\n const expIso = new Date(now() + SESSION_TTL_MS).toISOString();\n const delegation = await buildSiwxHeader(config.signer, {\n baseUrl: config.baseUrl,\n chainId: config.chainId,\n ttlMs: SESSION_TTL_MS,\n statement: 'Delegate a Tenjin session key.',\n resources: delegationResources(publicKeyRaw, expIso, config.scope),\n });\n\n const file: SessionFile = {\n address: config.signer.address.toLowerCase(),\n origin: originOf(config.baseUrl),\n delegation,\n exp: expIso,\n scope: config.scope,\n publicKeyRaw,\n privateKeyJwk: jwk,\n };\n await saveSessionFile(config.dataDir, file);\n return file;\n}\n\n// ---------------------------------------------------------------------------\n// Cache writes (0600, address-bound). The reader lives in session-present.\n// ---------------------------------------------------------------------------\n\nexport async function saveSessionFile(dir: string, file: SessionFile): Promise<void> {\n await writeFileAtomic(sessionPath(dir), `${JSON.stringify(file, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n}\n\n// ---------------------------------------------------------------------------\n// The WriteAuth implementation: lazy establish, cache reuse, 401 recovery.\n// ---------------------------------------------------------------------------\n\n/** How each 401 `code` maps to recovery (per the llms-full.txt policy section). */\ntype Recovery = 'resign' | 'reestablish' | 'fatal';\n\nexport function recoveryFor(code: string | undefined): Recovery {\n switch (code) {\n case 'proof_expired':\n // The per-request signature is too old; just re-sign (no wallet).\n return 'resign';\n case 'session_expired':\n case 'proof_revoked':\n case 'insufficient_scope':\n // The delegation itself is gone/insufficient; re-establish (one wallet sig).\n return 'reestablish';\n case 'session_key_unbound':\n // keyid ≠ the delegation-bound key: retrying cannot fix it.\n return 'fatal';\n default:\n return 'fatal';\n }\n}\n\n/**\n * A session-key WriteAuth: mints (or loads) the delegation on first use and signs\n * every write with the P-256 key — so a returning agent never wallet-signs again\n * until the session expires. On a 401 it re-signs or re-establishes per the code.\n */\nexport function createSessionKeyAuth(\n config: SessionKeyConfig,\n deps: SessionKeyDeps = {},\n): WriteAuth {\n const now = deps.now ?? Date.now;\n let cached: SessionFile | null = null;\n let forceReestablish = false;\n\n const ensure = async (): Promise<SessionFile> => {\n if (\n !forceReestablish &&\n cached !== null &&\n isSessionUsable(cached, config.signer.address, now(), config.scope, originOf(config.baseUrl))\n ) {\n return cached;\n }\n if (!forceReestablish) {\n const onDisk = await loadSessionFile(config.dataDir);\n const origin = originOf(config.baseUrl);\n if (\n onDisk !== null &&\n isSessionUsable(onDisk, config.signer.address, now(), config.scope, origin)\n ) {\n cached = onDisk;\n return cached;\n }\n }\n cached = await establishSession(config, deps);\n forceReestablish = false;\n return cached;\n };\n\n return {\n async headersFor(req) {\n const file = await ensure();\n return signWithSession(file, req, deps);\n },\n async recover(code) {\n const recovery = recoveryFor(code);\n if (recovery === 'fatal') return false;\n if (recovery === 'reestablish') {\n cached = null;\n forceReestablish = true;\n }\n // 'resign' needs no state change: the next headersFor mints a fresh\n // created/nonce over the same (still-valid) delegation.\n return true;\n },\n };\n}\n\n/**\n * The plain-SIWX fallback (no session): every write carries its own fresh\n * wallet-signed `SIGN-IN-WITH-X` header. Used when session establishment is\n * disabled; a burned/stale nonce (401) is recovered by re-signing.\n */\nexport function createSiwxAuth(config: SessionKeyConfig): WriteAuth {\n return {\n async headersFor() {\n const header = await buildSiwxHeader(config.signer, {\n baseUrl: config.baseUrl,\n chainId: config.chainId,\n });\n return { 'SIGN-IN-WITH-X': header };\n },\n async recover(code) {\n // A single-use nonce burns on every write; a stale/burned nonce (or an\n // expired proof) is recovered by re-signing with a fresh nonce + issuedAt.\n return code === 'nonce_already_used' || code === 'invalid_proof' || code === 'proof_expired';\n },\n };\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/lib/session-key.ts"],"sourcesContent":["import { webcrypto } from 'node:crypto';\nimport { sessionPath } from './paths';\nimport { writeFileAtomic } from './atomic-json';\nimport { buildSiwxHeader } from './siwx';\nimport { originOf } from './url';\nimport {\n isSessionUsable,\n loadSessionFile,\n signWithSession,\n type SessionFile,\n type SessionKeyDeps,\n type SessionScope,\n type SignableRequest,\n} from './session-present';\nimport type { TenjinSigner } from './wallet/provider';\n\n/**\n * Session-key delegation (RFC 9421 signed HTTP, RFC 9530-shaped Content-Digest),\n * verified byte-for-byte against the live \"Auth — session keys\" contract in\n * https://tenjin.blog/llms-full.txt (D35).\n *\n * The point: a plain SIWX write burns a single-use nonce, so every write needs a\n * fresh WALLET signature. A session key trades that for ONE wallet signature per\n * session: generate a P-256 keypair, wallet-sign a SIWX message binding its\n * pubkey/exp/scope, then sign each subsequent write with the P-256 key (no wallet\n * popup) until the delegation expires. The delegated key is short-lived (≤24h,\n * server-clamped) and cached 0600, address-bound so a wallet change invalidates it.\n *\n * This module is the MINT half — everything that needs a wallet signer, i.e.\n * `establishSession`, the cache writer, and the two `WriteAuth` implementations.\n * The present-only half (load a file, sign one request with it) lives in\n * `session-present.ts` and is re-exported below, so `posts-api`/`publish`/`edit`\n * keep importing one module while `read` can import the present half ALONE and\n * stay structurally unable to open a keystore. Do not move a signer-touching\n * function down into `session-present.ts`: read's import-graph pin is what makes\n * \"read cannot mint and cannot pay\" a property of the code rather than a promise.\n *\n * A minted delegation is a wallet-derived credential, so it is bound to the\n * ORIGIN it was minted against and every presenter re-checks that binding.\n *\n * Never hand-rolls crypto: P-256 keygen is node:crypto webcrypto (subtle) and the\n * wallet delegation reuses the siwx.ts seam.\n */\n\nexport {\n contentDigest,\n isSessionPresentable,\n readSessionFile,\n isSessionUsable,\n keyidFor,\n loadSessionFile,\n scopeSatisfies,\n signatureBase,\n signatureParams,\n signWithSession,\n targetUri,\n} from './session-present';\nexport type {\n SessionFile,\n SessionFileState,\n SessionKeyDeps,\n SessionScope,\n SignableRequest,\n SignatureParamsInput,\n} from './session-present';\n\n/**\n * The chain a session delegation is signed over. Writes require Base mainnet per\n * the server's SIWX chain constraint, and a session covers reads and writes\n * alike, so there is exactly ONE session chain id rather than a per-caller\n * choice: `session start` and the write path must mint against the same chain or\n * the file they share would flip between two delegations.\n */\nexport const SESSION_CHAIN_ID = 'eip155:8453';\n\nconst SESSION_TTL_MS = 24 * 60 * 60 * 1000; // 24h; the server clamps to ≤24h.\n\n/**\n * The write-auth seam a posts client signs through. `headersFor` attaches the\n * signature headers (establishing the session lazily on first use); `recover`\n * reacts to a 401 by returning whether a retry is worthwhile.\n */\nexport interface WriteAuth {\n headersFor(req: SignableRequest): Promise<Record<string, string>>;\n /** React to a write's 401 `code`; true ⇒ the next headersFor retry may succeed. */\n recover(code: string | undefined): Promise<boolean>;\n}\n\nexport interface SessionKeyConfig {\n signer: TenjinSigner;\n baseUrl: string;\n chainId: string;\n dataDir: string;\n /**\n * The scope this session is minted at, and the scope a cached session must\n * cover to be reused. Required, not defaulted: over-granting silently is the\n * failure mode worth making impossible, so every caller states what it needs.\n */\n scope: SessionScope;\n}\n\nconst subtle = webcrypto.subtle;\n\nfunction generateP256KeyPair(): Promise<webcrypto.CryptoKeyPair> {\n return subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, true, [\n 'sign',\n 'verify',\n ]) as Promise<webcrypto.CryptoKeyPair>;\n}\n\n/** base64url (no padding) of raw bytes — the pubkey/keyid encoding. */\nfunction toBase64Url(bytes: Uint8Array): string {\n return Buffer.from(bytes).toString('base64url');\n}\n\n/** The three URNs bound into the delegation's SIWX `resources` array (D35). */\nexport function delegationResources(\n publicKeyRaw: string,\n expIso: string,\n scope: SessionScope,\n): string[] {\n return [\n `urn:tenjin:session:pubkey:p256:${publicKeyRaw}`,\n `urn:tenjin:session:exp:${expIso}`,\n `urn:tenjin:session:scope:${scope}`,\n ];\n}\n\n/**\n * Establish a session with ONE wallet signature: generate a P-256 keypair, bind\n * its pubkey/exp/scope into a SIWX message, wallet-sign it, and cache the result\n * 0600 address-bound. The returned file's `delegation` is the constant\n * `Tenjin-Session-Delegation` header for the session's life.\n */\nexport async function establishSession(\n config: SessionKeyConfig,\n deps: SessionKeyDeps = {},\n): Promise<SessionFile> {\n const now = deps.now ?? Date.now;\n const pair = await generateP256KeyPair();\n const rawPub = new Uint8Array(await subtle.exportKey('raw', pair.publicKey));\n const publicKeyRaw = toBase64Url(rawPub);\n const jwk = (await subtle.exportKey('jwk', pair.privateKey)) as SessionFile['privateKeyJwk'];\n\n const expIso = new Date(now() + SESSION_TTL_MS).toISOString();\n const delegation = await buildSiwxHeader(config.signer, {\n baseUrl: config.baseUrl,\n chainId: config.chainId,\n ttlMs: SESSION_TTL_MS,\n statement: 'Delegate a Tenjin session key.',\n resources: delegationResources(publicKeyRaw, expIso, config.scope),\n });\n\n const file: SessionFile = {\n address: config.signer.address.toLowerCase(),\n origin: originOf(config.baseUrl),\n delegation,\n exp: expIso,\n scope: config.scope,\n publicKeyRaw,\n privateKeyJwk: jwk,\n };\n await saveSessionFile(config.dataDir, file);\n return file;\n}\n\n// ---------------------------------------------------------------------------\n// Cache writes (0600, address-bound). The reader lives in session-present.\n// ---------------------------------------------------------------------------\n\nexport async function saveSessionFile(dir: string, file: SessionFile): Promise<void> {\n await writeFileAtomic(sessionPath(dir), `${JSON.stringify(file, null, 2)}\\n`, {\n mode: 0o600,\n dirMode: 0o700,\n });\n}\n\n// ---------------------------------------------------------------------------\n// The WriteAuth implementation: lazy establish, cache reuse, 401 recovery.\n// ---------------------------------------------------------------------------\n\n/** How each 401 `code` maps to recovery (per the llms-full.txt policy section). */\ntype Recovery = 'resign' | 'reestablish' | 'fatal';\n\nexport function recoveryFor(code: string | undefined): Recovery {\n switch (code) {\n case 'proof_expired':\n // The per-request signature is too old; just re-sign (no wallet).\n return 'resign';\n case 'session_expired':\n case 'proof_revoked':\n case 'insufficient_scope':\n // The delegation itself is gone/insufficient; re-establish (one wallet sig).\n return 'reestablish';\n case 'session_key_unbound':\n // keyid ≠ the delegation-bound key: retrying cannot fix it.\n return 'fatal';\n default:\n return 'fatal';\n }\n}\n\n/**\n * A session-key WriteAuth: mints (or loads) the delegation on first use and signs\n * every write with the P-256 key — so a returning agent never wallet-signs again\n * until the session expires. On a 401 it re-signs or re-establishes per the code.\n */\nexport function createSessionKeyAuth(\n config: SessionKeyConfig,\n deps: SessionKeyDeps = {},\n): WriteAuth {\n const now = deps.now ?? Date.now;\n let cached: SessionFile | null = null;\n let forceReestablish = false;\n\n const ensure = async (): Promise<SessionFile> => {\n if (\n !forceReestablish &&\n cached !== null &&\n isSessionUsable(cached, config.signer.address, now(), config.scope, originOf(config.baseUrl))\n ) {\n return cached;\n }\n if (!forceReestablish) {\n const onDisk = await loadSessionFile(config.dataDir);\n const origin = originOf(config.baseUrl);\n if (\n onDisk !== null &&\n isSessionUsable(onDisk, config.signer.address, now(), config.scope, origin)\n ) {\n cached = onDisk;\n return cached;\n }\n }\n cached = await establishSession(config, deps);\n forceReestablish = false;\n return cached;\n };\n\n return {\n async headersFor(req) {\n const file = await ensure();\n return signWithSession(file, req, deps);\n },\n async recover(code) {\n const recovery = recoveryFor(code);\n if (recovery === 'fatal') return false;\n if (recovery === 'reestablish') {\n cached = null;\n forceReestablish = true;\n }\n // 'resign' needs no state change: the next headersFor mints a fresh\n // created/nonce over the same (still-valid) delegation.\n return true;\n },\n };\n}\n\n/**\n * The plain-SIWX fallback (no session): every write carries its own fresh\n * wallet-signed `SIGN-IN-WITH-X` header. Used when session establishment is\n * disabled; a burned/stale nonce (401) is recovered by re-signing.\n */\nexport function createSiwxAuth(config: SessionKeyConfig): WriteAuth {\n return {\n async headersFor() {\n const header = await buildSiwxHeader(config.signer, {\n baseUrl: config.baseUrl,\n chainId: config.chainId,\n });\n return { 'SIGN-IN-WITH-X': header };\n },\n async recover(code) {\n // A single-use nonce burns on every write; a stale/burned nonce (or an\n // expired proof) is recovered by re-signing with a fresh nonce + issuedAt.\n return code === 'nonce_already_used' || code === 'invalid_proof' || code === 'proof_expired';\n },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA,SAAS,iBAAiB;AAyEnB,IAAM,mBAAmB;AAEhC,IAAM,iBAAiB,KAAK,KAAK,KAAK;AA0BtC,IAAM,SAAS,UAAU;AAEzB,SAAS,sBAAwD;AAC/D,SAAO,OAAO,YAAY,EAAE,MAAM,SAAS,YAAY,QAAQ,GAAG,MAAM;AAAA,IACtE;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAGA,SAAS,YAAY,OAA2B;AAC9C,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS,WAAW;AAChD;AAGO,SAAS,oBACd,cACA,QACA,OACU;AACV,SAAO;AAAA,IACL,kCAAkC,YAAY;AAAA,IAC9C,0BAA0B,MAAM;AAAA,IAChC,4BAA4B,KAAK;AAAA,EACnC;AACF;AAQA,eAAsB,iBACpB,QACA,OAAuB,CAAC,GACF;AACtB,QAAM,MAAM,KAAK,OAAO,KAAK;AAC7B,QAAM,OAAO,MAAM,oBAAoB;AACvC,QAAM,SAAS,IAAI,WAAW,MAAM,OAAO,UAAU,OAAO,KAAK,SAAS,CAAC;AAC3E,QAAM,eAAe,YAAY,MAAM;AACvC,QAAM,MAAO,MAAM,OAAO,UAAU,OAAO,KAAK,UAAU;AAE1D,QAAM,SAAS,IAAI,KAAK,IAAI,IAAI,cAAc,EAAE,YAAY;AAC5D,QAAM,aAAa,MAAM,gBAAgB,OAAO,QAAQ;AAAA,IACtD,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,IAChB,OAAO;AAAA,IACP,WAAW;AAAA,IACX,WAAW,oBAAoB,cAAc,QAAQ,OAAO,KAAK;AAAA,EACnE,CAAC;AAED,QAAM,OAAoB;AAAA,IACxB,SAAS,OAAO,OAAO,QAAQ,YAAY;AAAA,IAC3C,QAAQ,SAAS,OAAO,OAAO;AAAA,IAC/B;AAAA,IACA,KAAK;AAAA,IACL,OAAO,OAAO;AAAA,IACd;AAAA,IACA,eAAe;AAAA,EACjB;AACA,QAAM,gBAAgB,OAAO,SAAS,IAAI;AAC1C,SAAO;AACT;AAMA,eAAsB,gBAAgB,KAAa,MAAkC;AACnF,QAAM,gBAAgB,YAAY,GAAG,GAAG,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,GAAM;AAAA,IAC5E,MAAM;AAAA,IACN,SAAS;AAAA,EACX,CAAC;AACH;AASO,SAAS,YAAY,MAAoC;AAC9D,UAAQ,MAAM;AAAA,IACZ,KAAK;AAEH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAEH,aAAO;AAAA,IACT,KAAK;AAEH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAOO,SAAS,qBACd,QACA,OAAuB,CAAC,GACb;AACX,QAAM,MAAM,KAAK,OAAO,KAAK;AAC7B,MAAI,SAA6B;AACjC,MAAI,mBAAmB;AAEvB,QAAM,SAAS,YAAkC;AAC/C,QACE,CAAC,oBACD,WAAW,QACX,gBAAgB,QAAQ,OAAO,OAAO,SAAS,IAAI,GAAG,OAAO,OAAO,SAAS,OAAO,OAAO,CAAC,GAC5F;AACA,aAAO;AAAA,IACT;AACA,QAAI,CAAC,kBAAkB;AACrB,YAAM,SAAS,MAAM,gBAAgB,OAAO,OAAO;AACnD,YAAM,SAAS,SAAS,OAAO,OAAO;AACtC,UACE,WAAW,QACX,gBAAgB,QAAQ,OAAO,OAAO,SAAS,IAAI,GAAG,OAAO,OAAO,MAAM,GAC1E;AACA,iBAAS;AACT,eAAO;AAAA,MACT;AAAA,IACF;AACA,aAAS,MAAM,iBAAiB,QAAQ,IAAI;AAC5C,uBAAmB;AACnB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,WAAW,KAAK;AACpB,YAAM,OAAO,MAAM,OAAO;AAC1B,aAAO,gBAAgB,MAAM,KAAK,IAAI;AAAA,IACxC;AAAA,IACA,MAAM,QAAQ,MAAM;AAClB,YAAM,WAAW,YAAY,IAAI;AACjC,UAAI,aAAa,QAAS,QAAO;AACjC,UAAI,aAAa,eAAe;AAC9B,iBAAS;AACT,2BAAmB;AAAA,MACrB;AAGA,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAOO,SAAS,eAAe,QAAqC;AAClE,SAAO;AAAA,IACL,MAAM,aAAa;AACjB,YAAM,SAAS,MAAM,gBAAgB,OAAO,QAAQ;AAAA,QAClD,SAAS,OAAO;AAAA,QAChB,SAAS,OAAO;AAAA,MAClB,CAAC;AACD,aAAO,EAAE,kBAAkB,OAAO;AAAA,IACpC;AAAA,IACA,MAAM,QAAQ,MAAM;AAGlB,aAAO,SAAS,wBAAwB,SAAS,mBAAmB,SAAS;AAAA,IAC/E;AAAA,EACF;AACF;","names":[]}
@@ -1,13 +1,14 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
2
  import {
3
3
  HOSTED_SKILL_NAME,
4
+ PRODUCTION_HOST,
4
5
  readSkillFile
5
- } from "./chunk-OC3EIDCP.js";
6
+ } from "./chunk-2MYQN7HM.js";
6
7
  import {
7
8
  CliError,
8
9
  hasCode,
9
10
  writeFileAtomic
10
- } from "./chunk-PAOVPSP6.js";
11
+ } from "./chunk-ZFJJ3EXC.js";
11
12
 
12
13
  // src/lib/skill-writer.ts
13
14
  import { existsSync } from "fs";
@@ -18,6 +19,9 @@ async function installSkill(srcDir, destDir, dryRun, name, opts = {}) {
18
19
  if (src === null) {
19
20
  throw new CliError("INTERNAL", `Packaged skill source ${srcDir} is empty`);
20
21
  }
22
+ if (opts.materialize !== void 0) {
23
+ for (const [rel, content] of src) src.set(rel, opts.materialize(rel, content));
24
+ }
21
25
  const writeTo = /* @__PURE__ */ new Map();
22
26
  await assertReachable(destDir, name);
23
27
  await assertNoCaseCollision(destDir, name);
@@ -66,7 +70,7 @@ async function installSkill(srcDir, destDir, dryRun, name, opts = {}) {
66
70
  // differing local copy is a replacement, not the drift warning the CLI skills
67
71
  // get. Neither side carries a version or date, so the wording claims no
68
72
  // direction: the local file may well be a newer fetch than this package's copy.
69
- warning: name === HOSTED_SKILL_NAME ? `${destDir}: the hosted Tenjin skill differed and ${dryRun ? "would be" : "was"} replaced by this package's mirror of tenjin.blog/skills.md, which may be older; it stays as the zero-install fallback. Re-fetch it from tenjin.blog/skills.md if you need the current one.` : `${destDir}: local edits to ${name}'s SKILL.md ${dryRun ? "would be" : "were"} overwritten (the packaged copy is canonical).`
73
+ warning: name === HOSTED_SKILL_NAME ? `${destDir}: the hosted Tenjin skill differed and ${dryRun ? "would be" : "was"} replaced by this package's mirror of ${PRODUCTION_HOST}/skills.md, which may be older; it stays as the zero-install fallback. Re-fetch it from ${PRODUCTION_HOST}/skills.md if you need the current one.` : `${destDir}: local edits to ${name}'s SKILL.md ${dryRun ? "would be" : "were"} overwritten (the packaged copy is canonical).`
70
74
  };
71
75
  }
72
76
  async function readShippedFile(path, name, destDir) {
@@ -147,4 +151,4 @@ export {
147
151
  installSkill,
148
152
  resolveThroughLink
149
153
  };
150
- //# sourceMappingURL=chunk-WVHPGQH5.js.map
154
+ //# sourceMappingURL=chunk-QZ6ROAJU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/skill-writer.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { lstat, readFile, readdir, realpath, stat } from 'node:fs/promises';\nimport { dirname, join, relative } from 'node:path';\nimport { writeFileAtomic } from './atomic-json';\nimport { hasCode } from './errno';\nimport { CliError } from './errors';\nimport { PRODUCTION_HOST } from './production-origin';\nimport { HOSTED_SKILL_NAME, readSkillFile } from './skill-wiring';\n\n/**\n * Writing one packaged skill into one harness directory, and the path guards that\n * write needs. Its own module, free of the command layer's dependencies, because\n * `install` and the post-command self-heal both write skills and the heal runs on\n * every command: reaching into commands/install would parse the wallet's viem\n * chunk on a `tenjin config`.\n */\n\nexport type SkillInstallStatus =\n 'installed' | 'updated' | 'up-to-date' | 'would-install' | 'would-update';\n\nexport interface SkillInstallResult {\n status: SkillInstallStatus;\n warning?: string;\n /** Was a real copy (a SKILL.md, not just the directory) already on disk before this run? */\n preexisting: boolean;\n}\n\nexport interface SkillWriteOptions {\n /**\n * Write THROUGH a symlinked destination (default), or replace it. `install`\n * follows the link, because the operator pointed it somewhere on purpose. The\n * unattended self-heal does not, and passes false: it has already refused every\n * link it could see, and this closes the gap between that look and this write,\n * where a link appearing in between would otherwise be followed. `rename` never\n * follows its final component, so the worst a race can now do is leave our\n * regular file where the new link was.\n */\n followSymlinks?: boolean;\n /**\n * Shape a packaged file before it is compared and written (config-conditional\n * skill content; see lib/skill-materialize). Applied to the SOURCE side only,\n * before the on-disk compare, so \"up-to-date\" means \"matches what this config\n * state would write\" and a config change makes the same source differ again. A\n * transform that throws aborts the whole install of this skill: a half-shaped\n * skill must never be written.\n */\n materialize?: (rel: string, content: Buffer) => Buffer;\n}\n\nexport async function installSkill(\n srcDir: string,\n destDir: string,\n dryRun: boolean,\n name: string,\n opts: SkillWriteOptions = {},\n): Promise<SkillInstallResult> {\n const src = await readTree(srcDir);\n if (src === null) {\n // assertSkillsSource already guards SKILL.md; this is defensive for an empty dir.\n throw new CliError('INTERNAL', `Packaged skill source ${srcDir} is empty`);\n }\n if (opts.materialize !== undefined) {\n for (const [rel, content] of src) src.set(rel, opts.materialize(rel, content));\n }\n\n // Only the files this package SHIPS are read and written. Everything else in the\n // directory belongs to the operator: never inspected, listed, or removed. That is\n // what package managers do (npm, dpkg, Homebrew all own their files, not the\n // directory), and wholesale replacement was the single cause behind a run of\n // data-loss, symlink and enumeration bugs.\n //\n // Resolved on BOTH paths, dry run included, so a dry run cannot promise a write\n // the real run refuses.\n const writeTo = new Map<string, string>();\n await assertReachable(destDir, name);\n await assertNoCaseCollision(destDir, name);\n for (const rel of src.keys()) {\n const declared = join(destDir, rel);\n writeTo.set(\n rel,\n opts.followSymlinks === false ? declared : await resolveThroughLink(declared, name),\n );\n }\n\n let differs = false;\n let preexisting = false;\n for (const [rel, content] of src) {\n const current = await readShippedFile(writeTo.get(rel)!, name, destDir);\n if (rel === 'SKILL.md') preexisting = current !== null;\n if (current === null || !current.equals(content)) differs = true;\n }\n const change = !preexisting ? 'create' : differs ? 'update' : 'none';\n\n if (!dryRun && change !== 'none') {\n for (const [rel, content] of src) {\n const target = writeTo.get(rel)!;\n try {\n // An existing file keeps the mode it has. A skill an operator (or their\n // dotfiles) made group-readable or read-only is theirs to have set that\n // way, and an update is no reason to hand it back at the default 0644.\n const current = await stat(target).catch(() => null);\n await writeFileAtomic(\n target,\n content,\n current === null ? {} : { mode: current.mode & 0o777 },\n );\n } catch (err) {\n // Culprit is derived from the file that FAILED, not assumed to be the\n // skills root: an existing skill directory that refuses the temp file is\n // itself the thing to chmod, and a symlinked SKILL.md fails in the link's\n // TARGET directory, which no path under destDir names.\n throw wrapWriteError(\n err,\n destDir,\n `the ${name} skill`,\n await deepestExisting(dirname(target)),\n { expected: ': a skill is a directory holding SKILL.md' },\n );\n }\n }\n }\n\n if (change === 'create') return { status: dryRun ? 'would-install' : 'installed', preexisting };\n if (change === 'none') return { status: 'up-to-date', preexisting };\n return {\n status: dryRun ? 'would-update' : 'updated',\n preexisting,\n // The hosted skill is a MIRROR of tenjin.blog/skills.md (roadmap G4), so a\n // differing local copy is a replacement, not the drift warning the CLI skills\n // get. Neither side carries a version or date, so the wording claims no\n // direction: the local file may well be a newer fetch than this package's copy.\n warning:\n name === HOSTED_SKILL_NAME\n ? `${destDir}: the hosted Tenjin skill differed and ${dryRun ? 'would be' : 'was'} replaced by this package's mirror of ${PRODUCTION_HOST}/skills.md, which may be older; it stays as the zero-install fallback. Re-fetch it from ${PRODUCTION_HOST}/skills.md if you need the current one.`\n : `${destDir}: local edits to ${name}'s SKILL.md ${dryRun ? 'would be' : 'were'} overwritten (the packaged copy is canonical).`,\n };\n}\n\n/**\n * Read a shipped file, or null when it is not there.\n *\n * The node-type guard lives in `readSkillFile`, shared with the wiring check and\n * the staleness check, because all three read the same operator-controlled paths\n * and a pipe at one of them used to hang whichever command got there first.\n */\nasync function readShippedFile(\n path: string,\n name: string,\n destDir: string,\n): Promise<Buffer | null> {\n const read = await readSkillFile(path);\n if (read.kind === 'absent') return null;\n if (read.kind === 'ok') return read.bytes;\n if (read.kind === 'not-regular') {\n throw new CliError('INTERNAL', `${path} is not a regular file, so ${name} was not written.`, {\n fix: `A skill file must be a regular file. Check what is there (\\`ls -l ${path}\\`) and remove or replace it, then re-run \\`tenjin install\\`.`,\n });\n }\n // Names the FILE, not its directory: this is a read failure, and pointing at a\n // perfectly writable parent is what sent operators to chmod the wrong thing.\n throw wrapWriteError(read.err, destDir, `the ${name} skill`, path, { verb: 'read' });\n}\n\n/**\n * A destination the operator manages through a symlink is written THROUGH it, so\n * their link survives and their target is what actually changes. Same call the\n * settings.json writer makes, and the same reason: committing with `rename` over a\n * link would replace it with a regular file and strand the target.\n */\nexport async function resolveThroughLink(path: string, name: string): Promise<string> {\n const entry = await lstat(path).catch(() => null);\n if (entry === null || !entry.isSymbolicLink()) return path;\n const target = await realpath(path).catch(() => null);\n if (target !== null) return target;\n throw new CliError('INTERNAL', `${path} is a broken symlink, so ${name} was not written.`, {\n fix: `Point it at a path that exists, or remove it (\\`ls -ld ${path}\\`), then re-run \\`tenjin install\\`.`,\n });\n}\n\n/**\n * On a case-insensitive filesystem (the macOS default), a user directory named a\n * case variant of a shipped skill ALIASES the skill's path, so the write would\n * replace the user's own SKILL.md under a warning naming a path that is not on\n * disk. Detected by the alias itself: the destination resolves but the parent\n * lists only a differently-cased entry, which also means a case-SENSITIVE\n * filesystem (where both names can coexist) never trips this. Dry runs too.\n */\nasync function assertNoCaseCollision(destDir: string, name: string): Promise<void> {\n if (!existsSync(destDir)) return;\n const entries = await readdir(dirname(destDir)).catch(() => null);\n if (entries === null || entries.includes(name)) return;\n const variant = entries.find((e) => e.toLowerCase() === name.toLowerCase());\n if (variant === undefined) return;\n const actual = join(dirname(destDir), variant);\n throw new CliError(\n 'INTERNAL',\n `${actual} is a case variant of the ${name} skill and this filesystem treats them as the same directory, so ${name} was not written.`,\n {\n fix: `Rename or remove ${actual}, then re-run \\`tenjin install\\`.`,\n },\n );\n}\n\n/**\n * Fail a destination directory that is a BROKEN SYMLINK, on dry runs too, so a dry\n * run cannot report `would-install` where the real run cannot write. It checks only\n * that: an unwritable but real directory passes here and fails at the write, with\n * the permission-denied error.\n */\nasync function assertReachable(destDir: string, name: string): Promise<void> {\n const entry = await lstat(destDir).catch(() => null);\n if (entry?.isSymbolicLink() !== true) return;\n if ((await realpath(destDir).catch(() => null)) !== null) return;\n throw new CliError('INTERNAL', `${destDir} is a broken symlink, so ${name} was not written.`, {\n fix: `Point it at a directory that exists, or remove it (\\`ls -ld ${destDir}\\`), then re-run \\`tenjin install\\`.`,\n });\n}\n\n/**\n * The directory a denied WRITE should point the operator at: the deepest existing\n * ancestor of the failed target's directory, RESOLVED. An existing skill directory\n * that refuses the temp file names itself; a directory that could not be created\n * names the ancestor that refused to create it, because `ls -ld` on a path that is\n * not there says nothing. Resolved because a destination managed through a symlink\n * denies the write in the link's TARGET, and telling the operator to chmod the\n * link's path leaves them staring at a healthy link.\n */\nexport async function deepestExisting(dir: string): Promise<string> {\n for (let cur = dir; ; cur = dirname(cur)) {\n if (existsSync(cur)) return realpath(cur).catch(() => cur);\n if (dirname(cur) === cur) return cur;\n }\n}\n\n/** A raw errno under INTERNAL reads as a CLI bug and carries no fix. */\nexport function wrapWriteError(\n err: unknown,\n /** The destination as the operator knows it (the declared path, pre-resolution). */\n dest: string,\n /** What could not be written, e.g. `the tenjin-search skill` or `the Tenjin pointer`. */\n subject: string,\n /**\n * The path to point the operator at. A READ failure names the file itself, which\n * is the thing whose mode is wrong. A WRITE failure names the deepest existing\n * directory on the failed target's resolved path.\n */\n culprit: string,\n opts: {\n /** Which side failed; a read error reported as \"could not write\" misleads. */\n verb?: 'read' | 'write';\n /** Sentence tail for the wrong-kind fix, telling the operator the expected shape. */\n expected?: string;\n } = {},\n): unknown {\n const verb = opts.verb ?? 'write';\n const denied = hasCode(err, 'EACCES') || hasCode(err, 'EPERM');\n const missing = hasCode(err, 'ENOENT');\n // A skills directory that resolves to a regular file, or a SKILL.md that resolves\n // to a directory. Pathological, but a raw ENOTDIR/EISDIR says nothing about which\n // path is the wrong kind of thing.\n const wrongKind = hasCode(err, 'ENOTDIR') || hasCode(err, 'EISDIR');\n if (!denied && !missing && !wrongKind) return err;\n const fix = denied\n ? `Permission denied on ${culprit}. Check it (\\`ls -ld ${culprit}\\`), then re-run \\`tenjin install\\`.`\n : wrongKind\n ? `${dest} (or a path inside it) is not the kind of thing it needs to be${opts.expected ?? ''}. Check it (\\`ls -ld ${dest}\\`), then re-run \\`tenjin install\\`.`\n : `${dest} could not be created; if it is a symlink, check that its target exists (\\`ls -ld ${dest}\\`), then re-run \\`tenjin install\\`.`;\n return new CliError(\n 'INTERNAL',\n `Could not ${verb} ${subject} ${verb === 'read' ? 'at' : 'to'} ${dest}.`,\n { fix, cause: err },\n );\n}\n\n/**\n * Read a directory tree into a rel-path -> content map, or null when it does not\n * exist. Reads as raw `Buffer`, not `utf8`: today's skills are markdown-only, but\n * this is a general recursive dir-copy, and decoding to a string here would\n * silently corrupt a future non-text asset (an image, a font) on write, or worse,\n * make two different corrupted binaries both decode to U+FFFD and compare equal.\n */\nasync function readTree(dir: string): Promise<Map<string, Buffer> | null> {\n if (!existsSync(dir)) return null;\n const entries = await readdir(dir, { recursive: true, withFileTypes: true });\n const files = new Map<string, Buffer>();\n for (const entry of entries) {\n if (!entry.isFile()) continue;\n const full = join(entry.parentPath, entry.name);\n files.set(relative(dir, full), await readFile(full));\n }\n return files;\n}\n"],"mappings":"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","names":[]}
@@ -1,43 +1,52 @@
1
1
  import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
2
- import {
3
- permissionsPointer,
4
- recommendedPermissions
5
- } from "./chunk-OXUJ3FXU.js";
6
2
  import {
7
3
  isSessionPresentable,
8
4
  readSessionFile,
9
5
  scopeSatisfies
10
- } from "./chunk-J6FUAIRR.js";
11
- import {
12
- fetchJson
13
- } from "./chunk-SPUORKD7.js";
6
+ } from "./chunk-HRGBS2PA.js";
14
7
  import {
15
8
  trimSlash,
16
9
  tryOriginOf
17
- } from "./chunk-XGZ5EVMB.js";
10
+ } from "./chunk-EDZSNPE5.js";
11
+ import {
12
+ fetchJson
13
+ } from "./chunk-5QQTYWEU.js";
18
14
  import {
19
15
  walletFileExists
20
- } from "./chunk-3P3ES4XU.js";
16
+ } from "./chunk-GHLVXVZD.js";
21
17
  import {
22
18
  sanitizeForTerminal
23
- } from "./chunk-B676GPS2.js";
19
+ } from "./chunk-OLWTRUTS.js";
20
+ import {
21
+ modeGatedPointer,
22
+ permissionsPointer,
23
+ recommendedPermissions
24
+ } from "./chunk-4CQIDQOT.js";
25
+ import {
26
+ loadProjectConfig
27
+ } from "./chunk-VYOJOX4Z.js";
24
28
  import {
25
29
  toMoney
26
- } from "./chunk-736DW4V3.js";
30
+ } from "./chunk-EFWZPUTC.js";
27
31
  import {
28
32
  loadRawConfig,
29
33
  resolveSettings
30
- } from "./chunk-ELVDOTU7.js";
34
+ } from "./chunk-U6VPKMGC.js";
31
35
  import {
32
- configPath,
33
- sessionPath
34
- } from "./chunk-ZQIQ55KK.js";
36
+ MODE_GATED_RULES,
37
+ inspectFreeVerbRules,
38
+ readHermesIntegrationStatus,
39
+ resolveHermesHomeLenient
40
+ } from "./chunk-OKYSNAS3.js";
35
41
  import {
36
42
  CLI_SKILL_NAMES,
37
43
  HOSTED_SKILL_NAME,
44
+ OPTIONAL_PAY_SKILL,
45
+ OPTIONAL_SKILL_NAMES,
38
46
  anyTenjinSkill,
39
47
  cliSkillsWired,
40
48
  detectHarnesses,
49
+ harnessDetectedBy,
41
50
  harnessFlagFor,
42
51
  harnessInPlay,
43
52
  harnessReads,
@@ -48,10 +57,12 @@ import {
48
57
  readSkillFile,
49
58
  resolveSkillsSource,
50
59
  shadowedCliSkills
51
- } from "./chunk-OC3EIDCP.js";
60
+ } from "./chunk-2MYQN7HM.js";
52
61
  import {
53
- CliError
54
- } from "./chunk-PAOVPSP6.js";
62
+ CliError,
63
+ configPath,
64
+ sessionPath
65
+ } from "./chunk-ZFJJ3EXC.js";
55
66
 
56
67
  // src/commands/doctor.ts
57
68
  import { styleText } from "util";
@@ -65,8 +76,19 @@ var FIX_CHECK_NETWORK_AND_BASE_URL = "Check your network connection and the conf
65
76
  async function collectDoctorChecks(ctx, deps = {}) {
66
77
  const env = deps.env ?? process.env;
67
78
  const { config, check: configCheck } = await loadConfigForDoctor(ctx.dataDir);
68
- const settings = resolveSettings({ config, flags: { baseUrl: ctx.flags.baseUrl }, env });
79
+ const project = await loadProjectConfig(deps.cwd ?? process.cwd()).catch(() => null);
80
+ const settings = resolveSettings({
81
+ config,
82
+ flags: { baseUrl: ctx.flags.baseUrl },
83
+ env,
84
+ project: project?.layer
85
+ });
69
86
  const baseUrl = settings.baseUrl.value;
87
+ const home = deps.homeDir ?? homedir();
88
+ const which = deps.which ?? ((bin) => onPath(bin, env));
89
+ const requested = config.install?.harness ?? [];
90
+ const hermesTarget = deps.hermesHome === void 0 ? resolveHermesHomeLenient(home, env) : { home: deps.hermesHome, warning: void 0 };
91
+ const hermesHome = hermesTarget.home;
70
92
  const built = [
71
93
  checkNode(),
72
94
  configCheck,
@@ -74,33 +96,62 @@ async function collectDoctorChecks(ctx, deps = {}) {
74
96
  await checkReadPath(baseUrl, ctx.flags.timeout, deps.fetchImpl),
75
97
  await checkSearchContract(baseUrl, ctx.flags.timeout, deps.fetchImpl),
76
98
  await checkSkills(
77
- deps.homeDir ?? homedir(),
78
- deps.which ?? ((bin) => onPath(bin, env)),
79
- config.install?.harness ?? [],
80
- deps.skillsSourceDir
99
+ home,
100
+ which,
101
+ requested,
102
+ settings.bazaarPay.value,
103
+ deps.skillsSourceDir,
104
+ hermesHome
81
105
  ),
82
106
  await checkSession(ctx.dataDir, deps.now ?? Date.now, tryOriginOf(baseUrl))
83
107
  ];
108
+ const hermes = await checkHermes({
109
+ home,
110
+ hermesHome,
111
+ which,
112
+ requested,
113
+ webSearch: config.hooks?.webSearch ?? config.hooks?.searchMode,
114
+ homeWarning: hermesTarget.warning
115
+ });
116
+ if (hermes !== null) built.push(hermes);
84
117
  for (const result of await checkWallet(ctx, deps, env, settings.rpcUrl.value)) {
85
118
  built.push({ result });
86
119
  }
87
120
  const checks = built.map((b) => b.result);
121
+ const publishMode = settings.publishMode.value;
122
+ const probe = await inspectFreeVerbRules(deps.homeDir ?? homedir(), publishMode);
123
+ const gated = new Set(MODE_GATED_RULES);
124
+ const missingModeGated = (probe.pending ?? []).filter((r) => gated.has(r));
88
125
  const firstFail = built.find((b) => b.result.required && b.result.status === "fail");
89
- if (firstFail === void 0) return { checks };
90
- return { checks, failure: { code: firstFail.failCode ?? "INTERNAL", result: firstFail.result } };
126
+ if (firstFail === void 0) return { checks, publishMode, missingModeGated };
127
+ return {
128
+ checks,
129
+ publishMode,
130
+ missingModeGated,
131
+ failure: { code: firstFail.failCode ?? "INTERNAL", result: firstFail.result }
132
+ };
91
133
  }
92
134
  async function runDoctor(ctx, deps = {}) {
93
- const { checks, failure } = await collectDoctorChecks(ctx, deps);
135
+ const { checks, failure, publishMode, missingModeGated } = await collectDoctorChecks(ctx, deps);
94
136
  if (failure !== void 0) {
95
137
  const r = failure.result;
96
138
  throw new CliError(failure.code, r.detail, {
97
139
  ...r.fix !== void 0 ? { fix: r.fix } : {},
98
- details: { checks, permissions: recommendedPermissions() }
140
+ details: { checks, permissions: recommendedPermissions(publishMode) }
99
141
  });
100
142
  }
143
+ const env = deps.env ?? process.env;
144
+ const fromEnv = env.TENJIN_PUBLISH_MODE !== void 0 && env.TENJIN_PUBLISH_MODE.length > 0;
145
+ const modeLine = fromEnv ? `TENJIN_PUBLISH_MODE=${publishMode} is overriding your configured publish mode for this run only; the harness rules it needs are ${missingModeGated.join(" and ")}.` : modeGatedPointer(publishMode, missingModeGated, "tenjin install");
146
+ const showModeLine = fromEnv ? missingModeGated.length > 0 : modeLine !== null;
101
147
  return {
102
- data: { status: "pass", checks, permissions: recommendedPermissions() },
103
- humanLines: [...renderDoctorHuman(ctx.io, checks), "", permissionsPointer()]
148
+ data: { status: "pass", checks, permissions: recommendedPermissions(publishMode) },
149
+ humanLines: [
150
+ ...renderDoctorHuman(ctx.io, checks),
151
+ "",
152
+ ...showModeLine && modeLine !== null ? [modeLine] : [],
153
+ permissionsPointer()
154
+ ]
104
155
  };
105
156
  }
106
157
  function checkNode() {
@@ -207,42 +258,43 @@ async function checkSearchContract(baseUrl, timeoutMs, fetchImpl) {
207
258
  name: "search-contract",
208
259
  status: "warn",
209
260
  required: false,
210
- detail: "This deployment does not advertise POST /api/agent/search (A2 not deployed)",
211
- fix: "search/buy need A2 deployed; point the configured base URL at a deploy that has it (`tenjin config set baseUrl <url>`)."
261
+ detail: "This deployment does not advertise POST /api/search (it predates search v3)",
262
+ fix: "search/buy need search v3 deployed; point the configured base URL at a deploy that has it (`tenjin config set baseUrl <url>`)."
212
263
  }
213
264
  };
214
265
  }
215
266
  function hasSearchPath(json) {
216
267
  if (!isRecord(json)) return false;
217
268
  const paths = json.paths;
218
- return isRecord(paths) && "/api/agent/search" in paths;
269
+ return isRecord(paths) && "/api/search" in paths;
219
270
  }
220
- async function checkSkills(home, which, requested, skillsSourceDir) {
221
- const present = detectHarnesses(home, which);
222
- const wiring = await readAllWiring(home);
271
+ async function checkSkills(home, which, requested, bazaarPay, skillsSourceDir, hermesHome) {
272
+ const resolvedHermesHome = hermesHome;
273
+ const present = detectHarnesses(home, which, resolvedHermesHome);
274
+ const wiring = await readAllWiring(home, resolvedHermesHome);
223
275
  const data = {
224
276
  directories: wiring.map((w) => ({
225
277
  ...w,
226
- harnessPresent: harnessReads(home, w.dir, present),
227
- requested: harnessRequested(home, w.dir, requested)
278
+ harnessPresent: harnessReads(home, w.dir, present, resolvedHermesHome),
279
+ requested: harnessRequested(home, w.dir, requested, resolvedHermesHome)
228
280
  }))
229
281
  };
230
282
  const inPlay = wiring.filter((w) => anyTenjinSkill(w));
231
283
  if (inPlay.length === 0) {
232
- const targeted = requested.length > 0 ? wiring.filter((w) => harnessInPlay(home, w.dir, present, requested)) : [];
284
+ const targeted = requested.length > 0 ? wiring.filter((w) => harnessInPlay(home, w.dir, present, requested, resolvedHermesHome)) : [];
233
285
  return {
234
286
  result: {
235
287
  name: "skills",
236
288
  status: "warn",
237
289
  required: false,
238
- detail: `No Tenjin skills wired under ${home} (looked in .claude/skills and .agents/skills)`,
239
- fix: targeted.length > 0 ? fixFor(home, targeted) : "tenjin install",
290
+ detail: `No Tenjin skills wired under ${home} (looked in .claude/skills, .agents/skills, and Hermes skills)`,
291
+ fix: targeted.length > 0 ? fixFor(home, targeted, resolvedHermesHome) : "tenjin install",
240
292
  data
241
293
  }
242
294
  };
243
295
  }
244
296
  const broken = wiring.filter(
245
- (w) => harnessInPlay(home, w.dir, present, requested) && !cliSkillsWired(w)
297
+ (w) => harnessInPlay(home, w.dir, present, requested, resolvedHermesHome) && !cliSkillsWired(w)
246
298
  );
247
299
  if (broken.length > 0) {
248
300
  return {
@@ -251,7 +303,25 @@ async function checkSkills(home, which, requested, skillsSourceDir) {
251
303
  status: "warn",
252
304
  required: false,
253
305
  detail: `${broken.map(describeProblem).join("; ")}. Full state: ${describeWiring(inPlay)}`,
254
- fix: fixFor(home, broken),
306
+ fix: fixFor(home, broken, resolvedHermesHome),
307
+ data
308
+ }
309
+ };
310
+ }
311
+ const payDrift = [];
312
+ for (const w of inPlay) {
313
+ if (!harnessInPlay(home, w.dir, present, requested, resolvedHermesHome)) continue;
314
+ const onDisk = await readSkillFile(join(w.dir, OPTIONAL_PAY_SKILL, "SKILL.md"));
315
+ if (onDisk.kind === "ok" !== bazaarPay) payDrift.push(w.dir);
316
+ }
317
+ if (payDrift.length > 0) {
318
+ return {
319
+ result: {
320
+ name: "skills",
321
+ status: "warn",
322
+ required: false,
323
+ detail: bazaarPay ? `bazaarPay is on but the ${OPTIONAL_PAY_SKILL} skill is missing under ${payDrift.join(", ")}; agents are not being taught the lane` : `bazaarPay is off but the ${OPTIONAL_PAY_SKILL} skill is still present under ${payDrift.join(", ")}; agents are being taught a lane the runtime gate will refuse`,
324
+ fix: `Re-run \`tenjin config set bazaarPay ${bazaarPay ? "on" : "off"}\` to re-sync the skill's presence.`,
255
325
  data
256
326
  }
257
327
  };
@@ -287,7 +357,8 @@ async function checkSkills(home, which, requested, skillsSourceDir) {
287
357
  // passed --harness it would be a fix that never clears the warning.
288
358
  fix: fixFor(
289
359
  home,
290
- wiring.filter((w) => stale.includes(w.dir))
360
+ wiring.filter((w) => stale.includes(w.dir)),
361
+ resolvedHermesHome
291
362
  ),
292
363
  data
293
364
  }
@@ -303,6 +374,47 @@ async function checkSkills(home, which, requested, skillsSourceDir) {
303
374
  }
304
375
  };
305
376
  }
377
+ async function checkHermes(args) {
378
+ const { home, hermesHome, which, requested, webSearch: searchMode, homeWarning } = args;
379
+ const inPlay = requested.includes("hermes") || harnessDetectedBy(home, "hermes", which, hermesHome).length > 0;
380
+ if (!inPlay) return null;
381
+ const status = {
382
+ ...await readHermesIntegrationStatus(hermesHome),
383
+ ...homeWarning !== void 0 ? { homeWarning } : {}
384
+ };
385
+ const ok = status.mcp === "configured" && status.plugin === "installed" && status.activation === "enabled";
386
+ if (ok && homeWarning === void 0) {
387
+ return {
388
+ result: {
389
+ name: "hermes",
390
+ status: "ok",
391
+ required: false,
392
+ detail: `Native Tenjin retrieval and publish-back plugin enabled in ${hermesHome}`,
393
+ data: status
394
+ }
395
+ };
396
+ }
397
+ const problems = [];
398
+ if (status.mcp === "stale") {
399
+ problems.push(`MCP command missing (${status.mcpCommand ?? "unknown"})`);
400
+ } else if (status.mcp !== "configured") problems.push(`MCP ${status.mcp}`);
401
+ if (status.plugin !== "installed") problems.push(`plugin ${status.plugin}`);
402
+ if (status.activation !== "enabled") problems.push(`activation ${status.activation}`);
403
+ if (homeWarning !== void 0) problems.push("HERMES_HOME ignored");
404
+ return {
405
+ result: {
406
+ name: "hermes",
407
+ status: "warn",
408
+ required: false,
409
+ detail: `Hermes Tenjin integration incomplete in ${hermesHome}: ${problems.join(", ")}${homeWarning === void 0 ? "" : `. ${homeWarning}`}`,
410
+ // `tenjin install --harness hermes` alone is a dead end when the stored mode
411
+ // is `off`: it re-runs, withholds the hook code by design, and prints the same
412
+ // warning forever. Name the blocker that actually has to move first.
413
+ fix: searchMode === "off" ? "tenjin config set hooks.webSearch auto && tenjin install --harness hermes" : "tenjin install --harness hermes",
414
+ data: status
415
+ }
416
+ };
417
+ }
306
418
  async function compareWiredSkills(dirs, sourceDir) {
307
419
  let source;
308
420
  try {
@@ -311,14 +423,17 @@ async function compareWiredSkills(dirs, sourceDir) {
311
423
  return { stale: [], verifiable: false };
312
424
  }
313
425
  const packaged = /* @__PURE__ */ new Map();
314
- for (const name of CLI_SKILL_NAMES) {
426
+ for (const name of [...CLI_SKILL_NAMES, ...OPTIONAL_SKILL_NAMES]) {
315
427
  const read = await readSkillFile(join(source, name, "SKILL.md"));
316
428
  if (read.kind === "ok") packaged.set(name, read.bytes);
317
429
  }
318
- if (packaged.size !== CLI_SKILL_NAMES.length) return { stale: [], verifiable: false };
430
+ if (CLI_SKILL_NAMES.some((name) => !packaged.has(name))) {
431
+ return { stale: [], verifiable: false };
432
+ }
319
433
  const stale = [];
320
434
  for (const dir of dirs) {
321
- for (const name of CLI_SKILL_NAMES) {
435
+ for (const name of [...CLI_SKILL_NAMES, ...OPTIONAL_SKILL_NAMES]) {
436
+ if (!packaged.has(name)) continue;
322
437
  const onDisk = await readSkillFile(join(dir, name, "SKILL.md"));
323
438
  if (onDisk.kind !== "ok") continue;
324
439
  if (!packaged.get(name).equals(onDisk.bytes)) {
@@ -358,8 +473,8 @@ function reasonFor(w, name) {
358
473
  function hostedHere(w) {
359
474
  return w.skills.find((s) => s.name === HOSTED_SKILL_NAME)?.present === true;
360
475
  }
361
- function fixFor(home, dirs) {
362
- const flags = [...new Set(dirs.map((w) => harnessFlagFor(home, w.dir)))];
476
+ function fixFor(home, dirs, hermesHome) {
477
+ const flags = [...new Set(dirs.map((w) => harnessFlagFor(home, w.dir, hermesHome)))];
363
478
  return `tenjin install ${flags.map((f) => `--harness ${f}`).join(" ")}`;
364
479
  }
365
480
  function describeWiring(wiring) {
@@ -519,7 +634,7 @@ async function checkReadPath(baseUrl, timeoutMs, fetchImpl) {
519
634
  async function checkWallet(ctx, deps, env, rpcUrl) {
520
635
  const provider = deps.provider ?? await resolveLocalProviderOrNull(ctx, env, deps);
521
636
  if (provider === null) return [noWalletCheck()];
522
- const { describeWallet } = await import("./wallet-NS7TYWNN.js");
637
+ const { describeWallet } = await import("./wallet-TQ7D5EQ7.js");
523
638
  let desc;
524
639
  try {
525
640
  desc = await describeWallet(provider);
@@ -538,7 +653,7 @@ async function resolveLocalProviderOrNull(ctx, env, deps) {
538
653
  const envKey = env.TENJIN_WALLET_KEY;
539
654
  const envKeySet = typeof envKey === "string" && envKey.length > 0;
540
655
  if (!envKeySet && !await walletFileExists(ctx.dataDir)) return null;
541
- const { resolveWalletProvider } = await import("./wallet-NS7TYWNN.js");
656
+ const { resolveWalletProvider } = await import("./wallet-TQ7D5EQ7.js");
542
657
  return resolveWalletProvider(ctx, {
543
658
  ...deps.walletPassphrase !== void 0 ? { passphrase: deps.walletPassphrase } : {}
544
659
  });
@@ -676,4 +791,4 @@ export {
676
791
  isNoWalletCheck,
677
792
  renderDoctorHuman
678
793
  };
679
- //# sourceMappingURL=chunk-L4XNT3UW.js.map
794
+ //# sourceMappingURL=chunk-R7RSCBI7.js.map