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
@@ -1,5 +1,4 @@
1
1
  import "dayjs/locale/ko";
2
- import type { ClientEnv } from "akanjs/base";
3
2
  import type { RootLayoutProps, WebAppManifest } from "akanjs/client";
4
3
  import type { AkanTheme } from "akanjs/fetch";
5
4
  import type { ReactNode } from "react";
@@ -14,8 +13,8 @@ export interface ProviderProps {
14
13
  head?: ReactNode;
15
14
  /** Web app manifest emitted as a data URL. */
16
15
  manifest?: WebAppManifest;
17
- /** Client runtime environment injected into the app bridge. */
18
- env: ClientEnv;
16
+ /** App-specific public client config (`env/env.client.ts`) merged over the framework's own `getEnv()`. */
17
+ env?: object;
19
18
  /** Initial Akan theme configuration. */
20
19
  theme?: AkanTheme;
21
20
  /** Optional route prefix/base path. */
@@ -41,7 +40,7 @@ export interface ProviderProps {
41
40
  /** Root route component used by CSR page loading. */
42
41
  of: (props: unknown) => ReactNode | null;
43
42
  }
44
- export declare const Common: () => import("react/jsx-runtime").JSX.Element;
43
+ export declare const Common: () => null;
45
44
  export declare function ManifestLink({ manifest }: {
46
45
  manifest?: WebAppManifest;
47
46
  }): import("react/jsx-runtime").JSX.Element | null;
@@ -1 +1 @@
1
- export declare const Messages: () => import("react/jsx-runtime").JSX.Element | null;
1
+ export declare const Messages: () => import("react").ReactPortal | null;
@@ -4,7 +4,9 @@ export interface ProviderProps {
4
4
  className?: string;
5
5
  /** Initial active menu key. */
6
6
  defaultMenu?: string | null;
7
+ /** Names this tab for the in-page agent. Without it the tab publishes nothing — two tabs on one screen would otherwise share a name. */
8
+ namespace?: string;
7
9
  /** Tab.Menus and Tab.Panel children. */
8
10
  children?: ReactNode;
9
11
  }
10
- export declare const Provider: ({ className, defaultMenu, children }: ProviderProps) => import("react/jsx-runtime").JSX.Element;
12
+ export declare const Provider: ({ className, defaultMenu, namespace, children }: ProviderProps) => import("react/jsx-runtime").JSX.Element;
@@ -1,9 +1,11 @@
1
- import { type RefObject } from "react";
1
+ import type { RefObject } from "react";
2
2
  interface TabContextType {
3
3
  defaultMenu: string | null;
4
4
  menu: string | null;
5
5
  setMenu: (value: string | null) => void;
6
- menuSet: RefObject<Set<string>>;
6
+ /** Every mounted menu key against whether it is disabled — the tab's own vocabulary, for the agent and for the disabled fallback. */
7
+ menus: RefObject<Map<string, boolean>>;
8
+ switchTab: (menu: string) => void;
7
9
  }
8
10
  export declare const TabContext: import("react").Context<TabContextType>;
9
11
  export {};
@@ -11,6 +11,7 @@ export interface ToggleSelectProps<I extends string | number | boolean | null> {
11
11
  nullable: boolean;
12
12
  validate: (value: I) => boolean | string;
13
13
  onChange: (value: I, idx: number) => void;
14
+ onClear?: () => void;
14
15
  disabled?: boolean;
15
16
  }
16
17
  export interface MultiProps {
@@ -1,5 +1,13 @@
1
- import { type ComponentType } from "react";
1
+ import type { ComponentType } from "react";
2
2
  import type { ClassNameValue as ClassValue } from "tailwind-merge";
3
+ import type { ApprovalProps as AgentApprovalProps } from "../Agent/Approval.d.ts";
4
+ import type { BubbleProps as AgentBubbleProps } from "../Agent/Bubble.d.ts";
5
+ import type { ChatProps as AgentChatProps } from "../Agent/Chat.d.ts";
6
+ import type { ComposerProps as AgentComposerProps } from "../Agent/Composer.d.ts";
7
+ import type { LauncherProps as AgentLauncherProps } from "../Agent/Launcher.d.ts";
8
+ import type { CodeProps as AgentCodeProps, MarkdownProps as AgentMarkdownProps } from "../Agent/Markdown.d.ts";
9
+ import type { MenuProps as AgentMenuProps } from "../Agent/Menu.d.ts";
10
+ import type { QuestionProps as AgentQuestionProps } from "../Agent/Question.d.ts";
3
11
  import type { BadgeProps } from "../Badge.d.ts";
4
12
  import type { ButtonProps } from "../Button.d.ts";
5
13
  import type { DatePickerProps, RangePickerProps, TimePickerProps } from "../DatePicker.d.ts";
@@ -45,6 +53,15 @@ export interface AkanUiOverrides {
45
53
  Menu: ComponentType<MenuProps>;
46
54
  Tooltip: ComponentType<TooltipProps>;
47
55
  Unauthorized: ComponentType<UnauthorizedProps>;
56
+ AgentChat: ComponentType<AgentChatProps>;
57
+ AgentLauncher: ComponentType<AgentLauncherProps>;
58
+ AgentBubble: ComponentType<AgentBubbleProps>;
59
+ AgentComposer: ComponentType<AgentComposerProps>;
60
+ AgentApproval: ComponentType<AgentApprovalProps>;
61
+ AgentQuestion: ComponentType<AgentQuestionProps>;
62
+ AgentMenu: ComponentType<AgentMenuProps>;
63
+ AgentMarkdown: ComponentType<AgentMarkdownProps>;
64
+ AgentCode: ComponentType<AgentCodeProps>;
48
65
  Button: ComponentType<ButtonProps<unknown>>;
49
66
  Select: ComponentType<SelectProps<string | number | boolean | null | undefined>>;
50
67
  Input: ComponentType<InputProps>;
@@ -0,0 +1,14 @@
1
+ /**
2
+ * The `data-akan-*` attributes for a handler the caller passed by reference.
3
+ *
4
+ * `{}` when the handler is an inline arrow, which is the honest answer: a closure the caller wrote says nothing
5
+ * about what it does, and a guessed annotation is worse than none. The house form for a model field is the setter
6
+ * itself (`onChange={st.do.setNameOnUser}`), so the fields that matter are annotated without an app writing anything.
7
+ *
8
+ * What it buys, beyond an in-page agent: an accessibility tree and E2E selectors that name the action rather than a
9
+ * class, and an external browser agent — one this framework has no bridge into — reading the same names.
10
+ */
11
+ export declare const agentAttrs: (handler: unknown) => {
12
+ "data-akan-action"?: string;
13
+ "data-akan-state"?: string;
14
+ } | Record<string, never>;
@@ -1,3 +1,23 @@
1
+ export { AgentProvider, type AgentProviderProps, type AgentRunner, AgentSession, type AgentSessionOptions, type ChatMessage, type CompactOptions, type ContextBlock, httpRunner, type PublishedTool, type RunnerEvent, type RunnerRequest, SessionContext, type SessionHistory, type SurfaceView, useAgent, } from "../vendor/use-agentic.d.ts";
2
+ export { Agent } from "./Agent.d.ts";
3
+ export { type ApprovalProps, DefaultApproval } from "./Agent/Approval.d.ts";
4
+ export { type AgentSessionSetup, agentSessionOf } from "./Agent/agentSessionOf.d.ts";
5
+ export { type AttachReader, maxAttachmentBytes } from "./Agent/attachment.d.ts";
6
+ export { type BubbleProps, DefaultBubble } from "./Agent/Bubble.d.ts";
7
+ export type { ChatProps } from "./Agent/Chat.d.ts";
8
+ export { type ChatCommand, ChatCommands } from "./Agent/ChatCommands.d.ts";
9
+ export { type ComposerProps, DefaultComposer } from "./Agent/Composer.d.ts";
10
+ export { fetchRunner } from "./Agent/fetchRunner.d.ts";
11
+ export type { HistoryProps as AgentHistoryProps } from "./Agent/History.d.ts";
12
+ export { DefaultLauncher, type LauncherProps } from "./Agent/Launcher.d.ts";
13
+ export { type CodeProps, DefaultCode, DefaultMarkdown, type MarkdownProps } from "./Agent/Markdown.d.ts";
14
+ export { DefaultMenu, type MenuProps as AgentMenuProps, type MenuRow } from "./Agent/Menu.d.ts";
15
+ export { DefaultQuestion, type QuestionProps } from "./Agent/Question.d.ts";
16
+ export type { PersistOption } from "./Agent/sessionHistory.d.ts";
17
+ export type { AgentBuiltin, BuiltinOption } from "./Agent/sessionView.d.ts";
18
+ export { tokenCount } from "./Agent/tokenCount.d.ts";
19
+ export type { VoiceEngine, VoiceHandlers, VoiceListener, VoiceSpeech } from "./Agent/voice.d.ts";
20
+ export { agentAttrs } from "./agentAttrs.d.ts";
1
21
  export { animated } from "./animated.d.ts";
2
22
  export { Badge } from "./Badge.d.ts";
3
23
  export { BottomSheet, type BottomSheetRef } from "./BottomSheet.d.ts";
@@ -21,6 +41,7 @@ export { InfiniteScroll } from "./InfiniteScroll.d.ts";
21
41
  export { Input } from "./Input.d.ts";
22
42
  export { KeyboardAvoiding } from "./KeyboardAvoiding.d.ts";
23
43
  export { Layout } from "./Layout.d.ts";
44
+ export { LegacyModal } from "./LegacyModal.d.ts";
24
45
  export { Link } from "./Link.d.ts";
25
46
  export { Load } from "./Load.d.ts";
26
47
  export { Loading } from "./Loading.d.ts";
@@ -34,7 +55,7 @@ export { Pagination } from "./Pagination.d.ts";
34
55
  export { Popconfirm } from "./Popconfirm.d.ts";
35
56
  export { Portal } from "./Portal.d.ts";
36
57
  export { Radio } from "./Radio.d.ts";
37
- export { RecentTime } from "./RecentTime.d.ts";
58
+ export { RecentTime, type RecentTimeProps, type RecentTimeRelative, type RecentTimeRelativeFormat, type RecentTimeRelativeStyle, type RecentTimeRelativeUnit, } from "./RecentTime.d.ts";
38
59
  export { Refresh } from "./Refresh.d.ts";
39
60
  export { type BadgeVariants, type ButtonVariants, badgeRecipe, buttonRecipe, type InputSurfaceVariants, inputRecipe, recipe, tv, } from "./recipe.d.ts";
40
61
  export { ScreenNavigator } from "./ScreenNavigator.d.ts";
@@ -8,6 +8,19 @@
8
8
  * recognises its own overlays exactly, instead of guessing from how close a dialog happens to be.
9
9
  */
10
10
  export declare const OVERLAY_LAYER_ATTR = "data-akan-overlay";
11
+ /**
12
+ * Stacking order for overlays that portal to `document.body`, where nesting no longer decides who is on
13
+ * top. A Popconfirm outranks a dropdown menu because `Model.Remove` draws one from inside a menu item,
14
+ * and its scrim outranks the menu so the click that answers the confirm is not also a menu selection.
15
+ * A Select's options stay under both: it is a field, and whatever opened over it took the click that
16
+ * dismisses it.
17
+ */
18
+ export declare const overlayZ: {
19
+ readonly select: 90;
20
+ readonly dropdown: 100;
21
+ readonly popconfirmScrim: 105;
22
+ readonly popconfirm: 110;
23
+ };
11
24
  /** Wrap the content a dismissable container owns, with the scope from {@link useOverlayScope}. */
12
25
  export declare const OverlayOwnerProvider: import("react").Provider<string>;
13
26
  /** Scope a dismissable container hands to its content. Nests as a `parent/child` path. */
@@ -0,0 +1,28 @@
1
+ import { type RefObject } from "react";
2
+ export interface OverlayPosition {
3
+ top: number;
4
+ left: number;
5
+ /** Placed above the trigger, because there was no room below. */
6
+ above: boolean;
7
+ /** The trigger's centre relative to the panel's left edge, held clear of the panel's rounded corners. */
8
+ anchorOffset: number;
9
+ /** The trigger's own width, for a panel that lines up with the control it drops out of. */
10
+ anchorWidth: number;
11
+ }
12
+ /**
13
+ * Places a portalled panel against its trigger in viewport coordinates.
14
+ *
15
+ * A panel positioned inside its own tree is clipped by every `overflow` ancestor it has — the modal
16
+ * surface, the modal's scrolling body, a table's scroll container, the dropdown menu a row verb sits in —
17
+ * so overlay panels portal out to `document.body` and are placed here instead of by CSS.
18
+ * `position: fixed` in place would not do it either: a fixed element inside a transformed ancestor is laid
19
+ * out and clipped by that ancestor, and the modal surface animates a transform.
20
+ */
21
+ export declare const useOverlayPosition: ({ opened, triggerRef, panelRef, align, gap, }: {
22
+ opened: boolean;
23
+ triggerRef: RefObject<HTMLElement | null>;
24
+ panelRef: RefObject<HTMLElement | null>;
25
+ align: "start" | "end";
26
+ /** Distance from the trigger. Raise it for a panel whose pointer sticks out past its own edge. */
27
+ gap?: number;
28
+ }) => OverlayPosition | null;
@@ -2,14 +2,14 @@
2
2
  export declare const badgeRecipe: (variants?: Omit<({
3
3
  size?: "lg" | "md" | "sm" | "xs" | undefined;
4
4
  outline?: boolean | undefined;
5
- variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
5
+ variant?: "default" | "error" | "info" | "success" | "warning" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
6
6
  } & {
7
7
  class?: import("tailwind-variants").ClassValue;
8
8
  className?: never;
9
9
  }) | ({
10
10
  size?: "lg" | "md" | "sm" | "xs" | undefined;
11
11
  outline?: boolean | undefined;
12
- variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
12
+ variant?: "default" | "error" | "info" | "success" | "warning" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
13
13
  } & {
14
14
  class?: never;
15
15
  className?: import("tailwind-variants").ClassValue;
@@ -2,7 +2,7 @@
2
2
  export declare const buttonRecipe: (variants?: Omit<({
3
3
  size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
4
4
  outline?: boolean | undefined;
5
- variant?: "link" | "default" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
5
+ variant?: "link" | "default" | "info" | "success" | "warning" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
6
6
  shape?: "default" | "circle" | "square" | undefined;
7
7
  } & {
8
8
  class?: import("tailwind-variants").ClassValue;
@@ -10,7 +10,7 @@ export declare const buttonRecipe: (variants?: Omit<({
10
10
  }) | ({
11
11
  size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
12
12
  outline?: boolean | undefined;
13
- variant?: "link" | "default" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
13
+ variant?: "link" | "default" | "info" | "success" | "warning" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
14
14
  shape?: "default" | "circle" | "square" | undefined;
15
15
  } & {
16
16
  class?: never;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The abort signal of the tool call running now.
3
+ *
4
+ * Reached through a module slot rather than a parameter for the same reason `AgentProgress` is — work several
5
+ * frames down, a store action or a poll loop, reads it without every signature between here and there growing a
6
+ * channel argument, and a session executes tool calls one at a time. Outside a call `current` is null, so a tool
7
+ * that honours it runs unchanged in a test, under the dock, and on the server.
8
+ *
9
+ * Honouring it is optional: the session races every call against the same signal, so Stop lands whatever a tool
10
+ * does. What reading it buys is the tool's own cleanup — a timer that would otherwise keep ticking for the rest of
11
+ * its timeout with nobody left to answer.
12
+ */
13
+ export declare class AgentAbort {
14
+ #private;
15
+ static get current(): AbortSignal | null;
16
+ static run<T>(signal: AbortSignal, exec: () => Promise<T> | T): Promise<T>;
17
+ }
@@ -0,0 +1,27 @@
1
+ export interface AgentProgressReport {
2
+ /** One short line about the step in flight. Read by the user, not the model — keep it prose. */
3
+ message: string;
4
+ done?: number;
5
+ total?: number;
6
+ }
7
+ /**
8
+ * The progress channel for the tool call running now.
9
+ *
10
+ * Reached through a module slot rather than a parameter so work several frames down — a store action, an upload
11
+ * loop, an adapter — reports without every signature between here and there growing a channel argument. The
12
+ * browser has no `AsyncLocalStorage`, and it needs none: a session executes tool calls one at a time, and `run`
13
+ * saves and restores the slot so a tool that calls another tool through the surface nests correctly.
14
+ *
15
+ * Outside a call `report` is a no-op, so the same code runs unchanged in a test, on the server, and under a host
16
+ * that renders no progress at all.
17
+ */
18
+ export declare class AgentProgress {
19
+ #private;
20
+ static report(message: string, amount?: {
21
+ done?: number;
22
+ total?: number;
23
+ }): void;
24
+ /** True while someone is rendering the reports, for a message that costs something to assemble. */
25
+ static get watching(): boolean;
26
+ static run<T>(sink: (report: AgentProgressReport) => void, exec: () => Promise<T> | T): Promise<T>;
27
+ }
@@ -0,0 +1,17 @@
1
+ import { type ReactNode } from "react";
2
+ import { AgenticSurface } from "./AgenticSurface.d.ts";
3
+ import { AgentSession, type AgentSessionOptions } from "./AgentSession.d.ts";
4
+ import type { AgentRunner } from "./types.d.ts";
5
+ export interface AgentProviderProps extends AgentSessionOptions {
6
+ surface?: AgenticSurface;
7
+ session?: AgentSession;
8
+ runner?: AgentRunner;
9
+ children: ReactNode;
10
+ }
11
+ /**
12
+ * Scopes a subtree onto one surface and, when a runner or session is given, one conversation.
13
+ *
14
+ * Without a provider, hooks land on `AgenticSurface.shared` — a provider exists to isolate, or to hold the session
15
+ * `useAgent` reads.
16
+ */
17
+ export declare const AgentProvider: ({ surface, session, runner, children, ...options }: AgentProviderProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,9 @@
1
+ import { type ReactNode } from "react";
2
+ export interface AgentScopeProps {
3
+ id: string;
4
+ label?: string;
5
+ kind?: string;
6
+ children: ReactNode;
7
+ }
8
+ /** Namespaces every tool and resource registered below it, so list items can reuse local names. */
9
+ export declare const AgentScope: ({ id, label, kind, children }: AgentScopeProps) => import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,163 @@
1
+ import { type AgentProgressReport } from "./AgentProgress.d.ts";
2
+ import { type CompactOptions } from "./Compaction.d.ts";
3
+ import type { AgentRunner, ChatMessage, ContextBlock, PublishedTool, SurfaceView } from "./types.d.ts";
4
+ export interface PendingApproval {
5
+ callId: string;
6
+ name: string;
7
+ args: Record<string, unknown>;
8
+ message: string;
9
+ approve: () => void;
10
+ reject: (reason?: string) => void;
11
+ }
12
+ /**
13
+ * A decision the agent handed back to the user mid-turn. The loop is parked on it until it settles, exactly as it
14
+ * parks on an approval. `choices` is empty for a free-text ask, and `multiple` never accompanies an empty one.
15
+ */
16
+ export interface PendingQuestion {
17
+ callId: string;
18
+ question: string;
19
+ choices: string[];
20
+ multiple: boolean;
21
+ answer: (value: string | string[]) => void;
22
+ dismiss: (reason?: string) => void;
23
+ }
24
+ /**
25
+ * Where a session keeps its transcript across page loads. Storage-neutral: the host decides what backs it, so a
26
+ * server-side transcript is as legal as web storage — which is why every method may answer asynchronously. A
27
+ * `load` still in flight when the user sends the first message is dropped rather than merged: the conversation
28
+ * on screen is the one they are having, and splicing a restored one under it would rewrite what they just said.
29
+ *
30
+ * Which makes **sending on mount a race the restore loses** — an opening prompt fired from an effect beats the
31
+ * fetch, and the user watches the conversation they came back to never arrive. Wait for `isRestoring` to clear,
32
+ * or write the prompt into the composer and leave the send to them.
33
+ */
34
+ export interface SessionHistory {
35
+ load(): ChatMessage[] | null | Promise<ChatMessage[] | null>;
36
+ save(messages: readonly ChatMessage[]): void | Promise<void>;
37
+ clear(): void | Promise<void>;
38
+ }
39
+ export interface AgentSessionOptions {
40
+ instructions?: string;
41
+ buildContext?: (surface: SurfaceView) => ContextBlock[];
42
+ /** Assistant turns per send before the session asks whether to keep going, or stops. */
43
+ maxTurns?: number;
44
+ /**
45
+ * Restores settled messages at construction and saves after every change, debounced. Failures are silent, and
46
+ * saves are chained rather than issued in parallel — an async host would otherwise land them out of order and
47
+ * persist an older transcript last.
48
+ */
49
+ history?: SessionHistory;
50
+ /**
51
+ * Awaited after a tool that changed something and before its change report is taken. A surface is read
52
+ * synchronously and a screen does not settle synchronously, so without this the report describes the moment
53
+ * before the change landed. `ScreenSettle.wait` is what an akan app passes.
54
+ */
55
+ settle?: () => Promise<void> | void;
56
+ /**
57
+ * Turns the turn cap into a question instead of a dead end. Omitted, the cap fails as before — a host that
58
+ * renders no `pendingQuestion` would otherwise wait forever for an answer nobody can give. Read per ask rather
59
+ * than at construction, so the text follows a language switched mid-conversation.
60
+ */
61
+ continueAsk?: () => {
62
+ question: string;
63
+ keep: string;
64
+ };
65
+ /**
66
+ * Keeps a long conversation inside the model's window: past `at` estimated tokens the history above the last
67
+ * few messages is replaced by one summary of itself, before the turn that would have overflowed is sent.
68
+ */
69
+ compact?: CompactOptions;
70
+ /**
71
+ * Fires after a compaction replaced `replaced` with `summary`. A host that keeps its own server-side summary
72
+ * uses it to move its watermark to the same cut, so the two do not summarize the same messages twice.
73
+ *
74
+ * It matters most to a host whose watermark is a *position*: compaction shrinks the transcript in place, so a
75
+ * "sync everything past index N" scheme silently stops syncing once N is past the shortened array — no
76
+ * duplicate, no error, just messages that never reach the server. Reset the mark here.
77
+ */
78
+ onCompact?: (replaced: readonly ChatMessage[], summary: ChatMessage) => void;
79
+ }
80
+ /**
81
+ * The client-side conversation loop: send → model turn → tool calls → approval gate → execute → report diffs → next
82
+ * turn. The loop lives here rather than on a server because the tools do — the runner is one stateless model turn,
83
+ * so any backend that answers it works and none has to hold a session.
84
+ *
85
+ * Failures land in the transcript instead of being thrown past it: a refused guard, a rejected approval, and an
86
+ * unknown tool are all things the agent did, and the model reads them as tool results the same way a person reads
87
+ * them in the chat.
88
+ */
89
+ export declare class AgentSession {
90
+ #private;
91
+ /**
92
+ * The one built-in the session owns instead of the surface: the answer comes from the conversation, not the
93
+ * screen, so every host that renders `pendingQuestion` gets it and a zone agent asks inside its own transcript.
94
+ * A surface tool of this name shadows it, like any other built-in.
95
+ */
96
+ static readonly askUserTool: PublishedTool;
97
+ constructor(surface: SurfaceView, runner: AgentRunner, options?: AgentSessionOptions);
98
+ /**
99
+ * True while an async `history.load()` is still in flight — the transcript is empty but not yet known to be.
100
+ * A host that opens with a prompt of its own waits for this before sending, or the restore loses the race.
101
+ */
102
+ get isRestoring(): boolean;
103
+ get surface(): SurfaceView;
104
+ get messages(): readonly ChatMessage[];
105
+ get isRunning(): boolean;
106
+ /**
107
+ * True while the conversation is summarizing itself. Distinct from `isRunning`, which an auto-compaction runs
108
+ * inside: the summarizing turn answers nothing the user asked for and takes as long as a model turn, so a chat
109
+ * that only says "running" reads as a question being ignored.
110
+ */
111
+ get isCompacting(): boolean;
112
+ get pendingApproval(): PendingApproval | null;
113
+ get pendingQuestion(): PendingQuestion | null;
114
+ /** What the tool running now last said about its own progress, for the row that is still spinning. */
115
+ get progress(): (AgentProgressReport & {
116
+ callId: string;
117
+ }) | null;
118
+ /** Bumped on every change, so a store binding can use it as the snapshot. */
119
+ get version(): number;
120
+ subscribe: (listener: () => void) => () => void;
121
+ /** A user's text, or prewritten messages — how a host injects a prompt's result as the user's turn. */
122
+ send: (input: string | ChatMessage[]) => Promise<void>;
123
+ abort: () => void;
124
+ /**
125
+ * Empties the transcript and the persisted history, ending a turn that is still running. Awaiting the abort
126
+ * matters: the loop settles in its own `finally`, a microtask later, and a transcript emptied before that lands
127
+ * is one the winding-down turn appends onto. The returned promise waits for the history to clear too.
128
+ */
129
+ reset: () => Promise<void>;
130
+ /**
131
+ * Attaches a transcript store to a session built without one — what `Agent.History` mounts, so a zone can be
132
+ * assembled by a server component and still keep its transcript wherever the app keeps it. `null` detaches.
133
+ *
134
+ * Restoring follows the rule an async `load` already follows: it lands only while nothing has happened to this
135
+ * session yet. Attach before the first turn and it restores; attach after and it saves from there on, with the
136
+ * store never asked for a transcript that would be discarded. One rule rather than a mount-order surprise.
137
+ *
138
+ * Returns the detach, which clears the slot only while this call's store is still the one in it.
139
+ */
140
+ setHistory: (history: SessionHistory | null) => () => void;
141
+ /** The compaction hook as a setter, for the same reason `setHistory` is one: a host attaches it after the fact. */
142
+ setOnCompact: (onCompact: AgentSessionOptions["onCompact"] | null) => () => void;
143
+ /**
144
+ * Re-runs the last user message, dropping what the previous attempt produced. Turns fail for reasons that have
145
+ * nothing to do with what was asked — a refused relay, a model that is unavailable — and retyping is otherwise the
146
+ * only way back. Only the trailing message is replayed, so a prompt's own preamble stays where it is.
147
+ */
148
+ retry: () => Promise<boolean>;
149
+ /**
150
+ * Replaces the history with one summary of itself and returns whether anything was replaced. `keep` leaves that
151
+ * many trailing messages verbatim; the command that a user types keeps none, because a summary of everything is
152
+ * what they asked for. A turn in flight refuses — the transcript it is appending to is not one to rewrite.
153
+ */
154
+ compact: ({ keep }?: {
155
+ keep?: number;
156
+ }) => Promise<boolean>;
157
+ /** What the transcript is estimated to cost the next turn, in tokens — the number auto-compaction watches. */
158
+ get tokens(): number;
159
+ /** Records a host-side failure (a prompt fetch, an upload) in the transcript, where every other failure lands. */
160
+ report: (error: string) => void;
161
+ /** A line the host wrote — a command's own output. Rendered in the transcript, withheld from the model. */
162
+ note: (text: string) => void;
163
+ }
@@ -0,0 +1,21 @@
1
+ import { type ReactElement } from "react";
2
+ import type { ToolConfirm } from "./types.d.ts";
3
+ interface AgenticProps {
4
+ name: string;
5
+ description?: string;
6
+ settle?: boolean;
7
+ confirm?: ToolConfirm;
8
+ children: ReactElement<{
9
+ onClick?: () => unknown;
10
+ }>;
11
+ }
12
+ /**
13
+ * Registers the child's `onClick` as a no-argument tool and renders the child untouched.
14
+ *
15
+ * The first-class path is passing a hook-made tool by reference as the handler itself; this wrapper is for
16
+ * elements whose handler you do not own — third-party components and embeds.
17
+ */
18
+ export declare const Agentic: ({ name, description, settle, confirm, children }: AgenticProps) => ReactElement<{
19
+ onClick?: () => unknown;
20
+ }, string | import("react").JSXElementConstructor<any>>;
21
+ export {};
@@ -0,0 +1,58 @@
1
+ import type { AgentCall, ResourceDiff, ResourceEntry, ScopeEntry, SurfaceSnapshot, SurfaceSource, SurfaceView, ToolEntry } from "./types.d.ts";
2
+ /**
3
+ * The live registry of what the mounted screen offers an agent: tools, readable resources, and scopes.
4
+ *
5
+ * Entries come and go with component lifetimes, so unlike a static catalogue this is subscribable and every
6
+ * snapshot answers "now". A registration stack backs each name — remounts are ordinary React behavior, so a
7
+ * duplicate name warns and the newest wins instead of throwing, and unregistering restores what it shadowed.
8
+ */
9
+ export declare class AgenticSurface {
10
+ #private;
11
+ /** One surface per runtime unless a provider isolates its own. Keyed on `globalThis` so duplicated module copies still meet. */
12
+ static get shared(): AgenticSurface;
13
+ /** MCP tool names allow `[A-Za-z0-9_.-]`, and `.` is the scope join — so every part is folded into `[A-Za-z0-9_-]`. */
14
+ static sanitize(part: string): string;
15
+ static childPath(parent: string[], id: string): string[];
16
+ static fullName(scope: string[], name: string): string;
17
+ subscribe(listener: () => void): () => void;
18
+ /**
19
+ * A row component registers the same name once per row, which is legal when the tool takes the row's id as an
20
+ * argument rather than closing over it: every registration is then interchangeable and last-wins picks an
21
+ * equivalent one. The description is what says so — two registrations that describe the same action to a model
22
+ * are the same declaration twice, and fifty rows are one entry rather than fifty collisions. Two that describe
23
+ * different actions under one name are a real clash whichever of them mounted last, and warn.
24
+ */
25
+ registerTool(scope: string[], entry: ToolEntry): () => void;
26
+ registerResource(scope: string[], entry: ResourceEntry): () => void;
27
+ openScope(parent: string[], scope: ScopeEntry): () => void;
28
+ /**
29
+ * Standing guidance for the agent while the registrant is mounted — instructions, not context data. Kept in
30
+ * registration order rather than sorted: guides are prose, and each one must stay a coherent block.
31
+ */
32
+ registerGuide(scope: string[], text: string): () => void;
33
+ addSource(source: SurfaceSource): () => void;
34
+ snapshot(view?: string[]): SurfaceSnapshot;
35
+ /**
36
+ * A zone session's reading half: the same registry filtered to one scope subtree. Hook entries filter by their
37
+ * scope-prefixed name, sources decide for themselves per view, and guides follow the layout cascade — a zone
38
+ * reads its ancestors' guidance plus its own, never a sibling's. The empty path is the surface itself.
39
+ */
40
+ view(path: string[]): SurfaceView;
41
+ tool(name: string, view?: string[]): ToolEntry | null;
42
+ /**
43
+ * Whether a *mounted component* declares this name — a source's contribution answers `false`. The distinction is
44
+ * what lets a host drop the built-in tools without dropping a screen's own tool that deliberately shadows one.
45
+ */
46
+ declares(name: string, view?: string[]): boolean;
47
+ /** Every call made through this surface, oldest first. What the dock shows the user to check against the screen. */
48
+ get transcript(): readonly AgentCall[];
49
+ call(name: string, args?: Record<string, unknown>, view?: string[]): Promise<unknown>;
50
+ read(name: string, view?: string[]): unknown;
51
+ /**
52
+ * The resources that changed since `before`, for reporting a tool call's effect back to the model.
53
+ *
54
+ * Runs against the live entries rather than a second snapshot because `report: false` lives on the entry, and a
55
+ * snapshot deliberately does not publish it.
56
+ */
57
+ diffSince(before: SurfaceSnapshot, view?: string[]): ResourceDiff[];
58
+ }
@@ -0,0 +1,48 @@
1
+ import type { ChatMessage } from "./types.d.ts";
2
+ export interface CompactOptions {
3
+ /** Estimated transcript tokens above which a turn summarizes its own history first. `0` never compacts. */
4
+ at?: number;
5
+ /** Messages left verbatim below the summary. The cut slides down to the first message that can safely open one. */
6
+ keep?: number;
7
+ /** Produces the summary from the digest. Default: one tool-less turn through the session's own runner. */
8
+ summarize?: (digest: string, signal: AbortSignal) => Promise<string>;
9
+ }
10
+ /**
11
+ * Turns the part of a transcript that no longer fits into one message standing in for it. The loop runs in the
12
+ * browser and the relay is stateless, so nothing else is keeping the conversation inside the model's window: an
13
+ * uncompacted chat simply grows until the provider refuses the request.
14
+ */
15
+ export declare class Compaction {
16
+ #private;
17
+ /**
18
+ * Deliberately well under the smallest window a provider is likely to have: what a conversation loses to an
19
+ * early summary is detail, and what it loses to a late one is the conversation. The tools, the screen context
20
+ * and the system prompt ride on top of the transcript on every turn, and none of them is compactable.
21
+ */
22
+ static readonly defaults: {
23
+ at: number;
24
+ keep: number;
25
+ };
26
+ static readonly instruction: string;
27
+ /**
28
+ * Four characters per token, counted over the JSON the turn actually posts. A rough estimate on purpose: this
29
+ * places a threshold, and shipping a per-provider tokenizer to the browser to place it more exactly would cost
30
+ * more than the slack the estimate leaves.
31
+ */
32
+ static tokensOf(messages: readonly ChatMessage[]): number;
33
+ /**
34
+ * Where the kept half starts, or `-1` when nothing can be cut. A user message is the boundary to prefer —
35
+ * everything above it is settled — but one assistant turn that ran ten tools leaves no user message anywhere
36
+ * near the tail, and that is exactly the transcript that outgrows the window. What the pairing every provider
37
+ * dialect enforces actually requires is only that the kept half not open with a `tool` result whose call was
38
+ * summarized away, so any non-`tool` message opens one too. `keep: 0` summarizes the whole transcript, which is
39
+ * what the command does.
40
+ */
41
+ static cutAt(messages: readonly ChatMessage[], keep: number): number;
42
+ /**
43
+ * The messages as one bounded block of text. Bounded is the point: the transcript being summarized is the one
44
+ * that no longer fits, so feeding it back verbatim would fail exactly where compaction is needed most.
45
+ */
46
+ static digest(messages: readonly ChatMessage[], budget?: number): string;
47
+ static message(summary: string): ChatMessage;
48
+ }
@@ -0,0 +1,21 @@
1
+ import type { ToolCallResult } from "./types.d.ts";
2
+ /**
3
+ * The ceiling on what one tool call may add to the transcript.
4
+ *
5
+ * A tool returns whatever the app's own code returns, and a screen's state is not sized for a model's window: one
6
+ * `readState` of a list whose records carry inlined bytes is megabytes, which the loop then posts on this turn and
7
+ * on every turn after it. Compaction cannot save that — it summarizes what is *above* the cut and this arrives
8
+ * below it — so the value is bounded where it enters the transcript instead. The framework's own big reader
9
+ * (`ScreenReader.limit`) already caps itself; this is the same courtesy for every other tool.
10
+ *
11
+ * Clipped rather than dropped, and the note says what happened: a model handed a value it cannot see the end of
12
+ * asks a narrower question, where one handed nothing answers from the field names.
13
+ */
14
+ export declare class ToolOutput {
15
+ #private;
16
+ /** Characters, ~5k tokens: comfortably above `ScreenReader.limit` and far below any provider's window. */
17
+ static readonly limit = 20000;
18
+ /** Four characters per token, over the JSON the result rides as — the same estimate `Compaction` places. */
19
+ static tokensOf(result: ToolCallResult): number;
20
+ static clipped(result: ToolCallResult): ToolCallResult;
21
+ }