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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (719) hide show
  1. package/CHANGELOG.md +103 -0
  2. package/README.ko.md +1 -1
  3. package/README.md +1 -1
  4. package/base/baseEnv.ts +7 -4
  5. package/base/primitiveRegistry.ts +59 -12
  6. package/base/symbols.ts +4 -0
  7. package/client/capacitor.ts +34 -0
  8. package/client/clientRuntime.ts +5 -0
  9. package/client/csrTypes.ts +4 -3
  10. package/client/index.ts +1 -0
  11. package/client/locale.ts +2 -2
  12. package/client/router.ts +7 -7
  13. package/client/sharedContext.ts +31 -0
  14. package/client/translator.ts +2 -2
  15. package/client/types.ts +3 -3
  16. package/common/Logger.ts +280 -67
  17. package/common/clientAddress.ts +40 -0
  18. package/common/deepObjectify.ts +24 -9
  19. package/common/index.ts +42 -1
  20. package/common/logContext.ts +27 -0
  21. package/common/mcpExposure.ts +114 -0
  22. package/common/pathGetLoose.ts +31 -0
  23. package/common/pathSet.ts +17 -5
  24. package/common/plainFieldsOf.ts +13 -0
  25. package/common/routeConvention.ts +22 -12
  26. package/common/websocketBinaryFrame.ts +46 -0
  27. package/constant/crystalize.ts +94 -28
  28. package/constant/dateSlot.ts +62 -0
  29. package/constant/deserialize.ts +3 -2
  30. package/constant/fieldInfo.ts +43 -3
  31. package/constant/fieldQueryMeta.ts +35 -0
  32. package/constant/getDefault.ts +16 -11
  33. package/constant/hydrationPlan.ts +72 -0
  34. package/constant/immerify.ts +4 -6
  35. package/constant/index.ts +5 -0
  36. package/constant/labelOf.ts +26 -0
  37. package/constant/mask.ts +67 -0
  38. package/constant/purify.ts +17 -11
  39. package/constant/textFieldPaths.ts +13 -7
  40. package/constant/types.ts +19 -13
  41. package/constant/via.ts +24 -17
  42. package/dictionary/DictionaryLookup.ts +30 -0
  43. package/dictionary/agent.dictionary.ts +31 -0
  44. package/dictionary/agentTurn.dictionary.ts +29 -0
  45. package/dictionary/base.dictionary.ts +81 -0
  46. package/dictionary/dictInfo.ts +11 -2
  47. package/dictionary/dictionary.ts +9 -3
  48. package/dictionary/index.ts +1 -0
  49. package/dictionary/trans.ts +2 -2
  50. package/document/documentQuery.ts +1 -0
  51. package/document/filterMeta.ts +77 -12
  52. package/document/index.ts +1 -0
  53. package/document/noDocumentError.ts +12 -0
  54. package/document/types.ts +0 -1
  55. package/fetch/agentTurn.ts +19 -0
  56. package/fetch/client/fetchClient.ts +137 -37
  57. package/fetch/client/httpClient.ts +95 -20
  58. package/fetch/client/wsClient.ts +27 -12
  59. package/fetch/fetchType/appliedReturn.type.ts +65 -44
  60. package/fetch/fetchType/endpointFetch.type.ts +17 -8
  61. package/fetch/fetchType/sliceFetch.type.ts +27 -50
  62. package/fetch/index.ts +1 -0
  63. package/index.ts +80 -6
  64. package/local/apps/akan/akan-local.db +0 -0
  65. package/local/apps/akan/akan-local.db-shm +0 -0
  66. package/local/apps/akan/akan-local.db-wal +0 -0
  67. package/local/apps/akan/akan-local_solid.db +0 -0
  68. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  69. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  70. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  71. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  72. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  73. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  74. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  75. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  76. package/package.json +27 -18
  77. package/server/akanApp.ts +278 -138
  78. package/server/akanAppHeaders.ts +16 -2
  79. package/server/akanOption.ts +63 -8
  80. package/server/akanServer.ts +387 -32
  81. package/server/animatedImage.ts +83 -0
  82. package/server/assetEncoding.ts +4 -24
  83. package/server/binaryPubsub.ts +55 -0
  84. package/server/console.ts +110 -101
  85. package/server/consoleEvaluator.ts +51 -0
  86. package/server/consolePasteFilter.ts +91 -0
  87. package/server/consoleSession.ts +242 -0
  88. package/server/contentEncoding.ts +83 -0
  89. package/server/devtools/signalSerializer.ts +2 -2
  90. package/server/devtools/types.ts +4 -4
  91. package/server/di/diLifecycle.ts +123 -13
  92. package/server/di/predefinedAdaptor.ts +6 -0
  93. package/server/di/utils.ts +40 -0
  94. package/server/imageOptimizer.ts +154 -57
  95. package/server/lifecycle/runtimeDir.ts +14 -0
  96. package/server/lifecycle/shutdownManager.ts +1 -1
  97. package/server/logging/childOutputReader.ts +137 -0
  98. package/server/logging/hubFileSink.ts +39 -0
  99. package/server/logging/logControlSocket.ts +173 -0
  100. package/server/logging/logForwarder.ts +131 -0
  101. package/server/logging/logHub.ts +0 -0
  102. package/server/logging/logQuery.ts +130 -0
  103. package/server/logging/logStdoutWriter.ts +39 -0
  104. package/server/logging/logStreamRoute.ts +87 -0
  105. package/server/logging/logTailClient.ts +161 -0
  106. package/server/mcp/McpAuth.ts +177 -0
  107. package/server/mcp/McpDispatcher.ts +289 -0
  108. package/server/mcp/McpEventStream.ts +24 -0
  109. package/server/mcp/McpExecutionContext.ts +105 -0
  110. package/server/mcp/McpRouter.ts +621 -0
  111. package/server/mcp/index.ts +5 -0
  112. package/server/processMetricsCollector.ts +1 -1
  113. package/server/resolver/database.resolver.ts +5 -4
  114. package/server/resolver/signal.resolver.ts +208 -86
  115. package/server/routeTreeBuilder.ts +10 -8
  116. package/server/routing/apiRouter.ts +44 -14
  117. package/server/routing/appWsData.ts +24 -2
  118. package/server/routing/eventStream.ts +93 -0
  119. package/server/routing/soloAppRoutes.ts +50 -0
  120. package/server/rscWorker.tsx +36 -22
  121. package/server/rscWorkerHost.ts +59 -8
  122. package/server/semaphore.ts +22 -0
  123. package/server/subRouteIndexDocument.tsx +61 -0
  124. package/server/systemPageDocument.tsx +3 -3
  125. package/server/systemPages.tsx +49 -16
  126. package/server/types.tsx +28 -0
  127. package/server/vendor/akanjs-fetch.ts +1 -0
  128. package/server/webRouter.ts +96 -39
  129. package/service/adapt.ts +4 -4
  130. package/service/agent.service.ts +81 -0
  131. package/service/base.service.ts +2 -1
  132. package/service/index.ts +1 -0
  133. package/service/injectInfo.ts +8 -3
  134. package/service/ipcTypes.ts +6 -0
  135. package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
  136. package/service/predefinedAdaptor/database.adaptor.ts +68 -37
  137. package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
  138. package/service/predefinedAdaptor/index.ts +3 -0
  139. package/service/predefinedAdaptor/insightQuery.ts +183 -0
  140. package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
  141. package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
  142. package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
  143. package/service/predefinedAdaptor/role.adaptor.ts +2 -0
  144. package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
  145. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
  146. package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
  147. package/service/predefinedAdaptor/solidSqlite.ts +11 -9
  148. package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
  149. package/service/serve.ts +16 -9
  150. package/service/toolNames.ts +119 -0
  151. package/signal/agent/AgentCatalogue.ts +165 -0
  152. package/signal/agent/index.ts +1 -0
  153. package/signal/agent.signal.ts +38 -0
  154. package/signal/agentTurn.ts +8 -0
  155. package/signal/agentTurnStream.ts +60 -0
  156. package/signal/base.signal.ts +2 -1
  157. package/signal/endpointInfo.ts +38 -2
  158. package/signal/guard.ts +28 -1
  159. package/signal/guards.ts +49 -1
  160. package/signal/index.ts +6 -0
  161. package/signal/intercept.ts +4 -4
  162. package/signal/internalArg.ts +21 -4
  163. package/signal/mcp/McpDocument.ts +326 -0
  164. package/signal/mcp/McpProgress.ts +106 -0
  165. package/signal/mcp/McpUriTemplate.ts +80 -0
  166. package/signal/mcp/Msg.ts +368 -0
  167. package/signal/mcp/index.ts +5 -0
  168. package/signal/mcp/mcpProtocol.ts +120 -0
  169. package/signal/middleware.ts +3 -3
  170. package/signal/openapi/openapi.ts +36 -173
  171. package/signal/schema/JsonSchemaBuilder.ts +221 -0
  172. package/signal/schema/index.ts +1 -0
  173. package/signal/serializer/fetch.serializer.ts +51 -0
  174. package/signal/signalContext.ts +324 -76
  175. package/signal/slice.ts +62 -27
  176. package/signal/trace.ts +268 -9
  177. package/signal/types.ts +55 -4
  178. package/store/action.ts +34 -41
  179. package/store/actionTag.ts +33 -0
  180. package/store/agent/AgentBridge.ts +87 -0
  181. package/store/agent/AgentContext.ts +71 -0
  182. package/store/agent/AgentPrompts.ts +111 -0
  183. package/store/agent/ScreenReader.ts +349 -0
  184. package/store/agent/ScreenSettle.ts +45 -0
  185. package/store/agent/ScreenTarget.ts +135 -0
  186. package/store/agent/StoreCatalogue.ts +116 -0
  187. package/store/agent/StoreSurfaceSource.ts +225 -0
  188. package/store/agent/index.ts +13 -0
  189. package/store/agent/storeSurface.ts +28 -0
  190. package/store/agent/types.ts +16 -0
  191. package/store/agentic/AgentValue.ts +119 -0
  192. package/store/agentic/StExposeBuilder.ts +47 -0
  193. package/store/agentic/StExposeDraft.ts +24 -0
  194. package/store/agentic/StStateBuilder.ts +85 -0
  195. package/store/agentic/StStateDraft.ts +23 -0
  196. package/store/agentic/StToolBuilder.ts +279 -0
  197. package/store/agentic/StToolDraft.ts +22 -0
  198. package/store/agentic/attachAgentic.ts +33 -0
  199. package/store/agentic/formFields.ts +194 -0
  200. package/store/agentic/index.ts +12 -0
  201. package/store/agentic/useFieldTool.ts +183 -0
  202. package/store/agentic/useFormTools.ts +77 -0
  203. package/store/agentic/useRelationFieldTool.ts +113 -0
  204. package/store/baseSt.ts +1 -1
  205. package/store/databaseStateNames.ts +31 -0
  206. package/store/formSetterNames.ts +35 -0
  207. package/store/index.ts +8 -0
  208. package/store/rootStore.ts +3 -1
  209. package/store/sliceRole.ts +36 -0
  210. package/store/state.ts +2 -12
  211. package/store/store.ts +9 -0
  212. package/store/storeInstance.ts +185 -20
  213. package/store/storeRegistry.ts +39 -1
  214. package/store/types.ts +5 -0
  215. package/store/withSelector.ts +5 -4
  216. package/test/index.ts +1 -1
  217. package/test/registerDom.ts +4 -0
  218. package/test/sampleOf.ts +2 -0
  219. package/test/signalTestRuntime.ts +5 -5
  220. package/test/testServer.ts +14 -11
  221. package/types/base/baseEnv.d.ts +1 -1
  222. package/types/base/primitiveRegistry.d.ts +20 -8
  223. package/types/base/symbols.d.ts +4 -0
  224. package/types/client/capacitor.d.ts +39 -0
  225. package/types/client/clientRuntime.d.ts +7 -0
  226. package/types/client/index.d.ts +1 -0
  227. package/types/client/sharedContext.d.ts +21 -0
  228. package/types/client/types.d.ts +5 -3
  229. package/types/common/Logger.d.ts +88 -6
  230. package/types/common/clientAddress.d.ts +19 -0
  231. package/types/common/deepObjectify.d.ts +4 -2
  232. package/types/common/index.d.ts +8 -2
  233. package/types/common/logContext.d.ts +17 -0
  234. package/types/common/mcpExposure.d.ts +64 -0
  235. package/types/common/pathGetLoose.d.ts +8 -0
  236. package/types/common/plainFieldsOf.d.ts +6 -0
  237. package/types/common/routeConvention.d.ts +6 -0
  238. package/types/common/websocketBinaryFrame.d.ts +17 -0
  239. package/types/constant/constantRegistry.d.ts +2 -10
  240. package/types/constant/crystalize.d.ts +5 -0
  241. package/types/constant/dateSlot.d.ts +14 -0
  242. package/types/constant/fieldInfo.d.ts +20 -3
  243. package/types/constant/fieldQueryMeta.d.ts +17 -0
  244. package/types/constant/getDefault.d.ts +8 -0
  245. package/types/constant/hydrationPlan.d.ts +24 -0
  246. package/types/constant/index.d.ts +5 -0
  247. package/types/constant/labelOf.d.ts +7 -0
  248. package/types/constant/mask.d.ts +41 -0
  249. package/types/constant/purify.d.ts +2 -2
  250. package/types/constant/types.d.ts +5 -5
  251. package/types/dictionary/DictionaryLookup.d.ts +14 -0
  252. package/types/dictionary/agent.dictionary.d.ts +1 -0
  253. package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
  254. package/types/dictionary/base.dictionary.d.ts +1 -1
  255. package/types/dictionary/dictInfo.d.ts +7 -1
  256. package/types/dictionary/dictionary.d.ts +11 -9
  257. package/types/dictionary/index.d.ts +1 -0
  258. package/types/document/filterMeta.d.ts +24 -4
  259. package/types/document/index.d.ts +1 -0
  260. package/types/document/noDocumentError.d.ts +12 -0
  261. package/types/document/types.d.ts +0 -1
  262. package/types/fetch/agentTurn.d.ts +475 -0
  263. package/types/fetch/client/fetchClient.d.ts +12 -0
  264. package/types/fetch/client/httpClient.d.ts +2 -1
  265. package/types/fetch/fetchType/appliedReturn.type.d.ts +37 -18
  266. package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
  267. package/types/fetch/fetchType/sliceFetch.type.d.ts +11 -15
  268. package/types/fetch/index.d.ts +1 -0
  269. package/types/index.d.ts +74 -10
  270. package/types/server/akanApp.d.ts +12 -0
  271. package/types/server/akanAppHeaders.d.ts +7 -1
  272. package/types/server/akanOption.d.ts +36 -6
  273. package/types/server/akanServer.d.ts +67 -9
  274. package/types/server/animatedImage.d.ts +7 -0
  275. package/types/server/assetEncoding.d.ts +1 -1
  276. package/types/server/binaryPubsub.d.ts +18 -0
  277. package/types/server/console.d.ts +11 -1
  278. package/types/server/consoleEvaluator.d.ts +2 -0
  279. package/types/server/consolePasteFilter.d.ts +11 -0
  280. package/types/server/consoleSession.d.ts +22 -0
  281. package/types/server/contentEncoding.d.ts +28 -0
  282. package/types/server/devtools/types.d.ts +4 -4
  283. package/types/server/di/diLifecycle.d.ts +10 -2
  284. package/types/server/di/predefinedAdaptor.d.ts +4 -1
  285. package/types/server/di/utils.d.ts +16 -0
  286. package/types/server/lifecycle/runtimeDir.d.ts +5 -0
  287. package/types/server/logging/childOutputReader.d.ts +40 -0
  288. package/types/server/logging/hubFileSink.d.ts +18 -0
  289. package/types/server/logging/logControlSocket.d.ts +60 -0
  290. package/types/server/logging/logForwarder.d.ts +37 -0
  291. package/types/server/logging/logHub.d.ts +70 -0
  292. package/types/server/logging/logQuery.d.ts +31 -0
  293. package/types/server/logging/logStdoutWriter.d.ts +35 -0
  294. package/types/server/logging/logStreamRoute.d.ts +20 -0
  295. package/types/server/logging/logTailClient.d.ts +42 -0
  296. package/types/server/mcp/McpAuth.d.ts +62 -0
  297. package/types/server/mcp/McpDispatcher.d.ts +61 -0
  298. package/types/server/mcp/McpEventStream.d.ts +17 -0
  299. package/types/server/mcp/McpExecutionContext.d.ts +44 -0
  300. package/types/server/mcp/McpRouter.d.ts +65 -0
  301. package/types/server/mcp/index.d.ts +5 -0
  302. package/types/server/mcp.d.ts +1 -0
  303. package/types/server/resolver/signal.resolver.d.ts +7 -4
  304. package/types/server/routing/apiRouter.d.ts +2 -1
  305. package/types/server/routing/appWsData.d.ts +13 -1
  306. package/types/server/routing/eventStream.d.ts +23 -0
  307. package/types/server/routing/soloAppRoutes.d.ts +17 -0
  308. package/types/server/rscWorkerHost.d.ts +4 -1
  309. package/types/server/semaphore.d.ts +5 -0
  310. package/types/server/subRouteIndexDocument.d.ts +8 -0
  311. package/types/server/systemPageDocument.d.ts +1 -0
  312. package/types/server/systemPages.d.ts +5 -0
  313. package/types/server/types.d.ts +16 -0
  314. package/types/server/vendor/akanjs-fetch.d.ts +1 -0
  315. package/types/server/webRouter.d.ts +15 -4
  316. package/types/service/adapt.d.ts +2 -2
  317. package/types/service/agent.service.d.ts +32 -0
  318. package/types/service/base.service.d.ts +4 -0
  319. package/types/service/index.d.ts +1 -0
  320. package/types/service/injectInfo.d.ts +2 -2
  321. package/types/service/ipcTypes.d.ts +12 -0
  322. package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
  323. package/types/service/predefinedAdaptor/database.adaptor.d.ts +9 -3
  324. package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
  325. package/types/service/predefinedAdaptor/index.d.ts +3 -0
  326. package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
  327. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
  328. package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
  329. package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
  330. package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
  331. package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
  332. package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
  333. package/types/service/serve.d.ts +3 -3
  334. package/types/service/toolNames.d.ts +35 -0
  335. package/types/signal/agent/AgentCatalogue.d.ts +100 -0
  336. package/types/signal/agent/index.d.ts +1 -0
  337. package/types/signal/agent.d.ts +1 -0
  338. package/types/signal/agent.signal.d.ts +24 -0
  339. package/types/signal/agentTurn.d.ts +9 -0
  340. package/types/signal/agentTurnStream.d.ts +24 -0
  341. package/types/signal/base.signal.d.ts +1 -1
  342. package/types/signal/endpointInfo.d.ts +21 -3
  343. package/types/signal/guard.d.ts +12 -0
  344. package/types/signal/guards.d.ts +23 -1
  345. package/types/signal/index.d.ts +6 -0
  346. package/types/signal/intercept.d.ts +2 -2
  347. package/types/signal/internalArg.d.ts +22 -6
  348. package/types/signal/mcp/McpDocument.d.ts +84 -0
  349. package/types/signal/mcp/McpProgress.d.ts +40 -0
  350. package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
  351. package/types/signal/mcp/Msg.d.ts +143 -0
  352. package/types/signal/mcp/index.d.ts +5 -0
  353. package/types/signal/mcp/mcpProtocol.d.ts +107 -0
  354. package/types/signal/mcp.d.ts +1 -0
  355. package/types/signal/middleware.d.ts +7 -7
  356. package/types/signal/openapi/openapi.d.ts +3 -3
  357. package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
  358. package/types/signal/schema/index.d.ts +1 -0
  359. package/types/signal/schema.d.ts +1 -0
  360. package/types/signal/signalContext.d.ts +67 -8
  361. package/types/signal/slice.d.ts +42 -15
  362. package/types/signal/trace.d.ts +52 -2
  363. package/types/signal/types.d.ts +53 -4
  364. package/types/store/action.d.ts +7 -5
  365. package/types/store/actionTag.d.ts +21 -0
  366. package/types/store/agent/AgentBridge.d.ts +37 -0
  367. package/types/store/agent/AgentContext.d.ts +16 -0
  368. package/types/store/agent/AgentPrompts.d.ts +31 -0
  369. package/types/store/agent/ScreenReader.d.ts +29 -0
  370. package/types/store/agent/ScreenSettle.d.ts +22 -0
  371. package/types/store/agent/ScreenTarget.d.ts +34 -0
  372. package/types/store/agent/StoreCatalogue.d.ts +26 -0
  373. package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
  374. package/types/store/agent/index.d.ts +11 -0
  375. package/types/store/agent/storeSurface.d.ts +14 -0
  376. package/types/store/agent/types.d.ts +15 -0
  377. package/types/store/agent.d.ts +1 -0
  378. package/types/store/agentic/AgentValue.d.ts +43 -0
  379. package/types/store/agentic/StExposeBuilder.d.ts +21 -0
  380. package/types/store/agentic/StExposeDraft.d.ts +13 -0
  381. package/types/store/agentic/StStateBuilder.d.ts +21 -0
  382. package/types/store/agentic/StStateDraft.d.ts +12 -0
  383. package/types/store/agentic/StToolBuilder.d.ts +56 -0
  384. package/types/store/agentic/StToolDraft.d.ts +13 -0
  385. package/types/store/agentic/attachAgentic.d.ts +25 -0
  386. package/types/store/agentic/formFields.d.ts +53 -0
  387. package/types/store/agentic/index.d.ts +12 -0
  388. package/types/store/agentic/useFieldTool.d.ts +22 -0
  389. package/types/store/agentic/useFormTools.d.ts +19 -0
  390. package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
  391. package/types/store/agentic.d.ts +1 -0
  392. package/types/store/baseSt.d.ts +35 -39
  393. package/types/store/databaseStateNames.d.ts +25 -0
  394. package/types/store/formSetterNames.d.ts +30 -0
  395. package/types/store/index.d.ts +7 -0
  396. package/types/store/rootStore.d.ts +5 -1
  397. package/types/store/sliceRole.d.ts +25 -0
  398. package/types/store/store.d.ts +5 -1
  399. package/types/store/storeInstance.d.ts +33 -1
  400. package/types/store/storeRegistry.d.ts +5 -0
  401. package/types/store/types.d.ts +4 -0
  402. package/types/store/withSelector.d.ts +5 -4
  403. package/types/test/index.d.ts +1 -1
  404. package/types/test/registerDom.d.ts +1 -0
  405. package/types/test/signalTestRuntime.d.ts +2 -3
  406. package/types/test/testServer.d.ts +6 -4
  407. package/types/ui/Agent/Approval.d.ts +8 -0
  408. package/types/ui/Agent/Attach.d.ts +16 -0
  409. package/types/ui/Agent/Bubble.d.ts +26 -0
  410. package/types/ui/Agent/Chat.d.ts +91 -0
  411. package/types/ui/Agent/ChatCommands.d.ts +34 -0
  412. package/types/ui/Agent/Composer.d.ts +23 -0
  413. package/types/ui/Agent/Context.d.ts +13 -0
  414. package/types/ui/Agent/Dock.d.ts +17 -0
  415. package/types/ui/Agent/Guide.d.ts +9 -0
  416. package/types/ui/Agent/History.d.ts +26 -0
  417. package/types/ui/Agent/Launcher.d.ts +16 -0
  418. package/types/ui/Agent/Markdown.d.ts +19 -0
  419. package/types/ui/Agent/Menu.d.ts +18 -0
  420. package/types/ui/Agent/Mic.d.ts +8 -0
  421. package/types/ui/Agent/Question.d.ts +14 -0
  422. package/types/ui/Agent/Section.d.ts +10 -0
  423. package/types/ui/Agent/Skip.d.ts +22 -0
  424. package/types/ui/Agent/StateKey.d.ts +16 -0
  425. package/types/ui/Agent/Tool.d.ts +15 -0
  426. package/types/ui/Agent/Transcript.d.ts +13 -0
  427. package/types/ui/Agent/Zone.d.ts +48 -0
  428. package/types/ui/Agent/agentSessionOf.d.ts +27 -0
  429. package/types/ui/Agent/attachment.d.ts +34 -0
  430. package/types/ui/Agent/fetchRunner.d.ts +12 -0
  431. package/types/ui/Agent/index.d.ts +19 -0
  432. package/types/ui/Agent/index_.d.ts +1 -0
  433. package/types/ui/Agent/markdownBlocks.d.ts +35 -0
  434. package/types/ui/Agent/markdownSpans.d.ts +2 -0
  435. package/types/ui/Agent/markdownTable.d.ts +16 -0
  436. package/types/ui/Agent/sessionHistory.d.ts +14 -0
  437. package/types/ui/Agent/sessionView.d.ts +15 -0
  438. package/types/ui/Agent/tokenCount.d.ts +6 -0
  439. package/types/ui/Agent/useChatAttachments.d.ts +24 -0
  440. package/types/ui/Agent/useChatVoice.d.ts +30 -0
  441. package/types/ui/Agent/useDraftRecall.d.ts +14 -0
  442. package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
  443. package/types/ui/Agent/useSlashMenu.d.ts +24 -0
  444. package/types/ui/Agent/voice.d.ts +71 -0
  445. package/types/ui/Agent.d.ts +1 -0
  446. package/types/ui/Badge.d.ts +1 -1
  447. package/types/ui/Button.d.ts +1 -1
  448. package/types/ui/Constant/Graph.d.ts +10 -0
  449. package/types/ui/Constant/index.d.ts +2 -1
  450. package/types/ui/Constant/schemaGraph.d.ts +39 -0
  451. package/types/ui/Data/Dashboard.d.ts +16 -3
  452. package/types/ui/Data/Insight.d.ts +1 -1
  453. package/types/ui/Data/ListContainer.d.ts +15 -7
  454. package/types/ui/Data/QueryMaker.d.ts +45 -3
  455. package/types/ui/Data/RefPicker.d.ts +16 -0
  456. package/types/ui/Data/dataExport.d.ts +5 -0
  457. package/types/ui/Data/dataText.d.ts +6 -0
  458. package/types/ui/Data/index.d.ts +2 -0
  459. package/types/ui/Data/index_.d.ts +1 -0
  460. package/types/ui/DatePicker.d.ts +15 -11
  461. package/types/ui/Dialog/LegacyModal.d.ts +13 -0
  462. package/types/ui/Dialog/Provider.d.ts +3 -1
  463. package/types/ui/Dialog/context.d.ts +9 -1
  464. package/types/ui/Dialog/index.d.ts +1 -0
  465. package/types/ui/DraggableList.d.ts +1 -1
  466. package/types/ui/Dropdown.d.ts +5 -1
  467. package/types/ui/Field.d.ts +13 -12
  468. package/types/ui/Layout/BottomTab.d.ts +3 -2
  469. package/types/ui/LegacyModal.d.ts +24 -0
  470. package/types/ui/Loading/ProgressBar.d.ts +4 -0
  471. package/types/ui/Loading/Spin.d.ts +2 -1
  472. package/types/ui/Model/AdminPanel.d.ts +15 -3
  473. package/types/ui/Model/EditModal.d.ts +1 -1
  474. package/types/ui/Model/New.d.ts +3 -1
  475. package/types/ui/Model/NewWrapper.d.ts +2 -0
  476. package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
  477. package/types/ui/Pagination.d.ts +2 -2
  478. package/types/ui/Radio.d.ts +1 -1
  479. package/types/ui/RecentTime.d.ts +18 -1
  480. package/types/ui/Reference/Collapse.d.ts +11 -0
  481. package/types/ui/Reference/Panel.d.ts +29 -0
  482. package/types/ui/Reference/Segmented.d.ts +17 -0
  483. package/types/ui/Reference/Summary.d.ts +13 -0
  484. package/types/ui/Reference/Toolbar.d.ts +21 -0
  485. package/types/ui/Reference/dictText.d.ts +6 -0
  486. package/types/ui/Reference/index.d.ts +7 -0
  487. package/types/ui/Reference/style.d.ts +20 -0
  488. package/types/ui/Reference.d.ts +1 -0
  489. package/types/ui/ScreenNavigator.d.ts +3 -1
  490. package/types/ui/Signal/Arg.d.ts +7 -3
  491. package/types/ui/Signal/Doc.d.ts +4 -6
  492. package/types/ui/Signal/Object.d.ts +2 -1
  493. package/types/ui/Signal/RestApi.d.ts +2 -1
  494. package/types/ui/Signal/WebSocket.d.ts +2 -1
  495. package/types/ui/Signal/endpointEntries.d.ts +20 -0
  496. package/types/ui/Signal/style.d.ts +9 -8
  497. package/types/ui/System/Client.d.ts +1 -2
  498. package/types/ui/System/Common.d.ts +3 -4
  499. package/types/ui/System/Messages.d.ts +1 -1
  500. package/types/ui/Tab/Provider.d.ts +3 -1
  501. package/types/ui/Tab/context.d.ts +4 -2
  502. package/types/ui/ToggleSelect.d.ts +1 -0
  503. package/types/ui/UiOverride/context.d.ts +18 -1
  504. package/types/ui/agentAttrs.d.ts +14 -0
  505. package/types/ui/index.d.ts +22 -1
  506. package/types/ui/overlayLayer.d.ts +13 -0
  507. package/types/ui/overlayPosition.d.ts +28 -0
  508. package/types/ui/recipe/badgeRecipe.d.ts +2 -2
  509. package/types/ui/recipe/buttonRecipe.d.ts +2 -2
  510. package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
  511. package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
  512. package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
  513. package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
  514. package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
  515. package/types/vendor/use-agentic/Agentic.d.ts +21 -0
  516. package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
  517. package/types/vendor/use-agentic/Compaction.d.ts +48 -0
  518. package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
  519. package/types/vendor/use-agentic/Transcript.d.ts +18 -0
  520. package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
  521. package/types/vendor/use-agentic/index.d.ts +19 -0
  522. package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
  523. package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
  524. package/types/vendor/use-agentic/types.d.ts +182 -0
  525. package/types/vendor/use-agentic/useAgent.d.ts +4 -0
  526. package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
  527. package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
  528. package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
  529. package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
  530. package/types/vendor/use-agentic.d.ts +1 -0
  531. package/types/webkit/index.d.ts +4 -0
  532. package/types/webkit/useBodyScrollLock.d.ts +2 -0
  533. package/types/webkit/usePageTool.d.ts +19 -0
  534. package/types/webkit/useScreenScope.d.ts +25 -0
  535. package/ui/Agent/Approval.tsx +32 -0
  536. package/ui/Agent/Attach.tsx +77 -0
  537. package/ui/Agent/Bubble.tsx +192 -0
  538. package/ui/Agent/Chat.tsx +525 -0
  539. package/ui/Agent/ChatCommands.ts +141 -0
  540. package/ui/Agent/Composer.tsx +94 -0
  541. package/ui/Agent/Context.tsx +49 -0
  542. package/ui/Agent/Dock.tsx +77 -0
  543. package/ui/Agent/Guide.tsx +16 -0
  544. package/ui/Agent/History.tsx +49 -0
  545. package/ui/Agent/Launcher.tsx +60 -0
  546. package/ui/Agent/Markdown.tsx +142 -0
  547. package/ui/Agent/Menu.tsx +55 -0
  548. package/ui/Agent/Mic.tsx +27 -0
  549. package/ui/Agent/Question.tsx +63 -0
  550. package/ui/Agent/Section.tsx +24 -0
  551. package/ui/Agent/Skip.tsx +30 -0
  552. package/ui/Agent/StateKey.tsx +46 -0
  553. package/ui/Agent/Tool.tsx +59 -0
  554. package/ui/Agent/Transcript.tsx +33 -0
  555. package/ui/Agent/Zone.tsx +116 -0
  556. package/ui/Agent/agentSessionOf.ts +60 -0
  557. package/ui/Agent/attachment.ts +73 -0
  558. package/ui/Agent/fetchRunner.ts +44 -0
  559. package/ui/Agent/index.ts +27 -0
  560. package/ui/Agent/index_.tsx +4 -0
  561. package/ui/Agent/markdownBlocks.ts +137 -0
  562. package/ui/Agent/markdownSpans.tsx +49 -0
  563. package/ui/Agent/markdownTable.ts +54 -0
  564. package/ui/Agent/sessionHistory.ts +62 -0
  565. package/ui/Agent/sessionView.ts +38 -0
  566. package/ui/Agent/tokenCount.ts +10 -0
  567. package/ui/Agent/useChatAttachments.ts +84 -0
  568. package/ui/Agent/useChatVoice.ts +129 -0
  569. package/ui/Agent/useDraftRecall.ts +42 -0
  570. package/ui/Agent/useKeyboardInset.ts +26 -0
  571. package/ui/Agent/useSlashMenu.ts +58 -0
  572. package/ui/Agent/voice.ts +177 -0
  573. package/ui/Badge.tsx +1 -1
  574. package/ui/BottomSheet.tsx +32 -36
  575. package/ui/Button.tsx +3 -1
  576. package/ui/Clipboard.tsx +3 -6
  577. package/ui/Constant/Doc.tsx +265 -254
  578. package/ui/Constant/Graph.tsx +151 -0
  579. package/ui/Constant/index.ts +3 -2
  580. package/ui/Constant/schemaGraph.ts +232 -0
  581. package/ui/Data/CardList.tsx +14 -3
  582. package/ui/Data/Dashboard.tsx +70 -52
  583. package/ui/Data/Insight.tsx +18 -12
  584. package/ui/Data/Item.tsx +42 -56
  585. package/ui/Data/ListContainer.tsx +246 -132
  586. package/ui/Data/Pagination.tsx +10 -3
  587. package/ui/Data/QueryMaker.tsx +160 -11
  588. package/ui/Data/RefPicker.tsx +202 -0
  589. package/ui/Data/TableList.tsx +22 -13
  590. package/ui/Data/dataExport.ts +54 -0
  591. package/ui/Data/dataText.ts +22 -0
  592. package/ui/Data/index.ts +13 -1
  593. package/ui/Data/index_.tsx +1 -0
  594. package/ui/DatePicker.tsx +110 -128
  595. package/ui/Dialog/Close.tsx +3 -7
  596. package/ui/Dialog/LegacyModal.tsx +241 -0
  597. package/ui/Dialog/Modal.tsx +62 -195
  598. package/ui/Dialog/Provider.tsx +47 -3
  599. package/ui/Dialog/Trigger.tsx +3 -7
  600. package/ui/Dialog/context.ts +14 -2
  601. package/ui/Dialog/index.tsx +2 -0
  602. package/ui/DragAction.tsx +3 -2
  603. package/ui/DraggableList.tsx +9 -4
  604. package/ui/Dropdown.tsx +89 -27
  605. package/ui/Empty.tsx +6 -4
  606. package/ui/Field.tsx +128 -58
  607. package/ui/Input.tsx +27 -5
  608. package/ui/KeyboardAvoiding.tsx +2 -2
  609. package/ui/Layout/BottomTab.tsx +32 -37
  610. package/ui/Layout/Sider.tsx +37 -14
  611. package/ui/LegacyModal.tsx +53 -0
  612. package/ui/Link/CsrLink.tsx +1 -1
  613. package/ui/Load/Pagination.tsx +15 -8
  614. package/ui/Load/Units.tsx +30 -7
  615. package/ui/Load/View.tsx +10 -3
  616. package/ui/Loading/Area.tsx +7 -6
  617. package/ui/Loading/Button.tsx +7 -9
  618. package/ui/Loading/Input.tsx +7 -9
  619. package/ui/Loading/ProgressBar.tsx +16 -7
  620. package/ui/Loading/Skeleton.tsx +8 -13
  621. package/ui/Loading/Spin.tsx +20 -14
  622. package/ui/Menu.tsx +1 -1
  623. package/ui/Model/AdminPanel.tsx +52 -12
  624. package/ui/Model/EditModal.tsx +28 -6
  625. package/ui/Model/EditWrapper.tsx +16 -4
  626. package/ui/Model/New.tsx +4 -0
  627. package/ui/Model/NewWrapper.tsx +2 -0
  628. package/ui/Model/NewWrapper_Client.tsx +20 -6
  629. package/ui/Model/Remove.tsx +18 -6
  630. package/ui/Model/RemoveWrapper.tsx +12 -2
  631. package/ui/Model/SureToRemove.tsx +18 -6
  632. package/ui/Model/ViewEditModal.tsx +64 -15
  633. package/ui/Model/ViewModal.tsx +25 -11
  634. package/ui/Model/ViewWrapper.tsx +15 -4
  635. package/ui/Model/index_.tsx +1 -1
  636. package/ui/Pagination.tsx +51 -66
  637. package/ui/Popconfirm.tsx +88 -78
  638. package/ui/Radio.tsx +53 -24
  639. package/ui/RecentTime.tsx +83 -35
  640. package/ui/Reference/Collapse.tsx +26 -0
  641. package/ui/Reference/Panel.tsx +79 -0
  642. package/ui/Reference/Segmented.tsx +41 -0
  643. package/ui/Reference/Summary.tsx +25 -0
  644. package/ui/Reference/Toolbar.tsx +44 -0
  645. package/ui/Reference/dictText.ts +9 -0
  646. package/ui/Reference/index.ts +7 -0
  647. package/ui/Reference/style.ts +45 -0
  648. package/ui/ScreenNavigator.tsx +17 -2
  649. package/ui/Select.tsx +96 -57
  650. package/ui/Signal/Arg.tsx +83 -68
  651. package/ui/Signal/Doc.tsx +163 -129
  652. package/ui/Signal/Listener.tsx +40 -29
  653. package/ui/Signal/Message.tsx +87 -135
  654. package/ui/Signal/Object.tsx +79 -57
  655. package/ui/Signal/PubSub.tsx +72 -113
  656. package/ui/Signal/Request.tsx +2 -22
  657. package/ui/Signal/Response.tsx +19 -45
  658. package/ui/Signal/RestApi.tsx +170 -200
  659. package/ui/Signal/WebSocket.tsx +29 -26
  660. package/ui/Signal/endpointEntries.ts +59 -0
  661. package/ui/Signal/makeExample.ts +10 -3
  662. package/ui/Signal/style.ts +34 -29
  663. package/ui/Switch.tsx +4 -0
  664. package/ui/System/CSR.tsx +1 -1
  665. package/ui/System/Client.tsx +31 -15
  666. package/ui/System/Common.tsx +3 -4
  667. package/ui/System/DevModeToggle.tsx +1 -1
  668. package/ui/System/Gtag.tsx +2 -2
  669. package/ui/System/Messages.tsx +52 -31
  670. package/ui/System/Reconnect.tsx +22 -56
  671. package/ui/System/SelectLanguage.tsx +24 -15
  672. package/ui/System/ThemeToggle.tsx +25 -13
  673. package/ui/Tab/Menu.tsx +24 -12
  674. package/ui/Tab/Menus.tsx +6 -3
  675. package/ui/Tab/Provider.tsx +30 -3
  676. package/ui/Tab/context.ts +8 -4
  677. package/ui/Table.tsx +66 -60
  678. package/ui/ToggleSelect.tsx +8 -7
  679. package/ui/Tooltip.tsx +15 -1
  680. package/ui/UiOverride/context.ts +21 -2
  681. package/ui/Unauthorized.tsx +6 -4
  682. package/ui/agentAttrs.ts +19 -0
  683. package/ui/index.ts +49 -1
  684. package/ui/overlayLayer.ts +12 -2
  685. package/ui/overlayPosition.ts +104 -0
  686. package/ui/recipe/buttonRecipe.ts +2 -2
  687. package/ui/styles.css +31 -0
  688. package/vendor/use-agentic/AgentAbort.ts +29 -0
  689. package/vendor/use-agentic/AgentProgress.ts +40 -0
  690. package/vendor/use-agentic/AgentProvider.tsx +39 -0
  691. package/vendor/use-agentic/AgentScope.tsx +20 -0
  692. package/vendor/use-agentic/AgentSession.ts +750 -0
  693. package/vendor/use-agentic/Agentic.tsx +44 -0
  694. package/vendor/use-agentic/AgenticSurface.ts +333 -0
  695. package/vendor/use-agentic/Compaction.ts +120 -0
  696. package/vendor/use-agentic/ToolOutput.ts +60 -0
  697. package/vendor/use-agentic/Transcript.ts +50 -0
  698. package/vendor/use-agentic/WIRE.md +86 -0
  699. package/vendor/use-agentic/httpRunner.ts +131 -0
  700. package/vendor/use-agentic/index.ts +20 -0
  701. package/vendor/use-agentic/sharedContext.ts +25 -0
  702. package/vendor/use-agentic/surfaceContext.ts +10 -0
  703. package/vendor/use-agentic/types.ts +192 -0
  704. package/vendor/use-agentic/useAgent.ts +18 -0
  705. package/vendor/use-agentic/useAgentGuide.ts +16 -0
  706. package/vendor/use-agentic/useAgentResource.ts +36 -0
  707. package/vendor/use-agentic/useAgentState.ts +64 -0
  708. package/vendor/use-agentic/useAgentTool.ts +55 -0
  709. package/webkit/bootCsr.tsx +10 -8
  710. package/webkit/index.ts +4 -0
  711. package/webkit/lazy.tsx +5 -1
  712. package/webkit/useBodyScrollLock.tsx +29 -0
  713. package/webkit/useFrameRuntime.ts +1 -1
  714. package/webkit/usePageTool.tsx +37 -0
  715. package/webkit/useScreenScope.tsx +60 -0
  716. package/types/ui/Constant/Mermaid.d.ts +0 -8
  717. package/types/ui/Signal/Collapse.d.ts +0 -12
  718. package/ui/Constant/Mermaid.tsx +0 -149
  719. package/ui/Signal/Collapse.tsx +0 -29
