akanjs 3.0.0-beta.19 → 3.0.0-beta.20

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 (1237) hide show
  1. package/base/base.ts +5 -10
  2. package/base/baseEnv.ts +5 -8
  3. package/base/databaseModes.ts +3 -4
  4. package/base/primitiveRegistry.ts +16 -45
  5. package/base/symbols.ts +1 -1
  6. package/base/types.ts +1 -1
  7. package/base/utils.ts +3 -6
  8. package/capacitor.base.config.ts +2 -3
  9. package/client/capacitor.ts +18 -63
  10. package/client/cn.ts +3 -13
  11. package/client/cookie.ts +6 -15
  12. package/client/createFont.ts +0 -2
  13. package/client/csrTypes.ts +6 -29
  14. package/client/decorators.ts +1 -1
  15. package/client/device.ts +52 -44
  16. package/client/frameConfig.ts +13 -24
  17. package/client/index.ts +0 -1
  18. package/client/makePageProto.tsx +3 -4
  19. package/client/route/RouteDefinition.ts +4 -17
  20. package/client/route/resolveRouteModule.ts +1 -5
  21. package/client/router.ts +16 -45
  22. package/client/rscNavigation.ts +4 -5
  23. package/client/sharedContext.ts +2 -19
  24. package/client/storage.ts +29 -38
  25. package/client/translator.ts +5 -6
  26. package/client/types.ts +0 -3
  27. package/common/CodeAgentClient.ts +3 -14
  28. package/common/CodeTranscript.ts +7 -42
  29. package/common/Logger.ts +9 -34
  30. package/common/TrustedProxy.ts +6 -34
  31. package/common/applyMixins.ts +13 -2
  32. package/common/authToken.ts +0 -11
  33. package/common/capitalize.ts +3 -4
  34. package/common/clamp.ts +0 -1
  35. package/common/clientAddress.ts +1 -15
  36. package/common/codeAgentProfile.ts +13 -61
  37. package/common/codeAgentWire.ts +21 -170
  38. package/common/eventStream.ts +1 -6
  39. package/common/fileUpload.ts +1 -12
  40. package/common/formatNumber.ts +3 -12
  41. package/common/index.ts +14 -23
  42. package/common/interpolateTranslation.ts +1 -6
  43. package/common/isEmail.ts +0 -1
  44. package/common/isRecord.ts +2 -0
  45. package/common/isThenable.ts +1 -8
  46. package/common/isValidDate.ts +3 -5
  47. package/common/logContext.ts +1 -1
  48. package/common/markdownBlocks.ts +0 -3
  49. package/common/markdownSpans.ts +1 -11
  50. package/common/markdownTable.ts +1 -5
  51. package/common/mcpExposure.ts +4 -27
  52. package/common/objectPath.ts +67 -0
  53. package/common/objectify.ts +52 -0
  54. package/common/{isPhoneNumber.ts → phone.ts} +7 -1
  55. package/common/randomPick.ts +13 -0
  56. package/common/requestOrigin.ts +0 -17
  57. package/common/restClient.ts +8 -13
  58. package/common/round.ts +4 -0
  59. package/common/routeConvention.ts +21 -11
  60. package/common/sleep.ts +1 -8
  61. package/common/subRoute.ts +4 -7
  62. package/common/toError.ts +1 -0
  63. package/common/tunnelWire.ts +23 -115
  64. package/common/types.ts +5 -10
  65. package/common/{splitVersion.ts → version.ts} +3 -6
  66. package/common/{websocketBinaryFrame.ts → websocketContract.ts} +43 -9
  67. package/constant/cascadePaths.ts +6 -9
  68. package/constant/constantRegistry.ts +13 -46
  69. package/constant/crystalize.ts +2 -12
  70. package/constant/dateSlot.ts +0 -15
  71. package/constant/fieldInfo.ts +30 -109
  72. package/constant/fieldQueryMeta.ts +2 -10
  73. package/constant/getDefault.ts +4 -15
  74. package/constant/hydrationPlan.ts +1 -9
  75. package/constant/index.ts +0 -1
  76. package/constant/labelOf.ts +1 -6
  77. package/constant/mask.ts +7 -41
  78. package/constant/purify.ts +6 -14
  79. package/constant/serialize.ts +82 -5
  80. package/constant/textFieldPaths.ts +2 -3
  81. package/constant/types.ts +2 -6
  82. package/constant/via.ts +20 -60
  83. package/dictionary/DictionaryLookup.ts +1 -7
  84. package/dictionary/agent.dictionary.ts +33 -3
  85. package/dictionary/dictInfo.ts +145 -626
  86. package/dictionary/dictShape.ts +54 -0
  87. package/dictionary/dictionary.ts +1 -2
  88. package/dictionary/dictionaryRegistry.ts +7 -28
  89. package/dictionary/locale.ts +24 -116
  90. package/dictionary/trans.ts +18 -56
  91. package/document/dataLoader.ts +34 -68
  92. package/document/database.ts +13 -53
  93. package/document/documentQuery.ts +32 -32
  94. package/document/documentSchema.ts +21 -26
  95. package/document/filterMeta.ts +11 -31
  96. package/document/index.ts +0 -1
  97. package/document/into.ts +8 -18
  98. package/document/noDocumentError.ts +2 -7
  99. package/document/queryEvaluator.ts +11 -42
  100. package/document/types.ts +0 -1
  101. package/fetch/client/fetchClient.ts +40 -99
  102. package/fetch/client/fetchHandle.ts +4 -12
  103. package/fetch/client/httpClient.ts +31 -68
  104. package/fetch/client/remoteError.ts +2 -8
  105. package/fetch/client/sliceInitHandle.ts +3 -6
  106. package/fetch/client/sliceQueryArgs.ts +11 -0
  107. package/fetch/client/wsClient.ts +30 -59
  108. package/fetch/fetchType/appliedReturn.type.ts +5 -24
  109. package/fetch/fetchType/buildFetch.type.ts +28 -1
  110. package/fetch/fetchType/index.ts +0 -1
  111. package/fetch/requestStorage.ts +7 -28
  112. package/fetch/types.ts +0 -1
  113. package/index.ts +22 -70
  114. package/package.json +11 -5
  115. package/server/akanApp.ts +110 -288
  116. package/server/akanAppHeaders.ts +2 -3
  117. package/server/akanOption.ts +6 -36
  118. package/server/akanServer.ts +60 -215
  119. package/server/animatedImage.ts +2 -11
  120. package/server/artifact/builderRpc.ts +17 -62
  121. package/server/artifact/index.ts +0 -1
  122. package/server/artifact/ipcTypes.ts +26 -30
  123. package/server/artifact/routeClientCache.ts +13 -36
  124. package/server/artifact/routeSeedIndexStore.ts +2 -35
  125. package/server/artifact/routesManifestStore.ts +13 -38
  126. package/server/binaryPubsub.ts +0 -9
  127. package/server/cachePolicy.ts +10 -44
  128. package/server/console.ts +3 -7
  129. package/server/consoleSession.ts +55 -12
  130. package/server/contentEncoding.ts +42 -27
  131. package/server/decorators.ts +2 -7
  132. package/server/devtools/constantSerializer.ts +2 -14
  133. package/server/devtools/depsSerializer.ts +13 -42
  134. package/server/devtools/devtoolsJson.ts +6 -18
  135. package/server/devtools/devtoolsRouter.ts +2 -12
  136. package/server/devtools/signalSerializer.ts +5 -44
  137. package/server/devtools/types.ts +0 -12
  138. package/server/di/diLifecycle.ts +108 -218
  139. package/server/di/predefinedAdaptor.ts +1 -5
  140. package/server/di/resolveHierarchy.ts +114 -5
  141. package/server/di/utils.ts +13 -29
  142. package/server/head.tsx +7 -14
  143. package/server/hmr/clientScript.ts +2 -8
  144. package/server/hmr/devHmrController.ts +20 -31
  145. package/server/hmr/wsHub.ts +9 -7
  146. package/server/imageOptimizer.ts +2 -25
  147. package/server/index.ts +1 -1
  148. package/server/lifecycle/portInUse.ts +1 -4
  149. package/server/lifecycle/runtimeDir.ts +0 -4
  150. package/server/lifecycle/shutdownManager.ts +4 -29
  151. package/server/logging/childOutputReader.ts +0 -12
  152. package/server/logging/hubFileSink.ts +10 -6
  153. package/server/logging/logControlSocket.ts +13 -7
  154. package/server/logging/logForwarder.ts +19 -22
  155. package/server/logging/logHub.ts +0 -0
  156. package/server/logging/logQuery.ts +4 -7
  157. package/server/logging/logStdoutWriter.ts +1 -11
  158. package/server/logging/logStreamRoute.ts +3 -20
  159. package/server/logging/logTailClient.ts +1 -8
  160. package/server/logging/rotatingLogWriter.ts +4 -6
  161. package/server/mcp/McpAuth.ts +5 -79
  162. package/server/mcp/McpDispatcher.ts +8 -87
  163. package/server/mcp/McpEventStream.ts +1 -11
  164. package/server/mcp/McpExecutionContext.ts +1 -42
  165. package/server/mcp/McpRateLimiter.ts +2 -17
  166. package/server/mcp/McpRouter.ts +37 -202
  167. package/server/mcp/PagePromptComposer.ts +1 -27
  168. package/server/memoryLimit.ts +1 -13
  169. package/server/oauth/OAuthAuthorize.ts +3 -7
  170. package/server/oauth/OAuthClientIdMetadata.ts +2 -27
  171. package/server/oauth/OAuthErrors.ts +0 -13
  172. package/server/oauth/OAuthMetadata.ts +1 -7
  173. package/server/oauth/OAuthPkce.ts +0 -2
  174. package/server/oauth/OAuthRedirect.ts +0 -9
  175. package/server/oauth/OAuthRegistration.ts +0 -2
  176. package/server/oauth/OAuthRevocation.ts +1 -11
  177. package/server/oauth/OAuthToken.ts +3 -14
  178. package/server/oauth/oauthTypes.ts +1 -2
  179. package/server/ops/ageEncryption.ts +1 -6
  180. package/server/ops/opsCommand.ts +0 -4
  181. package/server/ops/opsRoute.ts +3 -7
  182. package/server/ops/opsToken.ts +0 -4
  183. package/server/ops/snapshotJobs.ts +0 -4
  184. package/server/ops/snapshotRestore.ts +2 -11
  185. package/server/ops/snapshotTypes.ts +1 -3
  186. package/server/ops/sqliteFiles.ts +4 -27
  187. package/server/ops/sqliteSnapshot.ts +4 -8
  188. package/server/processMetricsCollector.ts +12 -14
  189. package/server/proxy/hostBasePathWebProxy.ts +20 -13
  190. package/server/proxy/index.ts +2 -3
  191. package/server/proxy/localeWebProxy.ts +3 -17
  192. package/server/proxy/types.ts +14 -0
  193. package/server/proxy/webProxyRunner.ts +13 -1
  194. package/server/resolver/CascadeRunner.ts +7 -23
  195. package/server/resolver/database.resolver.ts +32 -101
  196. package/server/resolver/service.resolver.ts +9 -161
  197. package/server/resolver/signal.resolver.ts +30 -94
  198. package/server/routeElementComposer.tsx +20 -49
  199. package/server/routeState.ts +15 -34
  200. package/server/routeTreeBuilder.ts +23 -59
  201. package/server/routing/apiRouter.ts +12 -48
  202. package/server/routing/appWsData.ts +4 -28
  203. package/server/routing/soloAppRoutes.ts +0 -5
  204. package/server/rscClient.tsx +13 -49
  205. package/server/rscClientFetch.ts +2 -4
  206. package/server/rscClientPatch.ts +4 -25
  207. package/server/rscHttp.ts +1 -1
  208. package/server/rscNavigationState.ts +10 -25
  209. package/server/rscPagePrompts.ts +4 -24
  210. package/server/rscSegmentOutlet.tsx +1 -5
  211. package/server/rscWorker.tsx +136 -264
  212. package/server/rscWorkerCache.ts +74 -8
  213. package/server/rscWorkerHost.ts +36 -191
  214. package/server/semaphore.ts +1 -1
  215. package/server/sitemap.ts +1 -3
  216. package/server/ssrFromRscRenderer.tsx +31 -124
  217. package/server/ssrTypes.ts +3 -29
  218. package/server/staticPath.ts +0 -16
  219. package/server/systemPageDocument.tsx +65 -2
  220. package/server/systemPages.tsx +4 -2
  221. package/server/tunnel/TunnelAgent.ts +2 -15
  222. package/server/tunnel/TunnelDataSocket.ts +14 -8
  223. package/server/tunnel/TunnelHttpStream.ts +0 -7
  224. package/server/tunnel/TunnelTcpStream.ts +44 -48
  225. package/server/tunnel/TunnelWebsocketStream.ts +10 -15
  226. package/server/tunnel/tunnelStream.ts +2 -14
  227. package/server/types.tsx +2 -9
  228. package/server/webRouter.ts +66 -200
  229. package/service/agent.service.ts +8 -79
  230. package/service/injectInfo.ts +1 -2
  231. package/service/ipcTypes.ts +1 -1
  232. package/service/liveSyncHub.ts +4 -34
  233. package/service/predefinedAdaptor/anthropicLlm.ts +12 -77
  234. package/service/predefinedAdaptor/cache.adaptor.ts +4 -8
  235. package/service/predefinedAdaptor/database.adaptor.ts +16 -41
  236. package/service/predefinedAdaptor/documentTransfer.ts +2 -4
  237. package/service/predefinedAdaptor/insightQuery.ts +12 -72
  238. package/service/predefinedAdaptor/llm.adaptor.ts +26 -86
  239. package/service/predefinedAdaptor/llmOverflow.ts +3 -13
  240. package/service/predefinedAdaptor/openaiDialect.ts +13 -63
  241. package/service/predefinedAdaptor/openaiLlm.ts +4 -20
  242. package/service/predefinedAdaptor/queue.adaptor.ts +1 -1
  243. package/service/predefinedAdaptor/schedule.adaptor.ts +3 -4
  244. package/service/predefinedAdaptor/searchIndex.ts +18 -42
  245. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +1 -4
  246. package/service/predefinedAdaptor/solidQueue.adaptor.ts +0 -5
  247. package/service/predefinedAdaptor/solidSqlite.ts +3 -15
  248. package/service/predefinedAdaptor/sql/PendingStoreEnsures.ts +1 -0
  249. package/service/predefinedAdaptor/sql/PostgresInsightSession.ts +5 -8
  250. package/service/predefinedAdaptor/sql/QueryCompiler.ts +6 -14
  251. package/service/predefinedAdaptor/sql/SqlDocumentStore.ts +58 -102
  252. package/service/predefinedAdaptor/sql/SqliteInsightSession.ts +5 -9
  253. package/service/predefinedAdaptor/sql/UpdateCompiler.ts +1 -7
  254. package/service/predefinedAdaptor/sql/dialect/postgres.ts +6 -9
  255. package/service/predefinedAdaptor/sql/dialect/sqlite.ts +2 -3
  256. package/service/predefinedAdaptor/sql/driver/bunSqlite.ts +12 -10
  257. package/service/predefinedAdaptor/sql/driver/libsql.ts +4 -10
  258. package/service/predefinedAdaptor/sql/search/fts5.ts +11 -22
  259. package/service/predefinedAdaptor/sql/search/mirror.ts +1 -1
  260. package/service/predefinedAdaptor/sql/search/postgres.ts +9 -11
  261. package/service/predefinedAdaptor/sql/search/types.ts +3 -7
  262. package/service/predefinedAdaptor/sql/types.ts +5 -9
  263. package/service/predefinedAdaptor/sql/values.ts +26 -1
  264. package/service/predefinedAdaptor/sqlitePath.ts +12 -0
  265. package/service/predefinedAdaptor/sseData.ts +23 -0
  266. package/service/predefinedAdaptor/storage.adaptor.ts +2 -6
  267. package/service/predefinedAdaptor/websocket.adaptor.ts +4 -23
  268. package/service/serve.ts +1 -2
  269. package/service/serviceModule.ts +52 -70
  270. package/service/toolNames.ts +5 -22
  271. package/service/types.ts +3 -9
  272. package/signal/CrossSiteGuard.ts +5 -40
  273. package/signal/SignalFailure.ts +2 -15
  274. package/signal/agent/AgentCatalogue.ts +9 -55
  275. package/signal/agent.signal.ts +1 -2
  276. package/signal/agentMeter.ts +2 -6
  277. package/signal/agentTurnStream.ts +2 -11
  278. package/signal/endpoint.ts +12 -2
  279. package/signal/endpointCache.ts +1 -17
  280. package/signal/endpointInfo.ts +13 -27
  281. package/signal/exception.ts +3 -34
  282. package/signal/guard.ts +4 -22
  283. package/signal/guards.ts +2 -10
  284. package/signal/internal.ts +1 -5
  285. package/signal/internalArg.ts +4 -14
  286. package/signal/internalInfo.ts +1 -1
  287. package/signal/mcp/McpDocument.ts +20 -89
  288. package/signal/mcp/McpProgress.ts +6 -19
  289. package/signal/mcp/McpUriTemplate.ts +1 -27
  290. package/signal/mcp/Msg.ts +13 -122
  291. package/signal/mcp/mcpProtocol.ts +3 -26
  292. package/signal/mcp/pagePrompt.ts +3 -9
  293. package/signal/middleware.ts +2 -10
  294. package/signal/openapi/openapi.ts +0 -4
  295. package/signal/schema/JsonSchemaBuilder.ts +10 -47
  296. package/signal/serializer/fetch.serializer.ts +36 -43
  297. package/signal/serverSignal.ts +6 -8
  298. package/signal/signalContext.ts +55 -154
  299. package/signal/signalRegistry.ts +11 -17
  300. package/signal/slice.ts +6 -12
  301. package/signal/sliceInfo.ts +5 -30
  302. package/signal/trace.ts +11 -84
  303. package/signal/types.ts +21 -80
  304. package/store/SliceRequest.ts +1 -11
  305. package/store/action.ts +153 -395
  306. package/store/actionTag.ts +1 -10
  307. package/store/agent/AgentBridge.ts +3 -25
  308. package/store/agent/AgentContext.ts +2 -9
  309. package/store/agent/AgentCursor.ts +8 -39
  310. package/store/agent/AgentPrompts.ts +0 -15
  311. package/store/agent/AgentVisual.ts +6 -61
  312. package/store/agent/ScreenFlash.ts +8 -40
  313. package/store/agent/ScreenReader.ts +3 -52
  314. package/store/agent/ScreenSettle.ts +1 -13
  315. package/store/agent/ScreenTarget.ts +2 -29
  316. package/store/agent/StoreCatalogue.ts +12 -24
  317. package/store/agent/StoreSurfaceSource.ts +26 -36
  318. package/store/agent/index.ts +0 -3
  319. package/store/agentic/AgentValue.ts +3 -23
  320. package/store/agentic/StExposeBuilder.ts +3 -12
  321. package/store/agentic/StExposeDraft.ts +0 -6
  322. package/store/agentic/StStateBuilder.ts +3 -11
  323. package/store/agentic/StStateDraft.ts +0 -5
  324. package/store/agentic/StToolBuilder.ts +10 -57
  325. package/store/agentic/StToolDraft.ts +0 -7
  326. package/store/agentic/attachAgentic.ts +2 -11
  327. package/store/agentic/formFields.ts +6 -43
  328. package/store/agentic/index.ts +0 -1
  329. package/store/agentic/useAgentReference.ts +2 -20
  330. package/store/agentic/useFieldTool.ts +176 -58
  331. package/store/agentic/useFormTools.ts +3 -20
  332. package/store/agentic/useRelationFieldTool.ts +2 -15
  333. package/store/databaseStateNames.ts +0 -9
  334. package/store/draftStore.ts +4 -54
  335. package/store/formSetterNames.ts +2 -19
  336. package/store/liveInsert.ts +1 -30
  337. package/store/sliceKeys.ts +37 -0
  338. package/store/sliceRole.ts +1 -10
  339. package/store/state.ts +4 -50
  340. package/store/stateBuilder.ts +1 -23
  341. package/store/storeInstance.ts +21 -114
  342. package/store/storeRegistry.ts +1 -8
  343. package/store/types.ts +1 -1
  344. package/test/conformance.ts +7 -21
  345. package/test/index.ts +1 -2
  346. package/test/sampleOf.ts +35 -28
  347. package/test/signalTestRuntime.ts +4 -8
  348. package/test/testServer.ts +10 -27
  349. package/types/base/base.d.ts +2 -3
  350. package/types/base/baseEnv.d.ts +5 -8
  351. package/types/base/databaseModes.d.ts +3 -4
  352. package/types/base/primitiveRegistry.d.ts +7 -11
  353. package/types/base/symbols.d.ts +1 -1
  354. package/types/capacitor.base.config.d.ts +1 -1
  355. package/types/client/cn.d.ts +3 -13
  356. package/types/client/cookie.d.ts +3 -12
  357. package/types/client/csrTypes.d.ts +6 -27
  358. package/types/client/decorators.d.ts +1 -1
  359. package/types/client/device.d.ts +2 -1
  360. package/types/client/index.d.ts +0 -1
  361. package/types/client/route/RouteDefinition.d.ts +3 -13
  362. package/types/client/route/resolveRouteModule.d.ts +1 -5
  363. package/types/client/router.d.ts +3 -15
  364. package/types/client/rscNavigation.d.ts +4 -5
  365. package/types/client/sharedContext.d.ts +2 -19
  366. package/types/client/storage.d.ts +1 -1
  367. package/types/client/types.d.ts +0 -3
  368. package/types/common/CodeAgentClient.d.ts +2 -8
  369. package/types/common/CodeTranscript.d.ts +3 -32
  370. package/types/common/Logger.d.ts +4 -20
  371. package/types/common/TrustedProxy.d.ts +2 -28
  372. package/types/common/applyMixins.d.ts +3 -0
  373. package/types/common/authToken.d.ts +0 -11
  374. package/types/common/capitalize.d.ts +1 -1
  375. package/types/common/clamp.d.ts +0 -1
  376. package/types/common/clientAddress.d.ts +1 -15
  377. package/types/common/codeAgentProfile.d.ts +11 -61
  378. package/types/common/codeAgentWire.d.ts +20 -167
  379. package/types/common/eventStream.d.ts +0 -5
  380. package/types/common/fileUpload.d.ts +6 -11
  381. package/types/common/index.d.ts +11 -21
  382. package/types/common/interpolateTranslation.d.ts +1 -6
  383. package/types/common/isEmail.d.ts +0 -1
  384. package/types/common/isRecord.d.ts +1 -0
  385. package/types/common/isThenable.d.ts +0 -8
  386. package/types/common/logContext.d.ts +1 -1
  387. package/types/common/markdownBlocks.d.ts +0 -3
  388. package/types/common/markdownSpans.d.ts +0 -10
  389. package/types/common/markdownTable.d.ts +0 -2
  390. package/types/common/mcpExposure.d.ts +3 -23
  391. package/types/common/objectPath.d.ts +10 -0
  392. package/types/common/objectify.d.ts +7 -0
  393. package/types/common/phone.d.ts +2 -0
  394. package/types/common/randomPick.d.ts +1 -0
  395. package/types/common/requestOrigin.d.ts +0 -17
  396. package/types/common/restClient.d.ts +0 -7
  397. package/types/common/round.d.ts +1 -0
  398. package/types/common/routeConvention.d.ts +2 -5
  399. package/types/common/sleep.d.ts +0 -1
  400. package/types/common/subRoute.d.ts +4 -6
  401. package/types/common/toError.d.ts +1 -0
  402. package/types/common/tunnelWire.d.ts +22 -114
  403. package/types/common/types.d.ts +6 -10
  404. package/types/common/version.d.ts +6 -0
  405. package/types/common/websocketContract.d.ts +41 -0
  406. package/types/constant/cascadePaths.d.ts +2 -5
  407. package/types/constant/constantRegistry.d.ts +2 -2
  408. package/types/constant/dateSlot.d.ts +0 -5
  409. package/types/constant/fieldInfo.d.ts +2 -21
  410. package/types/constant/fieldQueryMeta.d.ts +2 -10
  411. package/types/constant/getDefault.d.ts +4 -15
  412. package/types/constant/hydrationPlan.d.ts +0 -8
  413. package/types/constant/index.d.ts +0 -1
  414. package/types/constant/labelOf.d.ts +1 -6
  415. package/types/constant/mask.d.ts +7 -41
  416. package/types/constant/serialize.d.ts +10 -2
  417. package/types/constant/types.d.ts +2 -6
  418. package/types/constant/via.d.ts +0 -1
  419. package/types/dictionary/DictionaryLookup.d.ts +1 -7
  420. package/types/dictionary/agent.dictionary.d.ts +1 -0
  421. package/types/dictionary/dictInfo.d.ts +25 -92
  422. package/types/dictionary/dictShape.d.ts +26 -0
  423. package/types/dictionary/dictionary.d.ts +2 -2
  424. package/types/dictionary/dictionaryRegistry.d.ts +1 -15
  425. package/types/dictionary/locale.d.ts +9 -28
  426. package/types/dictionary/trans.d.ts +5 -14
  427. package/types/document/dataLoader.d.ts +1 -6
  428. package/types/document/database.d.ts +6 -11
  429. package/types/document/documentQuery.d.ts +6 -1
  430. package/types/document/documentSchema.d.ts +3 -7
  431. package/types/document/filterMeta.d.ts +3 -8
  432. package/types/document/index.d.ts +0 -1
  433. package/types/document/into.d.ts +3 -2
  434. package/types/document/noDocumentError.d.ts +2 -7
  435. package/types/document/queryEvaluator.d.ts +7 -24
  436. package/types/document/types.d.ts +0 -1
  437. package/types/fetch/client/fetchClient.d.ts +2 -12
  438. package/types/fetch/client/fetchHandle.d.ts +3 -11
  439. package/types/fetch/client/httpClient.d.ts +3 -1
  440. package/types/fetch/client/remoteError.d.ts +2 -8
  441. package/types/fetch/client/sliceInitHandle.d.ts +2 -5
  442. package/types/fetch/client/sliceQueryArgs.d.ts +3 -0
  443. package/types/fetch/client/wsClient.d.ts +10 -15
  444. package/types/fetch/fetchType/appliedReturn.type.d.ts +5 -23
  445. package/types/fetch/fetchType/buildFetch.type.d.ts +15 -1
  446. package/types/fetch/fetchType/index.d.ts +0 -1
  447. package/types/fetch/requestStorage.d.ts +3 -16
  448. package/types/fetch/types.d.ts +0 -1
  449. package/types/index.d.ts +22 -70
  450. package/types/server/akanApp.d.ts +5 -28
  451. package/types/server/akanAppHeaders.d.ts +0 -1
  452. package/types/server/akanOption.d.ts +5 -33
  453. package/types/server/akanServer.d.ts +16 -56
  454. package/types/server/animatedImage.d.ts +0 -6
  455. package/types/server/artifact/builderRpc.d.ts +5 -29
  456. package/types/server/artifact/index.d.ts +0 -1
  457. package/types/server/artifact/ipcTypes.d.ts +21 -29
  458. package/types/server/artifact/routeClientCache.d.ts +3 -11
  459. package/types/server/artifact/routeSeedIndexStore.d.ts +0 -16
  460. package/types/server/artifact/routesManifestStore.d.ts +1 -1
  461. package/types/server/binaryPubsub.d.ts +0 -8
  462. package/types/server/cachePolicy.d.ts +2 -21
  463. package/types/server/console.d.ts +2 -5
  464. package/types/server/consoleSession.d.ts +2 -2
  465. package/types/server/contentEncoding.d.ts +6 -14
  466. package/types/server/decorators.d.ts +0 -5
  467. package/types/server/devtools/constantSerializer.d.ts +1 -6
  468. package/types/server/devtools/depsSerializer.d.ts +1 -7
  469. package/types/server/devtools/devtoolsJson.d.ts +1 -7
  470. package/types/server/devtools/devtoolsRouter.d.ts +2 -11
  471. package/types/server/devtools/signalSerializer.d.ts +1 -9
  472. package/types/server/devtools/types.d.ts +0 -11
  473. package/types/server/di/diLifecycle.d.ts +0 -36
  474. package/types/server/di/predefinedAdaptor.d.ts +0 -4
  475. package/types/server/di/resolveHierarchy.d.ts +22 -5
  476. package/types/server/di/utils.d.ts +4 -17
  477. package/types/server/head.d.ts +0 -1
  478. package/types/server/hmr/devHmrController.d.ts +0 -2
  479. package/types/server/hmr/wsHub.d.ts +6 -1
  480. package/types/server/index.d.ts +1 -1
  481. package/types/server/lifecycle/portInUse.d.ts +1 -4
  482. package/types/server/lifecycle/runtimeDir.d.ts +0 -4
  483. package/types/server/lifecycle/shutdownManager.d.ts +0 -9
  484. package/types/server/logging/childOutputReader.d.ts +0 -12
  485. package/types/server/logging/hubFileSink.d.ts +1 -5
  486. package/types/server/logging/logControlSocket.d.ts +2 -7
  487. package/types/server/logging/logForwarder.d.ts +3 -15
  488. package/types/server/logging/logHub.d.ts +1 -15
  489. package/types/server/logging/logQuery.d.ts +3 -6
  490. package/types/server/logging/logStdoutWriter.d.ts +0 -6
  491. package/types/server/logging/logStreamRoute.d.ts +0 -9
  492. package/types/server/logging/logTailClient.d.ts +0 -5
  493. package/types/server/mcp/McpAuth.d.ts +3 -71
  494. package/types/server/mcp/McpDispatcher.d.ts +0 -23
  495. package/types/server/mcp/McpEventStream.d.ts +0 -11
  496. package/types/server/mcp/McpExecutionContext.d.ts +0 -33
  497. package/types/server/mcp/McpRateLimiter.d.ts +2 -15
  498. package/types/server/mcp/McpRouter.d.ts +0 -46
  499. package/types/server/mcp/PagePromptComposer.d.ts +1 -13
  500. package/types/server/memoryLimit.d.ts +1 -13
  501. package/types/server/oauth/OAuthAuthorize.d.ts +1 -6
  502. package/types/server/oauth/OAuthClientIdMetadata.d.ts +2 -26
  503. package/types/server/oauth/OAuthErrors.d.ts +0 -13
  504. package/types/server/oauth/OAuthMetadata.d.ts +1 -7
  505. package/types/server/oauth/OAuthPkce.d.ts +0 -1
  506. package/types/server/oauth/OAuthRedirect.d.ts +0 -9
  507. package/types/server/oauth/OAuthRegistration.d.ts +0 -1
  508. package/types/server/oauth/OAuthRevocation.d.ts +1 -11
  509. package/types/server/oauth/OAuthToken.d.ts +1 -13
  510. package/types/server/oauth/oauthTypes.d.ts +1 -2
  511. package/types/server/ops/ageEncryption.d.ts +0 -5
  512. package/types/server/ops/opsCommand.d.ts +0 -4
  513. package/types/server/ops/opsRoute.d.ts +0 -4
  514. package/types/server/ops/opsToken.d.ts +0 -4
  515. package/types/server/ops/snapshotJobs.d.ts +0 -1
  516. package/types/server/ops/snapshotRestore.d.ts +1 -1
  517. package/types/server/ops/snapshotTypes.d.ts +1 -2
  518. package/types/server/ops/sqliteFiles.d.ts +0 -5
  519. package/types/server/ops/sqliteSnapshot.d.ts +2 -1
  520. package/types/server/processMetricsCollector.d.ts +3 -1
  521. package/types/server/proxy/hostBasePathWebProxy.d.ts +7 -1
  522. package/types/server/proxy/index.d.ts +2 -3
  523. package/types/server/proxy/localeWebProxy.d.ts +1 -1
  524. package/types/server/proxy/types.d.ts +5 -0
  525. package/types/server/proxy/webProxyRunner.d.ts +1 -0
  526. package/types/server/resolver/CascadeRunner.d.ts +0 -4
  527. package/types/server/resolver/database.resolver.d.ts +1 -1
  528. package/types/server/resolver/service.resolver.d.ts +2 -2
  529. package/types/server/resolver/signal.resolver.d.ts +1 -20
  530. package/types/server/routeElementComposer.d.ts +1 -7
  531. package/types/server/routeState.d.ts +1 -1
  532. package/types/server/routing/apiRouter.d.ts +2 -20
  533. package/types/server/routing/appWsData.d.ts +0 -26
  534. package/types/server/routing/soloAppRoutes.d.ts +0 -5
  535. package/types/server/rscClient.d.ts +0 -9
  536. package/types/server/rscClientFetch.d.ts +4 -6
  537. package/types/server/rscClientPatch.d.ts +1 -1
  538. package/types/server/rscHttp.d.ts +1 -0
  539. package/types/server/rscNavigationState.d.ts +3 -2
  540. package/types/server/rscPagePrompts.d.ts +0 -9
  541. package/types/server/rscWorkerCache.d.ts +41 -3
  542. package/types/server/rscWorkerHost.d.ts +2 -60
  543. package/types/server/ssrFromRscRenderer.d.ts +0 -12
  544. package/types/server/ssrTypes.d.ts +2 -29
  545. package/types/server/staticPath.d.ts +0 -16
  546. package/types/server/systemPageDocument.d.ts +8 -0
  547. package/types/server/systemPages.d.ts +2 -3
  548. package/types/server/tunnel/TunnelAgent.d.ts +2 -6
  549. package/types/server/tunnel/TunnelDataSocket.d.ts +1 -4
  550. package/types/server/tunnel/TunnelTcpStream.d.ts +1 -4
  551. package/types/server/tunnel/tunnelStream.d.ts +1 -12
  552. package/types/server/types.d.ts +2 -9
  553. package/types/server/webRouter.d.ts +2 -19
  554. package/types/service/agent.service.d.ts +7 -77
  555. package/types/service/injectInfo.d.ts +0 -1
  556. package/types/service/liveSyncHub.d.ts +4 -22
  557. package/types/service/predefinedAdaptor/anthropicLlm.d.ts +6 -43
  558. package/types/service/predefinedAdaptor/cache.adaptor.d.ts +1 -5
  559. package/types/service/predefinedAdaptor/database.adaptor.d.ts +5 -18
  560. package/types/service/predefinedAdaptor/documentTransfer.d.ts +2 -4
  561. package/types/service/predefinedAdaptor/insightQuery.d.ts +5 -30
  562. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +26 -86
  563. package/types/service/predefinedAdaptor/llmOverflow.d.ts +3 -13
  564. package/types/service/predefinedAdaptor/openaiDialect.d.ts +4 -34
  565. package/types/service/predefinedAdaptor/openaiLlm.d.ts +3 -19
  566. package/types/service/predefinedAdaptor/searchIndex.d.ts +7 -24
  567. package/types/service/predefinedAdaptor/solidSqlite.d.ts +1 -1
  568. package/types/service/predefinedAdaptor/sql/PostgresInsightSession.d.ts +3 -6
  569. package/types/service/predefinedAdaptor/sql/QueryCompiler.d.ts +2 -8
  570. package/types/service/predefinedAdaptor/sql/SqlDocumentStore.d.ts +4 -27
  571. package/types/service/predefinedAdaptor/sql/SqliteInsightSession.d.ts +3 -7
  572. package/types/service/predefinedAdaptor/sql/UpdateCompiler.d.ts +0 -4
  573. package/types/service/predefinedAdaptor/sql/dialect/postgres.d.ts +2 -4
  574. package/types/service/predefinedAdaptor/sql/driver/bunSqlite.d.ts +2 -2
  575. package/types/service/predefinedAdaptor/sql/driver/libsql.d.ts +0 -1
  576. package/types/service/predefinedAdaptor/sql/search/fts5.d.ts +1 -6
  577. package/types/service/predefinedAdaptor/sql/search/postgres.d.ts +4 -5
  578. package/types/service/predefinedAdaptor/sql/search/types.d.ts +3 -7
  579. package/types/service/predefinedAdaptor/sql/types.d.ts +4 -8
  580. package/types/service/predefinedAdaptor/sql/values.d.ts +5 -0
  581. package/types/service/predefinedAdaptor/sqlitePath.d.ts +1 -0
  582. package/types/service/predefinedAdaptor/sseData.d.ts +1 -0
  583. package/types/service/predefinedAdaptor/storage.adaptor.d.ts +1 -5
  584. package/types/service/predefinedAdaptor/websocket.adaptor.d.ts +3 -19
  585. package/types/service/serviceModule.d.ts +7 -7
  586. package/types/service/toolNames.d.ts +4 -21
  587. package/types/service/types.d.ts +3 -3
  588. package/types/signal/CrossSiteGuard.d.ts +3 -28
  589. package/types/signal/SignalFailure.d.ts +1 -15
  590. package/types/signal/agent/AgentCatalogue.d.ts +8 -54
  591. package/types/signal/agentMeter.d.ts +1 -5
  592. package/types/signal/agentTurnStream.d.ts +1 -9
  593. package/types/signal/endpoint.d.ts +0 -1
  594. package/types/signal/endpointCache.d.ts +0 -14
  595. package/types/signal/endpointInfo.d.ts +1 -9
  596. package/types/signal/exception.d.ts +1 -34
  597. package/types/signal/guard.d.ts +4 -16
  598. package/types/signal/guards.d.ts +2 -10
  599. package/types/signal/internal.d.ts +1 -5
  600. package/types/signal/internalArg.d.ts +4 -14
  601. package/types/signal/mcp/McpDocument.d.ts +5 -45
  602. package/types/signal/mcp/McpProgress.d.ts +6 -19
  603. package/types/signal/mcp/McpUriTemplate.d.ts +1 -19
  604. package/types/signal/mcp/Msg.d.ts +13 -70
  605. package/types/signal/mcp/mcpProtocol.d.ts +1 -26
  606. package/types/signal/mcp/pagePrompt.d.ts +3 -9
  607. package/types/signal/middleware.d.ts +0 -7
  608. package/types/signal/schema/JsonSchemaBuilder.d.ts +9 -46
  609. package/types/signal/serializer/fetch.serializer.d.ts +1 -6
  610. package/types/signal/serverSignal.d.ts +0 -1
  611. package/types/signal/signalContext.d.ts +14 -61
  612. package/types/signal/signalRegistry.d.ts +0 -1
  613. package/types/signal/slice.d.ts +3 -9
  614. package/types/signal/sliceInfo.d.ts +5 -30
  615. package/types/signal/trace.d.ts +2 -30
  616. package/types/signal/types.d.ts +21 -80
  617. package/types/store/SliceRequest.d.ts +1 -11
  618. package/types/store/action.d.ts +2 -6
  619. package/types/store/actionTag.d.ts +1 -10
  620. package/types/store/agent/AgentBridge.d.ts +3 -22
  621. package/types/store/agent/AgentContext.d.ts +1 -7
  622. package/types/store/agent/AgentCursor.d.ts +5 -29
  623. package/types/store/agent/AgentPrompts.d.ts +0 -5
  624. package/types/store/agent/AgentVisual.d.ts +5 -34
  625. package/types/store/agent/ScreenFlash.d.ts +7 -39
  626. package/types/store/agent/ScreenReader.d.ts +3 -26
  627. package/types/store/agent/ScreenSettle.d.ts +1 -12
  628. package/types/store/agent/ScreenTarget.d.ts +1 -28
  629. package/types/store/agent/StoreCatalogue.d.ts +12 -16
  630. package/types/store/agent/StoreSurfaceSource.d.ts +11 -19
  631. package/types/store/agent/index.d.ts +0 -2
  632. package/types/store/agentic/AgentValue.d.ts +3 -23
  633. package/types/store/agentic/StExposeBuilder.d.ts +2 -11
  634. package/types/store/agentic/StExposeDraft.d.ts +0 -6
  635. package/types/store/agentic/StStateBuilder.d.ts +1 -7
  636. package/types/store/agentic/StStateDraft.d.ts +0 -5
  637. package/types/store/agentic/StToolBuilder.d.ts +8 -53
  638. package/types/store/agentic/StToolDraft.d.ts +0 -7
  639. package/types/store/agentic/attachAgentic.d.ts +2 -11
  640. package/types/store/agentic/formFields.d.ts +5 -41
  641. package/types/store/agentic/index.d.ts +0 -1
  642. package/types/store/agentic/useAgentReference.d.ts +2 -20
  643. package/types/store/agentic/useFieldTool.d.ts +19 -16
  644. package/types/store/agentic/useFormTools.d.ts +1 -18
  645. package/types/store/agentic/useRelationFieldTool.d.ts +1 -14
  646. package/types/store/databaseStateNames.d.ts +0 -9
  647. package/types/store/draftStore.d.ts +4 -30
  648. package/types/store/formSetterNames.d.ts +0 -19
  649. package/types/store/liveInsert.d.ts +0 -23
  650. package/types/store/sliceKeys.d.ts +31 -0
  651. package/types/store/sliceRole.d.ts +1 -10
  652. package/types/store/state.d.ts +2 -9
  653. package/types/store/stateBuilder.d.ts +0 -14
  654. package/types/store/storeInstance.d.ts +6 -20
  655. package/types/store/storeRegistry.d.ts +0 -2
  656. package/types/test/conformance.d.ts +7 -21
  657. package/types/test/index.d.ts +1 -2
  658. package/types/test/sampleOf.d.ts +16 -1
  659. package/types/ui/Agent/Attach.d.ts +1 -1
  660. package/types/ui/Agent/Bubble.d.ts +3 -14
  661. package/types/ui/Agent/Chat.d.ts +25 -91
  662. package/types/ui/Agent/ChatCommands.d.ts +4 -14
  663. package/types/ui/Agent/Composer.d.ts +6 -16
  664. package/types/ui/Agent/Dock.d.ts +38 -10
  665. package/types/ui/Agent/Guide.d.ts +1 -5
  666. package/types/ui/Agent/History.d.ts +1 -18
  667. package/types/ui/Agent/Launcher.d.ts +2 -2
  668. package/types/ui/Agent/Markdown.d.ts +2 -6
  669. package/types/ui/Agent/MentionNode.d.ts +0 -8
  670. package/types/ui/Agent/Menu.d.ts +2 -4
  671. package/types/ui/Agent/Question.d.ts +1 -6
  672. package/types/ui/Agent/Queued.d.ts +1 -6
  673. package/types/ui/Agent/Refer.d.ts +0 -4
  674. package/types/ui/Agent/RichInput.d.ts +1 -9
  675. package/types/ui/Agent/Skip.d.ts +3 -15
  676. package/types/ui/Agent/Steps.d.ts +5 -21
  677. package/types/ui/Agent/ToolCard.d.ts +1 -8
  678. package/types/ui/Agent/Zone.d.ts +10 -36
  679. package/types/ui/Agent/agentSessionOf.d.ts +18 -17
  680. package/types/ui/Agent/attachment.d.ts +4 -38
  681. package/types/ui/Agent/fetchRunner.d.ts +1 -8
  682. package/types/ui/Agent/index.d.ts +1 -5
  683. package/types/ui/Agent/mentionDraft.d.ts +0 -10
  684. package/types/ui/Agent/tokenCount.d.ts +1 -5
  685. package/types/ui/Agent/useChatAttachments.d.ts +0 -5
  686. package/types/ui/Agent/useChatQueue.d.ts +1 -14
  687. package/types/ui/Agent/useChatReferences.d.ts +0 -12
  688. package/types/ui/Agent/useChatVoice.d.ts +0 -12
  689. package/types/ui/Agent/useDraftRecall.d.ts +0 -8
  690. package/types/ui/Agent/useKeyboardInset.d.ts +0 -7
  691. package/types/ui/Agent/useReferenceMenu.d.ts +3 -11
  692. package/types/ui/Agent/useSlashMenu.d.ts +0 -2
  693. package/types/ui/Agent/voice.d.ts +8 -42
  694. package/types/ui/Badge.d.ts +0 -1
  695. package/types/ui/BottomSheet.d.ts +2 -5
  696. package/types/ui/Button.d.ts +5 -22
  697. package/types/ui/ClientSide.d.ts +0 -2
  698. package/types/ui/Constant/schemaGraph.d.ts +0 -4
  699. package/types/ui/Copy.d.ts +2 -3
  700. package/types/ui/Data/Dashboard.d.ts +1 -4
  701. package/types/ui/Data/ListContainer.d.ts +1 -10
  702. package/types/ui/Data/Pagination.d.ts +0 -2
  703. package/types/ui/Data/QueryMaker.d.ts +0 -7
  704. package/types/ui/Data/RefPicker.d.ts +0 -7
  705. package/types/ui/DatePicker.d.ts +0 -11
  706. package/types/ui/Dialog/LegacyModal.d.ts +1 -4
  707. package/types/ui/Dialog/Provider.d.ts +37 -4
  708. package/types/ui/Dialog/index.d.ts +4 -4
  709. package/types/ui/Dropdown.d.ts +1 -9
  710. package/types/ui/Empty.d.ts +3 -10
  711. package/types/ui/Field/Collection.d.ts +1 -16
  712. package/types/ui/Field/Relation.d.ts +10 -37
  713. package/types/ui/Field/Text.d.ts +9 -66
  714. package/types/ui/Field/index.d.ts +0 -9
  715. package/types/ui/Field/lightRefCache.d.ts +0 -8
  716. package/types/ui/Field/useRelationOptions.d.ts +1 -12
  717. package/types/ui/Image.d.ts +8 -12
  718. package/types/ui/InfiniteScroll.d.ts +2 -6
  719. package/types/ui/Input.d.ts +8 -15
  720. package/types/ui/Layout/Role.d.ts +23 -0
  721. package/types/ui/Layout/Sider.d.ts +21 -0
  722. package/types/ui/Layout/TopInset.d.ts +5 -0
  723. package/types/ui/Layout/index.d.ts +7 -7
  724. package/types/ui/LegacyModal.d.ts +1 -12
  725. package/types/ui/Link/Action.d.ts +11 -0
  726. package/types/ui/Link/Anchor.d.ts +20 -0
  727. package/types/ui/Link/index.d.ts +4 -7
  728. package/types/ui/Load/Edit_Client.d.ts +1 -1
  729. package/types/ui/Load/Page.d.ts +3 -5
  730. package/types/ui/Load/Stream.d.ts +0 -12
  731. package/types/ui/Load/Units.d.ts +1 -1
  732. package/types/ui/Load/View.d.ts +2 -7
  733. package/types/ui/Loading/ProgressBar.d.ts +0 -4
  734. package/types/ui/Loading/Skeleton.d.ts +2 -0
  735. package/types/ui/Loading/Spin.d.ts +8 -14
  736. package/types/ui/Loading/index.d.ts +3 -8
  737. package/types/ui/Loading/index_.d.ts +3 -10
  738. package/types/ui/Menu.d.ts +0 -5
  739. package/types/ui/Modal.d.ts +0 -17
  740. package/types/ui/Model/AdminPanel.d.ts +1 -4
  741. package/types/ui/Model/DraftBar.d.ts +2 -7
  742. package/types/ui/Model/EditModal.d.ts +7 -22
  743. package/types/ui/Model/LoadStore.d.ts +18 -0
  744. package/types/ui/Model/Remove.d.ts +0 -2
  745. package/types/ui/Model/SureToRemove.d.ts +0 -3
  746. package/types/ui/Model/ViewEditModal.d.ts +0 -2
  747. package/types/ui/Model/draftScope.d.ts +0 -7
  748. package/types/ui/Model/index.d.ts +2 -2
  749. package/types/ui/Model/index_.d.ts +2 -2
  750. package/types/ui/Pagination.d.ts +4 -12
  751. package/types/ui/Popconfirm.d.ts +3 -17
  752. package/types/ui/Radio.d.ts +0 -4
  753. package/types/ui/RecentTime.d.ts +5 -9
  754. package/types/ui/Reference/Panel.d.ts +44 -6
  755. package/types/ui/Reference/Segmented.d.ts +0 -3
  756. package/types/ui/Reference/{style.d.ts → docUi.d.ts} +6 -2
  757. package/types/ui/Reference/index.d.ts +3 -7
  758. package/types/ui/Refresh.d.ts +1 -1
  759. package/types/ui/ScreenNavigator.d.ts +2 -2
  760. package/types/ui/Select.d.ts +3 -20
  761. package/types/ui/Signal/Endpoint.d.ts +43 -0
  762. package/types/ui/Signal/WebSocket.d.ts +23 -0
  763. package/types/ui/Signal/endpointEntries.d.ts +2 -4
  764. package/types/ui/Signal/index.d.ts +1 -3
  765. package/types/ui/Signal/style.d.ts +1 -2
  766. package/types/ui/Switch.d.ts +1 -5
  767. package/types/ui/System/Client.d.ts +0 -3
  768. package/types/ui/System/Common.d.ts +11 -20
  769. package/types/ui/System/Root.d.ts +1 -4
  770. package/types/ui/System/ThemeToggle.d.ts +1 -0
  771. package/types/ui/System/index.d.ts +1 -0
  772. package/types/ui/Tab/Provider.d.ts +24 -4
  773. package/types/ui/Tab/index.d.ts +3 -3
  774. package/types/ui/Table.d.ts +7 -23
  775. package/types/ui/Toast.d.ts +9 -16
  776. package/types/ui/ToggleSelect.d.ts +0 -5
  777. package/types/ui/Tooltip.d.ts +1 -2
  778. package/types/ui/UiOverride/{context.d.ts → UiOverride.d.ts} +20 -40
  779. package/types/ui/UiOverride/index.d.ts +2 -5
  780. package/types/ui/UiOverride/override.d.ts +2 -18
  781. package/types/ui/Unauthorized.d.ts +0 -6
  782. package/types/ui/agentAttrs.d.ts +2 -14
  783. package/types/ui/index.d.ts +1 -3
  784. package/types/ui/overlayLayer.d.ts +4 -24
  785. package/types/ui/overlayPosition.d.ts +0 -12
  786. package/types/ui/recipe/factory.d.ts +1 -21
  787. package/types/ui/recipe/index.d.ts +0 -14
  788. package/types/ui/sliceNamesOf.d.ts +78 -0
  789. package/types/ui/triggerSlot.d.ts +2 -12
  790. package/types/webkit/RenderLayer.d.ts +11 -0
  791. package/types/webkit/index.d.ts +1 -2
  792. package/types/webkit/lazy.d.ts +3 -12
  793. package/types/webkit/{createRobotPage.d.ts → seoPages.d.ts} +4 -0
  794. package/types/webkit/useBodyScrollLock.d.ts +0 -1
  795. package/types/webkit/useCamera.d.ts +1 -1
  796. package/types/webkit/useContact.d.ts +1 -1
  797. package/types/webkit/useDebounce.d.ts +0 -1
  798. package/types/webkit/useEscapeKey.d.ts +1 -4
  799. package/types/webkit/useFetch.d.ts +1 -6
  800. package/types/webkit/useFrameRuntime.d.ts +1 -1
  801. package/types/webkit/useGeoLocation.d.ts +1 -1
  802. package/types/webkit/usePageTool.d.ts +2 -9
  803. package/types/webkit/usePurchase.d.ts +1 -4
  804. package/types/webkit/useScreenScope.d.ts +2 -13
  805. package/ui/Agent/Attach.tsx +2 -2
  806. package/ui/Agent/Bubble.tsx +3 -31
  807. package/ui/Agent/Chat.tsx +31 -114
  808. package/ui/Agent/ChatCommands.ts +5 -21
  809. package/ui/Agent/Composer.tsx +32 -19
  810. package/ui/Agent/Dock.tsx +176 -16
  811. package/ui/Agent/Guide.tsx +1 -5
  812. package/ui/Agent/History.tsx +1 -18
  813. package/ui/Agent/Launcher.tsx +2 -2
  814. package/ui/Agent/Markdown.tsx +40 -14
  815. package/ui/Agent/MentionNode.ts +0 -8
  816. package/ui/Agent/Menu.tsx +2 -4
  817. package/ui/Agent/Question.tsx +1 -6
  818. package/ui/Agent/Queued.tsx +1 -6
  819. package/ui/Agent/Refer.tsx +1 -5
  820. package/ui/Agent/RichInput.tsx +4 -12
  821. package/ui/Agent/Skip.tsx +3 -15
  822. package/ui/Agent/Steps.tsx +6 -22
  823. package/ui/Agent/ToolCard.tsx +1 -8
  824. package/ui/Agent/Zone.tsx +11 -38
  825. package/ui/Agent/agentSessionOf.ts +111 -16
  826. package/ui/Agent/attachment.ts +5 -42
  827. package/ui/Agent/fetchRunner.ts +1 -14
  828. package/ui/Agent/index.ts +1 -6
  829. package/ui/Agent/mentionDraft.ts +2 -12
  830. package/ui/Agent/tokenCount.ts +1 -5
  831. package/ui/Agent/useChatAttachments.ts +2 -9
  832. package/ui/Agent/useChatQueue.ts +3 -15
  833. package/ui/Agent/useChatReferences.ts +1 -14
  834. package/ui/Agent/useChatVoice.ts +2 -23
  835. package/ui/Agent/useDraftRecall.ts +0 -9
  836. package/ui/Agent/useKeyboardInset.ts +0 -7
  837. package/ui/Agent/useReferenceMenu.ts +4 -19
  838. package/ui/Agent/useSlashMenu.ts +0 -3
  839. package/ui/Agent/voice.ts +8 -43
  840. package/ui/Badge.tsx +0 -2
  841. package/ui/BottomSheet.tsx +2 -5
  842. package/ui/Button.tsx +8 -44
  843. package/ui/ClientSide.tsx +0 -2
  844. package/ui/Clipboard.tsx +0 -1
  845. package/ui/Constant/Doc.tsx +182 -217
  846. package/ui/Constant/schemaGraph.ts +0 -9
  847. package/ui/Copy.tsx +2 -3
  848. package/ui/CsrImage.tsx +0 -4
  849. package/ui/Data/CardList.tsx +2 -17
  850. package/ui/Data/Dashboard.tsx +2 -5
  851. package/ui/Data/Item.tsx +1 -2
  852. package/ui/Data/ListContainer.tsx +15 -61
  853. package/ui/Data/Pagination.tsx +3 -22
  854. package/ui/Data/QueryMaker.tsx +1 -8
  855. package/ui/Data/RefPicker.tsx +1 -8
  856. package/ui/Data/TableList.tsx +2 -15
  857. package/ui/DatePicker.tsx +1 -12
  858. package/ui/Dialog/LegacyModal.tsx +3 -7
  859. package/ui/Dialog/Modal.tsx +3 -4
  860. package/ui/Dialog/Provider.tsx +85 -7
  861. package/ui/Dialog/index.tsx +1 -5
  862. package/ui/DraggableList.tsx +1 -4
  863. package/ui/Dropdown.tsx +4 -17
  864. package/ui/Empty.tsx +4 -12
  865. package/ui/Field/Collection.tsx +6 -29
  866. package/ui/Field/DateField.tsx +2 -7
  867. package/ui/Field/Label.tsx +0 -1
  868. package/ui/Field/NumberField.tsx +0 -1
  869. package/ui/Field/Relation.tsx +13 -53
  870. package/ui/Field/Text.tsx +25 -86
  871. package/ui/Field/index.tsx +0 -9
  872. package/ui/Field/lightRefCache.ts +1 -13
  873. package/ui/Field/useRelationOptions.ts +4 -13
  874. package/ui/Image.tsx +26 -55
  875. package/ui/InfiniteScroll.tsx +3 -21
  876. package/ui/Input.tsx +82 -174
  877. package/ui/Layout/Role.tsx +42 -0
  878. package/ui/Layout/Sider.tsx +82 -1
  879. package/ui/Layout/TopInset.tsx +23 -1
  880. package/ui/Layout/index.ts +3 -9
  881. package/ui/LegacyModal.tsx +1 -12
  882. package/ui/Link/Action.tsx +29 -0
  883. package/ui/Link/Anchor.tsx +118 -0
  884. package/ui/Link/index.tsx +7 -8
  885. package/ui/Load/Edit_Client.tsx +2 -37
  886. package/ui/Load/Page.tsx +3 -6
  887. package/ui/Load/Pagination.tsx +4 -19
  888. package/ui/Load/Stream.tsx +0 -12
  889. package/ui/Load/Units.tsx +13 -86
  890. package/ui/Load/View.tsx +4 -21
  891. package/ui/Loading/ProgressBar.tsx +0 -4
  892. package/ui/Loading/Skeleton.tsx +14 -0
  893. package/ui/Loading/Spin.tsx +24 -15
  894. package/ui/Loading/index.ts +0 -5
  895. package/ui/Loading/index_.tsx +2 -12
  896. package/ui/Menu.tsx +3 -21
  897. package/ui/Modal.tsx +0 -17
  898. package/ui/Model/AdminPanel.tsx +2 -5
  899. package/ui/Model/DraftBar.tsx +3 -14
  900. package/ui/Model/EditModal.tsx +11 -48
  901. package/ui/Model/EditWrapper.tsx +2 -3
  902. package/ui/Model/LoadStore.tsx +18 -0
  903. package/ui/Model/NewWrapper_Client.tsx +1 -1
  904. package/ui/Model/Remove.tsx +4 -12
  905. package/ui/Model/RemoveWrapper.tsx +2 -3
  906. package/ui/Model/SureToRemove.tsx +4 -13
  907. package/ui/Model/ViewEditModal.tsx +0 -6
  908. package/ui/Model/ViewModal.tsx +1 -5
  909. package/ui/Model/ViewWrapper.tsx +1 -2
  910. package/ui/Model/draftScope.ts +0 -7
  911. package/ui/Model/index_.tsx +2 -22
  912. package/ui/Pagination.tsx +4 -12
  913. package/ui/Popconfirm.tsx +3 -18
  914. package/ui/Radio.tsx +1 -5
  915. package/ui/RecentTime.tsx +19 -31
  916. package/ui/Reference/Panel.tsx +102 -6
  917. package/ui/Reference/Segmented.tsx +5 -11
  918. package/ui/Reference/{style.ts → docUi.ts} +10 -2
  919. package/ui/Reference/index.ts +3 -7
  920. package/ui/Refresh.tsx +80 -12
  921. package/ui/ScreenNavigator.tsx +2 -9
  922. package/ui/Select.tsx +7 -25
  923. package/ui/Signal/Endpoint.tsx +154 -0
  924. package/ui/Signal/Listener.tsx +1 -4
  925. package/ui/Signal/Object.tsx +67 -73
  926. package/ui/Signal/RestApi.tsx +30 -76
  927. package/ui/Signal/WebSocket.tsx +253 -2
  928. package/ui/Signal/endpointEntries.ts +3 -5
  929. package/ui/Signal/index.ts +1 -3
  930. package/ui/Signal/style.ts +1 -2
  931. package/ui/Switch.tsx +1 -5
  932. package/ui/System/CSR.tsx +28 -100
  933. package/ui/System/Client.tsx +4 -13
  934. package/ui/System/Common.tsx +31 -20
  935. package/ui/System/Messages.tsx +2 -2
  936. package/ui/System/Reconnect.tsx +1 -6
  937. package/ui/System/Root.tsx +1 -4
  938. package/ui/System/SSR.tsx +1 -2
  939. package/ui/System/ThemeToggle.tsx +15 -0
  940. package/ui/System/index.tsx +2 -2
  941. package/ui/Tab/Provider.tsx +115 -7
  942. package/ui/Tab/index.tsx +1 -4
  943. package/ui/Table.tsx +7 -23
  944. package/ui/Toast.tsx +9 -16
  945. package/ui/ToggleSelect.tsx +10 -24
  946. package/ui/Tooltip.tsx +2 -8
  947. package/ui/UiOverride/{context.ts → UiOverride.tsx} +50 -42
  948. package/ui/UiOverride/index.ts +9 -6
  949. package/ui/UiOverride/override.ts +2 -18
  950. package/ui/Unauthorized.tsx +1 -8
  951. package/ui/agentAttrs.ts +2 -14
  952. package/ui/index.ts +7 -4
  953. package/ui/overlayLayer.ts +4 -25
  954. package/ui/overlayPosition.ts +2 -14
  955. package/ui/recipe/badgeRecipe.ts +1 -1
  956. package/ui/recipe/buttonRecipe.ts +4 -4
  957. package/ui/recipe/factory.ts +1 -22
  958. package/ui/recipe/index.ts +1 -14
  959. package/ui/recipe/inputRecipe.ts +1 -1
  960. package/ui/sliceNamesOf.ts +26 -0
  961. package/ui/triggerSlot.tsx +2 -12
  962. package/vendor/use-agentic/index.ts +0 -1
  963. package/webkit/RenderLayer.tsx +45 -0
  964. package/webkit/bootCsr.tsx +4 -45
  965. package/webkit/index.ts +1 -2
  966. package/webkit/lazy.tsx +3 -13
  967. package/webkit/{createRobotPage.ts → seoPages.ts} +5 -0
  968. package/webkit/useBodyScrollLock.tsx +0 -6
  969. package/webkit/useCamera.tsx +6 -25
  970. package/webkit/useCodepush.tsx +8 -31
  971. package/webkit/useContact.tsx +1 -8
  972. package/webkit/useCsrValues.ts +201 -426
  973. package/webkit/useDebounce.ts +0 -3
  974. package/webkit/useEscapeKey.tsx +1 -12
  975. package/webkit/useFetch.ts +1 -6
  976. package/webkit/useFrameRuntime.ts +5 -43
  977. package/webkit/useGeoLocation.tsx +1 -1
  978. package/webkit/useLocation.ts +5 -8
  979. package/webkit/usePageTool.tsx +2 -9
  980. package/webkit/usePurchase.tsx +17 -33
  981. package/webkit/useScreenScope.tsx +2 -13
  982. package/client/fetch.ts +0 -1
  983. package/client/frameDebug.ts +0 -29
  984. package/common/deepObjectify.ts +0 -42
  985. package/common/dynamicRecord.ts +0 -12
  986. package/common/formatPhone.ts +0 -7
  987. package/common/getAllPropertyDescriptors.ts +0 -13
  988. package/common/lowerlize.ts +0 -4
  989. package/common/mergeVersion.ts +0 -10
  990. package/common/pathGet.ts +0 -23
  991. package/common/pathGetLoose.ts +0 -31
  992. package/common/pathSet.ts +0 -27
  993. package/common/plainFieldsOf.ts +0 -13
  994. package/common/randomPicks.ts +0 -12
  995. package/common/toPathSegments.ts +0 -10
  996. package/common/websocketAuth.ts +0 -24
  997. package/common/websocketHeartbeat.ts +0 -27
  998. package/constant/deserialize.ts +0 -98
  999. package/dictionary/agentTurn.dictionary.ts +0 -33
  1000. package/document/schema.ts +0 -24
  1001. package/fetch/fetchType/clientSignal.type.ts +0 -22
  1002. package/local/apps/akan/akan-local.db +0 -0
  1003. package/local/apps/akan/akan-local.db-shm +0 -0
  1004. package/local/apps/akan/akan-local.db-wal +0 -0
  1005. package/local/apps/akan/akan-local_solid.db +0 -0
  1006. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  1007. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  1008. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0001.log +0 -44
  1009. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0002.log +0 -42
  1010. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0003.log +0 -43
  1011. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0004.log +0 -44
  1012. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0005.log +0 -50
  1013. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0006.log +0 -46
  1014. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0007.log +0 -46
  1015. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0008.log +0 -47
  1016. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0009.log +0 -47
  1017. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0010.log +0 -6
  1018. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0011.log +0 -14
  1019. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0012.log +0 -6
  1020. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0013.log +0 -35
  1021. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0014.log +0 -46
  1022. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0015.log +0 -46
  1023. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0016.log +0 -47
  1024. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0017.log +0 -47
  1025. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0018.log +0 -46
  1026. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0019.log +0 -46
  1027. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0020.log +0 -47
  1028. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0021.log +0 -47
  1029. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0022.log +0 -46
  1030. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0023.log +0 -46
  1031. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0024.log +0 -46
  1032. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0025.log +0 -46
  1033. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0026.log +0 -46
  1034. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0027.log +0 -46
  1035. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0028.log +0 -46
  1036. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0029.log +0 -46
  1037. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0030.log +0 -46
  1038. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0031.log +0 -46
  1039. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0032.log +0 -46
  1040. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0033.log +0 -46
  1041. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0034.log +0 -46
  1042. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0035.log +0 -46
  1043. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0036.log +0 -46
  1044. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0037.log +0 -46
  1045. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0038.log +0 -46
  1046. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0039.log +0 -46
  1047. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0040.log +0 -46
  1048. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0041.log +0 -46
  1049. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0042.log +0 -46
  1050. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0043.log +0 -46
  1051. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0044.log +0 -46
  1052. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0045.log +0 -46
  1053. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0046.log +0 -46
  1054. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0047.log +0 -46
  1055. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0048.log +0 -46
  1056. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0049.log +0 -46
  1057. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0050.log +0 -46
  1058. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0051.log +0 -46
  1059. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0052.log +0 -46
  1060. package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0053.log +0 -46
  1061. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  1062. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  1063. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  1064. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  1065. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  1066. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  1067. package/server/artifact/manifestTypes.ts +0 -19
  1068. package/server/assetEncoding.ts +0 -27
  1069. package/server/consoleEvaluator.ts +0 -51
  1070. package/server/di/index.ts +0 -4
  1071. package/server/di/resolveAdaptorHierarchy.ts +0 -91
  1072. package/server/di/resolveServiceHierarchy.ts +0 -47
  1073. package/server/hmr/changeBatch.ts +0 -14
  1074. package/server/hmr/index.ts +0 -4
  1075. package/server/proxy/akanResponse.ts +0 -16
  1076. package/server/proxy/bunRequestFields.ts +0 -12
  1077. package/server/rscPartialCommit.ts +0 -3
  1078. package/server/rscPatchSafety.ts +0 -57
  1079. package/server/rscWorkerReplay.ts +0 -49
  1080. package/server/subRouteIndexDocument.tsx +0 -61
  1081. package/service/predefinedAdaptor/sqlDescriptor.ts +0 -25
  1082. package/store/agent/storeSurface.ts +0 -28
  1083. package/store/agent/types.ts +0 -16
  1084. package/store/agentic/useFileFieldTool.ts +0 -221
  1085. package/store/stateInfo.ts +0 -66
  1086. package/test/playwright.config.base.ts +0 -48
  1087. package/test/playwright.pageAgent.ts +0 -41
  1088. package/test/sample.ts +0 -19
  1089. package/types/client/fetch.d.ts +0 -1
  1090. package/types/client/frameDebug.d.ts +0 -3
  1091. package/types/common/deepObjectify.d.ts +0 -6
  1092. package/types/common/dynamicRecord.d.ts +0 -14
  1093. package/types/common/formatPhone.d.ts +0 -2
  1094. package/types/common/getAllPropertyDescriptors.d.ts +0 -5
  1095. package/types/common/isPhoneNumber.d.ts +0 -2
  1096. package/types/common/lowerlize.d.ts +0 -2
  1097. package/types/common/mergeVersion.d.ts +0 -10
  1098. package/types/common/pathGet.d.ts +0 -1
  1099. package/types/common/pathGetLoose.d.ts +0 -8
  1100. package/types/common/pathSet.d.ts +0 -3
  1101. package/types/common/plainFieldsOf.d.ts +0 -6
  1102. package/types/common/randomPicks.d.ts +0 -1
  1103. package/types/common/splitVersion.d.ts +0 -11
  1104. package/types/common/toPathSegments.d.ts +0 -9
  1105. package/types/common/websocketAuth.d.ts +0 -19
  1106. package/types/common/websocketBinaryFrame.d.ts +0 -17
  1107. package/types/common/websocketHeartbeat.d.ts +0 -25
  1108. package/types/constant/deserialize.d.ts +0 -10
  1109. package/types/dictionary/agentTurn.dictionary.d.ts +0 -1
  1110. package/types/document/schema.d.ts +0 -5
  1111. package/types/fetch/fetchType/clientSignal.type.d.ts +0 -16
  1112. package/types/server/artifact/manifestTypes.d.ts +0 -16
  1113. package/types/server/assetEncoding.d.ts +0 -7
  1114. package/types/server/consoleEvaluator.d.ts +0 -2
  1115. package/types/server/di/index.d.ts +0 -4
  1116. package/types/server/di/resolveAdaptorHierarchy.d.ts +0 -21
  1117. package/types/server/di/resolveServiceHierarchy.d.ts +0 -13
  1118. package/types/server/di.d.ts +0 -1
  1119. package/types/server/hmr/changeBatch.d.ts +0 -13
  1120. package/types/server/hmr/index.d.ts +0 -4
  1121. package/types/server/hmr.d.ts +0 -1
  1122. package/types/server/proxy/akanResponse.d.ts +0 -7
  1123. package/types/server/proxy/bunRequestFields.d.ts +0 -1
  1124. package/types/server/rscPartialCommit.d.ts +0 -1
  1125. package/types/server/rscPatchSafety.d.ts +0 -8
  1126. package/types/server/rscWorkerReplay.d.ts +0 -32
  1127. package/types/server/subRouteIndexDocument.d.ts +0 -8
  1128. package/types/service/predefinedAdaptor/sqlDescriptor.d.ts +0 -5
  1129. package/types/store/agent/storeSurface.d.ts +0 -14
  1130. package/types/store/agent/types.d.ts +0 -15
  1131. package/types/store/agentic/useFileFieldTool.d.ts +0 -41
  1132. package/types/store/stateInfo.d.ts +0 -23
  1133. package/types/test/playwright.config.base.d.ts +0 -9
  1134. package/types/test/playwright.pageAgent.d.ts +0 -12
  1135. package/types/test/sample.d.ts +0 -15
  1136. package/types/ui/Agent/Context.d.ts +0 -13
  1137. package/types/ui/Agent/Mic.d.ts +0 -8
  1138. package/types/ui/Agent/Section.d.ts +0 -10
  1139. package/types/ui/Agent/StateKey.d.ts +0 -16
  1140. package/types/ui/Agent/Tool.d.ts +0 -15
  1141. package/types/ui/Agent/Transcript.d.ts +0 -13
  1142. package/types/ui/Agent/markdownSpans.d.ts +0 -3
  1143. package/types/ui/Agent/sessionHistory.d.ts +0 -14
  1144. package/types/ui/Agent/sessionView.d.ts +0 -15
  1145. package/types/ui/Dialog/Action.d.ts +0 -5
  1146. package/types/ui/Dialog/Close.d.ts +0 -6
  1147. package/types/ui/Dialog/Content.d.ts +0 -6
  1148. package/types/ui/Dialog/Title.d.ts +0 -5
  1149. package/types/ui/Dialog/Trigger.d.ts +0 -6
  1150. package/types/ui/Dialog/context.d.ts +0 -18
  1151. package/types/ui/Layout/LeftSider.d.ts +0 -11
  1152. package/types/ui/Layout/RightSider.d.ts +0 -12
  1153. package/types/ui/Layout/Template.d.ts +0 -7
  1154. package/types/ui/Layout/TopLeftAction.d.ts +0 -6
  1155. package/types/ui/Layout/Unit.d.ts +0 -9
  1156. package/types/ui/Layout/View.d.ts +0 -8
  1157. package/types/ui/Layout/Zone.d.ts +0 -6
  1158. package/types/ui/Link/Back.d.ts +0 -7
  1159. package/types/ui/Link/Close.d.ts +0 -7
  1160. package/types/ui/Link/CsrLink.d.ts +0 -2
  1161. package/types/ui/Link/Lang.d.ts +0 -8
  1162. package/types/ui/Link/SsrLink.d.ts +0 -2
  1163. package/types/ui/Link/types.d.ts +0 -52
  1164. package/types/ui/Loading/Area.d.ts +0 -9
  1165. package/types/ui/Loading/Button.d.ts +0 -7
  1166. package/types/ui/Loading/Input.d.ts +0 -7
  1167. package/types/ui/Model/LoadInit.d.ts +0 -10
  1168. package/types/ui/Model/LoadView.d.ts +0 -10
  1169. package/types/ui/Reference/Collapse.d.ts +0 -11
  1170. package/types/ui/Reference/Summary.d.ts +0 -13
  1171. package/types/ui/Reference/Toolbar.d.ts +0 -21
  1172. package/types/ui/Reference/dictText.d.ts +0 -6
  1173. package/types/ui/Signal/Message.d.ts +0 -23
  1174. package/types/ui/Signal/PubSub.d.ts +0 -24
  1175. package/types/ui/Signal/Request.d.ts +0 -8
  1176. package/types/ui/System/DevModeToggle.d.ts +0 -1
  1177. package/types/ui/System/frameCssVars.d.ts +0 -5
  1178. package/types/ui/Tab/Menu.d.ts +0 -12
  1179. package/types/ui/Tab/Menus.d.ts +0 -6
  1180. package/types/ui/Tab/Panel.d.ts +0 -8
  1181. package/types/ui/Tab/context.d.ts +0 -11
  1182. package/types/ui/UiOverride/Provider.d.ts +0 -15
  1183. package/types/ui/UiOverride/createOverridable.d.ts +0 -9
  1184. package/types/ui/UiOverride/useUiOverride.d.ts +0 -7
  1185. package/types/ui/UiOverride/useUiRecipe.d.ts +0 -8
  1186. package/types/webkit/createSitemapPage.d.ts +0 -4
  1187. package/ui/Agent/Context.tsx +0 -49
  1188. package/ui/Agent/Mic.tsx +0 -27
  1189. package/ui/Agent/Section.tsx +0 -24
  1190. package/ui/Agent/StateKey.tsx +0 -46
  1191. package/ui/Agent/Tool.tsx +0 -59
  1192. package/ui/Agent/Transcript.tsx +0 -33
  1193. package/ui/Agent/markdownSpans.tsx +0 -39
  1194. package/ui/Agent/sessionHistory.ts +0 -88
  1195. package/ui/Agent/sessionView.ts +0 -38
  1196. package/ui/Dialog/Action.tsx +0 -15
  1197. package/ui/Dialog/Close.tsx +0 -18
  1198. package/ui/Dialog/Content.tsx +0 -11
  1199. package/ui/Dialog/Title.tsx +0 -15
  1200. package/ui/Dialog/Trigger.tsx +0 -18
  1201. package/ui/Dialog/context.ts +0 -32
  1202. package/ui/Layout/LeftSider.tsx +0 -43
  1203. package/ui/Layout/RightSider.tsx +0 -47
  1204. package/ui/Layout/Template.tsx +0 -11
  1205. package/ui/Layout/TopLeftAction.tsx +0 -28
  1206. package/ui/Layout/Unit.tsx +0 -19
  1207. package/ui/Layout/View.tsx +0 -12
  1208. package/ui/Layout/Zone.tsx +0 -10
  1209. package/ui/Link/Back.tsx +0 -15
  1210. package/ui/Link/Close.tsx +0 -20
  1211. package/ui/Link/CsrLink.tsx +0 -50
  1212. package/ui/Link/Lang.tsx +0 -16
  1213. package/ui/Link/SsrLink.tsx +0 -72
  1214. package/ui/Link/types.ts +0 -57
  1215. package/ui/Loading/Area.tsx +0 -27
  1216. package/ui/Loading/Button.tsx +0 -15
  1217. package/ui/Loading/Input.tsx +0 -15
  1218. package/ui/Model/LoadInit.tsx +0 -11
  1219. package/ui/Model/LoadView.tsx +0 -11
  1220. package/ui/Reference/Collapse.tsx +0 -26
  1221. package/ui/Reference/Summary.tsx +0 -25
  1222. package/ui/Reference/Toolbar.tsx +0 -44
  1223. package/ui/Reference/dictText.ts +0 -9
  1224. package/ui/Signal/Message.tsx +0 -215
  1225. package/ui/Signal/PubSub.tsx +0 -201
  1226. package/ui/Signal/Request.tsx +0 -11
  1227. package/ui/System/DevModeToggle.tsx +0 -19
  1228. package/ui/System/frameCssVars.ts +0 -25
  1229. package/ui/Tab/Menu.tsx +0 -70
  1230. package/ui/Tab/Menus.tsx +0 -13
  1231. package/ui/Tab/Panel.tsx +0 -25
  1232. package/ui/Tab/context.ts +0 -20
  1233. package/ui/UiOverride/Provider.tsx +0 -26
  1234. package/ui/UiOverride/createOverridable.tsx +0 -25
  1235. package/ui/UiOverride/useUiOverride.ts +0 -15
  1236. package/ui/UiOverride/useUiRecipe.ts +0 -15
  1237. package/webkit/createSitemapPage.ts +0 -4
