create-relkit 0.7.10 → 0.8.0

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 (501) hide show
  1. package/dist/add-transaction-files.d.ts +1 -0
  2. package/dist/add-transaction-files.d.ts.map +1 -1
  3. package/dist/add-transaction-files.js +3 -52
  4. package/dist/add-transaction-files.js.map +1 -1
  5. package/dist/add-types.d.ts +15 -45
  6. package/dist/add-types.d.ts.map +1 -1
  7. package/dist/add-types.js +3 -9
  8. package/dist/add-types.js.map +1 -1
  9. package/dist/bin.d.ts +2 -1
  10. package/dist/bin.d.ts.map +1 -1
  11. package/dist/bin.js +15 -80
  12. package/dist/bin.js.map +1 -1
  13. package/dist/cli.d.ts +10 -0
  14. package/dist/cli.d.ts.map +1 -0
  15. package/dist/cli.js +90 -0
  16. package/dist/cli.js.map +1 -0
  17. package/dist/create-capabilities.d.ts +5 -0
  18. package/dist/create-capabilities.d.ts.map +1 -1
  19. package/dist/create-capabilities.js +5 -5
  20. package/dist/create-capabilities.js.map +1 -1
  21. package/dist/create-capabilities.types.d.ts.map +1 -1
  22. package/dist/create-capabilities.types.js +1 -0
  23. package/dist/create-capabilities.types.js.map +1 -1
  24. package/dist/create-preview.d.ts +2 -1
  25. package/dist/create-preview.d.ts.map +1 -1
  26. package/dist/create-preview.js +2 -5
  27. package/dist/create-preview.js.map +1 -1
  28. package/dist/create-resolver.d.ts +1 -0
  29. package/dist/create-resolver.d.ts.map +1 -1
  30. package/dist/create-resolver.js +11 -7
  31. package/dist/create-resolver.js.map +1 -1
  32. package/dist/dependency-patches.d.ts +1 -0
  33. package/dist/dependency-patches.d.ts.map +1 -1
  34. package/dist/dependency-patches.js +5 -0
  35. package/dist/dependency-patches.js.map +1 -1
  36. package/dist/generate-deployment-manifest.d.ts +1 -0
  37. package/dist/generate-deployment-manifest.d.ts.map +1 -1
  38. package/dist/generate-deployment-manifest.js.map +1 -1
  39. package/dist/generate-deployment.d.ts +1 -0
  40. package/dist/generate-deployment.d.ts.map +1 -1
  41. package/dist/generate-deployment.js.map +1 -1
  42. package/dist/generate-examples.d.ts +1 -0
  43. package/dist/generate-examples.d.ts.map +1 -1
  44. package/dist/generate-examples.js.map +1 -1
  45. package/dist/generate-executable.d.ts +27 -0
  46. package/dist/generate-executable.d.ts.map +1 -0
  47. package/dist/generate-executable.js +48 -0
  48. package/dist/generate-executable.js.map +1 -0
  49. package/dist/generate-files-utilities.d.ts +1 -0
  50. package/dist/generate-files-utilities.d.ts.map +1 -1
  51. package/dist/generate-files-utilities.js.map +1 -1
  52. package/dist/generate-output.d.ts +6 -0
  53. package/dist/generate-output.d.ts.map +1 -1
  54. package/dist/generate-output.js +1 -2
  55. package/dist/generate-output.js.map +1 -1
  56. package/dist/generate-output.schemas.d.ts +1 -1
  57. package/dist/generate-output.schemas.d.ts.map +1 -1
  58. package/dist/generate-output.schemas.js +1 -1
  59. package/dist/generate-output.schemas.js.map +1 -1
  60. package/dist/generate-output.types.d.ts +2 -1
  61. package/dist/generate-output.types.d.ts.map +1 -1
  62. package/dist/generate-preparation.d.ts +6 -0
  63. package/dist/generate-preparation.d.ts.map +1 -1
  64. package/dist/generate-preparation.js.map +1 -1
  65. package/dist/generate-process.d.ts +3 -24
  66. package/dist/generate-process.d.ts.map +1 -1
  67. package/dist/generate-process.js +2 -43
  68. package/dist/generate-process.js.map +1 -1
  69. package/dist/generate-result.d.ts.map +1 -1
  70. package/dist/generate-result.js.map +1 -1
  71. package/dist/generate-stage.d.ts +6 -0
  72. package/dist/generate-stage.d.ts.map +1 -1
  73. package/dist/generate-stage.js.map +1 -1
  74. package/dist/generate-stage.types.d.ts.map +1 -1
  75. package/dist/generate-stage.types.js +4 -0
  76. package/dist/generate-stage.types.js.map +1 -1
  77. package/dist/generate-workflow.d.ts.map +1 -1
  78. package/dist/generate-workflow.js.map +1 -1
  79. package/dist/generator-file-writes.d.ts +27 -0
  80. package/dist/generator-file-writes.d.ts.map +1 -0
  81. package/dist/generator-file-writes.js +63 -0
  82. package/dist/generator-file-writes.js.map +1 -0
  83. package/dist/generator-filesystem.d.ts +1 -0
  84. package/dist/generator-filesystem.d.ts.map +1 -1
  85. package/dist/generator-filesystem.js +23 -15
  86. package/dist/generator-filesystem.js.map +1 -1
  87. package/dist/generator-process.d.ts +1 -0
  88. package/dist/generator-process.d.ts.map +1 -1
  89. package/dist/generator-process.js +14 -10
  90. package/dist/generator-process.js.map +1 -1
  91. package/dist/generator-prompt.d.ts +1 -0
  92. package/dist/generator-prompt.d.ts.map +1 -1
  93. package/dist/generator-prompt.js +14 -6
  94. package/dist/generator-prompt.js.map +1 -1
  95. package/dist/index.d.ts +1 -12
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +1 -12
  98. package/dist/index.js.map +1 -1
  99. package/dist/launcher.d.ts +9 -0
  100. package/dist/launcher.d.ts.map +1 -0
  101. package/dist/launcher.js +38 -0
  102. package/dist/launcher.js.map +1 -0
  103. package/dist/options-parser.d.ts +38 -0
  104. package/dist/options-parser.d.ts.map +1 -0
  105. package/dist/options-parser.js +67 -0
  106. package/dist/options-parser.js.map +1 -0
  107. package/dist/options.d.ts +13 -36
  108. package/dist/options.d.ts.map +1 -1
  109. package/dist/options.js +30 -99
  110. package/dist/options.js.map +1 -1
  111. package/dist/prompt-driver.d.ts +1 -0
  112. package/dist/prompt-driver.d.ts.map +1 -1
  113. package/dist/prompt-driver.js +18 -13
  114. package/dist/prompt-driver.js.map +1 -1
  115. package/dist/scaffold-catalog.d.ts +21 -0
  116. package/dist/scaffold-catalog.d.ts.map +1 -1
  117. package/dist/scaffold-catalog.js +18 -0
  118. package/dist/scaffold-catalog.js.map +1 -1
  119. package/dist/templates/default/README.md +1 -1
  120. package/dist/templates/default/v1/agent/.agents/skills/relkit/SKILL.md +10 -0
  121. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/agent-apis.md +10 -7
  122. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/cli.md +14 -13
  123. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/config-environments.md +9 -3
  124. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/data-apis.md +5 -1
  125. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/observability-apis.md +30 -3
  126. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/realtime-apis.md +3 -2
  127. package/dist/templates/default/v1/agent/.agents/skills/relkit/references/testing-apis.md +2 -2
  128. package/dist/templates/default/v1/agent/package.json +9 -6
  129. package/dist/templates/default/v1/agent/relkit.config.ts +1 -1
  130. package/dist/templates/default/v1/agent/src/services/hello/agents/assistant.agent.ts +1 -1
  131. package/dist/templates/default/v1/agent/src/services/hello/agents/review.agent.ts +1 -1
  132. package/dist/templates/default/v1/agent/tests/unit/assistant.agent.test.ts +1 -1
  133. package/dist/templates/default/v1/agent/tests/unit/review.agent.test.ts +1 -1
  134. package/dist/templates/default/v1/api/.agents/skills/relkit/SKILL.md +10 -0
  135. package/dist/templates/default/v1/api/.agents/skills/relkit/references/agent-apis.md +10 -7
  136. package/dist/templates/default/v1/api/.agents/skills/relkit/references/cli.md +14 -13
  137. package/dist/templates/default/v1/api/.agents/skills/relkit/references/config-environments.md +9 -3
  138. package/dist/templates/default/v1/api/.agents/skills/relkit/references/data-apis.md +5 -1
  139. package/dist/templates/default/v1/api/.agents/skills/relkit/references/observability-apis.md +30 -3
  140. package/dist/templates/default/v1/api/.agents/skills/relkit/references/realtime-apis.md +3 -2
  141. package/dist/templates/default/v1/api/.agents/skills/relkit/references/testing-apis.md +2 -2
  142. package/dist/templates/default/v1/api/package.json +4 -4
  143. package/dist/templates/default/v1/api/relkit.config.ts +1 -1
  144. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/SKILL.md +10 -0
  145. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/agent-apis.md +10 -7
  146. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/cli.md +14 -13
  147. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/config-environments.md +9 -3
  148. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/data-apis.md +5 -1
  149. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/observability-apis.md +30 -3
  150. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/realtime-apis.md +3 -2
  151. package/dist/templates/default/v1/fullstack/.agents/skills/relkit/references/testing-apis.md +2 -2
  152. package/dist/templates/default/v1/fullstack/README.md +6 -3
  153. package/dist/templates/default/v1/fullstack/package.json +11 -7
  154. package/dist/templates/default/v1/fullstack/relkit.config.ts +1 -1
  155. package/dist/templates/default/v1/fullstack/src/services/hello/agents/assistant.agent.ts +1 -1
  156. package/dist/templates/default/v1/fullstack/src/services/hello/agents/review.agent.ts +1 -1
  157. package/dist/templates/default/v1/fullstack/tests/unit/assistant.agent.test.ts +1 -1
  158. package/dist/templates/default/v1/fullstack/tests/unit/review.agent.test.ts +1 -1
  159. package/dist/templates/default/v1/minimal/.agents/skills/relkit/SKILL.md +10 -0
  160. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/agent-apis.md +10 -7
  161. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/cli.md +14 -13
  162. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/config-environments.md +9 -3
  163. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/data-apis.md +5 -1
  164. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/observability-apis.md +30 -3
  165. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/realtime-apis.md +3 -2
  166. package/dist/templates/default/v1/minimal/.agents/skills/relkit/references/testing-apis.md +2 -2
  167. package/dist/templates/default/v1/minimal/package.json +4 -4
  168. package/dist/templates/default/v1/minimal/relkit.config.ts +1 -1
  169. package/dist/templates/default/v1/tasks/.agents/skills/relkit/SKILL.md +10 -0
  170. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/agent-apis.md +10 -7
  171. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/cli.md +14 -13
  172. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/config-environments.md +9 -3
  173. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/data-apis.md +5 -1
  174. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/observability-apis.md +30 -3
  175. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/realtime-apis.md +3 -2
  176. package/dist/templates/default/v1/tasks/.agents/skills/relkit/references/testing-apis.md +2 -2
  177. package/dist/templates/default/v1/tasks/README.md +5 -2
  178. package/dist/templates/default/v1/tasks/package.json +4 -4
  179. package/dist/templates/default/v1/tasks/relkit.config.ts +1 -1
  180. package/dist/validate.d.ts +1 -1
  181. package/package.json +127 -21
  182. package/dist/add-name.d.ts +0 -16
  183. package/dist/add-name.d.ts.map +0 -1
  184. package/dist/add-name.js +0 -22
  185. package/dist/add-name.js.map +0 -1
  186. package/dist/add-options-parser.d.ts +0 -70
  187. package/dist/add-options-parser.d.ts.map +0 -1
  188. package/dist/add-options-parser.js +0 -155
  189. package/dist/add-options-parser.js.map +0 -1
  190. package/dist/add-options-resource.d.ts +0 -13
  191. package/dist/add-options-resource.d.ts.map +0 -1
  192. package/dist/add-options-resource.js +0 -26
  193. package/dist/add-options-resource.js.map +0 -1
  194. package/dist/add-options.d.ts +0 -11
  195. package/dist/add-options.d.ts.map +0 -1
  196. package/dist/add-options.js +0 -212
  197. package/dist/add-options.js.map +0 -1
  198. package/dist/add-output.d.ts +0 -14
  199. package/dist/add-output.d.ts.map +0 -1
  200. package/dist/add-output.js +0 -54
  201. package/dist/add-output.js.map +0 -1
  202. package/dist/add-plan.d.ts +0 -29
  203. package/dist/add-plan.d.ts.map +0 -1
  204. package/dist/add-plan.js +0 -96
  205. package/dist/add-plan.js.map +0 -1
  206. package/dist/add-plan.types.d.ts +0 -13
  207. package/dist/add-plan.types.d.ts.map +0 -1
  208. package/dist/add-plan.types.js +0 -2
  209. package/dist/add-plan.types.js.map +0 -1
  210. package/dist/add-resolution-discovery.d.ts +0 -67
  211. package/dist/add-resolution-discovery.d.ts.map +0 -1
  212. package/dist/add-resolution-discovery.js +0 -134
  213. package/dist/add-resolution-discovery.js.map +0 -1
  214. package/dist/add-resolution-prompt.d.ts +0 -46
  215. package/dist/add-resolution-prompt.d.ts.map +0 -1
  216. package/dist/add-resolution-prompt.js +0 -88
  217. package/dist/add-resolution-prompt.js.map +0 -1
  218. package/dist/add-resolution-state-base.d.ts +0 -112
  219. package/dist/add-resolution-state-base.d.ts.map +0 -1
  220. package/dist/add-resolution-state-base.js +0 -141
  221. package/dist/add-resolution-state-base.js.map +0 -1
  222. package/dist/add-resolution-state.d.ts +0 -78
  223. package/dist/add-resolution-state.d.ts.map +0 -1
  224. package/dist/add-resolution-state.js +0 -101
  225. package/dist/add-resolution-state.js.map +0 -1
  226. package/dist/add-resolution-state.types.d.ts +0 -6
  227. package/dist/add-resolution-state.types.d.ts.map +0 -1
  228. package/dist/add-resolution-state.types.js +0 -2
  229. package/dist/add-resolution-state.types.js.map +0 -1
  230. package/dist/add-resolver-domain-execution.d.ts +0 -35
  231. package/dist/add-resolver-domain-execution.d.ts.map +0 -1
  232. package/dist/add-resolver-domain-execution.js +0 -101
  233. package/dist/add-resolver-domain-execution.js.map +0 -1
  234. package/dist/add-resolver-domain-input.d.ts +0 -30
  235. package/dist/add-resolver-domain-input.d.ts.map +0 -1
  236. package/dist/add-resolver-domain-input.js +0 -83
  237. package/dist/add-resolver-domain-input.js.map +0 -1
  238. package/dist/add-resolver-domain.d.ts +0 -21
  239. package/dist/add-resolver-domain.d.ts.map +0 -1
  240. package/dist/add-resolver-domain.js +0 -50
  241. package/dist/add-resolver-domain.js.map +0 -1
  242. package/dist/add-resolver-platform.d.ts +0 -21
  243. package/dist/add-resolver-platform.d.ts.map +0 -1
  244. package/dist/add-resolver-platform.js +0 -159
  245. package/dist/add-resolver-platform.js.map +0 -1
  246. package/dist/add-resolver-provider.d.ts +0 -15
  247. package/dist/add-resolver-provider.d.ts.map +0 -1
  248. package/dist/add-resolver-provider.js +0 -67
  249. package/dist/add-resolver-provider.js.map +0 -1
  250. package/dist/add-resolver-resources.d.ts +0 -21
  251. package/dist/add-resolver-resources.d.ts.map +0 -1
  252. package/dist/add-resolver-resources.js +0 -144
  253. package/dist/add-resolver-resources.js.map +0 -1
  254. package/dist/add-resolver.d.ts +0 -38
  255. package/dist/add-resolver.d.ts.map +0 -1
  256. package/dist/add-resolver.js +0 -80
  257. package/dist/add-resolver.js.map +0 -1
  258. package/dist/add-resolver.types.d.ts +0 -27
  259. package/dist/add-resolver.types.d.ts.map +0 -1
  260. package/dist/add-resolver.types.js +0 -2
  261. package/dist/add-resolver.types.js.map +0 -1
  262. package/dist/add-transaction-process.d.ts +0 -37
  263. package/dist/add-transaction-process.d.ts.map +0 -1
  264. package/dist/add-transaction-process.js +0 -54
  265. package/dist/add-transaction-process.js.map +0 -1
  266. package/dist/add-transaction-workflow.d.ts +0 -23
  267. package/dist/add-transaction-workflow.d.ts.map +0 -1
  268. package/dist/add-transaction-workflow.js +0 -77
  269. package/dist/add-transaction-workflow.js.map +0 -1
  270. package/dist/add-transaction.d.ts +0 -30
  271. package/dist/add-transaction.d.ts.map +0 -1
  272. package/dist/add-transaction.js +0 -65
  273. package/dist/add-transaction.js.map +0 -1
  274. package/dist/add-transaction.types.d.ts +0 -32
  275. package/dist/add-transaction.types.d.ts.map +0 -1
  276. package/dist/add-transaction.types.js +0 -2
  277. package/dist/add-transaction.types.js.map +0 -1
  278. package/dist/bucket-profiles.d.ts +0 -18
  279. package/dist/bucket-profiles.d.ts.map +0 -1
  280. package/dist/bucket-profiles.js +0 -40
  281. package/dist/bucket-profiles.js.map +0 -1
  282. package/dist/bucket-profiles.types.d.ts +0 -9
  283. package/dist/bucket-profiles.types.d.ts.map +0 -1
  284. package/dist/bucket-profiles.types.js +0 -2
  285. package/dist/bucket-profiles.types.js.map +0 -1
  286. package/dist/domain-artifact.d.ts +0 -76
  287. package/dist/domain-artifact.d.ts.map +0 -1
  288. package/dist/domain-artifact.js +0 -123
  289. package/dist/domain-artifact.js.map +0 -1
  290. package/dist/domain-planning.d.ts +0 -45
  291. package/dist/domain-planning.d.ts.map +0 -1
  292. package/dist/domain-planning.js +0 -93
  293. package/dist/domain-planning.js.map +0 -1
  294. package/dist/domain-planning.types.d.ts +0 -21
  295. package/dist/domain-planning.types.d.ts.map +0 -1
  296. package/dist/domain-planning.types.js +0 -2
  297. package/dist/domain-planning.types.js.map +0 -1
  298. package/dist/plan-builder-effects.d.ts +0 -124
  299. package/dist/plan-builder-effects.d.ts.map +0 -1
  300. package/dist/plan-builder-effects.js +0 -172
  301. package/dist/plan-builder-effects.js.map +0 -1
  302. package/dist/plan-builder-files.d.ts +0 -12
  303. package/dist/plan-builder-files.d.ts.map +0 -1
  304. package/dist/plan-builder-files.js +0 -99
  305. package/dist/plan-builder-files.js.map +0 -1
  306. package/dist/plan-builder-files.types.d.ts +0 -49
  307. package/dist/plan-builder-files.types.d.ts.map +0 -1
  308. package/dist/plan-builder-files.types.js +0 -2
  309. package/dist/plan-builder-files.types.js.map +0 -1
  310. package/dist/plan-builder-manifest.d.ts +0 -11
  311. package/dist/plan-builder-manifest.d.ts.map +0 -1
  312. package/dist/plan-builder-manifest.js +0 -37
  313. package/dist/plan-builder-manifest.js.map +0 -1
  314. package/dist/plan-builder.d.ts +0 -93
  315. package/dist/plan-builder.d.ts.map +0 -1
  316. package/dist/plan-builder.js +0 -118
  317. package/dist/plan-builder.js.map +0 -1
  318. package/dist/plan-builder.types.d.ts +0 -22
  319. package/dist/plan-builder.types.d.ts.map +0 -1
  320. package/dist/plan-builder.types.js +0 -2
  321. package/dist/plan-builder.types.js.map +0 -1
  322. package/dist/plan-manifest.d.ts +0 -18
  323. package/dist/plan-manifest.d.ts.map +0 -1
  324. package/dist/plan-manifest.js +0 -100
  325. package/dist/plan-manifest.js.map +0 -1
  326. package/dist/plan-manifest.types.d.ts +0 -13
  327. package/dist/plan-manifest.types.d.ts.map +0 -1
  328. package/dist/plan-manifest.types.js +0 -2
  329. package/dist/plan-manifest.types.js.map +0 -1
  330. package/dist/project-catalog.d.ts +0 -17
  331. package/dist/project-catalog.d.ts.map +0 -1
  332. package/dist/project-catalog.js +0 -69
  333. package/dist/project-catalog.js.map +0 -1
  334. package/dist/project-discovery-app.d.ts +0 -14
  335. package/dist/project-discovery-app.d.ts.map +0 -1
  336. package/dist/project-discovery-app.js +0 -193
  337. package/dist/project-discovery-app.js.map +0 -1
  338. package/dist/project-discovery-artifacts.d.ts +0 -15
  339. package/dist/project-discovery-artifacts.d.ts.map +0 -1
  340. package/dist/project-discovery-artifacts.js +0 -107
  341. package/dist/project-discovery-artifacts.js.map +0 -1
  342. package/dist/project-discovery-artifacts.types.d.ts +0 -22
  343. package/dist/project-discovery-artifacts.types.d.ts.map +0 -1
  344. package/dist/project-discovery-artifacts.types.js +0 -2
  345. package/dist/project-discovery-artifacts.types.js.map +0 -1
  346. package/dist/project-discovery-database.d.ts +0 -21
  347. package/dist/project-discovery-database.d.ts.map +0 -1
  348. package/dist/project-discovery-database.js +0 -64
  349. package/dist/project-discovery-database.js.map +0 -1
  350. package/dist/project-discovery-facts.d.ts +0 -12
  351. package/dist/project-discovery-facts.d.ts.map +0 -1
  352. package/dist/project-discovery-facts.js +0 -64
  353. package/dist/project-discovery-facts.js.map +0 -1
  354. package/dist/project-discovery-members.d.ts +0 -16
  355. package/dist/project-discovery-members.d.ts.map +0 -1
  356. package/dist/project-discovery-members.js +0 -57
  357. package/dist/project-discovery-members.js.map +0 -1
  358. package/dist/project-discovery-types.d.ts +0 -68
  359. package/dist/project-discovery-types.d.ts.map +0 -1
  360. package/dist/project-discovery-types.js +0 -2
  361. package/dist/project-discovery-types.js.map +0 -1
  362. package/dist/project-discovery.d.ts +0 -34
  363. package/dist/project-discovery.d.ts.map +0 -1
  364. package/dist/project-discovery.js +0 -56
  365. package/dist/project-discovery.js.map +0 -1
  366. package/dist/project-discovery.service.types.d.ts +0 -13
  367. package/dist/project-discovery.service.types.d.ts.map +0 -1
  368. package/dist/project-discovery.service.types.js +0 -2
  369. package/dist/project-discovery.service.types.js.map +0 -1
  370. package/dist/provider-planning-definitions.d.ts +0 -78
  371. package/dist/provider-planning-definitions.d.ts.map +0 -1
  372. package/dist/provider-planning-definitions.js +0 -152
  373. package/dist/provider-planning-definitions.js.map +0 -1
  374. package/dist/provider-planning.d.ts +0 -41
  375. package/dist/provider-planning.d.ts.map +0 -1
  376. package/dist/provider-planning.js +0 -124
  377. package/dist/provider-planning.js.map +0 -1
  378. package/dist/provider-planning.types.d.ts +0 -14
  379. package/dist/provider-planning.types.d.ts.map +0 -1
  380. package/dist/provider-planning.types.js +0 -2
  381. package/dist/provider-planning.types.js.map +0 -1
  382. package/dist/provider-profile-definition.d.ts +0 -45
  383. package/dist/provider-profile-definition.d.ts.map +0 -1
  384. package/dist/provider-profile-definition.js +0 -93
  385. package/dist/provider-profile-definition.js.map +0 -1
  386. package/dist/render-ai-sources.d.ts +0 -38
  387. package/dist/render-ai-sources.d.ts.map +0 -1
  388. package/dist/render-ai-sources.js +0 -70
  389. package/dist/render-ai-sources.js.map +0 -1
  390. package/dist/render-ai.d.ts +0 -60
  391. package/dist/render-ai.d.ts.map +0 -1
  392. package/dist/render-ai.js +0 -111
  393. package/dist/render-ai.js.map +0 -1
  394. package/dist/render-auth-database.d.ts +0 -33
  395. package/dist/render-auth-database.d.ts.map +0 -1
  396. package/dist/render-auth-database.js +0 -69
  397. package/dist/render-auth-database.js.map +0 -1
  398. package/dist/render-auth-schema.d.ts +0 -8
  399. package/dist/render-auth-schema.d.ts.map +0 -1
  400. package/dist/render-auth-schema.js +0 -93
  401. package/dist/render-auth-schema.js.map +0 -1
  402. package/dist/render-auth-sources.d.ts +0 -17
  403. package/dist/render-auth-sources.d.ts.map +0 -1
  404. package/dist/render-auth-sources.js +0 -31
  405. package/dist/render-auth-sources.js.map +0 -1
  406. package/dist/render-auth.d.ts +0 -30
  407. package/dist/render-auth.d.ts.map +0 -1
  408. package/dist/render-auth.js +0 -79
  409. package/dist/render-auth.js.map +0 -1
  410. package/dist/render-database-sources.d.ts +0 -26
  411. package/dist/render-database-sources.d.ts.map +0 -1
  412. package/dist/render-database-sources.js +0 -82
  413. package/dist/render-database-sources.js.map +0 -1
  414. package/dist/render-database.d.ts +0 -34
  415. package/dist/render-database.d.ts.map +0 -1
  416. package/dist/render-database.js +0 -67
  417. package/dist/render-database.js.map +0 -1
  418. package/dist/render-database.types.d.ts +0 -15
  419. package/dist/render-database.types.d.ts.map +0 -1
  420. package/dist/render-database.types.js +0 -2
  421. package/dist/render-database.types.js.map +0 -1
  422. package/dist/render-domain-callables.d.ts +0 -67
  423. package/dist/render-domain-callables.d.ts.map +0 -1
  424. package/dist/render-domain-callables.js +0 -99
  425. package/dist/render-domain-callables.js.map +0 -1
  426. package/dist/render-domain-events.d.ts +0 -59
  427. package/dist/render-domain-events.d.ts.map +0 -1
  428. package/dist/render-domain-events.js +0 -92
  429. package/dist/render-domain-events.js.map +0 -1
  430. package/dist/render-domain-jobs.d.ts +0 -56
  431. package/dist/render-domain-jobs.d.ts.map +0 -1
  432. package/dist/render-domain-jobs.js +0 -84
  433. package/dist/render-domain-jobs.js.map +0 -1
  434. package/dist/render-domain-register.d.ts +0 -22
  435. package/dist/render-domain-register.d.ts.map +0 -1
  436. package/dist/render-domain-register.js +0 -31
  437. package/dist/render-domain-register.js.map +0 -1
  438. package/dist/render-domain-sources.d.ts +0 -82
  439. package/dist/render-domain-sources.d.ts.map +0 -1
  440. package/dist/render-domain-sources.js +0 -197
  441. package/dist/render-domain-sources.js.map +0 -1
  442. package/dist/render-domain.d.ts +0 -5
  443. package/dist/render-domain.d.ts.map +0 -1
  444. package/dist/render-domain.js +0 -4
  445. package/dist/render-domain.js.map +0 -1
  446. package/dist/render-domain.types.d.ts +0 -15
  447. package/dist/render-domain.types.d.ts.map +0 -1
  448. package/dist/render-domain.types.js +0 -2
  449. package/dist/render-domain.types.js.map +0 -1
  450. package/dist/render-resource-sources.d.ts +0 -16
  451. package/dist/render-resource-sources.d.ts.map +0 -1
  452. package/dist/render-resource-sources.js +0 -43
  453. package/dist/render-resource-sources.js.map +0 -1
  454. package/dist/render-resources.d.ts +0 -58
  455. package/dist/render-resources.d.ts.map +0 -1
  456. package/dist/render-resources.js +0 -100
  457. package/dist/render-resources.js.map +0 -1
  458. package/dist/render-route-sources.d.ts +0 -27
  459. package/dist/render-route-sources.d.ts.map +0 -1
  460. package/dist/render-route-sources.js +0 -56
  461. package/dist/render-route-sources.js.map +0 -1
  462. package/dist/render-routes.d.ts +0 -71
  463. package/dist/render-routes.d.ts.map +0 -1
  464. package/dist/render-routes.js +0 -111
  465. package/dist/render-routes.js.map +0 -1
  466. package/dist/render-service-members.d.ts +0 -32
  467. package/dist/render-service-members.d.ts.map +0 -1
  468. package/dist/render-service-members.js +0 -61
  469. package/dist/render-service-members.js.map +0 -1
  470. package/dist/render-service-requests.d.ts +0 -35
  471. package/dist/render-service-requests.d.ts.map +0 -1
  472. package/dist/render-service-requests.js +0 -62
  473. package/dist/render-service-requests.js.map +0 -1
  474. package/dist/render-service-support.d.ts +0 -37
  475. package/dist/render-service-support.d.ts.map +0 -1
  476. package/dist/render-service-support.js +0 -74
  477. package/dist/render-service-support.js.map +0 -1
  478. package/dist/render-service.d.ts +0 -31
  479. package/dist/render-service.d.ts.map +0 -1
  480. package/dist/render-service.js +0 -53
  481. package/dist/render-service.js.map +0 -1
  482. package/dist/render-service.types.d.ts +0 -13
  483. package/dist/render-service.types.d.ts.map +0 -1
  484. package/dist/render-service.types.js +0 -2
  485. package/dist/render-service.types.js.map +0 -1
  486. package/dist/scaffold-layout.d.ts +0 -10
  487. package/dist/scaffold-layout.d.ts.map +0 -1
  488. package/dist/scaffold-layout.js +0 -29
  489. package/dist/scaffold-layout.js.map +0 -1
  490. package/dist/source-edit.d.ts +0 -46
  491. package/dist/source-edit.d.ts.map +0 -1
  492. package/dist/source-edit.js +0 -81
  493. package/dist/source-edit.js.map +0 -1
  494. package/dist/source-factory-edit.d.ts +0 -78
  495. package/dist/source-factory-edit.d.ts.map +0 -1
  496. package/dist/source-factory-edit.js +0 -156
  497. package/dist/source-factory-edit.js.map +0 -1
  498. package/dist/source-import-edit.d.ts +0 -9
  499. package/dist/source-import-edit.d.ts.map +0 -1
  500. package/dist/source-import-edit.js +0 -71
  501. package/dist/source-import-edit.js.map +0 -1