package/signal/slice.ts CHANGED
@@ -1,9 +1,9 @@
1
- import { Any, type Assign, type Cls, type MergeAllKeyOfObjects, SLICE_DICT_SHAPE, SLICE_META } from "akanjs/base";
1
+ import { Any, type Assign, type MergeAllKeyOfObjects, SLICE_DICT_SHAPE, SLICE_META } from "akanjs/base";
2
2
  import { applyMixins } from "akanjs/common";
3
- import type { DocumentModel, QueryOf } from "akanjs/constant";
4
- import type { FilterInstance } from "akanjs/document";
3
+ import { type FilterInstance, FilterQueryError, resolveFilterQuery } from "akanjs/document";
5
4
  import { type Adaptor, type AdaptorCls, dangerouslyAdapt, type ServiceModel } from "akanjs/service";
6
- import type { Guard, GuardCls } from "./guard";
5
+ import { Exception } from "./exception";
6
+ import type { GuardCls } from "./guard";
7
7
  import {
8
8
  buildSlice,
9
9
  type SliceBuilder,
@@ -38,21 +38,42 @@ export type SliceCls<
38
38
  createGuards: GuardCls[];
39
39
  updateGuards: GuardCls[];
40
40
  removeGuards: GuardCls[];
41
+ mcp: ResolvedSliceMcp;
41
42
  };
