@askdkc/kiokuko 0.1.17 → 0.1.19

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 (534) hide show
  1. package/README.ja.md +91 -112
  2. package/README.ko.md +90 -102
  3. package/README.md +103 -262
  4. package/README.zh-CN.md +88 -102
  5. package/dist/agent-file/atomic-write.d.ts +90 -3
  6. package/dist/agent-file/atomic-write.d.ts.map +1 -1
  7. package/dist/agent-file/atomic-write.js +990 -14
  8. package/dist/agent-file/atomic-write.js.map +1 -1
  9. package/dist/agent-file/managed-block.d.ts +12 -1
  10. package/dist/agent-file/managed-block.d.ts.map +1 -1
  11. package/dist/agent-file/managed-block.js +49 -4
  12. package/dist/agent-file/managed-block.js.map +1 -1
  13. package/dist/agent-file/render.d.ts +1 -1
  14. package/dist/agent-file/render.d.ts.map +1 -1
  15. package/dist/agent-file/render.js +10 -7
  16. package/dist/agent-file/render.js.map +1 -1
  17. package/dist/akinator/agent-task.d.ts +11 -22
  18. package/dist/akinator/agent-task.d.ts.map +1 -1
  19. package/dist/akinator/agent-task.js +454 -99
  20. package/dist/akinator/agent-task.js.map +1 -1
  21. package/dist/akinator/capabilities.d.ts +18 -6
  22. package/dist/akinator/capabilities.d.ts.map +1 -1
  23. package/dist/akinator/capabilities.js +72 -35
  24. package/dist/akinator/capabilities.js.map +1 -1
  25. package/dist/akinator/capability-binding.d.ts +11 -0
  26. package/dist/akinator/capability-binding.d.ts.map +1 -0
  27. package/dist/akinator/capability-binding.js +56 -0
  28. package/dist/akinator/capability-binding.js.map +1 -0
  29. package/dist/akinator/domain.js +2 -2
  30. package/dist/akinator/domain.js.map +1 -1
  31. package/dist/akinator/knowledge-path.d.ts.map +1 -1
  32. package/dist/akinator/knowledge-path.js +409 -39
  33. package/dist/akinator/knowledge-path.js.map +1 -1
  34. package/dist/akinator/orchestrator.d.ts +3 -4
  35. package/dist/akinator/orchestrator.d.ts.map +1 -1
  36. package/dist/akinator/orchestrator.js +1 -4
  37. package/dist/akinator/orchestrator.js.map +1 -1
  38. package/dist/akinator/service.d.ts +0 -4
  39. package/dist/akinator/service.d.ts.map +1 -1
  40. package/dist/akinator/service.js +19 -35
  41. package/dist/akinator/service.js.map +1 -1
  42. package/dist/akinator/skill-discovery-attempt.d.ts +20 -0
  43. package/dist/akinator/skill-discovery-attempt.d.ts.map +1 -0
  44. package/dist/akinator/skill-discovery-attempt.js +390 -0
  45. package/dist/akinator/skill-discovery-attempt.js.map +1 -0
  46. package/dist/akinator/store.d.ts.map +1 -1
  47. package/dist/akinator/store.js +107 -52
  48. package/dist/akinator/store.js.map +1 -1
  49. package/dist/akinator/types.d.ts +0 -12
  50. package/dist/akinator/types.d.ts.map +1 -1
  51. package/dist/bin/kiokuko.js +0 -0
  52. package/dist/cli.d.ts +2 -0
  53. package/dist/cli.d.ts.map +1 -1
  54. package/dist/cli.js +534 -148
  55. package/dist/cli.js.map +1 -1
  56. package/dist/client/server-client.d.ts +5 -3
  57. package/dist/client/server-client.d.ts.map +1 -1
  58. package/dist/client/server-client.js +486 -181
  59. package/dist/client/server-client.js.map +1 -1
  60. package/dist/commands/agent.d.ts +2 -0
  61. package/dist/commands/agent.d.ts.map +1 -1
  62. package/dist/commands/agent.js +861 -86
  63. package/dist/commands/agent.js.map +1 -1
  64. package/dist/commands/backup.d.ts +2 -1
  65. package/dist/commands/backup.d.ts.map +1 -1
  66. package/dist/commands/backup.js +64 -8
  67. package/dist/commands/backup.js.map +1 -1
  68. package/dist/commands/doctor.d.ts +5 -1
  69. package/dist/commands/doctor.d.ts.map +1 -1
  70. package/dist/commands/doctor.js +70 -26
  71. package/dist/commands/doctor.js.map +1 -1
  72. package/dist/commands/export.d.ts +0 -4
  73. package/dist/commands/export.d.ts.map +1 -1
  74. package/dist/commands/export.js +191 -32
  75. package/dist/commands/export.js.map +1 -1
  76. package/dist/commands/import.d.ts +10 -1
  77. package/dist/commands/import.d.ts.map +1 -1
  78. package/dist/commands/import.js +592 -113
  79. package/dist/commands/import.js.map +1 -1
  80. package/dist/commands/init.d.ts +19 -1
  81. package/dist/commands/init.d.ts.map +1 -1
  82. package/dist/commands/init.js +569 -22
  83. package/dist/commands/init.js.map +1 -1
  84. package/dist/commands/purge.d.ts.map +1 -1
  85. package/dist/commands/purge.js +3 -0
  86. package/dist/commands/purge.js.map +1 -1
  87. package/dist/commands/setup.d.ts +34 -8
  88. package/dist/commands/setup.d.ts.map +1 -1
  89. package/dist/commands/setup.js +418 -86
  90. package/dist/commands/setup.js.map +1 -1
  91. package/dist/commands/skills.d.ts +9 -0
  92. package/dist/commands/skills.d.ts.map +1 -0
  93. package/dist/commands/skills.js +317 -0
  94. package/dist/commands/skills.js.map +1 -0
  95. package/dist/commands/use.d.ts +10 -2
  96. package/dist/commands/use.d.ts.map +1 -1
  97. package/dist/commands/use.js +851 -73
  98. package/dist/commands/use.js.map +1 -1
  99. package/dist/config/paths.d.ts +11 -1
  100. package/dist/config/paths.d.ts.map +1 -1
  101. package/dist/config/paths.js +64 -29
  102. package/dist/config/paths.js.map +1 -1
  103. package/dist/config/project-config.d.ts +1 -0
  104. package/dist/config/project-config.d.ts.map +1 -1
  105. package/dist/config/project-config.js +70 -32
  106. package/dist/config/project-config.js.map +1 -1
  107. package/dist/context/broker.d.ts +28 -14
  108. package/dist/context/broker.d.ts.map +1 -1
  109. package/dist/context/broker.js +604 -145
  110. package/dist/context/broker.js.map +1 -1
  111. package/dist/context/delivery.d.ts +6 -21
  112. package/dist/context/delivery.d.ts.map +1 -1
  113. package/dist/context/delivery.js +196 -147
  114. package/dist/context/delivery.js.map +1 -1
  115. package/dist/context/feedback.d.ts +11 -12
  116. package/dist/context/feedback.d.ts.map +1 -1
  117. package/dist/context/feedback.js +229 -261
  118. package/dist/context/feedback.js.map +1 -1
  119. package/dist/context/ranking.d.ts +1 -12
  120. package/dist/context/ranking.d.ts.map +1 -1
  121. package/dist/context/ranking.js +13 -4
  122. package/dist/context/ranking.js.map +1 -1
  123. package/dist/context/recommendations.d.ts +0 -5
  124. package/dist/context/recommendations.d.ts.map +1 -1
  125. package/dist/context/recommendations.js +0 -1
  126. package/dist/context/recommendations.js.map +1 -1
  127. package/dist/context/run-state.d.ts +26 -0
  128. package/dist/context/run-state.d.ts.map +1 -0
  129. package/dist/context/run-state.js +399 -0
  130. package/dist/context/run-state.js.map +1 -0
  131. package/dist/context/scoped-broker.d.ts +17 -5
  132. package/dist/context/scoped-broker.d.ts.map +1 -1
  133. package/dist/context/scoped-broker.js +512 -106
  134. package/dist/context/scoped-broker.js.map +1 -1
  135. package/dist/context/selection-state.d.ts +19 -0
  136. package/dist/context/selection-state.d.ts.map +1 -0
  137. package/dist/context/selection-state.js +250 -0
  138. package/dist/context/selection-state.js.map +1 -0
  139. package/dist/db/adapter.d.ts +5 -3
  140. package/dist/db/adapter.d.ts.map +1 -1
  141. package/dist/db/adapter.js +6 -3
  142. package/dist/db/adapter.js.map +1 -1
  143. package/dist/db/capabilities.d.ts.map +1 -1
  144. package/dist/db/capabilities.js +34 -16
  145. package/dist/db/capabilities.js.map +1 -1
  146. package/dist/db/connection.d.ts +8 -0
  147. package/dist/db/connection.d.ts.map +1 -1
  148. package/dist/db/connection.js +55 -26
  149. package/dist/db/connection.js.map +1 -1
  150. package/dist/db/migrate.d.ts +28 -7
  151. package/dist/db/migrate.d.ts.map +1 -1
  152. package/dist/db/migrate.js +106 -78
  153. package/dist/db/migrate.js.map +1 -1
  154. package/dist/db/sqlite-retry.d.ts +11 -0
  155. package/dist/db/sqlite-retry.d.ts.map +1 -0
  156. package/dist/db/sqlite-retry.js +66 -0
  157. package/dist/db/sqlite-retry.js.map +1 -0
  158. package/dist/db/transaction.d.ts +13 -0
  159. package/dist/db/transaction.d.ts.map +1 -1
  160. package/dist/db/transaction.js +53 -24
  161. package/dist/db/transaction.js.map +1 -1
  162. package/dist/db/upgrade-backup.d.ts +58 -2
  163. package/dist/db/upgrade-backup.d.ts.map +1 -1
  164. package/dist/db/upgrade-backup.js +757 -28
  165. package/dist/db/upgrade-backup.js.map +1 -1
  166. package/dist/errors.js +1 -1
  167. package/dist/errors.js.map +1 -1
  168. package/dist/gateway/agent-service.d.ts +4 -1
  169. package/dist/gateway/agent-service.d.ts.map +1 -1
  170. package/dist/gateway/agent-service.js +71 -58
  171. package/dist/gateway/agent-service.js.map +1 -1
  172. package/dist/gateway/checkpoint-service.d.ts +1 -0
  173. package/dist/gateway/checkpoint-service.d.ts.map +1 -1
  174. package/dist/gateway/checkpoint-service.js +47 -24
  175. package/dist/gateway/checkpoint-service.js.map +1 -1
  176. package/dist/ledger/archive.d.ts +1 -4
  177. package/dist/ledger/archive.d.ts.map +1 -1
  178. package/dist/ledger/archive.js +77 -39
  179. package/dist/ledger/archive.js.map +1 -1
  180. package/dist/ledger/maintenance.d.ts +0 -11
  181. package/dist/ledger/maintenance.d.ts.map +1 -1
  182. package/dist/ledger/maintenance.js +24 -40
  183. package/dist/ledger/maintenance.js.map +1 -1
  184. package/dist/ledger/projection.d.ts +0 -1
  185. package/dist/ledger/projection.d.ts.map +1 -1
  186. package/dist/ledger/projection.js.map +1 -1
  187. package/dist/ledger/promotion.d.ts +0 -9
  188. package/dist/ledger/promotion.d.ts.map +1 -1
  189. package/dist/ledger/promotion.js.map +1 -1
  190. package/dist/ledger/query.d.ts +1 -15
  191. package/dist/ledger/query.d.ts.map +1 -1
  192. package/dist/ledger/query.js.map +1 -1
  193. package/dist/ledger/store.d.ts +0 -1
  194. package/dist/ledger/store.d.ts.map +1 -1
  195. package/dist/ledger/store.js +11 -8
  196. package/dist/ledger/store.js.map +1 -1
  197. package/dist/ledger/types.d.ts +0 -4
  198. package/dist/ledger/types.d.ts.map +1 -1
  199. package/dist/ledger/types.js.map +1 -1
  200. package/dist/ledger/validate.d.ts.map +1 -1
  201. package/dist/ledger/validate.js +0 -5
  202. package/dist/ledger/validate.js.map +1 -1
  203. package/dist/mcp/server.d.ts +4 -0
  204. package/dist/mcp/server.d.ts.map +1 -1
  205. package/dist/mcp/server.js +105 -54
  206. package/dist/mcp/server.js.map +1 -1
  207. package/dist/memory/audit.d.ts +0 -1
  208. package/dist/memory/audit.d.ts.map +1 -1
  209. package/dist/memory/audit.js +0 -1
  210. package/dist/memory/audit.js.map +1 -1
  211. package/dist/memory/curator.d.ts.map +1 -1
  212. package/dist/memory/curator.js +172 -96
  213. package/dist/memory/curator.js.map +1 -1
  214. package/dist/memory/entries.d.ts +12 -2
  215. package/dist/memory/entries.d.ts.map +1 -1
  216. package/dist/memory/entries.js +198 -114
  217. package/dist/memory/entries.js.map +1 -1
  218. package/dist/memory/federated-retrieval.d.ts +12 -1
  219. package/dist/memory/federated-retrieval.d.ts.map +1 -1
  220. package/dist/memory/federated-retrieval.js +183 -70
  221. package/dist/memory/federated-retrieval.js.map +1 -1
  222. package/dist/memory/hybrid-retrieval.d.ts +5 -11
  223. package/dist/memory/hybrid-retrieval.d.ts.map +1 -1
  224. package/dist/memory/hybrid-retrieval.js +78 -58
  225. package/dist/memory/hybrid-retrieval.js.map +1 -1
  226. package/dist/memory/lifecycle.d.ts.map +1 -1
  227. package/dist/memory/lifecycle.js +17 -13
  228. package/dist/memory/lifecycle.js.map +1 -1
  229. package/dist/memory/rebuild-search.d.ts +5 -0
  230. package/dist/memory/rebuild-search.d.ts.map +1 -1
  231. package/dist/memory/rebuild-search.js +101 -76
  232. package/dist/memory/rebuild-search.js.map +1 -1
  233. package/dist/memory/retrieval-query.d.ts +0 -5
  234. package/dist/memory/retrieval-query.d.ts.map +1 -1
  235. package/dist/memory/retrieval-query.js +0 -5
  236. package/dist/memory/retrieval-query.js.map +1 -1
  237. package/dist/memory/retrieval.d.ts.map +1 -1
  238. package/dist/memory/retrieval.js +25 -131
  239. package/dist/memory/retrieval.js.map +1 -1
  240. package/dist/memory/revisions.d.ts +76 -1
  241. package/dist/memory/revisions.d.ts.map +1 -1
  242. package/dist/memory/revisions.js +539 -35
  243. package/dist/memory/revisions.js.map +1 -1
  244. package/dist/memory/scoped-memory.d.ts +16 -1
  245. package/dist/memory/scoped-memory.d.ts.map +1 -1
  246. package/dist/memory/scoped-memory.js +240 -107
  247. package/dist/memory/scoped-memory.js.map +1 -1
  248. package/dist/memory/secrets.d.ts +2 -0
  249. package/dist/memory/secrets.d.ts.map +1 -1
  250. package/dist/memory/secrets.js +36 -0
  251. package/dist/memory/secrets.js.map +1 -1
  252. package/dist/memory/structured-memory.d.ts +3 -2
  253. package/dist/memory/structured-memory.d.ts.map +1 -1
  254. package/dist/memory/structured-memory.js +54 -22
  255. package/dist/memory/structured-memory.js.map +1 -1
  256. package/dist/memory/workspaces.d.ts +9 -0
  257. package/dist/memory/workspaces.d.ts.map +1 -1
  258. package/dist/memory/workspaces.js +67 -0
  259. package/dist/memory/workspaces.js.map +1 -1
  260. package/dist/package-version.d.ts +2 -0
  261. package/dist/package-version.d.ts.map +1 -0
  262. package/dist/package-version.js +7 -0
  263. package/dist/package-version.js.map +1 -0
  264. package/dist/repository/binding.d.ts +5 -0
  265. package/dist/repository/binding.d.ts.map +1 -1
  266. package/dist/repository/binding.js +117 -17
  267. package/dist/repository/binding.js.map +1 -1
  268. package/dist/repository/framework-version.d.ts +8 -0
  269. package/dist/repository/framework-version.d.ts.map +1 -0
  270. package/dist/repository/framework-version.js +29 -0
  271. package/dist/repository/framework-version.js.map +1 -0
  272. package/dist/repository/identity-value.d.ts +4 -0
  273. package/dist/repository/identity-value.d.ts.map +1 -0
  274. package/dist/repository/identity-value.js +24 -0
  275. package/dist/repository/identity-value.js.map +1 -0
  276. package/dist/repository/identity.d.ts.map +1 -1
  277. package/dist/repository/identity.js +2 -0
  278. package/dist/repository/identity.js.map +1 -1
  279. package/dist/repository/project-fingerprint.d.ts +14 -2
  280. package/dist/repository/project-fingerprint.d.ts.map +1 -1
  281. package/dist/repository/project-fingerprint.js +312 -33
  282. package/dist/repository/project-fingerprint.js.map +1 -1
  283. package/dist/repository/remote-url.d.ts +0 -1
  284. package/dist/repository/remote-url.d.ts.map +1 -1
  285. package/dist/repository/remote-url.js +0 -1
  286. package/dist/repository/remote-url.js.map +1 -1
  287. package/dist/runtime-version.d.ts +2 -1
  288. package/dist/runtime-version.d.ts.map +1 -1
  289. package/dist/runtime-version.js +21 -4
  290. package/dist/runtime-version.js.map +1 -1
  291. package/dist/serialization/boundary-json.d.ts +20 -0
  292. package/dist/serialization/boundary-json.d.ts.map +1 -0
  293. package/dist/serialization/boundary-json.js +129 -0
  294. package/dist/serialization/boundary-json.js.map +1 -0
  295. package/dist/serialization/envelope.js +1 -1
  296. package/dist/serialization/envelope.js.map +1 -1
  297. package/dist/serialization/validate.d.ts +7 -0
  298. package/dist/serialization/validate.d.ts.map +1 -1
  299. package/dist/serialization/validate.js +53 -13
  300. package/dist/serialization/validate.js.map +1 -1
  301. package/dist/server/app.js +1 -1
  302. package/dist/server/app.js.map +1 -1
  303. package/dist/server/http.d.ts +4 -3
  304. package/dist/server/http.d.ts.map +1 -1
  305. package/dist/server/http.js +90 -50
  306. package/dist/server/http.js.map +1 -1
  307. package/dist/server/idempotency.d.ts +0 -6
  308. package/dist/server/idempotency.d.ts.map +1 -1
  309. package/dist/server/idempotency.js.map +1 -1
  310. package/dist/server/router.d.ts.map +1 -1
  311. package/dist/server/router.js +21 -4
  312. package/dist/server/router.js.map +1 -1
  313. package/dist/server/routes/agent-capability-gate.d.ts +40 -0
  314. package/dist/server/routes/agent-capability-gate.d.ts.map +1 -0
  315. package/dist/server/routes/agent-capability-gate.js +182 -0
  316. package/dist/server/routes/agent-capability-gate.js.map +1 -0
  317. package/dist/server/routes/agent-events.d.ts.map +1 -1
  318. package/dist/server/routes/agent-events.js +8 -1
  319. package/dist/server/routes/agent-events.js.map +1 -1
  320. package/dist/server/routes/agent-intake.d.ts.map +1 -1
  321. package/dist/server/routes/agent-intake.js +10 -2
  322. package/dist/server/routes/agent-intake.js.map +1 -1
  323. package/dist/server/routes/agent-promotions.d.ts.map +1 -1
  324. package/dist/server/routes/agent-promotions.js +5 -2
  325. package/dist/server/routes/agent-promotions.js.map +1 -1
  326. package/dist/server/routes/agent-runs.d.ts.map +1 -1
  327. package/dist/server/routes/agent-runs.js +18 -4
  328. package/dist/server/routes/agent-runs.js.map +1 -1
  329. package/dist/server/routes/request-binding.d.ts +5 -0
  330. package/dist/server/routes/request-binding.d.ts.map +1 -0
  331. package/dist/server/routes/request-binding.js +49 -0
  332. package/dist/server/routes/request-binding.js.map +1 -0
  333. package/dist/server/routes/task5-support.d.ts +1 -8
  334. package/dist/server/routes/task5-support.d.ts.map +1 -1
  335. package/dist/server/routes/task5-support.js +1 -17
  336. package/dist/server/routes/task5-support.js.map +1 -1
  337. package/dist/server/routes/task5.d.ts.map +1 -1
  338. package/dist/server/routes/task5.js +106 -36
  339. package/dist/server/routes/task5.js.map +1 -1
  340. package/dist/server/write-queue.js +2 -2
  341. package/dist/server/write-queue.js.map +1 -1
  342. package/dist/setup/claude-config.d.ts +2 -1
  343. package/dist/setup/claude-config.d.ts.map +1 -1
  344. package/dist/setup/claude-config.js +54 -4
  345. package/dist/setup/claude-config.js.map +1 -1
  346. package/dist/setup/client-detection.d.ts +7 -2
  347. package/dist/setup/client-detection.d.ts.map +1 -1
  348. package/dist/setup/client-detection.js +27 -9
  349. package/dist/setup/client-detection.js.map +1 -1
  350. package/dist/setup/hermes-config.d.ts +2 -1
  351. package/dist/setup/hermes-config.d.ts.map +1 -1
  352. package/dist/setup/hermes-config.js +53 -12
  353. package/dist/setup/hermes-config.js.map +1 -1
  354. package/dist/setup/legacy-client-cleanup.d.ts +6 -0
  355. package/dist/setup/legacy-client-cleanup.d.ts.map +1 -0
  356. package/dist/setup/legacy-client-cleanup.js +152 -0
  357. package/dist/setup/legacy-client-cleanup.js.map +1 -0
  358. package/dist/setup/managed-text.d.ts.map +1 -1
  359. package/dist/setup/managed-text.js +11 -1
  360. package/dist/setup/managed-text.js.map +1 -1
  361. package/dist/setup/opencode-config.d.ts +2 -1
  362. package/dist/setup/opencode-config.d.ts.map +1 -1
  363. package/dist/setup/opencode-config.js +57 -5
  364. package/dist/setup/opencode-config.js.map +1 -1
  365. package/dist/setup/render.d.ts +2 -1
  366. package/dist/setup/render.d.ts.map +1 -1
  367. package/dist/setup/render.js +91 -17
  368. package/dist/setup/render.js.map +1 -1
  369. package/dist/setup/standard-skills.d.ts +16 -2
  370. package/dist/setup/standard-skills.d.ts.map +1 -1
  371. package/dist/setup/standard-skills.js +37 -13
  372. package/dist/setup/standard-skills.js.map +1 -1
  373. package/dist/setup/strict-json.d.ts +7 -0
  374. package/dist/setup/strict-json.d.ts.map +1 -0
  375. package/dist/setup/strict-json.js +98 -0
  376. package/dist/setup/strict-json.js.map +1 -0
  377. package/dist/setup/strict-toml.d.ts +7 -0
  378. package/dist/setup/strict-toml.d.ts.map +1 -0
  379. package/dist/setup/strict-toml.js +470 -0
  380. package/dist/setup/strict-toml.js.map +1 -0
  381. package/dist/skills/cache.d.ts +15 -0
  382. package/dist/skills/cache.d.ts.map +1 -0
  383. package/dist/skills/cache.js +19 -0
  384. package/dist/skills/cache.js.map +1 -0
  385. package/dist/skills/candidate-ranking.d.ts +15 -0
  386. package/dist/skills/candidate-ranking.d.ts.map +1 -0
  387. package/dist/skills/candidate-ranking.js +52 -0
  388. package/dist/skills/candidate-ranking.js.map +1 -0
  389. package/dist/skills/chunking.d.ts +11 -0
  390. package/dist/skills/chunking.d.ts.map +1 -0
  391. package/dist/skills/chunking.js +291 -0
  392. package/dist/skills/chunking.js.map +1 -0
  393. package/dist/skills/config.d.ts +19 -0
  394. package/dist/skills/config.d.ts.map +1 -0
  395. package/dist/skills/config.js +103 -0
  396. package/dist/skills/config.js.map +1 -0
  397. package/dist/skills/discovery-service.d.ts +26 -0
  398. package/dist/skills/discovery-service.d.ts.map +1 -0
  399. package/dist/skills/discovery-service.js +921 -0
  400. package/dist/skills/discovery-service.js.map +1 -0
  401. package/dist/skills/external-transport.d.ts +2 -0
  402. package/dist/skills/external-transport.d.ts.map +1 -0
  403. package/dist/skills/external-transport.js +30 -0
  404. package/dist/skills/external-transport.js.map +1 -0
  405. package/dist/skills/find.d.ts +16 -0
  406. package/dist/skills/find.d.ts.map +1 -0
  407. package/dist/skills/find.js +58 -0
  408. package/dist/skills/find.js.map +1 -0
  409. package/dist/skills/gap-detection.d.ts +23 -0
  410. package/dist/skills/gap-detection.d.ts.map +1 -0
  411. package/dist/skills/gap-detection.js +62 -0
  412. package/dist/skills/gap-detection.js.map +1 -0
  413. package/dist/skills/import-preparation.d.ts +4 -0
  414. package/dist/skills/import-preparation.d.ts.map +1 -0
  415. package/dist/skills/import-preparation.js +20 -0
  416. package/dist/skills/import-preparation.js.map +1 -0
  417. package/dist/skills/materialization-authority.d.ts +11 -0
  418. package/dist/skills/materialization-authority.d.ts.map +1 -0
  419. package/dist/skills/materialization-authority.js +92 -0
  420. package/dist/skills/materialization-authority.js.map +1 -0
  421. package/dist/skills/materialization-service.d.ts +22 -0
  422. package/dist/skills/materialization-service.d.ts.map +1 -0
  423. package/dist/skills/materialization-service.js +101 -0
  424. package/dist/skills/materialization-service.js.map +1 -0
  425. package/dist/skills/official-catalog.d.ts +31 -0
  426. package/dist/skills/official-catalog.d.ts.map +1 -0
  427. package/dist/skills/official-catalog.js +110 -0
  428. package/dist/skills/official-catalog.js.map +1 -0
  429. package/dist/skills/providers/schema.d.ts +30 -0
  430. package/dist/skills/providers/schema.d.ts.map +1 -0
  431. package/dist/skills/providers/schema.js +354 -0
  432. package/dist/skills/providers/schema.js.map +1 -0
  433. package/dist/skills/providers/skills-sh-compat.d.ts +17 -0
  434. package/dist/skills/providers/skills-sh-compat.d.ts.map +1 -0
  435. package/dist/skills/providers/skills-sh-compat.js +71 -0
  436. package/dist/skills/providers/skills-sh-compat.js.map +1 -0
  437. package/dist/skills/providers/skills-sh-v1.d.ts +23 -0
  438. package/dist/skills/providers/skills-sh-v1.d.ts.map +1 -0
  439. package/dist/skills/providers/skills-sh-v1.js +134 -0
  440. package/dist/skills/providers/skills-sh-v1.js.map +1 -0
  441. package/dist/skills/query-builder.d.ts +18 -0
  442. package/dist/skills/query-builder.d.ts.map +1 -0
  443. package/dist/skills/query-builder.js +93 -0
  444. package/dist/skills/query-builder.js.map +1 -0
  445. package/dist/skills/source/errors.d.ts +9 -0
  446. package/dist/skills/source/errors.d.ts.map +1 -0
  447. package/dist/skills/source/errors.js +15 -0
  448. package/dist/skills/source/errors.js.map +1 -0
  449. package/dist/skills/source/frontmatter.d.ts +9 -0
  450. package/dist/skills/source/frontmatter.d.ts.map +1 -0
  451. package/dist/skills/source/frontmatter.js +77 -0
  452. package/dist/skills/source/frontmatter.js.map +1 -0
  453. package/dist/skills/source/github-fetcher.d.ts +20 -0
  454. package/dist/skills/source/github-fetcher.d.ts.map +1 -0
  455. package/dist/skills/source/github-fetcher.js +292 -0
  456. package/dist/skills/source/github-fetcher.js.map +1 -0
  457. package/dist/skills/source/snapshot-validator.d.ts +28 -0
  458. package/dist/skills/source/snapshot-validator.d.ts.map +1 -0
  459. package/dist/skills/source/snapshot-validator.js +186 -0
  460. package/dist/skills/source/snapshot-validator.js.map +1 -0
  461. package/dist/skills/store.d.ts +181 -0
  462. package/dist/skills/store.d.ts.map +1 -0
  463. package/dist/skills/store.js +1710 -0
  464. package/dist/skills/store.js.map +1 -0
  465. package/dist/skills/types.d.ts +169 -0
  466. package/dist/skills/types.d.ts.map +1 -0
  467. package/dist/skills/types.js +2 -0
  468. package/dist/skills/types.js.map +1 -0
  469. package/dist/web/i18n.d.ts +32 -0
  470. package/dist/web/i18n.d.ts.map +1 -1
  471. package/dist/web/i18n.js +128 -0
  472. package/dist/web/i18n.js.map +1 -1
  473. package/dist/web/server.d.ts.map +1 -1
  474. package/dist/web/server.js +386 -38
  475. package/dist/web/server.js.map +1 -1
  476. package/dist/web/ui.d.ts +4 -0
  477. package/dist/web/ui.d.ts.map +1 -1
  478. package/dist/web/ui.js +382 -6
  479. package/dist/web/ui.js.map +1 -1
  480. package/migrations/009_external_skill_discovery.sql +126 -0
  481. package/package.json +4 -3
  482. package/skills/kiokuko-single-purpose-functions/SKILL.md +288 -0
  483. package/skills/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +344 -0
  484. package/skills/kiokuko-single-purpose-functions/references/review-checklist.md +97 -0
  485. package/skills/kiokuko-ui-design-soul/SKILL.md +1186 -28
  486. package/templates/AGENTS.md +8 -7
  487. package/dist/client/runtime-discovery.d.ts +0 -15
  488. package/dist/client/runtime-discovery.d.ts.map +0 -1
  489. package/dist/client/runtime-discovery.js +0 -45
  490. package/dist/client/runtime-discovery.js.map +0 -1
  491. package/dist/commands/call.d.ts +0 -7
  492. package/dist/commands/call.d.ts.map +0 -1
  493. package/dist/commands/call.js +0 -10
  494. package/dist/commands/call.js.map +0 -1
  495. package/dist/commands/link.d.ts +0 -6
  496. package/dist/commands/link.d.ts.map +0 -1
  497. package/dist/commands/link.js +0 -6
  498. package/dist/commands/link.js.map +0 -1
  499. package/dist/commands/promote.d.ts +0 -6
  500. package/dist/commands/promote.d.ts.map +0 -1
  501. package/dist/commands/promote.js +0 -6
  502. package/dist/commands/promote.js.map +0 -1
  503. package/dist/commands/read.d.ts +0 -6
  504. package/dist/commands/read.d.ts.map +0 -1
  505. package/dist/commands/read.js +0 -4
  506. package/dist/commands/read.js.map +0 -1
  507. package/dist/commands/recall.d.ts +0 -6
  508. package/dist/commands/recall.d.ts.map +0 -1
  509. package/dist/commands/recall.js +0 -4
  510. package/dist/commands/recall.js.map +0 -1
  511. package/dist/commands/record.d.ts +0 -6
  512. package/dist/commands/record.d.ts.map +0 -1
  513. package/dist/commands/record.js +0 -4
  514. package/dist/commands/record.js.map +0 -1
  515. package/dist/commands/search.d.ts +0 -6
  516. package/dist/commands/search.d.ts.map +0 -1
  517. package/dist/commands/search.js +0 -4
  518. package/dist/commands/search.js.map +0 -1
  519. package/dist/commands/supersede.d.ts +0 -6
  520. package/dist/commands/supersede.d.ts.map +0 -1
  521. package/dist/commands/supersede.js +0 -6
  522. package/dist/commands/supersede.js.map +0 -1
  523. package/dist/knowledge/sources.d.ts +0 -72
  524. package/dist/knowledge/sources.d.ts.map +0 -1
  525. package/dist/knowledge/sources.js +0 -388
  526. package/dist/knowledge/sources.js.map +0 -1
  527. package/dist/setup/opencode-evidence.d.ts +0 -37
  528. package/dist/setup/opencode-evidence.d.ts.map +0 -1
  529. package/dist/setup/opencode-evidence.js +0 -58
  530. package/dist/setup/opencode-evidence.js.map +0 -1
  531. package/dist/setup/opencode-loop-guard.d.ts +0 -9
  532. package/dist/setup/opencode-loop-guard.d.ts.map +0 -1
  533. package/dist/setup/opencode-loop-guard.js +0 -248
  534. package/dist/setup/opencode-loop-guard.js.map +0 -1
