akanjs 3.0.0-alpha.8 → 3.0.0-alpha.80

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 (832) 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/cookie.ts +21 -34
  10. package/client/csrTypes.ts +4 -15
  11. package/client/frameConfig.ts +13 -0
  12. package/client/index.ts +1 -0
  13. package/client/locale.ts +2 -2
  14. package/client/router.ts +7 -7
  15. package/client/sharedContext.ts +31 -0
  16. package/client/translator.ts +2 -2
  17. package/client/types.ts +3 -3
  18. package/common/Logger.ts +287 -67
  19. package/common/TrustedProxy.ts +134 -0
  20. package/common/clamp.ts +2 -0
  21. package/common/clientAddress.ts +40 -0
  22. package/common/deepObjectify.ts +3 -2
  23. package/common/dynamicRecord.ts +12 -0
  24. package/common/index.ts +47 -2
  25. package/common/isValidDate.ts +1 -1
  26. package/common/logContext.ts +27 -0
  27. package/common/mcpExposure.ts +114 -0
  28. package/common/pathGetLoose.ts +31 -0
  29. package/common/plainFieldsOf.ts +13 -0
  30. package/common/requestOrigin.ts +32 -0
  31. package/common/{httpClient.ts → restClient.ts} +16 -9
  32. package/common/routeConvention.ts +22 -12
  33. package/common/websocketBinaryFrame.ts +46 -0
  34. package/constant/crystalize.ts +92 -28
  35. package/constant/dateSlot.ts +62 -0
  36. package/constant/deserialize.ts +3 -2
  37. package/constant/fieldInfo.ts +43 -3
  38. package/constant/fieldQueryMeta.ts +35 -0
  39. package/constant/getDefault.ts +16 -11
  40. package/constant/hydrationPlan.ts +72 -0
  41. package/constant/immerify.ts +4 -6
  42. package/constant/index.ts +5 -0
  43. package/constant/labelOf.ts +26 -0
  44. package/constant/mask.ts +67 -0
  45. package/constant/purify.ts +17 -11
  46. package/constant/textFieldPaths.ts +13 -7
  47. package/constant/types.ts +41 -13
  48. package/constant/via.ts +24 -17
  49. package/dictionary/DictionaryLookup.ts +30 -0
  50. package/dictionary/agent.dictionary.ts +31 -0
  51. package/dictionary/agentTurn.dictionary.ts +29 -0
  52. package/dictionary/base.dictionary.ts +85 -0
  53. package/dictionary/dictInfo.ts +11 -2
  54. package/dictionary/dictionary.ts +9 -3
  55. package/dictionary/index.ts +1 -0
  56. package/dictionary/trans.ts +26 -7
  57. package/document/dataLoader.ts +0 -4
  58. package/document/documentQuery.ts +1 -0
  59. package/document/filterMeta.ts +79 -14
  60. package/document/index.ts +1 -0
  61. package/document/loaderInfo.ts +4 -1
  62. package/document/noDocumentError.ts +12 -0
  63. package/document/types.ts +0 -1
  64. package/fetch/agentTurn.ts +19 -0
  65. package/fetch/client/fetchClient.ts +166 -89
  66. package/fetch/client/fetchHandle.ts +57 -0
  67. package/fetch/client/httpClient.ts +140 -30
  68. package/fetch/client/sliceInitHandle.ts +101 -0
  69. package/fetch/client/wsClient.ts +27 -12
  70. package/fetch/fetchType/appliedReturn.type.ts +126 -42
  71. package/fetch/fetchType/endpointFetch.type.ts +17 -8
  72. package/fetch/fetchType/sliceFetch.type.ts +30 -53
  73. package/fetch/index.ts +1 -0
  74. package/fetch/requestStorage.ts +19 -5
  75. package/index.ts +132 -8
  76. package/local/apps/akan/akan-local.db +0 -0
  77. package/local/apps/akan/akan-local.db-shm +0 -0
  78. package/local/apps/akan/akan-local.db-wal +0 -0
  79. package/local/apps/akan/akan-local_solid.db +0 -0
  80. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  81. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  82. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  83. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  84. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  85. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  86. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  87. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  88. package/package.json +27 -18
  89. package/server/akanApp.ts +325 -157
  90. package/server/akanAppHeaders.ts +23 -3
  91. package/server/akanOption.ts +76 -8
  92. package/server/akanServer.ts +390 -32
  93. package/server/animatedImage.ts +83 -0
  94. package/server/assetEncoding.ts +4 -24
  95. package/server/binaryPubsub.ts +55 -0
  96. package/server/cachePolicy.ts +2 -11
  97. package/server/console.ts +110 -101
  98. package/server/consoleEvaluator.ts +51 -0
  99. package/server/consolePasteFilter.ts +91 -0
  100. package/server/consoleSession.ts +242 -0
  101. package/server/contentEncoding.ts +83 -0
  102. package/server/decorators.ts +12 -3
  103. package/server/devtools/constantSerializer.ts +8 -1
  104. package/server/devtools/signalSerializer.ts +2 -2
  105. package/server/devtools/types.ts +4 -4
  106. package/server/di/diLifecycle.ts +144 -14
  107. package/server/di/predefinedAdaptor.ts +6 -0
  108. package/server/di/resolveHierarchy.ts +3 -3
  109. package/server/di/utils.ts +40 -0
  110. package/server/hmr/clientScript.ts +1 -1
  111. package/server/imageOptimizer.ts +156 -74
  112. package/server/lifecycle/runtimeDir.ts +14 -0
  113. package/server/lifecycle/shutdownManager.ts +17 -2
  114. package/server/logging/childOutputReader.ts +137 -0
  115. package/server/logging/hubFileSink.ts +39 -0
  116. package/server/logging/logControlSocket.ts +173 -0
  117. package/server/logging/logForwarder.ts +131 -0
  118. package/server/logging/logHub.ts +0 -0
  119. package/server/logging/logQuery.ts +130 -0
  120. package/server/logging/logStdoutWriter.ts +39 -0
  121. package/server/logging/logStreamRoute.ts +87 -0
  122. package/server/logging/logTailClient.ts +161 -0
  123. package/server/mcp/McpAuth.ts +177 -0
  124. package/server/mcp/McpDispatcher.ts +295 -0
  125. package/server/mcp/McpEventStream.ts +24 -0
  126. package/server/mcp/McpExecutionContext.ts +105 -0
  127. package/server/mcp/McpRouter.ts +621 -0
  128. package/server/mcp/index.ts +5 -0
  129. package/server/processMetricsCollector.ts +1 -1
  130. package/server/resolver/database.resolver.ts +18 -12
  131. package/server/resolver/signal.resolver.ts +211 -89
  132. package/server/routeTreeBuilder.ts +11 -23
  133. package/server/routing/apiRouter.ts +45 -16
  134. package/server/routing/appWsData.ts +30 -5
  135. package/server/routing/eventStream.ts +93 -0
  136. package/server/routing/soloAppRoutes.ts +50 -0
  137. package/server/rscWorker.tsx +63 -22
  138. package/server/rscWorkerHost.ts +59 -8
  139. package/server/semaphore.ts +22 -0
  140. package/server/ssrFromRscRenderer.tsx +50 -0
  141. package/server/staticPath.ts +34 -0
  142. package/server/subRouteIndexDocument.tsx +61 -0
  143. package/server/systemPageDocument.tsx +3 -3
  144. package/server/systemPages.tsx +49 -16
  145. package/server/types.tsx +28 -0
  146. package/server/vendor/akanjs-fetch.ts +1 -0
  147. package/server/webRouter.ts +130 -73
  148. package/service/adapt.ts +5 -9
  149. package/service/agent.service.ts +81 -0
  150. package/service/base.service.ts +2 -1
  151. package/service/index.ts +1 -0
  152. package/service/injectInfo.ts +8 -3
  153. package/service/ipcTypes.ts +6 -0
  154. package/service/predefinedAdaptor/cache.adaptor.ts +8 -4
  155. package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
  156. package/service/predefinedAdaptor/database.adaptor.ts +59 -1757
  157. package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
  158. package/service/predefinedAdaptor/index.ts +3 -0
  159. package/service/predefinedAdaptor/insightQuery.ts +183 -0
  160. package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
  161. package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
  162. package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
  163. package/service/predefinedAdaptor/role.adaptor.ts +2 -0
  164. package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
  165. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
  166. package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
  167. package/service/predefinedAdaptor/solidSqlite.ts +11 -9
  168. package/service/predefinedAdaptor/sql/PendingStoreEnsures.ts +22 -0
  169. package/service/predefinedAdaptor/sql/QueryCompiler.ts +225 -0
  170. package/service/predefinedAdaptor/sql/SqlDocumentStore.ts +812 -0
  171. package/service/predefinedAdaptor/sql/UpdateCompiler.ts +67 -0
  172. package/service/predefinedAdaptor/sql/dialect/postgres.ts +151 -0
  173. package/service/predefinedAdaptor/sql/dialect/sqlite.ts +134 -0
  174. package/service/predefinedAdaptor/sql/driver/bunSqlite.ts +29 -0
  175. package/service/predefinedAdaptor/sql/driver/libsql.ts +37 -0
  176. package/service/predefinedAdaptor/sql/driver/postgres.ts +42 -0
  177. package/service/predefinedAdaptor/sql/types.ts +251 -0
  178. package/service/predefinedAdaptor/sql/values.ts +91 -0
  179. package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
  180. package/service/serve.ts +16 -9
  181. package/service/toolNames.ts +119 -0
  182. package/signal/CrossSiteGuard.ts +71 -0
  183. package/signal/SignalFailure.ts +51 -0
  184. package/signal/agent/AgentCatalogue.ts +165 -0
  185. package/signal/agent/index.ts +1 -0
  186. package/signal/agent.signal.ts +38 -0
  187. package/signal/agentTurn.ts +8 -0
  188. package/signal/agentTurnStream.ts +60 -0
  189. package/signal/base.signal.ts +2 -1
  190. package/signal/endpoint.ts +2 -2
  191. package/signal/endpointInfo.ts +38 -2
  192. package/signal/exception.ts +43 -6
  193. package/signal/guard.ts +28 -1
  194. package/signal/guards.ts +49 -1
  195. package/signal/index.ts +8 -0
  196. package/signal/intercept.ts +9 -6
  197. package/signal/internal.ts +10 -2
  198. package/signal/internalArg.ts +21 -4
  199. package/signal/mcp/McpDocument.ts +326 -0
  200. package/signal/mcp/McpProgress.ts +106 -0
  201. package/signal/mcp/McpUriTemplate.ts +80 -0
  202. package/signal/mcp/Msg.ts +368 -0
  203. package/signal/mcp/index.ts +5 -0
  204. package/signal/mcp/mcpProtocol.ts +120 -0
  205. package/signal/middleware.ts +3 -3
  206. package/signal/openapi/openapi.ts +36 -173
  207. package/signal/schema/JsonSchemaBuilder.ts +221 -0
  208. package/signal/schema/index.ts +1 -0
  209. package/signal/serializer/fetch.serializer.ts +62 -1
  210. package/signal/signalContext.ts +339 -94
  211. package/signal/slice.ts +63 -28
  212. package/signal/trace.ts +268 -9
  213. package/signal/types.ts +55 -4
  214. package/store/SliceRequest.ts +23 -0
  215. package/store/action.ts +210 -154
  216. package/store/actionTag.ts +33 -0
  217. package/store/agent/AgentBridge.ts +89 -0
  218. package/store/agent/AgentContext.ts +71 -0
  219. package/store/agent/AgentPrompts.ts +111 -0
  220. package/store/agent/ScreenReader.ts +349 -0
  221. package/store/agent/ScreenSettle.ts +45 -0
  222. package/store/agent/ScreenTarget.ts +135 -0
  223. package/store/agent/StoreCatalogue.ts +116 -0
  224. package/store/agent/StoreSurfaceSource.ts +225 -0
  225. package/store/agent/index.ts +13 -0
  226. package/store/agent/storeSurface.ts +28 -0
  227. package/store/agent/types.ts +16 -0
  228. package/store/agentic/AgentValue.ts +119 -0
  229. package/store/agentic/StExposeBuilder.ts +50 -0
  230. package/store/agentic/StExposeDraft.ts +24 -0
  231. package/store/agentic/StStateBuilder.ts +90 -0
  232. package/store/agentic/StStateDraft.ts +23 -0
  233. package/store/agentic/StToolBuilder.ts +293 -0
  234. package/store/agentic/StToolDraft.ts +22 -0
  235. package/store/agentic/attachAgentic.ts +33 -0
  236. package/store/agentic/formFields.ts +194 -0
  237. package/store/agentic/index.ts +12 -0
  238. package/store/agentic/useFieldTool.ts +183 -0
  239. package/store/agentic/useFormTools.ts +77 -0
  240. package/store/agentic/useRelationFieldTool.ts +113 -0
  241. package/store/baseSt.ts +1 -1
  242. package/store/databaseStateNames.ts +31 -0
  243. package/store/formSetterNames.ts +35 -0
  244. package/store/index.ts +8 -0
  245. package/store/rootStore.ts +3 -1
  246. package/store/sliceRole.ts +36 -0
  247. package/store/state.ts +2 -12
  248. package/store/store.ts +10 -1
  249. package/store/storeInstance.ts +185 -22
  250. package/store/storeRegistry.ts +40 -2
  251. package/store/types.ts +5 -0
  252. package/store/withSelector.ts +5 -4
  253. package/test/index.ts +1 -1
  254. package/test/registerDom.ts +4 -0
  255. package/test/sampleOf.ts +2 -0
  256. package/test/signalTestRuntime.ts +5 -5
  257. package/test/testServer.ts +14 -11
  258. package/types/base/baseEnv.d.ts +1 -1
  259. package/types/base/primitiveRegistry.d.ts +20 -8
  260. package/types/base/symbols.d.ts +4 -0
  261. package/types/client/capacitor.d.ts +39 -0
  262. package/types/client/clientRuntime.d.ts +7 -0
  263. package/types/client/cookie.d.ts +13 -2
  264. package/types/client/csrTypes.d.ts +0 -1
  265. package/types/client/frameConfig.d.ts +1 -0
  266. package/types/client/index.d.ts +1 -0
  267. package/types/client/sharedContext.d.ts +21 -0
  268. package/types/client/types.d.ts +5 -3
  269. package/types/common/Logger.d.ts +88 -6
  270. package/types/common/TrustedProxy.d.ts +24 -0
  271. package/types/common/clamp.d.ts +2 -0
  272. package/types/common/clientAddress.d.ts +19 -0
  273. package/types/common/dynamicRecord.d.ts +14 -0
  274. package/types/common/index.d.ts +13 -3
  275. package/types/common/logContext.d.ts +17 -0
  276. package/types/common/mcpExposure.d.ts +64 -0
  277. package/types/common/pathGetLoose.d.ts +8 -0
  278. package/types/common/plainFieldsOf.d.ts +6 -0
  279. package/types/common/requestOrigin.d.ts +14 -0
  280. package/types/common/restClient.d.ts +27 -0
  281. package/types/common/routeConvention.d.ts +6 -0
  282. package/types/common/websocketBinaryFrame.d.ts +17 -0
  283. package/types/constant/constantRegistry.d.ts +2 -10
  284. package/types/constant/crystalize.d.ts +5 -0
  285. package/types/constant/dateSlot.d.ts +14 -0
  286. package/types/constant/fieldInfo.d.ts +20 -3
  287. package/types/constant/fieldQueryMeta.d.ts +17 -0
  288. package/types/constant/getDefault.d.ts +8 -0
  289. package/types/constant/hydrationPlan.d.ts +24 -0
  290. package/types/constant/index.d.ts +5 -0
  291. package/types/constant/labelOf.d.ts +7 -0
  292. package/types/constant/mask.d.ts +41 -0
  293. package/types/constant/purify.d.ts +2 -2
  294. package/types/constant/types.d.ts +18 -5
  295. package/types/dictionary/DictionaryLookup.d.ts +14 -0
  296. package/types/dictionary/agent.dictionary.d.ts +1 -0
  297. package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
  298. package/types/dictionary/base.dictionary.d.ts +1 -1
  299. package/types/dictionary/dictInfo.d.ts +7 -1
  300. package/types/dictionary/dictionary.d.ts +11 -9
  301. package/types/dictionary/index.d.ts +1 -0
  302. package/types/document/dataLoader.d.ts +0 -3
  303. package/types/document/filterMeta.d.ts +26 -6
  304. package/types/document/index.d.ts +1 -0
  305. package/types/document/loaderInfo.d.ts +2 -2
  306. package/types/document/noDocumentError.d.ts +12 -0
  307. package/types/document/types.d.ts +0 -1
  308. package/types/fetch/agentTurn.d.ts +475 -0
  309. package/types/fetch/client/fetchClient.d.ts +12 -0
  310. package/types/fetch/client/fetchHandle.d.ts +24 -0
  311. package/types/fetch/client/httpClient.d.ts +10 -4
  312. package/types/fetch/client/sliceInitHandle.d.ts +29 -0
  313. package/types/fetch/fetchType/appliedReturn.type.d.ts +71 -15
  314. package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
  315. package/types/fetch/fetchType/sliceFetch.type.d.ts +14 -18
  316. package/types/fetch/index.d.ts +1 -0
  317. package/types/fetch/requestStorage.d.ts +14 -0
  318. package/types/index.d.ts +124 -12
  319. package/types/server/akanApp.d.ts +12 -0
  320. package/types/server/akanAppHeaders.d.ts +7 -1
  321. package/types/server/akanOption.d.ts +43 -6
  322. package/types/server/akanServer.d.ts +67 -9
  323. package/types/server/animatedImage.d.ts +7 -0
  324. package/types/server/assetEncoding.d.ts +1 -1
  325. package/types/server/binaryPubsub.d.ts +18 -0
  326. package/types/server/console.d.ts +11 -1
  327. package/types/server/consoleEvaluator.d.ts +2 -0
  328. package/types/server/consolePasteFilter.d.ts +11 -0
  329. package/types/server/consoleSession.d.ts +22 -0
  330. package/types/server/contentEncoding.d.ts +28 -0
  331. package/types/server/decorators.d.ts +12 -2
  332. package/types/server/devtools/types.d.ts +4 -4
  333. package/types/server/di/diLifecycle.d.ts +19 -3
  334. package/types/server/di/predefinedAdaptor.d.ts +4 -1
  335. package/types/server/di/utils.d.ts +16 -0
  336. package/types/server/lifecycle/runtimeDir.d.ts +5 -0
  337. package/types/server/lifecycle/shutdownManager.d.ts +2 -1
  338. package/types/server/logging/childOutputReader.d.ts +40 -0
  339. package/types/server/logging/hubFileSink.d.ts +18 -0
  340. package/types/server/logging/logControlSocket.d.ts +60 -0
  341. package/types/server/logging/logForwarder.d.ts +37 -0
  342. package/types/server/logging/logHub.d.ts +70 -0
  343. package/types/server/logging/logQuery.d.ts +31 -0
  344. package/types/server/logging/logStdoutWriter.d.ts +35 -0
  345. package/types/server/logging/logStreamRoute.d.ts +20 -0
  346. package/types/server/logging/logTailClient.d.ts +42 -0
  347. package/types/server/mcp/McpAuth.d.ts +62 -0
  348. package/types/server/mcp/McpDispatcher.d.ts +61 -0
  349. package/types/server/mcp/McpEventStream.d.ts +17 -0
  350. package/types/server/mcp/McpExecutionContext.d.ts +44 -0
  351. package/types/server/mcp/McpRouter.d.ts +65 -0
  352. package/types/server/mcp/index.d.ts +5 -0
  353. package/types/server/mcp.d.ts +1 -0
  354. package/types/server/resolver/signal.resolver.d.ts +7 -4
  355. package/types/server/routeTreeBuilder.d.ts +1 -2
  356. package/types/server/routing/apiRouter.d.ts +2 -1
  357. package/types/server/routing/appWsData.d.ts +19 -3
  358. package/types/server/routing/eventStream.d.ts +23 -0
  359. package/types/server/routing/soloAppRoutes.d.ts +17 -0
  360. package/types/server/rscWorkerHost.d.ts +4 -1
  361. package/types/server/semaphore.d.ts +5 -0
  362. package/types/server/ssrFromRscRenderer.d.ts +14 -0
  363. package/types/server/staticPath.d.ts +17 -0
  364. package/types/server/subRouteIndexDocument.d.ts +8 -0
  365. package/types/server/systemPageDocument.d.ts +1 -0
  366. package/types/server/systemPages.d.ts +5 -0
  367. package/types/server/types.d.ts +16 -0
  368. package/types/server/vendor/akanjs-fetch.d.ts +1 -0
  369. package/types/server/webRouter.d.ts +15 -4
  370. package/types/service/adapt.d.ts +3 -3
  371. package/types/service/agent.service.d.ts +32 -0
  372. package/types/service/base.service.d.ts +4 -0
  373. package/types/service/index.d.ts +1 -0
  374. package/types/service/injectInfo.d.ts +2 -2
  375. package/types/service/ipcTypes.d.ts +12 -0
  376. package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
  377. package/types/service/predefinedAdaptor/database.adaptor.d.ts +16 -402
  378. package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
  379. package/types/service/predefinedAdaptor/index.d.ts +3 -0
  380. package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
  381. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
  382. package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
  383. package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
  384. package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
  385. package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
  386. package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
  387. package/types/service/predefinedAdaptor/sql/PendingStoreEnsures.d.ts +6 -0
  388. package/types/service/predefinedAdaptor/sql/QueryCompiler.d.ts +28 -0
  389. package/types/service/predefinedAdaptor/sql/SqlDocumentStore.d.ts +127 -0
  390. package/types/service/predefinedAdaptor/sql/UpdateCompiler.d.ts +17 -0
  391. package/types/service/predefinedAdaptor/sql/dialect/postgres.d.ts +27 -0
  392. package/types/service/predefinedAdaptor/sql/dialect/sqlite.d.ts +27 -0
  393. package/types/service/predefinedAdaptor/sql/driver/bunSqlite.d.ts +16 -0
  394. package/types/service/predefinedAdaptor/sql/driver/libsql.d.ts +17 -0
  395. package/types/service/predefinedAdaptor/sql/driver/postgres.d.ts +17 -0
  396. package/types/service/predefinedAdaptor/sql/types.d.ts +226 -0
  397. package/types/service/predefinedAdaptor/sql/values.d.ts +13 -0
  398. package/types/service/serve.d.ts +3 -3
  399. package/types/service/toolNames.d.ts +35 -0
  400. package/types/signal/CrossSiteGuard.d.ts +44 -0
  401. package/types/signal/SignalFailure.d.ts +28 -0
  402. package/types/signal/agent/AgentCatalogue.d.ts +100 -0
  403. package/types/signal/agent/index.d.ts +1 -0
  404. package/types/signal/agent.d.ts +1 -0
  405. package/types/signal/agent.signal.d.ts +24 -0
  406. package/types/signal/agentTurn.d.ts +9 -0
  407. package/types/signal/agentTurnStream.d.ts +24 -0
  408. package/types/signal/base.signal.d.ts +1 -1
  409. package/types/signal/endpointInfo.d.ts +21 -3
  410. package/types/signal/exception.d.ts +38 -54774
  411. package/types/signal/guard.d.ts +12 -0
  412. package/types/signal/guards.d.ts +23 -1
  413. package/types/signal/index.d.ts +8 -0
  414. package/types/signal/intercept.d.ts +5 -5
  415. package/types/signal/internal.d.ts +5 -1
  416. package/types/signal/internalArg.d.ts +22 -6
  417. package/types/signal/mcp/McpDocument.d.ts +84 -0
  418. package/types/signal/mcp/McpProgress.d.ts +40 -0
  419. package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
  420. package/types/signal/mcp/Msg.d.ts +143 -0
  421. package/types/signal/mcp/index.d.ts +5 -0
  422. package/types/signal/mcp/mcpProtocol.d.ts +107 -0
  423. package/types/signal/mcp.d.ts +1 -0
  424. package/types/signal/middleware.d.ts +7 -7
  425. package/types/signal/openapi/openapi.d.ts +3 -3
  426. package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
  427. package/types/signal/schema/index.d.ts +1 -0
  428. package/types/signal/schema.d.ts +1 -0
  429. package/types/signal/serializer/fetch.serializer.d.ts +7 -1
  430. package/types/signal/signalContext.d.ts +67 -8
  431. package/types/signal/slice.d.ts +42 -15
  432. package/types/signal/trace.d.ts +52 -2
  433. package/types/signal/types.d.ts +53 -4
  434. package/types/store/SliceRequest.d.ts +16 -0
  435. package/types/store/action.d.ts +7 -5
  436. package/types/store/actionTag.d.ts +21 -0
  437. package/types/store/agent/AgentBridge.d.ts +37 -0
  438. package/types/store/agent/AgentContext.d.ts +16 -0
  439. package/types/store/agent/AgentPrompts.d.ts +31 -0
  440. package/types/store/agent/ScreenReader.d.ts +29 -0
  441. package/types/store/agent/ScreenSettle.d.ts +22 -0
  442. package/types/store/agent/ScreenTarget.d.ts +34 -0
  443. package/types/store/agent/StoreCatalogue.d.ts +26 -0
  444. package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
  445. package/types/store/agent/index.d.ts +11 -0
  446. package/types/store/agent/storeSurface.d.ts +14 -0
  447. package/types/store/agent/types.d.ts +15 -0
  448. package/types/store/agent.d.ts +1 -0
  449. package/types/store/agentic/AgentValue.d.ts +43 -0
  450. package/types/store/agentic/StExposeBuilder.d.ts +21 -0
  451. package/types/store/agentic/StExposeDraft.d.ts +13 -0
  452. package/types/store/agentic/StStateBuilder.d.ts +21 -0
  453. package/types/store/agentic/StStateDraft.d.ts +12 -0
  454. package/types/store/agentic/StToolBuilder.d.ts +65 -0
  455. package/types/store/agentic/StToolDraft.d.ts +13 -0
  456. package/types/store/agentic/attachAgentic.d.ts +25 -0
  457. package/types/store/agentic/formFields.d.ts +53 -0
  458. package/types/store/agentic/index.d.ts +12 -0
  459. package/types/store/agentic/useFieldTool.d.ts +22 -0
  460. package/types/store/agentic/useFormTools.d.ts +19 -0
  461. package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
  462. package/types/store/agentic.d.ts +1 -0
  463. package/types/store/baseSt.d.ts +35 -39
  464. package/types/store/databaseStateNames.d.ts +25 -0
  465. package/types/store/formSetterNames.d.ts +30 -0
  466. package/types/store/index.d.ts +7 -0
  467. package/types/store/rootStore.d.ts +5 -1
  468. package/types/store/sliceRole.d.ts +25 -0
  469. package/types/store/store.d.ts +5 -1
  470. package/types/store/storeInstance.d.ts +33 -1
  471. package/types/store/storeRegistry.d.ts +5 -0
  472. package/types/store/types.d.ts +4 -0
  473. package/types/store/withSelector.d.ts +5 -4
  474. package/types/test/index.d.ts +1 -1
  475. package/types/test/registerDom.d.ts +1 -0
  476. package/types/test/signalTestRuntime.d.ts +2 -3
  477. package/types/test/testServer.d.ts +6 -4
  478. package/types/ui/Agent/Approval.d.ts +8 -0
  479. package/types/ui/Agent/Attach.d.ts +16 -0
  480. package/types/ui/Agent/Bubble.d.ts +26 -0
  481. package/types/ui/Agent/Chat.d.ts +91 -0
  482. package/types/ui/Agent/ChatCommands.d.ts +34 -0
  483. package/types/ui/Agent/Composer.d.ts +23 -0
  484. package/types/ui/Agent/Context.d.ts +13 -0
  485. package/types/ui/Agent/Dock.d.ts +17 -0
  486. package/types/ui/Agent/Guide.d.ts +9 -0
  487. package/types/ui/Agent/History.d.ts +26 -0
  488. package/types/ui/Agent/Launcher.d.ts +16 -0
  489. package/types/ui/Agent/Markdown.d.ts +19 -0
  490. package/types/ui/Agent/Menu.d.ts +18 -0
  491. package/types/ui/Agent/Mic.d.ts +8 -0
  492. package/types/ui/Agent/Question.d.ts +14 -0
  493. package/types/ui/Agent/Section.d.ts +10 -0
  494. package/types/ui/Agent/Skip.d.ts +22 -0
  495. package/types/ui/Agent/StateKey.d.ts +16 -0
  496. package/types/ui/Agent/Tool.d.ts +15 -0
  497. package/types/ui/Agent/Transcript.d.ts +13 -0
  498. package/types/ui/Agent/Zone.d.ts +48 -0
  499. package/types/ui/Agent/agentSessionOf.d.ts +27 -0
  500. package/types/ui/Agent/attachment.d.ts +34 -0
  501. package/types/ui/Agent/fetchRunner.d.ts +12 -0
  502. package/types/ui/Agent/index.d.ts +19 -0
  503. package/types/ui/Agent/index_.d.ts +1 -0
  504. package/types/ui/Agent/markdownBlocks.d.ts +35 -0
  505. package/types/ui/Agent/markdownSpans.d.ts +2 -0
  506. package/types/ui/Agent/markdownTable.d.ts +16 -0
  507. package/types/ui/Agent/sessionHistory.d.ts +14 -0
  508. package/types/ui/Agent/sessionView.d.ts +15 -0
  509. package/types/ui/Agent/tokenCount.d.ts +6 -0
  510. package/types/ui/Agent/useChatAttachments.d.ts +24 -0
  511. package/types/ui/Agent/useChatVoice.d.ts +30 -0
  512. package/types/ui/Agent/useDraftRecall.d.ts +14 -0
  513. package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
  514. package/types/ui/Agent/useSlashMenu.d.ts +24 -0
  515. package/types/ui/Agent/voice.d.ts +71 -0
  516. package/types/ui/Agent.d.ts +1 -0
  517. package/types/ui/Badge.d.ts +1 -1
  518. package/types/ui/Button.d.ts +1 -1
  519. package/types/ui/Constant/Graph.d.ts +10 -0
  520. package/types/ui/Constant/index.d.ts +2 -1
  521. package/types/ui/Constant/schemaGraph.d.ts +39 -0
  522. package/types/ui/Data/Dashboard.d.ts +16 -3
  523. package/types/ui/Data/Insight.d.ts +1 -1
  524. package/types/ui/Data/ListContainer.d.ts +15 -7
  525. package/types/ui/Data/QueryMaker.d.ts +45 -3
  526. package/types/ui/Data/RefPicker.d.ts +16 -0
  527. package/types/ui/Data/dataExport.d.ts +5 -0
  528. package/types/ui/Data/dataText.d.ts +6 -0
  529. package/types/ui/Data/index.d.ts +2 -0
  530. package/types/ui/Data/index_.d.ts +1 -0
  531. package/types/ui/DatePicker.d.ts +15 -11
  532. package/types/ui/Dialog/LegacyModal.d.ts +13 -0
  533. package/types/ui/Dialog/Provider.d.ts +3 -1
  534. package/types/ui/Dialog/context.d.ts +9 -1
  535. package/types/ui/Dialog/index.d.ts +1 -0
  536. package/types/ui/DraggableList.d.ts +1 -1
  537. package/types/ui/Dropdown.d.ts +5 -1
  538. package/types/ui/Field/Choice.d.ts +52 -0
  539. package/types/ui/Field/Collection.d.ts +51 -0
  540. package/types/ui/Field/DateField.d.ts +32 -0
  541. package/types/ui/Field/Label.d.ts +9 -0
  542. package/types/ui/Field/NumberField.d.ts +43 -0
  543. package/types/ui/Field/Relation.d.ts +80 -0
  544. package/types/ui/Field/Text.d.ts +101 -0
  545. package/types/ui/Field/index.d.ts +50 -0
  546. package/types/ui/Field.d.ts +1 -411
  547. package/types/ui/Layout/BottomTab.d.ts +3 -2
  548. package/types/ui/LegacyModal.d.ts +24 -0
  549. package/types/ui/Load/Edit_Client.d.ts +3 -1
  550. package/types/ui/Load/Stream.d.ts +22 -0
  551. package/types/ui/Load/index.d.ts +2 -0
  552. package/types/ui/Loading/ProgressBar.d.ts +4 -0
  553. package/types/ui/Loading/Spin.d.ts +2 -1
  554. package/types/ui/Loading/index_.d.ts +13 -0
  555. package/types/ui/Model/AdminPanel.d.ts +15 -3
  556. package/types/ui/Model/EditModal.d.ts +1 -1
  557. package/types/ui/Model/New.d.ts +3 -1
  558. package/types/ui/Model/NewWrapper.d.ts +2 -0
  559. package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
  560. package/types/ui/Pagination.d.ts +2 -2
  561. package/types/ui/Radio.d.ts +1 -1
  562. package/types/ui/RecentTime.d.ts +18 -1
  563. package/types/ui/Reference/Collapse.d.ts +11 -0
  564. package/types/ui/Reference/Panel.d.ts +29 -0
  565. package/types/ui/Reference/Segmented.d.ts +17 -0
  566. package/types/ui/Reference/Summary.d.ts +13 -0
  567. package/types/ui/Reference/Toolbar.d.ts +21 -0
  568. package/types/ui/Reference/dictText.d.ts +6 -0
  569. package/types/ui/Reference/index.d.ts +7 -0
  570. package/types/ui/Reference/style.d.ts +20 -0
  571. package/types/ui/Reference.d.ts +1 -0
  572. package/types/ui/ScreenNavigator.d.ts +3 -1
  573. package/types/ui/Signal/Arg.d.ts +7 -3
  574. package/types/ui/Signal/Doc.d.ts +4 -6
  575. package/types/ui/Signal/Object.d.ts +2 -1
  576. package/types/ui/Signal/RestApi.d.ts +2 -1
  577. package/types/ui/Signal/WebSocket.d.ts +2 -1
  578. package/types/ui/Signal/endpointEntries.d.ts +20 -0
  579. package/types/ui/Signal/style.d.ts +9 -8
  580. package/types/ui/System/Client.d.ts +1 -2
  581. package/types/ui/System/Common.d.ts +3 -4
  582. package/types/ui/System/Messages.d.ts +1 -1
  583. package/types/ui/System/Root.d.ts +4 -0
  584. package/types/ui/Tab/Provider.d.ts +3 -1
  585. package/types/ui/Tab/context.d.ts +4 -2
  586. package/types/ui/ToggleSelect.d.ts +1 -0
  587. package/types/ui/UiOverride/context.d.ts +18 -1
  588. package/types/ui/agentAttrs.d.ts +14 -0
  589. package/types/ui/index.d.ts +22 -1
  590. package/types/ui/overlayLayer.d.ts +13 -0
  591. package/types/ui/overlayPosition.d.ts +28 -0
  592. package/types/ui/recipe/badgeRecipe.d.ts +2 -2
  593. package/types/ui/recipe/buttonRecipe.d.ts +2 -2
  594. package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
  595. package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
  596. package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
  597. package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
  598. package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
  599. package/types/vendor/use-agentic/Agentic.d.ts +21 -0
  600. package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
  601. package/types/vendor/use-agentic/Compaction.d.ts +48 -0
  602. package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
  603. package/types/vendor/use-agentic/Transcript.d.ts +18 -0
  604. package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
  605. package/types/vendor/use-agentic/index.d.ts +19 -0
  606. package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
  607. package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
  608. package/types/vendor/use-agentic/types.d.ts +182 -0
  609. package/types/vendor/use-agentic/useAgent.d.ts +4 -0
  610. package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
  611. package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
  612. package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
  613. package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
  614. package/types/vendor/use-agentic.d.ts +1 -0
  615. package/types/webkit/index.d.ts +4 -0
  616. package/types/webkit/useBodyScrollLock.d.ts +2 -0
  617. package/types/webkit/useCamera.d.ts +10 -1
  618. package/types/webkit/usePageTool.d.ts +19 -0
  619. package/types/webkit/usePurchase.d.ts +4 -0
  620. package/types/webkit/useScreenScope.d.ts +25 -0
  621. package/ui/Agent/Approval.tsx +32 -0
  622. package/ui/Agent/Attach.tsx +77 -0
  623. package/ui/Agent/Bubble.tsx +192 -0
  624. package/ui/Agent/Chat.tsx +525 -0
  625. package/ui/Agent/ChatCommands.ts +141 -0
  626. package/ui/Agent/Composer.tsx +94 -0
  627. package/ui/Agent/Context.tsx +49 -0
  628. package/ui/Agent/Dock.tsx +77 -0
  629. package/ui/Agent/Guide.tsx +16 -0
  630. package/ui/Agent/History.tsx +49 -0
  631. package/ui/Agent/Launcher.tsx +60 -0
  632. package/ui/Agent/Markdown.tsx +142 -0
  633. package/ui/Agent/Menu.tsx +55 -0
  634. package/ui/Agent/Mic.tsx +27 -0
  635. package/ui/Agent/Question.tsx +63 -0
  636. package/ui/Agent/Section.tsx +24 -0
  637. package/ui/Agent/Skip.tsx +30 -0
  638. package/ui/Agent/StateKey.tsx +46 -0
  639. package/ui/Agent/Tool.tsx +59 -0
  640. package/ui/Agent/Transcript.tsx +33 -0
  641. package/ui/Agent/Zone.tsx +116 -0
  642. package/ui/Agent/agentSessionOf.ts +60 -0
  643. package/ui/Agent/attachment.ts +73 -0
  644. package/ui/Agent/fetchRunner.ts +44 -0
  645. package/ui/Agent/index.ts +27 -0
  646. package/ui/Agent/index_.tsx +4 -0
  647. package/ui/Agent/markdownBlocks.ts +137 -0
  648. package/ui/Agent/markdownSpans.tsx +49 -0
  649. package/ui/Agent/markdownTable.ts +54 -0
  650. package/ui/Agent/sessionHistory.ts +62 -0
  651. package/ui/Agent/sessionView.ts +38 -0
  652. package/ui/Agent/tokenCount.ts +10 -0
  653. package/ui/Agent/useChatAttachments.ts +84 -0
  654. package/ui/Agent/useChatVoice.ts +129 -0
  655. package/ui/Agent/useDraftRecall.ts +42 -0
  656. package/ui/Agent/useKeyboardInset.ts +26 -0
  657. package/ui/Agent/useSlashMenu.ts +58 -0
  658. package/ui/Agent/voice.ts +177 -0
  659. package/ui/Badge.tsx +1 -1
  660. package/ui/BottomSheet.tsx +32 -36
  661. package/ui/Button.tsx +3 -1
  662. package/ui/Clipboard.tsx +3 -6
  663. package/ui/Constant/Doc.tsx +265 -254
  664. package/ui/Constant/Graph.tsx +151 -0
  665. package/ui/Constant/index.ts +3 -2
  666. package/ui/Constant/schemaGraph.ts +232 -0
  667. package/ui/Data/CardList.tsx +14 -3
  668. package/ui/Data/Dashboard.tsx +70 -52
  669. package/ui/Data/Insight.tsx +18 -12
  670. package/ui/Data/Item.tsx +42 -56
  671. package/ui/Data/ListContainer.tsx +246 -132
  672. package/ui/Data/Pagination.tsx +10 -3
  673. package/ui/Data/QueryMaker.tsx +160 -11
  674. package/ui/Data/RefPicker.tsx +202 -0
  675. package/ui/Data/TableList.tsx +22 -13
  676. package/ui/Data/dataExport.ts +54 -0
  677. package/ui/Data/dataText.ts +22 -0
  678. package/ui/Data/index.ts +13 -1
  679. package/ui/Data/index_.tsx +1 -0
  680. package/ui/DatePicker.tsx +110 -128
  681. package/ui/Dialog/Close.tsx +3 -7
  682. package/ui/Dialog/LegacyModal.tsx +241 -0
  683. package/ui/Dialog/Modal.tsx +62 -195
  684. package/ui/Dialog/Provider.tsx +47 -3
  685. package/ui/Dialog/Trigger.tsx +3 -7
  686. package/ui/Dialog/context.ts +14 -2
  687. package/ui/Dialog/index.tsx +2 -0
  688. package/ui/DragAction.tsx +3 -2
  689. package/ui/DraggableList.tsx +10 -6
  690. package/ui/Dropdown.tsx +89 -27
  691. package/ui/Empty.tsx +6 -4
  692. package/ui/Field/Choice.tsx +172 -0
  693. package/ui/Field/Collection.tsx +293 -0
  694. package/ui/Field/DateField.tsx +138 -0
  695. package/ui/Field/Label.tsx +31 -0
  696. package/ui/Field/NumberField.tsx +169 -0
  697. package/ui/Field/Relation.tsx +387 -0
  698. package/ui/Field/Text.tsx +360 -0
  699. package/ui/Field/index.tsx +70 -0
  700. package/ui/Input.tsx +30 -8
  701. package/ui/KeyboardAvoiding.tsx +2 -2
  702. package/ui/Layout/BottomTab.tsx +32 -37
  703. package/ui/Layout/Sider.tsx +37 -14
  704. package/ui/LegacyModal.tsx +53 -0
  705. package/ui/Link/CsrLink.tsx +1 -1
  706. package/ui/Load/Edit.tsx +2 -2
  707. package/ui/Load/Edit_Client.tsx +11 -3
  708. package/ui/Load/Pagination.tsx +35 -28
  709. package/ui/Load/Stream.tsx +38 -0
  710. package/ui/Load/Units.tsx +76 -40
  711. package/ui/Load/View.tsx +34 -19
  712. package/ui/Load/index.ts +2 -0
  713. package/ui/Loading/Area.tsx +7 -6
  714. package/ui/Loading/Button.tsx +7 -9
  715. package/ui/Loading/Input.tsx +7 -9
  716. package/ui/Loading/ProgressBar.tsx +16 -7
  717. package/ui/Loading/Skeleton.tsx +8 -13
  718. package/ui/Loading/Spin.tsx +20 -14
  719. package/ui/Loading/index.ts +15 -0
  720. package/ui/Loading/index_.tsx +22 -0
  721. package/ui/Menu.tsx +1 -1
  722. package/ui/Model/AdminPanel.tsx +52 -12
  723. package/ui/Model/EditModal.tsx +35 -13
  724. package/ui/Model/EditWrapper.tsx +16 -4
  725. package/ui/Model/New.tsx +4 -0
  726. package/ui/Model/NewWrapper.tsx +2 -0
  727. package/ui/Model/NewWrapper_Client.tsx +20 -6
  728. package/ui/Model/Remove.tsx +18 -6
  729. package/ui/Model/RemoveWrapper.tsx +12 -2
  730. package/ui/Model/SureToRemove.tsx +18 -6
  731. package/ui/Model/ViewEditModal.tsx +64 -15
  732. package/ui/Model/ViewModal.tsx +25 -11
  733. package/ui/Model/ViewWrapper.tsx +15 -4
  734. package/ui/Model/index_.tsx +1 -1
  735. package/ui/Pagination.tsx +51 -66
  736. package/ui/Popconfirm.tsx +88 -78
  737. package/ui/Radio.tsx +53 -24
  738. package/ui/RecentTime.tsx +83 -35
  739. package/ui/Reference/Collapse.tsx +26 -0
  740. package/ui/Reference/Panel.tsx +79 -0
  741. package/ui/Reference/Segmented.tsx +41 -0
  742. package/ui/Reference/Summary.tsx +25 -0
  743. package/ui/Reference/Toolbar.tsx +44 -0
  744. package/ui/Reference/dictText.ts +9 -0
  745. package/ui/Reference/index.ts +7 -0
  746. package/ui/Reference/style.ts +45 -0
  747. package/ui/ScreenNavigator.tsx +17 -2
  748. package/ui/Select.tsx +96 -57
  749. package/ui/Signal/Arg.tsx +83 -68
  750. package/ui/Signal/Doc.tsx +163 -129
  751. package/ui/Signal/Listener.tsx +40 -29
  752. package/ui/Signal/Message.tsx +94 -142
  753. package/ui/Signal/Object.tsx +79 -57
  754. package/ui/Signal/PubSub.tsx +76 -114
  755. package/ui/Signal/Request.tsx +2 -22
  756. package/ui/Signal/Response.tsx +19 -45
  757. package/ui/Signal/RestApi.tsx +170 -200
  758. package/ui/Signal/WebSocket.tsx +29 -26
  759. package/ui/Signal/endpointEntries.ts +59 -0
  760. package/ui/Signal/makeExample.ts +10 -3
  761. package/ui/Signal/style.ts +34 -29
  762. package/ui/Switch.tsx +4 -0
  763. package/ui/System/CSR.tsx +1 -1
  764. package/ui/System/Client.tsx +31 -17
  765. package/ui/System/Common.tsx +3 -4
  766. package/ui/System/DevModeToggle.tsx +1 -1
  767. package/ui/System/Gtag.tsx +3 -3
  768. package/ui/System/Messages.tsx +52 -31
  769. package/ui/System/Reconnect.tsx +22 -56
  770. package/ui/System/Root.tsx +4 -0
  771. package/ui/System/SelectLanguage.tsx +24 -15
  772. package/ui/System/ThemeToggle.tsx +25 -13
  773. package/ui/Tab/Menu.tsx +24 -12
  774. package/ui/Tab/Menus.tsx +6 -3
  775. package/ui/Tab/Provider.tsx +30 -3
  776. package/ui/Tab/context.ts +8 -4
  777. package/ui/Table.tsx +66 -60
  778. package/ui/ToggleSelect.tsx +8 -7
  779. package/ui/Tooltip.tsx +15 -1
  780. package/ui/UiOverride/context.ts +21 -2
  781. package/ui/Unauthorized.tsx +6 -4
  782. package/ui/agentAttrs.ts +19 -0
  783. package/ui/index.ts +49 -1
  784. package/ui/overlayLayer.ts +12 -2
  785. package/ui/overlayPosition.ts +103 -0
  786. package/ui/recipe/buttonRecipe.ts +2 -2
  787. package/ui/styles.css +31 -0
  788. package/vendor/use-agentic/AgentAbort.ts +29 -0
  789. package/vendor/use-agentic/AgentProgress.ts +40 -0
  790. package/vendor/use-agentic/AgentProvider.tsx +39 -0
  791. package/vendor/use-agentic/AgentScope.tsx +20 -0
  792. package/vendor/use-agentic/AgentSession.ts +750 -0
  793. package/vendor/use-agentic/Agentic.tsx +44 -0
  794. package/vendor/use-agentic/AgenticSurface.ts +333 -0
  795. package/vendor/use-agentic/Compaction.ts +120 -0
  796. package/vendor/use-agentic/ToolOutput.ts +60 -0
  797. package/vendor/use-agentic/Transcript.ts +50 -0
  798. package/vendor/use-agentic/WIRE.md +86 -0
  799. package/vendor/use-agentic/httpRunner.ts +131 -0
  800. package/vendor/use-agentic/index.ts +20 -0
  801. package/vendor/use-agentic/sharedContext.ts +25 -0
  802. package/vendor/use-agentic/surfaceContext.ts +10 -0
  803. package/vendor/use-agentic/types.ts +192 -0
  804. package/vendor/use-agentic/useAgent.ts +18 -0
  805. package/vendor/use-agentic/useAgentGuide.ts +16 -0
  806. package/vendor/use-agentic/useAgentResource.ts +36 -0
  807. package/vendor/use-agentic/useAgentState.ts +64 -0
  808. package/vendor/use-agentic/useAgentTool.ts +55 -0
  809. package/webkit/bootCsr.tsx +10 -8
  810. package/webkit/index.ts +4 -0
  811. package/webkit/lazy.tsx +5 -1
  812. package/webkit/useBodyScrollLock.tsx +29 -0
  813. package/webkit/useCamera.tsx +22 -6
  814. package/webkit/useCodepush.tsx +2 -2
  815. package/webkit/useCsrValues.ts +1 -3
  816. package/webkit/useFetch.ts +4 -3
  817. package/webkit/useFrameRuntime.ts +15 -8
  818. package/webkit/usePageTool.tsx +37 -0
  819. package/webkit/usePurchase.tsx +4 -1
  820. package/webkit/useScreenScope.tsx +60 -0
  821. package/fetch/serializer/fetch.serializer.ts +0 -142
  822. package/fetch/serializer/index.ts +0 -1
  823. package/types/common/httpClient.d.ts +0 -20
  824. package/types/fetch/serializer/fetch.serializer.d.ts +0 -14
  825. package/types/fetch/serializer/index.d.ts +0 -1
  826. package/types/fetch/serializer.d.ts +0 -1
  827. package/types/ui/Constant/Mermaid.d.ts +0 -8
  828. package/types/ui/Signal/Collapse.d.ts +0 -12
  829. package/ui/Constant/Mermaid.tsx +0 -149
  830. package/ui/Field.tsx +0 -1569
  831. package/ui/Loading/index.tsx +0 -22
  832. package/ui/Signal/Collapse.tsx +0 -29