42
43
 
44
+ /** The generated verbs, resolved to a plain answer each. `root` is not here: it rides on the root slice itself. */
45
+ export interface ResolvedSliceMcp {
46
+ get: boolean;
47
+ create: boolean;
48
+ update: boolean;
49
+ remove: boolean;
50
+ }
51
+
43
52
  interface RootSliceOption {
44
53
  guards?: {
45
- root?: Cls<Guard> | Cls<Guard>[];
46
- get?: Cls<Guard> | Cls<Guard>[];
47
- cru?: Cls<Guard> | Cls<Guard>[];
48
- create?: Cls<Guard> | Cls<Guard>[];
49
- update?: Cls<Guard> | Cls<Guard>[];
50
- remove?: Cls<Guard> | Cls<Guard>[];
54
+ root?: GuardCls | GuardCls[];
55
+ get?: GuardCls | GuardCls[];
56
+ cru?: GuardCls | GuardCls[];
57
+ create?: GuardCls | GuardCls[];
58
+ update?: GuardCls | GuardCls[];
59
+ remove?: GuardCls | GuardCls[];
51
60
  };
61
+ /**
62
+ * Which of the entries this call generates belong on an agent's shelf. Keyed exactly like `guards` above and
63
+ * scoped to exactly what `guards` governs — the root slice and the generated CRUD — so `false` here narrows the
64
+ * catalogue and nothing else. `create`/`update`/`remove` fall back to `cru` the same way their guards do, and
65
+ * the bare `false` is every key at once.
66
+ *
67
+ * A named slice and a custom endpoint declare their own `mcp` in their own signal option, exactly as they
68
+ * declare their own guards. This is curation, not authorization: HTTP is unchanged.
69
+ */
70
+ mcp?:
71
+ | boolean
72
+ | { root?: boolean; get?: boolean; cru?: boolean; create?: boolean; update?: boolean; remove?: boolean };
52
73
  prefix?: string;
53
74
  }
