@cavi-ai/api-client 0.1.0

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 (665) hide show
  1. package/ARCHITECTURE.md +12 -0
  2. package/CHANGELOG.md +80 -0
  3. package/CONTRIBUTING.md +158 -0
  4. package/LICENSE +21 -0
  5. package/README.md +618 -0
  6. package/SECURITY.md +48 -0
  7. package/dist/contracts/index.d.ts +5 -0
  8. package/dist/contracts/index.d.ts.map +1 -0
  9. package/dist/contracts/index.js +4 -0
  10. package/dist/contracts/paths.d.ts +154 -0
  11. package/dist/contracts/paths.d.ts.map +1 -0
  12. package/dist/contracts/paths.js +89 -0
  13. package/dist/contracts/resolve.d.ts +7 -0
  14. package/dist/contracts/resolve.d.ts.map +1 -0
  15. package/dist/contracts/resolve.js +22 -0
  16. package/dist/contracts/surfaces.d.ts +13 -0
  17. package/dist/contracts/surfaces.d.ts.map +1 -0
  18. package/dist/contracts/surfaces.js +332 -0
  19. package/dist/contracts/team-manifest.d.ts +200 -0
  20. package/dist/contracts/team-manifest.d.ts.map +1 -0
  21. package/dist/contracts/team-manifest.js +951 -0
  22. package/dist/core/data/guards.d.ts +6 -0
  23. package/dist/core/data/guards.d.ts.map +1 -0
  24. package/dist/core/data/guards.js +22 -0
  25. package/dist/core/data/index.d.ts +2 -0
  26. package/dist/core/data/index.d.ts.map +1 -0
  27. package/dist/core/data/index.js +1 -0
  28. package/dist/core/env/config.d.ts +40 -0
  29. package/dist/core/env/config.d.ts.map +1 -0
  30. package/dist/core/env/config.js +44 -0
  31. package/dist/core/env/index.d.ts +3 -0
  32. package/dist/core/env/index.d.ts.map +1 -0
  33. package/dist/core/env/index.js +2 -0
  34. package/dist/core/env/repo-root.d.ts +11 -0
  35. package/dist/core/env/repo-root.d.ts.map +1 -0
  36. package/dist/core/env/repo-root.js +36 -0
  37. package/dist/core/gateway/agent/commands.d.ts +93 -0
  38. package/dist/core/gateway/agent/commands.d.ts.map +1 -0
  39. package/dist/core/gateway/agent/commands.js +351 -0
  40. package/dist/core/gateway/agent/config.d.ts +158 -0
  41. package/dist/core/gateway/agent/config.d.ts.map +1 -0
  42. package/dist/core/gateway/agent/config.js +536 -0
  43. package/dist/core/gateway/agent/index.d.ts +4 -0
  44. package/dist/core/gateway/agent/index.d.ts.map +1 -0
  45. package/dist/core/gateway/agent/index.js +3 -0
  46. package/dist/core/gateway/agent/voice-config.d.ts +20 -0
  47. package/dist/core/gateway/agent/voice-config.d.ts.map +1 -0
  48. package/dist/core/gateway/agent/voice-config.js +65 -0
  49. package/dist/core/gateway/client/capabilities.d.ts +28 -0
  50. package/dist/core/gateway/client/capabilities.d.ts.map +1 -0
  51. package/dist/core/gateway/client/capabilities.js +288 -0
  52. package/dist/core/gateway/client/client.d.ts +106 -0
  53. package/dist/core/gateway/client/client.d.ts.map +1 -0
  54. package/dist/core/gateway/client/client.js +41 -0
  55. package/dist/core/gateway/client/error-details.d.ts +17 -0
  56. package/dist/core/gateway/client/error-details.d.ts.map +1 -0
  57. package/dist/core/gateway/client/error-details.js +50 -0
  58. package/dist/core/gateway/client/fetch.d.ts +24 -0
  59. package/dist/core/gateway/client/fetch.d.ts.map +1 -0
  60. package/dist/core/gateway/client/fetch.js +98 -0
  61. package/dist/core/gateway/client/index.d.ts +6 -0
  62. package/dist/core/gateway/client/index.d.ts.map +1 -0
  63. package/dist/core/gateway/client/index.js +5 -0
  64. package/dist/core/gateway/client/runtime-targets.d.ts +11 -0
  65. package/dist/core/gateway/client/runtime-targets.d.ts.map +1 -0
  66. package/dist/core/gateway/client/runtime-targets.js +86 -0
  67. package/dist/core/gateway/envelope/envelope.d.ts +25 -0
  68. package/dist/core/gateway/envelope/envelope.d.ts.map +1 -0
  69. package/dist/core/gateway/envelope/envelope.js +141 -0
  70. package/dist/core/gateway/envelope/index.d.ts +3 -0
  71. package/dist/core/gateway/envelope/index.d.ts.map +1 -0
  72. package/dist/core/gateway/envelope/index.js +1 -0
  73. package/dist/core/gateway/envelope/types.d.ts +32 -0
  74. package/dist/core/gateway/envelope/types.d.ts.map +1 -0
  75. package/dist/core/gateway/envelope/types.js +1 -0
  76. package/dist/core/gateway/index.d.ts +11 -0
  77. package/dist/core/gateway/index.d.ts.map +1 -0
  78. package/dist/core/gateway/index.js +10 -0
  79. package/dist/core/gateway/jobs.d.ts +44 -0
  80. package/dist/core/gateway/jobs.d.ts.map +1 -0
  81. package/dist/core/gateway/jobs.js +104 -0
  82. package/dist/core/gateway/portal/config-patch.d.ts +42 -0
  83. package/dist/core/gateway/portal/config-patch.d.ts.map +1 -0
  84. package/dist/core/gateway/portal/config-patch.js +99 -0
  85. package/dist/core/gateway/portal/index.d.ts +2 -0
  86. package/dist/core/gateway/portal/index.d.ts.map +1 -0
  87. package/dist/core/gateway/portal/index.js +1 -0
  88. package/dist/core/gateway/providers/factory.d.ts +18 -0
  89. package/dist/core/gateway/providers/factory.d.ts.map +1 -0
  90. package/dist/core/gateway/providers/factory.js +40 -0
  91. package/dist/core/gateway/providers/index.d.ts +5 -0
  92. package/dist/core/gateway/providers/index.d.ts.map +1 -0
  93. package/dist/core/gateway/providers/index.js +4 -0
  94. package/dist/core/gateway/providers/normalize.d.ts +2 -0
  95. package/dist/core/gateway/providers/normalize.d.ts.map +1 -0
  96. package/dist/core/gateway/providers/normalize.js +6 -0
  97. package/dist/core/gateway/providers/registry.d.ts +5 -0
  98. package/dist/core/gateway/providers/registry.d.ts.map +1 -0
  99. package/dist/core/gateway/providers/registry.js +76 -0
  100. package/dist/core/gateway/providers/types.d.ts +42 -0
  101. package/dist/core/gateway/providers/types.d.ts.map +1 -0
  102. package/dist/core/gateway/providers/types.js +4 -0
  103. package/dist/core/gateway/resources/index.d.ts +3 -0
  104. package/dist/core/gateway/resources/index.d.ts.map +1 -0
  105. package/dist/core/gateway/resources/index.js +2 -0
  106. package/dist/core/gateway/resources/media.d.ts +165 -0
  107. package/dist/core/gateway/resources/media.d.ts.map +1 -0
  108. package/dist/core/gateway/resources/media.js +170 -0
  109. package/dist/core/gateway/resources/wiki.d.ts +136 -0
  110. package/dist/core/gateway/resources/wiki.d.ts.map +1 -0
  111. package/dist/core/gateway/resources/wiki.js +72 -0
  112. package/dist/core/gateway/rpc/client.d.ts +150 -0
  113. package/dist/core/gateway/rpc/client.d.ts.map +1 -0
  114. package/dist/core/gateway/rpc/client.js +675 -0
  115. package/dist/core/gateway/rpc/device-crypto.d.ts +19 -0
  116. package/dist/core/gateway/rpc/device-crypto.d.ts.map +1 -0
  117. package/dist/core/gateway/rpc/device-crypto.js +75 -0
  118. package/dist/core/gateway/rpc/device-store.d.ts +8 -0
  119. package/dist/core/gateway/rpc/device-store.d.ts.map +1 -0
  120. package/dist/core/gateway/rpc/device-store.js +113 -0
  121. package/dist/core/gateway/rpc/error.d.ts +5 -0
  122. package/dist/core/gateway/rpc/error.d.ts.map +1 -0
  123. package/dist/core/gateway/rpc/error.js +9 -0
  124. package/dist/core/gateway/rpc/index.d.ts +6 -0
  125. package/dist/core/gateway/rpc/index.d.ts.map +1 -0
  126. package/dist/core/gateway/rpc/index.js +5 -0
  127. package/dist/core/gateway/rpc/preauth-handshake.d.ts +39 -0
  128. package/dist/core/gateway/rpc/preauth-handshake.d.ts.map +1 -0
  129. package/dist/core/gateway/rpc/preauth-handshake.js +58 -0
  130. package/dist/core/gateway/run/contracts.d.ts +126 -0
  131. package/dist/core/gateway/run/contracts.d.ts.map +1 -0
  132. package/dist/core/gateway/run/contracts.js +23 -0
  133. package/dist/core/gateway/run/event-stream.d.ts +106 -0
  134. package/dist/core/gateway/run/event-stream.d.ts.map +1 -0
  135. package/dist/core/gateway/run/event-stream.js +264 -0
  136. package/dist/core/gateway/run/index.d.ts +5 -0
  137. package/dist/core/gateway/run/index.d.ts.map +1 -0
  138. package/dist/core/gateway/run/index.js +4 -0
  139. package/dist/core/gateway/run/sse-run-event-provider.d.ts +55 -0
  140. package/dist/core/gateway/run/sse-run-event-provider.d.ts.map +1 -0
  141. package/dist/core/gateway/run/sse-run-event-provider.js +394 -0
  142. package/dist/core/gateway/run/stream-failure.d.ts +11 -0
  143. package/dist/core/gateway/run/stream-failure.d.ts.map +1 -0
  144. package/dist/core/gateway/run/stream-failure.js +101 -0
  145. package/dist/core/gateway/snapshots/cache.d.ts +7 -0
  146. package/dist/core/gateway/snapshots/cache.d.ts.map +1 -0
  147. package/dist/core/gateway/snapshots/cache.js +13 -0
  148. package/dist/core/gateway/snapshots/contracts.d.ts +279 -0
  149. package/dist/core/gateway/snapshots/contracts.d.ts.map +1 -0
  150. package/dist/core/gateway/snapshots/contracts.js +1 -0
  151. package/dist/core/gateway/snapshots/index.d.ts +7 -0
  152. package/dist/core/gateway/snapshots/index.d.ts.map +1 -0
  153. package/dist/core/gateway/snapshots/index.js +6 -0
  154. package/dist/core/gateway/snapshots/loaders.d.ts +76 -0
  155. package/dist/core/gateway/snapshots/loaders.d.ts.map +1 -0
  156. package/dist/core/gateway/snapshots/loaders.js +515 -0
  157. package/dist/core/gateway/snapshots/session-loaders.d.ts +116 -0
  158. package/dist/core/gateway/snapshots/session-loaders.d.ts.map +1 -0
  159. package/dist/core/gateway/snapshots/session-loaders.js +310 -0
  160. package/dist/core/gateway/snapshots/system-loaders.d.ts +16 -0
  161. package/dist/core/gateway/snapshots/system-loaders.d.ts.map +1 -0
  162. package/dist/core/gateway/snapshots/system-loaders.js +61 -0
  163. package/dist/core/gateway/snapshots/transforms.d.ts +38 -0
  164. package/dist/core/gateway/snapshots/transforms.d.ts.map +1 -0
  165. package/dist/core/gateway/snapshots/transforms.js +328 -0
  166. package/dist/core/http/client-id.d.ts +6 -0
  167. package/dist/core/http/client-id.d.ts.map +1 -0
  168. package/dist/core/http/client-id.js +29 -0
  169. package/dist/core/http/client.d.ts +25 -0
  170. package/dist/core/http/client.d.ts.map +1 -0
  171. package/dist/core/http/client.js +234 -0
  172. package/dist/core/http/contracts.d.ts +3 -0
  173. package/dist/core/http/contracts.d.ts.map +1 -0
  174. package/dist/core/http/contracts.js +5 -0
  175. package/dist/core/http/errors.d.ts +17 -0
  176. package/dist/core/http/errors.d.ts.map +1 -0
  177. package/dist/core/http/errors.js +16 -0
  178. package/dist/core/http/gateway-error.d.ts +15 -0
  179. package/dist/core/http/gateway-error.d.ts.map +1 -0
  180. package/dist/core/http/gateway-error.js +15 -0
  181. package/dist/core/http/index.d.ts +10 -0
  182. package/dist/core/http/index.d.ts.map +1 -0
  183. package/dist/core/http/index.js +9 -0
  184. package/dist/core/http/json-client.d.ts +17 -0
  185. package/dist/core/http/json-client.d.ts.map +1 -0
  186. package/dist/core/http/json-client.js +62 -0
  187. package/dist/core/http/raw-client.d.ts +16 -0
  188. package/dist/core/http/raw-client.d.ts.map +1 -0
  189. package/dist/core/http/raw-client.js +36 -0
  190. package/dist/core/http/redaction.d.ts +20 -0
  191. package/dist/core/http/redaction.d.ts.map +1 -0
  192. package/dist/core/http/redaction.js +58 -0
  193. package/dist/core/http/types.d.ts +44 -0
  194. package/dist/core/http/types.d.ts.map +1 -0
  195. package/dist/core/http/types.js +3 -0
  196. package/dist/core/runtime/index.d.ts +2 -0
  197. package/dist/core/runtime/index.d.ts.map +1 -0
  198. package/dist/core/runtime/index.js +1 -0
  199. package/dist/core/runtime/paths.d.ts +5 -0
  200. package/dist/core/runtime/paths.d.ts.map +1 -0
  201. package/dist/core/runtime/paths.js +29 -0
  202. package/dist/core/sse/index.d.ts +2 -0
  203. package/dist/core/sse/index.d.ts.map +1 -0
  204. package/dist/core/sse/index.js +1 -0
  205. package/dist/core/sse/stream.d.ts +17 -0
  206. package/dist/core/sse/stream.d.ts.map +1 -0
  207. package/dist/core/sse/stream.js +106 -0
  208. package/dist/core/ws/close.d.ts +11 -0
  209. package/dist/core/ws/close.d.ts.map +1 -0
  210. package/dist/core/ws/close.js +34 -0
  211. package/dist/core/ws/gateway-websocket.d.ts +2 -0
  212. package/dist/core/ws/gateway-websocket.d.ts.map +1 -0
  213. package/dist/core/ws/gateway-websocket.js +1 -0
  214. package/dist/core/ws/index.d.ts +4 -0
  215. package/dist/core/ws/index.d.ts.map +1 -0
  216. package/dist/core/ws/index.js +3 -0
  217. package/dist/core/ws/targets.d.ts +21 -0
  218. package/dist/core/ws/targets.d.ts.map +1 -0
  219. package/dist/core/ws/targets.js +61 -0
  220. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-loaders.d.ts +21 -0
  221. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-loaders.d.ts.map +1 -0
  222. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-loaders.js +22 -0
  223. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-snapshot-loaders.d.ts +30 -0
  224. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-snapshot-loaders.d.ts.map +1 -0
  225. package/dist/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-snapshot-loaders.js +72 -0
  226. package/dist/extensions/cavi/adapters/cavi-control-adapters/library-live.d.ts +4 -0
  227. package/dist/extensions/cavi/adapters/cavi-control-adapters/library-live.d.ts.map +1 -0
  228. package/dist/extensions/cavi/adapters/cavi-control-adapters/library-live.js +66 -0
  229. package/dist/extensions/cavi/adapters/cavi-control-adapters/operator-control-live.d.ts +7 -0
  230. package/dist/extensions/cavi/adapters/cavi-control-adapters/operator-control-live.d.ts.map +1 -0
  231. package/dist/extensions/cavi/adapters/cavi-control-adapters/operator-control-live.js +318 -0
  232. package/dist/extensions/cavi/adapters/create-cavi-control-adapters.d.ts +88 -0
  233. package/dist/extensions/cavi/adapters/create-cavi-control-adapters.d.ts.map +1 -0
  234. package/dist/extensions/cavi/adapters/create-cavi-control-adapters.js +172 -0
  235. package/dist/extensions/cavi/client.d.ts +72 -0
  236. package/dist/extensions/cavi/client.d.ts.map +1 -0
  237. package/dist/extensions/cavi/client.js +19 -0
  238. package/dist/extensions/cavi/contracts/index.d.ts +6 -0
  239. package/dist/extensions/cavi/contracts/index.d.ts.map +1 -0
  240. package/dist/extensions/cavi/contracts/index.js +5 -0
  241. package/dist/extensions/cavi/contracts/mobile.d.ts +441 -0
  242. package/dist/extensions/cavi/contracts/mobile.d.ts.map +1 -0
  243. package/dist/extensions/cavi/contracts/mobile.js +467 -0
  244. package/dist/extensions/cavi/contracts/paths.d.ts +121 -0
  245. package/dist/extensions/cavi/contracts/paths.d.ts.map +1 -0
  246. package/dist/extensions/cavi/contracts/paths.js +197 -0
  247. package/dist/extensions/cavi/contracts/portals.d.ts +78 -0
  248. package/dist/extensions/cavi/contracts/portals.d.ts.map +1 -0
  249. package/dist/extensions/cavi/contracts/portals.js +70 -0
  250. package/dist/extensions/cavi/contracts/resolve.d.ts +3 -0
  251. package/dist/extensions/cavi/contracts/resolve.d.ts.map +1 -0
  252. package/dist/extensions/cavi/contracts/resolve.js +4 -0
  253. package/dist/extensions/cavi/contracts/surfaces.d.ts +5 -0
  254. package/dist/extensions/cavi/contracts/surfaces.d.ts.map +1 -0
  255. package/dist/extensions/cavi/contracts/surfaces.js +551 -0
  256. package/dist/extensions/cavi/discourse/contracts.d.ts +5 -0
  257. package/dist/extensions/cavi/discourse/contracts.d.ts.map +1 -0
  258. package/dist/extensions/cavi/discourse/contracts.js +7 -0
  259. package/dist/extensions/cavi/discourse/fallback.d.ts +3 -0
  260. package/dist/extensions/cavi/discourse/fallback.d.ts.map +1 -0
  261. package/dist/extensions/cavi/discourse/fallback.js +364 -0
  262. package/dist/extensions/cavi/discourse/live.d.ts +5 -0
  263. package/dist/extensions/cavi/discourse/live.d.ts.map +1 -0
  264. package/dist/extensions/cavi/discourse/live.js +22 -0
  265. package/dist/extensions/cavi/discourse/normalize-helpers.d.ts +11 -0
  266. package/dist/extensions/cavi/discourse/normalize-helpers.d.ts.map +1 -0
  267. package/dist/extensions/cavi/discourse/normalize-helpers.js +155 -0
  268. package/dist/extensions/cavi/discourse/normalize.d.ts +4 -0
  269. package/dist/extensions/cavi/discourse/normalize.d.ts.map +1 -0
  270. package/dist/extensions/cavi/discourse/normalize.js +287 -0
  271. package/dist/extensions/cavi/domain/discourse.d.ts +161 -0
  272. package/dist/extensions/cavi/domain/discourse.d.ts.map +1 -0
  273. package/dist/extensions/cavi/domain/discourse.js +1 -0
  274. package/dist/extensions/cavi/domain/index.d.ts +6 -0
  275. package/dist/extensions/cavi/domain/index.d.ts.map +1 -0
  276. package/dist/extensions/cavi/domain/index.js +5 -0
  277. package/dist/extensions/cavi/domain/library.d.ts +80 -0
  278. package/dist/extensions/cavi/domain/library.d.ts.map +1 -0
  279. package/dist/extensions/cavi/domain/library.js +2 -0
  280. package/dist/extensions/cavi/domain/observability.d.ts +34 -0
  281. package/dist/extensions/cavi/domain/observability.d.ts.map +1 -0
  282. package/dist/extensions/cavi/domain/observability.js +1 -0
  283. package/dist/extensions/cavi/domain/operator.d.ts +420 -0
  284. package/dist/extensions/cavi/domain/operator.d.ts.map +1 -0
  285. package/dist/extensions/cavi/domain/operator.js +1 -0
  286. package/dist/extensions/cavi/domain/project-board.d.ts +96 -0
  287. package/dist/extensions/cavi/domain/project-board.d.ts.map +1 -0
  288. package/dist/extensions/cavi/domain/project-board.js +1 -0
  289. package/dist/extensions/cavi/fallbacks/provider.d.ts +13 -0
  290. package/dist/extensions/cavi/fallbacks/provider.d.ts.map +1 -0
  291. package/dist/extensions/cavi/fallbacks/provider.js +23 -0
  292. package/dist/extensions/cavi/fallbacks/snapshots/agent-memory.d.ts +3 -0
  293. package/dist/extensions/cavi/fallbacks/snapshots/agent-memory.d.ts.map +1 -0
  294. package/dist/extensions/cavi/fallbacks/snapshots/agent-memory.js +6 -0
  295. package/dist/extensions/cavi/fallbacks/snapshots/cost-history.d.ts +3 -0
  296. package/dist/extensions/cavi/fallbacks/snapshots/cost-history.d.ts.map +1 -0
  297. package/dist/extensions/cavi/fallbacks/snapshots/cost-history.js +73 -0
  298. package/dist/extensions/cavi/fallbacks/snapshots/incidents.d.ts +3 -0
  299. package/dist/extensions/cavi/fallbacks/snapshots/incidents.d.ts.map +1 -0
  300. package/dist/extensions/cavi/fallbacks/snapshots/incidents.js +50 -0
  301. package/dist/extensions/cavi/fallbacks/snapshots/index.d.ts +10 -0
  302. package/dist/extensions/cavi/fallbacks/snapshots/index.d.ts.map +1 -0
  303. package/dist/extensions/cavi/fallbacks/snapshots/index.js +9 -0
  304. package/dist/extensions/cavi/fallbacks/snapshots/library.d.ts +3 -0
  305. package/dist/extensions/cavi/fallbacks/snapshots/library.d.ts.map +1 -0
  306. package/dist/extensions/cavi/fallbacks/snapshots/library.js +110 -0
  307. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/defaults.d.ts +8 -0
  308. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/defaults.d.ts.map +1 -0
  309. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/defaults.js +29 -0
  310. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/index.d.ts +4 -0
  311. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/index.d.ts.map +1 -0
  312. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/index.js +3 -0
  313. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-memory.d.ts +3 -0
  314. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-memory.d.ts.map +1 -0
  315. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-memory.js +63 -0
  316. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-registry-detail.d.ts +3 -0
  317. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-registry-detail.d.ts.map +1 -0
  318. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-registry-detail.js +716 -0
  319. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-section-status.d.ts +3 -0
  320. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-section-status.d.ts.map +1 -0
  321. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-section-status.js +38 -0
  322. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-status.d.ts +3 -0
  323. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-status.d.ts.map +1 -0
  324. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-status.js +84 -0
  325. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-tasks.d.ts +3 -0
  326. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-tasks.d.ts.map +1 -0
  327. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-tasks.js +111 -0
  328. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-ready.d.ts +3 -0
  329. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-ready.d.ts.map +1 -0
  330. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-ready.js +16 -0
  331. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-tasks.d.ts +3 -0
  332. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-tasks.d.ts.map +1 -0
  333. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-tasks.js +43 -0
  334. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot.d.ts +3 -0
  335. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot.d.ts.map +1 -0
  336. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/snapshot.js +16 -0
  337. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/transports.d.ts +4 -0
  338. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/transports.d.ts.map +1 -0
  339. package/dist/extensions/cavi/fallbacks/snapshots/operator-control/transports.js +65 -0
  340. package/dist/extensions/cavi/fallbacks/snapshots/overview.d.ts +3 -0
  341. package/dist/extensions/cavi/fallbacks/snapshots/overview.d.ts.map +1 -0
  342. package/dist/extensions/cavi/fallbacks/snapshots/overview.js +40 -0
  343. package/dist/extensions/cavi/fallbacks/snapshots/routing.d.ts +3 -0
  344. package/dist/extensions/cavi/fallbacks/snapshots/routing.d.ts.map +1 -0
  345. package/dist/extensions/cavi/fallbacks/snapshots/routing.js +36 -0
  346. package/dist/extensions/cavi/fallbacks/snapshots/runs.d.ts +4 -0
  347. package/dist/extensions/cavi/fallbacks/snapshots/runs.d.ts.map +1 -0
  348. package/dist/extensions/cavi/fallbacks/snapshots/runs.js +133 -0
  349. package/dist/extensions/cavi/fallbacks/snapshots/shared.d.ts +2 -0
  350. package/dist/extensions/cavi/fallbacks/snapshots/shared.d.ts.map +1 -0
  351. package/dist/extensions/cavi/fallbacks/snapshots/shared.js +1 -0
  352. package/dist/extensions/cavi/index.d.ts +27 -0
  353. package/dist/extensions/cavi/index.d.ts.map +1 -0
  354. package/dist/extensions/cavi/index.js +26 -0
  355. package/dist/extensions/cavi/library/api.d.ts +18 -0
  356. package/dist/extensions/cavi/library/api.d.ts.map +1 -0
  357. package/dist/extensions/cavi/library/api.js +67 -0
  358. package/dist/extensions/cavi/library/client.d.ts +51 -0
  359. package/dist/extensions/cavi/library/client.d.ts.map +1 -0
  360. package/dist/extensions/cavi/library/client.js +23 -0
  361. package/dist/extensions/cavi/library/clip.d.ts +93 -0
  362. package/dist/extensions/cavi/library/clip.d.ts.map +1 -0
  363. package/dist/extensions/cavi/library/clip.js +272 -0
  364. package/dist/extensions/cavi/operator-control/constants.d.ts +4 -0
  365. package/dist/extensions/cavi/operator-control/constants.d.ts.map +1 -0
  366. package/dist/extensions/cavi/operator-control/constants.js +3 -0
  367. package/dist/extensions/cavi/operator-control/defaults.d.ts +11 -0
  368. package/dist/extensions/cavi/operator-control/defaults.d.ts.map +1 -0
  369. package/dist/extensions/cavi/operator-control/defaults.js +243 -0
  370. package/dist/extensions/cavi/operator-control/load-section.d.ts +24 -0
  371. package/dist/extensions/cavi/operator-control/load-section.d.ts.map +1 -0
  372. package/dist/extensions/cavi/operator-control/load-section.js +46 -0
  373. package/dist/extensions/cavi/portal/client.d.ts +16 -0
  374. package/dist/extensions/cavi/portal/client.d.ts.map +1 -0
  375. package/dist/extensions/cavi/portal/client.js +38 -0
  376. package/dist/extensions/cavi/portal/tts.d.ts +69 -0
  377. package/dist/extensions/cavi/portal/tts.d.ts.map +1 -0
  378. package/dist/extensions/cavi/portal/tts.js +116 -0
  379. package/dist/extensions/cavi/project-board/constants.d.ts +68 -0
  380. package/dist/extensions/cavi/project-board/constants.d.ts.map +1 -0
  381. package/dist/extensions/cavi/project-board/constants.js +9 -0
  382. package/dist/extensions/cavi/project-board/fallback.d.ts +3 -0
  383. package/dist/extensions/cavi/project-board/fallback.d.ts.map +1 -0
  384. package/dist/extensions/cavi/project-board/fallback.js +127 -0
  385. package/dist/extensions/cavi/project-board/live.d.ts +16 -0
  386. package/dist/extensions/cavi/project-board/live.d.ts.map +1 -0
  387. package/dist/extensions/cavi/project-board/live.js +86 -0
  388. package/dist/extensions/cavi/project-board/mutations.d.ts +43 -0
  389. package/dist/extensions/cavi/project-board/mutations.d.ts.map +1 -0
  390. package/dist/extensions/cavi/project-board/mutations.js +210 -0
  391. package/dist/extensions/cavi/project-board/normalize.d.ts +23 -0
  392. package/dist/extensions/cavi/project-board/normalize.d.ts.map +1 -0
  393. package/dist/extensions/cavi/project-board/normalize.js +410 -0
  394. package/dist/extensions/cavi/project-board/trace-id.d.ts +2 -0
  395. package/dist/extensions/cavi/project-board/trace-id.d.ts.map +1 -0
  396. package/dist/extensions/cavi/project-board/trace-id.js +7 -0
  397. package/dist/extensions/cavi/registry/canonical-team-registry.d.ts +41 -0
  398. package/dist/extensions/cavi/registry/canonical-team-registry.d.ts.map +1 -0
  399. package/dist/extensions/cavi/registry/canonical-team-registry.js +102 -0
  400. package/dist/extensions/cavi/registry/portal-library-registry.d.ts +6 -0
  401. package/dist/extensions/cavi/registry/portal-library-registry.d.ts.map +1 -0
  402. package/dist/extensions/cavi/registry/portal-library-registry.js +17 -0
  403. package/dist/extensions/cavi/registry/session-keys.d.ts +16 -0
  404. package/dist/extensions/cavi/registry/session-keys.d.ts.map +1 -0
  405. package/dist/extensions/cavi/registry/session-keys.js +68 -0
  406. package/dist/extensions/cavi/registry/team-registry-config.d.ts +6 -0
  407. package/dist/extensions/cavi/registry/team-registry-config.d.ts.map +1 -0
  408. package/dist/extensions/cavi/registry/team-registry-config.js +23 -0
  409. package/dist/extensions/cavi/registry/team-registry.d.ts +49 -0
  410. package/dist/extensions/cavi/registry/team-registry.d.ts.map +1 -0
  411. package/dist/extensions/cavi/registry/team-registry.js +290 -0
  412. package/dist/extensions/cavi/runtime/env-config.d.ts +35 -0
  413. package/dist/extensions/cavi/runtime/env-config.d.ts.map +1 -0
  414. package/dist/extensions/cavi/runtime/env-config.js +74 -0
  415. package/dist/extensions/cavi/runtime/paths.d.ts +11 -0
  416. package/dist/extensions/cavi/runtime/paths.d.ts.map +1 -0
  417. package/dist/extensions/cavi/runtime/paths.js +43 -0
  418. package/dist/extensions/cavi/runtime/standalone-mode.d.ts +3 -0
  419. package/dist/extensions/cavi/runtime/standalone-mode.d.ts.map +1 -0
  420. package/dist/extensions/cavi/runtime/standalone-mode.js +15 -0
  421. package/dist/index.d.ts +70 -0
  422. package/dist/index.d.ts.map +1 -0
  423. package/dist/index.js +75 -0
  424. package/dist/providers/hermes/agent-config.d.ts +36 -0
  425. package/dist/providers/hermes/agent-config.d.ts.map +1 -0
  426. package/dist/providers/hermes/agent-config.js +242 -0
  427. package/dist/providers/hermes/chat-run.d.ts +106 -0
  428. package/dist/providers/hermes/chat-run.d.ts.map +1 -0
  429. package/dist/providers/hermes/chat-run.js +221 -0
  430. package/dist/providers/hermes/client.d.ts +13 -0
  431. package/dist/providers/hermes/client.d.ts.map +1 -0
  432. package/dist/providers/hermes/client.js +6 -0
  433. package/dist/providers/hermes/env-config.d.ts +18 -0
  434. package/dist/providers/hermes/env-config.d.ts.map +1 -0
  435. package/dist/providers/hermes/env-config.js +38 -0
  436. package/dist/providers/hermes/index.d.ts +12 -0
  437. package/dist/providers/hermes/index.d.ts.map +1 -0
  438. package/dist/providers/hermes/index.js +11 -0
  439. package/dist/providers/hermes/media.d.ts +6 -0
  440. package/dist/providers/hermes/media.d.ts.map +1 -0
  441. package/dist/providers/hermes/media.js +10 -0
  442. package/dist/providers/hermes/provider-module.d.ts +3 -0
  443. package/dist/providers/hermes/provider-module.d.ts.map +1 -0
  444. package/dist/providers/hermes/provider-module.js +22 -0
  445. package/dist/providers/hermes/sse-run-event-provider.d.ts +24 -0
  446. package/dist/providers/hermes/sse-run-event-provider.d.ts.map +1 -0
  447. package/dist/providers/hermes/sse-run-event-provider.js +32 -0
  448. package/dist/providers/hermes/team-registry-config.d.ts +3 -0
  449. package/dist/providers/hermes/team-registry-config.d.ts.map +1 -0
  450. package/dist/providers/hermes/team-registry-config.js +1 -0
  451. package/dist/providers/hermes/team-registry.d.ts +3 -0
  452. package/dist/providers/hermes/team-registry.d.ts.map +1 -0
  453. package/dist/providers/hermes/team-registry.js +5 -0
  454. package/dist/providers/hermes/websocket.d.ts +6 -0
  455. package/dist/providers/hermes/websocket.d.ts.map +1 -0
  456. package/dist/providers/hermes/websocket.js +6 -0
  457. package/dist/providers/hermes/wiki.d.ts +6 -0
  458. package/dist/providers/hermes/wiki.d.ts.map +1 -0
  459. package/dist/providers/hermes/wiki.js +10 -0
  460. package/dist/providers/openclaw/agent-config.d.ts +6 -0
  461. package/dist/providers/openclaw/agent-config.d.ts.map +1 -0
  462. package/dist/providers/openclaw/agent-config.js +10 -0
  463. package/dist/providers/openclaw/client.d.ts +13 -0
  464. package/dist/providers/openclaw/client.d.ts.map +1 -0
  465. package/dist/providers/openclaw/client.js +6 -0
  466. package/dist/providers/openclaw/index.d.ts +10 -0
  467. package/dist/providers/openclaw/index.d.ts.map +1 -0
  468. package/dist/providers/openclaw/index.js +9 -0
  469. package/dist/providers/openclaw/media.d.ts +6 -0
  470. package/dist/providers/openclaw/media.d.ts.map +1 -0
  471. package/dist/providers/openclaw/media.js +10 -0
  472. package/dist/providers/openclaw/provider-module.d.ts +3 -0
  473. package/dist/providers/openclaw/provider-module.d.ts.map +1 -0
  474. package/dist/providers/openclaw/provider-module.js +16 -0
  475. package/dist/providers/openclaw/sse-run-event-provider.d.ts +6 -0
  476. package/dist/providers/openclaw/sse-run-event-provider.d.ts.map +1 -0
  477. package/dist/providers/openclaw/sse-run-event-provider.js +10 -0
  478. package/dist/providers/openclaw/team-registry-config.d.ts +3 -0
  479. package/dist/providers/openclaw/team-registry-config.d.ts.map +1 -0
  480. package/dist/providers/openclaw/team-registry-config.js +1 -0
  481. package/dist/providers/openclaw/team-registry.d.ts +3 -0
  482. package/dist/providers/openclaw/team-registry.d.ts.map +1 -0
  483. package/dist/providers/openclaw/team-registry.js +5 -0
  484. package/dist/providers/openclaw/websocket.d.ts +6 -0
  485. package/dist/providers/openclaw/websocket.d.ts.map +1 -0
  486. package/dist/providers/openclaw/websocket.js +28 -0
  487. package/dist/providers/openclaw/wiki.d.ts +6 -0
  488. package/dist/providers/openclaw/wiki.d.ts.map +1 -0
  489. package/dist/providers/openclaw/wiki.js +10 -0
  490. package/dist/react/gateway-provider.d.ts +142 -0
  491. package/dist/react/gateway-provider.d.ts.map +1 -0
  492. package/dist/react/gateway-provider.js +569 -0
  493. package/dist/react/index.d.ts +2 -0
  494. package/dist/react/index.d.ts.map +1 -0
  495. package/dist/react/index.js +1 -0
  496. package/docs/assets/api-client-hero.svg +73 -0
  497. package/docs/cavi-team-manifest.example.ts +219 -0
  498. package/docs/team-manifest.consumer.template.ts +248 -0
  499. package/docs/team-manifest.md +252 -0
  500. package/package.json +152 -0
  501. package/src/contracts/index.ts +4 -0
  502. package/src/contracts/paths.ts +126 -0
  503. package/src/contracts/resolve.ts +42 -0
  504. package/src/contracts/surfaces.ts +366 -0
  505. package/src/contracts/team-manifest.ts +1402 -0
  506. package/src/core/data/guards.ts +26 -0
  507. package/src/core/data/index.ts +1 -0
  508. package/src/core/env/config.ts +97 -0
  509. package/src/core/env/index.ts +2 -0
  510. package/src/core/env/repo-root.ts +59 -0
  511. package/src/core/gateway/README.md +35 -0
  512. package/src/core/gateway/agent/commands.ts +482 -0
  513. package/src/core/gateway/agent/config.ts +786 -0
  514. package/src/core/gateway/agent/index.ts +3 -0
  515. package/src/core/gateway/agent/voice-config.ts +91 -0
  516. package/src/core/gateway/client/capabilities.ts +385 -0
  517. package/src/core/gateway/client/client.ts +137 -0
  518. package/src/core/gateway/client/error-details.ts +74 -0
  519. package/src/core/gateway/client/fetch.ts +180 -0
  520. package/src/core/gateway/client/index.ts +5 -0
  521. package/src/core/gateway/client/runtime-targets.ts +132 -0
  522. package/src/core/gateway/envelope/envelope.ts +204 -0
  523. package/src/core/gateway/envelope/index.ts +2 -0
  524. package/src/core/gateway/envelope/types.ts +48 -0
  525. package/src/core/gateway/index.ts +10 -0
  526. package/src/core/gateway/jobs.ts +178 -0
  527. package/src/core/gateway/portal/config-patch.ts +136 -0
  528. package/src/core/gateway/portal/index.ts +1 -0
  529. package/src/core/gateway/providers/factory.ts +77 -0
  530. package/src/core/gateway/providers/index.ts +4 -0
  531. package/src/core/gateway/providers/normalize.ts +7 -0
  532. package/src/core/gateway/providers/registry.ts +96 -0
  533. package/src/core/gateway/providers/types.ts +73 -0
  534. package/src/core/gateway/resources/index.ts +2 -0
  535. package/src/core/gateway/resources/media.ts +474 -0
  536. package/src/core/gateway/resources/wiki.ts +301 -0
  537. package/src/core/gateway/rpc/client.ts +1067 -0
  538. package/src/core/gateway/rpc/device-crypto.ts +101 -0
  539. package/src/core/gateway/rpc/device-store.ts +147 -0
  540. package/src/core/gateway/rpc/error.ts +11 -0
  541. package/src/core/gateway/rpc/index.ts +5 -0
  542. package/src/core/gateway/rpc/preauth-handshake.ts +99 -0
  543. package/src/core/gateway/run/contracts.ts +155 -0
  544. package/src/core/gateway/run/event-stream.ts +373 -0
  545. package/src/core/gateway/run/index.ts +4 -0
  546. package/src/core/gateway/run/sse-run-event-provider.ts +513 -0
  547. package/src/core/gateway/run/stream-failure.ts +135 -0
  548. package/src/core/gateway/snapshots/cache.ts +22 -0
  549. package/src/core/gateway/snapshots/contracts.ts +293 -0
  550. package/src/core/gateway/snapshots/index.ts +6 -0
  551. package/src/core/gateway/snapshots/loaders.ts +738 -0
  552. package/src/core/gateway/snapshots/session-loaders.ts +534 -0
  553. package/src/core/gateway/snapshots/system-loaders.ts +93 -0
  554. package/src/core/gateway/snapshots/transforms.ts +508 -0
  555. package/src/core/http/client-id.ts +40 -0
  556. package/src/core/http/client.ts +271 -0
  557. package/src/core/http/contracts.ts +9 -0
  558. package/src/core/http/errors.ts +26 -0
  559. package/src/core/http/gateway-error.ts +38 -0
  560. package/src/core/http/index.ts +9 -0
  561. package/src/core/http/json-client.ts +90 -0
  562. package/src/core/http/raw-client.ts +57 -0
  563. package/src/core/http/redaction.ts +78 -0
  564. package/src/core/http/types.ts +59 -0
  565. package/src/core/runtime/index.ts +1 -0
  566. package/src/core/runtime/paths.ts +44 -0
  567. package/src/core/sse/index.ts +1 -0
  568. package/src/core/sse/stream.ts +118 -0
  569. package/src/core/ws/close.ts +51 -0
  570. package/src/core/ws/gateway-websocket.ts +8 -0
  571. package/src/core/ws/index.ts +3 -0
  572. package/src/core/ws/targets.ts +74 -0
  573. package/src/extensions/README.md +16 -0
  574. package/src/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-loaders.ts +33 -0
  575. package/src/extensions/cavi/adapters/cavi-control-adapters/gateway-ws-snapshot-loaders.ts +152 -0
  576. package/src/extensions/cavi/adapters/cavi-control-adapters/library-live.ts +120 -0
  577. package/src/extensions/cavi/adapters/cavi-control-adapters/operator-control-live.ts +422 -0
  578. package/src/extensions/cavi/adapters/create-cavi-control-adapters.ts +350 -0
  579. package/src/extensions/cavi/client.ts +25 -0
  580. package/src/extensions/cavi/contracts/index.ts +5 -0
  581. package/src/extensions/cavi/contracts/mobile.ts +528 -0
  582. package/src/extensions/cavi/contracts/paths.ts +242 -0
  583. package/src/extensions/cavi/contracts/portals.ts +165 -0
  584. package/src/extensions/cavi/contracts/resolve.ts +6 -0
  585. package/src/extensions/cavi/contracts/surfaces.ts +567 -0
  586. package/src/extensions/cavi/discourse/contracts.ts +9 -0
  587. package/src/extensions/cavi/discourse/fallback.ts +387 -0
  588. package/src/extensions/cavi/discourse/live.ts +36 -0
  589. package/src/extensions/cavi/discourse/normalize-helpers.ts +202 -0
  590. package/src/extensions/cavi/discourse/normalize.ts +415 -0
  591. package/src/extensions/cavi/domain/discourse.ts +209 -0
  592. package/src/extensions/cavi/domain/index.ts +5 -0
  593. package/src/extensions/cavi/domain/library.ts +96 -0
  594. package/src/extensions/cavi/domain/observability.ts +36 -0
  595. package/src/extensions/cavi/domain/operator.ts +486 -0
  596. package/src/extensions/cavi/domain/project-board.ts +107 -0
  597. package/src/extensions/cavi/fallbacks/provider.ts +57 -0
  598. package/src/extensions/cavi/fallbacks/snapshots/agent-memory.ts +8 -0
  599. package/src/extensions/cavi/fallbacks/snapshots/cost-history.ts +101 -0
  600. package/src/extensions/cavi/fallbacks/snapshots/incidents.ts +56 -0
  601. package/src/extensions/cavi/fallbacks/snapshots/index.ts +9 -0
  602. package/src/extensions/cavi/fallbacks/snapshots/library.ts +112 -0
  603. package/src/extensions/cavi/fallbacks/snapshots/operator-control/defaults.ts +57 -0
  604. package/src/extensions/cavi/fallbacks/snapshots/operator-control/index.ts +3 -0
  605. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-memory.ts +65 -0
  606. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-registry-detail.ts +735 -0
  607. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-section-status.ts +41 -0
  608. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-status.ts +87 -0
  609. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-tasks.ts +113 -0
  610. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-ready.ts +19 -0
  611. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-worker-tasks.ts +46 -0
  612. package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot.ts +18 -0
  613. package/src/extensions/cavi/fallbacks/snapshots/operator-control/transports.ts +81 -0
  614. package/src/extensions/cavi/fallbacks/snapshots/overview.ts +42 -0
  615. package/src/extensions/cavi/fallbacks/snapshots/routing.ts +38 -0
  616. package/src/extensions/cavi/fallbacks/snapshots/runs.ts +141 -0
  617. package/src/extensions/cavi/fallbacks/snapshots/shared.ts +1 -0
  618. package/src/extensions/cavi/index.ts +52 -0
  619. package/src/extensions/cavi/library/api.ts +120 -0
  620. package/src/extensions/cavi/library/client.ts +54 -0
  621. package/src/extensions/cavi/library/clip.ts +389 -0
  622. package/src/extensions/cavi/operator-control/constants.ts +3 -0
  623. package/src/extensions/cavi/operator-control/defaults.ts +254 -0
  624. package/src/extensions/cavi/operator-control/load-section.ts +92 -0
  625. package/src/extensions/cavi/portal/client.ts +63 -0
  626. package/src/extensions/cavi/portal/tts.ts +213 -0
  627. package/src/extensions/cavi/project-board/constants.ts +84 -0
  628. package/src/extensions/cavi/project-board/fallback.ts +129 -0
  629. package/src/extensions/cavi/project-board/live.ts +121 -0
  630. package/src/extensions/cavi/project-board/mutations.ts +306 -0
  631. package/src/extensions/cavi/project-board/normalize.ts +552 -0
  632. package/src/extensions/cavi/project-board/trace-id.ts +9 -0
  633. package/src/extensions/cavi/registry/canonical-team-registry.ts +193 -0
  634. package/src/extensions/cavi/registry/portal-library-registry.ts +24 -0
  635. package/src/extensions/cavi/registry/session-keys.ts +92 -0
  636. package/src/extensions/cavi/registry/team-registry-config.ts +36 -0
  637. package/src/extensions/cavi/registry/team-registry.ts +414 -0
  638. package/src/extensions/cavi/runtime/env-config.ts +114 -0
  639. package/src/extensions/cavi/runtime/paths.ts +82 -0
  640. package/src/extensions/cavi/runtime/standalone-mode.ts +28 -0
  641. package/src/index.ts +576 -0
  642. package/src/providers/hermes/agent-config.ts +322 -0
  643. package/src/providers/hermes/chat-run.ts +340 -0
  644. package/src/providers/hermes/client.ts +21 -0
  645. package/src/providers/hermes/env-config.ts +58 -0
  646. package/src/providers/hermes/index.ts +11 -0
  647. package/src/providers/hermes/media.ts +12 -0
  648. package/src/providers/hermes/provider-module.ts +26 -0
  649. package/src/providers/hermes/sse-run-event-provider.ts +47 -0
  650. package/src/providers/hermes/team-registry-config.ts +2 -0
  651. package/src/providers/hermes/team-registry.ts +12 -0
  652. package/src/providers/hermes/websocket.ts +16 -0
  653. package/src/providers/hermes/wiki.ts +12 -0
  654. package/src/providers/openclaw/agent-config.ts +12 -0
  655. package/src/providers/openclaw/client.ts +21 -0
  656. package/src/providers/openclaw/index.ts +9 -0
  657. package/src/providers/openclaw/media.ts +12 -0
  658. package/src/providers/openclaw/provider-module.ts +20 -0
  659. package/src/providers/openclaw/sse-run-event-provider.ts +16 -0
  660. package/src/providers/openclaw/team-registry-config.ts +2 -0
  661. package/src/providers/openclaw/team-registry.ts +12 -0
  662. package/src/providers/openclaw/websocket.ts +56 -0
  663. package/src/providers/openclaw/wiki.ts +12 -0
  664. package/src/react/gateway-provider.tsx +835 -0
  665. package/src/react/index.ts +1 -0
