openryoko 2026.10.9 → 2026.10.13

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 (669) hide show
  1. package/dist/bin/jimmy.js +51 -1
  2. package/dist/bin/jimmy.js.map +1 -1
  3. package/dist/package.json +2 -1
  4. package/dist/src/backup/archive.d.ts +65 -0
  5. package/dist/src/backup/archive.d.ts.map +1 -0
  6. package/dist/src/backup/archive.js +214 -0
  7. package/dist/src/backup/archive.js.map +1 -0
  8. package/dist/src/backup/catalog.d.ts +64 -0
  9. package/dist/src/backup/catalog.d.ts.map +1 -0
  10. package/dist/src/backup/catalog.js +252 -0
  11. package/dist/src/backup/catalog.js.map +1 -0
  12. package/dist/src/backup/database-restore.d.ts +63 -0
  13. package/dist/src/backup/database-restore.d.ts.map +1 -0
  14. package/dist/src/backup/database-restore.js +236 -0
  15. package/dist/src/backup/database-restore.js.map +1 -0
  16. package/dist/src/backup/database-source.d.ts +70 -0
  17. package/dist/src/backup/database-source.d.ts.map +1 -0
  18. package/dist/src/backup/database-source.js +70 -0
  19. package/dist/src/backup/database-source.js.map +1 -0
  20. package/dist/src/backup/format.d.ts +4 -0
  21. package/dist/src/backup/format.d.ts.map +1 -0
  22. package/dist/src/backup/format.js +15 -0
  23. package/dist/src/backup/format.js.map +1 -0
  24. package/dist/src/backup/gateway-liveness.d.ts +44 -0
  25. package/dist/src/backup/gateway-liveness.d.ts.map +1 -0
  26. package/dist/src/backup/gateway-liveness.js +120 -0
  27. package/dist/src/backup/gateway-liveness.js.map +1 -0
  28. package/dist/src/backup/inspect.d.ts +45 -0
  29. package/dist/src/backup/inspect.d.ts.map +1 -0
  30. package/dist/src/backup/inspect.js +291 -0
  31. package/dist/src/backup/inspect.js.map +1 -0
  32. package/dist/src/backup/layout.d.ts +11 -0
  33. package/dist/src/backup/layout.d.ts.map +1 -0
  34. package/dist/src/backup/layout.js +16 -0
  35. package/dist/src/backup/layout.js.map +1 -0
  36. package/dist/src/backup/limits.d.ts +54 -0
  37. package/dist/src/backup/limits.d.ts.map +1 -0
  38. package/dist/src/backup/limits.js +59 -0
  39. package/dist/src/backup/limits.js.map +1 -0
  40. package/dist/src/backup/manifest.d.ts +45 -0
  41. package/dist/src/backup/manifest.d.ts.map +1 -0
  42. package/dist/src/backup/manifest.js +77 -0
  43. package/dist/src/backup/manifest.js.map +1 -0
  44. package/dist/src/backup/restore.d.ts +73 -0
  45. package/dist/src/backup/restore.d.ts.map +1 -0
  46. package/dist/src/backup/restore.js +685 -0
  47. package/dist/src/backup/restore.js.map +1 -0
  48. package/dist/src/backup/run.d.ts +76 -0
  49. package/dist/src/backup/run.d.ts.map +1 -0
  50. package/dist/src/backup/run.js +181 -0
  51. package/dist/src/backup/run.js.map +1 -0
  52. package/dist/src/backup/scheduler.d.ts +51 -0
  53. package/dist/src/backup/scheduler.d.ts.map +1 -0
  54. package/dist/src/backup/scheduler.js +198 -0
  55. package/dist/src/backup/scheduler.js.map +1 -0
  56. package/dist/src/backup/settings.d.ts +44 -0
  57. package/dist/src/backup/settings.d.ts.map +1 -0
  58. package/dist/src/backup/settings.js +91 -0
  59. package/dist/src/backup/settings.js.map +1 -0
  60. package/dist/src/backup/space.d.ts +22 -0
  61. package/dist/src/backup/space.d.ts.map +1 -0
  62. package/dist/src/backup/space.js +47 -0
  63. package/dist/src/backup/space.js.map +1 -0
  64. package/dist/src/backup/state.d.ts +46 -0
  65. package/dist/src/backup/state.d.ts.map +1 -0
  66. package/dist/src/backup/state.js +137 -0
  67. package/dist/src/backup/state.js.map +1 -0
  68. package/dist/src/backup/tar.d.ts +64 -0
  69. package/dist/src/backup/tar.d.ts.map +1 -0
  70. package/dist/src/backup/tar.js +274 -0
  71. package/dist/src/backup/tar.js.map +1 -0
  72. package/dist/src/backup/targets.d.ts +85 -0
  73. package/dist/src/backup/targets.d.ts.map +1 -0
  74. package/dist/src/backup/targets.js +104 -0
  75. package/dist/src/backup/targets.js.map +1 -0
  76. package/dist/src/backup/walk.d.ts +42 -0
  77. package/dist/src/backup/walk.d.ts.map +1 -0
  78. package/dist/src/backup/walk.js +324 -0
  79. package/dist/src/backup/walk.js.map +1 -0
  80. package/dist/src/cli/backup.d.ts +45 -0
  81. package/dist/src/cli/backup.d.ts.map +1 -0
  82. package/dist/src/cli/backup.js +344 -0
  83. package/dist/src/cli/backup.js.map +1 -0
  84. package/dist/src/cli/bundled-skills.d.ts +7 -1
  85. package/dist/src/cli/bundled-skills.d.ts.map +1 -1
  86. package/dist/src/cli/bundled-skills.js +12 -2
  87. package/dist/src/cli/bundled-skills.js.map +1 -1
  88. package/dist/src/cli/config-failure.d.ts +18 -0
  89. package/dist/src/cli/config-failure.d.ts.map +1 -0
  90. package/dist/src/cli/config-failure.js +39 -0
  91. package/dist/src/cli/config-failure.js.map +1 -0
  92. package/dist/src/cli/gateway-audit.d.ts +3 -0
  93. package/dist/src/cli/gateway-audit.d.ts.map +1 -1
  94. package/dist/src/cli/gateway-audit.js +61 -14
  95. package/dist/src/cli/gateway-audit.js.map +1 -1
  96. package/dist/src/cli/gateway-url-backup.d.ts +21 -0
  97. package/dist/src/cli/gateway-url-backup.d.ts.map +1 -0
  98. package/dist/src/cli/gateway-url-backup.js +87 -0
  99. package/dist/src/cli/gateway-url-backup.js.map +1 -0
  100. package/dist/src/cli/home-copy.d.ts +37 -0
  101. package/dist/src/cli/home-copy.d.ts.map +1 -0
  102. package/dist/src/cli/home-copy.js +155 -0
  103. package/dist/src/cli/home-copy.js.map +1 -0
  104. package/dist/src/cli/interactive-config.d.ts +5 -0
  105. package/dist/src/cli/interactive-config.d.ts.map +1 -1
  106. package/dist/src/cli/interactive-config.js +16 -7
  107. package/dist/src/cli/interactive-config.js.map +1 -1
  108. package/dist/src/cli/migrate.d.ts +16 -0
  109. package/dist/src/cli/migrate.d.ts.map +1 -1
  110. package/dist/src/cli/migrate.js +358 -69
  111. package/dist/src/cli/migrate.js.map +1 -1
  112. package/dist/src/cli/migration-declarations.d.ts +24 -0
  113. package/dist/src/cli/migration-declarations.d.ts.map +1 -0
  114. package/dist/src/cli/migration-declarations.js +54 -0
  115. package/dist/src/cli/migration-declarations.js.map +1 -0
  116. package/dist/src/cli/start.d.ts.map +1 -1
  117. package/dist/src/cli/start.js +40 -1
  118. package/dist/src/cli/start.js.map +1 -1
  119. package/dist/src/connectors/chunked-send.d.ts +27 -0
  120. package/dist/src/connectors/chunked-send.d.ts.map +1 -0
  121. package/dist/src/connectors/chunked-send.js +40 -0
  122. package/dist/src/connectors/chunked-send.js.map +1 -0
  123. package/dist/src/connectors/cron/index.d.ts +10 -0
  124. package/dist/src/connectors/cron/index.d.ts.map +1 -1
  125. package/dist/src/connectors/cron/index.js +26 -3
  126. package/dist/src/connectors/cron/index.js.map +1 -1
  127. package/dist/src/connectors/discord/attachments.d.ts +25 -0
  128. package/dist/src/connectors/discord/attachments.d.ts.map +1 -0
  129. package/dist/src/connectors/discord/attachments.js +33 -0
  130. package/dist/src/connectors/discord/attachments.js.map +1 -0
  131. package/dist/src/connectors/discord/format.d.ts +17 -1
  132. package/dist/src/connectors/discord/format.d.ts.map +1 -1
  133. package/dist/src/connectors/discord/format.js +36 -6
  134. package/dist/src/connectors/discord/format.js.map +1 -1
  135. package/dist/src/connectors/discord/index.d.ts +12 -0
  136. package/dist/src/connectors/discord/index.d.ts.map +1 -1
  137. package/dist/src/connectors/discord/index.js +47 -40
  138. package/dist/src/connectors/discord/index.js.map +1 -1
  139. package/dist/src/connectors/discord/remote.d.ts +45 -1
  140. package/dist/src/connectors/discord/remote.d.ts.map +1 -1
  141. package/dist/src/connectors/discord/remote.js +147 -22
  142. package/dist/src/connectors/discord/remote.js.map +1 -1
  143. package/dist/src/connectors/slack/attachments.d.ts +25 -0
  144. package/dist/src/connectors/slack/attachments.d.ts.map +1 -0
  145. package/dist/src/connectors/slack/attachments.js +32 -0
  146. package/dist/src/connectors/slack/attachments.js.map +1 -0
  147. package/dist/src/connectors/slack/auth-test-cache.d.ts +22 -0
  148. package/dist/src/connectors/slack/auth-test-cache.d.ts.map +1 -0
  149. package/dist/src/connectors/slack/auth-test-cache.js +34 -0
  150. package/dist/src/connectors/slack/auth-test-cache.js.map +1 -0
  151. package/dist/src/connectors/slack/format.d.ts +6 -1
  152. package/dist/src/connectors/slack/format.d.ts.map +1 -1
  153. package/dist/src/connectors/slack/format.js +65 -13
  154. package/dist/src/connectors/slack/format.js.map +1 -1
  155. package/dist/src/connectors/slack/index.d.ts +4 -0
  156. package/dist/src/connectors/slack/index.d.ts.map +1 -1
  157. package/dist/src/connectors/slack/index.js +64 -52
  158. package/dist/src/connectors/slack/index.js.map +1 -1
  159. package/dist/src/connectors/slack/provider-auth-blocks.d.ts +62 -0
  160. package/dist/src/connectors/slack/provider-auth-blocks.d.ts.map +1 -0
  161. package/dist/src/connectors/slack/provider-auth-blocks.js +204 -0
  162. package/dist/src/connectors/slack/provider-auth-blocks.js.map +1 -0
  163. package/dist/src/connectors/slack/provider-auth.d.ts +126 -0
  164. package/dist/src/connectors/slack/provider-auth.d.ts.map +1 -0
  165. package/dist/src/connectors/slack/provider-auth.js +357 -0
  166. package/dist/src/connectors/slack/provider-auth.js.map +1 -0
  167. package/dist/src/connectors/telegram/index.d.ts +5 -0
  168. package/dist/src/connectors/telegram/index.d.ts.map +1 -1
  169. package/dist/src/connectors/telegram/index.js +14 -22
  170. package/dist/src/connectors/telegram/index.js.map +1 -1
  171. package/dist/src/connectors/whatsapp/index.d.ts +3 -0
  172. package/dist/src/connectors/whatsapp/index.d.ts.map +1 -1
  173. package/dist/src/connectors/whatsapp/index.js +33 -14
  174. package/dist/src/connectors/whatsapp/index.js.map +1 -1
  175. package/dist/src/cron/alert-throttle.d.ts +28 -0
  176. package/dist/src/cron/alert-throttle.d.ts.map +1 -0
  177. package/dist/src/cron/alert-throttle.js +106 -0
  178. package/dist/src/cron/alert-throttle.js.map +1 -0
  179. package/dist/src/cron/jobs.d.ts +8 -0
  180. package/dist/src/cron/jobs.d.ts.map +1 -1
  181. package/dist/src/cron/jobs.js +27 -1
  182. package/dist/src/cron/jobs.js.map +1 -1
  183. package/dist/src/cron/run-outcome.d.ts +28 -0
  184. package/dist/src/cron/run-outcome.d.ts.map +1 -0
  185. package/dist/src/cron/run-outcome.js +66 -0
  186. package/dist/src/cron/run-outcome.js.map +1 -0
  187. package/dist/src/cron/runner.d.ts.map +1 -1
  188. package/dist/src/cron/runner.js +68 -5
  189. package/dist/src/cron/runner.js.map +1 -1
  190. package/dist/src/cron/scheduler.d.ts +8 -1
  191. package/dist/src/cron/scheduler.d.ts.map +1 -1
  192. package/dist/src/cron/scheduler.js +11 -4
  193. package/dist/src/cron/scheduler.js.map +1 -1
  194. package/dist/src/cron/waiting-fires.d.ts +18 -0
  195. package/dist/src/cron/waiting-fires.d.ts.map +1 -0
  196. package/dist/src/cron/waiting-fires.js +49 -0
  197. package/dist/src/cron/waiting-fires.js.map +1 -0
  198. package/dist/src/engines/claude-interactive.d.ts +15 -2
  199. package/dist/src/engines/claude-interactive.d.ts.map +1 -1
  200. package/dist/src/engines/claude-interactive.js +32 -11
  201. package/dist/src/engines/claude-interactive.js.map +1 -1
  202. package/dist/src/engines/claude.d.ts.map +1 -1
  203. package/dist/src/engines/claude.js +37 -5
  204. package/dist/src/engines/claude.js.map +1 -1
  205. package/dist/src/engines/codex.d.ts.map +1 -1
  206. package/dist/src/engines/codex.js +1 -0
  207. package/dist/src/engines/codex.js.map +1 -1
  208. package/dist/src/engines/gemini.d.ts.map +1 -1
  209. package/dist/src/engines/gemini.js +1 -0
  210. package/dist/src/engines/gemini.js.map +1 -1
  211. package/dist/src/gateway/api.d.ts.map +1 -1
  212. package/dist/src/gateway/api.js +182 -150
  213. package/dist/src/gateway/api.js.map +1 -1
  214. package/dist/src/gateway/config-redaction.d.ts +32 -0
  215. package/dist/src/gateway/config-redaction.d.ts.map +1 -0
  216. package/dist/src/gateway/config-redaction.js +139 -0
  217. package/dist/src/gateway/config-redaction.js.map +1 -0
  218. package/dist/src/gateway/config-revision.d.ts +46 -0
  219. package/dist/src/gateway/config-revision.d.ts.map +1 -0
  220. package/dist/src/gateway/config-revision.js +63 -0
  221. package/dist/src/gateway/config-revision.js.map +1 -0
  222. package/dist/src/gateway/connector-config.d.ts +21 -0
  223. package/dist/src/gateway/connector-config.d.ts.map +1 -0
  224. package/dist/src/gateway/connector-config.js +24 -0
  225. package/dist/src/gateway/connector-config.js.map +1 -0
  226. package/dist/src/gateway/daemon-entry.js +5 -0
  227. package/dist/src/gateway/daemon-entry.js.map +1 -1
  228. package/dist/src/gateway/engine-health-monitor.d.ts +67 -0
  229. package/dist/src/gateway/engine-health-monitor.d.ts.map +1 -0
  230. package/dist/src/gateway/engine-health-monitor.js +221 -0
  231. package/dist/src/gateway/engine-health-monitor.js.map +1 -0
  232. package/dist/src/gateway/files.d.ts +7 -1
  233. package/dist/src/gateway/files.d.ts.map +1 -1
  234. package/dist/src/gateway/files.js +110 -217
  235. package/dist/src/gateway/files.js.map +1 -1
  236. package/dist/src/gateway/portal-config.d.ts +17 -3
  237. package/dist/src/gateway/portal-config.d.ts.map +1 -1
  238. package/dist/src/gateway/portal-config.js +52 -3
  239. package/dist/src/gateway/portal-config.js.map +1 -1
  240. package/dist/src/gateway/request-origin.d.ts +9 -0
  241. package/dist/src/gateway/request-origin.d.ts.map +1 -1
  242. package/dist/src/gateway/request-origin.js +10 -0
  243. package/dist/src/gateway/request-origin.js.map +1 -1
  244. package/dist/src/gateway/server.d.ts.map +1 -1
  245. package/dist/src/gateway/server.js +76 -59
  246. package/dist/src/gateway/server.js.map +1 -1
  247. package/dist/src/gateway/slack-connect-rollback.d.ts +23 -0
  248. package/dist/src/gateway/slack-connect-rollback.d.ts.map +1 -0
  249. package/dist/src/gateway/slack-connect-rollback.js +53 -0
  250. package/dist/src/gateway/slack-connect-rollback.js.map +1 -0
  251. package/dist/src/gateway/status-reconciler.d.ts +25 -7
  252. package/dist/src/gateway/status-reconciler.d.ts.map +1 -1
  253. package/dist/src/gateway/status-reconciler.js +86 -43
  254. package/dist/src/gateway/status-reconciler.js.map +1 -1
  255. package/dist/src/gateway/watcher.d.ts.map +1 -1
  256. package/dist/src/gateway/watcher.js +44 -3
  257. package/dist/src/gateway/watcher.js.map +1 -1
  258. package/dist/src/mcp/gateway-server.js +21 -3
  259. package/dist/src/mcp/gateway-server.js.map +1 -1
  260. package/dist/src/mcp/resolver.d.ts.map +1 -1
  261. package/dist/src/mcp/resolver.js +51 -1
  262. package/dist/src/mcp/resolver.js.map +1 -1
  263. package/dist/src/models/service.d.ts.map +1 -1
  264. package/dist/src/models/service.js +14 -8
  265. package/dist/src/models/service.js.map +1 -1
  266. package/dist/src/provider-auth/discovery.d.ts +16 -0
  267. package/dist/src/provider-auth/discovery.d.ts.map +1 -0
  268. package/dist/src/provider-auth/discovery.js +66 -0
  269. package/dist/src/provider-auth/discovery.js.map +1 -0
  270. package/dist/src/provider-auth/failure-notices.d.ts +29 -0
  271. package/dist/src/provider-auth/failure-notices.d.ts.map +1 -0
  272. package/dist/src/provider-auth/failure-notices.js +48 -0
  273. package/dist/src/provider-auth/failure-notices.js.map +1 -0
  274. package/dist/src/provider-auth/failure-signal.d.ts +22 -0
  275. package/dist/src/provider-auth/failure-signal.d.ts.map +1 -0
  276. package/dist/src/provider-auth/failure-signal.js +79 -0
  277. package/dist/src/provider-auth/failure-signal.js.map +1 -0
  278. package/dist/src/provider-auth/index.d.ts +26 -0
  279. package/dist/src/provider-auth/index.d.ts.map +1 -0
  280. package/dist/src/provider-auth/index.js +51 -0
  281. package/dist/src/provider-auth/index.js.map +1 -0
  282. package/dist/src/provider-auth/input.d.ts +44 -0
  283. package/dist/src/provider-auth/input.d.ts.map +1 -0
  284. package/dist/src/provider-auth/input.js +86 -0
  285. package/dist/src/provider-auth/input.js.map +1 -0
  286. package/dist/src/provider-auth/providers.d.ts +26 -0
  287. package/dist/src/provider-auth/providers.d.ts.map +1 -0
  288. package/dist/src/provider-auth/providers.js +86 -0
  289. package/dist/src/provider-auth/providers.js.map +1 -0
  290. package/dist/src/provider-auth/runtime.d.ts +21 -0
  291. package/dist/src/provider-auth/runtime.d.ts.map +1 -0
  292. package/dist/src/provider-auth/runtime.js +104 -0
  293. package/dist/src/provider-auth/runtime.js.map +1 -0
  294. package/dist/src/provider-auth/service.d.ts +70 -0
  295. package/dist/src/provider-auth/service.d.ts.map +1 -0
  296. package/dist/src/provider-auth/service.js +349 -0
  297. package/dist/src/provider-auth/service.js.map +1 -0
  298. package/dist/src/provider-auth/terminal.d.ts +21 -0
  299. package/dist/src/provider-auth/terminal.d.ts.map +1 -0
  300. package/dist/src/provider-auth/terminal.js +46 -0
  301. package/dist/src/provider-auth/terminal.js.map +1 -0
  302. package/dist/src/provider-auth/types.d.ts +123 -0
  303. package/dist/src/provider-auth/types.d.ts.map +1 -0
  304. package/dist/src/provider-auth/types.js +10 -0
  305. package/dist/src/provider-auth/types.js.map +1 -0
  306. package/dist/src/sessions/accounting.d.ts +3 -0
  307. package/dist/src/sessions/accounting.d.ts.map +1 -1
  308. package/dist/src/sessions/accounting.js +5 -0
  309. package/dist/src/sessions/accounting.js.map +1 -1
  310. package/dist/src/sessions/backup-integrity.d.ts +45 -0
  311. package/dist/src/sessions/backup-integrity.d.ts.map +1 -0
  312. package/dist/src/sessions/backup-integrity.js +122 -0
  313. package/dist/src/sessions/backup-integrity.js.map +1 -0
  314. package/dist/src/sessions/backup.d.ts +40 -2
  315. package/dist/src/sessions/backup.d.ts.map +1 -1
  316. package/dist/src/sessions/backup.js +88 -12
  317. package/dist/src/sessions/backup.js.map +1 -1
  318. package/dist/src/sessions/callbacks.d.ts +9 -0
  319. package/dist/src/sessions/callbacks.d.ts.map +1 -1
  320. package/dist/src/sessions/callbacks.js +55 -10
  321. package/dist/src/sessions/callbacks.js.map +1 -1
  322. package/dist/src/sessions/completion-batching.d.ts +82 -0
  323. package/dist/src/sessions/completion-batching.d.ts.map +1 -0
  324. package/dist/src/sessions/completion-batching.js +126 -0
  325. package/dist/src/sessions/completion-batching.js.map +1 -0
  326. package/dist/src/sessions/connector-command-guard.d.ts +66 -0
  327. package/dist/src/sessions/connector-command-guard.d.ts.map +1 -0
  328. package/dist/src/sessions/connector-command-guard.js +145 -0
  329. package/dist/src/sessions/connector-command-guard.js.map +1 -0
  330. package/dist/src/sessions/context.js +2 -2
  331. package/dist/src/sessions/engine-fallback.d.ts +43 -1
  332. package/dist/src/sessions/engine-fallback.d.ts.map +1 -1
  333. package/dist/src/sessions/engine-fallback.js +266 -15
  334. package/dist/src/sessions/engine-fallback.js.map +1 -1
  335. package/dist/src/sessions/engine-health-gate.d.ts +83 -0
  336. package/dist/src/sessions/engine-health-gate.d.ts.map +1 -0
  337. package/dist/src/sessions/engine-health-gate.js +186 -0
  338. package/dist/src/sessions/engine-health-gate.js.map +1 -0
  339. package/dist/src/sessions/engine-login.d.ts +58 -0
  340. package/dist/src/sessions/engine-login.d.ts.map +1 -0
  341. package/dist/src/sessions/engine-login.js +107 -0
  342. package/dist/src/sessions/engine-login.js.map +1 -0
  343. package/dist/src/sessions/fork.d.ts.map +1 -1
  344. package/dist/src/sessions/fork.js +2 -1
  345. package/dist/src/sessions/fork.js.map +1 -1
  346. package/dist/src/sessions/goal-execution.d.ts.map +1 -1
  347. package/dist/src/sessions/goal-execution.js +8 -1
  348. package/dist/src/sessions/goal-execution.js.map +1 -1
  349. package/dist/src/sessions/limit-failure-notice.d.ts +41 -0
  350. package/dist/src/sessions/limit-failure-notice.d.ts.map +1 -0
  351. package/dist/src/sessions/limit-failure-notice.js +87 -0
  352. package/dist/src/sessions/limit-failure-notice.js.map +1 -0
  353. package/dist/src/sessions/lost-turn.d.ts +39 -0
  354. package/dist/src/sessions/lost-turn.d.ts.map +1 -0
  355. package/dist/src/sessions/lost-turn.js +32 -0
  356. package/dist/src/sessions/lost-turn.js.map +1 -0
  357. package/dist/src/sessions/manager.d.ts.map +1 -1
  358. package/dist/src/sessions/manager.js +104 -47
  359. package/dist/src/sessions/manager.js.map +1 -1
  360. package/dist/src/sessions/new-session-engine.d.ts +42 -0
  361. package/dist/src/sessions/new-session-engine.d.ts.map +1 -0
  362. package/dist/src/sessions/new-session-engine.js +100 -0
  363. package/dist/src/sessions/new-session-engine.js.map +1 -0
  364. package/dist/src/sessions/origin-delivery.d.ts +50 -4
  365. package/dist/src/sessions/origin-delivery.d.ts.map +1 -1
  366. package/dist/src/sessions/origin-delivery.js +108 -9
  367. package/dist/src/sessions/origin-delivery.js.map +1 -1
  368. package/dist/src/sessions/queue.d.ts +14 -0
  369. package/dist/src/sessions/queue.d.ts.map +1 -1
  370. package/dist/src/sessions/queue.js +38 -2
  371. package/dist/src/sessions/queue.js.map +1 -1
  372. package/dist/src/sessions/registry.d.ts +4 -2
  373. package/dist/src/sessions/registry.d.ts.map +1 -1
  374. package/dist/src/sessions/registry.js +21 -4
  375. package/dist/src/sessions/registry.js.map +1 -1
  376. package/dist/src/sessions/reply-disposition.d.ts +8 -0
  377. package/dist/src/sessions/reply-disposition.d.ts.map +1 -1
  378. package/dist/src/sessions/reply-disposition.js +8 -0
  379. package/dist/src/sessions/reply-disposition.js.map +1 -1
  380. package/dist/src/sessions/restart-resume.d.ts +234 -0
  381. package/dist/src/sessions/restart-resume.d.ts.map +1 -0
  382. package/dist/src/sessions/restart-resume.js +596 -0
  383. package/dist/src/sessions/restart-resume.js.map +1 -0
  384. package/dist/src/sessions/speaker-prefix.d.ts.map +1 -1
  385. package/dist/src/sessions/speaker-prefix.js +3 -1
  386. package/dist/src/sessions/speaker-prefix.js.map +1 -1
  387. package/dist/src/sessions/turn-delivery.d.ts +26 -0
  388. package/dist/src/sessions/turn-delivery.d.ts.map +1 -0
  389. package/dist/src/sessions/turn-delivery.js +34 -0
  390. package/dist/src/sessions/turn-delivery.js.map +1 -0
  391. package/dist/src/sessions/unrequested-stop.d.ts +26 -0
  392. package/dist/src/sessions/unrequested-stop.d.ts.map +1 -0
  393. package/dist/src/sessions/unrequested-stop.js +19 -0
  394. package/dist/src/sessions/unrequested-stop.js.map +1 -0
  395. package/dist/src/sessions/usage-limit-wait.d.ts +14 -0
  396. package/dist/src/sessions/usage-limit-wait.d.ts.map +1 -0
  397. package/dist/src/sessions/usage-limit-wait.js +9 -0
  398. package/dist/src/sessions/usage-limit-wait.js.map +1 -0
  399. package/dist/src/shared/attachment-download.d.ts +41 -0
  400. package/dist/src/shared/attachment-download.d.ts.map +1 -0
  401. package/dist/src/shared/attachment-download.js +110 -0
  402. package/dist/src/shared/attachment-download.js.map +1 -0
  403. package/dist/src/shared/attachment-notice.d.ts +24 -0
  404. package/dist/src/shared/attachment-notice.d.ts.map +1 -0
  405. package/dist/src/shared/attachment-notice.js +37 -0
  406. package/dist/src/shared/attachment-notice.js.map +1 -0
  407. package/dist/src/shared/attachments.d.ts +65 -0
  408. package/dist/src/shared/attachments.d.ts.map +1 -0
  409. package/dist/src/shared/attachments.js +153 -0
  410. package/dist/src/shared/attachments.js.map +1 -0
  411. package/dist/src/shared/childEnv.d.ts +15 -0
  412. package/dist/src/shared/childEnv.d.ts.map +1 -1
  413. package/dist/src/shared/childEnv.js +15 -0
  414. package/dist/src/shared/childEnv.js.map +1 -1
  415. package/dist/src/shared/claude-limit-reset.d.ts +54 -0
  416. package/dist/src/shared/claude-limit-reset.d.ts.map +1 -0
  417. package/dist/src/shared/claude-limit-reset.js +99 -0
  418. package/dist/src/shared/claude-limit-reset.js.map +1 -0
  419. package/dist/src/shared/config-error.d.ts +21 -0
  420. package/dist/src/shared/config-error.d.ts.map +1 -0
  421. package/dist/src/shared/config-error.js +37 -0
  422. package/dist/src/shared/config-error.js.map +1 -0
  423. package/dist/src/shared/config-file.d.ts +57 -0
  424. package/dist/src/shared/config-file.d.ts.map +1 -0
  425. package/dist/src/shared/config-file.js +217 -0
  426. package/dist/src/shared/config-file.js.map +1 -0
  427. package/dist/src/shared/config-yaml-edit.d.ts +20 -0
  428. package/dist/src/shared/config-yaml-edit.d.ts.map +1 -0
  429. package/dist/src/shared/config-yaml-edit.js +468 -0
  430. package/dist/src/shared/config-yaml-edit.js.map +1 -0
  431. package/dist/src/shared/config.d.ts.map +1 -1
  432. package/dist/src/shared/config.js +12 -4
  433. package/dist/src/shared/config.js.map +1 -1
  434. package/dist/src/shared/engine-fallback.d.ts +22 -0
  435. package/dist/src/shared/engine-fallback.d.ts.map +1 -1
  436. package/dist/src/shared/engine-fallback.js +55 -4
  437. package/dist/src/shared/engine-fallback.js.map +1 -1
  438. package/dist/src/shared/engine-health.d.ts +16 -0
  439. package/dist/src/shared/engine-health.d.ts.map +1 -1
  440. package/dist/src/shared/engine-health.js +42 -0
  441. package/dist/src/shared/engine-health.js.map +1 -1
  442. package/dist/src/shared/list-alignment.d.ts +23 -0
  443. package/dist/src/shared/list-alignment.d.ts.map +1 -0
  444. package/dist/src/shared/list-alignment.js +61 -0
  445. package/dist/src/shared/list-alignment.js.map +1 -0
  446. package/dist/src/shared/logger.d.ts.map +1 -1
  447. package/dist/src/shared/logger.js +104 -33
  448. package/dist/src/shared/logger.js.map +1 -1
  449. package/dist/src/shared/map-limited.d.ts +11 -0
  450. package/dist/src/shared/map-limited.d.ts.map +1 -0
  451. package/dist/src/shared/map-limited.js +30 -0
  452. package/dist/src/shared/map-limited.js.map +1 -0
  453. package/dist/src/shared/oneShotCli.d.ts.map +1 -1
  454. package/dist/src/shared/oneShotCli.js +4 -2
  455. package/dist/src/shared/oneShotCli.js.map +1 -1
  456. package/dist/src/shared/partial-delivery.d.ts +24 -0
  457. package/dist/src/shared/partial-delivery.d.ts.map +1 -0
  458. package/dist/src/shared/partial-delivery.js +46 -0
  459. package/dist/src/shared/partial-delivery.js.map +1 -0
  460. package/dist/src/shared/process-safety-net.d.ts +44 -0
  461. package/dist/src/shared/process-safety-net.d.ts.map +1 -0
  462. package/dist/src/shared/process-safety-net.js +88 -0
  463. package/dist/src/shared/process-safety-net.js.map +1 -0
  464. package/dist/src/shared/rateLimit.d.ts +45 -2
  465. package/dist/src/shared/rateLimit.d.ts.map +1 -1
  466. package/dist/src/shared/rateLimit.js +64 -2
  467. package/dist/src/shared/rateLimit.js.map +1 -1
  468. package/dist/src/shared/redact.d.ts.map +1 -1
  469. package/dist/src/shared/redact.js +11 -1
  470. package/dist/src/shared/redact.js.map +1 -1
  471. package/dist/src/shared/safe-file-name.d.ts +9 -0
  472. package/dist/src/shared/safe-file-name.d.ts.map +1 -0
  473. package/dist/src/shared/safe-file-name.js +16 -0
  474. package/dist/src/shared/safe-file-name.js.map +1 -0
  475. package/dist/src/shared/terminal-safe-text.d.ts +2 -0
  476. package/dist/src/shared/terminal-safe-text.d.ts.map +1 -0
  477. package/dist/src/shared/terminal-safe-text.js +21 -0
  478. package/dist/src/shared/terminal-safe-text.js.map +1 -0
  479. package/dist/src/shared/types.d.ts +69 -4
  480. package/dist/src/shared/types.d.ts.map +1 -1
  481. package/dist/src/skills-sync/apply.d.ts +21 -0
  482. package/dist/src/skills-sync/apply.d.ts.map +1 -0
  483. package/dist/src/skills-sync/apply.js +209 -0
  484. package/dist/src/skills-sync/apply.js.map +1 -0
  485. package/dist/src/skills-sync/backup-run.d.ts +47 -0
  486. package/dist/src/skills-sync/backup-run.d.ts.map +1 -0
  487. package/dist/src/skills-sync/backup-run.js +150 -0
  488. package/dist/src/skills-sync/backup-run.js.map +1 -0
  489. package/dist/src/skills-sync/bounded-read.d.ts +32 -0
  490. package/dist/src/skills-sync/bounded-read.d.ts.map +1 -0
  491. package/dist/src/skills-sync/bounded-read.js +104 -0
  492. package/dist/src/skills-sync/bounded-read.js.map +1 -0
  493. package/dist/src/skills-sync/bundled.d.ts +28 -0
  494. package/dist/src/skills-sync/bundled.d.ts.map +1 -0
  495. package/dist/src/skills-sync/bundled.js +84 -0
  496. package/dist/src/skills-sync/bundled.js.map +1 -0
  497. package/dist/src/skills-sync/fingerprint.d.ts +32 -0
  498. package/dist/src/skills-sync/fingerprint.d.ts.map +1 -0
  499. package/dist/src/skills-sync/fingerprint.js +58 -0
  500. package/dist/src/skills-sync/fingerprint.js.map +1 -0
  501. package/dist/src/skills-sync/history.d.ts +44 -0
  502. package/dist/src/skills-sync/history.d.ts.map +1 -0
  503. package/dist/src/skills-sync/history.js +115 -0
  504. package/dist/src/skills-sync/history.js.map +1 -0
  505. package/dist/src/skills-sync/home-skill.d.ts +28 -0
  506. package/dist/src/skills-sync/home-skill.d.ts.map +1 -0
  507. package/dist/src/skills-sync/home-skill.js +67 -0
  508. package/dist/src/skills-sync/home-skill.js.map +1 -0
  509. package/dist/src/skills-sync/instance.d.ts +26 -0
  510. package/dist/src/skills-sync/instance.d.ts.map +1 -0
  511. package/dist/src/skills-sync/instance.js +128 -0
  512. package/dist/src/skills-sync/instance.js.map +1 -0
  513. package/dist/src/skills-sync/names.d.ts +25 -0
  514. package/dist/src/skills-sync/names.d.ts.map +1 -0
  515. package/dist/src/skills-sync/names.js +56 -0
  516. package/dist/src/skills-sync/names.js.map +1 -0
  517. package/dist/src/skills-sync/plan.d.ts +58 -0
  518. package/dist/src/skills-sync/plan.d.ts.map +1 -0
  519. package/dist/src/skills-sync/plan.js +132 -0
  520. package/dist/src/skills-sync/plan.js.map +1 -0
  521. package/dist/src/skills-sync/receipt.d.ts +61 -0
  522. package/dist/src/skills-sync/receipt.d.ts.map +1 -0
  523. package/dist/src/skills-sync/receipt.js +149 -0
  524. package/dist/src/skills-sync/receipt.js.map +1 -0
  525. package/dist/src/skills-sync/staging.d.ts +21 -0
  526. package/dist/src/skills-sync/staging.d.ts.map +1 -0
  527. package/dist/src/skills-sync/staging.js +81 -0
  528. package/dist/src/skills-sync/staging.js.map +1 -0
  529. package/dist/src/skills-sync/sync.d.ts +37 -0
  530. package/dist/src/skills-sync/sync.d.ts.map +1 -0
  531. package/dist/src/skills-sync/sync.js +201 -0
  532. package/dist/src/skills-sync/sync.js.map +1 -0
  533. package/dist/src/skills-sync/types.d.ts +66 -0
  534. package/dist/src/skills-sync/types.d.ts.map +1 -0
  535. package/dist/src/skills-sync/types.js +2 -0
  536. package/dist/src/skills-sync/types.js.map +1 -0
  537. package/dist/src/stt/config.d.ts +5 -0
  538. package/dist/src/stt/config.d.ts.map +1 -0
  539. package/dist/src/stt/config.js +18 -0
  540. package/dist/src/stt/config.js.map +1 -0
  541. package/dist/src/updates/maintenance.d.ts.map +1 -1
  542. package/dist/src/updates/maintenance.js +24 -4
  543. package/dist/src/updates/maintenance.js.map +1 -1
  544. package/dist/src/workflows/repository-mutex.d.ts +1 -1
  545. package/dist/web/404.html +1 -1
  546. package/dist/web/__next.__PAGE__.txt +11 -11
  547. package/dist/web/__next._full.txt +12 -12
  548. package/dist/web/__next._tree.txt +2 -2
  549. package/dist/web/_next/static/chunks/{0g5c5ppr8zmup.js → 20v6mri7epga5.js} +1 -1
  550. package/dist/web/_next/static/chunks/2u0328ngpt-ek.js +1 -0
  551. package/dist/web/_next/static/chunks/3f9i3f9q6v6_j.css +1 -0
  552. package/dist/web/_next/static/chunks/{2iqxlc9wtxzm2.js → 3yy053rafgrzy.js} +1 -1
  553. package/dist/web/_not-found/__next._full.txt +10 -10
  554. package/dist/web/_not-found/__next._not-found.__PAGE__.txt +9 -9
  555. package/dist/web/_not-found/__next._tree.txt +2 -2
  556. package/dist/web/_not-found.html +1 -1
  557. package/dist/web/_not-found.txt +10 -10
  558. package/dist/web/chat/__next._full.txt +12 -12
  559. package/dist/web/chat/__next._tree.txt +2 -2
  560. package/dist/web/chat/__next.chat.__PAGE__.txt +11 -11
  561. package/dist/web/chat.html +1 -1
  562. package/dist/web/chat.txt +12 -12
  563. package/dist/web/cron/__next._full.txt +12 -12
  564. package/dist/web/cron/__next._tree.txt +2 -2
  565. package/dist/web/cron/__next.cron.__PAGE__.txt +11 -11
  566. package/dist/web/cron.html +1 -1
  567. package/dist/web/cron.txt +12 -12
  568. package/dist/web/index.html +1 -1
  569. package/dist/web/index.txt +12 -12
  570. package/dist/web/kanban/__next._full.txt +12 -12
  571. package/dist/web/kanban/__next._tree.txt +2 -2
  572. package/dist/web/kanban/__next.kanban.__PAGE__.txt +11 -11
  573. package/dist/web/kanban.html +1 -1
  574. package/dist/web/kanban.txt +12 -12
  575. package/dist/web/logs/__next._full.txt +12 -12
  576. package/dist/web/logs/__next._tree.txt +2 -2
  577. package/dist/web/logs/__next.logs.__PAGE__.txt +11 -11
  578. package/dist/web/logs.html +1 -1
  579. package/dist/web/logs.txt +12 -12
  580. package/dist/web/models/__next._full.txt +12 -12
  581. package/dist/web/models/__next._tree.txt +2 -2
  582. package/dist/web/models/__next.models.__PAGE__.txt +11 -11
  583. package/dist/web/models.html +1 -1
  584. package/dist/web/models.txt +12 -12
  585. package/dist/web/org/__next._full.txt +12 -12
  586. package/dist/web/org/__next._tree.txt +2 -2
  587. package/dist/web/org/__next.org.__PAGE__.txt +11 -11
  588. package/dist/web/org.html +1 -1
  589. package/dist/web/org.txt +12 -12
  590. package/dist/web/sessions/__next._full.txt +10 -10
  591. package/dist/web/sessions/__next._tree.txt +2 -2
  592. package/dist/web/sessions/__next.sessions.__PAGE__.txt +9 -9
  593. package/dist/web/sessions.html +1 -1
  594. package/dist/web/sessions.txt +10 -10
  595. package/dist/web/settings/__next._full.txt +12 -12
  596. package/dist/web/settings/__next._tree.txt +2 -2
  597. package/dist/web/settings/__next.settings.__PAGE__.txt +11 -11
  598. package/dist/web/settings.html +1 -1
  599. package/dist/web/settings.txt +12 -12
  600. package/dist/web/skills/__next._full.txt +12 -12
  601. package/dist/web/skills/__next._tree.txt +2 -2
  602. package/dist/web/skills/__next.skills.__PAGE__.txt +11 -11
  603. package/dist/web/skills.html +1 -1
  604. package/dist/web/skills.txt +12 -12
  605. package/package.json +2 -1
  606. package/template/bundled-skill-history.json +377 -0
  607. package/template/config.default.yaml +48 -3
  608. package/template/docs/architecture.md +41 -3
  609. package/template/docs/backup.md +142 -0
  610. package/template/docs/connectors.md +192 -16
  611. package/template/docs/cron.md +30 -11
  612. package/template/docs/memory.md +1 -1
  613. package/template/docs/overview.md +6 -2
  614. package/template/docs/self-modification.md +11 -10
  615. package/template/docs/skills.md +77 -4
  616. package/template/migrations/0.3.0/MIGRATION.md +6 -0
  617. package/template/migrations/0.7.3/MIGRATION.md +6 -0
  618. package/template/migrations/0.7.5/MIGRATION.md +1 -1
  619. package/template/migrations/0.9.0/MIGRATION.md +6 -0
  620. package/template/migrations/2026.10.13/MIGRATION.md +76 -0
  621. package/template/migrations/2026.10.13/files/docs/architecture.md +112 -0
  622. package/template/migrations/2026.10.13/files/docs/automations.md +110 -0
  623. package/template/migrations/2026.10.13/files/docs/backup.md +142 -0
  624. package/template/migrations/2026.10.13/files/docs/connectors.md +370 -0
  625. package/template/migrations/2026.10.13/files/docs/cron-commands.md +52 -0
  626. package/template/migrations/2026.10.13/files/docs/cron.md +178 -0
  627. package/template/migrations/2026.10.13/files/docs/mcp.md +108 -0
  628. package/template/migrations/2026.10.13/files/docs/memory.md +47 -0
  629. package/template/migrations/2026.10.13/files/docs/org.md +111 -0
  630. package/template/migrations/2026.10.13/files/docs/overview.md +44 -0
  631. package/template/migrations/2026.10.13/files/docs/self-modification.md +71 -0
  632. package/template/migrations/2026.10.13/files/docs/skills.md +140 -0
  633. package/template/migrations/2026.10.13/files/skills/cron-manager/SKILL.md +107 -0
  634. package/template/migrations/2026.10.13/files/skills/management/SKILL.md +227 -0
  635. package/template/migrations/2026.10.13/files/skills/migrate/SKILL.md +194 -0
  636. package/template/migrations/2026.10.13/files/skills/onboarding/SKILL.md +153 -0
  637. package/template/migrations/2026.10.13/files/skills/openryoko-config/SKILL.md +35 -0
  638. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/engine-fallback.md +98 -0
  639. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/jev.md +89 -0
  640. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/maintenance.md +49 -0
  641. package/template/migrations/2026.10.13/files/skills/openryoko-config/references/platform.md +100 -0
  642. package/template/migrations/2026.10.13/files/skills/self-heal/SKILL.md +187 -0
  643. package/template/migrations/2026.10.9/MIGRATION.md +6 -0
  644. package/template/migrations/2026.10.9/files/docs/memory.md +1 -1
  645. package/template/migrations/2026.10.9/files/skills/migrate/SKILL.md +39 -5
  646. package/template/migrations/2026.5.7/MIGRATION.md +6 -0
  647. package/template/migrations/2026.8.28/MIGRATION.md +6 -0
  648. package/template/migrations/2026.9.11/MIGRATION.md +6 -0
  649. package/template/skills/cron-manager/SKILL.md +10 -0
  650. package/template/skills/management/SKILL.md +5 -4
  651. package/template/skills/migrate/SKILL.md +39 -5
  652. package/template/skills/onboarding/SKILL.md +2 -2
  653. package/template/skills/openryoko-config/SKILL.md +1 -1
  654. package/template/skills/openryoko-config/references/engine-fallback.md +16 -5
  655. package/template/skills/openryoko-config/references/platform.md +23 -4
  656. package/template/skills/self-heal/SKILL.md +117 -44
  657. package/dist/src/engines/mock.d.ts +0 -16
  658. package/dist/src/engines/mock.d.ts.map +0 -1
  659. package/dist/src/engines/mock.js +0 -47
  660. package/dist/src/engines/mock.js.map +0 -1
  661. package/dist/src/shared/test-support/posix-mode.d.ts +0 -17
  662. package/dist/src/shared/test-support/posix-mode.d.ts.map +0 -1
  663. package/dist/src/shared/test-support/posix-mode.js +0 -23
  664. package/dist/src/shared/test-support/posix-mode.js.map +0 -1
  665. package/dist/web/_next/static/chunks/0ic18n-m7ixyw.css +0 -1
  666. package/dist/web/_next/static/chunks/1_jm0szyu2the.js +0 -1
  667. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_buildManifest.js +0 -0
  668. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_clientMiddlewareManifest.js +0 -0
  669. /package/dist/web/_next/static/{peH9RGESLkxB7fw3Cq1GO → ov0mWzyHx0B5oEnTHE_pa}/_ssgManifest.js +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../../src/shared/attachments.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,18 @@