@@ -1,4 +1,4 @@
1
- import type { SerializedArg } from "akanjs/signal";
1
+ import type { HttpMutationMethod, SerializedArg } from "akanjs/signal";
2
2
 
3
3
  export interface ErrorResponsePayload {
4
4
  error: string;
@@ -22,18 +22,49 @@ export interface ErrorConstructor {
22
22
  fromJSON: (payload: ErrorResponsePayload) => RestoredError;
23
23
  }
24
24
 
25
- interface FetchOptions {
25
+ export interface HttpClientOptions {
26
26
  headers?: Record<string, string>;
27
+ /** Milliseconds before the request is abandoned; `false` waits as long as the browser will. */
28
+ timeout?: number | false;
29
+ ErrorCls?: ErrorConstructor;
30
+ }
31
+
32
+ interface FetchOptions extends Pick<HttpClientOptions, "headers" | "timeout"> {
27
33
  baseUrl?: string;
28
34
  }
29
35
 
36
+ const jsonContentType = /^application\/(?:[\w.+-]+\+)?json\b/i;
37
+
38
+ const transportErrorKeyMap = {
39
+ 408: "base.error.gatewayTimeout",
40
+ 502: "base.error.serverUnavailable",
41
+ 503: "base.error.serverUnavailable",
42
+ 504: "base.error.gatewayTimeout",
43
+ } as const;
44
+
45
+ const serverUnreachableKey = "base.error.serverUnreachable";
46
+ const unexpectedResponseKey = "base.error.unexpectedResponse";
47
+ const transportDetailLimit = 200;
48
+ /**
49
+ * How long a call waits before giving up.
50
+ *
51
+ * Nothing else bounds it: a gateway answers a dead upstream with a 504, but a solo process has no gateway and a
52
+ * severed connection produces no response at all — the request then sits until the browser's own limit, which is
53
+ * minutes. The dictionary already has the wording for a slow server (`gatewayTimeout`), so this is the client
54
+ * side of an answer that only existed for one deployment shape.
55
+ */
56
+ const DEFAULT_TIMEOUT_MS = 30_000;
57
+
30
58
  export class HttpClient {
31
59
  readonly baseUrl: string;
32
- constructor(
33
- baseUrl: string,
34
- private ErrorCls?: ErrorConstructor,
35
- ) {
60
+ #headers: Record<string, string>;
61
+ #timeout?: number | false;
62
+ private ErrorCls?: ErrorConstructor;
63
+ constructor(baseUrl: string, options: HttpClientOptions = {}) {
36
64
  this.baseUrl = baseUrl;
65
+ this.#headers = options.headers ?? {};
66
+ this.#timeout = options.timeout;
67
+ this.ErrorCls = options.ErrorCls;
37
68
  }
38
69
 
39
70
  setErrorConstructor(ErrorCls?: ErrorConstructor) {
@@ -42,57 +73,131 @@ export class HttpClient {
42
73
  #resolveBaseUrl(baseUrl?: string) {
43
74
  return (baseUrl ?? this.baseUrl).replace(/\/$/, "");
44
75
  }
76
+ #resolveUrl(url: string, options: FetchOptions) {
77
+ return `${this.#resolveBaseUrl(options.baseUrl)}${url}`;
78
+ }
79
+
80
+ #makeHeaders(headers: Record<string, string>, options: FetchOptions) {
81
+ return { Accept: "application/json", ...this.#headers, ...headers, ...options.headers };
82
+ }
45
83
  async get<Returns = unknown>(url: string, options: FetchOptions = {}): Promise<Returns> {
46
- const res = await fetch(`${this.#resolveBaseUrl(options.baseUrl)}${url}`, {
47
- headers: { "Content-Type": "application/json", ...options.headers },
48
- });
49
- return await this.#readJsonResponse<Returns>(res);
84
+ return await this.#request<Returns>(
85
+ this.#resolveUrl(url, options),
86
+ { headers: this.#makeHeaders({ "Content-Type": "application/json" }, options) },
87
+ options,
88
+ );
50
89
  }
51
90
  #makeReqContent(data: FormData | Record<string, unknown>): { body: BodyInit; headers: Record<string, string> } {
52
91
 
53
92
  if (data instanceof FormData) return { body: data, headers: {} };
54
93
  return { body: JSON.stringify(data), headers: { "Content-Type": "application/json" } };
55
94
  }
56
- async put<Returns = unknown>(
95
+ async send<Returns = unknown>(
96
+ method: HttpMutationMethod,
57
97
  url: string,
58
98
  data: FormData | Record<string, unknown>,
59
99
  options: FetchOptions = {},
60
100
  ): Promise<Returns> {
61
101
  const { body, headers } = this.#makeReqContent(data);
62
- const res = await fetch(`${this.#resolveBaseUrl(options.baseUrl)}${url}`, {
63
- method: "PUT",
64
- body,
65
- headers: { ...headers, ...options.headers },
66
- });
67
- return await this.#readJsonResponse<Returns>(res);
102
+ return await this.#request<Returns>(
103
+ this.#resolveUrl(url, options),
104
+ { method, body, headers: this.#makeHeaders(headers, options) },
105
+ options,
106
+ );
107
+ }
108
+ async put<Returns = unknown>(
109
+ url: string,
110
+ data: FormData | Record<string, unknown>,
111
+ options: FetchOptions = {},
112
+ ): Promise<Returns> {
113
+ return await this.send<Returns>("PUT", url, data, options);
68
114
  }
69
115
  async post<Returns = unknown>(
70
116
  url: string,
71
117
  data: FormData | Record<string, unknown>,
72
118
  options: FetchOptions = {},
73
119
  ): Promise<Returns> {
74
- const { body, headers } = this.#makeReqContent(data);
75
- const res = await fetch(`${this.#resolveBaseUrl(options.baseUrl)}${url}`, {
76
- method: "POST",
77
- body,
78
- headers: { ...headers, ...options.headers },
79
- });
80
- return await this.#readJsonResponse<Returns>(res);
120
+ return await this.send<Returns>("POST", url, data, options);
81
121
  }
82
122
  async delete<Returns = unknown>(url: string, options: FetchOptions = {}): Promise<Returns> {
83
- const res = await fetch(`${this.#resolveBaseUrl(options.baseUrl)}${url}`, {
84
- method: "DELETE",
85
- headers: { "Content-Type": "application/json", ...options.headers },
86
- });
123
+ return await this.#request<Returns>(
124
+ this.#resolveUrl(url, options),
125
+ { method: "DELETE", headers: this.#makeHeaders({ "Content-Type": "application/json" }, options) },
126
+ options,
127
+ );
128
+ }
129
+
130
+ async #request<Returns>(url: string, init: RequestInit, options: FetchOptions = {}): Promise<Returns> {
131
+ const res = await this.#fetch(url, this.#withTimeout(init, options));
87
132
  return await this.#readJsonResponse<Returns>(res);
88
133
  }
89
134
 
135
+ /**
136
+ * An upload gets no deadline of its own: a large file on a slow uplink is a long request that is working, and
137
+ * the request body is the only thing this side can tell that from. Everything else takes the default unless
138
+ * the caller named one.
139
+ */
140
+ #withTimeout(init: RequestInit, options: FetchOptions): RequestInit {
141
+ const timeout = options.timeout ?? (init.body instanceof FormData ? false : (this.#timeout ?? DEFAULT_TIMEOUT_MS));
142
+ if (timeout === false || !Number.isFinite(timeout) || timeout <= 0) return init;
143
+ return { ...init, signal: AbortSignal.timeout(timeout) };
144
+ }
145
+
146
+ /**
147
+ * `fetch` rejects only when no response arrived at all — a refused connection, a DNS failure, a socket
148
+ * dropped mid-flight. That is the server being unreachable, not an error this API reported, so it is
149
+ * restored as one rather than surfacing the runtime's own `TypeError: Failed to fetch`.
150
+ */
151
+ async #fetch(url: string, init: RequestInit) {
152
+ try {
153
+ return await fetch(url, init);
154
+ } catch (error) {
155
+
156
+ if (error instanceof Error && error.name === "TimeoutError")
157
+ throw this.#restoreError({ error: transportErrorKeyMap[408], data: { status: 408 } }, 408);
158
+ if (error instanceof Error && error.name === "AbortError") throw error;
159
+ throw this.#restoreError({ error: serverUnreachableKey, details: String(error) }, 503);
160
+ }
161
+ }
162
+
90
163
  async #readJsonResponse<Returns>(res: Response): Promise<Returns> {
91
- const body = await res.json();
164
+ const body = await this.#readBody(res);
92
165
  if (res.ok) return body as Returns;
93
166
  throw this.#restoreError(body, res.status);
94
167
  }
95
168
 
169
+ /**
170
+ * A proxy answers a restarting upstream with a page of its own — nginx's `504 Gateway Time-out` HTML,
171
+ * the federation gateway's plain-text 503. That body is not this API's, so parsing it would surface the
172
+ * parser's complaint (`Unexpected token '<'`) instead of the fact that the server is down.
173
+ */
174
+ async #readBody(res: Response) {
175
+ if (jsonContentType.test(res.headers.get("content-type") ?? "")) {
176
+ try {
177
+ return (await res.json()) as unknown;
178
+ } catch (error) {
179
+ throw this.#transportError(res.status, String(error));
180
+ }
181
+ }
182
+ const raw = await res.text();
183
+ const parsed = HttpClient.#parseJson(raw);
184
+ if (parsed === undefined) throw this.#transportError(res.status, raw);
185
+ return parsed;
186
+ }
187
+
188
+ static #parseJson(raw: string): unknown {
189
+ try {
190
+ return JSON.parse(raw) as unknown;
191
+ } catch {
192
+ return undefined;
193
+ }
194
+ }
195
+
196
+ #transportError(status: number, detail: string): RestoredError {
197
+ const error = transportErrorKeyMap[status as keyof typeof transportErrorKeyMap] ?? unexpectedResponseKey;
198
+ return this.#restoreError({ error, data: { status }, details: detail.slice(0, transportDetailLimit) }, status);
199
+ }
200
+
96
201
  #restoreError(body: unknown, fallbackStatusCode: number): RestoredError {