@@ -89,10 +89,11 @@ export default defineApp({
89
89
  defaults: { realtime: "default" },
90
90
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
91
91
  server: { port: 3000 },
92
- inspector: { port: 3210 },
93
92
  });
94
93
  ```
95
94
 
96
- Merge these fields into an existing `defineApp` while preserving its other providers and settings. Redis supports fanout across application instances. Provider storage, retention, and Redis persistence determine recovery guarantees. Run `bun run check`, `bun run typecheck`, then test publication, browser subscription, reconnect, and gap recovery. Inspect channels in the Inspector while `bun run dev` is running.
95
+ Merge these fields into an existing `defineApp` while preserving its other providers and settings. Redis supports fanout across application instances. Provider storage, retention, and Redis persistence determine recovery guarantees. Run `bun run check`, `bun run typecheck`, then test publication, browser subscription, reconnect, and gap recovery.
96
+
97
+ Inspection is optional. Set `inspector: { enabled: true }` to enable the authenticated backend bridge, then install and run the separate `@relkit/inspector` tool with `relkit-inspector --project-root .`. Its UI defaults to port `3210`; change it with the tool's `--port` flag. The app's `inspector.connection.host/port` settings configure only the bridge. See the [Inspector setup](https://relkit.dev/docs/operations/inspector) for prerequisites and history ownership.
97
98
 
98
99
  The current `relkit add` kinds do not include `channel`. Create the descriptor and provider configuration in the app source.
@@ -51,9 +51,9 @@ Use `app.http.request`, `get`, or other client methods to assert status, body, a
51
51
 
52
52
  - `createTestCacheFake`, `createTestBucketFake`, `createTestJobFake`, and `createTestEventFake` provide owned, inspectable test dependencies. `createTestFakes` groups native clients. Close any separately created fake after use. Replace every configured provider profile the graph needs, not only the one under direct assertion.
53
53
  - `createTestHttpClient` exercises a standalone in-memory HTTP application. Use `createTestApplication` when route discovery and service wiring matter. `createTestRealtimeProvider` and `createTestAgentStateProvider` supply local stateful provider replacements.
54
- - `createTestModel`, `createTestAgent`, and `assertAgentTrace` support deterministic agent execution. Use scripted responses and inspect tool calls or traces instead of live model calls or sleeps.
54
+ - Import `createTestModel`, `createTestAgent`, and `assertAgentTrace` from `@relkit/langchain/testing` for deterministic native agent execution. Use scripted responses and inspect tool calls or traces instead of live model calls or sleeps.
55
55
  - For jobs, assert behavior beyond the descriptor shape: input/output, accepted run handle, progress, retry or cancellation policy, and idempotency where applicable. Use the test job adapter or fake appropriate to the contract.
56
- - For database and auth integration, migrate an isolated temporary database before starting the application. Supply both parsed RELKIT environment and any native auth process environment required by the provider; close the app before removing test-owned files. Test public and protected requests with real cookies and separate users. A direct function mock does not verify migrations, sessions, or route protection.
56
+ - Import `createTestApplication` from `@relkit/testing/drizzle` for database services, or `@relkit/testing/better-auth` for auth with its borrowed database. The generic root does not acquire native auth/database dependencies. For database and auth integration, migrate an isolated temporary database before starting the application. Supply both parsed RELKIT environment and any native auth process environment required by the provider; close the app before removing test-owned files. Test public and protected requests with real cookies and separate users. A direct function mock does not verify migrations, sessions, or route protection.
57
57
  - For realtime, streaming, and observability, test the exposed route or channel contract and recorded events/spans as applicable. Use a running backend for actual transport, connection, and browser behavior.
58
58
 
59
59
  ## Run the generated project checks
@@ -11,17 +11,17 @@
11
11
  "test:unit": "bun test tests/unit",
12
12
  "test:integration": "bun test tests/integration",
13
13
  "build": "relkit build",
14
- "start": "relkit start",
14
+ "start": "NODE_ENV=production bun run --no-env-file .relkit/build/server/index.js",
15
15
  "graph": "relkit graph print"
16
16
  },
17
17
  "dependencies": {
18
- "@relkit/app": "0.7.9",
18
+ "@relkit/app": "0.8.0",
19
19
  "effect": "4.0.1"
20
20
  },
21
21
  "devDependencies": {
22
22
  "@types/bun": "1.3.10",
23
- "@relkit/cli": "0.7.10",
24
- "@relkit/testing": "0.7.9",
23
+ "@relkit/cli": "0.8.0",
24
+ "@relkit/testing": "0.8.0",
25
25
  "typescript": "5.9.3"
26
26
  }
27
27
  }
@@ -1,3 +1,4 @@
1
+ /** Declares backend defaults; inspection remains disabled unless explicitly enabled. */
1
2
  import { defineApp } from "@relkit/app/config";
2
3
  import env from "@app/platform/env.js";
3
4
  // relkit:create:deployment-imports
@@ -6,6 +7,5 @@ export default defineApp({
6
7
  env,
7
8
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
8
9
  server: { port: 3000, maxBodyBytes: 1_048_576 },
9
- inspector: { port: 3210 },
10
10
  // relkit:create:deployment
11
11
  });
@@ -21,6 +21,16 @@ Recommend optional modules only when they solve a concrete part of this task: fo
21
21
 
22
22
  Default to backend work. Do not introduce frontend pages, app.js, assets.css or demo interfaces unless requested. Preserve existing frontend files, explicitly selected fullstack functionality and the framework Inspector. For users and orders, define separate resource endpoints with explicit input/output contracts, validation and applicable authorization; avoid a public table dispatcher controlled by an entity parameter. Internal tables and infrastructure services need no public endpoint. Preserve intentional protocol handlers such as the Better Auth mount and shared internal helpers.
23
23
 
24
+ Inspection is disabled when omitted. To inspect development work, select
25
+ `inspector: { enabled: true }`; this starts a private bridge on `127.0.0.1:0`,
26
+ configured through `inspector.connection.host/port`. Install `@relkit/inspector`
27
+ separately and run `relkit-inspector --project-root . --port 3211` in another
28
+ terminal when UI port 3211 is wanted (the tool default is 3210). Keep dev and
29
+ Inspector as separate processes. Preserve `.relkit/observability`; the tool owns
30
+ its diagnostic DuckDB history. Production builds exclude rich inspection and do
31
+ not require UI/storage packages in the backend closure. See the observability
32
+ reference for runtimes, availability, private discovery and history ownership.
33
+
24
34
  ## Design domain ownership
25
35
 
26
36
  Before scaffolding business behavior, identify its owning domain. For a request spanning multiple business capabilities, include a compact ownership map in the implementation plan: service name, owned rules/state, public operations/events, dependencies, and any transaction spanning capabilities. Then proceed with authorized implementation; the map is not another approval gate.
@@ -1,18 +1,21 @@
1
1
  # Agents, tools, and prompts
2
2
 
3
- | API | Import | Role |
4
- | ----------------------------------------------- | -------------------- | ------------------------------------ |
5
- | `defineAgent`, `defineGraph`, `defineGraphNode` | `@relkit/app/agents` | Model-driven agent or explicit graph |
6
- | `defineTool` | `@relkit/app/tools` | Policy-controlled view of a function |
7
- | `definePrompt` | `@relkit/app` | Reusable instructions |
8
- | `z` | `@relkit/app/schema` | Agent and tool schemas |
3
+ | API | Import | Role |
4
+ | ------------------------------------------------------ | -------------------- | ----------------------------------------- |
5
+ | Generic `defineAgent` | `@relkit/app/agents` | SDK-free agent declaration |
6
+ | Native `defineAgent`, `defineGraph`, `defineGraphNode` | `@relkit/langchain` | LangChain model execution or native graph |
7
+ | `defineTool` | `@relkit/app/tools` | Policy-controlled view of a function |
8
+ | `definePrompt` | `@relkit/app` | Reusable instructions |
9
+ | `z` | `@relkit/app/schema` | Agent and tool schemas |
10
+
11
+ The native integration requires application-installed `@langchain/core`, `@langchain/langgraph`, `langchain` and `langsmith` at the supported versions. Add `deepagents` only for a deep-agent declaration. Check/build/start validate selected requirements before readiness; they do not install missing peers. Generic descriptors, tools and agent-state provider contracts do not select a native engine.
9
12
 
10
13
  ## `defineAgent`
11
14
 
12
15
  Use `defineAgent` when a model should choose among tools. The agent template provides an executable offline LangChain model example. This shortened form uses the same public options:
13
16
 
14
17
  ```ts