@@ -2,7 +2,12 @@ import { constants } from 'node:fs';
2
2
  import { access, stat } from 'node:fs/promises';
3
3
  import path from 'node:path';
4
4
  export const DETECTABLE_CLIENTS = ['codex', 'opencode', 'claude', 'hermes'];
5
- async function hasExecutable(platform, pathModule, env, executableBaseName) {
5
+ function errorCode(error) {
6
+ return error instanceof Error && 'code' in error
7
+ ? String(error.code)
8
+ : undefined;
9
+ }
10
+ async function hasExecutable(platform, pathModule, env, executableBaseName, dependencies) {
6
11
  const pathValue = env.PATH;
7
12
  if (!pathValue)
8
13
  return false;
@@ -14,33 +19,46 @@ async function hasExecutable(platform, pathModule, env, executableBaseName) {
14
19
  for (const executableName of executableNames) {
15
20
  const executable = pathModule.join(directory, executableName);
16
21
  try {
17
- const info = await stat(executable);
22
+ const info = await dependencies.stat(executable);
18
23
  if (!info.isFile())
19
24
  continue;
20
- await access(executable, platform === 'win32' ? constants.F_OK : constants.X_OK);
25
+ }
26
+ catch (error) {
27
+ if (['ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
28
+ continue;
29
+ throw error;
30
+ }
31
+ try {
32
+ await dependencies.access(executable, platform === 'win32' ? constants.F_OK : constants.X_OK);
21
33
  return true;
22
34
  }
23
- catch {
24
- // Continue checking the remaining PATH candidates.
35
+ catch (error) {
36
+ if (['EACCES', 'EPERM', 'ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
37
+ continue;
38
+ throw error;
25
39
  }
26
40
  }
27
41
  }
28
42
  return false;
29
43
  }
30
44
  /** Detect supported client executables without mutating client state. */
31
- export async function detectInstalledClients(options = {}) {
45
+ export async function detectInstalledClients(options = {}, dependencyOverrides = {}) {
32
46
  const platform = options.platform ?? process.platform;
33
47
  const pathModule = platform === 'win32' ? path.win32 : path.posix;
34
48
  const env = options.env ?? process.env;
49
+ const dependencies = {
50
+ stat: dependencyOverrides.stat ?? stat,
51
+ access: dependencyOverrides.access ?? access,
52
+ };
35
53
  const installed = [];
36
54
  for (const client of DETECTABLE_CLIENTS) {
37
- if (await hasExecutable(platform, pathModule, env, client))
55
+ if (await hasExecutable(platform, pathModule, env, client, dependencies))
38
56
  installed.push(client);
39
57
  }
40
58
  return installed;
41
59
  }
42
60
  /** Detect an installed Hermes executable without mutating client state. */
43
- export async function isHermesAgentInstalled(options = {}) {
44
- return (await detectInstalledClients(options)).includes('hermes');
61
+ export async function isHermesAgentInstalled(options = {}, dependencyOverrides = {}) {
62
+ return (await detectInstalledClients(options, dependencyOverrides)).includes('hermes');
45
63
  }
46
64
  //# sourceMappingURL=client-detection.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/setup/client-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAGrF,KAAK,UAAU,aAAa,CAC1B,QAAyB,EACzB,UAA6B,EAC7B,GAAsB,EACtB,kBAA0B;IAE1B,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,aAAa,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,MAAM,eAAe,GAAG,QAAQ,KAAK,OAAO;QAC1C,CAAC,CAAC,CAAC,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,kBAAkB,CAAC;QAC7G,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAEzB,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,MAAM,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACjF,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,OAAO,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC"}
1
+ {"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/setup/client-detection.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,5 @@
1
+ import type { SkillDiscoveryMode } from '../skills/types.js';
1
2
  import type { DelimitedBlockResult } from './managed-text.js';
2
3
  export declare const HERMES_MANAGED_MARKER = "Managed by `kiokuko setup`.";
3
- export declare function renderHermesConfig(existing: string | undefined, command?: string): DelimitedBlockResult;
4
+ export declare function renderHermesConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode): DelimitedBlockResult;
4
5
  //# sourceMappingURL=hermes-config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AA6DnE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,GAAG,oBAAoB,CAoC1G"}
1
+ {"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAkFnE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAmDnJ"}
@@ -1,5 +1,6 @@
1
1
  import { parseDocument, isMap, isNode, isPair, isScalar, isSeq } from 'yaml';
2
2
  import { KiokukoError } from '../errors.js';
3
+ import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
3
4
  export const HERMES_MANAGED_MARKER = 'Managed by `kiokuko setup`.';
4
5
  function scalarValue(value) {
5
6
  return isScalar(value) ? value.value : undefined;
@@ -8,21 +9,35 @@ function findKeyPair(map, key) {
8
9
  return map.items.find((item) => isPair(item) && scalarValue(item.key) === key);
9
10
  }
10
11
  function hasManagedMarker(pair) {
11
- return (isNode(pair.key) && pair.key.commentBefore?.includes(HERMES_MANAGED_MARKER) === true)
12
- || (isNode(pair.value) && pair.value.commentBefore?.includes(HERMES_MANAGED_MARKER) === true);
12
+ return isNode(pair.value) && pair.value.commentBefore?.trim() === HERMES_MANAGED_MARKER;
13
13
  }
14
14
  function hasCanonicalManagedShape(pair) {
15
15
  if (!isMap(pair.value))
16
16
  return false;
17
17
  const fields = pair.value.items.map((item) => isPair(item) ? scalarValue(item.key) : undefined);
18
- if (fields.length !== 2 || fields[0] === fields[1] || !fields.includes('command') || !fields.includes('args'))
18
+ if (fields.length !== 3
19
+ || new Set(fields).size !== fields.length
20
+ || !fields.includes('command')
21
+ || !fields.includes('args')
22
+ || fields.some((field) => field !== 'command' && field !== 'args' && field !== 'env'))
19
23
  return false;
20
24
  const commandNode = pair.value.get('command', true);
21
25
  const argsNode = pair.value.get('args', true);
22
- return typeof scalarValue(commandNode) === 'string'
23
- && isSeq(argsNode)
24
- && argsNode.items.length === 1
25
- && scalarValue(argsNode.items[0]) === 'mcp';
26
+ const command = scalarValue(commandNode);
27
+ if (typeof command !== 'string'
28
+ || command.trim().length === 0
29
+ || command.includes('\0')
30
+ || !isSeq(argsNode)
31
+ || argsNode.items.length !== 1
32
+ || scalarValue(argsNode.items[0]) !== 'mcp')
33
+ return false;
34
+ const envNode = pair.value.get('env', true);
35
+ if (!isMap(envNode) || envNode.items.length !== 1)
36
+ return false;
37
+ const environmentPair = envNode.items[0];
38
+ return isPair(environmentPair)
39
+ && scalarValue(environmentPair.key) === SKILL_DISCOVERY_ENV
40
+ && isSkillDiscoveryMode(scalarValue(environmentPair.value));
26
41
  }
27
42
  function currentManagedCommand(pair) {
28
43
  if (!hasCanonicalManagedShape(pair))
@@ -30,8 +45,18 @@ function currentManagedCommand(pair) {
30
45
  const command = scalarValue(pair.value.get('command', true));
31
46
  return typeof command === 'string' ? command : undefined;
32
47
  }
33
- function hasRequestedState(pair, command) {
34
- return currentManagedCommand(pair) === command;
48
+ function currentManagedSkillDiscoveryMode(pair) {
49
+ if (!hasCanonicalManagedShape(pair) || !isMap(pair.value))
50
+ return undefined;
51
+ const environment = pair.value.get('env', true);
52
+ if (!isMap(environment))
53
+ return undefined;
54
+ const mode = scalarValue(environment.get(SKILL_DISCOVERY_ENV, true));
55
+ return isSkillDiscoveryMode(mode) ? mode : undefined;
56
+ }
57
+ function hasRequestedState(pair, command, skillDiscoveryMode) {
58
+ return currentManagedCommand(pair) === command
59
+ && currentManagedSkillDiscoveryMode(pair) === skillDiscoveryMode;
35
60
  }
36
61
  function validation() {
37
62
  throw new KiokukoError('VALIDATION_ERROR', 'Hermes config is not a valid YAML mapping');
@@ -48,7 +73,13 @@ function serializeHermesDocument(document, source, existing) {
48
73
  action: existing === undefined ? 'created' : content === existing ? 'unchanged' : 'updated',
49
74
  };
50
75
  }
51
- export function renderHermesConfig(existing, command = 'kiokuko') {
76
+ export function renderHermesConfig(existing, command = 'kiokuko', skillDiscoveryMode) {
77
+ if (typeof command !== 'string' || command.trim().length === 0 || command.includes('\0')) {
78
+ throw new KiokukoError('VALIDATION_ERROR', 'Hermes MCP command must be a non-empty executable path or name');
79
+ }
80
+ if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
81
+ throw new KiokukoError('VALIDATION_ERROR', 'Hermes Skill discovery mode is invalid');
82
+ }
52
83
  const source = existing ?? '';
53
84
  const document = parseDocument(source);
54
85
  if (document.errors.length > 0)
@@ -74,14 +105,24 @@ export function renderHermesConfig(existing, command = 'kiokuko') {
74
105
  if (existingPair !== undefined) {
75
106
  if (!hasManagedMarker(existingPair) || !hasCanonicalManagedShape(existingPair))
76
107
  conflict();
77
- if (hasRequestedState(existingPair, command))
108
+ const currentSkillDiscoveryMode = currentManagedSkillDiscoveryMode(existingPair);
109
+ if (currentSkillDiscoveryMode === undefined)
110
+ conflict();
111
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? currentSkillDiscoveryMode;
112
+ if (hasRequestedState(existingPair, command, effectiveSkillDiscoveryMode))
78
113
  return { content: source, action: 'unchanged' };
79
114
  if (!isMap(existingPair.value))
80
115
  conflict();
81
116
  existingPair.value.set('command', command);
117
+ existingPair.value.set('env', { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode });
82
118
  return serializeHermesDocument(document, source, existing);
83
119
  }
84
- const pair = document.createPair('kiokuko', { command, args: ['mcp'] });
120
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? 'official';
121
+ const pair = document.createPair('kiokuko', {
122
+ command,
123
+ args: ['mcp'],
124
+ env: { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode },
125
+ });
85
126
  if (!isNode(pair.value))
86
127
  validation();
87
128
  pair.value.commentBefore = ` ${HERMES_MANAGED_MARKER}`;
@@ -1 +1 @@
1
- {"version":3,"file":"hermes-config.js","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"hermes-config.js","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export declare const LEGACY_OPENCODE_LOOP_GUARD_MARKER = "// Managed by `kiokuko setup`: OpenCode loop guard v1";
2
+ /** Remove one exact hook written by the retired Claude integration. */
3
+ export declare function cleanupLegacyClaudePromptHook(source: string): string;
4
+ /** Accept only byte-exact files emitted by the retired OpenCode guard renderer. */
5
+ export declare function assertExactLegacyOpenCodeLoopGuard(source: string): void;
6
+ //# sourceMappingURL=legacy-client-cleanup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-client-cleanup.d.ts","sourceRoot":"","sources":["../../src/setup/legacy-client-cleanup.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iCAAiC,0DAA0D,CAAC;AAyFzG,uEAAuE;AACvE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyCpE;AAED,mFAAmF;AACnF,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CASvE"}
@@ -0,0 +1,152 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { applyEdits, modify, parse } from 'jsonc-parser';
3
+ import { KiokukoError } from '../errors.js';
4
+ import { assertStrictJsonSyntax } from './strict-json.js';
5
+ const CLAUDE_HOOK_EVENT = 'UserPromptSubmit';
6
+ const LEGACY_HOOK_INPUT = Object.freeze({
7
+ prompt: '${prompt}',
8
+ cwd: '${cwd}',
9
+ sessionId: '${session_id}',
10
+ });
11
+ const LEGACY_HOOK_STATUS = 'Kiokuko: recalling relevant memory';
12
+ export const LEGACY_OPENCODE_LOOP_GUARD_MARKER = '// Managed by `kiokuko setup`: OpenCode loop guard v1';
13
+ const LEGACY_OPENCODE_LOOP_GUARD_SHA256 = new Set([
14
+ '9a9a5430942a3632c7b73958d49fc5e456b439741ef31db34fec38c2ebcb9f0a',
15
+ '6910ad5cae126371397ca3dda4adadca8b07f80dcd4ba995192c46e167758cde',
16
+ 'a34f3e3c3009ae622bda92a77ea33cc24aaa75ab05a338f795acbe8346effbfe',
17
+ 'd86f45354797f586748fd7beaa6c66c8df0705a0ac7d07db45118aa1dbdccece',
18
+ '598d919ed088e725311e567d3ee305bdbb026b538972c41e84ed450d4cd79620',
19
+ '04898710f67a451177e351f5343aed2b2a9c75c4fcc233829b2062aa804bd040',
20
+ 'd044cc7947dd4b41e14ed8891a01f21bb28f83c14765e542192172202e7ab6b2',
21
+ '26facf4203b66c25d0305a7ec919cfba6e55e4b2b4dcd7333af0002eb87255d2',
22
+ '4226cfe43306871e3fda95f87e4d4c1c98c54150e8a9ec876e941d7aaf5a8431',
23
+ 'efe0b9274b6f0de8976989639810cff6d55f50d759a6e1a3839834f3b3386931',
24
+ '2aecaf04354cb76d0e2c8fa63f96f7fb91e8bd3720aaee827e5794f0eb6d94a6',
25
+ '361c7b1a8d0993597d139ab6703d130d788dfcf01e4911bb7966c54afa57201b',
26
+ ]);
27
+ function isObject(value) {
28
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
29
+ return false;
30
+ const prototype = Object.getPrototypeOf(value);
31
+ return prototype === Object.prototype || prototype === null;
32
+ }
33
+ function invalidClaudeSettings() {
34
+ throw new KiokukoError('VALIDATION_ERROR', 'Claude settings are not a valid JSON object with valid hook arrays');
35
+ }
36
+ function legacyClaudeHookConflict() {
37
+ throw new KiokukoError('CONFLICT', 'Claude settings contain an ambiguous or modified legacy Kiokuko prompt hook; remove it manually before running setup');
38
+ }
39
+ function validateHookGroups(value) {
40
+ if (!Array.isArray(value))
41
+ invalidClaudeSettings();
42
+ for (const group of value) {
43
+ if (!isObject(group) || (group.matcher !== undefined && typeof group.matcher !== 'string') || !Array.isArray(group.hooks))
44
+ invalidClaudeSettings();
45
+ for (const handler of group.hooks) {
46
+ if (!isObject(handler))
47
+ invalidClaudeSettings();
48
+ }
49
+ }
50
+ }
51
+ function validateSettings(value) {
52
+ if (!isObject(value))
53
+ invalidClaudeSettings();
54
+ if (value.hooks === undefined)
55
+ return;
56
+ if (!isObject(value.hooks))
57
+ invalidClaudeSettings();
58
+ for (const groups of Object.values(value.hooks))
59
+ validateHookGroups(groups);
60
+ }
61
+ function hasLegacyIdentityPart(handler) {
62
+ if (handler.server === 'kiokuko'
63
+ || handler.tool === 'claude_prompt_context'
64
+ || handler.statusMessage === LEGACY_HOOK_STATUS)
65
+ return true;
66
+ if (!isObject(handler.input))
67
+ return false;
68
+ const inputMatches = [
69
+ handler.input.prompt === LEGACY_HOOK_INPUT.prompt,
70
+ handler.input.cwd === LEGACY_HOOK_INPUT.cwd,
71
+ handler.input.sessionId === LEGACY_HOOK_INPUT.sessionId,
72
+ ].filter(Boolean).length;
73
+ return inputMatches >= 2
74
+ || (handler.type === 'mcp_tool' && handler.timeout === 5 && inputMatches >= 1);
75
+ }
76
+ function isCanonicalLegacyHook(handler) {
77
+ const keys = Object.keys(handler).sort();
78
+ if (keys.join('\0') !== ['input', 'server', 'statusMessage', 'timeout', 'tool', 'type'].sort().join('\0'))
79
+ return false;
80
+ if (handler.type !== 'mcp_tool'
81
+ || handler.server !== 'kiokuko'
82
+ || handler.tool !== 'claude_prompt_context'
83
+ || handler.timeout !== 5
84
+ || handler.statusMessage !== LEGACY_HOOK_STATUS
85
+ || !isObject(handler.input))
86
+ return false;
87
+ const inputKeys = Object.keys(handler.input).sort();
88
+ return inputKeys.join('\0') === Object.keys(LEGACY_HOOK_INPUT).sort().join('\0')
89
+ && handler.input.prompt === LEGACY_HOOK_INPUT.prompt
90
+ && handler.input.cwd === LEGACY_HOOK_INPUT.cwd
91
+ && handler.input.sessionId === LEGACY_HOOK_INPUT.sessionId;
92
+ }
93
+ function formattingOptions(source) {
94
+ const indentation = source.match(/^([ \t]+)(?=["}])/mu)?.[1];
95
+ const eol = source.includes('\r\n') ? '\r\n' : '\n';
96
+ if (indentation?.includes('\t'))
97
+ return { insertSpaces: false, tabSize: 1, eol };
98
+ return { insertSpaces: true, tabSize: indentation?.length || 2, eol };
99
+ }
100
+ /** Remove one exact hook written by the retired Claude integration. */
101
+ export function cleanupLegacyClaudePromptHook(source) {
102
+ assertStrictJsonSyntax(source, { allowTrailingComma: false, disallowComments: true }, 'Claude settings are not a valid JSON object with unique keys');
103
+ const errors = [];
104
+ const parsed = parse(source, errors, { allowTrailingComma: false, disallowComments: true });
105
+ if (errors.length > 0)
106
+ invalidClaudeSettings();
107
+ validateSettings(parsed);
108
+ const hooks = parsed.hooks;
109
+ const matches = [];
110
+ for (const [event, groupsValue] of Object.entries(hooks ?? {})) {
111
+ const groups = groupsValue;
112
+ groups.forEach((group, groupIndex) => {
113
+ group.hooks.forEach((handler, handlerIndex) => {
114
+ if (!hasLegacyIdentityPart(handler))
115
+ return;
116
+ if (event !== CLAUDE_HOOK_EVENT || !isCanonicalLegacyHook(handler))
117
+ legacyClaudeHookConflict();
118
+ matches.push({ event, groupIndex, handlerIndex });
119
+ });
120
+ });
121
+ }
122
+ if (matches.length === 0)
123
+ return source;
124
+ if (matches.length !== 1)
125
+ legacyClaudeHookConflict();
126
+ const groups = (hooks?.[CLAUDE_HOOK_EVENT]).map((group) => ({
127
+ ...group,
128
+ hooks: [...group.hooks],
129
+ }));
130
+ const match = matches[0];
131
+ const group = groups[match.groupIndex];
132
+ group.hooks.splice(match.handlerIndex, 1);
133
+ if (group.hooks.length === 0 && Object.keys(group).length === 1) {
134
+ groups.splice(match.groupIndex, 1);
135
+ }
136
+ const edits = modify(source, ['hooks', CLAUDE_HOOK_EVENT], groups.length === 0 ? undefined : groups, {
137
+ formattingOptions: formattingOptions(source),
138
+ });
139
+ return applyEdits(source, edits);
140
+ }
141
+ /** Accept only byte-exact files emitted by the retired OpenCode guard renderer. */
142
+ export function assertExactLegacyOpenCodeLoopGuard(source) {
143
+ if (!source.startsWith(`${LEGACY_OPENCODE_LOOP_GUARD_MARKER}\n`)
144
+ && !source.startsWith(`${LEGACY_OPENCODE_LOOP_GUARD_MARKER}\r\n`)) {
145
+ throw new KiokukoError('CONFLICT', 'The retired OpenCode Kiokuko plugin path contains an unmanaged file; move or remove it before running setup');
146
+ }
147
+ const digest = createHash('sha256').update(source).digest('hex');
148
+ if (!LEGACY_OPENCODE_LOOP_GUARD_SHA256.has(digest)) {
149
+ throw new KiokukoError('CONFLICT', 'The retired OpenCode Kiokuko plugin was modified; move or remove it before running setup');
150
+ }
151
+ }
152
+ //# sourceMappingURL=legacy-client-cleanup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-client-cleanup.js","sourceRoot":"","sources":["../../src/setup/legacy-client-cleanup.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAiBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CAsBtB"}
1
+ {"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAwBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CA0BtB"}
@@ -10,13 +10,23 @@ function positions(content, marker) {
10
10
  offset = position + marker.length;
11
11
  }
12
12
  }
13
+ function isStandaloneMarker(content, marker, position) {
14
+ const before = position === 0 ? '' : content[position - 1];
15
+ const after = content.slice(position + marker.length, position + marker.length + 2);
16
+ return (position === 0 || before === '\n')
17
+ && (position + marker.length === content.length || after.startsWith('\n') || after === '\r\n');
18
+ }
13
19
  function eolFor(content) {
14
20
  return content.includes('\r\n') ? '\r\n' : '\n';
15
21
  }
16
22
  export function upsertDelimitedBlock(existing, block, beginMarker, endMarker, label) {
17
23
  const begins = positions(existing, beginMarker);
18
24
  const ends = positions(existing, endMarker);
19
- if ((begins.length === 0) !== (ends.length === 0) || begins.length > 1 || ends.length > 1) {
25
+ if ((begins.length === 0) !== (ends.length === 0)
26
+ || begins.length > 1
27
+ || ends.length > 1
28
+ || (begins[0] !== undefined && !isStandaloneMarker(existing, beginMarker, begins[0]))
29
+ || (ends[0] !== undefined && !isStandaloneMarker(existing, endMarker, ends[0]))) {
20
30
  throw new KiokukoError('VALIDATION_ERROR', `${label} contains malformed Kiokuko managed markers`);
21
31
  }
22
32
  const eol = eolFor(existing);
@@ -1 +1 @@
1
- {"version":3,"file":"managed-text.js","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"managed-text.js","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import type { SkillDiscoveryMode } from '../skills/types.js';
1
2
  import type { DelimitedBlockResult } from './managed-text.js';
2
- export declare function renderOpenCodeConfig(existing: string | undefined, command?: string): DelimitedBlockResult;
3
+ export declare function renderOpenCodeConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode): DelimitedBlockResult;
3
4
  //# sourceMappingURL=opencode-config.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,GAAG,oBAAoB,CAsB5G"}
1
+ {"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAwC9D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,SAAY,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAuCrJ"}
@@ -1,19 +1,71 @@
1
1
  import { applyEdits, modify, parse } from 'jsonc-parser';
2
2
  import { KiokukoError } from '../errors.js';
3
- export function renderOpenCodeConfig(existing, command = 'kiokuko') {
4
- const source = existing === undefined || existing.trim().length === 0
5
- ? '{\n "$schema": "https://opencode.ai/config.json"\n}\n'
6
- : existing;
3
+ import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
4
+ import { assertStrictJsonSyntax } from './strict-json.js';
5
+ function object(value) {
6
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
7
+ ? value
8
+ : undefined;
9
+ }
10
+ function hasExactKeys(value, expected) {
11
+ const keys = Object.keys(value);
12
+ return keys.length === expected.length && expected.every((key) => keys.includes(key));
13
+ }
14
+ function isNonEmptyCommand(value) {
15
+ return typeof value === 'string' && value.trim().length > 0 && !value.includes('\0');
16
+ }
17
+ function isCanonicalManagedServer(value) {
18
+ const server = object(value);
19
+ if (server === undefined || !hasExactKeys(server, ['type', 'command', 'enabled', 'environment']))
20
+ return false;
21
+ if (server.type !== 'local' || server.enabled !== true)
22
+ return false;
23
+ if (!Array.isArray(server.command)
24
+ || server.command.length !== 2
25
+ || !isNonEmptyCommand(server.command[0])
26
+ || server.command[1] !== 'mcp')
27
+ return false;
28
+ const environment = object(server.environment);
29
+ return environment !== undefined
30
+ && hasExactKeys(environment, [SKILL_DISCOVERY_ENV])
31
+ && isSkillDiscoveryMode(environment[SKILL_DISCOVERY_ENV]);
32
+ }
33
+ function validation(message) {
34
+ throw new KiokukoError('VALIDATION_ERROR', message);
35
+ }
36
+ function conflict() {
37
+ throw new KiokukoError('CONFLICT', 'OpenCode config already contains a conflicting kiokuko MCP server');
38
+ }
39
+ export function renderOpenCodeConfig(existing, command = 'kiokuko', skillDiscoveryMode) {
40
+ if (!isNonEmptyCommand(command))
41
+ validation('OpenCode MCP command must be a non-empty executable path or name');
42
+ if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
43
+ validation('OpenCode Skill discovery mode is invalid');
44
+ }
45
+ const source = existing ?? '{\n "$schema": "https://opencode.ai/config.json"\n}\n';
46
+ assertStrictJsonSyntax(source, { allowTrailingComma: true, disallowComments: false }, 'OpenCode config is not a valid JSON/JSONC object with unique keys');
7
47
  const errors = [];
8
48
  const parsed = parse(source, errors, { allowTrailingComma: true, disallowComments: false });
9
49
  if (errors.length > 0 || typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
10
- throw new KiokukoError('VALIDATION_ERROR', 'OpenCode config is not a valid JSON/JSONC object');
50
+ validation('OpenCode config is not a valid JSON/JSONC object');
11
51
  }
52
+ const root = parsed;
53
+ const mcp = object(root.mcp);
54
+ if (root.mcp !== undefined && mcp === undefined)
55
+ validation('OpenCode config has an invalid mcp object');
56
+ const currentServer = mcp?.kiokuko;
57
+ if (currentServer !== undefined && !isCanonicalManagedServer(currentServer))
58
+ conflict();
59
+ const currentEnvironment = currentServer === undefined ? undefined : object(currentServer.environment);
60
+ const effectiveSkillDiscoveryMode = skillDiscoveryMode
61
+ ?? currentEnvironment?.[SKILL_DISCOVERY_ENV]
62
+ ?? 'official';
12
63
  const eol = source.includes('\r\n') ? '\r\n' : '\n';
13
64
  const edits = modify(source, ['mcp', 'kiokuko'], {
14
65
  type: 'local',
15
66
  command: [command, 'mcp'],
16
67
  enabled: true,
68
+ environment: { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode },
17
69
  }, {
18
70
  formattingOptions: { insertSpaces: true, tabSize: 2, eol },
19
71
  });
@@ -1 +1 @@
1
- {"version":3,"file":"opencode-config.js","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAmB,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,OAAO,GAAG,SAAS;IACpF,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QACnE,CAAC,CAAC,wDAAwD;QAC1D,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,kDAAkD,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE;QAC/C,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;QACzB,OAAO,EAAE,IAAI;KACd,EAAE;QACD,iBAAiB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE;KAC3D,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO;QACP,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC5F,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"opencode-config.js","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAmB,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAA8B,EAAE,QAA2B;IAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/G,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;WAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;WAC3B,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;WACrC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,WAAW,KAAK,SAAS;WAC3B,YAAY,CAAC,WAAW,EAAE,CAAC,mBAAmB,CAAC,CAAC;WAChD,oBAAoB,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ;IACf,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,mEAAmE,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA4B,EAAE,OAAO,GAAG,SAAS,EAAE,kBAAuC;IAC7H,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;QAAE,UAAU,CAAC,kEAAkE,CAAC,CAAC;IAChH,IAAI,kBAAkB,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClF,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,IAAI,wDAAwD,CAAC;IACpF,sBAAsB,CACpB,MAAM,EACN,EAAE,kBAAkB,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,EACrD,mEAAmE,CACpE,CAAC;IACF,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChG,UAAU,CAAC,kDAAkD,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,MAAiC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,2CAA2C,CAAC,CAAC;IACzG,MAAM,aAAa,GAAG,GAAG,EAAE,OAAO,CAAC;IACnC,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,CAAC;IACxF,MAAM,kBAAkB,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;IACvG,MAAM,2BAA2B,GAAG,kBAAkB;WAChD,kBAAkB,EAAE,CAAC,mBAAmB,CAAoC;WAC7E,UAAU,CAAC;IAChB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE;QAC/C,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;QACzB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,2BAA2B,EAAE;KACpE,EAAE;QACD,iBAAiB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE;KAC3D,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO;QACP,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC5F,CAAC;AACJ,CAAC"}
@@ -1,8 +1,9 @@
1
+ import type { SkillDiscoveryMode } from '../skills/types.js';
1
2
  import { type DelimitedBlockResult } from './managed-text.js';
2
3
  export declare const GLOBAL_INSTRUCTIONS_BEGIN = "<!-- BEGIN KIOKUKO GLOBAL MEMORY -->";
3
4
  export declare const GLOBAL_INSTRUCTIONS_END = "<!-- END KIOKUKO GLOBAL MEMORY -->";
4
5
  export declare const CODEX_MCP_BEGIN = "# BEGIN KIOKUKO MCP";
5
6
  export declare const CODEX_MCP_END = "# END KIOKUKO MCP";
6
7
  export declare function renderGlobalInstructions(existing?: string): DelimitedBlockResult;
7
- export declare function renderCodexMcpConfig(existing?: string, command?: string): DelimitedBlockResult;
8
+ export declare function renderCodexMcpConfig(existing?: string, command?: string, skillDiscoveryMode?: SkillDiscoveryMode): DelimitedBlockResult;
8
9
  //# sourceMappingURL=render.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/setup/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpF,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAChF,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAC5E,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD,wBAAgB,wBAAwB,CAAC,QAAQ,SAAK,GAAG,oBAAoB,CA4B5E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,SAAK,EAAE,OAAO,SAAY,GAAG,oBAAoB,CAe7F"}
1
+ {"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/setup/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGpF,eAAO,MAAM,yBAAyB,yCAAyC,CAAC;AAChF,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAC5E,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD,wBAAgB,wBAAwB,CAAC,QAAQ,SAAK,GAAG,oBAAoB,CA6B5E;AA8ED,wBAAgB,oBAAoB,CAAC,QAAQ,SAAK,EAAE,OAAO,SAAY,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAsBtI"}