akanjs 3.0.0-alpha.7 → 3.0.0-alpha.71

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 (719) hide show
  1. package/CHANGELOG.md +103 -0
  2. package/README.ko.md +1 -1
  3. package/README.md +1 -1
  4. package/base/baseEnv.ts +7 -4
  5. package/base/primitiveRegistry.ts +59 -12
  6. package/base/symbols.ts +4 -0
  7. package/client/capacitor.ts +34 -0
  8. package/client/clientRuntime.ts +5 -0
  9. package/client/csrTypes.ts +4 -3
  10. package/client/index.ts +1 -0
  11. package/client/locale.ts +2 -2
  12. package/client/router.ts +7 -7
  13. package/client/sharedContext.ts +31 -0
  14. package/client/translator.ts +2 -2
  15. package/client/types.ts +3 -3
  16. package/common/Logger.ts +280 -67
  17. package/common/clientAddress.ts +40 -0
  18. package/common/deepObjectify.ts +24 -9
  19. package/common/index.ts +42 -1
  20. package/common/logContext.ts +27 -0
  21. package/common/mcpExposure.ts +114 -0
  22. package/common/pathGetLoose.ts +31 -0
  23. package/common/pathSet.ts +17 -5
  24. package/common/plainFieldsOf.ts +13 -0
  25. package/common/routeConvention.ts +22 -12
  26. package/common/websocketBinaryFrame.ts +46 -0
  27. package/constant/crystalize.ts +94 -28
  28. package/constant/dateSlot.ts +62 -0
  29. package/constant/deserialize.ts +3 -2
  30. package/constant/fieldInfo.ts +43 -3
  31. package/constant/fieldQueryMeta.ts +35 -0
  32. package/constant/getDefault.ts +16 -11
  33. package/constant/hydrationPlan.ts +72 -0
  34. package/constant/immerify.ts +4 -6
  35. package/constant/index.ts +5 -0
  36. package/constant/labelOf.ts +26 -0
  37. package/constant/mask.ts +67 -0
  38. package/constant/purify.ts +17 -11
  39. package/constant/textFieldPaths.ts +13 -7
  40. package/constant/types.ts +19 -13
  41. package/constant/via.ts +24 -17
  42. package/dictionary/DictionaryLookup.ts +30 -0
  43. package/dictionary/agent.dictionary.ts +31 -0
  44. package/dictionary/agentTurn.dictionary.ts +29 -0
  45. package/dictionary/base.dictionary.ts +81 -0
  46. package/dictionary/dictInfo.ts +11 -2
  47. package/dictionary/dictionary.ts +9 -3
  48. package/dictionary/index.ts +1 -0
  49. package/dictionary/trans.ts +2 -2
  50. package/document/documentQuery.ts +1 -0
  51. package/document/filterMeta.ts +77 -12
  52. package/document/index.ts +1 -0
  53. package/document/noDocumentError.ts +12 -0
  54. package/document/types.ts +0 -1
  55. package/fetch/agentTurn.ts +19 -0
  56. package/fetch/client/fetchClient.ts +137 -37
  57. package/fetch/client/httpClient.ts +95 -20
  58. package/fetch/client/wsClient.ts +27 -12
  59. package/fetch/fetchType/appliedReturn.type.ts +65 -44
  60. package/fetch/fetchType/endpointFetch.type.ts +17 -8
  61. package/fetch/fetchType/sliceFetch.type.ts +27 -50
  62. package/fetch/index.ts +1 -0
  63. package/index.ts +80 -6
  64. package/local/apps/akan/akan-local.db +0 -0
  65. package/local/apps/akan/akan-local.db-shm +0 -0
  66. package/local/apps/akan/akan-local.db-wal +0 -0
  67. package/local/apps/akan/akan-local_solid.db +0 -0
  68. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  69. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  70. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  71. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  72. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  73. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  74. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  75. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  76. package/package.json +27 -18
  77. package/server/akanApp.ts +278 -138
  78. package/server/akanAppHeaders.ts +16 -2
  79. package/server/akanOption.ts +63 -8
  80. package/server/akanServer.ts +387 -32
  81. package/server/animatedImage.ts +83 -0
  82. package/server/assetEncoding.ts +4 -24
  83. package/server/binaryPubsub.ts +55 -0
  84. package/server/console.ts +110 -101
  85. package/server/consoleEvaluator.ts +51 -0
  86. package/server/consolePasteFilter.ts +91 -0
  87. package/server/consoleSession.ts +242 -0
  88. package/server/contentEncoding.ts +83 -0
  89. package/server/devtools/signalSerializer.ts +2 -2
  90. package/server/devtools/types.ts +4 -4
  91. package/server/di/diLifecycle.ts +123 -13
  92. package/server/di/predefinedAdaptor.ts +6 -0
  93. package/server/di/utils.ts +40 -0
  94. package/server/imageOptimizer.ts +154 -57
  95. package/server/lifecycle/runtimeDir.ts +14 -0
  96. package/server/lifecycle/shutdownManager.ts +1 -1
  97. package/server/logging/childOutputReader.ts +137 -0
  98. package/server/logging/hubFileSink.ts +39 -0
  99. package/server/logging/logControlSocket.ts +173 -0
  100. package/server/logging/logForwarder.ts +131 -0
  101. package/server/logging/logHub.ts +0 -0
  102. package/server/logging/logQuery.ts +130 -0
  103. package/server/logging/logStdoutWriter.ts +39 -0
  104. package/server/logging/logStreamRoute.ts +87 -0
  105. package/server/logging/logTailClient.ts +161 -0
  106. package/server/mcp/McpAuth.ts +177 -0
  107. package/server/mcp/McpDispatcher.ts +289 -0
  108. package/server/mcp/McpEventStream.ts +24 -0
  109. package/server/mcp/McpExecutionContext.ts +105 -0
  110. package/server/mcp/McpRouter.ts +621 -0
  111. package/server/mcp/index.ts +5 -0
  112. package/server/processMetricsCollector.ts +1 -1
  113. package/server/resolver/database.resolver.ts +5 -4
  114. package/server/resolver/signal.resolver.ts +208 -86
  115. package/server/routeTreeBuilder.ts +10 -8
  116. package/server/routing/apiRouter.ts +44 -14
  117. package/server/routing/appWsData.ts +24 -2
  118. package/server/routing/eventStream.ts +93 -0
  119. package/server/routing/soloAppRoutes.ts +50 -0
  120. package/server/rscWorker.tsx +36 -22
  121. package/server/rscWorkerHost.ts +59 -8
  122. package/server/semaphore.ts +22 -0
  123. package/server/subRouteIndexDocument.tsx +61 -0
  124. package/server/systemPageDocument.tsx +3 -3
  125. package/server/systemPages.tsx +49 -16
  126. package/server/types.tsx +28 -0
  127. package/server/vendor/akanjs-fetch.ts +1 -0
  128. package/server/webRouter.ts +96 -39
  129. package/service/adapt.ts +4 -4
  130. package/service/agent.service.ts +81 -0
  131. package/service/base.service.ts +2 -1
  132. package/service/index.ts +1 -0
  133. package/service/injectInfo.ts +8 -3
  134. package/service/ipcTypes.ts +6 -0
  135. package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
  136. package/service/predefinedAdaptor/database.adaptor.ts +68 -37
  137. package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
  138. package/service/predefinedAdaptor/index.ts +3 -0
  139. package/service/predefinedAdaptor/insightQuery.ts +183 -0
  140. package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
  141. package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
  142. package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
  143. package/service/predefinedAdaptor/role.adaptor.ts +2 -0
  144. package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
  145. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
  146. package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
  147. package/service/predefinedAdaptor/solidSqlite.ts +11 -9
  148. package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
  149. package/service/serve.ts +16 -9
  150. package/service/toolNames.ts +119 -0
  151. package/signal/agent/AgentCatalogue.ts +165 -0
  152. package/signal/agent/index.ts +1 -0
  153. package/signal/agent.signal.ts +38 -0
  154. package/signal/agentTurn.ts +8 -0
  155. package/signal/agentTurnStream.ts +60 -0
  156. package/signal/base.signal.ts +2 -1
  157. package/signal/endpointInfo.ts +38 -2
  158. package/signal/guard.ts +28 -1
  159. package/signal/guards.ts +49 -1
  160. package/signal/index.ts +6 -0
  161. package/signal/intercept.ts +4 -4
  162. package/signal/internalArg.ts +21 -4
  163. package/signal/mcp/McpDocument.ts +326 -0
  164. package/signal/mcp/McpProgress.ts +106 -0
  165. package/signal/mcp/McpUriTemplate.ts +80 -0
  166. package/signal/mcp/Msg.ts +368 -0
  167. package/signal/mcp/index.ts +5 -0
  168. package/signal/mcp/mcpProtocol.ts +120 -0
  169. package/signal/middleware.ts +3 -3
  170. package/signal/openapi/openapi.ts +36 -173
  171. package/signal/schema/JsonSchemaBuilder.ts +221 -0
  172. package/signal/schema/index.ts +1 -0
  173. package/signal/serializer/fetch.serializer.ts +51 -0
  174. package/signal/signalContext.ts +324 -76
  175. package/signal/slice.ts +62 -27
  176. package/signal/trace.ts +268 -9
  177. package/signal/types.ts +55 -4
  178. package/store/action.ts +34 -41
  179. package/store/actionTag.ts +33 -0
  180. package/store/agent/AgentBridge.ts +87 -0
  181. package/store/agent/AgentContext.ts +71 -0
  182. package/store/agent/AgentPrompts.ts +111 -0
  183. package/store/agent/ScreenReader.ts +349 -0
  184. package/store/agent/ScreenSettle.ts +45 -0
  185. package/store/agent/ScreenTarget.ts +135 -0
  186. package/store/agent/StoreCatalogue.ts +116 -0
  187. package/store/agent/StoreSurfaceSource.ts +225 -0
  188. package/store/agent/index.ts +13 -0
  189. package/store/agent/storeSurface.ts +28 -0
  190. package/store/agent/types.ts +16 -0
  191. package/store/agentic/AgentValue.ts +119 -0
  192. package/store/agentic/StExposeBuilder.ts +47 -0
  193. package/store/agentic/StExposeDraft.ts +24 -0
  194. package/store/agentic/StStateBuilder.ts +85 -0
  195. package/store/agentic/StStateDraft.ts +23 -0
  196. package/store/agentic/StToolBuilder.ts +279 -0
  197. package/store/agentic/StToolDraft.ts +22 -0
  198. package/store/agentic/attachAgentic.ts +33 -0
  199. package/store/agentic/formFields.ts +194 -0
  200. package/store/agentic/index.ts +12 -0
  201. package/store/agentic/useFieldTool.ts +183 -0
  202. package/store/agentic/useFormTools.ts +77 -0
  203. package/store/agentic/useRelationFieldTool.ts +113 -0
  204. package/store/baseSt.ts +1 -1
  205. package/store/databaseStateNames.ts +31 -0
  206. package/store/formSetterNames.ts +35 -0
  207. package/store/index.ts +8 -0
  208. package/store/rootStore.ts +3 -1
  209. package/store/sliceRole.ts +36 -0
  210. package/store/state.ts +2 -12
  211. package/store/store.ts +9 -0
  212. package/store/storeInstance.ts +185 -20
  213. package/store/storeRegistry.ts +39 -1
  214. package/store/types.ts +5 -0
  215. package/store/withSelector.ts +5 -4
  216. package/test/index.ts +1 -1
  217. package/test/registerDom.ts +4 -0
  218. package/test/sampleOf.ts +2 -0
  219. package/test/signalTestRuntime.ts +5 -5
  220. package/test/testServer.ts +14 -11
  221. package/types/base/baseEnv.d.ts +1 -1
  222. package/types/base/primitiveRegistry.d.ts +20 -8
  223. package/types/base/symbols.d.ts +4 -0
  224. package/types/client/capacitor.d.ts +39 -0
  225. package/types/client/clientRuntime.d.ts +7 -0
  226. package/types/client/index.d.ts +1 -0
  227. package/types/client/sharedContext.d.ts +21 -0
  228. package/types/client/types.d.ts +5 -3
  229. package/types/common/Logger.d.ts +88 -6
  230. package/types/common/clientAddress.d.ts +19 -0
  231. package/types/common/deepObjectify.d.ts +4 -2
  232. package/types/common/index.d.ts +8 -2
  233. package/types/common/logContext.d.ts +17 -0
  234. package/types/common/mcpExposure.d.ts +64 -0
  235. package/types/common/pathGetLoose.d.ts +8 -0
  236. package/types/common/plainFieldsOf.d.ts +6 -0
  237. package/types/common/routeConvention.d.ts +6 -0
  238. package/types/common/websocketBinaryFrame.d.ts +17 -0
  239. package/types/constant/constantRegistry.d.ts +2 -10
  240. package/types/constant/crystalize.d.ts +5 -0
  241. package/types/constant/dateSlot.d.ts +14 -0
  242. package/types/constant/fieldInfo.d.ts +20 -3
  243. package/types/constant/fieldQueryMeta.d.ts +17 -0
  244. package/types/constant/getDefault.d.ts +8 -0
  245. package/types/constant/hydrationPlan.d.ts +24 -0
  246. package/types/constant/index.d.ts +5 -0
  247. package/types/constant/labelOf.d.ts +7 -0
  248. package/types/constant/mask.d.ts +41 -0
  249. package/types/constant/purify.d.ts +2 -2
  250. package/types/constant/types.d.ts +5 -5
  251. package/types/dictionary/DictionaryLookup.d.ts +14 -0
  252. package/types/dictionary/agent.dictionary.d.ts +1 -0
  253. package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
  254. package/types/dictionary/base.dictionary.d.ts +1 -1
  255. package/types/dictionary/dictInfo.d.ts +7 -1
  256. package/types/dictionary/dictionary.d.ts +11 -9
  257. package/types/dictionary/index.d.ts +1 -0
  258. package/types/document/filterMeta.d.ts +24 -4
  259. package/types/document/index.d.ts +1 -0
  260. package/types/document/noDocumentError.d.ts +12 -0
  261. package/types/document/types.d.ts +0 -1
  262. package/types/fetch/agentTurn.d.ts +475 -0
  263. package/types/fetch/client/fetchClient.d.ts +12 -0
  264. package/types/fetch/client/httpClient.d.ts +2 -1
  265. package/types/fetch/fetchType/appliedReturn.type.d.ts +37 -18
  266. package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
  267. package/types/fetch/fetchType/sliceFetch.type.d.ts +11 -15
  268. package/types/fetch/index.d.ts +1 -0
  269. package/types/index.d.ts +74 -10
  270. package/types/server/akanApp.d.ts +12 -0
  271. package/types/server/akanAppHeaders.d.ts +7 -1
  272. package/types/server/akanOption.d.ts +36 -6
  273. package/types/server/akanServer.d.ts +67 -9
  274. package/types/server/animatedImage.d.ts +7 -0
  275. package/types/server/assetEncoding.d.ts +1 -1
  276. package/types/server/binaryPubsub.d.ts +18 -0
  277. package/types/server/console.d.ts +11 -1
  278. package/types/server/consoleEvaluator.d.ts +2 -0
  279. package/types/server/consolePasteFilter.d.ts +11 -0
  280. package/types/server/consoleSession.d.ts +22 -0
  281. package/types/server/contentEncoding.d.ts +28 -0
  282. package/types/server/devtools/types.d.ts +4 -4
  283. package/types/server/di/diLifecycle.d.ts +10 -2
  284. package/types/server/di/predefinedAdaptor.d.ts +4 -1
  285. package/types/server/di/utils.d.ts +16 -0
  286. package/types/server/lifecycle/runtimeDir.d.ts +5 -0
  287. package/types/server/logging/childOutputReader.d.ts +40 -0
  288. package/types/server/logging/hubFileSink.d.ts +18 -0
  289. package/types/server/logging/logControlSocket.d.ts +60 -0
  290. package/types/server/logging/logForwarder.d.ts +37 -0
  291. package/types/server/logging/logHub.d.ts +70 -0
  292. package/types/server/logging/logQuery.d.ts +31 -0
  293. package/types/server/logging/logStdoutWriter.d.ts +35 -0
  294. package/types/server/logging/logStreamRoute.d.ts +20 -0
  295. package/types/server/logging/logTailClient.d.ts +42 -0
  296. package/types/server/mcp/McpAuth.d.ts +62 -0
  297. package/types/server/mcp/McpDispatcher.d.ts +61 -0
  298. package/types/server/mcp/McpEventStream.d.ts +17 -0
  299. package/types/server/mcp/McpExecutionContext.d.ts +44 -0
  300. package/types/server/mcp/McpRouter.d.ts +65 -0
  301. package/types/server/mcp/index.d.ts +5 -0
  302. package/types/server/mcp.d.ts +1 -0
  303. package/types/server/resolver/signal.resolver.d.ts +7 -4
  304. package/types/server/routing/apiRouter.d.ts +2 -1
  305. package/types/server/routing/appWsData.d.ts +13 -1
  306. package/types/server/routing/eventStream.d.ts +23 -0
  307. package/types/server/routing/soloAppRoutes.d.ts +17 -0
  308. package/types/server/rscWorkerHost.d.ts +4 -1
  309. package/types/server/semaphore.d.ts +5 -0
  310. package/types/server/subRouteIndexDocument.d.ts +8 -0
  311. package/types/server/systemPageDocument.d.ts +1 -0
  312. package/types/server/systemPages.d.ts +5 -0
  313. package/types/server/types.d.ts +16 -0
  314. package/types/server/vendor/akanjs-fetch.d.ts +1 -0
  315. package/types/server/webRouter.d.ts +15 -4
  316. package/types/service/adapt.d.ts +2 -2
  317. package/types/service/agent.service.d.ts +32 -0
  318. package/types/service/base.service.d.ts +4 -0
  319. package/types/service/index.d.ts +1 -0
  320. package/types/service/injectInfo.d.ts +2 -2
  321. package/types/service/ipcTypes.d.ts +12 -0
  322. package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
  323. package/types/service/predefinedAdaptor/database.adaptor.d.ts +9 -3
  324. package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
  325. package/types/service/predefinedAdaptor/index.d.ts +3 -0
  326. package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
  327. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
  328. package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
  329. package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
  330. package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
  331. package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
  332. package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
  333. package/types/service/serve.d.ts +3 -3
  334. package/types/service/toolNames.d.ts +35 -0
  335. package/types/signal/agent/AgentCatalogue.d.ts +100 -0
  336. package/types/signal/agent/index.d.ts +1 -0
  337. package/types/signal/agent.d.ts +1 -0
  338. package/types/signal/agent.signal.d.ts +24 -0
  339. package/types/signal/agentTurn.d.ts +9 -0
  340. package/types/signal/agentTurnStream.d.ts +24 -0
  341. package/types/signal/base.signal.d.ts +1 -1
  342. package/types/signal/endpointInfo.d.ts +21 -3
  343. package/types/signal/guard.d.ts +12 -0
  344. package/types/signal/guards.d.ts +23 -1
  345. package/types/signal/index.d.ts +6 -0
  346. package/types/signal/intercept.d.ts +2 -2
  347. package/types/signal/internalArg.d.ts +22 -6
  348. package/types/signal/mcp/McpDocument.d.ts +84 -0
  349. package/types/signal/mcp/McpProgress.d.ts +40 -0
  350. package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
  351. package/types/signal/mcp/Msg.d.ts +143 -0
  352. package/types/signal/mcp/index.d.ts +5 -0
  353. package/types/signal/mcp/mcpProtocol.d.ts +107 -0
  354. package/types/signal/mcp.d.ts +1 -0
  355. package/types/signal/middleware.d.ts +7 -7
  356. package/types/signal/openapi/openapi.d.ts +3 -3
  357. package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
  358. package/types/signal/schema/index.d.ts +1 -0
  359. package/types/signal/schema.d.ts +1 -0
  360. package/types/signal/signalContext.d.ts +67 -8
  361. package/types/signal/slice.d.ts +42 -15
  362. package/types/signal/trace.d.ts +52 -2
  363. package/types/signal/types.d.ts +53 -4
  364. package/types/store/action.d.ts +7 -5
  365. package/types/store/actionTag.d.ts +21 -0
  366. package/types/store/agent/AgentBridge.d.ts +37 -0
  367. package/types/store/agent/AgentContext.d.ts +16 -0
  368. package/types/store/agent/AgentPrompts.d.ts +31 -0
  369. package/types/store/agent/ScreenReader.d.ts +29 -0
  370. package/types/store/agent/ScreenSettle.d.ts +22 -0
  371. package/types/store/agent/ScreenTarget.d.ts +34 -0
  372. package/types/store/agent/StoreCatalogue.d.ts +26 -0
  373. package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
  374. package/types/store/agent/index.d.ts +11 -0
  375. package/types/store/agent/storeSurface.d.ts +14 -0
  376. package/types/store/agent/types.d.ts +15 -0
  377. package/types/store/agent.d.ts +1 -0
  378. package/types/store/agentic/AgentValue.d.ts +43 -0
  379. package/types/store/agentic/StExposeBuilder.d.ts +21 -0
  380. package/types/store/agentic/StExposeDraft.d.ts +13 -0
  381. package/types/store/agentic/StStateBuilder.d.ts +21 -0
  382. package/types/store/agentic/StStateDraft.d.ts +12 -0
  383. package/types/store/agentic/StToolBuilder.d.ts +56 -0
  384. package/types/store/agentic/StToolDraft.d.ts +13 -0
  385. package/types/store/agentic/attachAgentic.d.ts +25 -0
  386. package/types/store/agentic/formFields.d.ts +53 -0
  387. package/types/store/agentic/index.d.ts +12 -0
  388. package/types/store/agentic/useFieldTool.d.ts +22 -0
  389. package/types/store/agentic/useFormTools.d.ts +19 -0
  390. package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
  391. package/types/store/agentic.d.ts +1 -0
  392. package/types/store/baseSt.d.ts +35 -39
  393. package/types/store/databaseStateNames.d.ts +25 -0
  394. package/types/store/formSetterNames.d.ts +30 -0
  395. package/types/store/index.d.ts +7 -0
  396. package/types/store/rootStore.d.ts +5 -1
  397. package/types/store/sliceRole.d.ts +25 -0
  398. package/types/store/store.d.ts +5 -1
  399. package/types/store/storeInstance.d.ts +33 -1
  400. package/types/store/storeRegistry.d.ts +5 -0
  401. package/types/store/types.d.ts +4 -0
  402. package/types/store/withSelector.d.ts +5 -4
  403. package/types/test/index.d.ts +1 -1
  404. package/types/test/registerDom.d.ts +1 -0
  405. package/types/test/signalTestRuntime.d.ts +2 -3
  406. package/types/test/testServer.d.ts +6 -4
  407. package/types/ui/Agent/Approval.d.ts +8 -0
  408. package/types/ui/Agent/Attach.d.ts +16 -0
  409. package/types/ui/Agent/Bubble.d.ts +26 -0
  410. package/types/ui/Agent/Chat.d.ts +91 -0
  411. package/types/ui/Agent/ChatCommands.d.ts +34 -0
  412. package/types/ui/Agent/Composer.d.ts +23 -0
  413. package/types/ui/Agent/Context.d.ts +13 -0
  414. package/types/ui/Agent/Dock.d.ts +17 -0
  415. package/types/ui/Agent/Guide.d.ts +9 -0
  416. package/types/ui/Agent/History.d.ts +26 -0
  417. package/types/ui/Agent/Launcher.d.ts +16 -0
  418. package/types/ui/Agent/Markdown.d.ts +19 -0
  419. package/types/ui/Agent/Menu.d.ts +18 -0
  420. package/types/ui/Agent/Mic.d.ts +8 -0
  421. package/types/ui/Agent/Question.d.ts +14 -0
  422. package/types/ui/Agent/Section.d.ts +10 -0
  423. package/types/ui/Agent/Skip.d.ts +22 -0
  424. package/types/ui/Agent/StateKey.d.ts +16 -0
  425. package/types/ui/Agent/Tool.d.ts +15 -0
  426. package/types/ui/Agent/Transcript.d.ts +13 -0
  427. package/types/ui/Agent/Zone.d.ts +48 -0
  428. package/types/ui/Agent/agentSessionOf.d.ts +27 -0
  429. package/types/ui/Agent/attachment.d.ts +34 -0
  430. package/types/ui/Agent/fetchRunner.d.ts +12 -0
  431. package/types/ui/Agent/index.d.ts +19 -0
  432. package/types/ui/Agent/index_.d.ts +1 -0
  433. package/types/ui/Agent/markdownBlocks.d.ts +35 -0
  434. package/types/ui/Agent/markdownSpans.d.ts +2 -0
  435. package/types/ui/Agent/markdownTable.d.ts +16 -0
  436. package/types/ui/Agent/sessionHistory.d.ts +14 -0
  437. package/types/ui/Agent/sessionView.d.ts +15 -0
  438. package/types/ui/Agent/tokenCount.d.ts +6 -0
  439. package/types/ui/Agent/useChatAttachments.d.ts +24 -0
  440. package/types/ui/Agent/useChatVoice.d.ts +30 -0
  441. package/types/ui/Agent/useDraftRecall.d.ts +14 -0
  442. package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
  443. package/types/ui/Agent/useSlashMenu.d.ts +24 -0
  444. package/types/ui/Agent/voice.d.ts +71 -0
  445. package/types/ui/Agent.d.ts +1 -0
  446. package/types/ui/Badge.d.ts +1 -1
  447. package/types/ui/Button.d.ts +1 -1
  448. package/types/ui/Constant/Graph.d.ts +10 -0
  449. package/types/ui/Constant/index.d.ts +2 -1
  450. package/types/ui/Constant/schemaGraph.d.ts +39 -0
  451. package/types/ui/Data/Dashboard.d.ts +16 -3
  452. package/types/ui/Data/Insight.d.ts +1 -1
  453. package/types/ui/Data/ListContainer.d.ts +15 -7
  454. package/types/ui/Data/QueryMaker.d.ts +45 -3
  455. package/types/ui/Data/RefPicker.d.ts +16 -0
  456. package/types/ui/Data/dataExport.d.ts +5 -0
  457. package/types/ui/Data/dataText.d.ts +6 -0
  458. package/types/ui/Data/index.d.ts +2 -0
  459. package/types/ui/Data/index_.d.ts +1 -0
  460. package/types/ui/DatePicker.d.ts +15 -11
  461. package/types/ui/Dialog/LegacyModal.d.ts +13 -0
  462. package/types/ui/Dialog/Provider.d.ts +3 -1
  463. package/types/ui/Dialog/context.d.ts +9 -1
  464. package/types/ui/Dialog/index.d.ts +1 -0
  465. package/types/ui/DraggableList.d.ts +1 -1
  466. package/types/ui/Dropdown.d.ts +5 -1
  467. package/types/ui/Field.d.ts +13 -12
  468. package/types/ui/Layout/BottomTab.d.ts +3 -2
  469. package/types/ui/LegacyModal.d.ts +24 -0
  470. package/types/ui/Loading/ProgressBar.d.ts +4 -0
  471. package/types/ui/Loading/Spin.d.ts +2 -1
  472. package/types/ui/Model/AdminPanel.d.ts +15 -3
  473. package/types/ui/Model/EditModal.d.ts +1 -1
  474. package/types/ui/Model/New.d.ts +3 -1
  475. package/types/ui/Model/NewWrapper.d.ts +2 -0
  476. package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
  477. package/types/ui/Pagination.d.ts +2 -2
  478. package/types/ui/Radio.d.ts +1 -1
  479. package/types/ui/RecentTime.d.ts +18 -1
  480. package/types/ui/Reference/Collapse.d.ts +11 -0
  481. package/types/ui/Reference/Panel.d.ts +29 -0
  482. package/types/ui/Reference/Segmented.d.ts +17 -0
  483. package/types/ui/Reference/Summary.d.ts +13 -0
  484. package/types/ui/Reference/Toolbar.d.ts +21 -0
  485. package/types/ui/Reference/dictText.d.ts +6 -0
  486. package/types/ui/Reference/index.d.ts +7 -0
  487. package/types/ui/Reference/style.d.ts +20 -0
  488. package/types/ui/Reference.d.ts +1 -0
  489. package/types/ui/ScreenNavigator.d.ts +3 -1
  490. package/types/ui/Signal/Arg.d.ts +7 -3
  491. package/types/ui/Signal/Doc.d.ts +4 -6
  492. package/types/ui/Signal/Object.d.ts +2 -1
  493. package/types/ui/Signal/RestApi.d.ts +2 -1
  494. package/types/ui/Signal/WebSocket.d.ts +2 -1
  495. package/types/ui/Signal/endpointEntries.d.ts +20 -0
  496. package/types/ui/Signal/style.d.ts +9 -8
  497. package/types/ui/System/Client.d.ts +1 -2
  498. package/types/ui/System/Common.d.ts +3 -4
  499. package/types/ui/System/Messages.d.ts +1 -1
  500. package/types/ui/Tab/Provider.d.ts +3 -1
  501. package/types/ui/Tab/context.d.ts +4 -2
  502. package/types/ui/ToggleSelect.d.ts +1 -0
  503. package/types/ui/UiOverride/context.d.ts +18 -1
  504. package/types/ui/agentAttrs.d.ts +14 -0
  505. package/types/ui/index.d.ts +22 -1
  506. package/types/ui/overlayLayer.d.ts +13 -0
  507. package/types/ui/overlayPosition.d.ts +28 -0
  508. package/types/ui/recipe/badgeRecipe.d.ts +2 -2
  509. package/types/ui/recipe/buttonRecipe.d.ts +2 -2
  510. package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
  511. package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
  512. package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
  513. package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
  514. package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
  515. package/types/vendor/use-agentic/Agentic.d.ts +21 -0
  516. package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
  517. package/types/vendor/use-agentic/Compaction.d.ts +48 -0
  518. package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
  519. package/types/vendor/use-agentic/Transcript.d.ts +18 -0
  520. package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
  521. package/types/vendor/use-agentic/index.d.ts +19 -0
  522. package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
  523. package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
  524. package/types/vendor/use-agentic/types.d.ts +182 -0
  525. package/types/vendor/use-agentic/useAgent.d.ts +4 -0
  526. package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
  527. package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
  528. package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
  529. package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
  530. package/types/vendor/use-agentic.d.ts +1 -0
  531. package/types/webkit/index.d.ts +4 -0
  532. package/types/webkit/useBodyScrollLock.d.ts +2 -0
  533. package/types/webkit/usePageTool.d.ts +19 -0
  534. package/types/webkit/useScreenScope.d.ts +25 -0
  535. package/ui/Agent/Approval.tsx +32 -0
  536. package/ui/Agent/Attach.tsx +77 -0
  537. package/ui/Agent/Bubble.tsx +192 -0
  538. package/ui/Agent/Chat.tsx +525 -0
  539. package/ui/Agent/ChatCommands.ts +141 -0
  540. package/ui/Agent/Composer.tsx +94 -0
  541. package/ui/Agent/Context.tsx +49 -0
  542. package/ui/Agent/Dock.tsx +77 -0
  543. package/ui/Agent/Guide.tsx +16 -0
  544. package/ui/Agent/History.tsx +49 -0
  545. package/ui/Agent/Launcher.tsx +60 -0
  546. package/ui/Agent/Markdown.tsx +142 -0
  547. package/ui/Agent/Menu.tsx +55 -0
  548. package/ui/Agent/Mic.tsx +27 -0
  549. package/ui/Agent/Question.tsx +63 -0
  550. package/ui/Agent/Section.tsx +24 -0
  551. package/ui/Agent/Skip.tsx +30 -0
  552. package/ui/Agent/StateKey.tsx +46 -0
  553. package/ui/Agent/Tool.tsx +59 -0
  554. package/ui/Agent/Transcript.tsx +33 -0
  555. package/ui/Agent/Zone.tsx +116 -0
  556. package/ui/Agent/agentSessionOf.ts +60 -0
  557. package/ui/Agent/attachment.ts +73 -0
  558. package/ui/Agent/fetchRunner.ts +44 -0
  559. package/ui/Agent/index.ts +27 -0
  560. package/ui/Agent/index_.tsx +4 -0
  561. package/ui/Agent/markdownBlocks.ts +137 -0
  562. package/ui/Agent/markdownSpans.tsx +49 -0
  563. package/ui/Agent/markdownTable.ts +54 -0
  564. package/ui/Agent/sessionHistory.ts +62 -0
  565. package/ui/Agent/sessionView.ts +38 -0
  566. package/ui/Agent/tokenCount.ts +10 -0
  567. package/ui/Agent/useChatAttachments.ts +84 -0
  568. package/ui/Agent/useChatVoice.ts +129 -0
  569. package/ui/Agent/useDraftRecall.ts +42 -0
  570. package/ui/Agent/useKeyboardInset.ts +26 -0
  571. package/ui/Agent/useSlashMenu.ts +58 -0
  572. package/ui/Agent/voice.ts +177 -0
  573. package/ui/Badge.tsx +1 -1
  574. package/ui/BottomSheet.tsx +32 -36
  575. package/ui/Button.tsx +3 -1
  576. package/ui/Clipboard.tsx +3 -6
  577. package/ui/Constant/Doc.tsx +265 -254
  578. package/ui/Constant/Graph.tsx +151 -0
  579. package/ui/Constant/index.ts +3 -2
  580. package/ui/Constant/schemaGraph.ts +232 -0
  581. package/ui/Data/CardList.tsx +14 -3
  582. package/ui/Data/Dashboard.tsx +70 -52
  583. package/ui/Data/Insight.tsx +18 -12
  584. package/ui/Data/Item.tsx +42 -56
  585. package/ui/Data/ListContainer.tsx +246 -132
  586. package/ui/Data/Pagination.tsx +10 -3
  587. package/ui/Data/QueryMaker.tsx +160 -11
  588. package/ui/Data/RefPicker.tsx +202 -0
  589. package/ui/Data/TableList.tsx +22 -13
  590. package/ui/Data/dataExport.ts +54 -0
  591. package/ui/Data/dataText.ts +22 -0
  592. package/ui/Data/index.ts +13 -1
  593. package/ui/Data/index_.tsx +1 -0
  594. package/ui/DatePicker.tsx +110 -128
  595. package/ui/Dialog/Close.tsx +3 -7
  596. package/ui/Dialog/LegacyModal.tsx +241 -0
  597. package/ui/Dialog/Modal.tsx +62 -195
  598. package/ui/Dialog/Provider.tsx +47 -3
  599. package/ui/Dialog/Trigger.tsx +3 -7
  600. package/ui/Dialog/context.ts +14 -2
  601. package/ui/Dialog/index.tsx +2 -0
  602. package/ui/DragAction.tsx +3 -2
  603. package/ui/DraggableList.tsx +9 -4
  604. package/ui/Dropdown.tsx +89 -27
  605. package/ui/Empty.tsx +6 -4
  606. package/ui/Field.tsx +128 -58
  607. package/ui/Input.tsx +27 -5
  608. package/ui/KeyboardAvoiding.tsx +2 -2
  609. package/ui/Layout/BottomTab.tsx +32 -37
  610. package/ui/Layout/Sider.tsx +37 -14
  611. package/ui/LegacyModal.tsx +53 -0
  612. package/ui/Link/CsrLink.tsx +1 -1
  613. package/ui/Load/Pagination.tsx +15 -8
  614. package/ui/Load/Units.tsx +30 -7
  615. package/ui/Load/View.tsx +10 -3
  616. package/ui/Loading/Area.tsx +7 -6
  617. package/ui/Loading/Button.tsx +7 -9
  618. package/ui/Loading/Input.tsx +7 -9
  619. package/ui/Loading/ProgressBar.tsx +16 -7
  620. package/ui/Loading/Skeleton.tsx +8 -13
  621. package/ui/Loading/Spin.tsx +20 -14
  622. package/ui/Menu.tsx +1 -1
  623. package/ui/Model/AdminPanel.tsx +52 -12
  624. package/ui/Model/EditModal.tsx +28 -6
  625. package/ui/Model/EditWrapper.tsx +16 -4
  626. package/ui/Model/New.tsx +4 -0
  627. package/ui/Model/NewWrapper.tsx +2 -0
  628. package/ui/Model/NewWrapper_Client.tsx +20 -6
  629. package/ui/Model/Remove.tsx +18 -6
  630. package/ui/Model/RemoveWrapper.tsx +12 -2
  631. package/ui/Model/SureToRemove.tsx +18 -6
  632. package/ui/Model/ViewEditModal.tsx +64 -15
  633. package/ui/Model/ViewModal.tsx +25 -11
  634. package/ui/Model/ViewWrapper.tsx +15 -4
  635. package/ui/Model/index_.tsx +1 -1
  636. package/ui/Pagination.tsx +51 -66
  637. package/ui/Popconfirm.tsx +88 -78
  638. package/ui/Radio.tsx +53 -24
  639. package/ui/RecentTime.tsx +83 -35
  640. package/ui/Reference/Collapse.tsx +26 -0
  641. package/ui/Reference/Panel.tsx +79 -0
  642. package/ui/Reference/Segmented.tsx +41 -0
  643. package/ui/Reference/Summary.tsx +25 -0
  644. package/ui/Reference/Toolbar.tsx +44 -0
  645. package/ui/Reference/dictText.ts +9 -0
  646. package/ui/Reference/index.ts +7 -0
  647. package/ui/Reference/style.ts +45 -0
  648. package/ui/ScreenNavigator.tsx +17 -2
  649. package/ui/Select.tsx +96 -57
  650. package/ui/Signal/Arg.tsx +83 -68
  651. package/ui/Signal/Doc.tsx +163 -129
  652. package/ui/Signal/Listener.tsx +40 -29
  653. package/ui/Signal/Message.tsx +87 -135
  654. package/ui/Signal/Object.tsx +79 -57
  655. package/ui/Signal/PubSub.tsx +72 -113
  656. package/ui/Signal/Request.tsx +2 -22
  657. package/ui/Signal/Response.tsx +19 -45
  658. package/ui/Signal/RestApi.tsx +170 -200
  659. package/ui/Signal/WebSocket.tsx +29 -26
  660. package/ui/Signal/endpointEntries.ts +59 -0
  661. package/ui/Signal/makeExample.ts +10 -3
  662. package/ui/Signal/style.ts +34 -29
  663. package/ui/Switch.tsx +4 -0
  664. package/ui/System/CSR.tsx +1 -1
  665. package/ui/System/Client.tsx +31 -15
  666. package/ui/System/Common.tsx +3 -4
  667. package/ui/System/DevModeToggle.tsx +1 -1
  668. package/ui/System/Gtag.tsx +2 -2
  669. package/ui/System/Messages.tsx +52 -31
  670. package/ui/System/Reconnect.tsx +22 -56
  671. package/ui/System/SelectLanguage.tsx +24 -15
  672. package/ui/System/ThemeToggle.tsx +25 -13
  673. package/ui/Tab/Menu.tsx +24 -12
  674. package/ui/Tab/Menus.tsx +6 -3
  675. package/ui/Tab/Provider.tsx +30 -3
  676. package/ui/Tab/context.ts +8 -4
  677. package/ui/Table.tsx +66 -60
  678. package/ui/ToggleSelect.tsx +8 -7
  679. package/ui/Tooltip.tsx +15 -1
  680. package/ui/UiOverride/context.ts +21 -2
  681. package/ui/Unauthorized.tsx +6 -4
  682. package/ui/agentAttrs.ts +19 -0
  683. package/ui/index.ts +49 -1
  684. package/ui/overlayLayer.ts +12 -2
  685. package/ui/overlayPosition.ts +104 -0
  686. package/ui/recipe/buttonRecipe.ts +2 -2
  687. package/ui/styles.css +31 -0
  688. package/vendor/use-agentic/AgentAbort.ts +29 -0
  689. package/vendor/use-agentic/AgentProgress.ts +40 -0
  690. package/vendor/use-agentic/AgentProvider.tsx +39 -0
  691. package/vendor/use-agentic/AgentScope.tsx +20 -0
  692. package/vendor/use-agentic/AgentSession.ts +750 -0
  693. package/vendor/use-agentic/Agentic.tsx +44 -0
  694. package/vendor/use-agentic/AgenticSurface.ts +333 -0
  695. package/vendor/use-agentic/Compaction.ts +120 -0
  696. package/vendor/use-agentic/ToolOutput.ts +60 -0
  697. package/vendor/use-agentic/Transcript.ts +50 -0
  698. package/vendor/use-agentic/WIRE.md +86 -0
  699. package/vendor/use-agentic/httpRunner.ts +131 -0
  700. package/vendor/use-agentic/index.ts +20 -0
  701. package/vendor/use-agentic/sharedContext.ts +25 -0
  702. package/vendor/use-agentic/surfaceContext.ts +10 -0
  703. package/vendor/use-agentic/types.ts +192 -0
  704. package/vendor/use-agentic/useAgent.ts +18 -0
  705. package/vendor/use-agentic/useAgentGuide.ts +16 -0
  706. package/vendor/use-agentic/useAgentResource.ts +36 -0
  707. package/vendor/use-agentic/useAgentState.ts +64 -0
  708. package/vendor/use-agentic/useAgentTool.ts +55 -0
  709. package/webkit/bootCsr.tsx +10 -8
  710. package/webkit/index.ts +4 -0
  711. package/webkit/lazy.tsx +5 -1
  712. package/webkit/useBodyScrollLock.tsx +29 -0
  713. package/webkit/useFrameRuntime.ts +1 -1
  714. package/webkit/usePageTool.tsx +37 -0
  715. package/webkit/useScreenScope.tsx +60 -0
  716. package/types/ui/Constant/Mermaid.d.ts +0 -8
  717. package/types/ui/Signal/Collapse.d.ts +0 -12
  718. package/ui/Constant/Mermaid.tsx +0 -149
  719. package/ui/Signal/Collapse.tsx +0 -29