54
75
 
55
- type RootSliceQuery<SrvModule extends ServiceModel, Full = CnstFull<SrvModule>> = QueryOf<DocumentModel<Full>>;
76
+ type RootSliceQueryKey<Filter extends FilterInstance> = Extract<keyof Filter["query"], string>;
56
77
 
57
78
  type ExtendSliceInfoObj<
58
79
  SrvModule extends ServiceModel,
@@ -91,7 +112,7 @@ export function slice<
91
112
  _Light = CnstLight<SrvModule>,
92
113
  _Insight = CnstInsight<SrvModule>,
93
114
  _Filter extends FilterInstance = DbFilter<SrvModule>,
94
- _Query = RootSliceQuery<SrvModule, _Full>,
115
+ _QueryKey extends string = RootSliceQueryKey<_Filter>,
95
116
  >(
96
117
  srv: SrvModule,
97
118
  option: RootSliceOption,
@@ -111,25 +132,19 @@ export function slice<
111
132
  _Insight,
112
133
  _Filter,
113
134
  SrvMap<SrvModule>,
114
- ["query"],
115
- [query?: _Query | null],
135
+ ["queryKey", "args"],
136
+ [queryKey?: _QueryKey | null, args?: unknown[] | null],
116
137
  [],
117
- [_Query]
138
+ [_QueryKey | undefined, unknown[] | undefined]
118
139
  >;
119
140
  }
