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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (719) hide show
  1. package/CHANGELOG.md +103 -0
  2. package/README.ko.md +1 -1
  3. package/README.md +1 -1
  4. package/base/baseEnv.ts +7 -4
  5. package/base/primitiveRegistry.ts +59 -12
  6. package/base/symbols.ts +4 -0
  7. package/client/capacitor.ts +34 -0
  8. package/client/clientRuntime.ts +5 -0
  9. package/client/csrTypes.ts +4 -3
  10. package/client/index.ts +1 -0
  11. package/client/locale.ts +2 -2
  12. package/client/router.ts +7 -7
  13. package/client/sharedContext.ts +31 -0
  14. package/client/translator.ts +2 -2
  15. package/client/types.ts +3 -3
  16. package/common/Logger.ts +280 -67
  17. package/common/clientAddress.ts +40 -0
  18. package/common/deepObjectify.ts +24 -9
  19. package/common/index.ts +42 -1
  20. package/common/logContext.ts +27 -0
  21. package/common/mcpExposure.ts +114 -0
  22. package/common/pathGetLoose.ts +31 -0
  23. package/common/pathSet.ts +17 -5
  24. package/common/plainFieldsOf.ts +13 -0
  25. package/common/routeConvention.ts +22 -12
  26. package/common/websocketBinaryFrame.ts +46 -0
  27. package/constant/crystalize.ts +94 -28
  28. package/constant/dateSlot.ts +62 -0
  29. package/constant/deserialize.ts +3 -2
  30. package/constant/fieldInfo.ts +43 -3
  31. package/constant/fieldQueryMeta.ts +35 -0
  32. package/constant/getDefault.ts +16 -11
  33. package/constant/hydrationPlan.ts +72 -0
  34. package/constant/immerify.ts +4 -6
  35. package/constant/index.ts +5 -0
  36. package/constant/labelOf.ts +26 -0
  37. package/constant/mask.ts +67 -0
  38. package/constant/purify.ts +17 -11
  39. package/constant/textFieldPaths.ts +13 -7
  40. package/constant/types.ts +19 -13
  41. package/constant/via.ts +24 -17
  42. package/dictionary/DictionaryLookup.ts +30 -0
  43. package/dictionary/agent.dictionary.ts +31 -0
  44. package/dictionary/agentTurn.dictionary.ts +29 -0
  45. package/dictionary/base.dictionary.ts +81 -0
  46. package/dictionary/dictInfo.ts +11 -2
  47. package/dictionary/dictionary.ts +9 -3
  48. package/dictionary/index.ts +1 -0
  49. package/dictionary/trans.ts +2 -2
  50. package/document/documentQuery.ts +1 -0
  51. package/document/filterMeta.ts +77 -12
  52. package/document/index.ts +1 -0
  53. package/document/noDocumentError.ts +12 -0
  54. package/document/types.ts +0 -1
  55. package/fetch/agentTurn.ts +19 -0
  56. package/fetch/client/fetchClient.ts +137 -37
  57. package/fetch/client/httpClient.ts +95 -20
  58. package/fetch/client/wsClient.ts +27 -12
  59. package/fetch/fetchType/appliedReturn.type.ts +65 -44
  60. package/fetch/fetchType/endpointFetch.type.ts +17 -8
  61. package/fetch/fetchType/sliceFetch.type.ts +27 -50
  62. package/fetch/index.ts +1 -0
  63. package/index.ts +80 -6
  64. package/local/apps/akan/akan-local.db +0 -0
  65. package/local/apps/akan/akan-local.db-shm +0 -0
  66. package/local/apps/akan/akan-local.db-wal +0 -0
  67. package/local/apps/akan/akan-local_solid.db +0 -0
  68. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  69. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  70. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  71. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  72. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  73. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  74. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  75. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  76. package/package.json +27 -18
  77. package/server/akanApp.ts +278 -138
  78. package/server/akanAppHeaders.ts +16 -2
  79. package/server/akanOption.ts +63 -8
  80. package/server/akanServer.ts +387 -32
  81. package/server/animatedImage.ts +83 -0
  82. package/server/assetEncoding.ts +4 -24
  83. package/server/binaryPubsub.ts +55 -0
  84. package/server/console.ts +110 -101
  85. package/server/consoleEvaluator.ts +51 -0
  86. package/server/consolePasteFilter.ts +91 -0
  87. package/server/consoleSession.ts +242 -0
  88. package/server/contentEncoding.ts +83 -0
  89. package/server/devtools/signalSerializer.ts +2 -2
  90. package/server/devtools/types.ts +4 -4
  91. package/server/di/diLifecycle.ts +123 -13
  92. package/server/di/predefinedAdaptor.ts +6 -0
  93. package/server/di/utils.ts +40 -0
  94. package/server/imageOptimizer.ts +154 -57
  95. package/server/lifecycle/runtimeDir.ts +14 -0
  96. package/server/lifecycle/shutdownManager.ts +1 -1
  97. package/server/logging/childOutputReader.ts +137 -0
  98. package/server/logging/hubFileSink.ts +39 -0
  99. package/server/logging/logControlSocket.ts +173 -0
  100. package/server/logging/logForwarder.ts +131 -0
  101. package/server/logging/logHub.ts +0 -0
  102. package/server/logging/logQuery.ts +130 -0
  103. package/server/logging/logStdoutWriter.ts +39 -0
  104. package/server/logging/logStreamRoute.ts +87 -0
  105. package/server/logging/logTailClient.ts +161 -0
  106. package/server/mcp/McpAuth.ts +177 -0
  107. package/server/mcp/McpDispatcher.ts +289 -0
  108. package/server/mcp/McpEventStream.ts +24 -0
  109. package/server/mcp/McpExecutionContext.ts +105 -0
  110. package/server/mcp/McpRouter.ts +621 -0
  111. package/server/mcp/index.ts +5 -0
  112. package/server/processMetricsCollector.ts +1 -1
  113. package/server/resolver/database.resolver.ts +5 -4
  114. package/server/resolver/signal.resolver.ts +208 -86
  115. package/server/routeTreeBuilder.ts +10 -8
  116. package/server/routing/apiRouter.ts +44 -14
  117. package/server/routing/appWsData.ts +24 -2
  118. package/server/routing/eventStream.ts +93 -0
  119. package/server/routing/soloAppRoutes.ts +50 -0
  120. package/server/rscWorker.tsx +36 -22
  121. package/server/rscWorkerHost.ts +59 -8
  122. package/server/semaphore.ts +22 -0
  123. package/server/subRouteIndexDocument.tsx +61 -0
  124. package/server/systemPageDocument.tsx +3 -3
  125. package/server/systemPages.tsx +49 -16
  126. package/server/types.tsx +28 -0
  127. package/server/vendor/akanjs-fetch.ts +1 -0
  128. package/server/webRouter.ts +96 -39
  129. package/service/adapt.ts +4 -4
  130. package/service/agent.service.ts +81 -0
  131. package/service/base.service.ts +2 -1
  132. package/service/index.ts +1 -0
  133. package/service/injectInfo.ts +8 -3
  134. package/service/ipcTypes.ts +6 -0
  135. package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
  136. package/service/predefinedAdaptor/database.adaptor.ts +68 -37
  137. package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
  138. package/service/predefinedAdaptor/index.ts +3 -0
  139. package/service/predefinedAdaptor/insightQuery.ts +183 -0
  140. package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
  141. package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
  142. package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
  143. package/service/predefinedAdaptor/role.adaptor.ts +2 -0
  144. package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
  145. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
  146. package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
  147. package/service/predefinedAdaptor/solidSqlite.ts +11 -9
  148. package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
  149. package/service/serve.ts +16 -9
  150. package/service/toolNames.ts +119 -0
  151. package/signal/agent/AgentCatalogue.ts +165 -0
  152. package/signal/agent/index.ts +1 -0
  153. package/signal/agent.signal.ts +38 -0
  154. package/signal/agentTurn.ts +8 -0
  155. package/signal/agentTurnStream.ts +60 -0
  156. package/signal/base.signal.ts +2 -1
  157. package/signal/endpointInfo.ts +38 -2
  158. package/signal/guard.ts +28 -1
  159. package/signal/guards.ts +49 -1
  160. package/signal/index.ts +6 -0
  161. package/signal/intercept.ts +4 -4
  162. package/signal/internalArg.ts +21 -4
  163. package/signal/mcp/McpDocument.ts +326 -0
  164. package/signal/mcp/McpProgress.ts +106 -0
  165. package/signal/mcp/McpUriTemplate.ts +80 -0
  166. package/signal/mcp/Msg.ts +368 -0
  167. package/signal/mcp/index.ts +5 -0
  168. package/signal/mcp/mcpProtocol.ts +120 -0
  169. package/signal/middleware.ts +3 -3
  170. package/signal/openapi/openapi.ts +36 -173
  171. package/signal/schema/JsonSchemaBuilder.ts +221 -0
  172. package/signal/schema/index.ts +1 -0
  173. package/signal/serializer/fetch.serializer.ts +51 -0
  174. package/signal/signalContext.ts +324 -76
  175. package/signal/slice.ts +62 -27
  176. package/signal/trace.ts +268 -9
  177. package/signal/types.ts +55 -4
  178. package/store/action.ts +34 -41
  179. package/store/actionTag.ts +33 -0
  180. package/store/agent/AgentBridge.ts +87 -0
  181. package/store/agent/AgentContext.ts +71 -0
  182. package/store/agent/AgentPrompts.ts +111 -0
  183. package/store/agent/ScreenReader.ts +349 -0
  184. package/store/agent/ScreenSettle.ts +45 -0
  185. package/store/agent/ScreenTarget.ts +135 -0
  186. package/store/agent/StoreCatalogue.ts +116 -0
  187. package/store/agent/StoreSurfaceSource.ts +225 -0
  188. package/store/agent/index.ts +13 -0
  189. package/store/agent/storeSurface.ts +28 -0
  190. package/store/agent/types.ts +16 -0
  191. package/store/agentic/AgentValue.ts +119 -0
  192. package/store/agentic/StExposeBuilder.ts +47 -0
  193. package/store/agentic/StExposeDraft.ts +24 -0
  194. package/store/agentic/StStateBuilder.ts +85 -0
  195. package/store/agentic/StStateDraft.ts +23 -0
  196. package/store/agentic/StToolBuilder.ts +279 -0
  197. package/store/agentic/StToolDraft.ts +22 -0
  198. package/store/agentic/attachAgentic.ts +33 -0
  199. package/store/agentic/formFields.ts +194 -0
  200. package/store/agentic/index.ts +12 -0
  201. package/store/agentic/useFieldTool.ts +183 -0
  202. package/store/agentic/useFormTools.ts +77 -0
  203. package/store/agentic/useRelationFieldTool.ts +113 -0
  204. package/store/baseSt.ts +1 -1
  205. package/store/databaseStateNames.ts +31 -0
  206. package/store/formSetterNames.ts +35 -0
  207. package/store/index.ts +8 -0
  208. package/store/rootStore.ts +3 -1
  209. package/store/sliceRole.ts +36 -0
  210. package/store/state.ts +2 -12
  211. package/store/store.ts +9 -0
  212. package/store/storeInstance.ts +185 -20
  213. package/store/storeRegistry.ts +39 -1
  214. package/store/types.ts +5 -0
  215. package/store/withSelector.ts +5 -4
  216. package/test/index.ts +1 -1
  217. package/test/registerDom.ts +4 -0
  218. package/test/sampleOf.ts +2 -0
  219. package/test/signalTestRuntime.ts +5 -5
  220. package/test/testServer.ts +14 -11
  221. package/types/base/baseEnv.d.ts +1 -1
  222. package/types/base/primitiveRegistry.d.ts +20 -8
  223. package/types/base/symbols.d.ts +4 -0
  224. package/types/client/capacitor.d.ts +39 -0
  225. package/types/client/clientRuntime.d.ts +7 -0
  226. package/types/client/index.d.ts +1 -0
  227. package/types/client/sharedContext.d.ts +21 -0
  228. package/types/client/types.d.ts +5 -3
  229. package/types/common/Logger.d.ts +88 -6
  230. package/types/common/clientAddress.d.ts +19 -0
  231. package/types/common/deepObjectify.d.ts +4 -2
  232. package/types/common/index.d.ts +8 -2
  233. package/types/common/logContext.d.ts +17 -0
  234. package/types/common/mcpExposure.d.ts +64 -0
  235. package/types/common/pathGetLoose.d.ts +8 -0
  236. package/types/common/plainFieldsOf.d.ts +6 -0
  237. package/types/common/routeConvention.d.ts +6 -0
  238. package/types/common/websocketBinaryFrame.d.ts +17 -0
  239. package/types/constant/constantRegistry.d.ts +2 -10
  240. package/types/constant/crystalize.d.ts +5 -0
  241. package/types/constant/dateSlot.d.ts +14 -0
  242. package/types/constant/fieldInfo.d.ts +20 -3
  243. package/types/constant/fieldQueryMeta.d.ts +17 -0
  244. package/types/constant/getDefault.d.ts +8 -0
  245. package/types/constant/hydrationPlan.d.ts +24 -0
  246. package/types/constant/index.d.ts +5 -0
  247. package/types/constant/labelOf.d.ts +7 -0
  248. package/types/constant/mask.d.ts +41 -0
  249. package/types/constant/purify.d.ts +2 -2
  250. package/types/constant/types.d.ts +5 -5
  251. package/types/dictionary/DictionaryLookup.d.ts +14 -0
  252. package/types/dictionary/agent.dictionary.d.ts +1 -0
  253. package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
  254. package/types/dictionary/base.dictionary.d.ts +1 -1
  255. package/types/dictionary/dictInfo.d.ts +7 -1
  256. package/types/dictionary/dictionary.d.ts +11 -9
  257. package/types/dictionary/index.d.ts +1 -0
  258. package/types/document/filterMeta.d.ts +24 -4
  259. package/types/document/index.d.ts +1 -0
  260. package/types/document/noDocumentError.d.ts +12 -0
  261. package/types/document/types.d.ts +0 -1
  262. package/types/fetch/agentTurn.d.ts +475 -0
  263. package/types/fetch/client/fetchClient.d.ts +12 -0
  264. package/types/fetch/client/httpClient.d.ts +2 -1
  265. package/types/fetch/fetchType/appliedReturn.type.d.ts +37 -18
  266. package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
  267. package/types/fetch/fetchType/sliceFetch.type.d.ts +11 -15
  268. package/types/fetch/index.d.ts +1 -0
  269. package/types/index.d.ts +74 -10
  270. package/types/server/akanApp.d.ts +12 -0
  271. package/types/server/akanAppHeaders.d.ts +7 -1
  272. package/types/server/akanOption.d.ts +36 -6
  273. package/types/server/akanServer.d.ts +67 -9
  274. package/types/server/animatedImage.d.ts +7 -0
  275. package/types/server/assetEncoding.d.ts +1 -1
  276. package/types/server/binaryPubsub.d.ts +18 -0
  277. package/types/server/console.d.ts +11 -1
  278. package/types/server/consoleEvaluator.d.ts +2 -0
  279. package/types/server/consolePasteFilter.d.ts +11 -0
  280. package/types/server/consoleSession.d.ts +22 -0
  281. package/types/server/contentEncoding.d.ts +28 -0
  282. package/types/server/devtools/types.d.ts +4 -4
  283. package/types/server/di/diLifecycle.d.ts +10 -2
  284. package/types/server/di/predefinedAdaptor.d.ts +4 -1
  285. package/types/server/di/utils.d.ts +16 -0
  286. package/types/server/lifecycle/runtimeDir.d.ts +5 -0
  287. package/types/server/logging/childOutputReader.d.ts +40 -0
  288. package/types/server/logging/hubFileSink.d.ts +18 -0
  289. package/types/server/logging/logControlSocket.d.ts +60 -0
  290. package/types/server/logging/logForwarder.d.ts +37 -0
  291. package/types/server/logging/logHub.d.ts +70 -0
  292. package/types/server/logging/logQuery.d.ts +31 -0
  293. package/types/server/logging/logStdoutWriter.d.ts +35 -0
  294. package/types/server/logging/logStreamRoute.d.ts +20 -0
  295. package/types/server/logging/logTailClient.d.ts +42 -0
  296. package/types/server/mcp/McpAuth.d.ts +62 -0
  297. package/types/server/mcp/McpDispatcher.d.ts +61 -0
  298. package/types/server/mcp/McpEventStream.d.ts +17 -0
  299. package/types/server/mcp/McpExecutionContext.d.ts +44 -0
  300. package/types/server/mcp/McpRouter.d.ts +65 -0
  301. package/types/server/mcp/index.d.ts +5 -0
  302. package/types/server/mcp.d.ts +1 -0
  303. package/types/server/resolver/signal.resolver.d.ts +7 -4
  304. package/types/server/routing/apiRouter.d.ts +2 -1
  305. package/types/server/routing/appWsData.d.ts +13 -1
  306. package/types/server/routing/eventStream.d.ts +23 -0
  307. package/types/server/routing/soloAppRoutes.d.ts +17 -0
  308. package/types/server/rscWorkerHost.d.ts +4 -1
  309. package/types/server/semaphore.d.ts +5 -0
  310. package/types/server/subRouteIndexDocument.d.ts +8 -0
  311. package/types/server/systemPageDocument.d.ts +1 -0
  312. package/types/server/systemPages.d.ts +5 -0
  313. package/types/server/types.d.ts +16 -0
  314. package/types/server/vendor/akanjs-fetch.d.ts +1 -0
  315. package/types/server/webRouter.d.ts +15 -4
  316. package/types/service/adapt.d.ts +2 -2
  317. package/types/service/agent.service.d.ts +32 -0
  318. package/types/service/base.service.d.ts +4 -0
  319. package/types/service/index.d.ts +1 -0
  320. package/types/service/injectInfo.d.ts +2 -2
  321. package/types/service/ipcTypes.d.ts +12 -0
  322. package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
  323. package/types/service/predefinedAdaptor/database.adaptor.d.ts +9 -3
  324. package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
  325. package/types/service/predefinedAdaptor/index.d.ts +3 -0
  326. package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
  327. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
  328. package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
  329. package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
  330. package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
  331. package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
  332. package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
  333. package/types/service/serve.d.ts +3 -3
  334. package/types/service/toolNames.d.ts +35 -0
  335. package/types/signal/agent/AgentCatalogue.d.ts +100 -0
  336. package/types/signal/agent/index.d.ts +1 -0
  337. package/types/signal/agent.d.ts +1 -0
  338. package/types/signal/agent.signal.d.ts +24 -0
  339. package/types/signal/agentTurn.d.ts +9 -0
  340. package/types/signal/agentTurnStream.d.ts +24 -0
  341. package/types/signal/base.signal.d.ts +1 -1
  342. package/types/signal/endpointInfo.d.ts +21 -3
  343. package/types/signal/guard.d.ts +12 -0
  344. package/types/signal/guards.d.ts +23 -1
  345. package/types/signal/index.d.ts +6 -0
  346. package/types/signal/intercept.d.ts +2 -2
  347. package/types/signal/internalArg.d.ts +22 -6
  348. package/types/signal/mcp/McpDocument.d.ts +84 -0
  349. package/types/signal/mcp/McpProgress.d.ts +40 -0
  350. package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
  351. package/types/signal/mcp/Msg.d.ts +143 -0
  352. package/types/signal/mcp/index.d.ts +5 -0
  353. package/types/signal/mcp/mcpProtocol.d.ts +107 -0
  354. package/types/signal/mcp.d.ts +1 -0
  355. package/types/signal/middleware.d.ts +7 -7
  356. package/types/signal/openapi/openapi.d.ts +3 -3
  357. package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
  358. package/types/signal/schema/index.d.ts +1 -0
  359. package/types/signal/schema.d.ts +1 -0
  360. package/types/signal/signalContext.d.ts +67 -8
  361. package/types/signal/slice.d.ts +42 -15
  362. package/types/signal/trace.d.ts +52 -2
  363. package/types/signal/types.d.ts +53 -4
  364. package/types/store/action.d.ts +7 -5
  365. package/types/store/actionTag.d.ts +21 -0
  366. package/types/store/agent/AgentBridge.d.ts +37 -0
  367. package/types/store/agent/AgentContext.d.ts +16 -0
  368. package/types/store/agent/AgentPrompts.d.ts +31 -0
  369. package/types/store/agent/ScreenReader.d.ts +29 -0
  370. package/types/store/agent/ScreenSettle.d.ts +22 -0
  371. package/types/store/agent/ScreenTarget.d.ts +34 -0
  372. package/types/store/agent/StoreCatalogue.d.ts +26 -0
  373. package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
  374. package/types/store/agent/index.d.ts +11 -0
  375. package/types/store/agent/storeSurface.d.ts +14 -0
  376. package/types/store/agent/types.d.ts +15 -0
  377. package/types/store/agent.d.ts +1 -0
  378. package/types/store/agentic/AgentValue.d.ts +43 -0
  379. package/types/store/agentic/StExposeBuilder.d.ts +21 -0
  380. package/types/store/agentic/StExposeDraft.d.ts +13 -0
  381. package/types/store/agentic/StStateBuilder.d.ts +21 -0
  382. package/types/store/agentic/StStateDraft.d.ts +12 -0
  383. package/types/store/agentic/StToolBuilder.d.ts +56 -0
  384. package/types/store/agentic/StToolDraft.d.ts +13 -0
  385. package/types/store/agentic/attachAgentic.d.ts +25 -0
  386. package/types/store/agentic/formFields.d.ts +53 -0
  387. package/types/store/agentic/index.d.ts +12 -0
  388. package/types/store/agentic/useFieldTool.d.ts +22 -0
  389. package/types/store/agentic/useFormTools.d.ts +19 -0
  390. package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
  391. package/types/store/agentic.d.ts +1 -0
  392. package/types/store/baseSt.d.ts +35 -39
  393. package/types/store/databaseStateNames.d.ts +25 -0
  394. package/types/store/formSetterNames.d.ts +30 -0
  395. package/types/store/index.d.ts +7 -0
  396. package/types/store/rootStore.d.ts +5 -1
  397. package/types/store/sliceRole.d.ts +25 -0
  398. package/types/store/store.d.ts +5 -1
  399. package/types/store/storeInstance.d.ts +33 -1
  400. package/types/store/storeRegistry.d.ts +5 -0
  401. package/types/store/types.d.ts +4 -0
  402. package/types/store/withSelector.d.ts +5 -4
  403. package/types/test/index.d.ts +1 -1
  404. package/types/test/registerDom.d.ts +1 -0
  405. package/types/test/signalTestRuntime.d.ts +2 -3
  406. package/types/test/testServer.d.ts +6 -4
  407. package/types/ui/Agent/Approval.d.ts +8 -0
  408. package/types/ui/Agent/Attach.d.ts +16 -0
  409. package/types/ui/Agent/Bubble.d.ts +26 -0
  410. package/types/ui/Agent/Chat.d.ts +91 -0
  411. package/types/ui/Agent/ChatCommands.d.ts +34 -0
  412. package/types/ui/Agent/Composer.d.ts +23 -0
  413. package/types/ui/Agent/Context.d.ts +13 -0
  414. package/types/ui/Agent/Dock.d.ts +17 -0
  415. package/types/ui/Agent/Guide.d.ts +9 -0
  416. package/types/ui/Agent/History.d.ts +26 -0
  417. package/types/ui/Agent/Launcher.d.ts +16 -0
  418. package/types/ui/Agent/Markdown.d.ts +19 -0
  419. package/types/ui/Agent/Menu.d.ts +18 -0
  420. package/types/ui/Agent/Mic.d.ts +8 -0
  421. package/types/ui/Agent/Question.d.ts +14 -0
  422. package/types/ui/Agent/Section.d.ts +10 -0
  423. package/types/ui/Agent/Skip.d.ts +22 -0
  424. package/types/ui/Agent/StateKey.d.ts +16 -0
  425. package/types/ui/Agent/Tool.d.ts +15 -0
  426. package/types/ui/Agent/Transcript.d.ts +13 -0
  427. package/types/ui/Agent/Zone.d.ts +48 -0
  428. package/types/ui/Agent/agentSessionOf.d.ts +27 -0
  429. package/types/ui/Agent/attachment.d.ts +34 -0
  430. package/types/ui/Agent/fetchRunner.d.ts +12 -0
  431. package/types/ui/Agent/index.d.ts +19 -0
  432. package/types/ui/Agent/index_.d.ts +1 -0
  433. package/types/ui/Agent/markdownBlocks.d.ts +35 -0
  434. package/types/ui/Agent/markdownSpans.d.ts +2 -0
  435. package/types/ui/Agent/markdownTable.d.ts +16 -0
  436. package/types/ui/Agent/sessionHistory.d.ts +14 -0
  437. package/types/ui/Agent/sessionView.d.ts +15 -0
  438. package/types/ui/Agent/tokenCount.d.ts +6 -0
  439. package/types/ui/Agent/useChatAttachments.d.ts +24 -0
  440. package/types/ui/Agent/useChatVoice.d.ts +30 -0
  441. package/types/ui/Agent/useDraftRecall.d.ts +14 -0
  442. package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
  443. package/types/ui/Agent/useSlashMenu.d.ts +24 -0
  444. package/types/ui/Agent/voice.d.ts +71 -0
  445. package/types/ui/Agent.d.ts +1 -0
  446. package/types/ui/Badge.d.ts +1 -1
  447. package/types/ui/Button.d.ts +1 -1
  448. package/types/ui/Constant/Graph.d.ts +10 -0
  449. package/types/ui/Constant/index.d.ts +2 -1
  450. package/types/ui/Constant/schemaGraph.d.ts +39 -0
  451. package/types/ui/Data/Dashboard.d.ts +16 -3
  452. package/types/ui/Data/Insight.d.ts +1 -1
  453. package/types/ui/Data/ListContainer.d.ts +15 -7
  454. package/types/ui/Data/QueryMaker.d.ts +45 -3
  455. package/types/ui/Data/RefPicker.d.ts +16 -0
  456. package/types/ui/Data/dataExport.d.ts +5 -0
  457. package/types/ui/Data/dataText.d.ts +6 -0
  458. package/types/ui/Data/index.d.ts +2 -0
  459. package/types/ui/Data/index_.d.ts +1 -0
  460. package/types/ui/DatePicker.d.ts +15 -11
  461. package/types/ui/Dialog/LegacyModal.d.ts +13 -0
  462. package/types/ui/Dialog/Provider.d.ts +3 -1
  463. package/types/ui/Dialog/context.d.ts +9 -1
  464. package/types/ui/Dialog/index.d.ts +1 -0
  465. package/types/ui/DraggableList.d.ts +1 -1
  466. package/types/ui/Dropdown.d.ts +5 -1
  467. package/types/ui/Field.d.ts +13 -12
  468. package/types/ui/Layout/BottomTab.d.ts +3 -2
  469. package/types/ui/LegacyModal.d.ts +24 -0
  470. package/types/ui/Loading/ProgressBar.d.ts +4 -0
  471. package/types/ui/Loading/Spin.d.ts +2 -1
  472. package/types/ui/Model/AdminPanel.d.ts +15 -3
  473. package/types/ui/Model/EditModal.d.ts +1 -1
  474. package/types/ui/Model/New.d.ts +3 -1
  475. package/types/ui/Model/NewWrapper.d.ts +2 -0
  476. package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
  477. package/types/ui/Pagination.d.ts +2 -2
  478. package/types/ui/Radio.d.ts +1 -1
  479. package/types/ui/RecentTime.d.ts +18 -1
  480. package/types/ui/Reference/Collapse.d.ts +11 -0
  481. package/types/ui/Reference/Panel.d.ts +29 -0
  482. package/types/ui/Reference/Segmented.d.ts +17 -0
  483. package/types/ui/Reference/Summary.d.ts +13 -0
  484. package/types/ui/Reference/Toolbar.d.ts +21 -0
  485. package/types/ui/Reference/dictText.d.ts +6 -0
  486. package/types/ui/Reference/index.d.ts +7 -0
  487. package/types/ui/Reference/style.d.ts +20 -0
  488. package/types/ui/Reference.d.ts +1 -0
  489. package/types/ui/ScreenNavigator.d.ts +3 -1
  490. package/types/ui/Signal/Arg.d.ts +7 -3
  491. package/types/ui/Signal/Doc.d.ts +4 -6
  492. package/types/ui/Signal/Object.d.ts +2 -1
  493. package/types/ui/Signal/RestApi.d.ts +2 -1
  494. package/types/ui/Signal/WebSocket.d.ts +2 -1
  495. package/types/ui/Signal/endpointEntries.d.ts +20 -0
  496. package/types/ui/Signal/style.d.ts +9 -8
  497. package/types/ui/System/Client.d.ts +1 -2
  498. package/types/ui/System/Common.d.ts +3 -4
  499. package/types/ui/System/Messages.d.ts +1 -1
  500. package/types/ui/Tab/Provider.d.ts +3 -1
  501. package/types/ui/Tab/context.d.ts +4 -2
  502. package/types/ui/ToggleSelect.d.ts +1 -0
  503. package/types/ui/UiOverride/context.d.ts +18 -1
  504. package/types/ui/agentAttrs.d.ts +14 -0
  505. package/types/ui/index.d.ts +22 -1
  506. package/types/ui/overlayLayer.d.ts +13 -0
  507. package/types/ui/overlayPosition.d.ts +28 -0
  508. package/types/ui/recipe/badgeRecipe.d.ts +2 -2
  509. package/types/ui/recipe/buttonRecipe.d.ts +2 -2
  510. package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
  511. package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
  512. package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
  513. package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
  514. package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
  515. package/types/vendor/use-agentic/Agentic.d.ts +21 -0
  516. package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
  517. package/types/vendor/use-agentic/Compaction.d.ts +48 -0
  518. package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
  519. package/types/vendor/use-agentic/Transcript.d.ts +18 -0
  520. package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
  521. package/types/vendor/use-agentic/index.d.ts +19 -0
  522. package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
  523. package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
  524. package/types/vendor/use-agentic/types.d.ts +182 -0
  525. package/types/vendor/use-agentic/useAgent.d.ts +4 -0
  526. package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
  527. package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
  528. package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
  529. package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
  530. package/types/vendor/use-agentic.d.ts +1 -0
  531. package/types/webkit/index.d.ts +4 -0
  532. package/types/webkit/useBodyScrollLock.d.ts +2 -0
  533. package/types/webkit/usePageTool.d.ts +19 -0
  534. package/types/webkit/useScreenScope.d.ts +25 -0
  535. package/ui/Agent/Approval.tsx +32 -0
  536. package/ui/Agent/Attach.tsx +77 -0
  537. package/ui/Agent/Bubble.tsx +192 -0
  538. package/ui/Agent/Chat.tsx +525 -0
  539. package/ui/Agent/ChatCommands.ts +141 -0
  540. package/ui/Agent/Composer.tsx +94 -0
  541. package/ui/Agent/Context.tsx +49 -0
  542. package/ui/Agent/Dock.tsx +77 -0
  543. package/ui/Agent/Guide.tsx +16 -0
  544. package/ui/Agent/History.tsx +49 -0
  545. package/ui/Agent/Launcher.tsx +60 -0
  546. package/ui/Agent/Markdown.tsx +142 -0
  547. package/ui/Agent/Menu.tsx +55 -0
  548. package/ui/Agent/Mic.tsx +27 -0
  549. package/ui/Agent/Question.tsx +63 -0
  550. package/ui/Agent/Section.tsx +24 -0
  551. package/ui/Agent/Skip.tsx +30 -0
  552. package/ui/Agent/StateKey.tsx +46 -0
  553. package/ui/Agent/Tool.tsx +59 -0
  554. package/ui/Agent/Transcript.tsx +33 -0
  555. package/ui/Agent/Zone.tsx +116 -0
  556. package/ui/Agent/agentSessionOf.ts +60 -0
  557. package/ui/Agent/attachment.ts +73 -0
  558. package/ui/Agent/fetchRunner.ts +44 -0
  559. package/ui/Agent/index.ts +27 -0
  560. package/ui/Agent/index_.tsx +4 -0
  561. package/ui/Agent/markdownBlocks.ts +137 -0
  562. package/ui/Agent/markdownSpans.tsx +49 -0
  563. package/ui/Agent/markdownTable.ts +54 -0
  564. package/ui/Agent/sessionHistory.ts +62 -0
  565. package/ui/Agent/sessionView.ts +38 -0
  566. package/ui/Agent/tokenCount.ts +10 -0
  567. package/ui/Agent/useChatAttachments.ts +84 -0
  568. package/ui/Agent/useChatVoice.ts +129 -0
  569. package/ui/Agent/useDraftRecall.ts +42 -0
  570. package/ui/Agent/useKeyboardInset.ts +26 -0
  571. package/ui/Agent/useSlashMenu.ts +58 -0
  572. package/ui/Agent/voice.ts +177 -0
  573. package/ui/Badge.tsx +1 -1
  574. package/ui/BottomSheet.tsx +32 -36
  575. package/ui/Button.tsx +3 -1
  576. package/ui/Clipboard.tsx +3 -6
  577. package/ui/Constant/Doc.tsx +265 -254
  578. package/ui/Constant/Graph.tsx +151 -0
  579. package/ui/Constant/index.ts +3 -2
  580. package/ui/Constant/schemaGraph.ts +232 -0
  581. package/ui/Data/CardList.tsx +14 -3
  582. package/ui/Data/Dashboard.tsx +70 -52
  583. package/ui/Data/Insight.tsx +18 -12
  584. package/ui/Data/Item.tsx +42 -56
  585. package/ui/Data/ListContainer.tsx +246 -132
  586. package/ui/Data/Pagination.tsx +10 -3
  587. package/ui/Data/QueryMaker.tsx +160 -11
  588. package/ui/Data/RefPicker.tsx +202 -0
  589. package/ui/Data/TableList.tsx +22 -13
  590. package/ui/Data/dataExport.ts +54 -0
  591. package/ui/Data/dataText.ts +22 -0
  592. package/ui/Data/index.ts +13 -1
  593. package/ui/Data/index_.tsx +1 -0
  594. package/ui/DatePicker.tsx +110 -128
  595. package/ui/Dialog/Close.tsx +3 -7
  596. package/ui/Dialog/LegacyModal.tsx +241 -0
  597. package/ui/Dialog/Modal.tsx +62 -195
  598. package/ui/Dialog/Provider.tsx +47 -3
  599. package/ui/Dialog/Trigger.tsx +3 -7
  600. package/ui/Dialog/context.ts +14 -2
  601. package/ui/Dialog/index.tsx +2 -0
  602. package/ui/DragAction.tsx +3 -2
  603. package/ui/DraggableList.tsx +9 -4
  604. package/ui/Dropdown.tsx +89 -27
  605. package/ui/Empty.tsx +6 -4
  606. package/ui/Field.tsx +128 -58
  607. package/ui/Input.tsx +27 -5
  608. package/ui/KeyboardAvoiding.tsx +2 -2
  609. package/ui/Layout/BottomTab.tsx +32 -37
  610. package/ui/Layout/Sider.tsx +37 -14
  611. package/ui/LegacyModal.tsx +53 -0
  612. package/ui/Link/CsrLink.tsx +1 -1
  613. package/ui/Load/Pagination.tsx +15 -8
  614. package/ui/Load/Units.tsx +30 -7
  615. package/ui/Load/View.tsx +10 -3
  616. package/ui/Loading/Area.tsx +7 -6
  617. package/ui/Loading/Button.tsx +7 -9
  618. package/ui/Loading/Input.tsx +7 -9
  619. package/ui/Loading/ProgressBar.tsx +16 -7
  620. package/ui/Loading/Skeleton.tsx +8 -13
  621. package/ui/Loading/Spin.tsx +20 -14
  622. package/ui/Menu.tsx +1 -1
  623. package/ui/Model/AdminPanel.tsx +52 -12
  624. package/ui/Model/EditModal.tsx +28 -6
  625. package/ui/Model/EditWrapper.tsx +16 -4
  626. package/ui/Model/New.tsx +4 -0
  627. package/ui/Model/NewWrapper.tsx +2 -0
  628. package/ui/Model/NewWrapper_Client.tsx +20 -6
  629. package/ui/Model/Remove.tsx +18 -6
  630. package/ui/Model/RemoveWrapper.tsx +12 -2
  631. package/ui/Model/SureToRemove.tsx +18 -6
  632. package/ui/Model/ViewEditModal.tsx +64 -15
  633. package/ui/Model/ViewModal.tsx +25 -11
  634. package/ui/Model/ViewWrapper.tsx +15 -4
  635. package/ui/Model/index_.tsx +1 -1
  636. package/ui/Pagination.tsx +51 -66
  637. package/ui/Popconfirm.tsx +88 -78
  638. package/ui/Radio.tsx +53 -24
  639. package/ui/RecentTime.tsx +83 -35
  640. package/ui/Reference/Collapse.tsx +26 -0
  641. package/ui/Reference/Panel.tsx +79 -0
  642. package/ui/Reference/Segmented.tsx +41 -0
  643. package/ui/Reference/Summary.tsx +25 -0
  644. package/ui/Reference/Toolbar.tsx +44 -0
  645. package/ui/Reference/dictText.ts +9 -0
  646. package/ui/Reference/index.ts +7 -0
  647. package/ui/Reference/style.ts +45 -0
  648. package/ui/ScreenNavigator.tsx +17 -2
  649. package/ui/Select.tsx +96 -57
  650. package/ui/Signal/Arg.tsx +83 -68
  651. package/ui/Signal/Doc.tsx +163 -129
  652. package/ui/Signal/Listener.tsx +40 -29
  653. package/ui/Signal/Message.tsx +87 -135
  654. package/ui/Signal/Object.tsx +79 -57
  655. package/ui/Signal/PubSub.tsx +72 -113
  656. package/ui/Signal/Request.tsx +2 -22
  657. package/ui/Signal/Response.tsx +19 -45
  658. package/ui/Signal/RestApi.tsx +170 -200
  659. package/ui/Signal/WebSocket.tsx +29 -26
  660. package/ui/Signal/endpointEntries.ts +59 -0
  661. package/ui/Signal/makeExample.ts +10 -3
  662. package/ui/Signal/style.ts +34 -29
  663. package/ui/Switch.tsx +4 -0
  664. package/ui/System/CSR.tsx +1 -1
  665. package/ui/System/Client.tsx +31 -15
  666. package/ui/System/Common.tsx +3 -4
  667. package/ui/System/DevModeToggle.tsx +1 -1
  668. package/ui/System/Gtag.tsx +2 -2
  669. package/ui/System/Messages.tsx +52 -31
  670. package/ui/System/Reconnect.tsx +22 -56
  671. package/ui/System/SelectLanguage.tsx +24 -15
  672. package/ui/System/ThemeToggle.tsx +25 -13
  673. package/ui/Tab/Menu.tsx +24 -12
  674. package/ui/Tab/Menus.tsx +6 -3
  675. package/ui/Tab/Provider.tsx +30 -3
  676. package/ui/Tab/context.ts +8 -4
  677. package/ui/Table.tsx +66 -60
  678. package/ui/ToggleSelect.tsx +8 -7
  679. package/ui/Tooltip.tsx +15 -1
  680. package/ui/UiOverride/context.ts +21 -2
  681. package/ui/Unauthorized.tsx +6 -4
  682. package/ui/agentAttrs.ts +19 -0
  683. package/ui/index.ts +49 -1
  684. package/ui/overlayLayer.ts +12 -2
  685. package/ui/overlayPosition.ts +104 -0
  686. package/ui/recipe/buttonRecipe.ts +2 -2
  687. package/ui/styles.css +31 -0
  688. package/vendor/use-agentic/AgentAbort.ts +29 -0
  689. package/vendor/use-agentic/AgentProgress.ts +40 -0
  690. package/vendor/use-agentic/AgentProvider.tsx +39 -0
  691. package/vendor/use-agentic/AgentScope.tsx +20 -0
  692. package/vendor/use-agentic/AgentSession.ts +750 -0
  693. package/vendor/use-agentic/Agentic.tsx +44 -0
  694. package/vendor/use-agentic/AgenticSurface.ts +333 -0
  695. package/vendor/use-agentic/Compaction.ts +120 -0
  696. package/vendor/use-agentic/ToolOutput.ts +60 -0
  697. package/vendor/use-agentic/Transcript.ts +50 -0
  698. package/vendor/use-agentic/WIRE.md +86 -0
  699. package/vendor/use-agentic/httpRunner.ts +131 -0
  700. package/vendor/use-agentic/index.ts +20 -0
  701. package/vendor/use-agentic/sharedContext.ts +25 -0
  702. package/vendor/use-agentic/surfaceContext.ts +10 -0
  703. package/vendor/use-agentic/types.ts +192 -0
  704. package/vendor/use-agentic/useAgent.ts +18 -0
  705. package/vendor/use-agentic/useAgentGuide.ts +16 -0
  706. package/vendor/use-agentic/useAgentResource.ts +36 -0
  707. package/vendor/use-agentic/useAgentState.ts +64 -0
  708. package/vendor/use-agentic/useAgentTool.ts +55 -0
  709. package/webkit/bootCsr.tsx +10 -8
  710. package/webkit/index.ts +4 -0
  711. package/webkit/lazy.tsx +5 -1
  712. package/webkit/useBodyScrollLock.tsx +29 -0
  713. package/webkit/useFrameRuntime.ts +1 -1
  714. package/webkit/usePageTool.tsx +37 -0
  715. package/webkit/useScreenScope.tsx +60 -0
  716. package/types/ui/Constant/Mermaid.d.ts +0 -8
  717. package/types/ui/Signal/Collapse.d.ts +0 -12
  718. package/ui/Constant/Mermaid.tsx +0 -149
  719. package/ui/Signal/Collapse.tsx +0 -29