@@ -107,16 +107,20 @@ export class EndpointInfo<
107
107
  this.returns = EndpointInfo.getReturnInfo(returnRef, signalOption);
108
108
  this.signalOption = signalOption;
109
109
  }
110
+ #addArg(type: ArgType, name: string, arg: ConstantFieldTypeInput, option?: EndpointArgProps<boolean>) {
111
+ if (this.execFn) throw new Error("Query function is already set");
112
+ if (type !== "body" && type !== "search" && this.args.at(-1)?.option?.nullable)
113
+ throw new Error("Last argument is nullable");
114
+ this.argNames.push(name);
115
+ this.args.push(EndpointInfo.getArgInfo(type, name, arg, option));
116
+ }
110
117
  param<
111
118
  ArgName extends string,
112
119
  Arg extends ParamFieldType,
113
120
  _ClientArg = FieldToValue<Arg>,
114
121
  _ServerArg = DocumentModel<_ClientArg>,
115
122
  >(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">) {
116
- if (this.execFn) throw new Error("Query function is already set");
117
- else if (this.args.at(-1)?.option?.nullable) throw new Error("Last argument is nullable");
118
- this.argNames.push(name);
119
- this.args.push(EndpointInfo.getArgInfo("param", name, arg, option));
123
+ this.#addArg("param", name, arg, option);
120
124
  return this as unknown as EndpointInfo<
121
125
  ReqType,
122
126
  Srvs,
@@ -139,9 +143,7 @@ export class EndpointInfo<
139
143
  _ClientArg = UploadableClientArg<PurifiedModel<_ArgType>>,
140
144
  _ServerArg = DocumentModel<_ArgType>,
141
145
  >(name: ArgName, arg: Arg, option?: EndpointArgProps<Optional>) {
142
- if (this.execFn) throw new Error("Query function is already set");
143
- this.argNames.push(name);
144
- this.args.push(EndpointInfo.getArgInfo("body", name, arg, option));
146
+ this.#addArg("body", name, arg, option);
145
147
  return this as unknown as EndpointInfo<
146
148
  ReqType,
147
149
  Srvs,
@@ -163,10 +165,7 @@ export class EndpointInfo<
163
165
  _ClientArg = PurifiedModel<_ArgType>,
164
166
  _ServerArg = DocumentModel<_ArgType>,
165
167
  >(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">) {
166
- if (this.execFn) throw new Error("Query function is already set");
167
- else if (this.args.at(-1)?.option?.nullable) throw new Error("Last argument is nullable");
168
- this.argNames.push(name);
169
- this.args.push(EndpointInfo.getArgInfo("room", name, arg, option));
168
+ this.#addArg("room", name, arg, option);
170
169
  return this as unknown as EndpointInfo<
171
170
  ReqType,
172
171
  Srvs,
@@ -189,10 +188,7 @@ export class EndpointInfo<
189
188
  _ClientArg = PurifiedModel<_ArgType>,
190
189
  _ServerArg = DocumentModel<_ArgType>,
191
190
  >(name: string, arg: Arg, option?: EndpointArgProps<Optional>) {
192
- if (this.execFn) throw new Error("Query function is already set");
193
- else if (this.args.at(-1)?.option?.nullable) throw new Error("Last argument is nullable");
194
- this.argNames.push(name);
195
- this.args.push(EndpointInfo.getArgInfo("msg", name, arg, option));
191
+ this.#addArg("msg", name, arg, option);
196
192
  return this as unknown as EndpointInfo<
197
193
  ReqType,
198
194
  Srvs,
@@ -214,9 +210,7 @@ export class EndpointInfo<
214
210
  _ClientArg = PurifiedModel<_ArgType>,
215
211
  _ServerArg = DocumentModel<_ArgType>,
216
212
  >(name: string, arg: Arg, option?: Omit<EndpointArgProps, "nullable">) {
217
- if (this.execFn) throw new Error("Query function is already set");
218
- this.argNames.push(name);
219
- this.args.push(EndpointInfo.getArgInfo("search", name, arg, { ...option, nullable: true }));
213
+ this.#addArg("search", name, arg, { ...option, nullable: true });
220
214
  return this as unknown as EndpointInfo<
221
215
  ReqType,
222
216
  Srvs,
@@ -274,15 +268,7 @@ export class EndpointInfo<
274
268
  Nullable
275
269
  >;
276
270
  }
277
- /**
278
- * Retypes a slice's own arguments as this room's arguments, keeping each one's nullability.
279
- *
280
- * Not `_addArgs`, which would route a `search` argument back to `.search()`. And not `.room()` per argument:
281
- * that refuses a nullable argument in anything but the last position, which is the right rule for a URL and a
282
- * meaningless one for a room — the arguments travel as a positional array with explicit nulls, so a missing one
283
- * is unambiguous. Nullability is preserved because dropping it would make an absent optional argument fail to
284
- * deserialize on the way in.
285
- */
271
+
286
272
  _addRoomArgs(args: ArgInfo<EndpointArgProps<boolean>>[]) {
287
273
  for (const arg of args) {
288
274
  this.argNames.push(arg.name);
@@ -1,31 +1,5 @@
1
- /**
2
- * The three ways this framework throws, and which one to reach for.
3
- *
4
- * - **`Exception`** (here) — a request-level answer with a status code. It travels to the caller as it is:
5
- * `{ error, statusCode, path, timestamp }`, with the message intact. Reach for it when the caller did
6
- * something the endpoint can name — a filter that does not exist, an argument that will not parse, a guard's
7
- * refusal. The message is read by whoever called, so it may not say anything the caller may not know.
8
- *
9
- * - **`Err`** (`akanjs/dictionary`, `new Err("<module>.error.<key>")`) — the same thing for a **domain** rule,
10
- * with the sentence in the module's dictionary in every language. Everything a *user* reads is one of these;
11
- * `Exception` carries English prose and belongs to the protocol rather than to the product.
12
- *
13
- * - **`Error`** — a bug, an invariant the code holds and something broke, or a misconfiguration a developer has
14
- * to fix. It never reaches a caller: `SignalFailure` generalizes anything without a status code to
15
- * `Internal Server Error` and logs the stack, because a stack names server paths and a driver message quotes
16
- * the statement. Most of the 379 `throw new Error` in this package are boot-time refusals, which is right —
17
- * nobody is holding the connection.
18
- *
19
- * The test for the first two is whether a caller can act on it. The test for the third is whether *this repo*
20
- * has to change for the throw to stop happening.
21
- */
22
- /**
23
- * The shape of every `Exception.<Status>` shorthand below.
24
- *
25
- * The annotation is not decoration: a `static X = class extends Exception {}` has to be serialized into the
26
- * `.d.ts` as a structural type, and that type contains `Exception`, whose statics contain it again — declaration
27
- * emit gives up with TS7056 and `akn build-package akanjs` fails. Naming the type breaks the cycle.
28
- */
1
+
2
+
29
3
  export interface StatusException {
30
4
  new (message?: string, details?: unknown): Exception;
31
5
  }
@@ -86,12 +60,7 @@ export class Exception extends Error {
86
60
  };
87
61
  }
88
62
 
89
- /**
90
- * What a transport forwards to the caller instead of generalizing: a status code and a payload the value can
91
- * write itself. An `Exception` is one; so is a dictionary `Err`; so is a failure `restoreRemoteError` rebuilt
92
- * from another process, which is what lets a server hop rethrow a remote `Err` and have it travel as that
93
- * `Err`. Anything else is this repo's own bug and becomes `SignalFailure`'s 500.
94
- */
63
+ /** Forwarded to the caller instead of generalized: an `Exception`, a dictionary `Err`, or a restored remote one. */
95
64
  export interface ExceptionLike {
96
65
  statusCode: number;
97
66
  toJSON: () => object;
package/signal/guard.ts CHANGED
@@ -6,33 +6,21 @@ export interface Guard {
6
6
  }
7
7
 
8
8
  /**
9
- * What a guard needs in order to answer. `account` reads the caller and nothing else, so it can be evaluated
10
- * with no arguments — which is what lets a catalogue hide what the caller certainly cannot use. `resource` needs
11
- * the call's arguments and fails closed without them, so evaluating one early would erase legitimate entries.
12
- *
13
- * `GuardCls` requires it on a hand-written guard class. Exposure is decided by a guard rather than by an opt-in, so
14
- * an unmarked guard would silently take the `resource` path and list its endpoint to every caller — the whole
15
- * guarded surface's names, refused only at call time. A class built with `guard(name)` starts as `account`, the
16
- * side that errs hidden: a subclass reading the call's arguments without overriding it drops out of every listing.
9
+ * `account` reads only the caller, so a listing may evaluate it with no arguments; `resource` needs the call's
10
+ * arguments and fails closed without them. Required on a hand-written guard: unmarked, every listing would show it.
17
11
  */
18
12
  export type GuardScope = "account" | "resource";
19
13
 
20
- /**
21
- * A guard that admits no model — one that refuses every MCP call and every call on an agent's token — says so with
22
- * `static agents = false`. The MCP catalogue then refuses every endpoint it guards outright, the way `mcp: false`
23
- * does, instead of publishing an entry that every agent would only ever be refused. Optional, unlike `scope`: the
24
- * default (agents may pass, subject to the verdict) is the one almost every guard means.
25
- */
14
+ /** `static agents = false` marks a guard that admits no model: the MCP catalogue refuses every endpoint it guards. */
26
15
  export type GuardCls<Name extends string = string> = Cls<
27
16
  Guard,
28
17
  { readonly name: Name; readonly scope: GuardScope; readonly agents?: boolean }
29
18
  >;
30
19
 
31
- /** Whether any guard in the list admits no agent at all — the fact the serializer stamps on an endpoint as `agents: false`. */
32
20
  export const refusesAgents = (guards: readonly GuardCls[] | undefined): boolean =>
33
21
  !!guards?.some((GuardCls) => GuardCls.agents === false);
34
22
 
35
- /** Creates a named guard base class for signal access checks. */
23
+ /** Starts as `scope = "account"`, the side that errs hidden. */
36
24
  export const guard = <T extends string>(name: T): GuardCls<T> => {
37
25
  return class Guard {
38
26
  static name = name;
@@ -43,12 +31,6 @@ export const guard = <T extends string>(name: T): GuardCls<T> => {
43
31
  };
44
32
  };
45
33
 
46
- /**
47
- * Guards read everything from the context they are handed and are already required to be side-effect free and
48
- * safe to re-run — `SignalResolver.revalidateWsRooms` re-runs them outside of any request — so one instance per
49
- * class serves every call instead of one per guard per request. Built on first use, not at registration: a guard
50
- * may be declared long before the container it reads from is up.
51
- */
52
34
  const instances = new WeakMap<GuardCls, Guard>();
53
35
  export const guardOf = (GuardCls: GuardCls): Guard => {
54
36
  const cached = instances.get(GuardCls);
package/signal/guards.ts CHANGED
@@ -19,12 +19,8 @@ export class None implements Guard {
19
19
  }
20
20
 
21
21
  /**
22
- * Gate for the `runAgentTurn` relay. Every tool runs in the caller's own browser session, so the LLM key is the
23
- * one thing this endpoint spends — ungated, any visitor can bill the app's provider through fetch alone.
24
- *
25
- * The framework has no account model to gate on, so with no guard registered it refuses every call — the same
26
- * answer `None` gives. An app names its own at boot, e.g. `AgentRelayAccess.use(Every)`, usually through
27
- * `option.setAgentAccess(...)`. Several are ANDed, as an endpoint's own `guards` array is.
22
+ * Gates the `runAgentTurn` relay, which spends the app's LLM key. Refuses every call until the app registers guards
23
+ * (`option.setAgentAccess(...)`); several are ANDed.
28
24
  */
29
25
  export class AgentRelayAccess implements Guard {
30
26
 
@@ -40,10 +36,6 @@ export class AgentRelayAccess implements Guard {
40
36
  return !!AgentRelayAccess.#guards.length;
41
37
  }
42
38
 
43
- /**
44
- * Whatever the registered guards need, since this one only forwards to them. With none registered it reads the
45
- * caller and nothing else — the refusal is unconditional — so a listing may still evaluate it argument-free.
46
- */
47
39
  static get scope(): GuardScope {
48
40
  return AgentRelayAccess.#guards.some((GuardCls) => GuardCls.scope === "resource") ? "resource" : "account";
49
41
  }
@@ -22,16 +22,12 @@ export type InternalCls<
22
22
  SrvModule extends ServiceModel = ServiceModel,
23
23
  InternalInfoMap extends { [key: string]: InternalInfo } = { [key: string]: InternalInfo },
24
24
  > = AdaptorCls & {
25
- /**
26
- * The adaptor name, which `dangerouslyAdapt` suffixes — and which the DI container keys `live.internal` by.
27
- * It used to be declared as the bare service name, so every typed read of it disagreed with the value.
28
- */
25
+ /** The suffixed adaptor name the DI container keys `live.internal` by. */
29
26
  refName: `${SrvRefName<SrvModule>}Internal`;
30
27
  srv: SrvModule;
31
28
  [INTERNAL_META]: InternalInfoMap;
32
29
  };
33
30
 
34
- /** Builds an internal adaptor for schedules, queues, processes, and server-only jobs. */
35
31
  export function internal<
36
32
  SrvModule extends ServiceModel,
37
33
  InternalInfoMap extends ReturnType<InternalBuilder<SrvModule>>,
@@ -6,14 +6,12 @@ export interface InternalArg<ArgType = unknown> {
6
6
  }
7
7
  export type InternalArgCls<ArgType = unknown> = Cls<InternalArg<ArgType>>;
8
8
 
9
- /** Injects the current Bun request into an endpoint/internal handler. */
10
9
  export class Req implements InternalArg {
11
10
  getArg(context: SignalContext): Bun.BunRequest {
12
11
  const httpContext = context.getHttpContext();
13
12
  return httpContext.req;
14
13
  }
15
14
  }
16
- /** Injects the current mutable response context into an endpoint/internal handler. */
17
15
  export class Res implements InternalArg {
18
16
  getArg(context: SignalContext) {
19
17
  const httpContext = context.getHttpContext();
@@ -21,20 +19,14 @@ export class Res implements InternalArg {
21
19
  }
22
20
  }
23
21
 
24
- /** Injects whatever the account middleware resolved for this call, or `null` for an anonymous one. */
22
+ /** Whatever the account middleware resolved for this call, or `null` for an anonymous one. */
25
23
  export class CallerAccount implements InternalArg<unknown> {
26
24
  getArg(context: SignalContext): unknown {
27
25
  return context.get("account") ?? null;
28
26
  }
29
27
  }
30
28
 
31
- /**
32
- * Injects the caller's IP, as the nearest proxy recorded it rather than as the socket peer reports it.
33
- * Behind the federation gateway every peer is the gateway, so an endpoint that reads `remoteAddress` sees
34
- * `127.0.0.1` for every caller — this reads the forwarded headers first and falls back to the peer only
35
- * when nothing proxied the call. IPv4 comes back unwrapped from `::ffff:`, so it can address a `udp4`
36
- * socket. `null` when no proxy recorded one and the transport has no peer.
37
- */
29
+ /** The caller's IP as the nearest proxy recorded it (see `SignalContext.getClientIp`), `null` when unknown. */
38
30
  export class Ip implements InternalArg<string | null> {
39
31
  getArg(context: SignalContext): string | null {
40
32
  return context.getClientIp();
@@ -42,10 +34,8 @@ export class Ip implements InternalArg<string | null> {
42
34
  }
43
35
 
44
36
  /**
45
- * Injects websocket state, this connection's id, and subscription hooks into message/pubsub handlers.
46
- * `socketId` is the one `AppWsData` minted at the handshake, so a handler never reads `ws.data` to
47
- * tell two callers apart — and never mints an id of its own, which would not match the room bookkeeping.
48
- * `on`/`off` register cleanup that runs when the room is unsubscribed or the socket closes.
37
+ * `socketId` is the one minted at the handshake — never mint your own, it would not match the room bookkeeping.
38
+ * `on`/`off` register cleanup for unsubscribe or socket close.
49
39
  */
50
40
  export class Ws implements InternalArg {
51
41
  getArg(context: SignalContext) {
@@ -72,7 +72,7 @@ export class InternalInfo<
72
72
  if (this.execFn) throw new Error("Query function is already set");
73
73
  this.internalArgs.push({
74
74
  argRef,
75
- option: { ...option, ...(this.type === "resolveField" ? { nullable: true } : {}) }, //? for resolveField, nullable is true by default
75
+ option: { ...option, ...(this.type === "resolveField" ? { nullable: true } : {}) },
76
76
  });
77
77
  return this as unknown as InternalInfo<
78
78
  ReqType,
@@ -1,4 +1,4 @@
1
- import { isMcpDescribableArg, mcpHintsOf, mcpRefusalOf } from "akanjs/common";
1
+ import { isMcpDescribableArg, lowerlize, mcpHintsOf, mcpRefusalOf } from "akanjs/common";
2
2
  import { FetchClient } from "akanjs/fetch";
3
3
  import { type AgentCandidate, AgentCatalogue, type AgentRefusal, type AgentUndescribed } from "../agent";
4
4
  import { type JsonSchema, JsonSchemaBuilder } from "../schema";
@@ -9,18 +9,11 @@ import type { McpResource, McpResourceTemplate, McpTool, McpToolAnnotations } fr
9
9
  export interface McpDocumentOptions {
10
10
  resolveDescription?: (key: string) => string | undefined;
11
11
  excludeSignals?: string[];
12
- /**
13
- * Drops every mutation from the catalogue regardless of what it opted into. Off by default: the endpoint's own
14
- * an endpoint's guards are the decision, and a second switch that silently unlists a published endpoint gives
15
- * its author no way to see why. This is the read-only-deployment valve.
16
- */
12
+ /** Drops every mutation from the catalogue whatever its guards allow. Off by default. */
17
13
  readOnly?: boolean;
18
14
  /**
19
- * How much of a result's shape a tool advertises. `shallow`, the default, publishes the returned model with every
20
- * field of its own and names each nested model instead of inlining it: on a fully open catalogue 83% of the bytes
21
- * were the same model schemas re-inlined per entry, most of them nested closures. `full` inlines the closure the
22
- * way a shared component section would. `none` publishes no `outputSchema` at all — results still ship as
23
- * `structuredContent` — for a deployment that would rather spend the bytes per call.
15
+ * `shallow` (default) names each nested model instead of inlining it, `full` inlines the closure, `none` publishes
16
+ * no `outputSchema` (results still ship as `structuredContent`).
24
17
  */
25
18
  outputSchema?: McpOutputSchemaMode;
26
19
  }
@@ -35,14 +28,9 @@ export interface McpExposedEndpoint {
35
28
  endpoint: SerializedEndpoint;
36
29
  }
37
30
 
38
- /**
39
- * A candidate this catalogue did not publish. The bookkeeping is audience-independent and lives on
40
- * `AgentCatalogue`; these are the MCP names for it.
41
- */
42
31
  export type McpRefusal = AgentRefusal;
43
32
  export type McpUndescribed = AgentUndescribed;
44
33
 
45
- /** What one signal contributes to a listing, so a catalogue that grew can say where it grew. */
46
34
  export interface McpSignalCost {
47
35
  refName: string;
48
36
  entries: number;
@@ -54,34 +42,21 @@ export interface McpListingCost {
54
42
  bySignal: McpSignalCost[];
55
43
  }
56
44
 
57
- /**
58
- * Turns the serialized signal registry into the three MCP catalogues and answers the lookups `tools/call` and
59
- * `resources/read` need. Pure: no IO and no DI — the sibling of `createOpenApiDocument`.
60
- */
61
45
  export class McpDocument {
62
- /**
63
- * An array cannot be `structuredContent` — the spec types it as an object — so a list result is wrapped under
64
- * this key and `outputSchema` is shaped to match. Both halves must agree, which is why they live together.
65
- */
46
+ /** The spec types `structuredContent` as an object, so a list result is wrapped under this key. */
66
47
  static readonly listKey = "items";
67
48
 
68
49
  readonly tools: McpTool[];
69
50
  readonly resourceTemplates: McpResourceTemplate[];
70
51
  /** Every readable thing is addressed by a template, so there are no fixed resources to enumerate. */
71
52
  readonly resources: McpResource[] = [];
72
- /**
73
- * Every candidate that was not published, with the sentence saying why — the rejections are fail-closed by
74
- * design, and an author whose endpoint is missing otherwise has nowhere to look but the framework source.
75
- */
76
53
  readonly refusals: McpRefusal[];
77
- /** What is published with no description of its own, which is the field a model picks a tool by. */
78
54
  readonly undescribed: McpUndescribed[];
79
55
  readonly #schema = new JsonSchemaBuilder({ refPrefix: "#/$defs/", nullable: "type", face: "agent" });
80
56
  readonly #modelSchemas = new Map<McpSchemaSide, Record<string, JsonSchema>>();
81
57
  readonly #options: McpDocumentOptions;
82
58
  readonly #catalogue: AgentCatalogue;
83
59
  readonly #byToolName = new Map<string, McpExposedEndpoint>();
84
- /** Keyed by endpoint key: what is addressable, and by exactly which uri. */
85
60
  readonly #templates = new Map<string, string>();
86
61
  #cost: McpListingCost | null = null;
87
62
 
@@ -99,14 +74,6 @@ export class McpDocument {
99
74
  this.undescribed = this.#catalogue.undescribed;
100
75
  }
101
76
 
102
- /**
103
- * Roughly what a `tools/list` costs the caller, and which signals it went to.
104
- *
105
- * Worth reporting because the number is nobody's intuition: MCP has no shared component section and forbids a
106
- * `$ref` across entries, so every entry inlines the schema of every model it mentions — under `outputSchema:
107
- * "full"` a plain 21-field model with one named slice ships 12KB across its eight entries, three quarters of it
108
- * the same four schemas repeated. A catalogue is re-sent whole to every agent that connects, before its first turn.
109
- */
110
77
  get listingCost(): McpListingCost {
111
78
  if (this.#cost) return this.#cost;
112
79
  const bySignal = new Map<string, McpSignalCost>();
@@ -126,20 +93,12 @@ export class McpDocument {
126
93
  return this.#byToolName.get(name);
127
94
  }
128
95
 
129
- /**
130
- * The uri `resources/read` answers for one call of a tool, or undefined for a tool that has no template. What a
131
- * page fetched is attached to a prompt under the address an agent can read it back from.
132
- */
133
96
  resourceUri(key: string, args: Record<string, unknown>): string | undefined {
134
97
  const template = this.#templates.get(key);
135
98
  return template ? McpUriTemplate.expand(template, args) : undefined;
136
99
  }
137
100
 
138
- /**
139
- * Resolves a URI only when the endpoint behind it was published as a template. An endpoint that was never
140
- * advertised has to fail here rather than fall through to its guards: opting out of MCP means keeping a thing
141
- * off the wire entirely, not merely making it refuse.
142
- */
101
+ /** Only a published template resolves: an opted-out endpoint must be unreachable, not merely refused by guards. */
143
102
  resolveResource(uri: string) {
144
103
  const target = McpUriTemplate.parse(uri);
145
104
  if (!target || !this.#templates.has(target.endpointKey)) return null;
@@ -150,55 +109,34 @@ export class McpDocument {
150
109
  static structuredContent(endpoint: SerializedEndpoint, value: unknown) {
151
110
  if (!endpoint.returns.modelType) return undefined;
152
111
  if (endpoint.returns.arrDepth) return { [McpDocument.listKey]: value };
153
-
112
+
154
113
  return value === null || value === undefined ? undefined : value;
155
114
  }
156
115
 
157
- /**
158
- * Which of the catalogue's candidates this audience takes, and in what shape.
159
- *
160
- * The enumeration and the naming policy are `AgentCatalogue`'s — every audience walks the same registry and
161
- * holds one name per entry. What is MCP's own is only this: that every candidate is published unless a rule
162
- * refuses it, and that a published one becomes a tool and sometimes an addressable uri.
163
- */
164
116
  #collect(serializedSignal: Record<string, SerializedSignal>): McpExposedEndpoint[] {
165
117
  const tools: McpExposedEndpoint[] = [];
166
118
  for (const candidate of AgentCatalogue.candidates(serializedSignal, {
167
119
  excludeSignals: this.#options.excludeSignals,
168
120
  })) {
169
- const item: McpExposedEndpoint = {
170
- refName: candidate.refName,
171
- key: candidate.key,
172
- endpoint: candidate.endpoint,
173
- };
174
-
175
- const reason = mcpRefusalOf(item.endpoint, {
176
- refName: item.refName,
177
- key: item.key,
178
- readOnly: this.#options.readOnly,
179
- });
121
+ const { refName, key, endpoint } = candidate;
122
+ const item: McpExposedEndpoint = { refName, key, endpoint };
123
+ const reason = mcpRefusalOf(endpoint, { refName, key, readOnly: this.#options.readOnly });
180
124
  if (reason) {
181
- this.#catalogue.refuse(item.key, reason);
125
+ this.#catalogue.refuse(key, reason);
182
126
  continue;
183
127
  }
184
- if (!this.#catalogue.claim(item.key)) continue;
185
-
128
+ if (!this.#catalogue.claim(key)) continue;
129
+
186
130
  const uriTemplate = McpDocument.#addressable(candidate)
187
- ? McpDocument.#uriTemplate(item.refName, item.key, item.endpoint)
131
+ ? McpDocument.#uriTemplate(refName, key, endpoint)
188
132
  : undefined;
189
- this.#byToolName.set(item.key, item);
190
- if (uriTemplate) this.#templates.set(item.key, uriTemplate);
133
+ this.#byToolName.set(key, item);
134
+ if (uriTemplate) this.#templates.set(key, uriTemplate);
191
135
  tools.push(item);
192
136
  }
193
137
  return tools;
194
138
  }
195
139
 
196
- /**
197
- * Whether this candidate is one of the generated reads that has an `akan://` address.
198
- *
199
- * Only the list side of a slice is addressable; an insight is an aggregate with nothing to point a URI at, and a
200
- * custom endpoint has no generated key shape to build one from.
201
- */
202
140
  static #addressable({ origin, refName, key, baseVerb }: AgentCandidate): boolean {
203
141
  if (origin === "base") return baseVerb === "get";
204
142
  if (origin === "slice") return key.startsWith(`${refName}List`);
@@ -210,7 +148,7 @@ export class McpDocument {
210
148
 
211
149
  const args = [...paramArgs, ...searchArgs, ...bodyArgs].filter(isMcpDescribableArg);
212
150
  const properties = Object.fromEntries(args.map((arg) => [arg.name, this.#argSchema(refName, key, arg)]));
213
-
151
+
214
152
  const required = [...paramArgs, ...bodyArgs]
215
153
  .filter((arg) => isMcpDescribableArg(arg) && !arg.nullable)
216
154
  .map((arg) => arg.name);
@@ -234,7 +172,6 @@ export class McpDocument {
234
172
  if (this.#options.outputSchema === "none") return undefined;
235
173
 
236
174
  if (!endpoint.returns.modelType) return undefined;
237
-
238
175
  if (endpoint.returns.nullable && !endpoint.returns.arrDepth) return undefined;
239
176
  const returns = this.#schema.returns(endpoint.returns);
240
177
  const schema = endpoint.returns.arrDepth
@@ -245,22 +182,15 @@ export class McpDocument {
245
182
  additionalProperties: false,
246
183
  }
247
184
  : returns;
248
-
249
185
  return { ...schema, ...this.#defs(schema, "output") };
250
186
  }
251
187
 
252
188
  #defs(seed: unknown, side: McpSchemaSide) {
253
189
  const defs = this.#schema.referencedSchemas(seed, this.#modelSchemasOf(side));
254
-
190
+
255
191
  return Object.keys(defs).length ? { $defs: defs } : {};
256
192
  }
257
193
 
258
- /**
259
- * Every registered model, built once per side for the whole document. Narrowing runs twice per tool — input
260
- * schema and output schema — so deriving the full set inside each call rebuilt every model in the app 2N times.
261
- * A request side asks for a relation's id, which is what the wire carries; a response side names a nested model
262
- * unless `outputSchema: "full"` asked for the closure. Neither repeats the id pattern inside a `$defs`.
263
- */
264
194
  #modelSchemasOf(side: McpSchemaSide) {
265
195
  const cached = this.#modelSchemas.get(side);
266
196
  if (cached) return cached;
@@ -268,6 +198,7 @@ export class McpDocument {
268
198
  side === "input"
269
199
  ? this.#schema.allModelSchemas({ relations: "id", idPattern: false })
270
200
  : this.#schema.allModelSchemas({
201
+
271
202
  readable: true,
272
203
  relations: this.#options.outputSchema === "full" ? "inline" : "named",
273
204
  idPattern: false,
@@ -303,6 +234,6 @@ export class McpDocument {
303
234
  const argNames = endpoint.args
304
235
  .filter((arg) => (arg.type === "param" || arg.type === "search") && isMcpDescribableArg(arg))
305
236
  .map((arg) => arg.name);
306
- return McpUriTemplate.list(refName, suffix ? `${suffix.charAt(0).toLowerCase()}${suffix.slice(1)}` : "", argNames);
237
+ return McpUriTemplate.list(refName, lowerlize(suffix), argNames);
307
238
  }
308
239
  }
@@ -1,9 +1,9 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
2
 
3
3
  export interface McpProgressOption {
4
- /** Denominator for the ratio a client renders. Omit when the amount of work is not known up front. */
4
+ /** Omit when the amount of work is not known up front. */
5
5
  total?: number;
6
- /** One short line describing the current step. Shown to the user, so keep it prose rather than a status code. */
6
+ /** Shown to the user, so write prose rather than a status code. */
7
7
  message?: string;
8
8
  }
9
9
 
@@ -12,26 +12,17 @@ export interface McpProgressReport extends McpProgressOption {
12
12
  }
13
13
 
14
14
  /**
15
- * The progress channel for one streamed MCP call.
16
- *
17
- * Reached through `AsyncLocalStorage` rather than a parameter so an endpoint reports progress from wherever the
18
- * work actually happens — a service, an adapter, a loop several frames down — without every signature between
19
- * here and there growing a channel argument. Outside a streamed call `report` is a no-op, so the same endpoint
20
- * code runs unchanged over plain HTTP, a websocket, or a test.
15
+ * Reached through `AsyncLocalStorage` so any frame of the work can report; outside a streamed call `report` is a
16
+ * no-op, so the same endpoint runs unchanged over HTTP, a websocket or a test.
21
17
  */
22
18
  export class McpProgress {
23
19
  static readonly #storage = new AsyncLocalStorage<McpProgress>();
24
20
 
25
- /**
26
- * Reports progress for the call running on this stack. Silent when nothing is listening, which is every call
27
- * that did not ask for a stream.
28
- */
29
21
  static report(progress: number, option: McpProgressOption = {}) {
30
22
  const channel = McpProgress.#storage.getStore();
31
23
  if (channel) channel.#push(progress, option);
32
24
  }
33
25
 
34
- /** True while the caller is streaming, so an expensive progress message can be skipped when nobody reads it. */
35
26
  static get streaming() {
36
27
  return !!McpProgress.#storage.getStore();
37
28
  }
@@ -46,7 +37,7 @@ export class McpProgress {
46
37
  #start: (() => void) | null = null;
47
38
  #ended = false;
48
39
 
49
- /** Resolves on the first report and never otherwise — a call that reports nothing has nothing to stream. */
40
+ /** Resolves on the first report, and never for a call that reports nothing. */
50
41
  readonly started: Promise<void>;
51
42
 
52
43
  constructor() {
@@ -55,15 +46,11 @@ export class McpProgress {
55
46
  });
56
47
  }
57
48
 
58
- /**
59
- * Aborted when the client closes the response stream, which is how cancellation is signalled over this
60
- * transport. Long-running work may watch it; the framework cannot force an `exec` already in flight to stop.
61
- */
49
+ /** Aborted when the client closes the response stream; an `exec` already in flight is not forced to stop. */
62
50
  get signal() {
63
51
  return this.#abort.signal;
64
52
  }
65
53
 
66
- /** Yields every report until the call finishes. Buffered ones come out first, so none is lost to a late reader. */
67
54
  async *reports(): AsyncGenerator<McpProgressReport> {
68
55
 
69
56
  while (!this.#ended || this.#queue.length) {
@@ -5,13 +5,6 @@ export interface McpResourceTarget {
5
5
  args: Record<string, string | string[]>;
6
6
  }
7
7
 
8
- /**
9
- * Two-way map between an `akan://` resource URI and the endpoint that answers it.
10
- *
11
- * Parsing is done by hand rather than through `URL`: `akan:` is a non-special scheme, and how a runtime
12
- * normalizes the authority of one (case, percent-decoding) is exactly where a camelCase refName like
13
- * `agentSession` would quietly stop matching its model.
14
- */
15
8
  export class McpUriTemplate {
16
9
  static readonly scheme = "akan";
17
10
  /** Reserved second segment: a model id may never take one of these values, and none is a valid ObjectId. */
@@ -20,23 +13,12 @@ export class McpUriTemplate {
20
13
  static model(refName: string) {
21
14
  return `${McpUriTemplate.scheme}://${refName}/{${refName}Id}`;
22
15
  }
23
- /**
24
- * The model's own unfiltered list is the bare `…/list`, never `…/list/<token>`. A named slice occupies the
25
- * third segment, and a slice key is an author-chosen identifier — so any token put there for the root list
26
- * would be one a slice could also be called, and the two would publish the same uri with only one of them
27
- * readable. `list` in the *second* segment is already reserved against a model id, so there is nothing to
28
- * collide with here.
29
- */
16
+ /** The root list is the bare `…/list`: any third-segment token could also be an author's slice key. */
30
17
  static list(refName: string, sliceKey: string, argNames: string[]) {
31
18
  const base = `${McpUriTemplate.scheme}://${refName}/list${sliceKey ? `/${sliceKey}` : ""}`;
32
19
  return argNames.length ? `${base}{?${argNames.join(",")}}` : base;
33
20
  }
34
21
 
35
- /**
36
- * The uri a template names for one call's arguments — the inverse of `parse`, so what a page fetched can be
37
- * attached under the address an agent may read it back from. A list argument repeats its key; an absent
38
- * optional one is left out.
39
- */
40
22
  static expand(template: string, args: Record<string, unknown>): string {
41
23
  const queryAt = template.indexOf("{?");
42
24
  const path = (queryAt === -1 ? template : template.slice(0, queryAt)).replace(/\{([^}]+)\}/g, (_, name: string) =>
@@ -75,13 +57,6 @@ export class McpUriTemplate {
75
57
  return null;
76
58
  }
77
59
 
78
- /**
79
- * A percent escape the decoder rejects (`akan://banner/%`) makes the uri unreadable, which is the same answer as
80
- * a uri naming nothing: `resources/read` says `Unknown resource`. Left to throw, `decodeURIComponent`'s `URIError`
81
- * reached the router's catch and became "the server failed" with a stack in the log — on a method an agent may
82
- * call with any string it likes, so it was a log-spam path as well as a wrong verdict. The query half needs no
83
- * such guard: `URLSearchParams` reads a bad escape as literal text.
84
- */
85
60
  static #decode(segments: string[]) {
86
61
  try {
87
62
  return segments.map(decodeURIComponent);
@@ -90,7 +65,6 @@ export class McpUriTemplate {
90
65
  }
91
66
  }
92
67
 
93
- /** Repeated keys become an array so an `arrDepth` search arg round-trips through `{?statuses}` form expansion. */
94
68
  static #searchArgs(search: URLSearchParams): Record<string, string | string[]> {
95
69
  const args: Record<string, string | string[]> = {};
96
70
  for (const key of new Set(search.keys())) {