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,525 @@
1
+ "use client";
2
+ import { cn, fetch, usePage } from "akanjs/client";
3
+ import type { PromptResult } from "akanjs/signal";
4
+ import { type AgentPrompt, AgentPrompts } from "akanjs/store";
5
+ import {
6
+ type KeyboardEvent as ReactKeyboardEvent,
7
+ type ReactNode,
8
+ useContext,
9
+ useEffect,
10
+ useMemo,
11
+ useRef,
12
+ useState,
13
+ useSyncExternalStore,
14
+ } from "react";
15
+ import { createPortal } from "react-dom";
16
+ import { AiOutlineClear, AiOutlineClose } from "react-icons/ai";
17
+ import {
18
+ type AgentRunner,
19
+ type AgentSession,
20
+ type AgentSessionOptions,
21
+ type CompactOptions,
22
+ SessionContext,
23
+ type SessionHistory,
24
+ } from "../../vendor/use-agentic";
25
+ import { createOverridable } from "../UiOverride";
26
+ import Approval from "./Approval";
27
+ import { agentSessionOf } from "./agentSessionOf";
28
+ import type { AttachReader } from "./attachment";
29
+ import Bubble from "./Bubble";
30
+ import { type ChatCommand, ChatCommands } from "./ChatCommands";
31
+ import { Composer } from "./Composer";
32
+ import { Launcher } from "./Launcher";
33
+ import Menu from "./Menu";
34
+ import Question from "./Question";
35
+ import type { PersistOption } from "./sessionHistory";
36
+ import type { BuiltinOption } from "./sessionView";
37
+ import { tokenCount } from "./tokenCount";
38
+ import { useChatAttachments } from "./useChatAttachments";
39
+ import { useChatVoice } from "./useChatVoice";
40
+ import { useDraftRecall } from "./useDraftRecall";
41
+ import { useKeyboardInset } from "./useKeyboardInset";
42
+ import { useSlashMenu } from "./useSlashMenu";
43
+ import type { VoiceEngine } from "./voice";
44
+
45
+ export interface ChatProps {
46
+ /** Reaches whichever surface is showing — the launcher while closed, the panel while open. */
47
+ className?: string;
48
+ title?: string;
49
+ /** App-global framing. Route-scoped guidance layers on it through mounted `Agent.Guide`s. */
50
+ instructions?: string;
51
+ /** Swap the transport; the default drives the app's `runAgentTurn` endpoint. */
52
+ runner?: AgentRunner;
53
+ maxTurns?: number;
54
+ /**
55
+ * When the conversation summarizes itself to stay inside the model's window — `at` estimated tokens, `keep`
56
+ * messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
57
+ */
58
+ compact?: CompactOptions;
59
+ /**
60
+ * Which of the runtime's own tools this chat's agent gets — all of them by default, `false` none, an array
61
+ * exactly the ones it names. A chat that must not leave the screen it is on drops `navigate` and `goBack`.
62
+ */
63
+ builtins?: BuiltinOption;
64
+ /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
65
+ onCompact?: AgentSessionOptions["onCompact"];
66
+ defaultOpen?: boolean;
67
+ /**
68
+ * Controlled open state. Pass it with `onOpenChange` to drive the panel from the app's own control — a header
69
+ * button, a menu item — instead of the built-in launcher. Left off, the panel owns the state as before.
70
+ */
71
+ open?: boolean;
72
+ /**
73
+ * Left off while `open` is controlled, the panel cannot close itself — so it draws **no close button** rather
74
+ * than an inert one. That is the shape of a fixed panel with nowhere to close to, and it is also what keeps a
75
+ * controlled chat assemblable by a server component, since this is the only prop here that is a function.
76
+ */
77
+ onOpenChange?: (open: boolean) => void;
78
+ /** `false` draws no launcher, for an app that opens the panel from a control of its own. */
79
+ launcher?: boolean;
80
+ /**
81
+ * Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab, or
82
+ * a `SessionHistory` of the app's own to keep it anywhere else, a server included.
83
+ *
84
+ * Ignored, like every session option above it, when an enclosing `Agent.Zone` or `AgentProvider` already holds a
85
+ * session: this chat then binds to that one, and the options belong to whoever built it.
86
+ */
87
+ persist?: PersistOption | SessionHistory;
88
+ /** Renders in the page flow instead of floating above it — a zone chat that lives inside its own section. */
89
+ inline?: boolean;
90
+ /** `false` gives the browser its own Cmd/Ctrl+L back, for an app whose shell already spends that chord. */
91
+ shortcut?: boolean;
92
+ /** One surface each, where `className` reaches both. */
93
+ launcherClassName?: string;
94
+ panelClassName?: string;
95
+ /** Shown in place of the intro line while the transcript is empty — where starter questions go. */
96
+ intro?: ReactNode;
97
+ /** Extra header controls, left of the built-in clear and close buttons. */
98
+ header?: ReactNode;
99
+ /**
100
+ * `false` draws no header bar at all — for an `inline` chat inside a panel the app already titles. The extra
101
+ * `header` controls go with it, and the clear action stays reachable as the `/new` command.
102
+ */
103
+ chrome?: boolean;
104
+ /** The composer's opening text, read once at mount — where a `?prompt=` lands without sending it. */
105
+ defaultDraft?: string;
106
+ /**
107
+ * Reads a file the user attached into an attachment, or answers `null` to leave it to the built-in reader
108
+ * (images as bytes, text as text). This is where an app puts what needs a parser — a PDF's text, a spreadsheet's
109
+ * cells — since the framework carries attachments but depends on nothing that can extract one. It runs before
110
+ * the built-in, so it can also replace how an image is prepared.
111
+ */
112
+ attach?: AttachReader;
113
+ /**
114
+ * Speech in and out. The engine listens and speaks; this component decides when — a press-to-talk microphone
115
+ * whose transcript lands in the composer for the user to correct, and a reply read aloud **only when the ask
116
+ * itself came in by voice**, so a typed question never turns the speakers on.
117
+ */
118
+ voice?: VoiceEngine;
119
+ }
120
+
121
+ const isApplePlatform = () => {
122
+ const data = (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData;
123
+ return /Mac|iPhone|iPad|iPod/i.test(data?.platform || navigator.platform || navigator.userAgent);
124
+ };
125
+
126
+ const launcherLayer = "fixed right-4 bottom-4 z-[150]";
127
+
128
+ const panelLayer = "fixed inset-0 z-[150] sm:inset-auto sm:right-4 sm:bottom-4";
129
+ const panelSize =
130
+ "h-dvh w-screen rounded-none sm:h-[min(600px,calc(100dvh-2rem))] sm:w-[min(24rem,calc(100vw-2rem))] sm:rounded-box";
131
+
132
+ /** Distance from the bottom within which the transcript keeps following new messages. */
133
+ const stickyEdge = 80;
134
+
135
+ /**
136
+ * The user-facing half of the in-page agent: one floating chat wired to the same surface the dock inspects.
137
+ * The conversation loop runs in this browser session — every tool call executes here, gated by the approval
138
+ * card — and the session lives in a ref, so it survives reopening the panel and dies with the page unless
139
+ * `persist` keeps it. An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps
140
+ * the loop while keeping this UI.
141
+ */
142
+ export const DefaultChat = ({
143
+ className,
144
+ title,
145
+ instructions,
146
+ runner,
147
+ maxTurns,
148
+ compact,
149
+ builtins,
150
+ onCompact,
151
+ defaultOpen = false,
152
+ open: openProp,
153
+ onOpenChange,
154
+ launcher = true,
155
+ persist,
156
+ inline = false,
157
+ shortcut = true,
158
+ launcherClassName,
159
+ panelClassName,
160
+ intro,
161
+ header,
162
+ chrome = true,
163
+ defaultDraft,
164
+ attach,
165
+ voice,
166
+ }: ChatProps) => {
167
+ const { l } = usePage();
168
+ const provided = useContext(SessionContext);
169
+
170
+ const translate = useRef(l);
171
+ translate.current = l;
172
+ const held = useRef<AgentSession | null>(null);
173
+ held.current ??=
174
+ provided ??
175
+ agentSessionOf({
176
+ l: (key) => translate.current(key),
177
+ runner,
178
+ instructions,
179
+ maxTurns,
180
+ compact,
181
+ builtins,
182
+ persist,
183
+ onCompact,
184
+ });
185
+ const session = held.current;
186
+ const prompts = useRef<AgentPrompts | null>(null);
187
+ prompts.current ??= AgentPrompts.of();
188
+ const version = useSyncExternalStore(
189
+ session.subscribe,
190
+ () => session.version,
191
+ () => session.version,
192
+ );
193
+ const [ownOpen, setOwnOpen] = useState(defaultOpen);
194
+
195
+ const open = openProp ?? ownOpen;
196
+ const setOpen = (next: boolean) => {
197
+ if (openProp === undefined) setOwnOpen(next);
198
+ onOpenChange?.(next);
199
+ };
200
+ const [draft, setDraft] = useState(defaultDraft ?? "");
201
+ const files = useChatAttachments({ session, attach, l });
202
+ const speech = useChatVoice({
203
+ session,
204
+ engine: voice,
205
+ version,
206
+ onTranscript: setDraft,
207
+ onFailed: () => session.note(l("base.agentVoiceFailed")),
208
+ });
209
+ const recall = useDraftRecall(session.messages);
210
+ const [hotkey, setHotkey] = useState<{ label: string; keys: string } | null>(null);
211
+ const listRef = useRef<HTMLDivElement>(null);
212
+ const inputRef = useRef<HTMLTextAreaElement>(null);
213
+ const launcherRef = useRef<HTMLButtonElement>(null);
214
+
215
+ const sticky = useRef(true);
216
+ const returning = useRef(false);
217
+ const read = useRef(session.messages.length);
218
+ const keyboardInset = useKeyboardInset();
219
+ const [overlay, setOverlay] = useState<HTMLElement | null>(null);
220
+ useEffect(() => {
221
+ setOverlay(document.body);
222
+ }, []);
223
+ useEffect(() => {
224
+ if (open) read.current = session.messages.length;
225
+ if (sticky.current) listRef.current?.scrollTo({ top: listRef.current.scrollHeight });
226
+ }, [version, open]);
227
+ useEffect(() => {
228
+ if (!shortcut) return;
229
+ const apple = isApplePlatform();
230
+ setHotkey(apple ? { label: "⌘ L", keys: "Meta+L" } : { label: "Ctrl+L", keys: "Control+L" });
231
+ const onKeyDown = (event: KeyboardEvent) => {
232
+ if (event.repeat || event.key.toLowerCase() !== "l" || event.shiftKey || event.altKey) return;
233
+ const chord = apple ? event.metaKey && !event.ctrlKey : event.ctrlKey && !event.metaKey;
234
+ if (!chord) return;
235
+ event.preventDefault();
236
+ sticky.current = true;
237
+ setOpen(true);
238
+ inputRef.current?.focus();
239
+ };
240
+
241
+ window.addEventListener("keydown", onKeyDown, true);
242
+ return () => window.removeEventListener("keydown", onKeyDown, true);
243
+ }, [shortcut]);
244
+ useEffect(() => {
245
+ if (!open) {
246
+
247
+ if (returning.current) launcherRef.current?.focus();
248
+ returning.current = false;
249
+ return;
250
+ }
251
+ inputRef.current?.focus();
252
+ }, [open, session.pendingQuestion?.callId]);
253
+ useEffect(
254
+ () => () => {
255
+
256
+ if (!provided) session.abort();
257
+ },
258
+ [],
259
+ );
260
+ const runPrompt = async (prompt: AgentPrompt, args: string[]) => {
261
+ const usage = `/${prompt.name} ${prompt.args.map((arg) => `<${arg.name}>`).join(" ")}`.trim();
262
+ if (args.length < prompt.args.filter((arg) => arg.required).length) {
263
+ session.report(`Usage: ${usage}`);
264
+ return;
265
+ }
266
+ const handler = (fetch as unknown as Record<string, (...callArgs: unknown[]) => Promise<PromptResult>>)[
267
+ prompt.name
268
+ ];
269
+ if (typeof handler !== "function") {
270
+ session.report(`/${prompt.name} is not mounted on this app.`);
271
+ return;
272
+ }
273
+ try {
274
+ const result = await handler(...args);
275
+ await session.send(AgentPrompts.messagesOf(result));
276
+ } catch (error) {
277
+ session.report(`/${prompt.name} failed: ${error instanceof Error ? error.message : String(error)}`);
278
+ }
279
+ };
280
+ const write = (text: string) => {
281
+ setDraft(text);
282
+ menu.reopen();
283
+ };
284
+
285
+ const closable = openProp === undefined || !!onOpenChange;
286
+ const dismiss = () => {
287
+ returning.current = true;
288
+ setOpen(false);
289
+ };
290
+ const runCommand = (command: ChatCommand) => {
291
+ write("");
292
+ recall.remember(`/${command.name}`);
293
+
294
+ if (command.name === "new") files.clear();
295
+ void ChatCommands.run(command, { session, l });
296
+ };
297
+ const pick = (prompt: AgentPrompt) => {
298
+ if (prompt.args.some((arg) => arg.required)) {
299
+ write(`/${prompt.name} `);
300
+ return;
301
+ }
302
+ if (session.isRunning) {
303
+ session.note(l("base.agentBusy"));
304
+ return;
305
+ }
306
+ write("");
307
+ recall.remember(`/${prompt.name}`);
308
+ void runPrompt(prompt, []);
309
+ };
310
+ const menu = useSlashMenu({ draft, prompts: prompts.current, l, onCommand: runCommand, onPrompt: pick });
311
+ const send = () => {
312
+ const text = draft.trim();
313
+ if (!text && !files.attached.length) return;
314
+ const command = AgentPrompts.parseCommand(text);
315
+ const builtin = command ? ChatCommands.find(command.name, l) : null;
316
+
317
+ if (builtin) {
318
+ runCommand(builtin);
319
+ return;
320
+ }
321
+
322
+ const question = session.pendingQuestion;
323
+ if (question) {
324
+ if (!text) {
325
+ session.note(l("base.agentAnswerNeeded"));
326
+ return;
327
+ }
328
+ write("");
329
+ speech.drop();
330
+ question.answer(question.multiple ? [text] : text);
331
+ return;
332
+ }
333
+ if (session.isRunning) return;
334
+ const prompt = command ? prompts.current?.find(command.name) : null;
335
+ write("");
336
+ if (text) recall.remember(text);
337
+ sticky.current = true;
338
+ speech.take();
339
+ if (command && prompt) {
340
+ void runPrompt(prompt, command.args);
341
+ return;
342
+ }
343
+ if (!files.attached.length) {
344
+ void session.send(text);
345
+ return;
346
+ }
347
+ const attachments = files.attached;
348
+ files.clear();
349
+ void session.send([{ role: "user", ...(text ? { text } : {}), attachments }]);
350
+ };
351
+ const onKeyDown = (event: ReactKeyboardEvent<HTMLTextAreaElement>) => {
352
+ const area = event.currentTarget;
353
+
354
+ const onEdgeLine = (up: boolean) =>
355
+ area.selectionStart === area.selectionEnd &&
356
+ !(up ? area.value.slice(0, area.selectionStart) : area.value.slice(area.selectionEnd)).includes("\n");
357
+ const row = menu.at();
358
+ if (row) {
359
+
360
+ if (event.key === "ArrowDown" || event.key === "ArrowUp") {
361
+ event.preventDefault();
362
+ menu.move(event.key === "ArrowDown" ? 1 : -1);
363
+ return;
364
+ }
365
+ if (event.key === "Tab") {
366
+ event.preventDefault();
367
+ write(`/${row.name} `);
368
+ return;
369
+ }
370
+ if (event.key === "Escape") {
371
+ event.preventDefault();
372
+ menu.hide();
373
+ return;
374
+ }
375
+ if (event.key === "Enter" && !event.shiftKey && !event.nativeEvent.isComposing) {
376
+ event.preventDefault();
377
+ row.pick();
378
+ return;
379
+ }
380
+ }
381
+ if (event.key === "Escape") {
382
+ event.preventDefault();
383
+ dismiss();
384
+ return;
385
+ }
386
+ const up = event.key === "ArrowUp";
387
+ if ((up || event.key === "ArrowDown") && recall.has && onEdgeLine(up)) {
388
+ event.preventDefault();
389
+ const walked = recall.step(up ? 1 : -1, draft);
390
+ if (walked !== null) setDraft(walked);
391
+ return;
392
+ }
393
+ if (event.key !== "Enter" || event.shiftKey || event.nativeEvent.isComposing) return;
394
+ event.preventDefault();
395
+ send();
396
+ };
397
+
398
+ const bubbles = useMemo(() => {
399
+ const resultOf = new Map(session.messages.flatMap((message) => message.toolResults ?? []).map((r) => [r.id, r]));
400
+ const claimed = new Set(session.messages.flatMap((message) => message.toolCalls?.map((call) => call.id) ?? []));
401
+ return session.messages.flatMap((message, idx) => {
402
+ if (message.role !== "tool")
403
+ return [<Bubble key={idx} message={message} progress={session.progress} results={resultOf} />];
404
+ const orphans = (message.toolResults ?? []).filter((result) => !claimed.has(result.id));
405
+ return orphans.length ? [<Bubble key={idx} message={{ ...message, toolResults: orphans }} />] : [];
406
+ });
407
+ }, [version]);
408
+
409
+ const tokens = useMemo(() => session.tokens, [version]);
410
+ const unread = open ? 0 : Math.max(0, session.messages.length - read.current);
411
+ const layer = (surface: ReactNode) => (inline ? surface : overlay ? createPortal(surface, overlay) : null);
412
+ if (!open)
413
+ return launcher
414
+ ? layer(
415
+ <Launcher
416
+ className={cn(!inline && launcherLayer, className, launcherClassName)}
417
+ hotkey={hotkey}
418
+ label={l("base.agent")}
419
+ buttonRef={launcherRef}
420
+ onOpen={() => setOpen(true)}
421
+ unread={unread}
422
+ />,
423
+ )
424
+ : null;
425
+
426
+ return layer(
427
+ <aside
428
+ aria-label={title ?? l("base.agent")}
429
+ data-agent-ui=""
430
+ className={cn(
431
+ "flex flex-col overflow-hidden border border-border bg-background",
432
+ inline ? "h-full w-full rounded-box" : [panelLayer, panelSize, "shadow-xl"],
433
+ files.dragging && "border-primary ring-2 ring-primary/40",
434
+ className,
435
+ panelClassName,
436
+ )}
437
+ role="dialog"
438
+
439
+ style={inline ? undefined : { paddingBottom: keyboardInset || undefined }}
440
+ {...files.dropProps}
441
+ >
442
+ {chrome ? (
443
+ <header className="flex items-center gap-2 border-foreground/5 border-b px-4 py-3">
444
+ <span className="font-semibold text-sm">{title ?? l("base.agent")}</span>
445
+ {session.isRunning ? <span className="size-2 animate-pulse rounded-full bg-primary" /> : null}
446
+ {tokens ? (
447
+ <span className="shrink-0 whitespace-nowrap text-[10px] text-foreground/40">
448
+ {l("base.agentTokens", { count: tokenCount(tokens) })}
449
+ </span>
450
+ ) : null}
451
+ <span className="ml-auto flex items-center gap-2">
452
+ {header}
453
+ {session.messages.length ? (
454
+ <button
455
+ aria-label={l("base.agentClear")}
456
+ className="text-foreground/50 hover:text-foreground"
457
+ onClick={() => {
458
+ files.clear();
459
+ void session.reset();
460
+ }}
461
+ type="button"
462
+ >
463
+ <AiOutlineClear />
464
+ </button>
465
+ ) : null}
466
+ {closable ? (
467
+ <button
468
+ aria-label={l("base.cancel")}
469
+ className="text-foreground/50 hover:text-foreground"
470
+ onClick={dismiss}
471
+ type="button"
472
+ >
473
+ <AiOutlineClose />
474
+ </button>
475
+ ) : null}
476
+ </span>
477
+ </header>
478
+ ) : null}
479
+ <div
480
+ aria-busy={session.isRunning}
481
+ aria-live="polite"
482
+ className="scrollbar-thin flex flex-1 flex-col gap-2 overflow-y-auto px-4 py-3"
483
+ onScroll={() => {
484
+ const list = listRef.current;
485
+ if (list) sticky.current = list.scrollHeight - list.scrollTop - list.clientHeight < stickyEdge;
486
+ }}
487
+ ref={listRef}
488
+ role="log"
489
+ >
490
+ {bubbles.length
491
+ ? bubbles
492
+ : (intro ?? <p className="py-6 text-center text-foreground/40 text-sm">{l("base.agentIntro")}</p>)}
493
+ {session.isCompacting ? (
494
+ <p className="flex items-center gap-2 text-foreground/50 text-xs">
495
+ <span className="size-1.5 shrink-0 animate-pulse rounded-full bg-primary" />
496
+ {l("base.agentSummarizing")}
497
+ </p>
498
+ ) : null}
499
+ </div>
500
+ {session.pendingApproval ? <Approval approval={session.pendingApproval} /> : null}
501
+ {session.pendingQuestion ? (
502
+ <Question key={session.pendingQuestion.callId} question={session.pendingQuestion} />
503
+ ) : null}
504
+ <Menu onPick={(row) => row.pick()} rows={menu.rows} selected={menu.selected} />
505
+ <Composer
506
+ attached={files.attached}
507
+ draft={draft}
508
+ inputRef={inputRef}
509
+ {...(speech.canListen ? { mic: { listening: speech.listening, onToggle: speech.toggle } } : {})}
510
+ onDraft={write}
511
+ onFiles={(picked) => void files.add(picked)}
512
+ onKeyDown={onKeyDown}
513
+ onRemoveFile={files.remove}
514
+ onSend={send}
515
+ onStop={() => {
516
+ speech.silence();
517
+ session.abort();
518
+ }}
519
+ session={session}
520
+ />
521
+ </aside>,
522
+ );
523
+ };
524
+
525
+ export default createOverridable("AgentChat", DefaultChat);
@@ -0,0 +1,141 @@
1
+ import { AgentSession, type ChatMessage } from "../../vendor/use-agentic";
2
+
3
+ export interface ChatCommandContext {
4
+ session: AgentSession;
5
+ l: (key: string) => string;
6
+ }
7
+
8
+ export interface ChatCommand {
9
+ name: string;
10
+ /** Accepted but not listed: one row per command, so the menu names each thing once. */
11
+ aliases?: string[];
12
+ description: string;
13
+ run: (context: ChatCommandContext) => void | Promise<void>;
14
+ }
15
+
16
+ /**
17
+ * The chat's own slash commands, the client-side peer of `AgentPrompts`. They join the same `/` menu a prompt
18
+ * endpoint appears in and are dispatched ahead of one: a built-in wins a name collision because the user typed it,
19
+ * and no library's prompt may take `/new` away from them — the mirror image of the tool rule, where a component's
20
+ * own `st.tool` shadows a built-in it means to replace.
21
+ *
22
+ * Output goes through `session.note`, never `send`: a command is answered by this browser, so its text belongs in
23
+ * the transcript the user reads and nowhere in the history the model reads.
24
+ */
25
+ export class ChatCommands {
26
+ static list(l: (key: string) => string): ChatCommand[] {
27
+ return [
28
+ {
29
+ name: "new",
30
+ aliases: ["clear"],
31
+ description: l("base.agentCmdNew"),
32
+ run: async ({ session }) => {
33
+ await session.reset();
34
+ },
35
+ },
36
+ {
37
+ name: "retry",
38
+ description: l("base.agentCmdRetry"),
39
+ run: async ({ session, l: t }) => {
40
+
41
+ if (session.isRunning) session.note(t("base.agentBusy"));
42
+ else if (!(await session.retry())) session.note(t("base.agentNothingToRetry"));
43
+ },
44
+ },
45
+ {
46
+ name: "compact",
47
+ description: l("base.agentCmdCompact"),
48
+ run: async ({ session, l: t }) => {
49
+ if (session.isRunning) session.note(t("base.agentBusy"));
50
+ else if (await session.compact()) session.note(t("base.agentCompacted"));
51
+ else session.note(t("base.agentNothingToCompact"));
52
+ },
53
+ },
54
+ { name: "copy", description: l("base.agentCmdCopy"), run: (context) => ChatCommands.#copy(context) },
55
+ { name: "help", description: l("base.agentCmdHelp"), run: (context) => ChatCommands.#help(context) },
56
+ { name: "tools", description: l("base.agentCmdTools"), run: (context) => ChatCommands.#tools(context) },
57
+ ];
58
+ }
59
+
60
+ static find(name: string, l: (key: string) => string): ChatCommand | null {
61
+ return ChatCommands.list(l).find((command) => command.name === name || command.aliases?.includes(name)) ?? null;
62
+ }
63
+
64
+ /** A command is user-typed, so a failure inside one lands in the transcript instead of at the page. */
65
+ static async run(command: ChatCommand, context: ChatCommandContext) {
66
+ try {
67
+ await command.run(context);
68
+ } catch (error) {
69
+ context.session.report(error instanceof Error ? error.message : String(error));
70
+ }
71
+ }
72
+
73
+ /**
74
+ * The conversation as markdown. The relay is stateless and the transcript lives only in this browser, so an
75
+ * export is the only way a wrong answer can reach whoever could fix it — which is why the header carries where
76
+ * and when it happened. Local notes are left out: they are this chat talking to itself.
77
+ */
78
+ static transcriptOf(messages: readonly ChatMessage[], where = ""): string {
79
+ const lines = [`# Agent conversation`, [where, new Date().toISOString()].filter(Boolean).join(" · "), ""];
80
+ for (const message of messages) {
81
+ if (message.local) continue;
82
+
83
+ lines.push(`**${message.summary ? "summary" : message.role}**`);
84
+ if (message.text) lines.push(message.text);
85
+ for (const attachment of message.attachments ?? [])
86
+ lines.push(`- attached \`${attachment.name}\` (${attachment.mimeType})`);
87
+ for (const call of message.toolCalls ?? []) lines.push(`- call \`${call.name}\` ${JSON.stringify(call.args)}`);
88
+ for (const result of message.toolResults ?? [])
89
+ lines.push(
90
+ `- ${result.error ? "error" : "result"} \`${result.name}\` ${result.error ?? JSON.stringify(result.result ?? null)}`,
91
+ );
92
+ if (message.error) lines.push(`- failed: ${message.error}`);
93
+ lines.push("");
94
+ }
95
+ return lines.join("\n").trim();
96
+ }
97
+
98
+ static async #copy({ session, l }: ChatCommandContext) {
99
+ const where = typeof location === "undefined" ? "" : location.href;
100
+ try {
101
+ await navigator.clipboard.writeText(ChatCommands.transcriptOf(session.messages, where));
102
+ session.note(l("base.agentCopied"));
103
+ } catch {
104
+
105
+ session.note(l("base.agentCopyFailed"));
106
+ }
107
+ }
108
+
109
+ static #help({ session, l }: ChatCommandContext) {
110
+ const rows = ChatCommands.list(l).map((command) => `- \`/${command.name}\` — ${command.description}`);
111
+ session.note([l("base.agentHelpIntro"), ...rows, "", l("base.agentHelpNote")].join("\n"));
112
+ }
113
+
114
+ /**
115
+ * What this screen published, read off the session's own surface — a zone chat therefore lists its zone's view.
116
+ * `askUser` is the session's rather than the surface's, so it is added here the same way the turn adds it.
117
+ */
118
+ static #tools({ session, l }: ChatCommandContext) {
119
+ const { tools, resources } = session.surface.snapshot();
120
+ const published = tools.some((tool) => tool.name === AgentSession.askUserTool.name)
121
+ ? [...tools]
122
+ : [...tools, AgentSession.askUserTool];
123
+ const rows = published
124
+ .sort((a, b) => (a.name < b.name ? -1 : 1))
125
+ .map((tool) => `- \`${tool.name}\`${tool.description ? ` — ${ChatCommands.#sentence(tool.description)}` : ""}`);
126
+ const keys = resources.map((resource) => `\`${resource.name}\``).sort((a, b) => (a < b ? -1 : 1));
127
+ session.note(
128
+ [
129
+ l("base.agentToolsHead"),
130
+ ...rows,
131
+ ...(keys.length ? ["", l("base.agentToolsState"), keys.join(", ")] : []),
132
+ ].join("\n"),
133
+ );
134
+ }
135
+
136
+ /** A tool description is written for a model and runs long; the menu row wants its first sentence. */
137
+ static #sentence(text: string) {
138
+ const first = text.split(/(?<=[.!?])\s/)[0].trim();
139
+ return first.length > 120 ? `${first.slice(0, 117)}...` : first;
140
+ }
141
+ }