@@ -0,0 +1,94 @@
1
+ "use client";
2
+ import { cn, usePage } from "akanjs/client";
3
+ import { type KeyboardEvent, type RefObject, useEffect } from "react";
4
+ import type { AgentSession, MessageAttachment } from "../../vendor/use-agentic";
5
+ import { Button } from "../Button";
6
+ import { inputRecipe } from "../recipe";
7
+ import { createOverridable, useUiRecipe } from "../UiOverride";
8
+ import { Attach, Chips } from "./Attach";
9
+ import { Mic } from "./Mic";
10
+
11
+ export interface ComposerProps {
12
+ className?: string;
13
+ session: AgentSession;
14
+ draft: string;
15
+ attached: readonly MessageAttachment[];
16
+ /** Absent when the screen cannot listen — the same rule as publishing no tool for a control that is not drawn. */
17
+ mic?: { listening: boolean; onToggle: () => void };
18
+ onDraft: (text: string) => void;
19
+ onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
20
+ onFiles: (files: File[]) => void;
21
+ onRemoveFile: (idx: number) => void;
22
+ onSend: () => void;
23
+ onStop: () => void;
24
+ inputRef?: RefObject<HTMLTextAreaElement | null>;
25
+ }
26
+
27
+ /** Where the box stops growing and starts scrolling: a chat composer is a paragraph at most. */
28
+ const maxComposerHeight = 128;
29
+
30
+ /** What the user writes with: the staged files above, and the controls that send or stop below them. */
31
+ export const DefaultComposer = ({
32
+ className,
33
+ session,
34
+ draft,
35
+ attached,
36
+ mic,
37
+ onDraft,
38
+ onKeyDown,
39
+ onFiles,
40
+ onRemoveFile,
41
+ onSend,
42
+ onStop,
43
+ inputRef,
44
+ }: ComposerProps) => {
45
+ const { l } = usePage();
46
+ const surface = useUiRecipe("input") ?? inputRecipe;
47
+ useEffect(() => {
48
+ const area = inputRef?.current;
49
+ if (!area) return;
50
+
51
+ area.style.height = "auto";
52
+ area.style.height = `${Math.min(area.scrollHeight, maxComposerHeight)}px`;
53
+ }, [draft, inputRef]);
54
+ return (
55
+ <div className={cn("flex flex-col gap-2 border-foreground/5 border-t p-3", className)}>
56
+ {attached.length ? (
57
+ <Chips attachments={attached} onRemove={onRemoveFile} removeLabel={l("base.agentAttachRemove")} />
58
+ ) : null}
59
+ <div className="flex items-end gap-2">
60
+ {mic ? (
61
+ <Mic className="pb-2" label={l("base.agentListen")} listening={mic.listening} onToggle={mic.onToggle} />
62
+ ) : null}
63
+ <Attach className="pb-2" label={l("base.agentAttach")} onPick={onFiles} />
64
+ <textarea
65
+ className={surface({ kind: "area", size: "sm" }, "max-h-32 flex-1 resize-none py-1.5")}
66
+ onChange={(event) => onDraft(event.target.value)}
67
+ onKeyDown={onKeyDown}
68
+ onPaste={(event) => {
69
+ const pasted = [...event.clipboardData.files];
70
+ if (!pasted.length) return;
71
+ event.preventDefault();
72
+ onFiles(pasted);
73
+ }}
74
+ placeholder={session.pendingQuestion ? l("base.agentAnswer") : l("base.agentPlaceholder")}
75
+ ref={inputRef}
76
+ rows={1}
77
+ value={draft}
78
+ />
79
+ {/* A parked question is not a turn to stop: the loop is waiting on the card, and the card has its own out. */}
80
+ {session.isRunning && !session.pendingQuestion ? (
81
+ <Button onClick={onStop} size="sm" variant="outline">
82
+ {l("base.stop")}
83
+ </Button>
84
+ ) : (
85
+ <Button disabled={!draft.trim() && !attached.length} onClick={onSend} size="sm">
86
+ {l("base.send")}
87
+ </Button>
88
+ )}
89
+ </div>
90
+ </div>
91
+ );
92
+ };
93
+
94
+ export const Composer = createOverridable("AgentComposer", DefaultComposer);
@@ -0,0 +1,49 @@
1
+ "use client";
2
+ import { AgentContext } from "akanjs/store";
3
+ import { useState } from "react";
4
+ import { AgenticSurface } from "../../vendor/use-agentic";
5
+ import { buttonRecipe } from "../recipe";
6
+
7
+ interface ContextProps {
8
+ className?: string;
9
+ }
10
+
11
+ /**
12
+ * Assembles and shows exactly what a turn would carry, on demand — the one preview of "what does the agent see on
13
+ * this screen" that no amount of reading the source answers.
14
+ *
15
+ * The tool list leads, by name only: a zone publishes its tools scope-prefixed, and instructions that name a tool
16
+ * without its prefix name a tool that does not exist. That is invisible in the source of either file and obvious
17
+ * here. Renders nothing on `AKAN_PUBLIC_ENV=main`.
18
+ */
19
+ export default function Context({ className }: ContextProps) {
20
+ const [shown, setShown] = useState("");
21
+
22
+ if (process.env.AKAN_PUBLIC_ENV === "main" || process.env.NODE_ENV === "develop") return null;
23
+ const assemble = () => {
24
+ try {
25
+ const { guides, tools } = AgenticSurface.shared.snapshot();
26
+ const context = AgentContext.of().blocks(AgenticSurface.shared);
27
+ const assembled = {
28
+ tools: tools.map((tool) => tool.name),
29
+ ...(guides.length ? { guides } : {}),
30
+ context,
31
+ };
32
+ setShown(JSON.stringify(assembled, null, 2));
33
+ } catch (thrown) {
34
+ setShown(thrown instanceof Error ? thrown.message : String(thrown));
35
+ }
36
+ };
37
+ return (
38
+ <div className={className}>
39
+ <button className={buttonRecipe({ size: "xs" })} onClick={assemble} type="button">
40
+ Assemble
41
+ </button>
42
+ {shown ? (
43
+ <pre className="scrollbar-thin mt-2 max-h-60 overflow-auto rounded-field bg-background/60 p-2 text-[10px] leading-tight">
44
+ {shown}
45
+ </pre>
46
+ ) : null}
47
+ </div>
48
+ );
49
+ }
@@ -0,0 +1,77 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import { type AgentBridge, ensureStoreSurface, StoreRegistry } from "akanjs/store";
4
+ import { useRef, useState } from "react";
5
+ import { AgenticSurface } from "../../vendor/use-agentic";
6
+ import Context from "./Context";
7
+ import Section from "./Section";
8
+ import StateKey from "./StateKey";
9
+ import Tool from "./Tool";
10
+ import Transcript from "./Transcript";
11
+
12
+ export interface DockProps {
13
+ className?: string;
14
+ /** The store keys and their masking. Defaults to the app's own. */
15
+ bridge?: AgentBridge;
16
+ /** Where the declared tools live. Pass a zone's own to inspect it; defaults to the whole screen's. */
17
+ surface?: AgenticSurface;
18
+ open?: boolean;
19
+ }
20
+
21
+ /**
22
+ * The in-page surface of the agent: what this screen declared an agent may do, what it may read, and what it has
23
+ * done. Tools come from the surface rather than from the store, because a tool exists only where a component
24
+ * declared one — the dock is the way to see that this screen published what its author thought it did, which is
25
+ * the one thing no amount of reading the source answers. Renders nothing on `AKAN_PUBLIC_ENV=main`.
26
+ */
27
+ export const Dock = ({ className, bridge, surface, open = false }: DockProps) => {
28
+ const held = useRef<{ bridge: AgentBridge; surface: AgenticSurface } | null>(null);
29
+ held.current ??= { bridge: bridge ?? ensureStoreSurface().bridge, surface: surface ?? AgenticSurface.shared };
30
+ const agent = held.current.bridge;
31
+ const view = held.current.surface;
32
+ const [ran, setRan] = useState(0);
33
+ const liveKeys = StoreRegistry.instance.liveKeys;
34
+ const { tools } = view.snapshot();
35
+ const stateEntries = Object.entries(agent.state).sort(([a], [b]) => {
36
+ const [liveA, liveB] = [liveKeys.has(a), liveKeys.has(b)];
37
+ if (liveA !== liveB) return liveA ? -1 : 1;
38
+ return a < b ? -1 : 1;
39
+ });
40
+
41
+ if (process.env.AKAN_PUBLIC_ENV === "main") return null;
42
+ return (
43
+ <aside
44
+ data-agent-ui=""
45
+ className={cn(
46
+ "scrollbar-thin fixed right-4 bottom-4 z-50 flex max-h-[70vh] w-80 flex-col gap-2 overflow-y-auto rounded-box border border-border bg-background/95 p-3 shadow-lg",
47
+ className,
48
+ )}
49
+ >
50
+ <h2 className="font-semibold text-sm">Agent</h2>
51
+ <Section count={tools.length} open={open} title="Tools">
52
+ {tools.map((tool) => (
53
+ <Tool key={tool.name} onRun={() => setRan(ran + 1)} surface={view} tool={tool} />
54
+ ))}
55
+ </Section>
56
+ <Section count={Object.keys(agent.state).length} title="State">
57
+ {stateEntries.map(([name, entry]) => (
58
+ <StateKey bridge={agent} entry={entry} key={name} live={liveKeys.has(name)} name={name} />
59
+ ))}
60
+ </Section>
61
+ <Section count={liveKeys.size} title="Context">
62
+ <Context />
63
+ </Section>
64
+ <Section count={agent.refusals.length} title="Withheld">
65
+ {agent.refusals.map((refusal) => (
66
+ <div className="flex flex-col" key={refusal.key}>
67
+ <span className="truncate font-mono text-xs">{refusal.key}</span>
68
+ <span className="text-[10px] text-foreground/50">{refusal.reason}</span>
69
+ </div>
70
+ ))}
71
+ </Section>
72
+ <Section count={view.transcript.length} open title="Transcript">
73
+ <Transcript calls={view.transcript} />
74
+ </Section>
75
+ </aside>
76
+ );
77
+ };
@@ -0,0 +1,16 @@
1
+ "use client";
2
+ import { useAgentGuide } from "../../vendor/use-agentic";
3
+
4
+ export interface GuideProps {
5
+ instructions: string;
6
+ }
7
+
8
+ /**
9
+ * Standing agent guidance scoped to a route subtree: render it from a `_layout.tsx` or a page and the text joins
10
+ * the turn's instructions while that subtree is mounted. Nesting layers naturally — each mounted Guide contributes
11
+ * its block, and navigating away withdraws it. Renders nothing.
12
+ */
13
+ export const Guide = ({ instructions }: GuideProps) => {
14
+ useAgentGuide(instructions);
15
+ return null;
16
+ };
@@ -0,0 +1,49 @@
1
+ "use client";
2
+ import { useContext, useEffect, useRef } from "react";
3
+ import { type AgentSessionOptions, SessionContext, type SessionHistory } from "../../vendor/use-agentic";
4
+
5
+ export interface HistoryProps {
6
+ load: SessionHistory["load"];
7
+ save: SessionHistory["save"];
8
+ clear: SessionHistory["clear"];
9
+ /** Where a host with its own server-side summary moves its watermark — see `onCompact` on the session options. */
10
+ onCompact?: AgentSessionOptions["onCompact"];
11
+ }
12
+
13
+ /**
14
+ * Puts the enclosing zone's transcript wherever the app keeps it, as a mounted component rather than a prop.
15
+ *
16
+ * `persist` does the same thing and has to be passed to whoever builds the session, which makes every ancestor up
17
+ * to that point a client component — a function cannot cross the server/client boundary as a prop. Mounted here
18
+ * instead, the only client module an app needs is this leaf, and `Agent.Zone` and the chat inside it can be
19
+ * assembled by a server component. Same shape as `Agent.Guide`, and it renders nothing.
20
+ *
21
+ * Restoring follows the session's one rule: it lands only while nothing has happened to the conversation yet, so
22
+ * mounting with the zone restores and mounting later saves from there on.
23
+ *
24
+ * The store is attached for exactly as long as this is mounted. A zone's own session dies with it, so that is the
25
+ * whole story there — but a session the app handed in (`Agent.Zone`'s `session` prop) outlives this, and its
26
+ * saving stops on unmount: nothing is claiming to persist it any more, and a component that is gone should not
27
+ * still be writing. A host that wants the store to outlive the view calls `session.setHistory` itself, which also
28
+ * takes the slot, so a later unmount here leaves it alone.
29
+ */
30
+ export const History = ({ load, save, clear, onCompact }: HistoryProps) => {
31
+ const session = useContext(SessionContext);
32
+ if (!session) throw new Error("Agent.History needs an enclosing Agent.Zone or AgentProvider to hold the session.");
33
+
34
+ const latest = useRef({ load, save, clear, onCompact });
35
+ latest.current = { load, save, clear, onCompact };
36
+ useEffect(() => {
37
+ const detachHistory = session.setHistory({
38
+ load: () => latest.current.load(),
39
+ save: (messages) => latest.current.save(messages),
40
+ clear: () => latest.current.clear(),
41
+ });
42
+ const detachCompact = session.setOnCompact((replaced, summary) => latest.current.onCompact?.(replaced, summary));
43
+ return () => {
44
+ detachHistory();
45
+ detachCompact();
46
+ };
47
+ }, [session]);
48
+ return null;
49
+ };
@@ -0,0 +1,60 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import type { Ref } from "react";
4
+ import { createOverridable } from "../UiOverride";
5
+
6
+ export interface LauncherProps {
7
+ className?: string;
8
+ label: string;
9
+ /** The chord that opens the chat, shown on hover. Null until the platform is known, which needs the client. */
10
+ hotkey?: { label: string; keys: string } | null;
11
+ /** Messages that arrived while the panel was closed, so a finished turn is not silent. */
12
+ unread: number;
13
+ onOpen: () => void;
14
+ buttonRef?: Ref<HTMLButtonElement>;
15
+ }
16
+
17
+ export const DefaultLauncher = ({ className, label, hotkey, unread, onOpen, buttonRef }: LauncherProps) => (
18
+ <button
19
+ aria-expanded={false}
20
+ aria-haspopup="dialog"
21
+ aria-keyshortcuts={hotkey?.keys}
22
+ aria-label={unread ? `${label} (${unread})` : label}
23
+ data-agent-ui=""
24
+ className={cn(
25
+ "group/agent relative flex size-12 items-center justify-center rounded-full border border-primary/20 bg-primary/90 text-primary-foreground shadow-lg shadow-primary/30 transition-transform hover:scale-105",
26
+ className,
27
+ )}
28
+ onClick={onOpen}
29
+ ref={buttonRef}
30
+ type="button"
31
+ >
32
+ {hotkey ? (
33
+ <kbd className="pointer-events-none absolute right-full mr-3 hidden rounded-field border border-border bg-background px-2 py-0.5 font-mono text-foreground/50 text-xs opacity-0 shadow-sm group-hover/agent:opacity-100 group-focus-visible/agent:opacity-100 md:block">
34
+ {hotkey.label}
35
+ </kbd>
36
+ ) : null}
37
+ {unread ? (
38
+ <span
39
+ aria-hidden="true"
40
+ className="absolute -top-0.5 -right-0.5 flex size-5 items-center justify-center rounded-full bg-warning font-semibold text-[10px] text-warning-foreground"
41
+ >
42
+ {unread > 9 ? "9+" : unread}
43
+ </span>
44
+ ) : null}
45
+ <svg className="size-7" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
46
+ <path
47
+ fill="currentColor"
48
+ d="M40 18 C43.6 43.6 54.4 54.4 80 58 C54.4 61.6 43.6 72.4 40 98
49
+ C36.4 72.4 25.6 61.6 0 58 C25.6 54.4 36.4 43.6 40 18 Z"
50
+ />
51
+ <path
52
+ fill="currentColor"
53
+ d="M80 2 C81.8 14.8 87.2 20.2 100 22 C87.2 23.8 81.8 29.2 80 42
54
+ C78.2 29.2 72.8 23.8 60 22 C72.8 20.2 78.2 14.8 80 2 Z"
55
+ />
56
+ </svg>
57
+ </button>
58
+ );
59
+
60
+ export const Launcher = createOverridable("AgentLauncher", DefaultLauncher);
@@ -0,0 +1,142 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import type { ReactNode } from "react";
4
+ import { createOverridable } from "../UiOverride";
5
+ import { type MarkdownBlock, MarkdownBlocks, type MarkdownItem } from "./markdownBlocks";
6
+ import { spans } from "./markdownSpans";
7
+ import type { Align, TableBlock } from "./markdownTable";
8
+
9
+ const alignClass: { [key in Align]: string } = { left: "text-left", center: "text-center", right: "text-right" };
10
+
11
+ interface ListProps {
12
+ className?: string;
13
+ items: MarkdownItem[];
14
+ }
15
+
16
+ /** Folds the scanner's flat depth-scored items back into real nested lists, so a nested run carries its own
17
+ * marker and leaves the outer numbering alone — a hidden `li` still advances an `ol`'s counter. */
18
+ const List = ({ className, items }: ListProps) => {
19
+ const rows: ReactNode[] = [];
20
+ for (let at = 0; at < items.length; ) {
21
+ const item = items[at];
22
+ const nested: MarkdownItem[] = [];
23
+ for (at += 1; at < items.length && items[at].depth > item.depth; at += 1) nested.push(items[at]);
24
+ rows.push(
25
+ <li key={at}>
26
+ {spans(item.text)}
27
+ {nested.length ? <List className="pl-4" items={nested} /> : null}
28
+ </li>,
29
+ );
30
+ }
31
+ const [first] = items;
32
+ return first.ordered ? (
33
+ <ol className={cn("list-inside list-decimal", className)} start={first.num}>
34
+ {rows}
35
+ </ol>
36
+ ) : (
37
+ <ul className={cn("list-inside list-disc", className)}>{rows}</ul>
38
+ );
39
+ };
40
+
41
+ interface TableProps {
42
+ block: TableBlock;
43
+ }
44
+
45
+ const Table = ({ block }: TableProps) => {
46
+ const cellClass = block.head.map((_, idx) => {
47
+ const align = block.aligns[idx];
48
+ return align ? alignClass[align] : "";
49
+ });
50
+ return (
51
+
52
+ <div className="overflow-x-auto">
53
+ <table className="min-w-full border-collapse">
54
+ <thead>
55
+ <tr className="bg-muted/40">
56
+ {block.head.map((cell, idx) => (
57
+ <th className={cn("border-border border-b px-2 py-1 text-left", cellClass[idx])} key={idx}>
58
+ {spans(cell)}
59
+ </th>
60
+ ))}
61
+ </tr>
62
+ </thead>
63
+ <tbody>
64
+ {block.rows.map((row, rowIdx) => (
65
+ <tr key={rowIdx}>
66
+ {row.map((cell, idx) => (
67
+ <td className={cn("border-border/60 border-b px-2 py-1 text-left", cellClass[idx])} key={idx}>
68
+ {spans(cell)}
69
+ </td>
70
+ ))}
71
+ </tr>
72
+ ))}
73
+ </tbody>
74
+ </table>
75
+ </div>
76
+ );
77
+ };
78
+
79
+ export interface CodeProps {
80
+ className?: string;
81
+ /** The fence's info word, kept so a highlighter bound to this slot knows what it was handed. */
82
+ lang?: string;
83
+ text: string;
84
+ }
85
+
86
+ export const DefaultCode = ({ className, lang, text }: CodeProps) => (
87
+ <pre
88
+ className={cn("overflow-x-auto rounded-field bg-muted p-2 font-mono text-[11px] leading-tight", className)}
89
+ data-lang={lang}
90
+ >
91
+ {text}
92
+ </pre>
93
+ );
94
+
95
+ /** The one place a fenced block is drawn, so an app binds its highlighter here instead of replacing the renderer. */
96
+ const Code = createOverridable("AgentCode", DefaultCode);
97
+
98
+ interface BlockProps {
99
+ block: MarkdownBlock;
100
+ }
101
+
102
+ const Block = ({ block }: BlockProps) => {
103
+ switch (block.kind) {
104
+ case "code":
105
+ return <Code lang={block.lang} text={block.text} />;
106
+
107
+ case "heading":
108
+ return <p className={cn("font-semibold", block.level <= 2 && "text-base")}>{spans(block.text)}</p>;
109
+ case "list":
110
+ return <List items={block.items} />;
111
+ case "table":
112
+ return <Table block={block} />;
113
+ case "quote":
114
+ return (
115
+ <blockquote className="border-foreground/20 border-l-2 pl-2 text-foreground/70">{spans(block.text)}</blockquote>
116
+ );
117
+ case "rule":
118
+ return <hr className="border-foreground/10" />;
119
+ default:
120
+ return <p>{spans(block.text)}</p>;
121
+ }
122
+ };
123
+
124
+ export interface MarkdownProps {
125
+ className?: string;
126
+ children: string;
127
+ }
128
+
129
+ /**
130
+ * The chat's own markdown renderer: React elements, never `dangerouslySetInnerHTML`, and no parser dependency.
131
+ * `Bun.markdown` is the obvious candidate and cannot serve this — it is a runtime API the bundler passes through
132
+ * verbatim, so it is undefined in the browser, and assistant text arrives here as SSE deltas the client accrues.
133
+ */
134
+ export const DefaultMarkdown = ({ className, children }: MarkdownProps) => (
135
+ <div className={cn("flex flex-col gap-2 break-words", className)}>
136
+ {MarkdownBlocks.of(children).map((block, idx) => (
137
+ <Block block={block} key={idx} />
138
+ ))}
139
+ </div>
140
+ );
141
+
142
+ export default createOverridable("AgentMarkdown", DefaultMarkdown);
@@ -0,0 +1,55 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import { createOverridable } from "../UiOverride";
4
+
5
+ export interface MenuRow {
6
+ name: string;
7
+ description?: string;
8
+ /** The argument names a prompt takes, shown so a user knows what to type after the name. */
9
+ hint?: string;
10
+ pick: () => void;
11
+ }
12
+
13
+ export interface MenuProps {
14
+ className?: string;
15
+ rows: MenuRow[];
16
+ /** Index the arrows are on. Enter picks it and Tab completes its name, so it has to be visible. */
17
+ selected: number;
18
+ onPick: (row: MenuRow) => void;
19
+ }
20
+
21
+ /** The `/` menu: this chat's own commands first, then the app's `prompt()` endpoints. */
22
+ export const DefaultMenu = ({ className, rows, selected, onPick }: MenuProps) => {
23
+ if (!rows.length) return null;
24
+ return (
25
+ <div
26
+ className={cn(
27
+ "scrollbar-thin flex max-h-40 flex-col overflow-y-auto border-foreground/5 border-t py-1",
28
+ className,
29
+ )}
30
+ role="listbox"
31
+ >
32
+ {rows.map((row, idx) => (
33
+ <button
34
+ aria-selected={idx === selected}
35
+ className={cn(
36
+ "flex items-baseline gap-2 px-4 py-1.5 text-left hover:bg-muted",
37
+ idx === selected && "bg-muted",
38
+ )}
39
+ key={row.name}
40
+ onClick={() => onPick(row)}
41
+ role="option"
42
+ type="button"
43
+ >
44
+ <span className="shrink-0 font-mono text-xs">/{row.name}</span>
45
+ {row.hint ? <span className="shrink-0 font-mono text-[10px] text-foreground/40">{row.hint}</span> : null}
46
+ {row.description ? (
47
+ <span className="ml-auto truncate text-[10px] text-foreground/50">{row.description}</span>
48
+ ) : null}
49
+ </button>
50
+ ))}
51
+ </div>
52
+ );
53
+ };
54
+
55
+ export default createOverridable("AgentMenu", DefaultMenu);
@@ -0,0 +1,27 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import { AiOutlineAudio, AiOutlineAudioMuted } from "react-icons/ai";
4
+
5
+ interface MicProps {
6
+ className?: string;
7
+ listening: boolean;
8
+ label: string;
9
+ onToggle: () => void;
10
+ }
11
+
12
+ export const Mic = ({ className, listening, label, onToggle }: MicProps) => (
13
+ <button
14
+ aria-label={label}
15
+ aria-pressed={listening}
16
+ className={cn(
17
+ "shrink-0 hover:text-foreground",
18
+ listening ? "animate-pulse text-primary" : "text-foreground/50",
19
+ className,
20
+ )}
21
+ onClick={onToggle}
22
+ title={label}
23
+ type="button"
24
+ >
25
+ {listening ? <AiOutlineAudioMuted /> : <AiOutlineAudio />}
26
+ </button>
27
+ );
@@ -0,0 +1,63 @@
1
+ "use client";
2
+ import { cn, usePage } from "akanjs/client";
3
+ import { useState } from "react";
4
+ import type { PendingQuestion } from "../../vendor/use-agentic";
5
+ import { Button } from "../Button";
6
+ import { createOverridable } from "../UiOverride";
7
+
8
+ export interface QuestionProps {
9
+ className?: string;
10
+ question: PendingQuestion;
11
+ }
12
+
13
+ /**
14
+ * The agent's question, parked above the composer while the loop waits on it. Only the picks live here — the
15
+ * composer below is the free-text answer, so the panel never grows a second input meaning the same thing. There is
16
+ * always that way out of the options: the model wrote them, and only the user knows whether the answer is among
17
+ * them. Mounted keyed by call id, so a second ask starts with nothing picked.
18
+ */
19
+ export const DefaultQuestion = ({ className, question }: QuestionProps) => {
20
+ const { l } = usePage();
21
+ const [picked, setPicked] = useState<string[]>([]);
22
+ const toggle = (choice: string) =>
23
+ setPicked((current) => (current.includes(choice) ? current.filter((one) => one !== choice) : [...current, choice]));
24
+ return (
25
+ <div
26
+ aria-label={l("base.agentQuestion")}
27
+ className={cn("flex flex-col gap-2 border-primary/30 border-t bg-primary/5 px-4 py-3", className)}
28
+ role="group"
29
+ >
30
+ <p className="text-sm">{question.question}</p>
31
+ {question.choices.length ? (
32
+ <div className="flex flex-wrap gap-1.5">
33
+ {question.choices.map((choice) => (
34
+ <Button
35
+ key={choice}
36
+ onClick={() => (question.multiple ? toggle(choice) : question.answer(choice))}
37
+ size="xs"
38
+ variant={question.multiple && picked.includes(choice) ? "primary" : "outline"}
39
+ >
40
+ {choice}
41
+ </Button>
42
+ ))}
43
+ </div>
44
+ ) : null}
45
+ <div className="flex items-center justify-end gap-2">
46
+ <button
47
+ className="text-foreground/50 text-xs hover:text-foreground"
48
+ onClick={() => question.dismiss()}
49
+ type="button"
50
+ >
51
+ {l("base.skip")}
52
+ </button>
53
+ {question.multiple ? (
54
+ <Button disabled={!picked.length} onClick={() => question.answer(picked)} size="xs">
55
+ {l("base.ok")}
56
+ </Button>
57
+ ) : null}
58
+ </div>
59
+ </div>
60
+ );
61
+ };
62
+
63
+ export default createOverridable("AgentQuestion", DefaultQuestion);
@@ -0,0 +1,24 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import type { ReactNode } from "react";
4
+
5
+ interface SectionProps {
6
+ className?: string;
7
+ title: string;
8
+ count: number;
9
+ children: ReactNode;
10
+ open?: boolean;
11
+ }
12
+
13
+ export default function Section({ className, title, count, children, open }: SectionProps) {
14
+ return (
15
+ <details className={cn("group rounded-box bg-muted", className)} open={open}>
16
+ <summary className="flex cursor-pointer list-none items-center gap-2 px-3 py-2 [&::-webkit-details-marker]:hidden">
17
+ <span className="font-semibold text-sm">{title}</span>
18
+ <span className="text-foreground/50 text-xs">{count}</span>
19
+ <span className="ml-auto text-foreground/40 transition-transform group-open:rotate-180">▾</span>
20
+ </summary>
21
+ <div className="flex flex-col gap-1 px-3 pb-3">{children}</div>
22
+ </details>
23
+ );
24
+ }