@@ -0,0 +1,515 @@
1
+ import { GATEWAY_PROBE_ENDPOINTS } from "../../../contracts/paths.js";
2
+ import { asString } from "../../data/guards.js";
3
+ import { classifyFallbackError, withFallback, } from "../envelope/index.js";
4
+ import { BASELINE_SESSIONS_LIST_PARAMS, EMPTY_SESSIONS_USAGE, } from "./session-loaders.js";
5
+ import { buildIncidentsSnapshot, buildOverviewSnapshot, buildRunDetailSnapshot, buildRoutingMatrix, buildRunsSnapshot, normalizeRun, utcDateYmd, } from "./transforms.js";
6
+ function gatewayEnvelope(data) {
7
+ return {
8
+ data,
9
+ source: "gateway",
10
+ fetchedAt: Date.now(),
11
+ contractGaps: [],
12
+ };
13
+ }
14
+ function resolveValue(value, arg) {
15
+ return typeof value === "function"
16
+ ? value(arg)
17
+ : value;
18
+ }
19
+ function resolveUnitValue(value) {
20
+ return typeof value === "function" ? value() : value;
21
+ }
22
+ async function withOptionalSnapshotFallback(params) {
23
+ if (!params.fallback) {
24
+ return gatewayEnvelope(await params.run());
25
+ }
26
+ return await withFallback({
27
+ run: params.run,
28
+ fallback: params.fallback,
29
+ area: params.area,
30
+ expectedContract: params.expectedContract,
31
+ note: params.note,
32
+ });
33
+ }
34
+ function maybeBindRun(run, resolveBinding) {
35
+ const binding = resolveBinding?.({
36
+ key: run.key,
37
+ sessionKey: run.key,
38
+ source: run.channel,
39
+ channel: run.channel,
40
+ agentId: run.agentId,
41
+ }) ?? null;
42
+ return binding ? { ...run, binding } : run;
43
+ }
44
+ function bindRunsSnapshot(snapshot, resolveBinding) {
45
+ if (!resolveBinding) {
46
+ return snapshot;
47
+ }
48
+ return {
49
+ ...snapshot,
50
+ live: snapshot.live.map((run) => maybeBindRun(run, resolveBinding)),
51
+ history: snapshot.history.map((run) => maybeBindRun(run, resolveBinding)),
52
+ };
53
+ }
54
+ function bindRunDetailSnapshot(snapshot, resolveBinding) {
55
+ if (!resolveBinding || !snapshot.run) {
56
+ return snapshot;
57
+ }
58
+ return {
59
+ ...snapshot,
60
+ run: maybeBindRun(snapshot.run, resolveBinding),
61
+ };
62
+ }
63
+ function bindRoutingMatrixSnapshot(snapshot, resolveBinding) {
64
+ if (!resolveBinding) {
65
+ return snapshot;
66
+ }
67
+ return {
68
+ ...snapshot,
69
+ rows: snapshot.rows.map((row) => {
70
+ const binding = resolveBinding({
71
+ source: row.channel,
72
+ channel: row.channel,
73
+ agentId: row.handler,
74
+ });
75
+ return binding ? { ...row, binding } : row;
76
+ }),
77
+ };
78
+ }
79
+ export function createEmptyGatewayOverviewSnapshot(now = Date.now()) {
80
+ return {
81
+ health: {
82
+ live: false,
83
+ ready: false,
84
+ checkedAt: now,
85
+ probes: {
86
+ healthz: {
87
+ path: GATEWAY_PROBE_ENDPOINTS.healthz,
88
+ ok: false,
89
+ statusCode: 200,
90
+ },
91
+ readyz: {
92
+ path: GATEWAY_PROBE_ENDPOINTS.readyz,
93
+ ok: false,
94
+ statusCode: 503,
95
+ failing: [],
96
+ uptimeMs: null,
97
+ },
98
+ },
99
+ },
100
+ kpis: {
101
+ activeSessions: 0,
102
+ totalSessions: 0,
103
+ totalMessages: 0,
104
+ totalToolCalls: 0,
105
+ totalErrors: 0,
106
+ estimatedCostUsd: 0,
107
+ },
108
+ providerBreakdown: [],
109
+ topAgents: [],
110
+ };
111
+ }
112
+ export function createEmptyGatewayRunsSnapshot() {
113
+ return {
114
+ live: [],
115
+ history: [],
116
+ summary: {
117
+ active: 0,
118
+ idle: 0,
119
+ stalled: 0,
120
+ error: 0,
121
+ },
122
+ };
123
+ }
124
+ export function createEmptyGatewayRunDetailSnapshot(key) {
125
+ void key;
126
+ return {
127
+ run: null,
128
+ preview: {
129
+ status: "missing",
130
+ items: [],
131
+ },
132
+ usage: {
133
+ totalTokens: 0,
134
+ totalCostUsd: 0,
135
+ messages: 0,
136
+ toolCalls: 0,
137
+ errors: 0,
138
+ },
139
+ };
140
+ }
141
+ export function createEmptyGatewayRoutingMatrixSnapshot() {
142
+ return {
143
+ rows: [],
144
+ totals: {
145
+ totalRuns: 0,
146
+ successRuns: 0,
147
+ failedRuns: 0,
148
+ },
149
+ };
150
+ }
151
+ export function createEmptyGatewayIncidentsSnapshot() {
152
+ return {
153
+ incidents: [],
154
+ blockers: [],
155
+ };
156
+ }
157
+ export function createEmptyGatewayCostHistorySnapshot(range) {
158
+ return {
159
+ range,
160
+ resolution: "none",
161
+ generatedAt: Date.now(),
162
+ buckets: [],
163
+ totals: {
164
+ totalTokens: 0,
165
+ estimatedCostUsd: 0,
166
+ totalErrors: 0,
167
+ },
168
+ };
169
+ }
170
+ export function createEmptyGatewaySnapshotFallbacks() {
171
+ return {
172
+ overview: createEmptyGatewayOverviewSnapshot,
173
+ agentRuns: createEmptyGatewayRunsSnapshot,
174
+ runDetail: createEmptyGatewayRunDetailSnapshot,
175
+ routingMatrix: createEmptyGatewayRoutingMatrixSnapshot,
176
+ incidents: createEmptyGatewayIncidentsSnapshot,
177
+ };
178
+ }
179
+ export function createEmptyGatewaySnapshotFallbackProvider() {
180
+ return {
181
+ snapshots: createEmptyGatewaySnapshotFallbacks,
182
+ costHistory: createEmptyGatewayCostHistorySnapshot,
183
+ };
184
+ }
185
+ export function createDemoGatewaySnapshotFallbacks(now = Date.now()) {
186
+ const run = {
187
+ key: "demo:agent-alpha:main",
188
+ title: "Demo agent session",
189
+ agentId: "agent-alpha",
190
+ channel: "web",
191
+ updatedAt: now - 60_000,
192
+ status: "active",
193
+ totalTokens: 1200,
194
+ errors: 0,
195
+ model: "demo-model",
196
+ totalCostUsd: 0,
197
+ };
198
+ return {
199
+ overview: {
200
+ ...createEmptyGatewayOverviewSnapshot(now),
201
+ health: {
202
+ ...createEmptyGatewayOverviewSnapshot(now).health,
203
+ live: true,
204
+ ready: true,
205
+ probes: {
206
+ healthz: {
207
+ path: GATEWAY_PROBE_ENDPOINTS.healthz,
208
+ ok: true,
209
+ statusCode: 200,
210
+ },
211
+ readyz: {
212
+ path: GATEWAY_PROBE_ENDPOINTS.readyz,
213
+ ok: true,
214
+ statusCode: 200,
215
+ failing: [],
216
+ uptimeMs: 60_000,
217
+ },
218
+ },
219
+ },
220
+ kpis: {
221
+ activeSessions: 1,
222
+ totalSessions: 1,
223
+ totalMessages: 4,
224
+ totalToolCalls: 1,
225
+ totalErrors: 0,
226
+ estimatedCostUsd: 0,
227
+ },
228
+ providerBreakdown: [{ provider: "demo", tokens: 1200, cost: 0 }],
229
+ topAgents: [{ agentId: "agent-alpha", messages: 4, cost: 0 }],
230
+ },
231
+ agentRuns: {
232
+ live: [run],
233
+ history: [run],
234
+ summary: {
235
+ active: 1,
236
+ idle: 0,
237
+ stalled: 0,
238
+ error: 0,
239
+ },
240
+ },
241
+ runDetail: (key) => ({
242
+ run: key === run.key ? run : null,
243
+ preview: {
244
+ status: key === run.key ? "ok" : "missing",
245
+ items: key === run.key
246
+ ? [
247
+ {
248
+ role: "user",
249
+ text: "Start a demo workflow.",
250
+ at: now - 90_000,
251
+ },
252
+ {
253
+ role: "assistant",
254
+ text: "Demo workflow is running.",
255
+ at: now - 60_000,
256
+ },
257
+ ]
258
+ : [],
259
+ },
260
+ usage: {
261
+ totalTokens: key === run.key ? run.totalTokens : 0,
262
+ totalCostUsd: 0,
263
+ messages: key === run.key ? 4 : 0,
264
+ toolCalls: key === run.key ? 1 : 0,
265
+ errors: 0,
266
+ },
267
+ }),
268
+ routingMatrix: {
269
+ rows: [
270
+ {
271
+ channel: "web",
272
+ handler: "agent-alpha",
273
+ totalRuns: 1,
274
+ successRuns: 1,
275
+ failedRuns: 0,
276
+ successRate: 1,
277
+ messages: 4,
278
+ },
279
+ ],
280
+ totals: {
281
+ totalRuns: 1,
282
+ successRuns: 1,
283
+ failedRuns: 0,
284
+ },
285
+ },
286
+ incidents: createEmptyGatewayIncidentsSnapshot,
287
+ };
288
+ }
289
+ export function createDemoGatewayCostHistorySnapshot(range, now = Date.now()) {
290
+ const bucket = {
291
+ timestamp: now,
292
+ activeSessions: 1,
293
+ totalTokens: 1200,
294
+ estimatedCostUsd: 0,
295
+ totalErrors: 0,
296
+ providerBreakdown: [{ provider: "demo", tokens: 1200, cost: 0 }],
297
+ };
298
+ return {
299
+ range,
300
+ resolution: "demo",
301
+ generatedAt: now,
302
+ buckets: [bucket],
303
+ totals: {
304
+ totalTokens: bucket.totalTokens,
305
+ estimatedCostUsd: bucket.estimatedCostUsd,
306
+ totalErrors: bucket.totalErrors,
307
+ },
308
+ };
309
+ }
310
+ export function createDemoGatewaySnapshotFallbackProvider(now = Date.now()) {
311
+ return {
312
+ snapshots: () => createDemoGatewaySnapshotFallbacks(now),
313
+ costHistory: (range) => createDemoGatewayCostHistorySnapshot(range, now),
314
+ };
315
+ }
316
+ function resolveFallbackProviderSnapshots(provider) {
317
+ if (!provider?.snapshots) {
318
+ return null;
319
+ }
320
+ return typeof provider.snapshots === "function"
321
+ ? provider.snapshots()
322
+ : provider.snapshots;
323
+ }
324
+ export function mergeGatewaySnapshotFallbacks(base, overrides) {
325
+ return {
326
+ ...base,
327
+ ...(overrides ?? {}),
328
+ };
329
+ }
330
+ export function resolveGatewaySnapshotFallbacks(options = {}) {
331
+ const mode = options.mode ?? "empty";
332
+ if (mode === "none") {
333
+ return { snapshots: null, costHistory: null };
334
+ }
335
+ const defaultProvider = mode === "demo"
336
+ ? createDemoGatewaySnapshotFallbackProvider(options.now)
337
+ : createEmptyGatewaySnapshotFallbackProvider();
338
+ const provider = options.provider ?? defaultProvider;
339
+ const baseSnapshots = resolveFallbackProviderSnapshots(provider) ??
340
+ resolveFallbackProviderSnapshots(defaultProvider) ??
341
+ createEmptyGatewaySnapshotFallbacks();
342
+ const hasCostHistoryOverride = !!options.overrides && "costHistory" in options.overrides;
343
+ return {
344
+ snapshots: mergeGatewaySnapshotFallbacks(baseSnapshots, options.overrides),
345
+ costHistory: hasCostHistoryOverride
346
+ ? options.overrides?.costHistory ?? null
347
+ : provider.costHistory ?? defaultProvider.costHistory ?? null,
348
+ };
349
+ }
350
+ export function createGatewaySnapshotLoaders(deps) {
351
+ const { loadSessionsListRaw, loadSessionsUsageRaw, loadSessionsPreviewRaw, peekSessionsListCache, } = deps.sessionLoaders;
352
+ const { loadHealthSnapshotRaw, loadLogsTailRaw } = deps.systemLoaders;
353
+ const fallbacks = deps.options?.fallbacks ??
354
+ resolveFallbackProviderSnapshots(deps.options?.fallbackProvider ?? null);
355
+ const resolveBinding = deps.options?.resolveBinding ?? null;
356
+ const loadSessionsUsageMaybeBestEffort = async (params) => {
357
+ if (!fallbacks) {
358
+ return await loadSessionsUsageRaw(params);
359
+ }
360
+ try {
361
+ return await loadSessionsUsageRaw(params);
362
+ }
363
+ catch (error) {
364
+ const classified = classifyFallbackError(error);
365
+ if (classified.reason === "backend-unavailable" ||
366
+ classified.reason === "transport-disconnected") {
367
+ return EMPTY_SESSIONS_USAGE;
368
+ }
369
+ throw error;
370
+ }
371
+ };
372
+ return {
373
+ loadOverview: async () => await withOptionalSnapshotFallback({
374
+ area: "overview",
375
+ expectedContract: "WS sessions.list + sessions.usage + health.snapshot",
376
+ note: "Gateway overview snapshot unavailable",
377
+ fallback: fallbacks ? resolveUnitValue(fallbacks.overview) : null,
378
+ run: async () => {
379
+ const [listRes, usageRes, healthRes] = await Promise.all([
380
+ loadSessionsListRaw({
381
+ ...BASELINE_SESSIONS_LIST_PARAMS,
382
+ }),
383
+ loadSessionsUsageRaw({
384
+ limit: 300,
385
+ includeContextWeight: false,
386
+ }),
387
+ loadHealthSnapshotRaw(),
388
+ ]);
389
+ const sessions = Array.isArray(listRes.sessions)
390
+ ? listRes.sessions
391
+ : [];
392
+ const readiness = {
393
+ ready: healthRes.ready,
394
+ failing: Array.isArray(healthRes.failing)
395
+ ? healthRes.failing
396
+ .map((entry) => typeof entry === "string" ? entry : String(entry))
397
+ .filter((entry) => entry.trim().length > 0)
398
+ : [],
399
+ uptimeMs: healthRes.uptimeMs ?? null,
400
+ statusCode: healthRes.ready ? 200 : 503,
401
+ };
402
+ return buildOverviewSnapshot(sessions, usageRes, readiness, {
403
+ totalSessions: listRes.count,
404
+ });
405
+ },
406
+ }),
407
+ loadAgentRuns: async (filters) => await withOptionalSnapshotFallback({
408
+ area: "agent-runs",
409
+ expectedContract: "WS sessions.list + sessions.usage",
410
+ note: "Gateway runs snapshot unavailable",
411
+ fallback: fallbacks ? resolveUnitValue(fallbacks.agentRuns) : null,
412
+ run: async () => {
413
+ const [listRes, usageRes] = await Promise.all([
414
+ loadSessionsListRaw({
415
+ limit: filters.limit,
416
+ activeMinutes: filters.activeMinutes,
417
+ includeGlobal: true,
418
+ includeUnknown: true,
419
+ search: filters.search,
420
+ includeDerivedTitles: true,
421
+ }),
422
+ loadSessionsUsageMaybeBestEffort({
423
+ limit: filters.limit,
424
+ includeContextWeight: false,
425
+ }),
426
+ ]);
427
+ const rows = Array.isArray(listRes.sessions) ? listRes.sessions : [];
428
+ return bindRunsSnapshot(buildRunsSnapshot(rows, usageRes), resolveBinding);
429
+ },
430
+ }),
431
+ loadRunDetail: async (key) => await withOptionalSnapshotFallback({
432
+ area: "run-detail",
433
+ expectedContract: "WS sessions.usage + sessions.list + sessions.preview",
434
+ note: "Gateway run detail snapshot unavailable",
435
+ fallback: fallbacks ? resolveValue(fallbacks.runDetail, key) : null,
436
+ run: async () => {
437
+ const [usageRes, previewRes] = await Promise.all([
438
+ loadSessionsUsageRaw({
439
+ key,
440
+ limit: 1,
441
+ includeContextWeight: false,
442
+ }),
443
+ loadSessionsPreviewRaw({
444
+ keys: [key],
445
+ limit: 24,
446
+ maxChars: 240,
447
+ }),
448
+ ]);
449
+ const baselineRows = peekSessionsListCache(BASELINE_SESSIONS_LIST_PARAMS)?.sessions;
450
+ const baselineMatch = Array.isArray(baselineRows)
451
+ ? (baselineRows.find((row) => asString(row.key) === key) ?? null)
452
+ : null;
453
+ let matchedRow = baselineMatch;
454
+ if (!matchedRow) {
455
+ const listRes = await loadSessionsListRaw({
456
+ ...BASELINE_SESSIONS_LIST_PARAMS,
457
+ search: key,
458
+ });
459
+ const rows = Array.isArray(listRes.sessions)
460
+ ? listRes.sessions
461
+ : [];
462
+ matchedRow = rows.find((row) => asString(row.key) === key) ?? null;
463
+ }
464
+ const usageSession = Array.isArray(usageRes.sessions) && usageRes.sessions.length > 0
465
+ ? (usageRes.sessions[0] ?? null)
466
+ : null;
467
+ const run = matchedRow ? normalizeRun(matchedRow, 0) : null;
468
+ const preview = Array.isArray(previewRes.previews)
469
+ ? previewRes.previews[0]
470
+ : null;
471
+ return bindRunDetailSnapshot(buildRunDetailSnapshot(run, usageSession, preview), resolveBinding);
472
+ },
473
+ }),
474
+ loadRoutingMatrix: async (windowDays) => await withOptionalSnapshotFallback({
475
+ area: "routing-matrix",
476
+ expectedContract: "WS sessions.usage",
477
+ note: "Gateway routing snapshot unavailable",
478
+ fallback: fallbacks
479
+ ? resolveValue(fallbacks.routingMatrix, windowDays)
480
+ : null,
481
+ run: async () => {
482
+ const end = new Date();
483
+ const start = new Date(Date.now() - windowDays * 86_400_000);
484
+ const usageRes = await loadSessionsUsageMaybeBestEffort({
485
+ limit: 400,
486
+ startDate: utcDateYmd(start),
487
+ endDate: utcDateYmd(end),
488
+ includeContextWeight: false,
489
+ });
490
+ return bindRoutingMatrixSnapshot(buildRoutingMatrix(usageRes), resolveBinding);
491
+ },
492
+ }),
493
+ loadIncidents: async () => await withOptionalSnapshotFallback({
494
+ area: "incidents",
495
+ expectedContract: "WS logs.tail + sessions.list",
496
+ note: "Gateway incidents snapshot unavailable",
497
+ fallback: fallbacks ? resolveUnitValue(fallbacks.incidents) : null,
498
+ run: async () => {
499
+ const [logsRes, listRes] = await Promise.all([
500
+ loadLogsTailRaw({
501
+ limit: 300,
502
+ maxBytes: 512_000,
503
+ }),
504
+ loadSessionsListRaw({
505
+ ...BASELINE_SESSIONS_LIST_PARAMS,
506
+ }),
507
+ ]);
508
+ const sessions = Array.isArray(listRes.sessions)
509
+ ? listRes.sessions
510
+ : [];
511
+ return buildIncidentsSnapshot(logsRes, sessions);
512
+ },
513
+ }),
514
+ };
515
+ }
@@ -0,0 +1,116 @@
1
+ import type { SessionsListPayload, SessionsPreviewPayload, SessionsUsagePayload } from "./transforms.js";
2
+ import type { GatewayRpcClient } from "../rpc/client.js";
3
+ export type SessionHttpRequestJson = <T>(path: string, init?: {
4
+ method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
5
+ body?: unknown;
6
+ timeoutMs?: number;
7
+ }) => Promise<T>;
8
+ export type CreateSessionLoadersOptions = {
9
+ /** REST fallback used when the dashboard JSON-RPC websocket is unavailable. */
10
+ requestJson?: SessionHttpRequestJson | null;
11
+ };
12
+ /** Filters accepted by the gateway's `sessions.list` RPC. Mirrors the web's contract. */
13
+ export type SessionsListRequestParams = {
14
+ includeGlobal?: boolean;
15
+ includeUnknown?: boolean;
16
+ includeDerivedTitles?: boolean;
17
+ limit?: number;
18
+ activeMinutes?: number;
19
+ search?: string;
20
+ label?: string;
21
+ spawnedBy?: string;
22
+ agentId?: string;
23
+ lastHash?: string;
24
+ };
25
+ /** sessions.list "happy" payload — the gateway returns this when content actually changed. */
26
+ export type SessionsListPayloadWithCache = SessionsListPayload & {
27
+ hash?: string;
28
+ count?: number;
29
+ ts?: number;
30
+ path?: string;
31
+ };
32
+ /** sessions.list "no-op" payload — gateway sends `{ unchanged: true, hash }` when nothing moved. */
33
+ export type SessionsListUnchangedPayload = {
34
+ unchanged: true;
35
+ hash: string;
36
+ count?: number;
37
+ ts?: number;
38
+ path?: string;
39
+ };
40
+ export type SessionsListRpcPayload = SessionsListPayloadWithCache | SessionsListUnchangedPayload;
41
+ /** sessions.detail payload — kept loose because the gateway shape is still in flux. */
42
+ export type SessionDetailPayload = {
43
+ key?: string;
44
+ row?: unknown | null;
45
+ usageSession?: unknown | null;
46
+ preview?: unknown | null;
47
+ errors?: {
48
+ usage?: string | null;
49
+ };
50
+ };
51
+ export type SessionsPreviewRequestParams = {
52
+ keys: string[];
53
+ limit?: number;
54
+ maxChars?: number;
55
+ };
56
+ export type SessionDetailRequestParams = {
57
+ key: string;
58
+ previewLimit?: number;
59
+ maxChars?: number;
60
+ };
61
+ /**
62
+ * sessions.patch params — operator-tunable session settings.
63
+ *
64
+ * `null` clears the value (back to inherit). `undefined` leaves the field untouched.
65
+ * `fastMode` is a tri-state: `true` = on, `false` = off, `null` = inherit, `undefined` = unchanged.
66
+ */
67
+ export type SessionPatchInput = {
68
+ key: string;
69
+ label?: string | null;
70
+ thinkingLevel?: string | null;
71
+ fastMode?: boolean | null;
72
+ verboseLevel?: string | null;
73
+ reasoningLevel?: string | null;
74
+ };
75
+ /** Align with loader `staleTime` (~10–15s) so SSE/stream invalidations coalesce without hammering the gateway. */
76
+ export declare const SESSIONS_DETAIL_CACHE_TTL_MS = 12000;
77
+ export declare const BASELINE_SESSIONS_LIST_PARAMS: SessionsListRequestParams;
78
+ export declare const EMPTY_SESSIONS_USAGE: SessionsUsagePayload;
79
+ export declare function canonicalizeSessionsListParams(params: SessionsListRequestParams): string;
80
+ export declare function canonicalizeSessionsUsageParams(params: Record<string, unknown>): string;
81
+ export declare function canonicalizeSessionsPreviewParams(params: {
82
+ keys?: unknown;
83
+ limit?: unknown;
84
+ maxChars?: unknown;
85
+ }): string;
86
+ export declare function canonicalizeSessionDetailParams(params: {
87
+ key?: unknown;
88
+ previewLimit?: unknown;
89
+ maxChars?: unknown;
90
+ }): string;
91
+ export declare function isUnchangedSessionsListPayload(payload: unknown): payload is SessionsListUnchangedPayload;
92
+ export declare function normalizeSessionsListPayload(payload: SessionsListRpcPayload): SessionsListPayloadWithCache;
93
+ export type SessionLoaders = {
94
+ loadSessionsListRaw: (params: SessionsListRequestParams) => Promise<SessionsListPayloadWithCache>;
95
+ loadSessionsUsageRaw: (params: Record<string, unknown>) => Promise<SessionsUsagePayload>;
96
+ loadSessionsPreviewRaw: (params: SessionsPreviewRequestParams) => Promise<SessionsPreviewPayload>;
97
+ loadSessionDetailRaw: (params: SessionDetailRequestParams) => Promise<SessionDetailPayload>;
98
+ /**
99
+ * Synchronous read of the sessions.list cache for the given param shape. Returns the cached
100
+ * payload (or null) without triggering a fetch. Lets callers do a fast-path lookup before
101
+ * deciding to issue a real `loadSessionsListRaw` call (e.g. detail-by-key fallback).
102
+ */
103
+ peekSessionsListCache: (params: SessionsListRequestParams) => SessionsListPayloadWithCache | null;
104
+ /**
105
+ * Mutate per-session settings via `sessions.patch`. Fire-and-forget — caller is expected to
106
+ * invalidate any session detail / list / usage query on resolve. No client-side caching.
107
+ */
108
+ patchSession: (params: SessionPatchInput) => Promise<void>;
109
+ };
110
+ /**
111
+ * Build the sessions loader bundle. Each call returns a fresh closure with its own caches —
112
+ * intended to be created once per app shell (web adapter, mobile gateway query context) and
113
+ * shared across all queries on that surface.
114
+ */
115
+ export declare function createSessionLoaders(client: GatewayRpcClient | null | undefined, options?: CreateSessionLoadersOptions): SessionLoaders;
116
+ //# sourceMappingURL=session-loaders.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-loaders.d.ts","sourceRoot":"","sources":["../../../../src/core/gateway/snapshots/session-loaders.ts"],"names":[],"mappings":"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"}