@@ -0,0 +1,183 @@
1
+ import type { AkanSqlClient } from "./database.adaptor";
2
+
3
+ export interface InsightQueryOptions {
4
+ /** Rows to return at most. Clamped to `InsightQuery.maxRows`, which no caller can raise. */
5
+ limit?: number;
6
+ /** How long to wait for the driver, in ms. See the note on `#raced` for which dialects this can actually stop. */
7
+ timeoutMs?: number;
8
+ }
9
+
10
+ export interface InsightQueryResult {
11
+ columns: string[];
12
+ rows: Record<string, unknown>[];
13
+ /** The ceiling cut the answer short, so the caller knows not to read it as complete. */
14
+ truncated: boolean;
15
+ }
16
+
17
+ /**
18
+ * One read-only SQL statement, for an agent or an operator asking a question the domain endpoints cannot express.
19
+ *
20
+ * This is the layer-bypassing read, and every safeguard the framework has is bypassed with it — guards, soft delete,
21
+ * cascade, `_postRemove`, and the `hidden`/`secret` masking every other response path performs. So it is read-only
22
+ * by construction rather than by convention, and it is deliberately *not* wired to an endpoint here: the framework
23
+ * owns no guard strong enough to sit in front of it. An app that wants it writes the endpoint with its own
24
+ * `SuperAdmin`, the same way guards ship with the library that owns the model.
25
+ *
26
+ * Three things enforce read-only, and only the third is ours:
27
+ *
28
+ * 1. The statement is wrapped as a derived table — `SELECT * FROM (<sql>) AS "akanInsight" LIMIT ?`. Nothing but a
29
+ * query is legal in that position, in either dialect, so a write is a syntax error from the engine rather than a
30
+ * pattern this code had to recognise. A second statement smuggled behind `;` is a syntax error for the same
31
+ * reason, and the row ceiling rides along on the same wrapper.
32
+ * 2. A rejection before execution, so the caller reads why rather than a syntax error. It runs on the statement with
33
+ * comments and string literals removed, because that is what makes `-- ` and `'…'` unable to hide anything.
34
+ * 3. **`_doc` never crosses the boundary.** Every non-base field lives in that one JSON column, which is where the
35
+ * plan's "re-apply schema-based masking" runs into the fact that an arbitrary SELECT has no model to mask by. So
36
+ * the enforceable rule is the column itself: unnameable in the statement, dropped from the rows, and any cell
37
+ * that still arrives holding a JSON object or array is refused. An insight is made of scalars; a value that is
38
+ * not one is either a document or indistinguishable from it.
39
+ *
40
+ * What that costs is real and worth saying: this answers "how many, since when, grouped how" over base columns and
41
+ * the search mirror, and it cannot read a domain field. Field-level reads go through the domain tools, which mask.
42
+ */
43
+ export class InsightQuery {
44
+ /** Not an option. A caller asking for more gets this, because the point is that no caller sets the ceiling. */
45
+ static readonly maxRows = 1000;
46
+ static readonly #allowedFirstKeywords = new Set(["select", "with"]);
47
+ /**
48
+ * Words that cannot appear anywhere in a read, checked so read-only does not rest on a dialect's own rule.
49
+ *
50
+ * `WITH` has to be allowed as a first keyword — a CTE is how a real question gets asked — and Postgres lets a CTE
51
+ * modify data. That it is illegal *inside* the derived table this wraps the statement in is true and is what would
52
+ * stop it, but it is one sentence of another project's documentation away from not being true. This does not
53
+ * depend on it. Word-boundary matched on the comment- and literal-stripped statement, so `deleted_at` is fine and
54
+ * a column that is genuinely named `update` is refused — the wrong answer in the safe direction.
55
+ */
56
+ static readonly #forbidden =
57
+ /\b(insert|update|delete|drop|alter|create|truncate|replace|grant|revoke|attach|detach|vacuum|reindex|pragma)\b/i;
58
+ /** The column every document's non-base fields live in. See the class note. */
59
+ static readonly #documentColumn = "_doc";
60
+
61
+ readonly #client: AkanSqlClient;
62
+
63
+ constructor(client: AkanSqlClient) {
64
+ this.#client = client;
65
+ }
66
+
67
+ async run(sql: string, { limit = InsightQuery.maxRows, timeoutMs = 10_000 }: InsightQueryOptions = {}) {
68
+ const statement = InsightQuery.#assertReadable(sql);
69
+ const rows = Math.max(1, Math.min(limit, InsightQuery.maxRows));
70
+
71
+ const wrapped = `SELECT * FROM (${statement}) AS "akanInsight" LIMIT ${rows + 1}`;
72
+ const found = await InsightQuery.#raced(this.#client.prepare(wrapped).all(), timeoutMs);
73
+ const truncated = found.length > rows;
74
+ const kept = truncated ? found.slice(0, rows) : found;
75
+ return {
76
+ columns: InsightQuery.#columnsOf(kept),
77
+ rows: kept.map((row) => InsightQuery.#readable(row)),
78
+ truncated,
79
+ } satisfies InsightQueryResult;
80
+ }
81
+
82
+ /**
83
+ * Stops waiting; does not stop the query.
84
+ *
85
+ * With libsql or Postgres the driver call is genuinely asynchronous, so the caller is freed and the connection
86
+ * finishes on its own. With `bun:sqlite` it is synchronous and holds the event loop, so this timer cannot fire
87
+ * until the query is already done — the ceiling is what limits that case, not the clock. Do not read the timeout
88
+ * as protection against an expensive statement.
89
+ */
90
+ static async #raced<T>(work: Promise<T[]>, timeoutMs: number): Promise<T[]> {
91
+ let timer: ReturnType<typeof setTimeout> | undefined;
92
+ const expiry = new Promise<never>((_, reject) => {
93
+ timer = setTimeout(() => reject(new Error(`Insight query exceeded ${timeoutMs}ms.`)), timeoutMs);
94
+ });
95
+ try {
96
+ return await Promise.race([work, expiry]);
97
+ } finally {
98
+ clearTimeout(timer);
99
+ }
100
+ }
101
+
102
+ /** Returns the statement with a trailing `;` removed, or throws naming what is wrong with it. */
103
+ static #assertReadable(sql: string) {
104
+ const statement = sql.trim().replace(/;\s*$/, "");
105
+ if (!statement) throw new Error("An insight query needs a statement.");
106
+ const bare = InsightQuery.#stripLiterals(statement);
107
+ if (bare.includes(";")) throw new Error("An insight query is one statement. Remove the `;`.");
108
+ const first = /[a-z]+/.exec(bare.toLowerCase())?.[0];
109
+ if (!first || !InsightQuery.#allowedFirstKeywords.has(first))
110
+ throw new Error(
111
+ `An insight query reads: it starts with SELECT or WITH, not ${first ? first.toUpperCase() : "that"}.`,
112
+ );
113
+ const forbidden = InsightQuery.#forbidden.exec(bare)?.[0];
114
+ if (forbidden) throw new Error(`An insight query reads: ${forbidden.toUpperCase()} has no place in one.`);
115
+ if (new RegExp(`\\b${InsightQuery.#documentColumn}\\b`).test(bare))
116
+ throw new Error(
117
+ `An insight query cannot read \`${InsightQuery.#documentColumn}\`: every field a model marks hidden or secret is inside it, and an arbitrary statement names no model to mask it by. Read base columns, or use the model's own endpoint.`,
118
+ );
119
+ return statement;
120
+ }
121
+
122
+ /**
123
+ * Blanks out comments and string literals so the checks above read only what the engine would treat as syntax.
124
+ *
125
+ * Replaced with spaces rather than deleted, so nothing that was two tokens becomes one — `a/**\/b` must not read
126
+ * as the identifier `ab`. Dollar-quoting is not handled: it is Postgres function-body syntax, and a statement
127
+ * that begins with SELECT or WITH has nowhere legal to put one.
128
+ *
129
+ * A double-quoted span is **unquoted, not blanked**. It is an identifier in both dialects, not a literal, so
130
+ * blanking it was what let `SELECT "_doc"` through the column check while `SELECT _doc` was refused. Keeping the
131
+ * contents means SQLite's fallback — a double-quoted string, where no such column exists — is read as an
132
+ * identifier too, which errs toward refusing a statement rather than toward reading the column.
133
+ */
134
+ static #stripLiterals(sql: string) {
135
+ return sql
136
+ .replace(/\/\*[\s\S]*?(\*\/|$)/g, (match) => " ".repeat(match.length))
137
+ .replace(/--[^\n]*/g, (match) => " ".repeat(match.length))
138
+ .replace(/'(?:''|[^'])*'/g, (match) => " ".repeat(match.length))
139
+ .replace(/"(?:""|[^"])*"/g, (match) => ` ${match.slice(1, -1)} `);
140
+ }
141
+
142
+ static #columnsOf(rows: Record<string, unknown>[]) {
143
+ const columns = new Set<string>();
144
+ for (const row of rows) for (const key of Object.keys(row)) columns.add(key);
145
+ columns.delete(InsightQuery.#documentColumn);
146
+ return [...columns];
147
+ }
148
+
149
+ /**
150
+ * Drops the document column and refuses anything else shaped like one.
151
+ *
152
+ * The column has to be dropped here as well as rejected in the statement, because `SELECT * FROM "user"` returns
153
+ * it without ever naming it. The JSON check is for the ways a dialect can hand back a whole row under another
154
+ * name — `row_to_json(u)` — which no list of forbidden function names would keep up with.
155
+ */
156
+ static #readable(row: Record<string, unknown>) {
157
+ const readable: Record<string, unknown> = {};
158
+ for (const [key, value] of Object.entries(row)) {
159
+ if (key === InsightQuery.#documentColumn) continue;
160
+ if (InsightQuery.#isDocumentShaped(value))
161
+ throw new Error(
162
+ `Column "${key}" of the insight query holds an object, which may be a document with its hidden or secret fields intact. Select the values you need instead.`,
163
+ );
164
+ readable[key] = value;
165
+ }
166
+ return readable;
167
+ }
168
+
169
+ static #isDocumentShaped(value: unknown): boolean {
170
+ if (value === null || value === undefined) return false;
171
+ if (value instanceof Date) return false;
172
+ if (typeof value === "object") return true;
173
+ if (typeof value !== "string") return false;
174
+ const trimmed = value.trim();
175
+ if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return false;
176
+ try {
177
+ return typeof JSON.parse(trimmed) === "object";
178
+ } catch {
179
+
180
+ return false;
181
+ }
182
+ }
183
+ }
@@ -0,0 +1,115 @@
1
+ export interface AgentWireToolCall {
2
+ id: string;
3
+ name: string;
4
+ args: Record<string, unknown>;
5
+ }
6
+
7
+ export interface AgentWireToolResult {
8
+ id: string;
9
+ name: string;
10
+ result?: unknown;
11
+ changes?: unknown[];
12
+ error?: string;
13
+ }
14
+
15
+ /**
16
+ * A file the caller attached to one message. Exactly one carrier reaches the model — `data` as inlined bytes, `url`
17
+ * as something the provider fetches, `text` as content already extracted — and which of them a given provider can
18
+ * read is what `LlmAccepts` answers.
19
+ */
20
+ export interface AgentWireAttachment {
21
+ name: string;
22
+ mimeType: string;
23
+ /** Base64, with no `data:` prefix. */
24
+ data?: string;
25
+ url?: string;
26
+ text?: string;
27
+ }
28
+
29
+ /**
30
+ * One transcript message of the in-page agent wire (`use-agentic`'s WIRE.md), typed at both ends independently —
31
+ * the wire is the contract, so the server never imports the client package.
32
+ */
33
+ export interface AgentWireMessage {
34
+ role: "user" | "assistant" | "tool";
35
+ text?: string;
36
+ attachments?: AgentWireAttachment[];
37
+ toolCalls?: AgentWireToolCall[];
38
+ toolResults?: AgentWireToolResult[];
39
+ error?: string;
40
+ /**
41
+ * Stands in for the messages the client's own compaction replaced. It arrives with the user's role because the
42
+ * wire has no other, but it is history rather than an ask, so a provider mapping frames it as one.
43
+ */
44
+ summary?: boolean;
45
+ }
46
+
47
+ export interface AgentWireTool {
48
+ name: string;
49
+ description?: string;
50
+ parameters?: Record<string, unknown>;
51
+ needsConfirm?: boolean;
52
+ }
53
+
54
+ export interface AgentWireContext {
55
+ kind: string;
56
+ [key: string]: unknown;
57
+ }
58
+
59
+ export interface LlmTurnRequest {
60
+ messages: AgentWireMessage[];
61
+ tools: AgentWireTool[];
62
+ context: AgentWireContext[];
63
+ instructions?: string;
64
+ }
65
+
66
+ export interface LlmTurnAnswer {
67
+ text?: string;
68
+ toolCalls?: AgentWireToolCall[];
69
+ stop: "end" | "toolUse";
70
+ }
71
+
72
+ /**
73
+ * The provider seam for one stateless agent turn: the whole transcript in, one assistant answer out. The server
74
+ * relays — it never executes a client tool — so this is the only surface a provider integration fills. An
75
+ * implementation is an `adapt()` class in a lib's `srvkit/`.
76
+ *
77
+ * `null` means this provider is not configured, and the caller turns it into the one sentence that says so. A
78
+ * failure the provider explained is logged and **thrown** instead, as an `Err` whose text the chat prints: a
79
+ * refused turn and an unconfigured app are different things to be told, and collapsing both into `null` left a
80
+ * user reading "no model is configured" about a conversation that had merely outgrown the context window.
81
+ */
82
+ export interface LlmAdaptor {
83
+ /**
84
+ * `onDelta` opts into streaming: the adapter reports assistant text as it arrives and still resolves the full
85
+ * answer. An adapter may ignore it — the caller treats zero reported deltas as "answered whole".
86
+ */
87
+ chat(request: LlmTurnRequest, onDelta?: (delta: string) => void): Promise<LlmTurnAnswer | null>;
88
+ /** Which attachment carriers this provider's model can read. Omitted means text only. */
89
+ readonly accepts?: LlmAccepts;
90
+ }
91
+
92
+ /**
93
+ * What an adaptor's model reads beyond text. Declared rather than defaulted to true, because the failure of
94
+ * guessing wrong is the worst one available: a provider handed bytes it cannot decode either rejects the whole
95
+ * turn or accepts it having seen nothing, and the model then answers confidently about a file it never read.
96
+ * `AgentService` degrades what is not accepted into a note the model can repeat back, so a text-only provider
97
+ * needs no attachment code at all — which is every provider until somebody swaps one in for vision.
98
+ */
99
+ export interface LlmAccepts {
100
+ /** Inlined or linked image bytes. */
101
+ image?: boolean;
102
+ /** Non-image bytes handed over whole — a PDF the model parses itself. */
103
+ document?: boolean;
104
+ }
105
+
106
+ /**
107
+ * Settings for whichever adaptor fills `LlmAdaptorRole`, registered with `option.setLlm(...)` and injected as the
108
+ * `llmOption` use. It belongs to the role rather than to one provider: swapping the default for another `adapt()`
109
+ * class re-reads the same three fields under that provider's own defaults.
110
+ */
111
+ export interface LlmOption {
112
+ apiKey?: string;
113
+ model?: string;
114
+ host?: string;
115
+ }
@@ -22,7 +22,7 @@ export class ConsoleLogger extends adapt("consoleLogger", () => ({})) implements
22
22
  Logger.debug(msg, context, name);