15
- import { defineAgent } from "@relkit/app/agents";
18
+ import { defineAgent } from "@relkit/langchain";
16
19
  import { z } from "@relkit/app/schema";
17
20
  import { FakeToolCallingModel } from "langchain";
18
21
  import lookup from "@app/services/hello/tools/lookup.tool.js";
@@ -51,19 +51,20 @@ For streaming responses, scaffold a function and route, then edit the function's
51
51
 
52
52
  ## Inspect and run the app
53
53
 
54
- | Goal | Command |
55
- | --------------------------------------- | ----------------------------------- |
56
- | Validate the application graph | `bun run check` |
57
- | Typecheck and test | `bun run typecheck`, `bun run test` |
58
- | Start app, inspector, and API reference | `bun run dev` |
59
- | Inspect the graph | `bun run relkit graph print` |
60
- | Inspect environment value status | `bun run relkit env list` |
61
- | Validate active environment values | `bun run relkit env check` |
62
- | Explain one environment declaration | `bun run relkit env explain NAME` |
63
- | Render a safe environment example | `bun run relkit env example` |
64
- | Check local prerequisites | `bun run relkit doctor` |
65
- | Inspect local service status | `bun run relkit local status` |
66
- | Build or start a built app | `bun run build`, `bun run start` |
54
+ | Goal | Command |
55
+ | ---------------------------------------------------------- | ----------------------------------------------------- |
56
+ | Validate the application graph | `bun run check` |
57
+ | Typecheck and test | `bun run typecheck`, `bun run test` |
58
+ | Start the app and selected development features | `bun run dev` |
59
+ | Start separately installed Inspector for an enabled bridge | `bunx --no-install relkit-inspector --project-root .` |
60
+ | Inspect the graph | `bun run relkit graph print` |
61
+ | Inspect environment value status | `bun run relkit env list` |
62
+ | Validate active environment values | `bun run relkit env check` |
63
+ | Explain one environment declaration | `bun run relkit env explain NAME` |
64
+ | Render a safe environment example | `bun run relkit env example` |
65
+ | Check local prerequisites | `bun run relkit doctor` |
66
+ | Inspect local service status | `bun run relkit local status` |
67
+ | Build or start a built app | `bun run build`, `bun run start` |
67
68
 
