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,91 @@
1
+ import { type ReactNode } from "react";
2
+ import { type AgentRunner, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
3
+ import type { AttachReader } from "./attachment.d.ts";
4
+ import type { PersistOption } from "./sessionHistory.d.ts";
5
+ import type { BuiltinOption } from "./sessionView.d.ts";
6
+ import type { VoiceEngine } from "./voice.d.ts";
7
+ export interface ChatProps {
8
+ /** Reaches whichever surface is showing — the launcher while closed, the panel while open. */
9
+ className?: string;
10
+ title?: string;
11
+ /** App-global framing. Route-scoped guidance layers on it through mounted `Agent.Guide`s. */
12
+ instructions?: string;
13
+ /** Swap the transport; the default drives the app's `runAgentTurn` endpoint. */
14
+ runner?: AgentRunner;
15
+ maxTurns?: number;
16
+ /**
17
+ * When the conversation summarizes itself to stay inside the model's window — `at` estimated tokens, `keep`
18
+ * messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
19
+ */
20
+ compact?: CompactOptions;
21
+ /**
22
+ * Which of the runtime's own tools this chat's agent gets — all of them by default, `false` none, an array
23
+ * exactly the ones it names. A chat that must not leave the screen it is on drops `navigate` and `goBack`.
24
+ */
25
+ builtins?: BuiltinOption;
26
+ /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
27
+ onCompact?: AgentSessionOptions["onCompact"];
28
+ defaultOpen?: boolean;
29
+ /**
30
+ * Controlled open state. Pass it with `onOpenChange` to drive the panel from the app's own control — a header
31
+ * button, a menu item — instead of the built-in launcher. Left off, the panel owns the state as before.
32
+ */
33
+ open?: boolean;
34
+ /**
35
+ * Left off while `open` is controlled, the panel cannot close itself — so it draws **no close button** rather
36
+ * than an inert one. That is the shape of a fixed panel with nowhere to close to, and it is also what keeps a
37
+ * controlled chat assemblable by a server component, since this is the only prop here that is a function.
38
+ */
39
+ onOpenChange?: (open: boolean) => void;
40
+ /** `false` draws no launcher, for an app that opens the panel from a control of its own. */
41
+ launcher?: boolean;
42
+ /**
43
+ * Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab, or
44
+ * a `SessionHistory` of the app's own to keep it anywhere else, a server included.
45
+ *
46
+ * Ignored, like every session option above it, when an enclosing `Agent.Zone` or `AgentProvider` already holds a
47
+ * session: this chat then binds to that one, and the options belong to whoever built it.
48
+ */
49
+ persist?: PersistOption | SessionHistory;
50
+ /** Renders in the page flow instead of floating above it — a zone chat that lives inside its own section. */
51
+ inline?: boolean;
52
+ /** `false` gives the browser its own Cmd/Ctrl+L back, for an app whose shell already spends that chord. */
53
+ shortcut?: boolean;
54
+ /** One surface each, where `className` reaches both. */
55
+ launcherClassName?: string;
56
+ panelClassName?: string;
57
+ /** Shown in place of the intro line while the transcript is empty — where starter questions go. */
58
+ intro?: ReactNode;
59
+ /** Extra header controls, left of the built-in clear and close buttons. */
60
+ header?: ReactNode;
61
+ /**
62
+ * `false` draws no header bar at all — for an `inline` chat inside a panel the app already titles. The extra
63
+ * `header` controls go with it, and the clear action stays reachable as the `/new` command.
64
+ */
65
+ chrome?: boolean;
66
+ /** The composer's opening text, read once at mount — where a `?prompt=` lands without sending it. */
67
+ defaultDraft?: string;
68
+ /**
69
+ * Reads a file the user attached into an attachment, or answers `null` to leave it to the built-in reader
70
+ * (images as bytes, text as text). This is where an app puts what needs a parser — a PDF's text, a spreadsheet's
71
+ * cells — since the framework carries attachments but depends on nothing that can extract one. It runs before
72
+ * the built-in, so it can also replace how an image is prepared.
73
+ */
74
+ attach?: AttachReader;
75
+ /**
76
+ * Speech in and out. The engine listens and speaks; this component decides when — a press-to-talk microphone
77
+ * whose transcript lands in the composer for the user to correct, and a reply read aloud **only when the ask
78
+ * itself came in by voice**, so a typed question never turns the speakers on.
79
+ */
80
+ voice?: VoiceEngine;
81
+ }
82
+ /**
83
+ * The user-facing half of the in-page agent: one floating chat wired to the same surface the dock inspects.
84
+ * The conversation loop runs in this browser session — every tool call executes here, gated by the approval
85
+ * card — and the session lives in a ref, so it survives reopening the panel and dies with the page unless
86
+ * `persist` keeps it. An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps
87
+ * the loop while keeping this UI.
88
+ */
89
+ export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, compact, builtins, onCompact, defaultOpen, open: openProp, onOpenChange, launcher, persist, inline, shortcut, launcherClassName, panelClassName, intro, header, chrome, defaultDraft, attach, voice, }: ChatProps) => ReactNode;
90
+ declare const _default: import("react").ComponentType<ChatProps>;
91
+ export default _default;
@@ -0,0 +1,34 @@
1
+ import { AgentSession, type ChatMessage } from "../../vendor/use-agentic.d.ts";
2
+ export interface ChatCommandContext {
3
+ session: AgentSession;
4
+ l: (key: string) => string;
5
+ }
6
+ export interface ChatCommand {
7
+ name: string;
8
+ /** Accepted but not listed: one row per command, so the menu names each thing once. */
9
+ aliases?: string[];
10
+ description: string;
11
+ run: (context: ChatCommandContext) => void | Promise<void>;
12
+ }
13
+ /**
14
+ * The chat's own slash commands, the client-side peer of `AgentPrompts`. They join the same `/` menu a prompt
15
+ * endpoint appears in and are dispatched ahead of one: a built-in wins a name collision because the user typed it,
16
+ * and no library's prompt may take `/new` away from them — the mirror image of the tool rule, where a component's
17
+ * own `st.tool` shadows a built-in it means to replace.
18
+ *
19
+ * Output goes through `session.note`, never `send`: a command is answered by this browser, so its text belongs in
20
+ * the transcript the user reads and nowhere in the history the model reads.
21
+ */
22
+ export declare class ChatCommands {
23
+ #private;
24
+ static list(l: (key: string) => string): ChatCommand[];
25
+ static find(name: string, l: (key: string) => string): ChatCommand | null;
26
+ /** A command is user-typed, so a failure inside one lands in the transcript instead of at the page. */
27
+ static run(command: ChatCommand, context: ChatCommandContext): Promise<void>;
28
+ /**
29
+ * The conversation as markdown. The relay is stateless and the transcript lives only in this browser, so an
30
+ * export is the only way a wrong answer can reach whoever could fix it — which is why the header carries where
31
+ * and when it happened. Local notes are left out: they are this chat talking to itself.
32
+ */
33
+ static transcriptOf(messages: readonly ChatMessage[], where?: string): string;
34
+ }
@@ -0,0 +1,23 @@
1
+ import { type KeyboardEvent, type RefObject } from "react";
2
+ import type { AgentSession, MessageAttachment } from "../../vendor/use-agentic.d.ts";
3
+ export interface ComposerProps {
4
+ className?: string;
5
+ session: AgentSession;
6
+ draft: string;
7
+ attached: readonly MessageAttachment[];
8
+ /** Absent when the screen cannot listen — the same rule as publishing no tool for a control that is not drawn. */
9
+ mic?: {
10
+ listening: boolean;
11
+ onToggle: () => void;
12
+ };
13
+ onDraft: (text: string) => void;
14
+ onKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
15
+ onFiles: (files: File[]) => void;
16
+ onRemoveFile: (idx: number) => void;
17
+ onSend: () => void;
18
+ onStop: () => void;
19
+ inputRef?: RefObject<HTMLTextAreaElement | null>;
20
+ }
21
+ /** What the user writes with: the staged files above, and the controls that send or stop below them. */
22
+ export declare const DefaultComposer: ({ className, session, draft, attached, mic, onDraft, onKeyDown, onFiles, onRemoveFile, onSend, onStop, inputRef, }: ComposerProps) => import("react/jsx-runtime").JSX.Element;
23
+ export declare const Composer: import("react").ComponentType<ComposerProps>;
@@ -0,0 +1,13 @@
1
+ interface ContextProps {
2
+ className?: string;
3
+ }
4
+ /**
5
+ * Assembles and shows exactly what a turn would carry, on demand — the one preview of "what does the agent see on
6
+ * this screen" that no amount of reading the source answers.
7
+ *
8
+ * The tool list leads, by name only: a zone publishes its tools scope-prefixed, and instructions that name a tool
9
+ * without its prefix name a tool that does not exist. That is invisible in the source of either file and obvious
10
+ * here. Renders nothing on `AKAN_PUBLIC_ENV=main`.
11
+ */
12
+ export default function Context({ className }: ContextProps): import("react/jsx-runtime").JSX.Element | null;
13
+ export {};
@@ -0,0 +1,17 @@
1
+ import { type AgentBridge } from "akanjs/store";
2
+ import { AgenticSurface } from "../../vendor/use-agentic.d.ts";
3
+ export interface DockProps {
4
+ className?: string;
5
+ /** The store keys and their masking. Defaults to the app's own. */
6
+ bridge?: AgentBridge;
7
+ /** Where the declared tools live. Pass a zone's own to inspect it; defaults to the whole screen's. */
8
+ surface?: AgenticSurface;
9
+ open?: boolean;
10
+ }
11
+ /**
12
+ * The in-page surface of the agent: what this screen declared an agent may do, what it may read, and what it has
13
+ * done. Tools come from the surface rather than from the store, because a tool exists only where a component
14
+ * declared one — the dock is the way to see that this screen published what its author thought it did, which is
15
+ * the one thing no amount of reading the source answers. Renders nothing on `AKAN_PUBLIC_ENV=main`.
16
+ */
17
+ export declare const Dock: ({ className, bridge, surface, open }: DockProps) => import("react/jsx-runtime").JSX.Element | null;
@@ -0,0 +1,9 @@
1
+ export interface GuideProps {
2
+ instructions: string;
3
+ }
4
+ /**
5
+ * Standing agent guidance scoped to a route subtree: render it from a `_layout.tsx` or a page and the text joins
6
+ * the turn's instructions while that subtree is mounted. Nesting layers naturally — each mounted Guide contributes
7
+ * its block, and navigating away withdraws it. Renders nothing.
8
+ */
9
+ export declare const Guide: ({ instructions }: GuideProps) => null;
@@ -0,0 +1,26 @@
1
+ import { type AgentSessionOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
2
+ export interface HistoryProps {
3
+ load: SessionHistory["load"];
4
+ save: SessionHistory["save"];
5
+ clear: SessionHistory["clear"];
6
+ /** Where a host with its own server-side summary moves its watermark — see `onCompact` on the session options. */
7
+ onCompact?: AgentSessionOptions["onCompact"];
8
+ }
9
+ /**
10
+ * Puts the enclosing zone's transcript wherever the app keeps it, as a mounted component rather than a prop.
11
+ *
12
+ * `persist` does the same thing and has to be passed to whoever builds the session, which makes every ancestor up
13
+ * to that point a client component — a function cannot cross the server/client boundary as a prop. Mounted here
14
+ * instead, the only client module an app needs is this leaf, and `Agent.Zone` and the chat inside it can be
15
+ * assembled by a server component. Same shape as `Agent.Guide`, and it renders nothing.
16
+ *
17
+ * Restoring follows the session's one rule: it lands only while nothing has happened to the conversation yet, so
18
+ * mounting with the zone restores and mounting later saves from there on.
19
+ *
20
+ * The store is attached for exactly as long as this is mounted. A zone's own session dies with it, so that is the
21
+ * whole story there — but a session the app handed in (`Agent.Zone`'s `session` prop) outlives this, and its
22
+ * saving stops on unmount: nothing is claiming to persist it any more, and a component that is gone should not
23
+ * still be writing. A host that wants the store to outlive the view calls `session.setHistory` itself, which also
24
+ * takes the slot, so a later unmount here leaves it alone.
25
+ */
26
+ export declare const History: ({ load, save, clear, onCompact }: HistoryProps) => null;
@@ -0,0 +1,16 @@
1
+ import type { Ref } from "react";
2
+ export interface LauncherProps {
3
+ className?: string;
4
+ label: string;
5
+ /** The chord that opens the chat, shown on hover. Null until the platform is known, which needs the client. */
6
+ hotkey?: {
7
+ label: string;
8
+ keys: string;
9
+ } | null;
10
+ /** Messages that arrived while the panel was closed, so a finished turn is not silent. */
11
+ unread: number;
12
+ onOpen: () => void;
13
+ buttonRef?: Ref<HTMLButtonElement>;
14
+ }
15
+ export declare const DefaultLauncher: ({ className, label, hotkey, unread, onOpen, buttonRef }: LauncherProps) => import("react/jsx-runtime").JSX.Element;
16
+ export declare const Launcher: import("react").ComponentType<LauncherProps>;
@@ -0,0 +1,19 @@
1
+ export interface CodeProps {
2
+ className?: string;
3
+ /** The fence's info word, kept so a highlighter bound to this slot knows what it was handed. */
4
+ lang?: string;
5
+ text: string;
6
+ }
7
+ export declare const DefaultCode: ({ className, lang, text }: CodeProps) => import("react/jsx-runtime").JSX.Element;
8
+ export interface MarkdownProps {
9
+ className?: string;
10
+ children: string;
11
+ }
12
+ /**
13
+ * The chat's own markdown renderer: React elements, never `dangerouslySetInnerHTML`, and no parser dependency.
14
+ * `Bun.markdown` is the obvious candidate and cannot serve this — it is a runtime API the bundler passes through
15
+ * verbatim, so it is undefined in the browser, and assistant text arrives here as SSE deltas the client accrues.
16
+ */
17
+ export declare const DefaultMarkdown: ({ className, children }: MarkdownProps) => import("react/jsx-runtime").JSX.Element;
18
+ declare const _default: import("react").ComponentType<MarkdownProps>;
19
+ export default _default;
@@ -0,0 +1,18 @@
1
+ export interface MenuRow {
2
+ name: string;
3
+ description?: string;
4
+ /** The argument names a prompt takes, shown so a user knows what to type after the name. */
5
+ hint?: string;
6
+ pick: () => void;
7
+ }
8
+ export interface MenuProps {
9
+ className?: string;
10
+ rows: MenuRow[];
11
+ /** Index the arrows are on. Enter picks it and Tab completes its name, so it has to be visible. */
12
+ selected: number;
13
+ onPick: (row: MenuRow) => void;
14
+ }
15
+ /** The `/` menu: this chat's own commands first, then the app's `prompt()` endpoints. */
16
+ export declare const DefaultMenu: ({ className, rows, selected, onPick }: MenuProps) => import("react/jsx-runtime").JSX.Element | null;
17
+ declare const _default: import("react").ComponentType<MenuProps>;
18
+ export default _default;
@@ -0,0 +1,8 @@
1
+ interface MicProps {
2
+ className?: string;
3
+ listening: boolean;
4
+ label: string;
5
+ onToggle: () => void;
6
+ }
7
+ export declare const Mic: ({ className, listening, label, onToggle }: MicProps) => import("react/jsx-runtime").JSX.Element;
8
+ export {};
@@ -0,0 +1,14 @@
1
+ import type { PendingQuestion } from "../../vendor/use-agentic.d.ts";
2
+ export interface QuestionProps {
3
+ className?: string;
4
+ question: PendingQuestion;
5
+ }
6
+ /**
7
+ * The agent's question, parked above the composer while the loop waits on it. Only the picks live here — the
8
+ * composer below is the free-text answer, so the panel never grows a second input meaning the same thing. There is
9
+ * always that way out of the options: the model wrote them, and only the user knows whether the answer is among
10
+ * them. Mounted keyed by call id, so a second ask starts with nothing picked.
11
+ */
12
+ export declare const DefaultQuestion: ({ className, question }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
13
+ declare const _default: import("react").ComponentType<QuestionProps>;
14
+ export default _default;
@@ -0,0 +1,10 @@
1
+ import type { ReactNode } from "react";
2
+ interface SectionProps {
3
+ className?: string;
4
+ title: string;
5
+ count: number;
6
+ children: ReactNode;
7
+ open?: boolean;
8
+ }
9
+ export default function Section({ className, title, count, children, open }: SectionProps): import("react/jsx-runtime").JSX.Element;
10
+ export {};
@@ -0,0 +1,22 @@
1
+ import type { ReactNode } from "react";
2
+ export interface SkipProps {
3
+ className?: string;
4
+ /**
5
+ * What `readScreen` prints in place of the region, and the name `section` takes to read it anyway. Required
6
+ * because the marker is the whole point: an unnamed one tells the agent a region exists and nothing about it.
7
+ */
8
+ label: string;
9
+ children: ReactNode;
10
+ }
11
+ /**
12
+ * A region the default `readScreen` leaves out, for chrome that costs the agent tokens and answers nothing — a
13
+ * footer, a cookie banner, a repeated nav. What stands in its place is `[skipped: <label>]`, so an agent asked
14
+ * about the footer says it did not read one instead of reporting that the page has none, and `section: "<label>"`
15
+ * reads it on request.
16
+ *
17
+ * **This hides text, not behaviour.** Tools and state keys are declarations, not markup: an `st.tool` inside here
18
+ * is published exactly as before, and `highlight` still reaches a control in here. It renders a wrapper element,
19
+ * so where a div between a flex container and its children would move the layout, put the attribute on the element
20
+ * the page already renders — `<footer data-agent-skip="site footer">`.
21
+ */
22
+ export declare const Skip: ({ className, label, children }: SkipProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,16 @@
1
+ import type { AgentBridge, SerializedStoreState } from "akanjs/store";
2
+ interface StateKeyProps {
3
+ className?: string;
4
+ bridge: AgentBridge;
5
+ name: string;
6
+ entry: SerializedStoreState;
7
+ live?: boolean;
8
+ }
9
+ /**
10
+ * One readable state key, read on demand rather than rendered with the rest.
11
+ *
12
+ * Reading is where masking happens, so a key that holds an object no model claims refuses here instead of in the
13
+ * catalogue — whether it is readable depends on what is in it, which the catalogue cannot know ahead of time.
14
+ */
15
+ export default function StateKey({ className, bridge, name, entry, live }: StateKeyProps): import("react/jsx-runtime").JSX.Element;
16
+ export {};
@@ -0,0 +1,15 @@
1
+ import type { PublishedTool, SurfaceView } from "../../vendor/use-agentic.d.ts";
2
+ interface ToolProps {
3
+ className?: string;
4
+ surface: SurfaceView;
5
+ tool: PublishedTool;
6
+ onRun: () => void;
7
+ }
8
+ /**
9
+ * One declared tool, with the arguments as JSON rather than as a generated form.
10
+ *
11
+ * A form per argument is what the API explorer does, and it is the wrong trade here: the point of the dock is to
12
+ * watch a call land in the running app, and every schema shape a component declares is already legible as JSON.
13
+ */
14
+ export default function Tool({ className, surface, tool, onRun }: ToolProps): import("react/jsx-runtime").JSX.Element;
15
+ export {};
@@ -0,0 +1,13 @@
1
+ import type { AgentCall } from "../../vendor/use-agentic.d.ts";
2
+ interface TranscriptProps {
3
+ className?: string;
4
+ calls: readonly AgentCall[];
5
+ }
6
+ /**
7
+ * What the agent did, newest last, so the user can check it against what they saw the page do.
8
+ *
9
+ * There is no undo here. Every model removal in this framework is soft, so one is possible in principle, but which
10
+ * writes are reversible is a per-module judgement and `local/agent-native/PLAN.md` §9-3 leaves it open.
11
+ */
12
+ export default function Transcript({ className, calls }: TranscriptProps): import("react/jsx-runtime").JSX.Element;
13
+ export {};
@@ -0,0 +1,48 @@
1
+ import { type ReactNode } from "react";
2
+ import { type AgentRunner, type AgentSession, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
3
+ import type { PersistOption } from "./sessionHistory.d.ts";
4
+ import type { BuiltinOption } from "./sessionView.d.ts";
5
+ export interface ZoneProps {
6
+ className?: string;
7
+ /** Names the zone; the scope id and the `data-agent-zone` container both derive from it. */
8
+ id: string;
9
+ label?: string;
10
+ /** Zone-scoped guidance — a mounted Guide, so the root agent reads it too (ancestor rule), a sibling zone never does. */
11
+ instructions?: string;
12
+ runner?: AgentRunner;
13
+ maxTurns?: number;
14
+ /** When this zone's conversation summarizes itself — same contract as the chat's own `compact`. */
15
+ compact?: CompactOptions;
16
+ /**
17
+ * Which of the runtime's own tools this zone's agent gets — all of them by default, `false` none, an array
18
+ * exactly the ones it names. `builtins={["readScreen", "readState"]}` is how a zone that must not leave the
19
+ * screen stops being able to: the tools are withheld, not discouraged, so a prompt cannot talk the model past it.
20
+ */
21
+ builtins?: BuiltinOption;
22
+ /**
23
+ * Keeps this zone's transcript across reloads, keyed by the zone's scope path — web storage by default, or a
24
+ * `SessionHistory` of the app's own to keep it anywhere else, a server included.
25
+ */
26
+ persist?: PersistOption | SessionHistory;
27
+ /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
28
+ onCompact?: AgentSessionOptions["onCompact"];
29
+ /**
30
+ * Runs this zone on a session the app built instead of one of its own, and the app then owns it: unmounting the
31
+ * zone leaves it running. Read once at mount, like every other session option here.
32
+ */
33
+ session?: AgentSession;
34
+ /** Hands the session out once it exists, for a page or store that wants to send into it or watch it. */
35
+ onSession?: (session: AgentSession) => void;
36
+ children: ReactNode;
37
+ }
38
+ /**
39
+ * A zone agent: one subtree with its own conversation over a scoped view of the same surface. Everything mounted
40
+ * inside — hook tools, `st.use` subscriptions, guides — belongs to this zone's session *and* to the root agent:
41
+ * zones are views, never walls. An `Agent.Chat` mounted inside binds to this session automatically, so two zones
42
+ * on one screen run two conversations in parallel, each seeing only its own subtree.
43
+ *
44
+ * **Everything a zone publishes is named `<id>.<name>`.** Instructions that name a tool must carry the prefix —
45
+ * a bare name is a tool that does not exist, and the model calling it spends a turn on `Unknown tool`. Build the
46
+ * name from the id rather than writing it twice, and read `Agent.Context`'s Assemble to see the published list.
47
+ */
48
+ export declare const Zone: ({ className, id, label, instructions, runner, maxTurns, compact, builtins, persist, onCompact, session: provided, onSession, children, }: ZoneProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,27 @@
1
+ import { type AgentRunner, AgentSession, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
2
+ import { type PersistOption } from "./sessionHistory.d.ts";
3
+ import { type BuiltinOption } from "./sessionView.d.ts";
4
+ export interface AgentSessionSetup {
5
+ /** Read per call rather than captured, so text the session builds follows a language switched mid-conversation. */
6
+ l: (key: string) => string;
7
+ /** The zone's scope path, empty for the root agent — it picks both the surface view and the persistence key. */
8
+ view?: string[];
9
+ runner?: AgentRunner;
10
+ instructions?: string;
11
+ maxTurns?: number;
12
+ compact?: CompactOptions;
13
+ /**
14
+ * Which of the runtime's own tools this session gets: all of them by default, none with `false`, exactly the
15
+ * ones an array names. A zone whose conversation must stay on one screen takes `navigate` and `goBack` off it.
16
+ */
17
+ builtins?: BuiltinOption;
18
+ /** Web storage by default; a `SessionHistory` puts the transcript wherever the app keeps it, including a server. */
19
+ persist?: PersistOption | SessionHistory;
20
+ /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
21
+ onCompact?: AgentSessionOptions["onCompact"];
22
+ }
23
+ /**
24
+ * The one place a chat session is wired to the akan runtime. Chat and Zone both build one, and building it twice
25
+ * is how a zone came to be the only surface with no `compact` option — an option added on one side of a copy.
26
+ */
27
+ export declare const agentSessionOf: ({ l, view, runner, instructions, maxTurns, compact, builtins, persist, onCompact, }: AgentSessionSetup) => AgentSession;
@@ -0,0 +1,34 @@
1
+ import type { MessageAttachment } from "../../vendor/use-agentic.d.ts";
2
+ /** Turns one picked file into an attachment, or `null` to say this reader does not handle that file. */
3
+ export type AttachReader = (file: File) => Promise<MessageAttachment | null>;
4
+ /**
5
+ * Per-file ceiling for the composer. The bytes ride inside one turn's JSON request, so a file past this is not a
6
+ * slow attachment — it is a request the relay and the provider both refuse, and refusing it here is the only place
7
+ * the user learns which file it was.
8
+ */
9
+ export declare const maxAttachmentBytes: number;
10
+ /**
11
+ * Ceilings for one message rather than one file. The bytes ride inside a single turn's JSON, so what a provider
12
+ * refuses is the sum — and a count cap keeps a whole folder dropped onto the panel from becoming one request that
13
+ * cannot be sent and cannot be edited down without starting over.
14
+ */
15
+ export declare const maxMessageAttachmentBytes: number;
16
+ export declare const maxMessageAttachments = 5;
17
+ export type AttachFailure = "tooLarge" | "unsupported";
18
+ export declare class Attachment {
19
+ #private;
20
+ /**
21
+ * Reads what a browser can read on its own — an image as bytes, a text-ish file as text — and hands everything
22
+ * else to the app's own reader. That split is the layer boundary: a PDF needs a parser, so extracting one is the
23
+ * app's business (`attach`), while carrying the result is the framework's.
24
+ *
25
+ * The app's reader runs first so it can also replace the built-in handling, which is what downscaling an image
26
+ * before it costs a megabyte of prompt looks like.
27
+ */
28
+ static read(file: File, attach?: AttachReader): Promise<MessageAttachment | AttachFailure>;
29
+ static failure(value: MessageAttachment | AttachFailure): value is AttachFailure;
30
+ /** What this attachment costs the request: base64 carries three bytes per four characters, less its padding. */
31
+ static bytesOf(attachment: MessageAttachment): number;
32
+ /** Same name and same size is the same file picked twice — the shape a re-drop or a double paste produces. */
33
+ static same(one: MessageAttachment, other: MessageAttachment): boolean;
34
+ }
@@ -0,0 +1,12 @@
1
+ import { type AgentRunner } from "../../vendor/use-agentic.d.ts";
2
+ /**
3
+ * Runs each assistant turn against the app's own `runAgentTurn` route — service signals mount unprefixed, so the
4
+ * URL is `<serverHttpUri>/runAgentTurn` — through the shared `httpRunner`, which negotiates streaming via
5
+ * `accept`: a server that streams answers SSE and the text arrives as it is generated; one that does not answers
6
+ * the same JSON turn. The client runtime's fetch proxy is only probed for whether the endpoint exists (the util
7
+ * lib ships one) and for the signed-in JWT; cookies ride the same-origin request on their own. The endpoint is a
8
+ * stateless relay; the loop and every tool execution stay in this browser session.
9
+ */
10
+ export declare const fetchRunner: (options?: {
11
+ fetcher?: typeof globalThis.fetch;
12
+ }) => AgentRunner;
@@ -0,0 +1,19 @@
1
+ import Context from "./Context.d.ts";
2
+ import Section from "./Section.d.ts";
3
+ import StateKey from "./StateKey.d.ts";
4
+ import Tool from "./Tool.d.ts";
5
+ import Transcript from "./Transcript.d.ts";
6
+ export declare const Agent: {
7
+ Chat: import("react").ComponentType<import("./Chat.d.ts").ChatProps>;
8
+ Context: typeof Context;
9
+ Dock: ({ className, bridge, surface, open }: import("./Dock.d.ts").DockProps) => import("react/jsx-runtime").JSX.Element | null;
10
+ Guide: ({ instructions }: import("./Guide.d.ts").GuideProps) => null;
11
+ History: ({ load, save, clear, onCompact }: import("./History.d.ts").HistoryProps) => null;
12
+ Scope: ({ id, label, kind, children }: import("../../vendor/use-agentic.d.ts").AgentScopeProps) => import("react/jsx-runtime").JSX.Element;
13
+ Section: typeof Section;
14
+ Skip: ({ className, label, children }: import("./Skip.d.ts").SkipProps) => import("react/jsx-runtime").JSX.Element;
15
+ StateKey: typeof StateKey;
16
+ Tool: typeof Tool;
17
+ Transcript: typeof Transcript;
18
+ Zone: ({ className, id, label, instructions, runner, maxTurns, compact, builtins, persist, onCompact, session: provided, onSession, children, }: import("./Zone.d.ts").ZoneProps) => import("react/jsx-runtime").JSX.Element;
19
+ };
@@ -0,0 +1 @@
1
+ export declare const Chat: import("react").ComponentType<import("./Chat.d.ts").ChatProps>;
@@ -0,0 +1,35 @@
1
+ import { type TableBlock } from "./markdownTable.d.ts";
2
+ export interface MarkdownItem {
3
+ depth: number;
4
+ ordered: boolean;
5
+ num: number;
6
+ text: string;
7
+ }
8
+ export type MarkdownBlock = {
9
+ kind: "code";
10
+ lang?: string;
11
+ text: string;
12
+ } | {
13
+ kind: "heading";
14
+ level: number;
15
+ text: string;
16
+ } | {
17
+ kind: "list";
18
+ items: MarkdownItem[];
19
+ } | {
20
+ kind: "quote";
21
+ text: string;
22
+ } | {
23
+ kind: "rule";
24
+ } | {
25
+ kind: "para";
26
+ text: string;
27
+ } | TableBlock;
28
+ /**
29
+ * Block scanner for assistant chat text — the CommonMark subset a model actually emits over this wire.
30
+ */
31
+ export declare class MarkdownBlocks {
32
+ #private;
33
+ static of(source: string): MarkdownBlock[];
34
+ constructor(source: string);
35
+ }
@@ -0,0 +1,2 @@
1
+ import type { ReactNode } from "react";
2
+ export declare const spans: (text: string) => ReactNode[];
@@ -0,0 +1,16 @@
1
+ export type Align = "left" | "center" | "right";
2
+ export interface TableBlock {
3
+ kind: "table";
4
+ aligns: (Align | null)[];
5
+ head: string[];
6
+ rows: string[][];
7
+ }
8
+ /** GFM table scan, kept out of the block scanner because the delimiter row makes it the one shape that has to
9
+ * read the line after the one it starts on. */
10
+ export declare class MarkdownTable {
11
+ #private;
12
+ static at(lines: string[], at: number): {
13
+ block: TableBlock;
14
+ next: number;
15
+ } | null;
16
+ }
@@ -0,0 +1,14 @@
1
+ import { type SessionHistory } from "../../vendor/use-agentic.d.ts";
2
+ export type PersistOption = boolean | {
3
+ storage?: "session" | "local";
4
+ key?: string;
5
+ };
6
+ /**
7
+ * Maps the `persist` prop onto a `SessionHistory` over web storage. Session storage is the default on purpose:
8
+ * surviving a refresh is the whole ask, and a transcript that dies with the tab never lingers on a shared machine
9
+ * or collides across tabs. `"local"` is the explicit opt-up. The envelope is versioned so a wire change discards
10
+ * stale transcripts instead of replaying them, and only the newest messages are kept under the cap — which is
11
+ * why the cap is applied *before* the pairing repair: the window it keeps can start between a tool call and the
12
+ * result answering it, and a transcript restored in that state is refused by the provider on its first turn.
13
+ */
14
+ export declare const sessionHistoryOf: (persist: PersistOption | SessionHistory | undefined, pathKey?: string) => SessionHistory | undefined;
@@ -0,0 +1,15 @@
1
+ import { StoreSurfaceSource } from "akanjs/store";
2
+ import type { AgenticSurface, SurfaceView } from "../../vendor/use-agentic.d.ts";
3
+ /** One of the tools the akan runtime contributes to every screen, whatever that screen declares. */
4
+ export type AgentBuiltin = (typeof StoreSurfaceSource.builtins)[number];
5
+ /** `true` (the default) takes all of them, `false` none, an array exactly the ones it names. */
6
+ export type BuiltinOption = boolean | AgentBuiltin[];
7
+ /**
8
+ * The half of the surface one session reads: scoped to its zone, and narrowed to the built-ins it was given.
9
+ *
10
+ * Narrowing happens here rather than on the source because the source is shared — two sessions read one registry,
11
+ * and a zone that must not navigate away cannot take `navigate` off the screen for the root agent too. A withheld
12
+ * tool is withheld from `call` as well as from the listing, answering the same "unknown tool" a name that was
13
+ * never registered gets: a tool the model can still reach by guessing its name is not withheld.
14
+ */
15
+ export declare const sessionView: (surface: AgenticSurface, path: string[], builtins?: BuiltinOption) => SurfaceView;
@@ -0,0 +1,6 @@
1
+ /**
2
+ * An estimated token count as a chat-sized label. Rounded hard on purpose: the estimate itself is four characters
3
+ * to a token, so a digit-exact figure would claim a precision it does not have — what a reader needs from it is
4
+ * whether a tool result cost a hundred tokens or a million.
5
+ */
6
+ export declare const tokenCount: (count: number) => string;