97
202
  const payload =
98
203
  body && typeof body === "object" && "error" in body
@@ -112,7 +217,12 @@ export class HttpClient {
112
217
  searchArgs.forEach((arg) => {
113
218
  const argValue = argMap.get(arg.name);
114
219
  if (argValue === null || argValue === undefined) return;
115
- if (arg.arrDepth && Array.isArray(argValue))
220
+
221
+ if (arg.refName === "Any") {
222
+
223
+ const encoded = JSON.stringify(argValue);
224
+ if (encoded !== undefined) searchParams.set(arg.name, encoded);
225
+ } else if (arg.arrDepth && Array.isArray(argValue))
116
226
  argValue.forEach((value) => {
117
227
  searchParams.append(arg.name, String(value));
118
228
  });
@@ -0,0 +1,101 @@
1
+ import { DataList } from "akanjs/base";
2
+ import { type BaseInsight, type BaseObject, withSharedInstances } from "akanjs/constant";
3
+
4
+ import { FetchHandle } from "./fetchHandle";
5
+
6
+ export interface SliceInitInput {
7
+ refName: string;
8
+ capRefName: string;
9
+ capSuffix: string;
10
+ sliceName: string;
11
+ argLength: number;
12
+ queryArgs: unknown[];
13
+ page: number;
14
+ limit: number;
15
+ sort: string;
16
+ listRequest: Promise<BaseObject[]>;
17
+ /** `null` when the caller passed `{ insight: false }` — the aggregate query is then never made. */
18
+ insightRequest: Promise<BaseInsight | null>;
19
+ light: new (obj?: unknown) => BaseObject;
20
+ insight: new (obj?: unknown) => object;
21
+ }
22
+
23
+ /**
24
+ * The two calls a slice's `init` makes and the three values callers read off them.
25
+ *
26
+ * The list does not wait for the aggregate: `x<Slice>List` resolves as soon as the rows land, while
27
+ * `x<Slice>Init` — which carries `lastPageOf<Model>` and therefore needs the count — waits for both. Every
28
+ * derived value is memoized, so the awaited shape and the un-awaited handle hand out the same instances.
29
+ */
30
+ export class SliceInitHandle {
31
+ readonly #input: SliceInitInput;
32
+ #serverInit?: object;
33
+ #modelList?: DataList<BaseObject>;
34
+ #modelInsight?: object;
35
+
36
+ constructor(input: SliceInitInput) {
37
+ this.#input = input;
38
+ }
39
+
40
+ build() {
41
+ const { refName, capSuffix, listRequest, insightRequest } = this.#input;
42
+ const keys = {
43
+ init: `${refName}Init${capSuffix}`,
44
+ list: `${refName}List${capSuffix}`,
45
+ insight: `${refName}Insight${capSuffix}`,
46
+ };
47
+ return FetchHandle.of<Record<string, unknown>, Record<string, Promise<unknown>>>(
48
+ [listRequest, insightRequest],
49
+ async () => {
50
+ const [modelObjList, modelObjInsight] = await Promise.all([listRequest, insightRequest]);
51
+ return FetchHandle.lazy({ [keys.init]: this.#serverInitOf(modelObjList, modelObjInsight) }, {
52
+ [keys.list]: () => this.#listOf(modelObjList),
53
+ [keys.insight]: () => this.#insightOf(modelObjInsight),
54
+ } as { [key: string]: () => unknown });
55
+ },
56
+ {
57
+ [keys.init]: () =>
58
+ Promise.all([listRequest, insightRequest]).then(([modelObjList, modelObjInsight]) =>
59
+ this.#serverInitOf(modelObjList, modelObjInsight),
60
+ ),
61
+ [keys.list]: () => listRequest.then((modelObjList) => this.#listOf(modelObjList)),
62
+ [keys.insight]: () => insightRequest.then((modelObjInsight) => this.#insightOf(modelObjInsight)),
63
+ },
64
+ );
65
+ }
66
+
67
+ #serverInitOf(modelObjList: BaseObject[], modelObjInsight: BaseInsight | null) {
68
+ const { refName, capRefName, sliceName, argLength, queryArgs, page, limit, sort } = this.#input;
69
+ const lastPage = modelObjInsight?.count
70
+ ? Math.max(Math.floor((modelObjInsight.count - 1) / (limit || 20)) + 1, 1)
71
+ : 1;
72
+ this.#serverInit ??= {
73
+ refName,
74
+ sliceName,
75
+ argLength,
76
+ [`${refName}ObjList`]: modelObjList,
77
+ [`${refName}ObjInsight`]: modelObjInsight,
78
+ [`pageOf${capRefName}`]: page,
79
+ [`lastPageOf${capRefName}`]: lastPage,
80
+ [`limitOf${capRefName}`]: limit,
81
+ [`queryArgsOf${capRefName}`]: queryArgs,
82
+ [`sortOf${capRefName}`]: sort,
83
+ [`${refName}InitAt`]: new Date(),
84
+ };
85
+ return this.#serverInit;
86
+ }
87
+
88
+ #listOf(modelObjList: BaseObject[]) {
89
+ const { light } = this.#input;
90
+ this.#modelList ??= new DataList(
91
+ withSharedInstances(() => modelObjList.map((modelObj) => new light(modelObj) as BaseObject)),
92
+ );
93
+ return this.#modelList;
94
+ }
95
+
96
+ #insightOf(modelObjInsight: BaseInsight | null) {
97
+ const { insight } = this.#input;
98
+ this.#modelInsight ??= new insight(modelObjInsight);
99
+ return this.#modelInsight;
100
+ }
101
+ }
@@ -1,4 +1,4 @@
1
- import { Logger, websocketAuthContract } from "akanjs/common";
1
+ import { Logger, websocketAuthContract, websocketBinaryFrameContract } from "akanjs/common";
2
2
  import type {
3
3
  WebsocketAuthAck,
4
4
  WebsocketMessageData,
@@ -41,6 +41,7 @@ export class WsClient {
41
41
  #listenerMap = new Map<string, Set<Listener>>();
42
42
  #destroyed = false;
43
43
  #connectRequested = false;
44
+ #outbox: string[] = [];
44
45
  #unconnectedWarnTimers = new Map<string, ReturnType<typeof setTimeout>>();
45
46
  #jwt: string | null = null;
46
47
  connected = false;
@@ -84,6 +85,7 @@ export class WsClient {
84
85
  if (this.#destroyed) return;
85
86
 
86
87
  this.#ws = new WebSocket(this.url);
88
+ this.#ws.binaryType = "arraybuffer";
87
89
  this.#ws.onopen = (e) => {
88
90
  this.#reconnectAttempts = 0;
89
91
  this.connected = true;
@@ -94,10 +96,19 @@ export class WsClient {
94
96
  const data: WebsocketReqData = { key: option.key, data: option.data, subscribe: true };
95
97
  this.#ws?.send(JSON.stringify(data));
96
98
  });
99
+ const queued = this.#outbox;
100
+ this.#outbox = [];
101
+ for (const frame of queued) this.#ws?.send(frame);
97
102
  };
98
103
  this.#ws.onmessage = (e) => {
99
104
  try {
100
- const parsed = typeof e.data === "string" ? JSON.parse(e.data) : e.data;
105
+ if (typeof e.data !== "string") {
106
+ const frame = websocketBinaryFrameContract.decode(e.data as ArrayBuffer);
107
+ if (frame) this.#handlePubsub(frame.roomId, frame.payload);
108
+ else this.logger.warn("Unknown binary WebSocket frame");
109
+ return;
110
+ }
111
+ const parsed = JSON.parse(e.data) as { error?: unknown } & WebsocketResData;
101
112
  if (parsed?.error) {
102
113
  throw this.#restoreError(parsed);
103
114
  }
@@ -197,6 +208,7 @@ export class WsClient {
197
208
  }
198
209
  for (const timer of this.#unconnectedWarnTimers.values()) clearTimeout(timer);
199
210
  this.#unconnectedWarnTimers.clear();
211
+ this.#outbox = [];
200
212
  this.#ws?.close();
201
213
  this.#ws = null;
202
214
  }
@@ -240,28 +252,31 @@ export class WsClient {
240
252
  `[akanjs] WebSocket is not connected. Call fetch.instance.connect(), or drop the root layout "wsConnect = false", before ${action} "${key}".`,
241
253
  );
242
254
  }
243
- #warnUnconnectedSubscribe(key: string) {
244
- if (this.#connectRequested || this.#unconnectedWarnTimers.has(key)) return;
255
+ #warnUnconnected(action: "emit" | "subscribe", key: string) {
256
+ const timerKey = `${action}:${key}`;
257
+ if (this.#connectRequested || this.#unconnectedWarnTimers.has(timerKey)) return;
245
258
  const timer = setTimeout(() => {
246
- this.#unconnectedWarnTimers.delete(key);
259
+ this.#unconnectedWarnTimers.delete(timerKey);
247
260
  if (this.#connectRequested || this.#destroyed) return;
248
- this.#warnNotConnected("subscribe", key);
261
+ this.#warnNotConnected(action, key);
249
262
  }, 0);
250
- this.#unconnectedWarnTimers.set(key, timer);
263
+ this.#unconnectedWarnTimers.set(timerKey, timer);
251
264
  }
252
265
  emit(key: string, data: WsRequestPayload) {
266
+ const payload: WebsocketReqData = { key, data: Array.isArray(data) ? data : [data] };
267
+ const frame = JSON.stringify(payload);
268
+
253
269
  if (this.#ws?.readyState !== WebSocket.OPEN) {
254
- this.logger.warn("WebSocket not connected");
255
- this.#warnNotConnected("emit", key);
270
+ this.#outbox.push(frame);
271
+ this.#warnUnconnected("emit", key);
256
272
  return this;
257
273
  }
258
- const payload: WebsocketReqData = { key, data: Array.isArray(data) ? data : [data] };
259
- this.#ws.send(JSON.stringify(payload));
274
+ this.#ws.send(frame);
260
275
  return this;
261
276
  }
262
277
  subscribe(option: { key: string; data: unknown[]; handleEvent: (data: unknown) => void }) {
263
278
  const roomId = WsClient.makeRoomId(option.key, option.data);
264
- if (!this.#ws) this.#warnUnconnectedSubscribe(option.key);
279
+ if (!this.#ws) this.#warnUnconnected("subscribe", option.key);
265
280
  if (!this.#roomSubscribeMap.has(roomId)) {
266
281
  this.#roomSubscribeMap.set(roomId, { key: option.key, data: option.data, listener: new Set() });
267
282
  if (this.#ws?.readyState === WebSocket.OPEN) {
@@ -8,33 +8,63 @@ export type SliceMeta = {
8
8
  argLength: number;
9
9
  };
10
10
 
11
- export type ServerInit<
11
+ /** What the root slice takes: one of the model's declared filter queries, and the args that filter asks for. */
12
+ export interface QuerySetting {
13
+ queryKey: string;
14
+ /**
15
+ * Read when the query is applied rather than when the setting is written, so a thunk keeps an arg relative to
16
+ * now — `() => [dayjs().subtract(1, "hour")]` — current at the moment the user asks for it.
17
+ */
18
+ args?: unknown[] | (() => unknown[]);
19
+ /**
20
+ * The same list under the name the rest of the framework already uses for it — the `queryArgsOf<Model>` state
21
+ * key, `refresh<Model>({ queryArgs })`, and a field's own `.meta(...)` declaration. Accepted so a query a
22
+ * field declares is one of these as it stands, rather than something every caller has to rename by hand.
23
+ * `args` wins when both are given.
24
+ */
25
+ queryArgs?: unknown[] | (() => unknown[]);
26
+ }
27
+
28
+ type ServerInitShape<
12
29
  RefName extends string,
13
- Light,
14
- Insight = any,
15
- QueryArgs = any,
16
- Filter extends FilterInstance = any,
17
- _CapitalizedRefName extends string = Capitalize<RefName>,
18
- _LightObj = GetStateObject<Light>,
19
- _InsightObj = GetStateObject<Insight>,
20
- _Sort = ExtractSort<Filter>,
30
+ QueryArgs,
31
+ CapRefName extends string,
32
+ LightObj,
33
+ InsightObj,
34
+ Sort,
21
35
  > = SliceMeta & {
22
- [K in `${RefName}ObjList`]: _LightObj[];
36
+ [K in `${RefName}ObjList`]: LightObj[];
23
37
  } & {
24
- [K in `${RefName}ObjInsight`]: _InsightObj;
38
+ /** `null` when the caller passed `{ insight: false }`: the aggregate query was never made. */
39
+ [K in `${RefName}ObjInsight`]: InsightObj | null;
25
40
  } & {
26
- [K in `pageOf${_CapitalizedRefName}`]: number;
41
+ [K in `pageOf${CapRefName}`]: number;
27
42
  } & {
28
- [K in `lastPageOf${_CapitalizedRefName}`]: number;
43
+ [K in `lastPageOf${CapRefName}`]: number;
29
44
  } & {
30
- [K in `limitOf${_CapitalizedRefName}`]: number;
45
+ [K in `limitOf${CapRefName}`]: number;
31
46
  } & {
32
- [K in `queryArgsOf${_CapitalizedRefName}`]: QueryArgs;
47
+ [K in `queryArgsOf${CapRefName}`]: QueryArgs;
33
48
  } & {
34
- [K in `sortOf${_CapitalizedRefName}`]: _Sort;
49
+ [K in `sortOf${CapRefName}`]: Sort;
35
50
  } & {
36
51
  [K in `${RefName}InitAt`]: Date;
37
52
  };
53
+
54
+ export type ServerInit<
55
+ RefName extends string,
56
+ Light,
57
+ Insight = any,
58
+ QueryArgs = any,
59
+ Filter extends FilterInstance = any,
60
+ > = ServerInitShape<
61
+ RefName,
62
+ QueryArgs,
63
+ Capitalize<RefName>,
64
+ GetStateObject<Light>,
65
+ GetStateObject<Insight>,
66
+ ExtractSort<Filter>
67
+ >;
38
68
  /** Client/server-friendly return type for initialized list and insight data. */
39
69
  export type ClientInit<
40
70
  RefName extends string,
@@ -42,13 +72,7 @@ export type ClientInit<
42
72
  Insight = any,
43
73
  QueryArgs = any,
44
74
  Filter extends FilterInstance = any,
45
- _CapitalizedRefName extends string = Capitalize<RefName>,
46
- _LightObj = GetStateObject<Light>,
47
- _InsightObj = GetStateObject<Insight>,
48
- _Sort = ExtractSort<Filter>,
49
- > = PromiseOrObject<
50
- ServerInit<RefName, Light, Insight, QueryArgs, Filter, _CapitalizedRefName, _LightObj, _InsightObj, _Sort>
51
- >;
75
+ > = PromiseOrObject<ServerInit<RefName, Light, Insight, QueryArgs, Filter>>;
52
76
 
53
77
  export type ServerView<RefName extends string, Model> = { refName: RefName } & {
54
78
  [K in `${RefName}Obj`]: GetStateObject<Model>;
@@ -77,6 +101,43 @@ export type EditReturn<RefName extends string, Full> = {
77
101
  [K in `${RefName}Edit`]: ServerEdit<RefName, Full>;
78
102
  };
79
103
 
104
+ /**
105
+ * What `fetch.view<Model>` / `fetch.edit<Model>` / `fetch.init<Model><Suffix>` return: awaitable for the shape
106
+ * the helper has always given, and destructurable into one promise per field for a route that wants each
107
+ * section to render as its own data lands instead of holding the page for the slowest.
108
+ */
109
+ export type FetchHandleOf<Awaited, Fields> = PromiseLike<Awaited> & Fields;
110
+
111
+ export type ViewHandle<RefName extends string, Full> = FetchHandleOf<
112
+ ViewReturn<RefName, Full>,
113
+ {
114
+ [K in RefName]: Promise<Full>;
115
+ } & {
116
+ [K in `${RefName}View`]: Promise<ServerView<RefName, Full>>;
117
+ }
118
+ >;
119
+
120
+ export type EditHandle<RefName extends string, Full> = FetchHandleOf<
121
+ EditReturn<RefName, Full>,
122
+ {
123
+ [K in RefName]: Promise<Full>;
124
+ } & {
125
+ [K in `${RefName}Edit`]: Promise<ServerEdit<RefName, Full>>;
126
+ }
127
+ >;
128
+
129
+ type InitReturnShape<
130
+ RefName extends string,
131
+ CapSuffix extends string,
132
+ Init,
133
+ ListItem extends { id: string },
134
+ Insight,
135
+ > = {
136
+ [K in `${RefName}Init${CapSuffix}`]: Init;
137
+ } & {
138
+ [K in `${RefName}List${CapSuffix}`]: DataList<ListItem>;
139
+ } & { [K in `${RefName}Insight${CapSuffix}`]: Insight };
140
+
80
141
  export type InitReturn<
81
142
  RefName extends string,
82
143
  Suffix extends string,
@@ -84,25 +145,48 @@ export type InitReturn<
84
145
  Insight,
85
146
  Args,
86
147
  Filter extends FilterInstance,
87
- _CapitalizedRefName extends string = Capitalize<RefName>,
88
- _CapitalizedSuffix extends string = Capitalize<Suffix>,
89
- _Light extends { id: string } = Light extends { id: string } ? Light : { id: string },
90
- _LightObj = GetStateObject<_Light>,
91
- _InsightObj = GetStateObject<Insight>,
92
- _Sort = ExtractSort<Filter>,
148
+ > = InitReturnShape<
149
+ RefName,
150
+ Capitalize<Suffix>,
151
+ ServerInit<RefName, Light, Insight, Args, Filter>,
152
+ Light extends { id: string } ? Light : { id: string },
153
+ Insight
154
+ >;
155
+
156
+ /**
157
+ * The list resolves without waiting for the aggregate, so `x<Slice>List` lands before `x<Slice>Init` — which
158
+ * carries `lastPageOf<Model>` and therefore needs the count.
159
+ *
160
+ * `x<Slice>List` and `x<Slice>Insight` hold hydrated model instances, which React Flight refuses as props to a
161
+ * client component: consume them in a server component and hand `x<Slice>Init` to a `Zone`.
162
+ */
163
+ type InitHandleShape<
164
+ RefName extends string,
165
+ CapSuffix extends string,
166
+ Init,
167
+ ListItem extends { id: string },
168
+ Insight,
93
169
  > = {
94
- [K in `${RefName}Init${_CapitalizedSuffix}`]: ServerInit<
95
- RefName,
96
- Light,
97
- Insight,
98
- Args,
99
- Filter,
100
- _CapitalizedRefName,
101
- _LightObj,
102
- _InsightObj,
103
- _Sort
104
- >;
170
+ [K in `${RefName}Init${CapSuffix}`]: Promise<Init>;
105
171
  } & {
106
- [K in `${RefName}List${_CapitalizedSuffix}`]: DataList<_Light>;
107
- } & { [K in `${RefName}Insight${_CapitalizedSuffix}`]: Insight };
172
+ [K in `${RefName}List${CapSuffix}`]: Promise<DataList<ListItem>>;
173
+ } & { [K in `${RefName}Insight${CapSuffix}`]: Promise<Insight> };
174
+
175
+ export type InitHandle<
176
+ RefName extends string,
177
+ Suffix extends string,
178
+ Light,
179
+ Insight,
180
+ Args,
181
+ Filter extends FilterInstance,
182
+ > = FetchHandleOf<
183
+ InitReturn<RefName, Suffix, Light, Insight, Args, Filter>,
184
+ InitHandleShape<
185
+ RefName,
186
+ Capitalize<Suffix>,
187
+ ServerInit<RefName, Light, Insight, Args, Filter>,
188
+ Light extends { id: string } ? Light : { id: string },
189
+ Insight
190
+ >
191
+ >;
108
192
 
@@ -7,6 +7,7 @@ import type {
7
7
  EndpInfoReqType,
8
8
  EndpointCls,
9
9
  EndpointInfo,
10
+ PromptMessage,
10
11
  SlceCnstFull,
11
12
  SlceCnstInsight,
12
13
  SlceCnstLight,
@@ -32,15 +33,21 @@ type EndpointClientReturns<E, SlceCls extends SliceCls | never> = [SlceCls] exte
32
33
  SlceCnstInsight<SlceCls>
33
34
  >;
34
35
 
35
- type EndpInfoReturns<E, SlceCls extends SliceCls | never> =
36
- | EndpointClientReturns<E, SlceCls>
37
- | (EndpInfoNullable<E> extends true ? null : never);
36
+ type OrNull<T, Nullable> = Nullable extends true ? T | null : T;
37
+
38
+ type EndpInfoReturns<E, SlceCls extends SliceCls | never> = OrNull<
39
+ EndpointClientReturns<E, SlceCls>,
40
+ EndpInfoNullable<E>
41
+ >;
38
42
 
39
43
  type QueryOrMutationFetchFn<E, SlceCls extends SliceCls | never> = (
40
44
  ...args: [...EndpInfoArgs<E>, fetchPolicy?: FetchPolicy]
41
45
  ) => Promise<EndpInfoReturns<E, SlceCls>>;
42
46
 
43
- type MessageEmitFn<E> = (...args: EndpInfoArgs<E>) => void;
47
+ /** Typed off `PromptResult` rather than the endpoint's return ref, which is the `Any` carrier a prompt rides on. */
48
+ type PromptFetchFn<E> = (...args: [...EndpInfoArgs<E>, fetchPolicy?: FetchPolicy]) => Promise<PromptMessage[]>;
49
+
50
+ type MessageEmitFn<E> = (...args: [...EndpInfoArgs<E>, fetchPolicy?: FetchPolicy]) => void;
44
51
 
45
52
  type MessageListenFn<E, SlceCls extends SliceCls | never> = (
46
53
  handleEvent: (data: EndpInfoReturns<E, SlceCls>) => PromiseOrObject<void>,
@@ -58,12 +65,14 @@ type PubsubSubscribeFn<E, SlceCls extends SliceCls | never> = (
58
65
  type PrimaryFetchFn<E, SlceCls extends SliceCls | never> =
59
66
  EndpInfoReqType<E> extends "query" | "mutation"
60
67
  ? QueryOrMutationFetchFn<E, SlceCls>
61
- : EndpInfoReqType<E> extends "message"
62
- ? MessageEmitFn<E>
63
- : never;
68
+ : EndpInfoReqType<E> extends "prompt"
69
+ ? PromptFetchFn<E>
70
+ : EndpInfoReqType<E> extends "message"
71
+ ? MessageEmitFn<E>
72
+ : never;
64
73
 
65
74
  type PrimaryFetchType<EInfoObj extends { [key: string]: EndpointInfo }, SlceCls extends SliceCls | never> = {
66
- [K in keyof EInfoObj as EndpInfoReqType<EInfoObj[K]> extends "query" | "mutation" | "message"
75
+ [K in keyof EInfoObj as EndpInfoReqType<EInfoObj[K]> extends "query" | "mutation" | "prompt" | "message"
67
76
  ? K
68
77
  : never]: PrimaryFetchFn<EInfoObj[K], SlceCls>;
69
78
  };