68
69
  Use `bun run relkit --help` to discover additional `graph`, `env`, `local`, `jobs`, `client`, and deployment commands. Start Docker-backed local services with `bun run relkit local up --detach` only when the app actually declares and needs them. Deployment commands require a configured deployment target.
69
70
 
@@ -36,7 +36,7 @@ Mark credentials with `env.secret()`; keep actual values outside source control.
36
36
 
37
37
  ## `defineApp`: topology and policy
38
38
 
39
- In `relkit.config.ts`, the baseline application contains the environment contract, telemetry redaction, backend settings, and Inspector settings:
39
+ In `relkit.config.ts`, the baseline application contains the environment contract, telemetry redaction and backend settings. Inspection is omitted and disabled:
40
40
 
41
41
  ```ts
42
42
  import { defineApp } from "@relkit/app/config";
@@ -46,7 +46,6 @@ export default defineApp({
46
46
  env,
47
47
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
48
48
  server: { port: 3000, maxBodyBytes: 1_048_576 },
49
- inspector: { port: 3210 },
50
49
  });
51
50
  ```
52
51
 
@@ -70,7 +69,6 @@ export default defineApp({
70
69
  defaults: { cache: "requests", realtime: "default" },
71
70
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
72
71
  server: { port: 3000, maxBodyBytes: 1_048_576 },
73
- inspector: { port: 3210 },
74
72
  });