120
141
  : ExtendSliceInfoObj<SrvModule, LibSlices>
121
142
  >
122
143
  > {
123
144
  if (!srv.cnst || !srv.db) throw new Error("cnst and db are required");
124
- const init = buildSlice(
125
- srv.srv.refName,
126
- srv.cnst.input,
127
- srv.cnst.full,
128
- srv.cnst.light,
129
- srv.cnst.insight,
130
- srv.db.filter,
131
- );
132
- const toGuards = (guard?: Cls<Guard> | Cls<Guard>[]) => (guard ? (Array.isArray(guard) ? guard : [guard]) : []);
145
+ const filterRef = srv.db.filter;
146
+ const init = buildSlice(srv.srv.refName, srv.cnst.input, srv.cnst.full, srv.cnst.light, srv.cnst.insight, filterRef);
147
+ const toGuards = (guard?: GuardCls | GuardCls[]) => (guard ? (Array.isArray(guard) ? guard : [guard]) : []);
133
148
  const rootGuards = toGuards(option.guards?.root);
134
149
  const getGuards = toGuards(option.guards?.get);
135
150
  const cruGuards = toGuards(option.guards?.cru);
@@ -137,6 +152,15 @@ export function slice<
137
152
  const createGuards = option.guards?.create ? toGuards(option.guards.create) : cruGuards;
138
153
  const updateGuards = option.guards?.update ? toGuards(option.guards.update) : cruGuards;
139
154
  const removeGuards = option.guards?.remove ? toGuards(option.guards.remove) : cruGuards;
155
+ const mcpOption =
156
+ typeof option.mcp === "boolean" ? { root: option.mcp, get: option.mcp, cru: option.mcp } : option.mcp;
157
+ const cruMcp = mcpOption?.cru !== false;
158
+ const mcp: ResolvedSliceMcp = {
159
+ get: mcpOption?.get !== false,
160
+ create: mcpOption?.create ?? cruMcp,
161
+ update: mcpOption?.update ?? cruMcp,
162
+ remove: mcpOption?.remove ?? cruMcp,
163
+ };
140
164
  const srvKeys = [
141
165
  ...new Set([...Object.keys(srv.srvMap), ...libSlices.flatMap((libSlice) => Object.keys(libSlice.srv.srvMap))]),
142
166
  ];
@@ -150,11 +174,22 @@ export function slice<
150
174
  static createGuards = createGuards;
151
175
  static updateGuards = updateGuards;
152
176
  static removeGuards = removeGuards;
177
+ static mcp = mcp;
153
178
  static [SLICE_META] = Object.assign(
154
179
  {
155
- [""]: init({ guards: rootGuards })
156
- .search<"query", object>("query", Any)
157
- .exec((query) => query ?? {}),
180
+
181
+ [""]: init({ guards: rootGuards, ...(mcpOption?.root === false ? { mcp: false } : {}) })
182
+ .search<"queryKey", string>("queryKey", String)
183
+ .search<"args", unknown[]>("args", Any)
184
+ .exec((queryKey, args) => {
185
+ try {
186
+ return resolveFilterQuery(filterRef, queryKey, args);
187
+ } catch (error) {
188
+
189
+ if (error instanceof FilterQueryError) throw new Exception.BadRequest(error.message);
190
+ throw error;
191
+ }
192
+ }),
158
193
  },
159
194
  sliceBuilder(init as Parameters<BuildSlice>[0]),
160
195
  );
package/signal/trace.ts CHANGED
@@ -1,17 +1,31 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { timingSafeEqual } from "node:crypto";
3
+ import {
4
+ type LogAttrs,
5
+ type LogFlightRecorder,
6
+ Logger,
7
+ type LogRecord,
8
+ logSeverity,
9
+ registerLogContextReader,
10
+ } from "akanjs/common";
2
11
 
3
12
  /**
4
- * Lightweight request tracing for Akan signals.
13
+ * Request tracing for Akan signals, in two modes.
5
14
  *
6
- * Everything here is gated behind the `AKAN_TRACE=1` environment flag so that the
7
- * production hot path pays nothing when tracing is disabled (see {@link isTraceEnabled}).
8
- * The goal is internal performance work (per-stage latency breakdown, query counts,
9
- * cache hit ratio) rather than full distributed tracing.
15
+ * `context` is on by default, production included: it carries only the identity a log record needs
16
+ * (`traceId`, endpoint, origin) and costs one `als.run` per call (~25ns measured). `AKAN_LOG_CONTEXT=0` is
17
+ * the emergency exit. `full` adds the per-stage spans, query counts and cache ratio the metrics endpoint
18
+ * aggregates, and stays behind `AKAN_TRACE=1` because those are for performance work, not for every request.
19
+ *
20
+ * Two opt-ins ride the same trace: the canonical request line (`AKAN_LOG_CANONICAL`) summarizes every call as
21
+ * one record at its end, and the flight recorder (`AKAN_LOG_FLIGHT`) keeps the call's own sub-level records
22
+ * and promotes them only when the call failed or ran long.
10
23
  */
11
24
 
12
25
  let traceEnabledCache: boolean | null = null;
26
+ let logContextEnabledCache: boolean | null = null;
13
27
 
14
- /** Whether request tracing is enabled. Cached after first read. */
28
+ /** Whether full request tracing (`AKAN_TRACE=1`) is enabled. Cached after first read. */
15
29
  export const isTraceEnabled = (): boolean => {
16
30
  if (traceEnabledCache === null) traceEnabledCache = process.env.AKAN_TRACE === "1";
17
31
  return traceEnabledCache;
@@ -22,63 +36,277 @@ export const setTraceEnabled = (enabled: boolean): void => {
22
36
  traceEnabledCache = enabled;
23
37
  };
24
38
 
39
+ export const isLogContextEnabled = (): boolean => {
40
+ if (logContextEnabledCache === null)
41
+ logContextEnabledCache = !(process.env.AKAN_LOG_CONTEXT === "0" || process.env.AKAN_LOG_CONTEXT === "false");
42
+ return logContextEnabledCache;
43
+ };
44
+
45
+ export const setLogContextEnabled = (enabled: boolean): void => {
46
+ logContextEnabledCache = enabled;
47
+ };
48
+
49
+ export type CanonicalLineMode = "off" | "all" | "slow";
50
+
51
+ const isOn = (value: string | undefined) => value === "1" || value === "true";
52
+
53
+ let canonicalModeCache: CanonicalLineMode | null = null;
54
+ /** `AKAN_LOG_CANONICAL`: `1`/`all` writes one line per call, `slow` only for a failed or over-threshold call. */
55
+ export const getCanonicalLineMode = (): CanonicalLineMode => {
56
+ if (canonicalModeCache === null) {
57
+ const value = process.env.AKAN_LOG_CANONICAL;
58
+ canonicalModeCache = value === "slow" ? "slow" : isOn(value) || value === "all" ? "all" : "off";
59
+ }
60
+ return canonicalModeCache;
61
+ };
62
+ export const setCanonicalLineMode = (mode: CanonicalLineMode): void => {
63
+ canonicalModeCache = mode;
64
+ };
65
+
66
+ let flightEnabledCache: boolean | null = null;
67
+ export const isFlightRecorderEnabled = (): boolean => {
68
+ if (flightEnabledCache === null) flightEnabledCache = isOn(process.env.AKAN_LOG_FLIGHT);
69
+ return flightEnabledCache;
70
+ };
71
+ export const setFlightRecorderEnabled = (enabled: boolean): void => {
72
+ flightEnabledCache = enabled;
73
+ refreshLoggerContextGate();
74
+ };
75
+
76
+ let flightThresholdCache: number | null = null;
77
+ /** `AKAN_LOG_FLIGHT_MS`: a call at least this long is "slow" for both the recorder and the `slow` canonical mode. */
78
+ export const getFlightThresholdMs = (): number => {
79
+ if (flightThresholdCache === null) {
80
+ const value = Number(process.env.AKAN_LOG_FLIGHT_MS);
81
+ flightThresholdCache = Number.isFinite(value) && value > 0 ? value : 1_000;
82
+ }
83
+ return flightThresholdCache;
84
+ };
85
+ export const setFlightThresholdMs = (ms: number): void => {
86
+ flightThresholdCache = ms;
87
+ };
88
+
89
+ /**
90
+ * `x-akan-debug` lowers one request's log floor to `trace`. Honoured in `local` unconditionally, and elsewhere only
91
+ * when the header carries the value of `AKAN_LOG_DEBUG_HEADER`: a client that can lower a server's log level is a
92
+ * log-volume vector, so outside development it has to prove it was told the secret.
93
+ */
94
+ export const isDebugHeaderAllowed = (): boolean =>
95
+ process.env.AKAN_PUBLIC_ENV === "local" || !!process.env.AKAN_LOG_DEBUG_HEADER;
96
+
97
+ const refreshLoggerContextGate = () => {
98
+ Logger.contextGate = isFlightRecorderEnabled() || isDebugHeaderAllowed();
99
+ };
100
+
25
101
  export interface SpanRecord {
26
102
  name: string;
27
103
  durationMs: number;
28
104
  }
29
105
 
106
+ export type TraceMode = "context" | "full";
107
+ export type TraceOrigin = "http" | "websocket" | "mcp" | "internal" | "page";
108
+ export type TraceOutcome = "ok" | "error";
109
+
30
110
  const MAX_SPANS_PER_TRACE = 64;
111
+ /** Per call; 64 lines is a whole request at `trace` for anything short of a loop that logs per row. */
112
+ const FLIGHT_RING_SIZE = 64;
113
+ const CANONICAL_ERROR_CHARS = 200;
114
+
115
+ interface FlightEntry {
116
+ record: LogRecord;
117
+ written: boolean;
118
+ }
31
119
 
32
120
  /** Per-request trace context. Threaded via {@link AsyncLocalStorage}. */
33
121
  export class SignalTrace {
122
+ /** Total captured records the process holds at once (`AKAN_LOG_FLIGHT_MAX`); a call past it runs unrecorded. */
123
+ static readonly defaultFlightMaxRecords = 65_536;
124
+ static #activeFlights = 0;
125
+ static #flightMaxTraces: number | null = null;
126
+
34
127
  readonly traceId: string;
35
128
  readonly endpointKey: string;
36
129
  readonly endpointType: string;
130
+ readonly origin: TraceOrigin;
131
+ readonly mode: TraceMode;
37
132
  readonly startedAt: number;
38
133
  readonly spans: SpanRecord[] = [];
134
+ /** What the canonical line carries beyond timing — `userId` once the caller is known. */
135
+ readonly attrs: LogAttrs = {};
39
136
  dbQueryCount = 0;
40
137
  dbQueryMs = 0;
41
138
  cacheHits = 0;
42
139
  cacheMisses = 0;
43
140
  dataLoaderBatchCount = 0;
44
141
  dataLoaderKeyCount = 0;
142
+ outcome: TraceOutcome | null = null;
143
+ status: number | null = null;
144
+ error: unknown = null;
145
+ debugSev: number | null = null;
146
+ flight: LogFlightRecorder | null = null;
147
+ #flightRing: FlightEntry[] | null = null;
148
+ #flightEvicted = 0;
45
149
  #finalized = false;
46
150
 
47
- constructor(endpointKey: string, endpointType: string) {
151
+ constructor(
152
+ endpointKey: string,
153
+ endpointType: string,
154
+ { mode = "full", origin = "http" }: { mode?: TraceMode; origin?: TraceOrigin } = {},
155
+ ) {
48
156
  this.endpointKey = endpointKey;
49
157
  this.endpointType = endpointType;
158
+ this.mode = mode;
159
+ this.origin = origin;
50
160
  this.startedAt = performance.now();
51
161
  this.traceId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
52
162
  }
53
163
 
164
+ /** The trace a call runs under given what is switched on, or `null` when both modes are off. */
165
+ static create(endpointKey: string, endpointType: string, origin: TraceOrigin): SignalTrace | null {
166
+ const trace = isTraceEnabled()
167
+ ? new SignalTrace(endpointKey, endpointType, { mode: "full", origin })
168
+ : isLogContextEnabled()
169
+ ? new SignalTrace(endpointKey, endpointType, { mode: "context", origin })
170
+ : null;
171
+ if (trace && isFlightRecorderEnabled()) trace.startFlightRecorder();
172
+ return trace;
173
+ }
174
+
175
+ static get activeFlights() {
176
+ return SignalTrace.#activeFlights;
177
+ }
178
+
179
+ static #flightMaxTracesFromEnv() {
180
+ if (SignalTrace.#flightMaxTraces === null) {
181
+ const value = Number(process.env.AKAN_LOG_FLIGHT_MAX);
182
+ const max = Number.isFinite(value) && value > 0 ? value : SignalTrace.defaultFlightMaxRecords;
183
+ SignalTrace.#flightMaxTraces = Math.max(1, Math.floor(max / FLIGHT_RING_SIZE));
184
+ }
185
+ return SignalTrace.#flightMaxTraces;
186
+ }
187
+
188
+ get endpoint() {
189
+ return `${this.endpointType}:${this.endpointKey}`;
190
+ }
191
+
192
+ /** Attaches the ring unless the process is already holding its cap; a trace past the cap simply is not recorded. */
193
+ startFlightRecorder(): boolean {
194
+ if (this.#flightRing || this.#finalized) return !!this.#flightRing;
195
+ if (SignalTrace.#activeFlights >= SignalTrace.#flightMaxTracesFromEnv()) return false;
196
+ SignalTrace.#activeFlights += 1;
197
+ this.#flightRing = [];
198
+ this.flight = { minSev: logSeverity.trace, capture: (record, written) => this.#capture(record, written) };
199
+ return true;
200
+ }
201
+
202
+ /** Honours `x-akan-debug` for this call when the deployment allows it; anything else is ignored, not refused. */
203
+ applyDebugHeader(value: string | null | undefined): boolean {
204
+ if (!value) return false;
205
+ const secret = process.env.AKAN_LOG_DEBUG_HEADER;
206
+ const allowed =
207
+ process.env.AKAN_PUBLIC_ENV === "local" ||
208
+ (!!secret && value.length === secret.length && timingSafeEqual(Buffer.from(value), Buffer.from(secret)));
209
+ if (!allowed) return false;
210
+ this.debugSev = logSeverity.trace;
211
+ return true;
212
+ }
213
+
214
+ setAttr(key: string, value: LogAttrs[string]): void {
215
+ this.attrs[key] = value;
216
+ }
217
+
54
218
  recordSpan(name: string, durationMs: number): void {
55
- if (this.spans.length >= MAX_SPANS_PER_TRACE) return;
219
+ if (this.mode !== "full" || this.spans.length >= MAX_SPANS_PER_TRACE) return;
56
220
  this.spans.push({ name, durationMs });
57
221
  }
58
222
 
59
223
  countDbQuery(durationMs: number): void {
224
+ if (this.mode !== "full") return;
60
225
  this.dbQueryCount += 1;
61
226
  this.dbQueryMs += durationMs;
62
227
  }
63
228
 
64
229
  countCache(hit: boolean): void {
230
+ if (this.mode !== "full") return;
65
231
  if (hit) this.cacheHits += 1;
66
232
  else this.cacheMisses += 1;
67
233
  }
68
234
 
69
235
  countDataLoaderBatch(keyCount: number): void {
236
+ if (this.mode !== "full") return;
70
237
  this.dataLoaderBatchCount += 1;
71
238
  this.dataLoaderKeyCount += keyCount;
72
239
  }
73
240
 
241
+ fail(error: unknown): void {
242
+ this.outcome = "error";
243
+ this.error = error;
244
+ const statusCode = (error as { statusCode?: unknown } | null)?.statusCode;
245
+ this.status = typeof statusCode === "number" ? statusCode : 500;
246
+ }
247
+
74
248
  finalize(): void {
75
249
  if (this.#finalized) return;
76
250
  this.#finalized = true;
251
+ this.outcome ??= "ok";
252
+ this.status ??= 200;
77
253
  const totalMs = performance.now() - this.startedAt;
254
+
255
+ this.#flushFlight(totalMs);
256
+ this.#emitCanonicalLine(totalMs);
257
+ if (this.mode !== "full") return;
78
258
  this.recordSpan("total", totalMs);
79
259
  traceAggregator.ingest(this);
80
260
  maybeFlushTraceFile();
81
261
  }
262
+
263
+ #capture(record: LogRecord, written: boolean) {
264
+ const ring = this.#flightRing;
265
+ if (!ring || this.#finalized) return;
266
+ if (ring.length >= FLIGHT_RING_SIZE) {
267
+ ring.shift();
268
+ this.#flightEvicted += 1;
269
+ }
270
+ ring.push({ record, written });
271
+ }
272
+
273
+ #flushFlight(totalMs: number) {
274
+ const ring = this.#flightRing;
275
+ if (!ring) return;
276
+ this.#flightRing = null;
277
+ this.flight = null;
278
+ SignalTrace.#activeFlights -= 1;
279
+ if (this.outcome !== "error" && totalMs < getFlightThresholdMs()) return;
280
+ const pending = ring.filter((entry) => !entry.written).map((entry) => entry.record);
281
+ if (pending.length) Logger.replay(pending, { evicted: this.#flightEvicted });
282
+ }
283
+
284
+ #emitCanonicalLine(totalMs: number) {
285
+ const mode = getCanonicalLineMode();
286
+ if (mode === "off") return;
287
+ const failed = this.outcome === "error";
288
+ if (mode === "slow" && !failed && totalMs < getFlightThresholdMs()) return;
289
+ const attrs: LogAttrs = { ms: Math.round(totalMs * 10) / 10, status: this.status ?? 200, ...this.attrs };
290
+ if (this.mode === "full") {
291
+ attrs.db = this.dbQueryCount;
292
+ attrs.dbMs = Math.round(this.dbQueryMs * 10) / 10;
293
+ const lookups = this.cacheHits + this.cacheMisses;
294
+ if (lookups) attrs.cacheHit = Math.round((this.cacheHits / lookups) * 100) / 100;
295
+ }
296
+ if (failed) attrs.err = SignalTrace.#describeError(this.error);
297
+ Logger.emit({
298
+ level: failed ? "warn" : "info",
299
+ name: "Signal",
300
+ message: `${this.outcome} ${this.endpoint}`,
301
+ attrs,
302
+ });
303
+ }
304
+
305
+ static #describeError(error: unknown): string {
306
+ const text = error instanceof Error ? error.message : String(error);
307
+ const line = text.split("\n")[0] ?? "";
308
+ return line.length > CANONICAL_ERROR_CHARS ? `${line.slice(0, CANONICAL_ERROR_CHARS)}…` : line;
309
+ }
82
310
  }
83
311
 
84
312
  const traceProcessStore = process as unknown as {
@@ -98,13 +326,44 @@ export const getCurrentTrace = (): SignalTrace | undefined => als.getStore();
98
326
  /** Run `fn` with `trace` as the ambient request trace. */
99
327
  export const runWithTrace = <T>(trace: SignalTrace, fn: () => T): T => als.run(trace, fn);
100
328
 
329
+ /**
330
+ * Run `fn` as the whole life of `trace`: a throw marks the outcome before it propagates, and the trace is
331
+ * finalized after the caller's own catch has run — which is what lets an error log carry the traceId.
332
+ */
333
+ export const runTraced = async <T>(trace: SignalTrace | null, fn: () => Promise<T>): Promise<T> => {
334
+ if (!trace) return await fn();
335
+ return await als.run(trace, async () => {
336
+ try {
337
+ return await fn();
338
+ } catch (error) {
339
+ trace.fail(error);
340
+ throw error;
341
+ } finally {
342
+ trace.finalize();
343
+ }
344
+ });
345
+ };
346
+
347
+ registerLogContextReader(() => {
348
+ const trace = als.getStore();
349
+ if (!trace) return undefined;
350
+ return {
351
+ traceId: trace.traceId,
352
+ endpoint: trace.endpoint,
353
+ origin: trace.origin,
354
+ flight: trace.flight,
355
+ debugSev: trace.debugSev,
356
+ };
357
+ });
358
+ refreshLoggerContextGate();
359
+
101
360
  /**
102
361
  * Time an async stage under the current trace. When tracing is off (or no trace is
103
362
  * active) this is a thin passthrough with no measurement overhead.
104
363
  */
105
364
  export const traceSpan = async <T>(name: string, fn: () => Promise<T>): Promise<T> => {
106
365
  const trace = getCurrentTrace();
107
- if (!trace) return await fn();
366
+ if (trace?.mode !== "full") return await fn();
108
367
  const start = performance.now();
109
368
  try {
110
369
  return await fn();
package/signal/types.ts CHANGED
@@ -12,9 +12,9 @@ export type SrvMap<S extends ServiceModel> = S["srvMap"];
12
12
 
13
13
  export type CnstRefName<S extends ServiceModel> = CnstOf<S>["refName"];
14
14
  export type CnstInput<S extends ServiceModel> = CnstOf<S>["_Input"];
15
- export type CnstFull<S extends ServiceModel> = UnCls<CnstOf<S>["full"]> & CnstOf<S>["_Full"];
16
- export type CnstLight<S extends ServiceModel> = UnCls<CnstOf<S>["light"]> & CnstOf<S>["_Light"];
17
- export type CnstInsight<S extends ServiceModel> = UnCls<CnstOf<S>["insight"]> & CnstOf<S>["_Insight"];
15
+ export type CnstFull<S extends ServiceModel> = CnstOf<S>["_Full"];
16
+ export type CnstLight<S extends ServiceModel> = CnstOf<S>["_Light"];
17
+ export type CnstInsight<S extends ServiceModel> = CnstOf<S>["_Insight"];
18
18
  export type CnstDefault<S extends ServiceModel> = CnstOf<S>["_Default"];
19
19
  export type CnstDefaultInput<S extends ServiceModel> = CnstOf<S>["_DefaultInput"];
20
20
  export type CnstDefaultState<S extends ServiceModel> = CnstOf<S>["_DefaultState"];
@@ -61,6 +61,8 @@ interface TimerOption {
61
61
  enabled?: boolean;
62
62
  }
63
63
 
64
+ export type HttpMutationMethod = "POST" | "PATCH" | "PUT" | "DELETE";
65
+
64
66
  export interface SignalOption<Response = any, Nullable extends boolean = false, _Key = keyof UnCls<Response>>
65
67
  extends InitOption,
66
68
  TimerOption {
@@ -76,8 +78,31 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
76
78
  middlewares?: MiddlewareCls[];
77
79
  prefix?: false | string;
78
80
  globalPrefix?: false;
81
+ /**
82
+ * HTTP verb for a `mutation`, `POST` unless named. Only a foreign wire protocol needs the others — a client
83
+ * that cannot be changed and sends `PATCH /rest/v1/<table>`. Every other endpoint type ignores it.
84
+ */
85
+ method?: HttpMutationMethod;
79
86
  /** Marks this mutation as the framework file-upload endpoint (see resolveFileUploadCapability). */
80
87
  fileUpload?: boolean;
88
+ /**
89
+ * Whether this endpoint belongs on an agent's shelf. `true` — the default — publishes it to MCP subject to the
90
+ * guard and shape rules; `false` keeps it out of the catalogue entirely.
91
+ *
92
+ * This is curation, not authorization: HTTP serves the endpoint exactly as before, and the guards are still the
93
+ * only thing deciding who may call it. Write it where an endpoint is perfectly guarded and still has no business
94
+ * on a shelf — a step of a UI-driven state machine (`requestPhoneCodeForSignin`), or a read a model would only
95
+ * ever call by mistake. Every catalogue entry carries the model schemas it mentions, so one endpoint dropped
96
+ * here is kilobytes off every `tools/list`.
97
+ */
98
+ mcp?: boolean;
99
+ /**
100
+ * What a `pubsub(Binary)` does when a subscriber cannot keep up. `"coalesce"` (the default) keeps only the
101
+ * newest frame per room, which is what a telemetry or video stream wants — an old frame is worthless once a
102
+ * newer one exists. Name `"queue"` when the frames are a sequence a subscriber has to see in full, such as
103
+ * deltas against a base it already holds; the send buffer then grows with the slowest subscriber.
104
+ */
105
+ backpressure?: "coalesce" | "queue";
81
106
 
82
107
  scheduleType?: "init" | "destroy" | "cron" | "interval" | "timeout";
83
108
  scheduleCron?: string;
@@ -92,7 +117,15 @@ interface SerializedSignalOption {
92
117
  prefix?: false | string;
93
118
  globalPrefix?: false;
94
119
  guards?: string[];
120
+ method?: HttpMutationMethod;
95
121
  fileUpload?: boolean;
122
+ /**
123
+ * Only ever `false`, and only when something declared it: `true` is the default, so serializing it would ship a
124
+ * field per endpoint that says nothing. Resolved here rather than left to the reader because the browser API
125
+ * explorer has guard *names* and no classes, and a second implementation of the rule would eventually disagree
126
+ * with the catalogue.
127
+ */
128
+ mcp?: false;
96
129
  }
97
130
  export interface SerializedSlice extends SerializedSignalOption {}
98
131
 
@@ -112,12 +145,17 @@ export interface SerializedArg {
112
145
  nullable?: boolean;
113
146
  example?: string | number | boolean | Date;
114
147
  enum?: string;
148
+ /** The values this arg accepts, when they are a fixed list the caller has to pick from. */
149
+ oneOf?: (string | number)[];
150
+ /** For an id a filter declared against a model: the model it points at, so a UI can offer a picker. */
151
+ ref?: string;
115
152
  }
116
153
  export interface SerializedEndpoint extends SerializedSignalOption {
117
- type: "query" | "mutation" | "pubsub" | "message";
154
+ type: "query" | "mutation" | "pubsub" | "message" | "prompt";
118
155
  returns: SerializedReturns;
119
156
  }
120
157
  export interface SerializedFilter {
158
+ /** Every filter query the model declares, by key, with the args each one takes. */
121
159
  filter: { [key: string]: SerializedArg[] };
122
160
  sortKeys: string[];
123
161
  }
@@ -132,6 +170,19 @@ export interface SerializedSignal {
132
170
  createGuards?: string[];
133
171
  updateGuards?: string[];
134
172
  removeGuards?: string[];
173
+ /**
174
+ * Which generated CRUD verbs this model keeps off the agent shelf. Carried on the signal because the endpoints
175
+ * it names do not exist until `FetchClient.getBaseEndpoint` synthesizes them. Only the `false` keys travel.
176
+ */
177
+ mcp?: SerializedSignalMcp;
178
+ }
179
+
180
+ /** Keyed by generated verb, mirroring the `guards` map `slice()` takes. The root slice's own flag rides on `slice[""]`. */
181
+ export interface SerializedSignalMcp {
182
+ get?: false;
183
+ create?: false;
184
+ update?: false;
185
+ remove?: false;
135
186
  }
136
187
 
137
188
  export type SignalType = "restapi" | "websocket";