23
23
  }
24
24
  log(name: string, msg: string, context?: string): void {
25
- Logger.log(msg, context, name);
25
+ Logger.info(msg, context, name);
26
26
  }
27
27
  info(name: string, msg: string, context?: string): void {
28
28
  Logger.info(msg, context, name);
@@ -1,4 +1,4 @@
1
- import type { BaseEnv } from "akanjs/base";
1
+ import { getEnv } from "akanjs/base";
2
2
  import { adapt } from "../adapt";
3
3
  import type { AkanJob, AkanJobOptions, AkanWorker } from "../ipcTypes";
4
4
  import { RedisCache } from "./cache.adaptor";
@@ -30,7 +30,10 @@ export interface QueueAdaptor {
30
30
  export class BullQueue
31
31
  extends adapt("bullQueue", ({ plug, env }) => ({
32
32
  redis: plug(RedisCache, (redisCache) => redisCache.getClient()),
33
- prefix: env((env: BaseEnv) => `queue-${env.repoName}-${env.appName}-${env.environment}-${env.operationMode}`),
33
+ prefix: env(() => {
34
+ const { repoName, appName, environment, operationMode } = getEnv();
35
+ return `queue-${repoName}-${appName}-${environment}-${operationMode}`;
36
+ }),
34
37
  }))
35
38
  implements QueueAdaptor
36
39
  {
@@ -2,6 +2,7 @@ import { type AdaptorCls, adapt } from "../adapt";
2
2
  import type { CacheAdaptor } from "./cache.adaptor";
3
3
  import type { CompressAdaptor } from "./compress.adaptor";
4
4
  import type { DatabaseAdaptor } from "./database.adaptor";
5
+ import type { LlmAdaptor } from "./llm.adaptor";
5
6
  import type { LoggingAdaptor } from "./logging.adaptor";
6
7
  import type { QueueAdaptor } from "./queue.adaptor";
7
8
  import type { ScheduleAdaptor } from "./schedule.adaptor";
@@ -16,3 +17,4 @@ export const ScheduleAdaptorRole = adapt("scheduleAdaptorRole") as AdaptorCls<Sc
16
17
  export const LoggingAdaptorRole = adapt("loggingAdaptorRole") as AdaptorCls<LoggingAdaptor>;
17
18
  export const WebsocketAdaptorRole = adapt("websocketAdaptorRole") as AdaptorCls<WebsocketAdaptor>;
18
19
  export const CompressAdaptorRole = adapt("compressAdaptorRole") as AdaptorCls<CompressAdaptor>;
20
+ export const LlmAdaptorRole = adapt("llmAdaptorRole") as AdaptorCls<LlmAdaptor>;
@@ -1,10 +1,15 @@
1
- import { Cron } from "croner";
2
1
  import { adapt } from "../adapt";
3
2
  import { CacheAdaptorRole } from "./role.adaptor";
4
3
 
4
+ /** The scheduler's own job handle, so the cron backend stays behind this interface. `Bun.cron` satisfies it. */
5
+ export interface AkanCronJob {
6
+ readonly cron: string;
7
+ stop(): void;
8
+ }
9
+
5
10
  export interface ScheduleAdaptor {
6
- getCron(key: string): Cron | undefined;
7
- registerCron(key: string, cronStr: string, callback: () => Promise<void>, option?: { lock?: boolean }): Cron;
11
+ getCron(key: string): AkanCronJob | undefined;
12
+ registerCron(key: string, cronStr: string, callback: () => Promise<void>, option?: { lock?: boolean }): AkanCronJob;
8
13
  unregisterCron(key: string): void;
9
14
  getInterval(key: string): NodeJS.Timeout | undefined;
10
15
  registerInterval(
@@ -39,7 +44,7 @@ export class Scheduler
39
44
  implements ScheduleAdaptor
40
45
  {
41
46
  readonly lockMap = new Map<string, boolean>();
42
- readonly cronMap = new Map<string, Cron>();
47
+ readonly cronMap = new Map<string, AkanCronJob>();
43
48
  readonly intervalMap = new Map<string, NodeJS.Timeout>();
44
49
  readonly timeoutMap = new Map<string, NodeJS.Timeout>();
45
50
  readonly initMap = new Map<string, () => Promise<void>>();
@@ -48,7 +53,9 @@ export class Scheduler
48
53
  return this.cronMap.get(key);
49
54
  }
50
55
  registerCron(key: string, cronStr: string, callback: () => Promise<void>, { lock = true }: { lock?: boolean } = {}) {
51
- const cron = new Cron(cronStr, async () => {
56
+
57
+ if (!lock) this.logger.warn(`Schedule ${key} requested lock:false, but Bun.cron never overlaps a job`);
58
+ const cron = Bun.cron(cronStr, async () => {
52
59
  if (this.lockMap.get(key) && lock) {
53
60
  this.logger.warn(`Schedule ${key} is locked, skipped`);
54
61
  return;
@@ -3,9 +3,13 @@ import { adapt } from "../adapt";
3
3
  import { sendAkanIpc } from "../ipcTypes";
4
4
  import type { WebsocketAdaptor, WsRedisEventHandler, WsSocketData } from "./websocket.adaptor";
5
5
 
6
- const getSocketId = (ws: Bun.ServerWebSocket<unknown>, serverId: string) => {
6
+ /**
7
+ * `AppWsData` mints the id at the handshake, so this reads it; the fallback only covers a socket that
8
+ * was upgraded outside the app router, where nothing else would have given it one.
9
+ */
10
+ const getSocketId = (ws: Bun.ServerWebSocket<unknown>) => {
7
11
  const data = ws.data as WsSocketData;
8
- if (!data.socketId) data.socketId = `${serverId}-${Bun.randomUUIDv7()}`;
12
+ data.socketId ??= Bun.randomUUIDv7();
9
13
  return data.socketId;
10
14
  };
11
15
 
@@ -64,7 +68,7 @@ export class SolidPubSub
64
68
  }
65
69
 
66
70
  async joinRoom(ws: Bun.ServerWebSocket<unknown>, room: string): Promise<void> {
67
- const socketId = getSocketId(ws, this.serverId);
71
+ const socketId = getSocketId(ws);
68
72
  const rooms = this.#socketRooms.get(socketId) ?? new Set<string>();
69
73
  rooms.add(room);
70
74
  this.#socketRooms.set(socketId, rooms);
@@ -72,7 +76,7 @@ export class SolidPubSub
72
76
  }
73
77
 
74
78
  async leaveRoom(ws: Bun.ServerWebSocket<unknown>, room: string): Promise<void> {
75
- const socketId = getSocketId(ws, this.serverId);
79
+ const socketId = getSocketId(ws);
76
80
  const rooms = this.#socketRooms.get(socketId);
77
81
  rooms?.delete(room);
78
82
  if (!rooms || rooms.size === 0) this.#socketRooms.delete(socketId);
@@ -80,7 +84,7 @@ export class SolidPubSub
80
84
  }
81
85
 
82
86
  async leaveAllRooms(ws: Bun.ServerWebSocket<unknown>): Promise<void> {
83
- const socketId = getSocketId(ws, this.serverId);
87
+ const socketId = getSocketId(ws);
84
88
  const rooms = this.#socketRooms.get(socketId);
85
89
  if (rooms) {
86
90
  for (const room of rooms) sendAkanIpc({ type: "pubsub.unsubscribe", roomId: room, socketId, pid: process.pid });
@@ -89,7 +93,7 @@ export class SolidPubSub
89
93
  }
90
94
 
91
95
  async registerSocket(ws: Bun.ServerWebSocket<unknown>): Promise<void> {
92
- getSocketId(ws, this.serverId);
96
+ getSocketId(ws);
93
97
  }
94
98
 
95
99
  async unregisterSocket(ws: Bun.ServerWebSocket<unknown>): Promise<void> {
@@ -1,4 +1,5 @@
1
1
  import type { Database, Statement } from "bun:sqlite";
2
+ import { getEnv } from "akanjs/base";
2
3
  import { adapt } from "../adapt";
3
4
  import { type AkanJob, type AkanJobOptions, type AkanWorker, sendAkanIpc } from "../ipcTypes";
4
5
  import type { QueueAdaptor } from "./queue.adaptor";
@@ -56,8 +57,11 @@ class SolidWorker implements AkanWorker {
56
57
  export class SolidQueue
57
58
  extends adapt("solidQueue", ({ env }) => ({
58
59
  config: env((env: SolidEnv) => getSolidConfig(env)),
59
- queueName: env((env: SolidEnv) => `queue-${env.repoName}-${env.appName}-${env.environment}-${env.operationMode}`),
60
- workerId: env((env: SolidEnv) => `${env.appName}-${process.env.AKAN_REPLICA_IDX ?? "0"}-${process.pid}`),
60
+ queueName: env(() => {
61
+ const { repoName, appName, environment, operationMode } = getEnv();
62
+ return `queue-${repoName}-${appName}-${environment}-${operationMode}`;
63
+ }),
64
+ workerId: env(() => `${getEnv().appName}-${process.env.AKAN_REPLICA_IDX ?? "0"}-${process.pid}`),
61
65
  }))
62
66
  implements QueueAdaptor
63
67
  {
@@ -1,7 +1,7 @@
1
1
  import { Database } from "bun:sqlite";
2
2
  import { mkdir } from "node:fs/promises";
3
3
  import path from "node:path";
4
- import type { BaseEnv, Dayjs } from "akanjs/base";
4
+ import { type Dayjs, getEnv } from "akanjs/base";
5
5
  import { resolveDefaultSqliteFile } from "./sqlitePath";
6
6
 
7
7
  export interface SolidConfig {
@@ -14,7 +14,7 @@ export interface SolidConfig {
14
14
  queueLeaseMs?: number;
15
15
  }
16
16
 
17
- export interface SolidEnv extends BaseEnv {
17
+ export interface SolidEnv {
18
18
  workspaceRoot?: string;
19
19
  solid?: SolidConfig;
20
20
  }
@@ -23,18 +23,20 @@ export type SolidValueType = "string" | "number" | "buffer" | "json";
23
23
 
24
24
  const wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
25
25
 
26
- export const getSolidConfig = (env: SolidEnv): Required<SolidConfig> => {
27
- const appName = env.appName ?? "akan";
28
- const environment = env.environment ?? "local";
29
- const defaultFile = resolveDefaultSqliteFile({
26
+ const defaultSolidFile = (workspaceRoot?: string) => {
27
+ const { appName, environment, operationMode } = getEnv();
28
+ return resolveDefaultSqliteFile({
30
29
  appName,
31
30
  fileName: `${appName}-${environment}_solid.db`,
32
31
  isProduction: process.env.NODE_ENV === "production",
33
- operationMode: env.operationMode,
34
- workspaceRoot: env.workspaceRoot,
32
+ operationMode,
33
+ workspaceRoot,
35
34
  });
35
+ };
36
+
37
+ export const getSolidConfig = (env: SolidEnv): Required<SolidConfig> => {
36
38
  return {
37
- filePath: env.solid?.filePath ?? process.env.AKAN_SOLID_DB_PATH ?? defaultFile,
39
+ filePath: env.solid?.filePath ?? process.env.AKAN_SOLID_DB_PATH ?? defaultSolidFile(env.workspaceRoot),
38
40
  journalMode: env.solid?.journalMode ?? "WAL",
39
41
  busyTimeoutMs: env.solid?.busyTimeoutMs ?? 5000,
40
42
  synchronous: env.solid?.synchronous ?? "NORMAL",
@@ -209,9 +209,14 @@ export class WebSocketRedisAdaptor
209
209
  await pipeline.exec();
210
210
  }
211
211
 
212
+ /**
213
+ * `AppWsData` mints the id at the handshake, so this reads it; the fallback only covers a socket that
214
+ * was upgraded outside the app router. The owning server is recorded in the socket hash below, so the
215
+ * id itself carries no prefix.
216
+ */
212
217
  #getSocketId(ws: Bun.ServerWebSocket<unknown>): string {
213
218
  const data = ws.data as WsSocketData;
214
- if (!data.socketId) data.socketId = `${this.serverId}-${Bun.randomUUIDv7()}`;
219
+ data.socketId ??= Bun.randomUUIDv7();
215
220
  return data.socketId;
216
221
  }
217
222
 
package/service/serve.ts CHANGED
@@ -12,7 +12,7 @@ import {
12
12
  import type { DatabaseService, DatabaseServiceForModel } from "./types";
13
13
 
14
14
  interface ServiceOptions {
15
- enabled?: boolean;
15
+ enabled?: boolean | (() => boolean);
16
16
  serverMode?: "batch" | "federation";
17
17
  }
18
18
  export type ServiceType = "database" | "plain";
@@ -43,9 +43,9 @@ const avoidKeys = new Set([
43
43
  export interface Service {
44
44
  readonly logger: Logger;
45
45
 
46
- onInit(): Promise<void>;
46
+ onInit(): Promise<void> | void;
47
47
  _libsOnInit(): Promise<void>;
48
- onDestroy(): Promise<void>;
48
+ onDestroy(): Promise<void> | void;
49
49
  _libsOnDestroy(): Promise<void>;
50
50
  }
51
51
 
@@ -102,9 +102,10 @@ export function serve(
102
102
  ...(typeof optionOrInjectBuilder === "function" && injectBuilderOrExtendSrv ? [injectBuilderOrExtendSrv] : []),
103
103
  ...extendSrvs,
104
104
  ] as ServiceCls[];
105
- const isEnabled =
105
+ const enabledOption =
106
106
  option.enabled ??
107
107
  (!option.serverMode || process.env.SERVER_MODE === option.serverMode || process.env.SERVER_MODE === "all");
108
+ let enabledCache: boolean | undefined;
108
109
  const serviceType = typeof refNameOrDb === "string" ? "plain" : "database";
109
110
  const injectInfoMap = injectBuilder(injectionBuilder(refName));
110
111
  if (serviceType === "database")
@@ -115,15 +116,20 @@ export function serve(
115
116
  const srvRef = class Service {
116
117
  static readonly type = serviceType;
117
118
  static readonly refName = refName;
118
- static enabled = isEnabled;
119
+ static get enabled() {
120
+
121
+ if (enabledCache === undefined)
122
+ enabledCache = typeof enabledOption === "function" ? enabledOption() : enabledOption;
123
+ return enabledCache;
124
+ }
119
125
  static get name() {
120
126
  return `${capitalize(refName)}Service`;
121
127
  }
122
128
  static [INJECT_META] = {};
123
129
  readonly logger = new Logger(this.constructor.name);
124
- async onInit() {
130
+ onInit(): Promise<void> | void {
125
131
  }
126
- async onDestroy() {
132
+ onDestroy(): Promise<void> | void {
127
133
  }
128
134
  };
129
135
  applyMixins(srvRef, extSrvs, avoidKeys);
@@ -132,10 +138,11 @@ export function serve(
132
138
  const onDestroyFns = extSrvs.map((srv) => srv.prototype.onDestroy);
133
139
  Object.assign(srvRef.prototype, {
134
140
  async _libsOnInit(this: Service) {
135
- await Promise.all([...onInitFns.map((onInit) => onInit?.call(this)), this.onInit()]);
141
+
142
+ await Promise.all([...onInitFns, this.onInit].map(async (onInit) => await onInit?.call(this)));
136
143
  },
137
144
  async _libsOnDestroy(this: Service) {
138
- await Promise.all([...onDestroyFns.map((onDestroy) => onDestroy?.call(this)), this.onDestroy()]);
145
+ await Promise.all([...onDestroyFns, this.onDestroy].map(async (onDestroy) => await onDestroy?.call(this)));
139
146
  },
140
147
  });
141
148