75
73
  ```
76
74
 
@@ -80,6 +78,14 @@ Platform fragments may explicitly export server, Inspector, telemetry, deploymen
80
78
 
81
79
  CLI `--environment` selects provider configuration; `RELKIT_ENV` selects the application environment. `.env` and `.env.local` supply runtime values according to existing CLI loading; `.env.example` is informational and is not loaded as credentials.
82
80
 
81
+ Enable development inspection only when requested with `inspector: { enabled: true }`.
82
+ Its authenticated bridge defaults to `127.0.0.1:0`; optional fixed binding uses
83
+ `inspector.connection.host/port`. The separately installed `@relkit/inspector`
84
+ owns its UI (default 3210, selected with its own `--port`) and local history.
85
+ The obsolete `inspector.port` setting is rejected. Installing the tool does not
86
+ enable the application bridge; production excludes rich inspection regardless
87
+ of this development selection. See [inspection and history](observability-apis.md).
88
+
83
89
  ## Inspect and verify environment values
84
90
 
85
91
  From the generated project root:
@@ -30,6 +30,8 @@ export default defineDrizzleService({
30
30
 
31
31
  Open the native connection in the `client({ env })` factory and close it with `dispose` when needed. Discovery does not run the factory. Generate and review migrations with the installed Drizzle tooling; service creation does not create tables or apply migrations. After `bun run check`, generated context declarations provide typed `context.database`.
32
32
 
33
+ For a model callback that uses the native database, import `defineModel` from the selected dialect leaf: `@relkit/drizzle/sqlite`, `/pg` or `/mysql`. This keeps other drivers outside the declaration closure. A MySQL development/typecheck installation also supplies `mysql2` for the upstream native database declarations.
34
+
33
35
  ## Version and apply migration source
34
36
 
35
37
  New grouped scaffolds configure `src/services/database/migrations` beside the database service and schema. Keep SQL and required Drizzle metadata in Git, outside ignored `.relkit/`. One shared database has one ordered history, including authentication tables; do not create separate histories for business services. Existing flat apps retain their selected database service directory.
@@ -57,7 +59,9 @@ export default defineBetterAuthService({
57
59
  });
58
60
  ```