1
+ /**
2
+ * Environment the gateway adds to every LOCAL Claude CLI it launches, on top of
3
+ * the base child env. /logout in that CLI signs the shared account out from
4
+ * under every session and the next spawn, so it is turned off wherever the
5
+ * gateway or the CLI starts Claude locally — the interactive PTY, the headless
6
+ * `claude -p`, the one-shot classifier/extractor, a session fork, a migration
7
+ * run. /login is deliberately left on (web live-terminal recovery).
8
+ *
9
+ * NOT applied to a remote (sshHost) run: a value set here does not cross to the
10
+ * remote process, and a /logout there is that host's own CLI, not ours.
11
+ *
12
+ * One source of truth so the launch sites cannot drift apart; a test enumerates
13
+ * them (see claude-launch-env.test.ts).
14
+ */
15
+ export declare const CLAUDE_LOCAL_ENV: Readonly<Record<string, string>>;
1
16
  export interface BuildChildEnvOptions {
2
17
  /** Strip env keys whose name starts with any of these prefixes. */
3
18
  stripPrefixes?: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"childEnv.d.ts","sourceRoot":"","sources":["../../../src/shared/childEnv.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBrF;AAMD,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
1
+ {"version":3,"file":"childEnv.d.ts","sourceRoot":"","sources":["../../../src/shared/childEnv.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAmC,CAAC;AAElG,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBrF;AAMD,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
@@ -1,5 +1,20 @@
1
1
  import { logger } from "./logger.js";
2
2
  let warnedRoot = false;
3
+ /**
4
+ * Environment the gateway adds to every LOCAL Claude CLI it launches, on top of
5
+ * the base child env. /logout in that CLI signs the shared account out from
6
+ * under every session and the next spawn, so it is turned off wherever the
7
+ * gateway or the CLI starts Claude locally — the interactive PTY, the headless
8
+ * `claude -p`, the one-shot classifier/extractor, a session fork, a migration
9
+ * run. /login is deliberately left on (web live-terminal recovery).
10
+ *
11
+ * NOT applied to a remote (sshHost) run: a value set here does not cross to the
12
+ * remote process, and a /logout there is that host's own CLI, not ours.
13
+ *
14
+ * One source of truth so the launch sites cannot drift apart; a test enumerates
15
+ * them (see claude-launch-env.test.ts).
16
+ */
17
+ export const CLAUDE_LOCAL_ENV = { DISABLE_LOGOUT_COMMAND: "1" };
3
18
  /**
4
19
  * Build an env dict for spawning a child CLI.
5
20
  *
@@ -1 +1 @@
1
- {"version":3,"file":"childEnv.js","sourceRoot":"","sources":["../../../src/shared/childEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,IAAI,UAAU,GAAG,KAAK,CAAC;AASvB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B,EAAE;IAC3D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAElD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,SAAS;QACjE,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACzD,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,CAAC;YAClB,MAAM,CAAC,IAAI,CACT,oFAAoF;gBAClF,kGAAkG,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc;IAC5B,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"childEnv.js","sourceRoot":"","sources":["../../../src/shared/childEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC,EAAE,sBAAsB,EAAE,GAAG,EAAE,CAAC;AASlG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B,EAAE;IAC3D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAElD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,SAAS;QACjE,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,SAAS;QACzD,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,CAAC;YAClB,MAAM,CAAC,IAAI,CACT,oFAAoF;gBAClF,kGAAkG,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc;IAC5B,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * When the Claude allowance a turn just ran out of reopens.
3
+ *
4
+ * The usage collector next door answers for a person looking at a dashboard.
5
+ * This asks one question on behalf of a turn that has already failed, so it is
6
+ * best effort by construction: an unreachable source, a slow one, or one that
7
+ * shows no spent window resolves to `undefined` rather than throwing or
8
+ * stalling, and the caller keeps the backoff it had before.
9
+ */
10
+ import { type ClaudeUsageResponse, type ClaudeUsageWindow } from "./claude-usage.js";
11
+ /** The whole lookup — credential read and request together — may hold a failed
12
+ * turn back by this much and no more. */
13
+ export declare const CLAUDE_LIMIT_RESET_TIMEOUT_MS = 2500;
14
+ export interface ClaudeLimitReset {
15
+ /** Unix seconds. */
16
+ resetsAt: number;
17
+ /** The spent window as usage telemetry names it (`5h`, `7d`, `7d Fable`). */
18
+ window: string;
19
+ }
20
+ /**
21
+ * Whether a quota window counts against a turn on `model`.
22
+ *
23
+ * The shared windows bind every model, and so does a record that names no
24
+ * window at all. A scoped window binds only the model family it names; one that
25
+ * cannot be attributed binds no one, because holding an allowance against the
26
+ * wrong model is the failure this exists to prevent.
27
+ */
28
+ export declare function limitWindowBindsModel(window: string | undefined, model: string | null | undefined): boolean;
29
+ /**
30
+ * The spent window a turn on `model` is waiting for. When several are spent the
31
+ * model is back only once the last of them reopens, so that is the one named.
32
+ */
33
+ export declare function spentClaudeWindow(windows: readonly ClaudeUsageWindow[], model: string | null | undefined, nowMs?: number): ClaudeUsageWindow | undefined;
34
+ /**
35
+ * Whether `window` could be what holds a health record held on `recordWindow`.
36
+ * A record names the scoped window it was held on, if any, and no model: only
37
+ * that window and the shared ones can still be holding it.
38
+ */
39
+ export declare function windowCanHoldRecord(window: string, recordWindow: string | undefined): boolean;
40
+ /** `spentClaudeWindow`, asked on behalf of a health record rather than a turn. */
41
+ export declare function spentClaudeWindowFor(windows: readonly ClaudeUsageWindow[], recordWindow: string | undefined, nowMs?: number): ClaudeUsageWindow | undefined;
42
+ export interface ClaudeLimitResetOptions {
43
+ /** The model the limited turn ran on; decides which scoped windows apply. */
44
+ model?: string | null;
45
+ timeoutMs?: number;
46
+ nowMs?: number;
47
+ collect?: (options: {
48
+ timeoutMs: number;
49
+ }) => Promise<ClaudeUsageResponse>;
50
+ }
51
+ /** The real reset of the window `model` ran out of, or `undefined` when no
52
+ * source could say within the deadline. Never rejects. */
53
+ export declare function claudeLimitReset(options?: ClaudeLimitResetOptions): Promise<ClaudeLimitReset | undefined>;
54
+ //# sourceMappingURL=claude-limit-reset.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-limit-reset.d.ts","sourceRoot":"","sources":["../../../src/shared/claude-limit-reset.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsB,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzG;0CAC0C;AAC1C,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAM3G;AAoBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,KAAK,GAAE,MAAmB,GACzB,iBAAiB,GAAG,SAAS,CAE/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE7F;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,GAAE,MAAmB,GACzB,iBAAiB,GAAG,SAAS,CAE/B;AAED,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC5E;AAED;2DAC2D;AAC3D,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAsBnH"}
@@ -0,0 +1,99 @@
1
+ /**
2
+ * When the Claude allowance a turn just ran out of reopens.
3
+ *
4
+ * The usage collector next door answers for a person looking at a dashboard.
5
+ * This asks one question on behalf of a turn that has already failed, so it is
6
+ * best effort by construction: an unreachable source, a slow one, or one that
7
+ * shows no spent window resolves to `undefined` rather than throwing or
8
+ * stalling, and the caller keeps the backoff it had before.
9
+ */
10
+ import { collectClaudeUsage } from "./claude-usage.js";
11
+ /** The whole lookup — credential read and request together — may hold a failed
12
+ * turn back by this much and no more. */
13
+ export const CLAUDE_LIMIT_RESET_TIMEOUT_MS = 2_500;
14
+ /** Windows every model draws on. Any other window is scoped to what it names. */
15
+ const SHARED_WINDOWS = ["5h", "7d"];
16
+ /** Words in a window name that say nothing about which model it covers. */
17
+ const UNSCOPED_WORDS = ["claude", "scoped", "weekly", "session", "limit"];
18
+ /**
19
+ * Whether a quota window counts against a turn on `model`.
20
+ *
21
+ * The shared windows bind every model, and so does a record that names no
22
+ * window at all. A scoped window binds only the model family it names; one that
23
+ * cannot be attributed binds no one, because holding an allowance against the
24
+ * wrong model is the failure this exists to prevent.
25
+ */
26
+ export function limitWindowBindsModel(window, model) {
27
+ if (window === undefined || SHARED_WINDOWS.includes(window))
28
+ return true;
29
+ if (!model)
30
+ return false;
31
+ const families = (window.toLowerCase().match(/[a-z]{4,}/g) ?? []).filter((word) => !UNSCOPED_WORDS.includes(word));
32
+ const id = model.toLowerCase();
33
+ return families.some((family) => id.includes(family));
34
+ }
35
+ /** The last of the spent windows `applies` accepts to reopen. A window without
36
+ * a reset still ahead of `nowMs` states nothing to wait for. */
37
+ function lastSpentWindow(windows, applies, nowMs) {
38
+ let binding;
39
+ for (const window of windows) {
40
+ if (window.usedPercent < 100 || !applies(window.name))
41
+ continue;
42
+ const resetsAt = window.resetsAt;
43
+ if (resetsAt === undefined || resetsAt * 1000 <= nowMs)
44
+ continue;
45
+ if (binding?.resetsAt !== undefined && resetsAt <= binding.resetsAt)
46
+ continue;
47
+ binding = window;
48
+ }
49
+ return binding;
50
+ }
51
+ /**
52
+ * The spent window a turn on `model` is waiting for. When several are spent the
53
+ * model is back only once the last of them reopens, so that is the one named.
54
+ */
55
+ export function spentClaudeWindow(windows, model, nowMs = Date.now()) {
56
+ return lastSpentWindow(windows, (window) => limitWindowBindsModel(window, model), nowMs);
57
+ }
58
+ /**
59
+ * Whether `window` could be what holds a health record held on `recordWindow`.
60
+ * A record names the scoped window it was held on, if any, and no model: only
61
+ * that window and the shared ones can still be holding it.
62
+ */
63
+ export function windowCanHoldRecord(window, recordWindow) {
64
+ return SHARED_WINDOWS.includes(window) || window === recordWindow;
65
+ }
66
+ /** `spentClaudeWindow`, asked on behalf of a health record rather than a turn. */
67
+ export function spentClaudeWindowFor(windows, recordWindow, nowMs = Date.now()) {
68
+ return lastSpentWindow(windows, (window) => windowCanHoldRecord(window, recordWindow), nowMs);
69
+ }
70
+ /** The real reset of the window `model` ran out of, or `undefined` when no
71
+ * source could say within the deadline. Never rejects. */
72
+ export async function claudeLimitReset(options = {}) {
73
+ const timeoutMs = options.timeoutMs ?? CLAUDE_LIMIT_RESET_TIMEOUT_MS;
74
+ let timer;
75
+ const deadline = new Promise((resolve) => {
76
+ timer = setTimeout(() => resolve(undefined), timeoutMs);
77
+ timer.unref?.();
78
+ });
79
+ try {
80
+ // The collector outlives a lost race, so its own failure is absorbed here
81
+ // rather than left to surface as an unhandled rejection.
82
+ const reading = Promise.resolve()
83
+ .then(() => (options.collect ?? collectClaudeUsage)({ timeoutMs }))
84
+ .catch(() => undefined);
85
+ const usage = await Promise.race([reading, deadline]);
86
+ if (!usage?.available)
87
+ return undefined;
88
+ const spent = spentClaudeWindow(usage.windows, options.model, options.nowMs);
89
+ return spent?.resetsAt === undefined ? undefined : { resetsAt: spent.resetsAt, window: spent.name };
90
+ }
91
+ catch {
92
+ return undefined;
93
+ }
94
+ finally {
95
+ if (timer)
96
+ clearTimeout(timer);
97
+ }
98
+ }
99
+ //# sourceMappingURL=claude-limit-reset.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-limit-reset.js","sourceRoot":"","sources":["../../../src/shared/claude-limit-reset.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * What may be said — logged, printed, sent back by an API route — about a
3
+ * failure to load config.yaml. js-yaml's message for a file it cannot parse
4
+ * quotes the lines around the error, and its reason can name an alias or a tag
5
+ * taken from them. The file holds the bot tokens, so of a parse error only the
6
+ * position is passed on. Any other failure is reported as it is.
7
+ */
8
+ export declare function configErrorForLog(err: unknown): string;
9
+ /**
10
+ * config.yaml could not be parsed. Made afresh from the parser's error — which
11
+ * is not kept, not even as `cause`: its message, its stack and its mark all
12
+ * carry a snippet of the file, and callers print errors in every way there is.
13
+ */
14
+ export declare class ConfigSyntaxError extends Error {
15
+ constructor(parserError: unknown);
16
+ }
17
+ /** There is no config.yaml where one is expected: the instance was never set up. */
18
+ export declare class ConfigNotFoundError extends Error {
19
+ constructor(configPath: string);
20
+ }
21
+ //# sourceMappingURL=config-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-error.d.ts","sourceRoot":"","sources":["../../../src/shared/config-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,WAAW,EAAE,OAAO;CAIjC;AAED,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,UAAU,EAAE,MAAM;CAI/B"}
@@ -0,0 +1,37 @@
1
+ /**
2
+ * What may be said — logged, printed, sent back by an API route — about a
3
+ * failure to load config.yaml. js-yaml's message for a file it cannot parse
4
+ * quotes the lines around the error, and its reason can name an alias or a tag
5
+ * taken from them. The file holds the bot tokens, so of a parse error only the
6
+ * position is passed on. Any other failure is reported as it is.
7
+ */
8
+ export function configErrorForLog(err) {
9
+ if (!(err instanceof Error))
10
+ return String(err);
11
+ // By shape, not `instanceof`: the error may come from another copy of js-yaml.
12
+ if (err.name !== "YAMLException" && !("mark" in err))
13
+ return err.message;
14
+ const { line, column } = err.mark ?? {};
15
+ return typeof line === "number" && typeof column === "number"
16
+ ? `config.yaml is not valid YAML (line ${line + 1}, column ${column + 1})`
17
+ : "config.yaml is not valid YAML";
18
+ }
19
+ /**
20
+ * config.yaml could not be parsed. Made afresh from the parser's error — which
21
+ * is not kept, not even as `cause`: its message, its stack and its mark all
22
+ * carry a snippet of the file, and callers print errors in every way there is.
23
+ */
24
+ export class ConfigSyntaxError extends Error {
25
+ constructor(parserError) {
26
+ super(configErrorForLog(parserError));
27
+ this.name = "ConfigSyntaxError";
28
+ }
29
+ }
30
+ /** There is no config.yaml where one is expected: the instance was never set up. */
31
+ export class ConfigNotFoundError extends Error {
32
+ constructor(configPath) {
33
+ super(`Ryoko config not found at ${configPath}. Run "ryoko setup" first.`);
34
+ this.name = "ConfigNotFoundError";
35
+ }
36
+ }
37
+ //# sourceMappingURL=config-error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-error.js","sourceRoot":"","sources":["../../../src/shared/config-error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,+EAA+E;IAC/E,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IACzE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAI,GAAuD,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7F,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;QAC3D,CAAC,CAAC,uCAAuC,IAAI,GAAG,CAAC,YAAY,MAAM,GAAG,CAAC,GAAG;QAC1E,CAAC,CAAC,+BAA+B,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,WAAoB;QAC9B,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,UAAkB;QAC5B,KAAK,CAAC,6BAA6B,UAAU,4BAA4B,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * config.yaml exists but cannot serve as the base of a merge. Every API writer
3
+ * merges a partial update into the file on disk; starting that merge from an
4
+ * empty object would replace engines, connectors and tokens with the request
5
+ * body alone. The message never quotes the file — a token may sit on the
6
+ * broken line.
7
+ */
8
+ export declare class ConfigFileUnreadableError extends Error {
9
+ readonly code = "CONFIG_UNREADABLE";
10
+ constructor(reason: string);
11
+ }
12
+ export { configErrorForLog } from "./config-error.js";
13
+ /** config.yaml as one read saw it: the text, and the mapping parsed from it. */
14
+ export interface ConfigSnapshot {
15
+ /** The file's text; null when config.yaml does not exist yet. */
16
+ raw: string | null;
17
+ /** The file's exact bytes, for putting this very version back; null like `raw`. */
18
+ bytes: Buffer | null;
19
+ /** Permission bits of the file that was read; null when it does not exist yet. */
20
+ mode: number | null;
21
+ document: Record<string, unknown>;
22
+ /** Identifies these exact bytes, within this process (see revisionOf); empty while the file does not exist. */
23
+ revision: string;
24
+ }
25
+ /**
26
+ * Read config.yaml as the base for a merge. A missing file is the one honest
27
+ * "start fresh" (setup has not written it yet). A file that is there but
28
+ * cannot be read or parsed throws {@link ConfigFileUnreadableError}.
29
+ */
30
+ export declare function readConfigSnapshot(configPath?: string): ConfigSnapshot;
31
+ /**
32
+ * Replace config.yaml with `text` exactly as given — for a writer that edits
33
+ * the text itself (the onboarding portal block) or puts an earlier version of
34
+ * the file back (pass that snapshot's `bytes`). Staged and renamed into place
35
+ * like writeConfigDocument, with the permission bits and owner of the file
36
+ * `snapshot` was read from. Returns the revision of what was written.
37
+ */
38
+ export declare function writeConfigText(snapshot: ConfigSnapshot, text: string | Buffer, configPath?: string): string;
39
+ /**
40
+ * Read config.yaml, let `change` derive the next document, and write it: one
41
+ * call for a writer that sets a few keys. `change` receives a copy it is free
42
+ * to modify. Throws when config.yaml does not exist — a setting on its own is
43
+ * not a config the gateway could start from — or cannot be read.
44
+ */
45
+ export declare function updateConfigDocument(change: (document: Record<string, unknown>) => Record<string, unknown>, configPath?: string): string;
46
+ /**
47
+ * Replace config.yaml with `document`. The new contents are staged in a
48
+ * temporary file next to it and renamed into place, so a crash or a full disk
49
+ * mid-write leaves the previous file whole — neither the gateway's watcher nor
50
+ * the next boot ever reads a half-written config. `snapshot` is the read the
51
+ * document was merged from: it tells whether the file is being created
52
+ * (owner-only, it holds tokens) or replaced (permission bits kept), and it is
53
+ * the text the changed lines are written into. Returns the revision of what
54
+ * was written.
55
+ */
56
+ export declare function writeConfigDocument(snapshot: ConfigSnapshot, document: Record<string, unknown>, configPath?: string): string;
57
+ //# sourceMappingURL=config-file.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../../../src/shared/config-file.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,uBAAuB;gBACxB,MAAM,EAAE,MAAM;CAI3B;AAID,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mFAAmF;IACnF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kFAAkF;IAClF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,MAAoB,GAAG,cAAc,CAkBnF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,GAAE,MAAoB,GAAG,MAAM,CAGzH;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtE,UAAU,GAAE,MAAoB,GAC/B,MAAM,CAIR;AA0FD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,GAAE,MAAoB,GAC/B,MAAM,CAIR"}
@@ -0,0 +1,217 @@
1
+ import { createHmac, randomBytes, randomUUID } from "node:crypto";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ import yaml from "js-yaml";
5
+ import { editYamlText, MAX_EDITABLE_CHARS } from "./config-yaml-edit.js";
6
+ import { logger } from "./logger.js";
7
+ import { CONFIG_PATH } from "./paths.js";
8
+ /**
9
+ * config.yaml exists but cannot serve as the base of a merge. Every API writer
10
+ * merges a partial update into the file on disk; starting that merge from an
11
+ * empty object would replace engines, connectors and tokens with the request
12
+ * body alone. The message never quotes the file — a token may sit on the
13
+ * broken line.
14
+ */
15
+ export class ConfigFileUnreadableError extends Error {
16
+ code = "CONFIG_UNREADABLE";
17
+ constructor(reason) {
18
+ super(`config.yaml ${reason}; refusing to overwrite it. Fix or restore the file, then try again.`);
19
+ this.name = "ConfigFileUnreadableError";
20
+ }
21
+ }
22
+ // Lives in a module of its own so that loadConfig() can use it without
23
+ // pulling in the config writer; still exported from here for its callers.
24
+ export { configErrorForLog } from "./config-error.js";
25
+ /** Made when the process starts and kept in its memory only. */
26
+ const REVISION_KEY = randomBytes(32);
27
+ /**
28
+ * Derived from the bytes rather than read off an mtime: a rename-based write
29
+ * moves the mtime even when it changed nothing.
30
+ *
31
+ * Keyed (HMAC), not a plain hash. The revision is sent to every client of the
32
+ * API, and the file it is made from holds tokens: a plain digest would let
33
+ * whoever sees it test guesses about the file offline. With a key that never
34
+ * leaves this process it says one thing only — whether the file is still the
35
+ * one that was read. A revision therefore does not survive a restart: a page
36
+ * left open across one gets a single conflict on its next save, and reloads.
37
+ */
38
+ function revisionOf(bytes) {
39
+ return createHmac("sha256", REVISION_KEY).update(bytes).digest("hex");
40
+ }
41
+ function parseConfigMapping(raw) {
42
+ let parsed;
43
+ try {
44
+ parsed = yaml.load(raw);
45
+ }
46
+ catch (err) {
47
+ // js-yaml's own message carries a snippet of the file around the error.
48
+ const line = err.mark?.line;
49
+ throw new ConfigFileUnreadableError(`exists but is not valid YAML${typeof line === "number" ? ` (near line ${line + 1})` : ""}`);
50
+ }
51
+ // Empty or comment-only: nothing is configured yet, so nothing can be lost.
52
+ if (parsed === undefined || parsed === null)
53
+ return {};
54
+ if (typeof parsed !== "object" || Array.isArray(parsed)) {
55
+ throw new ConfigFileUnreadableError("exists but its top level is not a mapping");
56
+ }
57
+ return parsed;
58
+ }
59
+ /**
60
+ * Read config.yaml as the base for a merge. A missing file is the one honest
61
+ * "start fresh" (setup has not written it yet). A file that is there but
62
+ * cannot be read or parsed throws {@link ConfigFileUnreadableError}.
63
+ */
64
+ export function readConfigSnapshot(configPath = CONFIG_PATH) {
65
+ let bytes;
66
+ let mode;
67
+ try {
68
+ const fd = fs.openSync(configPath, "r");
69
+ try {
70
+ mode = fs.fstatSync(fd).mode & 0o7777;
71
+ bytes = fs.readFileSync(fd);
72
+ }
73
+ finally {
74
+ fs.closeSync(fd);
75
+ }
76
+ }
77
+ catch (err) {
78
+ const code = err.code;
79
+ if (code === "ENOENT")
80
+ return { raw: null, bytes: null, mode: null, document: {}, revision: "" };
81
+ throw new ConfigFileUnreadableError(`exists but could not be read (${code ?? "unknown error"})`);
82
+ }
83
+ const raw = bytes.toString("utf-8");
84
+ return { raw, bytes, mode, document: parseConfigMapping(raw), revision: revisionOf(bytes) };
85
+ }
86
+ /**
87
+ * Replace config.yaml with `text` exactly as given — for a writer that edits
88
+ * the text itself (the onboarding portal block) or puts an earlier version of
89
+ * the file back (pass that snapshot's `bytes`). Staged and renamed into place
90
+ * like writeConfigDocument, with the permission bits and owner of the file
91
+ * `snapshot` was read from. Returns the revision of what was written.
92
+ */
93
+ export function writeConfigText(snapshot, text, configPath = CONFIG_PATH) {
94
+ replaceFile(configPath, text, snapshot.mode ?? 0o600);
95
+ return revisionOf(text);
96
+ }
97
+ /**
98
+ * Read config.yaml, let `change` derive the next document, and write it: one
99
+ * call for a writer that sets a few keys. `change` receives a copy it is free
100
+ * to modify. Throws when config.yaml does not exist — a setting on its own is
101
+ * not a config the gateway could start from — or cannot be read.
102
+ */
103
+ export function updateConfigDocument(change, configPath = CONFIG_PATH) {
104
+ const snapshot = readConfigSnapshot(configPath);
105
+ if (snapshot.raw === null)
106
+ throw new Error("config.yaml not found");
107
+ return writeConfigDocument(snapshot, change(structuredClone(snapshot.document)), configPath);
108
+ }
109
+ /** Follow a symlinked config.yaml (dotfiles setups) so the link survives the
110
+ * rename. A missing file is created where it was asked for; a dangling link
111
+ * creates what it points at, as a plain write would. */
112
+ function resolveWriteTarget(filePath) {
113
+ try {
114
+ return fs.realpathSync(filePath);
115
+ }
116
+ catch {
117
+ try {
118
+ return path.resolve(path.dirname(filePath), fs.readlinkSync(filePath));
119
+ }
120
+ catch {
121
+ return filePath;
122
+ }
123
+ }
124
+ }
125
+ /** Keep the file with whoever owned it: a root-run gateway must not take a
126
+ * user's config.yaml away from them. Throws EPERM when the process may not
127
+ * hand the staged file back, which sends the caller to the in-place write. */
128
+ function matchOwner(fd, target) {
129
+ let previous;
130
+ try {
131
+ previous = fs.statSync(target);
132
+ }
133
+ catch {
134
+ return; // being created: the process's own identity stands
135
+ }
136
+ const staged = fs.fstatSync(fd);
137
+ if (previous.uid === staged.uid && previous.gid === staged.gid)
138
+ return;
139
+ fs.fchownSync(fd, previous.uid, previous.gid);
140
+ }
141
+ function stageFile(temporary, data, mode, target) {
142
+ const fd = fs.openSync(temporary, "wx", mode);
143
+ try {
144
+ fs.writeFileSync(fd, data, "utf-8");
145
+ fs.fchmodSync(fd, mode); // the mode given to open() is filtered by the umask
146
+ matchOwner(fd, target);
147
+ fs.fsyncSync(fd);
148
+ }
149
+ finally {
150
+ fs.closeSync(fd);
151
+ }
152
+ }
153
+ /** rename(2) cannot replace these targets (a bind-mounted single file, a
154
+ * directory the process may not write to, a file it does not own). Writing in
155
+ * place still works there, and is what saving did before. Deliberately NOT
156
+ * here: ENOSPC, EIO — an in-place write would truncate the file and then fail. */
157
+ const IN_PLACE_FALLBACK_CODES = new Set(["EBUSY", "EXDEV", "EACCES", "EPERM", "EROFS"]);
158
+ let warnedInPlaceWrite = false;
159
+ function replaceFile(filePath, data, mode) {
160
+ const target = resolveWriteTarget(filePath);
161
+ const temporary = path.join(path.dirname(target), `.${path.basename(target)}.${process.pid}-${randomUUID()}.tmp`);
162
+ try {
163
+ stageFile(temporary, data, mode, target);
164
+ fs.renameSync(temporary, target);
165
+ }
166
+ catch (err) {
167
+ try {
168
+ fs.unlinkSync(temporary);
169
+ }
170
+ catch { /* never created */ }
171
+ const code = err.code ?? "";
172
+ if (!IN_PLACE_FALLBACK_CODES.has(code))
173
+ throw err;
174
+ if (!warnedInPlaceWrite) {
175
+ warnedInPlaceWrite = true;
176
+ logger.warn(`config.yaml cannot be replaced atomically here (${code}); writing it in place instead`);
177
+ }
178
+ fs.writeFileSync(target, data, "utf-8");
179
+ }
180
+ }
181
+ /**
182
+ * The text to store for `document`. config.yaml is edited by hand as much as
183
+ * through the API, so only the lines whose value changed are rewritten: the
184
+ * comments, the order of keys and the quoting of everything else stay as they
185
+ * are. Where that cannot be done safely the whole document is dumped, the way
186
+ * every save used to be.
187
+ */
188
+ function renderConfig(snapshot, document) {
189
+ if (snapshot.raw === null)
190
+ return yaml.dump(document);
191
+ const edited = editYamlText(snapshot.raw, snapshot.document, document);
192
+ if (edited !== null)
193
+ return edited;
194
+ if (/^\s*#/m.test(snapshot.raw)) {
195
+ const why = snapshot.raw.length > MAX_EDITABLE_CHARS
196
+ ? `it is larger than ${MAX_EDITABLE_CHARS / 1024} KB, too large to edit in place`
197
+ : "this change could not be applied in place";
198
+ logger.info(`config.yaml was rewritten in full: ${why}, so its comments were not kept`);
199
+ }
200
+ return yaml.dump(document);
201
+ }
202
+ /**
203
+ * Replace config.yaml with `document`. The new contents are staged in a
204
+ * temporary file next to it and renamed into place, so a crash or a full disk
205
+ * mid-write leaves the previous file whole — neither the gateway's watcher nor
206
+ * the next boot ever reads a half-written config. `snapshot` is the read the
207
+ * document was merged from: it tells whether the file is being created
208
+ * (owner-only, it holds tokens) or replaced (permission bits kept), and it is
209
+ * the text the changed lines are written into. Returns the revision of what
210
+ * was written.
211
+ */
212
+ export function writeConfigDocument(snapshot, document, configPath = CONFIG_PATH) {
213
+ const data = renderConfig(snapshot, document);
214
+ replaceFile(configPath, data, snapshot.mode ?? 0o600);
215
+ return revisionOf(data);
216
+ }
217
+ //# sourceMappingURL=config-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../src/shared/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,mBAAmB,CAAC;IACpC,YAAY,MAAc;QACxB,KAAK,CAAC,eAAe,MAAM,sEAAsE,CAAC,CAAC;QACnG,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,uEAAuE;AACvE,0EAA0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAetD,gEAAgE;AAChE,MAAM,YAAY,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;AAErC;;;;;;;;;;GAUG;AACH,SAAS,UAAU,CAAC,KAAsB;IACxC,OAAO,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wEAAwE;QACxE,MAAM,IAAI,GAAI,GAAqC,CAAC,IAAI,EAAE,IAAI,CAAC;QAC/D,MAAM,IAAI,yBAAyB,CACjC,+BAA+B,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5F,CAAC;IACJ,CAAC;IACD,4EAA4E;IAC5E,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACvD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,yBAAyB,CAAC,2CAA2C,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,WAAW;IACjE,IAAI,KAAa,CAAC;IAClB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC;YACtC,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACjG,MAAM,IAAI,yBAAyB,CAAC,iCAAiC,IAAI,IAAI,eAAe,GAAG,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,QAAwB,EAAE,IAAqB,EAAE,aAAqB,WAAW;IAC/G,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsE,EACtE,aAAqB,WAAW;IAEhC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACpE,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAC/F,CAAC;AAED;;yDAEyD;AACzD,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;+EAE+E;AAC/E,SAAS,UAAU,CAAC,EAAU,EAAE,MAAc;IAC5C,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,mDAAmD;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,QAAQ,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG;QAAE,OAAO;IACvE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,IAAqB,EAAE,IAAY,EAAE,MAAc;IACvF,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,oDAAoD;QAC7E,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACvB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;mFAGmF;AACnF,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AACxF,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,SAAS,WAAW,CAAC,QAAgB,EAAE,IAAqB,EAAE,IAAY;IACxE,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC,CAAC;IAClH,IAAI,CAAC;QACH,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,GAAG,CAAC;QAClD,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,kBAAkB,GAAG,IAAI,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,mDAAmD,IAAI,gCAAgC,CAAC,CAAC;QACvG,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,QAAwB,EAAE,QAAiC;IAC/E,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GACP,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,kBAAkB;YACtC,CAAC,CAAC,qBAAqB,kBAAkB,GAAG,IAAI,iCAAiC;YACjF,CAAC,CAAC,2CAA2C,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,sCAAsC,GAAG,iCAAiC,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAwB,EACxB,QAAiC,EACjC,aAAqB,WAAW;IAEhC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,20 @@
1
+ type Data = Record<string, unknown>;
2
+ /**
3
+ * The largest text {@link editYamlText} takes on. Editing in place starts by
4
+ * parsing the whole text into a tree of nodes, whatever the size of the
5
+ * change: for a file of many small values that is about 0.4 s and well over
6
+ * 100 MB per megabyte, with the gateway doing nothing else meanwhile. The
7
+ * shipped config.yaml is 6 KB. One that has grown past forty times that is
8
+ * not a file somebody keeps notes in, and is not worth it.
9
+ */
10
+ export declare const MAX_EDITABLE_CHARS: number;
11
+ /**
12
+ * `raw` with the changes from `before` to `after` applied in place, or null
13
+ * when that cannot be done safely — or when `raw` is too large to be worth it
14
+ * (see {@link MAX_EDITABLE_CHARS}). `before` must be what js-yaml loads from
15
+ * `raw` (an empty mapping for a file that holds no data). `after` is taken the
16
+ * way a dump would store it: see {@link asStored}.
17
+ */
18
+ export declare function editYamlText(raw: string, before: Data, document: Data): string | null;
19
+ export {};
20
+ //# sourceMappingURL=config-yaml-edit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config-yaml-edit.d.ts","sourceRoot":"","sources":["../../../src/shared/config-yaml-edit.ts"],"names":[],"mappings":"AA2CA,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAobpC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAa,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAYrF"}