59
61
 
60
- Better Auth uses the same Drizzle connection and needs its tables in that schema. Mount `auth.handler` directly with `export const ALL = defineRoute({ handler: auth.handler })` under the auth base path. Supply a stable server-side `BETTER_AUTH_SECRET` and correct public `BETTER_AUTH_URL`; the scaffold only adds environment examples. Protect application routes and enforce ownership separately from signing in.
62
+ The root descriptor and session types remain available from `@relkit/better-auth`; native activation is owned by `@relkit/better-auth/drizzle` and selected by the server producer. Better Auth uses the same Drizzle connection and needs its tables in that schema. Mount `auth.handler` directly with `export const ALL = defineRoute({ handler: auth.handler })` under the auth base path. Supply a stable server-side `BETTER_AUTH_SECRET` and correct public `BETTER_AUTH_URL`; the scaffold only adds environment examples. Protect application routes and enforce ownership separately from signing in.
63
+
64
+ The selected auth scaffold keeps Better Auth 1.7.1 and the existing migration contract. It emits an override to the official `@better-fetch/fetch` 1.3.2 typing fix for Bun/npm and pnpm, and installs `@cloudflare/workers-types` 4.20250121.0 as a development-only requirement of the upstream D1 declarations. Preserve these fields and the separate Drizzle patch when extending the project; none applies SQL.
61
65
 
62
66
  ## `defineCache` and `defineBucket`
63
67
 
@@ -44,10 +44,37 @@ export default defineApp({
44
44
  exportSampling: { traceRate: 0.25, minimumLogLevel: "info" },
45
45
  },
46
46
  server: { port: 3000 },
47
- inspector: { port: 3210 },
47
+ inspector: { enabled: true },
48
48
  });
49
49
  ```
50
50
 
51
- The template already supplies redaction. `localRetention` bounds development history; `exportSampling` controls remote export independently of local capture. Add named Sentry or OTLP exporters only when those integrations and their secret environment bindings are configured. Redact before storage or export. No `relkit add observability` kind exists; configure `telemetry` in `defineApp`.
51
+ The template already supplies redaction and omits inspection. This example explicitly
52
+ enables the private development bridge. `localRetention` bounds the app's memory
53
+ buffer; `exportSampling` controls remote export independently. Defaults are 2,048
54
+ records and 2 MiB, with configurable ceilings of 65,536 records and 64 MiB. Records
55
+ and persistence batches have a 1 MiB ceiling. Missing records after overflow or
56
+ shutdown expiry are reported as incomplete history. Add named Sentry or OTLP
57
+ exporters only when selected integrations and secret bindings are configured.
58
+ Redact before storage or export. No `relkit add observability` kind exists.
52
59
 
53
- Run `bun run dev`, make one identifiable HTTP request, then inspect Requests, Traces, and Logs in the Inspector. Use `bun run dev -- --verbose` for DEBUG terminal output or `--json` for structured terminal records. Development history is stored in `.relkit/observability/observability.duckdb`; this is diagnostic history, not business storage.
60
+ Run `bun run dev` and make an identifiable HTTP request. Install the separately
61
+ available `@relkit/inspector` tool in the consumer project, then run
62
+ `bunx --no-install relkit-inspector --project-root .` or
63
+ `npx --no-install relkit-inspector --project-root .` in another terminal. These
64
+ installed runner forms were tested; consult the installed package and release
65
+ availability before assuming a new version has been published. The tool needs
66
+ Bun 1.3.10 or newer and Node 20.9 or newer, and its UI defaults to 3210. Use
67
+ `--port 3211` on that tool for a different UI port. App bridge binding defaults
68
+ to `127.0.0.1:0` and uses `inspector.connection.host/port` when explicitly configured.
69
+
70
+ The tool reads private `.relkit/connections` metadata without executing app config.
71
+ Zero live sessions means disconnected; multiple sessions require an explicit
72
+ `--connection-file`. Keep credential files private and out of URLs/browser code.
73
+ The tool alone owns `.relkit/observability/observability.duckdb` and its worker.
74
+ Preserve this directory across restarts and package cache removal; never delete
75
+ the database to resolve another writer's lock. `--history-directory` selects an
76
+ explicit project-bound persistent directory. Foreign-project directories are rejected.
77
+ Stopping/uninstalling the tool leaves the app running; stopping the app leaves
78
+ retained tool history readable. Production emits no rich Inspector registration.
79
+ This history is separate from jobs, checkpoints, migrations and business data.
80
+ Use dev `--verbose` for DEBUG terminal output or global `--json` for structured records.
@@ -89,10 +89,11 @@ export default defineApp({
89
89
  defaults: { realtime: "default" },
90
90
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
91
91
  server: { port: 3000 },
92
- inspector: { port: 3210 },
93
92
  });
94
93
  ```
95
94
 
96
- Merge these fields into an existing `defineApp` while preserving its other providers and settings. Redis supports fanout across application instances. Provider storage, retention, and Redis persistence determine recovery guarantees. Run `bun run check`, `bun run typecheck`, then test publication, browser subscription, reconnect, and gap recovery. Inspect channels in the Inspector while `bun run dev` is running.
95
+ Merge these fields into an existing `defineApp` while preserving its other providers and settings. Redis supports fanout across application instances. Provider storage, retention, and Redis persistence determine recovery guarantees. Run `bun run check`, `bun run typecheck`, then test publication, browser subscription, reconnect, and gap recovery.
96
+
97
+ Inspection is optional. Set `inspector: { enabled: true }` to enable the authenticated backend bridge, then install and run the separate `@relkit/inspector` tool with `relkit-inspector --project-root .`. Its UI defaults to port `3210`; change it with the tool's `--port` flag. The app's `inspector.connection.host/port` settings configure only the bridge. See the [Inspector setup](https://relkit.dev/docs/operations/inspector) for prerequisites and history ownership.
97
98
 
98
99
  The current `relkit add` kinds do not include `channel`. Create the descriptor and provider configuration in the app source.
@@ -51,9 +51,9 @@ Use `app.http.request`, `get`, or other client methods to assert status, body, a
51
51
 
52
52
  - `createTestCacheFake`, `createTestBucketFake`, `createTestJobFake`, and `createTestEventFake` provide owned, inspectable test dependencies. `createTestFakes` groups native clients. Close any separately created fake after use. Replace every configured provider profile the graph needs, not only the one under direct assertion.
53
53
  - `createTestHttpClient` exercises a standalone in-memory HTTP application. Use `createTestApplication` when route discovery and service wiring matter. `createTestRealtimeProvider` and `createTestAgentStateProvider` supply local stateful provider replacements.
54
- - `createTestModel`, `createTestAgent`, and `assertAgentTrace` support deterministic agent execution. Use scripted responses and inspect tool calls or traces instead of live model calls or sleeps.
54
+ - Import `createTestModel`, `createTestAgent`, and `assertAgentTrace` from `@relkit/langchain/testing` for deterministic native agent execution. Use scripted responses and inspect tool calls or traces instead of live model calls or sleeps.
55
55
  - For jobs, assert behavior beyond the descriptor shape: input/output, accepted run handle, progress, retry or cancellation policy, and idempotency where applicable. Use the test job adapter or fake appropriate to the contract.
56
- - For database and auth integration, migrate an isolated temporary database before starting the application. Supply both parsed RELKIT environment and any native auth process environment required by the provider; close the app before removing test-owned files. Test public and protected requests with real cookies and separate users. A direct function mock does not verify migrations, sessions, or route protection.
56
+ - Import `createTestApplication` from `@relkit/testing/drizzle` for database services, or `@relkit/testing/better-auth` for auth with its borrowed database. The generic root does not acquire native auth/database dependencies. For database and auth integration, migrate an isolated temporary database before starting the application. Supply both parsed RELKIT environment and any native auth process environment required by the provider; close the app before removing test-owned files. Test public and protected requests with real cookies and separate users. A direct function mock does not verify migrations, sessions, or route protection.
57
57
  - For realtime, streaming, and observability, test the exposed route or channel contract and recorded events/spans as applicable. Use a running backend for actual transport, connection, and browser behavior.
58
58
 
59
59
  ## Run the generated project checks
@@ -3,8 +3,11 @@
3
3
  This maintained task/provider candidate is exercised internally. Public jobs
4
4
  creation remains disabled until exact native and readiness certification passes.
5
5
 
6
- A small RelKit task and job project. The selected `--jobs` provider runs account-free
7
- through Docker and keeps task code in a domain-owned worker.
6
+ A small RelKit task and job project with a selected provider and domain-owned worker.
7
+ Its package manifest declares that provider's adapter/native SDKs. Follow the current
8
+ provider guide before running it: Inngest and Effect MQ have documented local paths,
9
+ while Trigger's provider/server compatibility remains unverified. A successful install
10
+ does not certify provider-native execution.
8
11
 
9
12
  ```sh
10
13
  bun install
@@ -9,17 +9,17 @@
9
9
  "typecheck": "tsc --noEmit",
10
10
  "test": "bun test",
11
11
  "build": "relkit build",
12
- "start": "relkit start",
12
+ "start": "NODE_ENV=production bun run --no-env-file .relkit/build/server/index.js",
13
13
  "jobs:trigger": "relkit jobs trigger --job exportOrders --input-file examples/export-orders.json --operation-id example-trigger"
14
14
  },
15
15
  "dependencies": {
16
- "@relkit/app": "0.7.9",
16
+ "@relkit/app": "0.8.0",
17
17
  "effect": "4.0.1"
18
18
  },
19
19
  "devDependencies": {
20
20
  "@types/bun": "1.3.10",
21
- "@relkit/cli": "0.7.10",
22
- "@relkit/testing": "0.7.9",
21
+ "@relkit/cli": "0.8.0",
22
+ "@relkit/testing": "0.8.0",
23
23
  "typescript": "5.9.3"
24
24
  }
25
25
  }
@@ -1,3 +1,4 @@
1
+ /** Declares task application defaults with inspection disabled until selected. */
1
2
  import { defineApp } from "@relkit/app/config";
2
3
  import env from "@app/platform/env.js";
3
4
  // relkit:create:deployment-imports
@@ -5,7 +6,6 @@ import env from "@app/platform/env.js";
5
6
  export default defineApp({
6
7
  env,
7
8
  server: { port: 3000, maxBodyBytes: 1_048_576 },
8
- inspector: { port: 3210 },
9
9
  telemetry: { redaction: { mode: "development-redacted", maxBytes: 65_536 } },
10
10
  // relkit:create:deployment
11
11
  });
@@ -22,7 +22,7 @@ export declare function validatePackageName(value: unknown): asserts value is st
22
22
  * @param context - Caller-owned settings and cancellation.
23
23
  * @returns The canonical safe destination path after name, ancestry and broad-path validation.
24
24
  */
25
- export declare const resolveCreateDestinationEffect: (options: Pick<CreateOptions, "name" | "directory">, context?: CreateValidationContext | undefined) => Effect.Effect<string, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
25
+ export declare const resolveCreateDestinationEffect: (options: Pick<CreateOptions, "directory" | "name">, context?: CreateValidationContext | undefined) => Effect.Effect<string, import("./generator-errors.js").GeneratorDomainError, GeneratorPaths>;
26
26
  /**
27
27
  * Validates destination state using the same path service as the existing synchronous API.
28
28
  * @param options - Explicit options retaining existing defaults.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-relkit",
3
- "version": "0.7.10",
3
+ "version": "0.8.0",
4
4
  "description": "Create a RELKIT application from a supported project template.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -28,26 +28,128 @@
28
28
  "create-relkit": "./dist/bin.js"
29
29
  },
30
30
  "exports": {
31
- "./catalog-resolution": {
32
- "types": "./src/catalog-resolution.ts",
33
- "default": "./src/catalog-resolution.ts"
34
- },
35
31
  ".": {
36
32
  "types": "./dist/index.d.ts",
37
33
  "import": "./dist/index.js"
34
+ },
35
+ "./cli": {
36
+ "types": "./dist/cli.d.ts",
37
+ "import": "./dist/cli.js"
38
+ },
39
+ "./launcher": {
40
+ "types": "./dist/launcher.d.ts",
41
+ "import": "./dist/launcher.js"
42
+ },
43
+ "./internal/add-transaction-files": {
44
+ "types": "./dist/add-transaction-files.d.ts",
45
+ "import": "./dist/add-transaction-files.js"
46
+ },
47
+ "./internal/add-types": {
48
+ "types": "./dist/add-types.d.ts",
49
+ "import": "./dist/add-types.js"
50
+ },
51
+ "./internal/build-catalog": {
52
+ "types": "./dist/build-catalog.d.ts",
53
+ "import": "./dist/build-catalog.js"
54
+ },
55
+ "./internal/catalog-resolution": {
56
+ "types": "./dist/catalog-resolution.d.ts",
57
+ "import": "./dist/catalog-resolution.js"
58
+ },
59
+ "./internal/dependency-patch-installation": {
60
+ "types": "./dist/dependency-patch-installation.d.ts",
61
+ "import": "./dist/dependency-patch-installation.js"
62
+ },
63
+ "./internal/dependency-patches": {
64
+ "types": "./dist/dependency-patches.d.ts",
65
+ "import": "./dist/dependency-patches.js"
66
+ },
67
+ "./internal/generate": {
68
+ "types": "./dist/generate.d.ts",
69
+ "import": "./dist/generate.js"
70
+ },
71
+ "./internal/generate-process": {
72
+ "types": "./dist/generate-process.d.ts",
73
+ "import": "./dist/generate-process.js"
74
+ },
75
+ "./internal/generator-cleanup": {
76
+ "types": "./dist/generator-cleanup.d.ts",
77
+ "import": "./dist/generator-cleanup.js"
78
+ },
79
+ "./internal/generator-errors": {
80
+ "types": "./dist/generator-errors.d.ts",
81
+ "import": "./dist/generator-errors.js"
82
+ },
83
+ "./internal/generator-filesystem": {
84
+ "types": "./dist/generator-filesystem.d.ts",
85
+ "import": "./dist/generator-filesystem.js"
86
+ },
87
+ "./internal/generator-filesystem.types": {
88
+ "types": "./dist/generator-filesystem.types.d.ts",
89
+ "import": "./dist/generator-filesystem.types.js"
90
+ },
91
+ "./internal/generator-paths": {
92
+ "types": "./dist/generator-paths.d.ts",
93
+ "import": "./dist/generator-paths.js"
94
+ },
95
+ "./internal/generator-process": {
96
+ "types": "./dist/generator-process.d.ts",
97
+ "import": "./dist/generator-process.js"
98
+ },
99
+ "./internal/generator-process.types": {
100
+ "types": "./dist/generator-process.types.d.ts",
101
+ "import": "./dist/generator-process.types.js"
102
+ },
103
+ "./internal/generator-prompt": {
104
+ "types": "./dist/generator-prompt.d.ts",
105
+ "import": "./dist/generator-prompt.js"
106
+ },
107
+ "./internal/generator-runtime": {
108
+ "types": "./dist/generator-runtime.d.ts",
109
+ "import": "./dist/generator-runtime.js"
110
+ },
111
+ "./internal/options": {
112
+ "types": "./dist/options.d.ts",
113
+ "import": "./dist/options.js"
114
+ },
115
+ "./internal/project-manifest.schemas": {
116
+ "types": "./dist/project-manifest.schemas.d.ts",
117
+ "import": "./dist/project-manifest.schemas.js"
118
+ },
119
+ "./internal/prompt-driver": {
120
+ "types": "./dist/prompt-driver.d.ts",
121
+ "import": "./dist/prompt-driver.js"
122
+ },
123
+ "./internal/prompt-driver.types": {
124
+ "types": "./dist/prompt-driver.types.d.ts",
125
+ "import": "./dist/prompt-driver.types.js"
126
+ },
127
+ "./internal/scaffold-catalog": {
128
+ "types": "./dist/scaffold-catalog.d.ts",
129
+ "import": "./dist/scaffold-catalog.js"
130
+ },
131
+ "./internal/scaffold-catalog.types": {
132
+ "types": "./dist/scaffold-catalog.types.d.ts",
133
+ "import": "./dist/scaffold-catalog.types.js"
134
+ },
135
+ "./internal/validate-paths": {
136
+ "types": "./dist/validate-paths.d.ts",
137
+ "import": "./dist/validate-paths.js"
138
+ },
139
+ "./catalog-resolution": {
140
+ "types": "./src/catalog-resolution.ts",
141
+ "default": "./src/catalog-resolution.ts"
38
142
  }
39
143
  },
40
144
  "scripts": {
41
- "build": "tsc -b && bun ../../scripts/package-create-relkit-templates.ts",
145
+ "build": "tsc -b && bun run ../../scripts/prune-moved-authoring-artifacts.ts creator && bun ../../scripts/package-create-relkit-templates.ts",
42
146
  "check": "tsc -b --pretty false",
43
147
  "typecheck": "tsc -b --pretty false && bun ../../scripts/package-create-relkit-templates.ts"
44
148
  },
45
149
  "dependencies": {
46
150
  "@clack/prompts": "1.7.0",
47
- "@relkit/compiler": "0.7.9",
48
- "typescript": "5.9.3",
49
151
  "effect": "4.0.1",
50
- "@relkit/contracts": "0.7.9"
152
+ "@relkit/contracts": "0.8.0"
51
153
  },
52
154
  "devDependencies": {
53
155
  "@effect/vitest": "4.0.1",
@@ -56,7 +158,9 @@
56
158
  "relkit": {
57
159
  "buildCatalog": {
58
160
  "dependencies": {
161
+ "@better-fetch/fetch": "1.3.2",
59
162
  "@clack/prompts": "1.7.0",
163
+ "@cloudflare/workers-types": "4.20250121.0",
60
164
  "@effect/docgen": "4.0.1",
61
165
  "@effect/platform-bun": "4.0.1",
62
166
  "@effect/platform-node-shared": "4.0.1",
@@ -83,6 +187,7 @@
83
187
  "hono": "4.13.7",
84
188
  "inngest": "4.20.0",
85
189
  "langchain": "1.5.10",
190
+ "langsmith": "0.10.8",
86
191
  "lucide-react": "1.34.0",
87
192
  "next": "16.3.8",
88
193
  "prettier": "3.9.6",
@@ -103,18 +208,19 @@
103
208
  }
104
209
  },
105
210
  "providerVersions": {
106
- "@relkit/aws": "0.7.9",
107
- "@relkit/pulumi": "0.7.9",
108
- "@relkit/docker": "0.7.9",
109
- "@relkit/local": "0.7.9",
110
- "@relkit/inngest": "0.7.9",
111
- "@relkit/trigger": "0.7.9",
112
- "@relkit/effect-mq": "0.7.9",
113
- "@relkit/better-auth": "0.7.9",
114
- "@relkit/cloudflare": "0.7.9",
115
- "@relkit/drizzle": "0.7.9",
116
- "@relkit/redis": "0.7.9",
117
- "@relkit/s3": "0.7.9"
211
+ "@relkit/aws": "0.8.0",
212
+ "@relkit/pulumi": "0.8.0",
213
+ "@relkit/docker": "0.7.11",
214
+ "@relkit/local": "0.7.11",
215
+ "@relkit/langchain": "0.7.11",
216
+ "@relkit/inngest": "0.8.0",
217
+ "@relkit/trigger": "0.8.0",
218
+ "@relkit/effect-mq": "0.8.0",
219
+ "@relkit/better-auth": "0.8.0",
220
+ "@relkit/cloudflare": "0.7.11",
221
+ "@relkit/drizzle": "0.8.0",
222
+ "@relkit/redis": "0.8.0",
223
+ "@relkit/s3": "0.7.11"
118
224
  }
119
225
  }
120
226
  }
@@ -1,16 +0,0 @@
1
- /**
2
- * Normalized user label, file stem, binding identifier and descriptor ID segment.
3
- */
4
- export interface NormalizedArtifactName {
5
- readonly input: string;
6
- readonly fileStem: string;
7
- readonly identifier: string;
8
- readonly idSegment: string;
9
- }
10
- /**
11
- * Normalizes one friendly label for source files, bindings, and stable IDs.
12
- * @param input - Friendly artifact label, normalized with Unicode NFKC.
13
- * @returns A frozen normalized input, kebab-case file/ID segment and camel-case binding.
14
- */
15
- export declare function normalizeArtifactName(input: string): NormalizedArtifactName;
16
- //# sourceMappingURL=add-name.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"add-name.d.ts","sourceRoot":"","sources":["../src/add-name.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAiB3E"}
package/dist/add-name.js DELETED
@@ -1,22 +0,0 @@
1
- import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
2
- /**
3
- * Normalizes one friendly label for source files, bindings, and stable IDs.
4
- * @param input - Friendly artifact label, normalized with Unicode NFKC.
5
- * @returns A frozen normalized input, kebab-case file/ID segment and camel-case binding.
6
- */
7
- export function normalizeArtifactName(input) {
8
- const value = input.normalize("NFKC").trim();
9
- const fileStem = value
10
- .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
11
- .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
12
- .replace(/[^A-Za-z0-9]+/g, "-")
13
- .replace(/^-+|-+$/g, "")
14
- .replace(/-+/g, "-")
15
- .toLowerCase();
16
- if (!/^[a-z][a-z0-9-]*$/.test(fileStem)) {
17
- throw new AddScaffoldError(ADD_FAILURE_CODES.usage, `Name must normalize to a value beginning with a letter: ${input}`);
18
- }
19
- const identifier = fileStem.replace(/-([a-z0-9])/g, (_, letter) => letter.toUpperCase());
20
- return Object.freeze({ input: value, fileStem, identifier, idSegment: fileStem });
21
- }
22
- //# sourceMappingURL=add-name.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"add-name.js","sourceRoot":"","sources":["../src/add-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAYrE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,KAAK;SACnB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,gBAAgB,CACxB,iBAAiB,CAAC,KAAK,EACvB,2DAA2D,KAAK,EAAE,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACjG,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AACpF,CAAC"}