mavenagi 0.0.0-alpha.11 → 0.0.0-alpha.14

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 (289) hide show
  1. package/Client.d.ts +9 -0
  2. package/README.md +49 -5
  3. package/api/resources/actions/client/Client.d.ts +9 -0
  4. package/api/resources/actions/client/Client.js +18 -15
  5. package/api/resources/commons/types/AppUser.d.ts +3 -2
  6. package/api/resources/commons/types/AppUserIdentifier.d.ts +1 -1
  7. package/api/resources/commons/types/AppUserRequest.d.ts +19 -1
  8. package/api/resources/commons/types/AppUserResponse.d.ts +34 -2
  9. package/api/resources/commons/types/EntityType.d.ts +2 -1
  10. package/api/resources/commons/types/EntityType.js +1 -0
  11. package/api/resources/commons/types/Feedback.d.ts +4 -8
  12. package/api/resources/commons/types/FeedbackBase.d.ts +10 -0
  13. package/api/resources/commons/types/UserData.d.ts +1 -1
  14. package/api/resources/commons/types/index.d.ts +4 -2
  15. package/api/resources/commons/types/index.js +4 -2
  16. package/api/resources/conversation/client/Client.d.ts +39 -22
  17. package/api/resources/conversation/client/Client.js +97 -77
  18. package/api/resources/conversation/types/AskRequest.d.ts +2 -4
  19. package/api/resources/conversation/types/ConversationBase.d.ts +12 -0
  20. package/api/resources/conversation/types/ConversationMessageBase.d.ts +4 -3
  21. package/api/resources/conversation/types/ConversationRequest.d.ts +0 -2
  22. package/api/resources/conversation/types/ConversationResponse.d.ts +0 -2
  23. package/api/resources/conversation/types/FeedbackRequest.d.ts +8 -1
  24. package/api/resources/conversation/types/SubmitActionFormRequest.d.ts +1 -3
  25. package/api/resources/conversation/types/UserMessageBase.d.ts +2 -0
  26. package/api/resources/conversation/types/index.d.ts +0 -2
  27. package/api/resources/conversation/types/index.js +0 -2
  28. package/api/resources/knowledge/client/Client.d.ts +9 -0
  29. package/api/resources/knowledge/client/Client.js +44 -37
  30. package/api/resources/triggers/client/Client.d.ts +9 -0
  31. package/api/resources/triggers/client/Client.js +18 -15
  32. package/api/resources/triggers/types/index.d.ts +0 -3
  33. package/api/resources/triggers/types/index.js +0 -3
  34. package/api/resources/users/client/Client.d.ts +27 -14
  35. package/api/resources/users/client/Client.js +32 -26
  36. package/core/fetcher/Fetcher.d.ts +4 -1
  37. package/core/fetcher/Fetcher.js +18 -159
  38. package/core/fetcher/createRequestUrl.d.ts +1 -0
  39. package/core/fetcher/createRequestUrl.js +6 -0
  40. package/core/fetcher/getFetchFn.d.ts +4 -0
  41. package/core/fetcher/getFetchFn.js +32 -0
  42. package/core/fetcher/getRequestBody.d.ts +7 -0
  43. package/core/fetcher/getRequestBody.js +19 -0
  44. package/core/fetcher/getResponseBody.d.ts +1 -0
  45. package/core/fetcher/getResponseBody.js +48 -0
  46. package/core/fetcher/makeRequest.d.ts +1 -0
  47. package/core/fetcher/makeRequest.js +38 -0
  48. package/core/fetcher/requestWithRetries.d.ts +1 -0
  49. package/core/fetcher/requestWithRetries.js +28 -0
  50. package/core/fetcher/signals.d.ts +12 -0
  51. package/core/fetcher/signals.js +32 -0
  52. package/core/fetcher/stream-wrappers/Node18UniversalStreamWrapper.d.ts +30 -0
  53. package/core/fetcher/stream-wrappers/Node18UniversalStreamWrapper.js +222 -0
  54. package/core/fetcher/stream-wrappers/NodePre18StreamWrapper.d.ts +21 -0
  55. package/core/fetcher/stream-wrappers/NodePre18StreamWrapper.js +104 -0
  56. package/core/fetcher/stream-wrappers/UndiciStreamWrapper.d.ts +30 -0
  57. package/core/fetcher/stream-wrappers/UndiciStreamWrapper.js +204 -0
  58. package/core/fetcher/stream-wrappers/chooseStreamWrapper.d.ts +17 -0
  59. package/core/fetcher/stream-wrappers/chooseStreamWrapper.js +23 -0
  60. package/core/runtime/runtime.d.ts +1 -0
  61. package/core/runtime/runtime.js +1 -0
  62. package/core/schemas/Schema.d.ts +7 -4
  63. package/core/schemas/builders/lazy/lazy.d.ts +2 -2
  64. package/core/schemas/builders/lazy/lazy.js +8 -19
  65. package/core/schemas/builders/lazy/lazyObject.js +1 -10
  66. package/core/schemas/builders/list/list.js +31 -44
  67. package/core/schemas/builders/object/object.js +90 -111
  68. package/core/schemas/builders/object/types.d.ts +2 -2
  69. package/core/schemas/builders/object-like/getObjectLikeUtils.js +3 -12
  70. package/core/schemas/builders/record/record.js +49 -60
  71. package/core/schemas/builders/schema-utils/getSchemaUtils.d.ts +2 -2
  72. package/core/schemas/builders/schema-utils/getSchemaUtils.js +18 -21
  73. package/core/schemas/builders/set/set.js +6 -15
  74. package/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.js +21 -32
  75. package/core/schemas/builders/union/union.js +51 -62
  76. package/core/schemas/utils/maybeSkipValidation.js +3 -12
  77. package/dist/Client.d.ts +9 -0
  78. package/dist/api/resources/actions/client/Client.d.ts +9 -0
  79. package/dist/api/resources/actions/client/Client.js +18 -15
  80. package/dist/api/resources/commons/types/AppUser.d.ts +3 -2
  81. package/dist/api/resources/commons/types/AppUserIdentifier.d.ts +1 -1
  82. package/dist/api/resources/commons/types/AppUserRequest.d.ts +19 -1
  83. package/dist/api/resources/commons/types/AppUserResponse.d.ts +34 -2
  84. package/dist/api/resources/commons/types/EntityType.d.ts +2 -1
  85. package/dist/api/resources/commons/types/EntityType.js +1 -0
  86. package/dist/api/resources/commons/types/Feedback.d.ts +4 -8
  87. package/dist/api/resources/commons/types/FeedbackBase.d.ts +10 -0
  88. package/dist/api/resources/commons/types/UserData.d.ts +1 -1
  89. package/dist/api/resources/commons/types/index.d.ts +4 -2
  90. package/dist/api/resources/commons/types/index.js +4 -2
  91. package/dist/api/resources/conversation/client/Client.d.ts +39 -22
  92. package/dist/api/resources/conversation/client/Client.js +97 -77
  93. package/dist/api/resources/conversation/types/AskRequest.d.ts +2 -4
  94. package/dist/api/resources/conversation/types/ConversationBase.d.ts +12 -0
  95. package/dist/api/resources/conversation/types/ConversationMessageBase.d.ts +4 -3
  96. package/dist/api/resources/conversation/types/ConversationRequest.d.ts +0 -2
  97. package/dist/api/resources/conversation/types/ConversationResponse.d.ts +0 -2
  98. package/dist/api/resources/conversation/types/FeedbackRequest.d.ts +8 -1
  99. package/dist/api/resources/conversation/types/SubmitActionFormRequest.d.ts +1 -3
  100. package/dist/api/resources/conversation/types/UserMessageBase.d.ts +2 -0
  101. package/dist/api/resources/conversation/types/index.d.ts +0 -2
  102. package/dist/api/resources/conversation/types/index.js +0 -2
  103. package/dist/api/resources/knowledge/client/Client.d.ts +9 -0
  104. package/dist/api/resources/knowledge/client/Client.js +44 -37
  105. package/dist/api/resources/triggers/client/Client.d.ts +9 -0
  106. package/dist/api/resources/triggers/client/Client.js +18 -15
  107. package/dist/api/resources/triggers/types/index.d.ts +0 -3
  108. package/dist/api/resources/triggers/types/index.js +0 -3
  109. package/dist/api/resources/users/client/Client.d.ts +27 -14
  110. package/dist/api/resources/users/client/Client.js +32 -26
  111. package/dist/core/fetcher/Fetcher.d.ts +4 -1
  112. package/dist/core/fetcher/Fetcher.js +18 -159
  113. package/dist/core/fetcher/createRequestUrl.d.ts +1 -0
  114. package/dist/core/fetcher/createRequestUrl.js +6 -0
  115. package/dist/core/fetcher/getFetchFn.d.ts +4 -0
  116. package/dist/core/fetcher/getFetchFn.js +32 -0
  117. package/dist/core/fetcher/getRequestBody.d.ts +7 -0
  118. package/dist/core/fetcher/getRequestBody.js +19 -0
  119. package/dist/core/fetcher/getResponseBody.d.ts +1 -0
  120. package/dist/core/fetcher/getResponseBody.js +48 -0
  121. package/dist/core/fetcher/makeRequest.d.ts +1 -0
  122. package/dist/core/fetcher/makeRequest.js +38 -0
  123. package/dist/core/fetcher/requestWithRetries.d.ts +1 -0
  124. package/dist/core/fetcher/requestWithRetries.js +28 -0
  125. package/dist/core/fetcher/signals.d.ts +12 -0
  126. package/dist/core/fetcher/signals.js +32 -0
  127. package/dist/core/fetcher/stream-wrappers/Node18UniversalStreamWrapper.d.ts +30 -0
  128. package/dist/core/fetcher/stream-wrappers/Node18UniversalStreamWrapper.js +222 -0
  129. package/dist/core/fetcher/stream-wrappers/NodePre18StreamWrapper.d.ts +21 -0
  130. package/dist/core/fetcher/stream-wrappers/NodePre18StreamWrapper.js +104 -0
  131. package/dist/core/fetcher/stream-wrappers/UndiciStreamWrapper.d.ts +30 -0
  132. package/dist/core/fetcher/stream-wrappers/UndiciStreamWrapper.js +204 -0
  133. package/dist/core/fetcher/stream-wrappers/chooseStreamWrapper.d.ts +17 -0
  134. package/dist/core/fetcher/stream-wrappers/chooseStreamWrapper.js +23 -0
  135. package/dist/core/runtime/runtime.d.ts +1 -0
  136. package/dist/core/runtime/runtime.js +1 -0
  137. package/dist/core/schemas/Schema.d.ts +7 -4
  138. package/dist/core/schemas/builders/lazy/lazy.d.ts +2 -2
  139. package/dist/core/schemas/builders/lazy/lazy.js +8 -19
  140. package/dist/core/schemas/builders/lazy/lazyObject.js +1 -10
  141. package/dist/core/schemas/builders/list/list.js +31 -44
  142. package/dist/core/schemas/builders/object/object.js +90 -111
  143. package/dist/core/schemas/builders/object/types.d.ts +2 -2
  144. package/dist/core/schemas/builders/object-like/getObjectLikeUtils.js +3 -12
  145. package/dist/core/schemas/builders/record/record.js +49 -60
  146. package/dist/core/schemas/builders/schema-utils/getSchemaUtils.d.ts +2 -2
  147. package/dist/core/schemas/builders/schema-utils/getSchemaUtils.js +18 -21
  148. package/dist/core/schemas/builders/set/set.js +6 -15
  149. package/dist/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.js +21 -32
  150. package/dist/core/schemas/builders/union/union.js +51 -62
  151. package/dist/core/schemas/utils/maybeSkipValidation.js +3 -12
  152. package/dist/serialization/resources/commons/types/AppUser.d.ts +3 -3
  153. package/dist/serialization/resources/commons/types/AppUser.js +3 -3
  154. package/dist/serialization/resources/commons/types/AppUserIdentifier.d.ts +1 -1
  155. package/dist/serialization/resources/commons/types/AppUserIdentifier.js +1 -1
  156. package/dist/serialization/resources/commons/types/AppUserRequest.d.ts +1 -1
  157. package/dist/serialization/resources/commons/types/AppUserRequest.js +1 -1
  158. package/dist/serialization/resources/commons/types/AppUserResponse.d.ts +2 -1
  159. package/dist/serialization/resources/commons/types/AppUserResponse.js +2 -1
  160. package/dist/serialization/resources/commons/types/EntityType.d.ts +1 -1
  161. package/dist/serialization/resources/commons/types/EntityType.js +1 -0
  162. package/{serialization/resources/triggers → dist/serialization/resources/commons}/types/EventTriggerResponse.d.ts +1 -1
  163. package/{serialization/resources/triggers → dist/serialization/resources/commons}/types/EventTriggerResponse.js +1 -1
  164. package/dist/serialization/resources/commons/types/Feedback.d.ts +6 -7
  165. package/dist/serialization/resources/commons/types/Feedback.js +9 -8
  166. package/dist/serialization/resources/commons/types/FeedbackBase.d.ts +14 -0
  167. package/dist/serialization/resources/commons/types/FeedbackBase.js +9 -0
  168. package/dist/serialization/resources/commons/types/UserData.d.ts +1 -1
  169. package/dist/serialization/resources/commons/types/UserData.js +1 -1
  170. package/dist/serialization/resources/commons/types/index.d.ts +4 -2
  171. package/dist/serialization/resources/commons/types/index.js +4 -2
  172. package/dist/serialization/resources/conversation/types/AskRequest.d.ts +1 -4
  173. package/dist/serialization/resources/conversation/types/AskRequest.js +1 -4
  174. package/dist/serialization/resources/conversation/types/ConversationBase.d.ts +6 -0
  175. package/dist/serialization/resources/conversation/types/ConversationBase.js +6 -0
  176. package/dist/serialization/resources/conversation/types/ConversationMessageBase.d.ts +2 -2
  177. package/dist/serialization/resources/conversation/types/ConversationMessageBase.js +2 -2
  178. package/dist/serialization/resources/conversation/types/ConversationRequest.d.ts +0 -2
  179. package/dist/serialization/resources/conversation/types/ConversationRequest.js +0 -2
  180. package/dist/serialization/resources/conversation/types/ConversationResponse.d.ts +0 -2
  181. package/dist/serialization/resources/conversation/types/ConversationResponse.js +0 -2
  182. package/dist/serialization/resources/conversation/types/FeedbackRequest.d.ts +7 -2
  183. package/dist/serialization/resources/conversation/types/FeedbackRequest.js +10 -2
  184. package/dist/serialization/resources/conversation/types/SubmitActionFormRequest.d.ts +0 -2
  185. package/dist/serialization/resources/conversation/types/SubmitActionFormRequest.js +0 -2
  186. package/dist/serialization/resources/conversation/types/UserMessageBase.d.ts +2 -0
  187. package/dist/serialization/resources/conversation/types/UserMessageBase.js +2 -0
  188. package/dist/serialization/resources/conversation/types/index.d.ts +0 -2
  189. package/dist/serialization/resources/conversation/types/index.js +0 -2
  190. package/dist/serialization/resources/triggers/types/EventTriggerRequest.d.ts +1 -1
  191. package/dist/serialization/resources/triggers/types/EventTriggerRequest.js +1 -1
  192. package/dist/serialization/resources/triggers/types/index.d.ts +0 -3
  193. package/dist/serialization/resources/triggers/types/index.js +0 -3
  194. package/package.json +7 -2
  195. package/reference.md +1732 -0
  196. package/serialization/resources/commons/types/AppUser.d.ts +3 -3
  197. package/serialization/resources/commons/types/AppUser.js +3 -3
  198. package/serialization/resources/commons/types/AppUserIdentifier.d.ts +1 -1
  199. package/serialization/resources/commons/types/AppUserIdentifier.js +1 -1
  200. package/serialization/resources/commons/types/AppUserRequest.d.ts +1 -1
  201. package/serialization/resources/commons/types/AppUserRequest.js +1 -1
  202. package/serialization/resources/commons/types/AppUserResponse.d.ts +2 -1
  203. package/serialization/resources/commons/types/AppUserResponse.js +2 -1
  204. package/serialization/resources/commons/types/EntityType.d.ts +1 -1
  205. package/serialization/resources/commons/types/EntityType.js +1 -0
  206. package/{dist/serialization/resources/triggers → serialization/resources/commons}/types/EventTriggerResponse.d.ts +1 -1
  207. package/{dist/serialization/resources/triggers → serialization/resources/commons}/types/EventTriggerResponse.js +1 -1
  208. package/serialization/resources/commons/types/Feedback.d.ts +6 -7
  209. package/serialization/resources/commons/types/Feedback.js +9 -8
  210. package/serialization/resources/commons/types/FeedbackBase.d.ts +14 -0
  211. package/serialization/resources/commons/types/FeedbackBase.js +9 -0
  212. package/serialization/resources/commons/types/UserData.d.ts +1 -1
  213. package/serialization/resources/commons/types/UserData.js +1 -1
  214. package/serialization/resources/commons/types/index.d.ts +4 -2
  215. package/serialization/resources/commons/types/index.js +4 -2
  216. package/serialization/resources/conversation/types/AskRequest.d.ts +1 -4
  217. package/serialization/resources/conversation/types/AskRequest.js +1 -4
  218. package/serialization/resources/conversation/types/ConversationBase.d.ts +6 -0
  219. package/serialization/resources/conversation/types/ConversationBase.js +6 -0
  220. package/serialization/resources/conversation/types/ConversationMessageBase.d.ts +2 -2
  221. package/serialization/resources/conversation/types/ConversationMessageBase.js +2 -2
  222. package/serialization/resources/conversation/types/ConversationRequest.d.ts +0 -2
  223. package/serialization/resources/conversation/types/ConversationRequest.js +0 -2
  224. package/serialization/resources/conversation/types/ConversationResponse.d.ts +0 -2
  225. package/serialization/resources/conversation/types/ConversationResponse.js +0 -2
  226. package/serialization/resources/conversation/types/FeedbackRequest.d.ts +7 -2
  227. package/serialization/resources/conversation/types/FeedbackRequest.js +10 -2
  228. package/serialization/resources/conversation/types/SubmitActionFormRequest.d.ts +0 -2
  229. package/serialization/resources/conversation/types/SubmitActionFormRequest.js +0 -2
  230. package/serialization/resources/conversation/types/UserMessageBase.d.ts +2 -0
  231. package/serialization/resources/conversation/types/UserMessageBase.js +2 -0
  232. package/serialization/resources/conversation/types/index.d.ts +0 -2
  233. package/serialization/resources/conversation/types/index.js +0 -2
  234. package/serialization/resources/triggers/types/EventTriggerRequest.d.ts +1 -1
  235. package/serialization/resources/triggers/types/EventTriggerRequest.js +1 -1
  236. package/serialization/resources/triggers/types/index.d.ts +0 -3
  237. package/serialization/resources/triggers/types/index.js +0 -3
  238. package/api/resources/commons/types/AppUserIdentification.d.ts +0 -8
  239. package/api/resources/commons/types/User.d.ts +0 -10
  240. package/api/resources/conversation/types/ConversationContext.d.ts +0 -20
  241. package/api/resources/conversation/types/ConversationContext.js +0 -4
  242. package/api/resources/conversation/types/ConversationMessageContext.d.ts +0 -12
  243. package/api/resources/conversation/types/ConversationMessageContext.js +0 -4
  244. package/dist/api/resources/commons/types/AppUserIdentification.d.ts +0 -8
  245. package/dist/api/resources/commons/types/AppUserIdentification.js +0 -4
  246. package/dist/api/resources/commons/types/User.d.ts +0 -10
  247. package/dist/api/resources/commons/types/User.js +0 -4
  248. package/dist/api/resources/conversation/types/ConversationContext.d.ts +0 -20
  249. package/dist/api/resources/conversation/types/ConversationContext.js +0 -4
  250. package/dist/api/resources/conversation/types/ConversationMessageContext.d.ts +0 -12
  251. package/dist/api/resources/conversation/types/ConversationMessageContext.js +0 -4
  252. package/dist/serialization/resources/commons/types/AppUserIdentification.d.ts +0 -13
  253. package/dist/serialization/resources/commons/types/AppUserIdentification.js +0 -8
  254. package/dist/serialization/resources/commons/types/User.d.ts +0 -15
  255. package/dist/serialization/resources/commons/types/User.js +0 -10
  256. package/dist/serialization/resources/conversation/types/ConversationContext.d.ts +0 -20
  257. package/dist/serialization/resources/conversation/types/ConversationContext.js +0 -15
  258. package/dist/serialization/resources/conversation/types/ConversationMessageContext.d.ts +0 -16
  259. package/dist/serialization/resources/conversation/types/ConversationMessageContext.js +0 -11
  260. package/serialization/resources/commons/types/AppUserIdentification.d.ts +0 -13
  261. package/serialization/resources/commons/types/AppUserIdentification.js +0 -8
  262. package/serialization/resources/commons/types/User.d.ts +0 -15
  263. package/serialization/resources/commons/types/User.js +0 -10
  264. package/serialization/resources/conversation/types/ConversationContext.d.ts +0 -20
  265. package/serialization/resources/conversation/types/ConversationContext.js +0 -15
  266. package/serialization/resources/conversation/types/ConversationMessageContext.d.ts +0 -16
  267. package/serialization/resources/conversation/types/ConversationMessageContext.js +0 -11
  268. /package/api/resources/{triggers → commons}/types/EventTriggerBase.d.ts +0 -0
  269. /package/api/resources/{triggers → commons}/types/EventTriggerBase.js +0 -0
  270. /package/api/resources/{triggers → commons}/types/EventTriggerResponse.d.ts +0 -0
  271. /package/api/resources/{triggers → commons}/types/EventTriggerResponse.js +0 -0
  272. /package/api/resources/{triggers → commons}/types/EventTriggerType.d.ts +0 -0
  273. /package/api/resources/{triggers → commons}/types/EventTriggerType.js +0 -0
  274. /package/api/resources/commons/types/{AppUserIdentification.js → FeedbackBase.js} +0 -0
  275. /package/dist/api/resources/{triggers → commons}/types/EventTriggerBase.d.ts +0 -0
  276. /package/dist/api/resources/{triggers → commons}/types/EventTriggerBase.js +0 -0
  277. /package/dist/api/resources/{triggers → commons}/types/EventTriggerResponse.d.ts +0 -0
  278. /package/dist/api/resources/{triggers → commons}/types/EventTriggerResponse.js +0 -0
  279. /package/dist/api/resources/{triggers → commons}/types/EventTriggerType.d.ts +0 -0
  280. /package/dist/api/resources/{triggers → commons}/types/EventTriggerType.js +0 -0
  281. /package/{api/resources/commons/types/User.js → dist/api/resources/commons/types/FeedbackBase.js} +0 -0
  282. /package/dist/serialization/resources/{triggers → commons}/types/EventTriggerBase.d.ts +0 -0
  283. /package/dist/serialization/resources/{triggers → commons}/types/EventTriggerBase.js +0 -0
  284. /package/dist/serialization/resources/{triggers → commons}/types/EventTriggerType.d.ts +0 -0
  285. /package/dist/serialization/resources/{triggers → commons}/types/EventTriggerType.js +0 -0
  286. /package/serialization/resources/{triggers → commons}/types/EventTriggerBase.d.ts +0 -0
  287. /package/serialization/resources/{triggers → commons}/types/EventTriggerBase.js +0 -0
  288. /package/serialization/resources/{triggers → commons}/types/EventTriggerType.d.ts +0 -0
  289. /package/serialization/resources/{triggers → commons}/types/EventTriggerType.js +0 -0
package/reference.md ADDED
@@ -0,0 +1,1732 @@
1
+ # Reference
2
+
3
+ ## Actions
4
+
5
+ <details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.ActionResponse</code></summary>
6
+ <dl>
7
+ <dd>
8
+
9
+ #### 📝 Description
10
+
11
+ <dl>
12
+ <dd>
13
+
14
+ <dl>
15
+ <dd>
16
+
17
+ Update an action or create it if it doesn't exist
18
+
19
+ </dd>
20
+ </dl>
21
+ </dd>
22
+ </dl>
23
+
24
+ #### 🔌 Usage
25
+
26
+ <dl>
27
+ <dd>
28
+
29
+ <dl>
30
+ <dd>
31
+
32
+ ```typescript
33
+ await client.actions.createOrUpdate({
34
+ actionId: {
35
+ referenceId: "get-balance",
36
+ },
37
+ name: "Get the user's balance",
38
+ description: "This action calls an API to get the user's current balance.",
39
+ userInteractionRequired: false,
40
+ preconditions: {
41
+ requiredUserContextFieldNames: new Set(["my-billing-system.userId"]),
42
+ },
43
+ userFormParameters: [],
44
+ });
45
+ ```
46
+
47
+ </dd>
48
+ </dl>
49
+ </dd>
50
+ </dl>
51
+
52
+ #### ⚙️ Parameters
53
+
54
+ <dl>
55
+ <dd>
56
+
57
+ <dl>
58
+ <dd>
59
+
60
+ **request:** `MavenAGI.ActionRequest`
61
+
62
+ </dd>
63
+ </dl>
64
+
65
+ <dl>
66
+ <dd>
67
+
68
+ **requestOptions:** `Actions.RequestOptions`
69
+
70
+ </dd>
71
+ </dl>
72
+ </dd>
73
+ </dl>
74
+
75
+ </dd>
76
+ </dl>
77
+ </details>
78
+
79
+ <details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">get</a>(actionReferenceId) -> MavenAGI.ActionResponse</code></summary>
80
+ <dl>
81
+ <dd>
82
+
83
+ #### 📝 Description
84
+
85
+ <dl>
86
+ <dd>
87
+
88
+ <dl>
89
+ <dd>
90
+
91
+ Get an action by its supplied ID
92
+
93
+ </dd>
94
+ </dl>
95
+ </dd>
96
+ </dl>
97
+
98
+ #### 🔌 Usage
99
+
100
+ <dl>
101
+ <dd>
102
+
103
+ <dl>
104
+ <dd>
105
+
106
+ ```typescript
107
+ await client.actions.get("get-balance");
108
+ ```
109
+
110
+ </dd>
111
+ </dl>
112
+ </dd>
113
+ </dl>
114
+
115
+ #### ⚙️ Parameters
116
+
117
+ <dl>
118
+ <dd>
119
+
120
+ <dl>
121
+ <dd>
122
+
123
+ **actionReferenceId:** `string` — The reference ID of the action to get. All other entity ID fields are inferred from the request.
124
+
125
+ </dd>
126
+ </dl>
127
+
128
+ <dl>
129
+ <dd>
130
+
131
+ **requestOptions:** `Actions.RequestOptions`
132
+
133
+ </dd>
134
+ </dl>
135
+ </dd>
136
+ </dl>
137
+
138
+ </dd>
139
+ </dl>
140
+ </details>
141
+
142
+ <details><summary><code>client.actions.<a href="/src/api/resources/actions/client/Client.ts">delete</a>(actionReferenceId) -> void</code></summary>
143
+ <dl>
144
+ <dd>
145
+
146
+ #### 📝 Description
147
+
148
+ <dl>
149
+ <dd>
150
+
151
+ <dl>
152
+ <dd>
153
+
154
+ Delete an action
155
+
156
+ </dd>
157
+ </dl>
158
+ </dd>
159
+ </dl>
160
+
161
+ #### 🔌 Usage
162
+
163
+ <dl>
164
+ <dd>
165
+
166
+ <dl>
167
+ <dd>
168
+
169
+ ```typescript
170
+ await client.actions.delete("get-balance");
171
+ ```
172
+
173
+ </dd>
174
+ </dl>
175
+ </dd>
176
+ </dl>
177
+
178
+ #### ⚙️ Parameters
179
+
180
+ <dl>
181
+ <dd>
182
+
183
+ <dl>
184
+ <dd>
185
+
186
+ **actionReferenceId:** `string` — The reference ID of the action to unregister. All other entity ID fields are inferred from the request.
187
+
188
+ </dd>
189
+ </dl>
190
+
191
+ <dl>
192
+ <dd>
193
+
194
+ **requestOptions:** `Actions.RequestOptions`
195
+
196
+ </dd>
197
+ </dl>
198
+ </dd>
199
+ </dl>
200
+
201
+ </dd>
202
+ </dl>
203
+ </details>
204
+
205
+ ## Conversation
206
+
207
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">initialize</a>({ ...params }) -> MavenAGI.ConversationResponse</code></summary>
208
+ <dl>
209
+ <dd>
210
+
211
+ #### 📝 Description
212
+
213
+ <dl>
214
+ <dd>
215
+
216
+ <dl>
217
+ <dd>
218
+
219
+ Initialize a new conversation. Only required if the ask request wishes to supply conversation level data or when syncing to external systems.
220
+
221
+ </dd>
222
+ </dl>
223
+ </dd>
224
+ </dl>
225
+
226
+ #### 🔌 Usage
227
+
228
+ <dl>
229
+ <dd>
230
+
231
+ <dl>
232
+ <dd>
233
+
234
+ ```typescript
235
+ await client.conversation.initialize({
236
+ conversationId: {
237
+ referenceId: "string",
238
+ },
239
+ messages: [{}],
240
+ responseConfig: {
241
+ capabilities: [MavenAGI.Capability.Markdown],
242
+ isCopilot: true,
243
+ responseLength: MavenAGI.ResponseLength.Short,
244
+ },
245
+ subject: "string",
246
+ url: "string",
247
+ createdAt: new Date("2024-01-15T09:30:00.000Z"),
248
+ updatedAt: new Date("2024-01-15T09:30:00.000Z"),
249
+ tags: new Set(["string"]),
250
+ metadata: {
251
+ string: "string",
252
+ },
253
+ });
254
+ ```
255
+
256
+ </dd>
257
+ </dl>
258
+ </dd>
259
+ </dl>
260
+
261
+ #### ⚙️ Parameters
262
+
263
+ <dl>
264
+ <dd>
265
+
266
+ <dl>
267
+ <dd>
268
+
269
+ **request:** `MavenAGI.ConversationRequest`
270
+
271
+ </dd>
272
+ </dl>
273
+
274
+ <dl>
275
+ <dd>
276
+
277
+ **requestOptions:** `Conversation.RequestOptions`
278
+
279
+ </dd>
280
+ </dl>
281
+ </dd>
282
+ </dl>
283
+
284
+ </dd>
285
+ </dl>
286
+ </details>
287
+
288
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">get</a>(conversationId) -> MavenAGI.ConversationResponse</code></summary>
289
+ <dl>
290
+ <dd>
291
+
292
+ #### 📝 Description
293
+
294
+ <dl>
295
+ <dd>
296
+
297
+ <dl>
298
+ <dd>
299
+
300
+ Get a conversation
301
+
302
+ </dd>
303
+ </dl>
304
+ </dd>
305
+ </dl>
306
+
307
+ #### 🔌 Usage
308
+
309
+ <dl>
310
+ <dd>
311
+
312
+ <dl>
313
+ <dd>
314
+
315
+ ```typescript
316
+ await client.conversation.get("string");
317
+ ```
318
+
319
+ </dd>
320
+ </dl>
321
+ </dd>
322
+ </dl>
323
+
324
+ #### ⚙️ Parameters
325
+
326
+ <dl>
327
+ <dd>
328
+
329
+ <dl>
330
+ <dd>
331
+
332
+ **conversationId:** `string` — The ID of the conversation to get
333
+
334
+ </dd>
335
+ </dl>
336
+
337
+ <dl>
338
+ <dd>
339
+
340
+ **requestOptions:** `Conversation.RequestOptions`
341
+
342
+ </dd>
343
+ </dl>
344
+ </dd>
345
+ </dl>
346
+
347
+ </dd>
348
+ </dl>
349
+ </details>
350
+
351
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">appendNewMessages</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
352
+ <dl>
353
+ <dd>
354
+
355
+ #### 📝 Description
356
+
357
+ <dl>
358
+ <dd>
359
+
360
+ <dl>
361
+ <dd>
362
+
363
+ Append messages to an existing conversation. The conversation must be initialized first. If a message with the same id already exists, it will be ignored.
364
+
365
+ </dd>
366
+ </dl>
367
+ </dd>
368
+ </dl>
369
+
370
+ #### 🔌 Usage
371
+
372
+ <dl>
373
+ <dd>
374
+
375
+ <dl>
376
+ <dd>
377
+
378
+ ```typescript
379
+ await client.conversation.appendNewMessages("string", [
380
+ {
381
+ conversationMessageId: {
382
+ referenceId: "string",
383
+ },
384
+ userId: {
385
+ referenceId: "string",
386
+ },
387
+ text: "string",
388
+ userMessageType: MavenAGI.UserConversationMessageType.User,
389
+ createdAt: new Date("2024-01-15T09:30:00.000Z"),
390
+ updatedAt: new Date("2024-01-15T09:30:00.000Z"),
391
+ },
392
+ ]);
393
+ ```
394
+
395
+ </dd>
396
+ </dl>
397
+ </dd>
398
+ </dl>
399
+
400
+ #### ⚙️ Parameters
401
+
402
+ <dl>
403
+ <dd>
404
+
405
+ <dl>
406
+ <dd>
407
+
408
+ **conversationId:** `string` — The ID of the conversation to append messages to
409
+
410
+ </dd>
411
+ </dl>
412
+
413
+ <dl>
414
+ <dd>
415
+
416
+ **request:** `MavenAGI.ConversationMessageRequest[]`
417
+
418
+ </dd>
419
+ </dl>
420
+
421
+ <dl>
422
+ <dd>
423
+
424
+ **requestOptions:** `Conversation.RequestOptions`
425
+
426
+ </dd>
427
+ </dl>
428
+ </dd>
429
+ </dl>
430
+
431
+ </dd>
432
+ </dl>
433
+ </details>
434
+
435
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">ask</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
436
+ <dl>
437
+ <dd>
438
+
439
+ #### 📝 Description
440
+
441
+ <dl>
442
+ <dd>
443
+
444
+ <dl>
445
+ <dd>
446
+
447
+ Ask a question
448
+
449
+ </dd>
450
+ </dl>
451
+ </dd>
452
+ </dl>
453
+
454
+ #### 🔌 Usage
455
+
456
+ <dl>
457
+ <dd>
458
+
459
+ <dl>
460
+ <dd>
461
+
462
+ ```typescript
463
+ await client.conversation.ask("string", {
464
+ conversationMessageId: {
465
+ referenceId: "string",
466
+ },
467
+ userId: {
468
+ referenceId: "string",
469
+ },
470
+ text: "string",
471
+ });
472
+ ```
473
+
474
+ </dd>
475
+ </dl>
476
+ </dd>
477
+ </dl>
478
+
479
+ #### ⚙️ Parameters
480
+
481
+ <dl>
482
+ <dd>
483
+
484
+ <dl>
485
+ <dd>
486
+
487
+ **conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
488
+
489
+ </dd>
490
+ </dl>
491
+
492
+ <dl>
493
+ <dd>
494
+
495
+ **request:** `MavenAGI.AskRequest`
496
+
497
+ </dd>
498
+ </dl>
499
+
500
+ <dl>
501
+ <dd>
502
+
503
+ **requestOptions:** `Conversation.RequestOptions`
504
+
505
+ </dd>
506
+ </dl>
507
+ </dd>
508
+ </dl>
509
+
510
+ </dd>
511
+ </dl>
512
+ </details>
513
+
514
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">askStream</a>(conversationId, { ...params }) -> core.Stream<MavenAGI.StreamResponse></code></summary>
515
+ <dl>
516
+ <dd>
517
+
518
+ #### 📝 Description
519
+
520
+ <dl>
521
+ <dd>
522
+
523
+ <dl>
524
+ <dd>
525
+
526
+ Ask a question
527
+
528
+ </dd>
529
+ </dl>
530
+ </dd>
531
+ </dl>
532
+
533
+ #### 🔌 Usage
534
+
535
+ <dl>
536
+ <dd>
537
+
538
+ <dl>
539
+ <dd>
540
+
541
+ ```typescript
542
+ await client.conversation.askStream("string", {
543
+ conversationMessageId: {
544
+ referenceId: "string",
545
+ },
546
+ userId: {
547
+ referenceId: "string",
548
+ },
549
+ text: "string",
550
+ });
551
+ ```
552
+
553
+ </dd>
554
+ </dl>
555
+ </dd>
556
+ </dl>
557
+
558
+ #### ⚙️ Parameters
559
+
560
+ <dl>
561
+ <dd>
562
+
563
+ <dl>
564
+ <dd>
565
+
566
+ **conversationId:** `string` — The ID of a new or existing conversation to use as context for the question
567
+
568
+ </dd>
569
+ </dl>
570
+
571
+ <dl>
572
+ <dd>
573
+
574
+ **request:** `MavenAGI.AskRequest`
575
+
576
+ </dd>
577
+ </dl>
578
+
579
+ <dl>
580
+ <dd>
581
+
582
+ **requestOptions:** `Conversation.RequestOptions`
583
+
584
+ </dd>
585
+ </dl>
586
+ </dd>
587
+ </dl>
588
+
589
+ </dd>
590
+ </dl>
591
+ </details>
592
+
593
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">generateMavenSuggestions</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
594
+ <dl>
595
+ <dd>
596
+
597
+ #### 📝 Description
598
+
599
+ <dl>
600
+ <dd>
601
+
602
+ <dl>
603
+ <dd>
604
+
605
+ Generate a response suggestion for each requested message id in a conversation
606
+
607
+ </dd>
608
+ </dl>
609
+ </dd>
610
+ </dl>
611
+
612
+ #### 🔌 Usage
613
+
614
+ <dl>
615
+ <dd>
616
+
617
+ <dl>
618
+ <dd>
619
+
620
+ ```typescript
621
+ await client.conversation.generateMavenSuggestions("string", {
622
+ conversationMessageIds: [
623
+ {
624
+ referenceId: "string",
625
+ },
626
+ ],
627
+ });
628
+ ```
629
+
630
+ </dd>
631
+ </dl>
632
+ </dd>
633
+ </dl>
634
+
635
+ #### ⚙️ Parameters
636
+
637
+ <dl>
638
+ <dd>
639
+
640
+ <dl>
641
+ <dd>
642
+
643
+ **conversationId:** `string` — The ID of a conversation the messages belong to
644
+
645
+ </dd>
646
+ </dl>
647
+
648
+ <dl>
649
+ <dd>
650
+
651
+ **request:** `MavenAGI.GenerateMavenSuggestionsRequest`
652
+
653
+ </dd>
654
+ </dl>
655
+
656
+ <dl>
657
+ <dd>
658
+
659
+ **requestOptions:** `Conversation.RequestOptions`
660
+
661
+ </dd>
662
+ </dl>
663
+ </dd>
664
+ </dl>
665
+
666
+ </dd>
667
+ </dl>
668
+ </details>
669
+
670
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">createFeedback</a>({ ...params }) -> MavenAGI.Feedback</code></summary>
671
+ <dl>
672
+ <dd>
673
+
674
+ #### 📝 Description
675
+
676
+ <dl>
677
+ <dd>
678
+
679
+ <dl>
680
+ <dd>
681
+
682
+ Create feedback
683
+
684
+ </dd>
685
+ </dl>
686
+ </dd>
687
+ </dl>
688
+
689
+ #### 🔌 Usage
690
+
691
+ <dl>
692
+ <dd>
693
+
694
+ <dl>
695
+ <dd>
696
+
697
+ ```typescript
698
+ await client.conversation.createFeedback({
699
+ feedbackId: {
700
+ referenceId: "string",
701
+ },
702
+ conversationId: {
703
+ referenceId: "string",
704
+ },
705
+ conversationMessageId: {
706
+ referenceId: "string",
707
+ },
708
+ type: MavenAGI.FeedbackType.ThumbsUp,
709
+ text: "string",
710
+ });
711
+ ```
712
+
713
+ </dd>
714
+ </dl>
715
+ </dd>
716
+ </dl>
717
+
718
+ #### ⚙️ Parameters
719
+
720
+ <dl>
721
+ <dd>
722
+
723
+ <dl>
724
+ <dd>
725
+
726
+ **request:** `MavenAGI.FeedbackRequest`
727
+
728
+ </dd>
729
+ </dl>
730
+
731
+ <dl>
732
+ <dd>
733
+
734
+ **requestOptions:** `Conversation.RequestOptions`
735
+
736
+ </dd>
737
+ </dl>
738
+ </dd>
739
+ </dl>
740
+
741
+ </dd>
742
+ </dl>
743
+ </details>
744
+
745
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">submitActionForm</a>(conversationId, { ...params }) -> MavenAGI.ConversationResponse</code></summary>
746
+ <dl>
747
+ <dd>
748
+
749
+ #### 📝 Description
750
+
751
+ <dl>
752
+ <dd>
753
+
754
+ <dl>
755
+ <dd>
756
+
757
+ Submit a filled out action form
758
+
759
+ </dd>
760
+ </dl>
761
+ </dd>
762
+ </dl>
763
+
764
+ #### 🔌 Usage
765
+
766
+ <dl>
767
+ <dd>
768
+
769
+ <dl>
770
+ <dd>
771
+
772
+ ```typescript
773
+ await client.conversation.submitActionForm("string", {
774
+ actionFormId: "string",
775
+ parameters: {
776
+ string: {
777
+ key: "value",
778
+ },
779
+ },
780
+ });
781
+ ```
782
+
783
+ </dd>
784
+ </dl>
785
+ </dd>
786
+ </dl>
787
+
788
+ #### ⚙️ Parameters
789
+
790
+ <dl>
791
+ <dd>
792
+
793
+ <dl>
794
+ <dd>
795
+
796
+ **conversationId:** `string` — The ID of a conversation the form being submitted belongs to
797
+
798
+ </dd>
799
+ </dl>
800
+
801
+ <dl>
802
+ <dd>
803
+
804
+ **request:** `MavenAGI.SubmitActionFormRequest`
805
+
806
+ </dd>
807
+ </dl>
808
+
809
+ <dl>
810
+ <dd>
811
+
812
+ **requestOptions:** `Conversation.RequestOptions`
813
+
814
+ </dd>
815
+ </dl>
816
+ </dd>
817
+ </dl>
818
+
819
+ </dd>
820
+ </dl>
821
+ </details>
822
+
823
+ <details><summary><code>client.conversation.<a href="/src/api/resources/conversation/client/Client.ts">addConversationMetadata</a>(conversationId, { ...params }) -> Record<string, string></code></summary>
824
+ <dl>
825
+ <dd>
826
+
827
+ #### 📝 Description
828
+
829
+ <dl>
830
+ <dd>
831
+
832
+ <dl>
833
+ <dd>
834
+
835
+ Add metadata to an existing conversation. If a metadata field already exists, it will be overwritten.
836
+
837
+ </dd>
838
+ </dl>
839
+ </dd>
840
+ </dl>
841
+
842
+ #### 🔌 Usage
843
+
844
+ <dl>
845
+ <dd>
846
+
847
+ <dl>
848
+ <dd>
849
+
850
+ ```typescript
851
+ await client.conversation.addConversationMetadata("string", {
852
+ string: "string",
853
+ });
854
+ ```
855
+
856
+ </dd>
857
+ </dl>
858
+ </dd>
859
+ </dl>
860
+
861
+ #### ⚙️ Parameters
862
+
863
+ <dl>
864
+ <dd>
865
+
866
+ <dl>
867
+ <dd>
868
+
869
+ **conversationId:** `string` — The ID of a conversation the metadata being added belongs to
870
+
871
+ </dd>
872
+ </dl>
873
+
874
+ <dl>
875
+ <dd>
876
+
877
+ **request:** `Record<string, string>`
878
+
879
+ </dd>
880
+ </dl>
881
+
882
+ <dl>
883
+ <dd>
884
+
885
+ **requestOptions:** `Conversation.RequestOptions`
886
+
887
+ </dd>
888
+ </dl>
889
+ </dd>
890
+ </dl>
891
+
892
+ </dd>
893
+ </dl>
894
+ </details>
895
+
896
+ ## Knowledge
897
+
898
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createOrUpdateKnowledgeBase</a>({ ...params }) -> MavenAGI.KnowledgeBaseResponse</code></summary>
899
+ <dl>
900
+ <dd>
901
+
902
+ #### 📝 Description
903
+
904
+ <dl>
905
+ <dd>
906
+
907
+ <dl>
908
+ <dd>
909
+
910
+ Update a knowledge base or create it if it doesn't exist.
911
+
912
+ </dd>
913
+ </dl>
914
+ </dd>
915
+ </dl>
916
+
917
+ #### 🔌 Usage
918
+
919
+ <dl>
920
+ <dd>
921
+
922
+ <dl>
923
+ <dd>
924
+
925
+ ```typescript
926
+ await client.knowledge.createOrUpdateKnowledgeBase({
927
+ knowledgeBaseId: {
928
+ referenceId: "help-center",
929
+ },
930
+ name: "Help center",
931
+ type: MavenAGI.KnowledgeBaseType.Api,
932
+ });
933
+ ```
934
+
935
+ </dd>
936
+ </dl>
937
+ </dd>
938
+ </dl>
939
+
940
+ #### ⚙️ Parameters
941
+
942
+ <dl>
943
+ <dd>
944
+
945
+ <dl>
946
+ <dd>
947
+
948
+ **request:** `MavenAGI.KnowledgeBaseRequest`
949
+
950
+ </dd>
951
+ </dl>
952
+
953
+ <dl>
954
+ <dd>
955
+
956
+ **requestOptions:** `Knowledge.RequestOptions`
957
+
958
+ </dd>
959
+ </dl>
960
+ </dd>
961
+ </dl>
962
+
963
+ </dd>
964
+ </dl>
965
+ </details>
966
+
967
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">getKnowledgeBase</a>(knowledgeBaseReferenceId) -> MavenAGI.KnowledgeBaseResponse</code></summary>
968
+ <dl>
969
+ <dd>
970
+
971
+ #### 📝 Description
972
+
973
+ <dl>
974
+ <dd>
975
+
976
+ <dl>
977
+ <dd>
978
+
979
+ Get an existing knowledge base by its supplied ID
980
+
981
+ </dd>
982
+ </dl>
983
+ </dd>
984
+ </dl>
985
+
986
+ #### 🔌 Usage
987
+
988
+ <dl>
989
+ <dd>
990
+
991
+ <dl>
992
+ <dd>
993
+
994
+ ```typescript
995
+ await client.knowledge.getKnowledgeBase("help-center");
996
+ ```
997
+
998
+ </dd>
999
+ </dl>
1000
+ </dd>
1001
+ </dl>
1002
+
1003
+ #### ⚙️ Parameters
1004
+
1005
+ <dl>
1006
+ <dd>
1007
+
1008
+ <dl>
1009
+ <dd>
1010
+
1011
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to get. All other entity ID fields are inferred from the request.
1012
+
1013
+ </dd>
1014
+ </dl>
1015
+
1016
+ <dl>
1017
+ <dd>
1018
+
1019
+ **requestOptions:** `Knowledge.RequestOptions`
1020
+
1021
+ </dd>
1022
+ </dl>
1023
+ </dd>
1024
+ </dl>
1025
+
1026
+ </dd>
1027
+ </dl>
1028
+ </details>
1029
+
1030
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeBaseVersion</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeBaseVersion</code></summary>
1031
+ <dl>
1032
+ <dd>
1033
+
1034
+ #### 📝 Description
1035
+
1036
+ <dl>
1037
+ <dd>
1038
+
1039
+ <dl>
1040
+ <dd>
1041
+
1042
+ Create a new knowledge base version. Only supported on API knowledge bases. Will throw an exception if there is an existing version in progress.
1043
+
1044
+ </dd>
1045
+ </dl>
1046
+ </dd>
1047
+ </dl>
1048
+
1049
+ #### 🔌 Usage
1050
+
1051
+ <dl>
1052
+ <dd>
1053
+
1054
+ <dl>
1055
+ <dd>
1056
+
1057
+ ```typescript
1058
+ await client.knowledge.createKnowledgeBaseVersion("help-center", {
1059
+ type: MavenAGI.KnowledgeBaseVersionType.Full,
1060
+ });
1061
+ ```
1062
+
1063
+ </dd>
1064
+ </dl>
1065
+ </dd>
1066
+ </dl>
1067
+
1068
+ #### ⚙️ Parameters
1069
+
1070
+ <dl>
1071
+ <dd>
1072
+
1073
+ <dl>
1074
+ <dd>
1075
+
1076
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a version for. All other entity ID fields are inferred from the request.
1077
+
1078
+ </dd>
1079
+ </dl>
1080
+
1081
+ <dl>
1082
+ <dd>
1083
+
1084
+ **request:** `MavenAGI.KnowledgeBaseVersion`
1085
+
1086
+ </dd>
1087
+ </dl>
1088
+
1089
+ <dl>
1090
+ <dd>
1091
+
1092
+ **requestOptions:** `Knowledge.RequestOptions`
1093
+
1094
+ </dd>
1095
+ </dl>
1096
+ </dd>
1097
+ </dl>
1098
+
1099
+ </dd>
1100
+ </dl>
1101
+ </details>
1102
+
1103
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">finalizeKnowledgeBaseVersion</a>(knowledgeBaseReferenceId) -> void</code></summary>
1104
+ <dl>
1105
+ <dd>
1106
+
1107
+ #### 📝 Description
1108
+
1109
+ <dl>
1110
+ <dd>
1111
+
1112
+ <dl>
1113
+ <dd>
1114
+
1115
+ Finalize the latest knowledge base version. Required to indicate the version is complete. Will throw an exception if the latest version is not in progress.
1116
+
1117
+ </dd>
1118
+ </dl>
1119
+ </dd>
1120
+ </dl>
1121
+
1122
+ #### 🔌 Usage
1123
+
1124
+ <dl>
1125
+ <dd>
1126
+
1127
+ <dl>
1128
+ <dd>
1129
+
1130
+ ```typescript
1131
+ await client.knowledge.finalizeKnowledgeBaseVersion("help-center");
1132
+ ```
1133
+
1134
+ </dd>
1135
+ </dl>
1136
+ </dd>
1137
+ </dl>
1138
+
1139
+ #### ⚙️ Parameters
1140
+
1141
+ <dl>
1142
+ <dd>
1143
+
1144
+ <dl>
1145
+ <dd>
1146
+
1147
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to finalize a version for. All other entity ID fields are inferred from the request.
1148
+
1149
+ </dd>
1150
+ </dl>
1151
+
1152
+ <dl>
1153
+ <dd>
1154
+
1155
+ **requestOptions:** `Knowledge.RequestOptions`
1156
+
1157
+ </dd>
1158
+ </dl>
1159
+ </dd>
1160
+ </dl>
1161
+
1162
+ </dd>
1163
+ </dl>
1164
+ </details>
1165
+
1166
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">createKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
1167
+ <dl>
1168
+ <dd>
1169
+
1170
+ #### 📝 Description
1171
+
1172
+ <dl>
1173
+ <dd>
1174
+
1175
+ <dl>
1176
+ <dd>
1177
+
1178
+ Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
1179
+
1180
+ </dd>
1181
+ </dl>
1182
+ </dd>
1183
+ </dl>
1184
+
1185
+ #### 🔌 Usage
1186
+
1187
+ <dl>
1188
+ <dd>
1189
+
1190
+ <dl>
1191
+ <dd>
1192
+
1193
+ ```typescript
1194
+ await client.knowledge.createKnowledgeDocument("help-center", {
1195
+ knowledgeDocumentId: {
1196
+ referenceId: "getting-started",
1197
+ },
1198
+ contentType: MavenAGI.KnowledgeDocumentContentType.Markdown,
1199
+ content: "## Getting started\\nThis is a getting started guide for the help center.",
1200
+ title: "Getting started",
1201
+ });
1202
+ ```
1203
+
1204
+ </dd>
1205
+ </dl>
1206
+ </dd>
1207
+ </dl>
1208
+
1209
+ #### ⚙️ Parameters
1210
+
1211
+ <dl>
1212
+ <dd>
1213
+
1214
+ <dl>
1215
+ <dd>
1216
+
1217
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base to create a document for. All other entity ID fields are inferred from the request.
1218
+
1219
+ </dd>
1220
+ </dl>
1221
+
1222
+ <dl>
1223
+ <dd>
1224
+
1225
+ **request:** `MavenAGI.KnowledgeDocumentRequest`
1226
+
1227
+ </dd>
1228
+ </dl>
1229
+
1230
+ <dl>
1231
+ <dd>
1232
+
1233
+ **requestOptions:** `Knowledge.RequestOptions`
1234
+
1235
+ </dd>
1236
+ </dl>
1237
+ </dd>
1238
+ </dl>
1239
+
1240
+ </dd>
1241
+ </dl>
1242
+ </details>
1243
+
1244
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">updateKnowledgeDocument</a>(knowledgeBaseReferenceId, { ...params }) -> MavenAGI.KnowledgeDocumentResponse</code></summary>
1245
+ <dl>
1246
+ <dd>
1247
+
1248
+ #### 📝 Description
1249
+
1250
+ <dl>
1251
+ <dd>
1252
+
1253
+ <dl>
1254
+ <dd>
1255
+
1256
+ Not yet implemented. Update knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
1257
+
1258
+ </dd>
1259
+ </dl>
1260
+ </dd>
1261
+ </dl>
1262
+
1263
+ #### 🔌 Usage
1264
+
1265
+ <dl>
1266
+ <dd>
1267
+
1268
+ <dl>
1269
+ <dd>
1270
+
1271
+ ```typescript
1272
+ await client.knowledge.updateKnowledgeDocument("help-center", {
1273
+ knowledgeDocumentId: {
1274
+ referenceId: "getting-started",
1275
+ },
1276
+ contentType: MavenAGI.KnowledgeDocumentContentType.Markdown,
1277
+ content: "## Getting started\\nThis is a getting started guide for the help center.",
1278
+ title: "Getting started",
1279
+ });
1280
+ ```
1281
+
1282
+ </dd>
1283
+ </dl>
1284
+ </dd>
1285
+ </dl>
1286
+
1287
+ #### ⚙️ Parameters
1288
+
1289
+ <dl>
1290
+ <dd>
1291
+
1292
+ <dl>
1293
+ <dd>
1294
+
1295
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to update. All other entity ID fields are inferred from the request.
1296
+
1297
+ </dd>
1298
+ </dl>
1299
+
1300
+ <dl>
1301
+ <dd>
1302
+
1303
+ **request:** `MavenAGI.KnowledgeDocumentRequest`
1304
+
1305
+ </dd>
1306
+ </dl>
1307
+
1308
+ <dl>
1309
+ <dd>
1310
+
1311
+ **requestOptions:** `Knowledge.RequestOptions`
1312
+
1313
+ </dd>
1314
+ </dl>
1315
+ </dd>
1316
+ </dl>
1317
+
1318
+ </dd>
1319
+ </dl>
1320
+ </details>
1321
+
1322
+ <details><summary><code>client.knowledge.<a href="/src/api/resources/knowledge/client/Client.ts">deleteKnowledgeDocument</a>(knowledgeBaseReferenceId, knowledgeDocumentReferenceId) -> void</code></summary>
1323
+ <dl>
1324
+ <dd>
1325
+
1326
+ #### 📝 Description
1327
+
1328
+ <dl>
1329
+ <dd>
1330
+
1331
+ <dl>
1332
+ <dd>
1333
+
1334
+ Not yet implemented. Delete knowledge document. Requires an existing knowledge base with an in progress version of type PARTIAL. Will throw an exception if the latest version is not in progress.
1335
+
1336
+ </dd>
1337
+ </dl>
1338
+ </dd>
1339
+ </dl>
1340
+
1341
+ #### 🔌 Usage
1342
+
1343
+ <dl>
1344
+ <dd>
1345
+
1346
+ <dl>
1347
+ <dd>
1348
+
1349
+ ```typescript
1350
+ await client.knowledge.deleteKnowledgeDocument("help-center", "getting-started");
1351
+ ```
1352
+
1353
+ </dd>
1354
+ </dl>
1355
+ </dd>
1356
+ </dl>
1357
+
1358
+ #### ⚙️ Parameters
1359
+
1360
+ <dl>
1361
+ <dd>
1362
+
1363
+ <dl>
1364
+ <dd>
1365
+
1366
+ **knowledgeBaseReferenceId:** `string` — The reference ID of the knowledge base that contains the document to delete. All other entity ID fields are inferred from the request
1367
+
1368
+ </dd>
1369
+ </dl>
1370
+
1371
+ <dl>
1372
+ <dd>
1373
+
1374
+ **knowledgeDocumentReferenceId:** `string` — The reference ID of the knowledge document to delete. All other entity ID fields are inferred from the request.
1375
+
1376
+ </dd>
1377
+ </dl>
1378
+
1379
+ <dl>
1380
+ <dd>
1381
+
1382
+ **requestOptions:** `Knowledge.RequestOptions`
1383
+
1384
+ </dd>
1385
+ </dl>
1386
+ </dd>
1387
+ </dl>
1388
+
1389
+ </dd>
1390
+ </dl>
1391
+ </details>
1392
+
1393
+ ## Triggers
1394
+
1395
+ <details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.EventTriggerResponse</code></summary>
1396
+ <dl>
1397
+ <dd>
1398
+
1399
+ #### 📝 Description
1400
+
1401
+ <dl>
1402
+ <dd>
1403
+
1404
+ <dl>
1405
+ <dd>
1406
+
1407
+ Update an event trigger or create it if it doesn't exist.
1408
+
1409
+ </dd>
1410
+ </dl>
1411
+ </dd>
1412
+ </dl>
1413
+
1414
+ #### 🔌 Usage
1415
+
1416
+ <dl>
1417
+ <dd>
1418
+
1419
+ <dl>
1420
+ <dd>
1421
+
1422
+ ```typescript
1423
+ await client.triggers.createOrUpdate({
1424
+ triggerId: {
1425
+ referenceId: "store-in-snowflake",
1426
+ },
1427
+ description: "Stores conversation data in Snowflake",
1428
+ type: MavenAGI.EventTriggerType.ConversationCreated,
1429
+ });
1430
+ ```
1431
+
1432
+ </dd>
1433
+ </dl>
1434
+ </dd>
1435
+ </dl>
1436
+
1437
+ #### ⚙️ Parameters
1438
+
1439
+ <dl>
1440
+ <dd>
1441
+
1442
+ <dl>
1443
+ <dd>
1444
+
1445
+ **request:** `MavenAGI.EventTriggerRequest`
1446
+
1447
+ </dd>
1448
+ </dl>
1449
+
1450
+ <dl>
1451
+ <dd>
1452
+
1453
+ **requestOptions:** `Triggers.RequestOptions`
1454
+
1455
+ </dd>
1456
+ </dl>
1457
+ </dd>
1458
+ </dl>
1459
+
1460
+ </dd>
1461
+ </dl>
1462
+ </details>
1463
+
1464
+ <details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">get</a>(triggerReferenceId) -> MavenAGI.EventTriggerResponse</code></summary>
1465
+ <dl>
1466
+ <dd>
1467
+
1468
+ #### 📝 Description
1469
+
1470
+ <dl>
1471
+ <dd>
1472
+
1473
+ <dl>
1474
+ <dd>
1475
+
1476
+ Get an event trigger by its supplied ID
1477
+
1478
+ </dd>
1479
+ </dl>
1480
+ </dd>
1481
+ </dl>
1482
+
1483
+ #### 🔌 Usage
1484
+
1485
+ <dl>
1486
+ <dd>
1487
+
1488
+ <dl>
1489
+ <dd>
1490
+
1491
+ ```typescript
1492
+ await client.triggers.get("store-in-snowflake");
1493
+ ```
1494
+
1495
+ </dd>
1496
+ </dl>
1497
+ </dd>
1498
+ </dl>
1499
+
1500
+ #### ⚙️ Parameters
1501
+
1502
+ <dl>
1503
+ <dd>
1504
+
1505
+ <dl>
1506
+ <dd>
1507
+
1508
+ **triggerReferenceId:** `string` — The reference ID of the event trigger to get. All other entity ID fields are inferred from the request.
1509
+
1510
+ </dd>
1511
+ </dl>
1512
+
1513
+ <dl>
1514
+ <dd>
1515
+
1516
+ **requestOptions:** `Triggers.RequestOptions`
1517
+
1518
+ </dd>
1519
+ </dl>
1520
+ </dd>
1521
+ </dl>
1522
+
1523
+ </dd>
1524
+ </dl>
1525
+ </details>
1526
+
1527
+ <details><summary><code>client.triggers.<a href="/src/api/resources/triggers/client/Client.ts">delete</a>(triggerReferenceId) -> void</code></summary>
1528
+ <dl>
1529
+ <dd>
1530
+
1531
+ #### 📝 Description
1532
+
1533
+ <dl>
1534
+ <dd>
1535
+
1536
+ <dl>
1537
+ <dd>
1538
+
1539
+ Delete an event trigger
1540
+
1541
+ </dd>
1542
+ </dl>
1543
+ </dd>
1544
+ </dl>
1545
+
1546
+ #### 🔌 Usage
1547
+
1548
+ <dl>
1549
+ <dd>
1550
+
1551
+ <dl>
1552
+ <dd>
1553
+
1554
+ ```typescript
1555
+ await client.triggers.delete("store-in-snowflake");
1556
+ ```
1557
+
1558
+ </dd>
1559
+ </dl>
1560
+ </dd>
1561
+ </dl>
1562
+
1563
+ #### ⚙️ Parameters
1564
+
1565
+ <dl>
1566
+ <dd>
1567
+
1568
+ <dl>
1569
+ <dd>
1570
+
1571
+ **triggerReferenceId:** `string` — The reference ID of the event trigger to delete. All other entity ID fields are inferred from the request.
1572
+
1573
+ </dd>
1574
+ </dl>
1575
+
1576
+ <dl>
1577
+ <dd>
1578
+
1579
+ **requestOptions:** `Triggers.RequestOptions`
1580
+
1581
+ </dd>
1582
+ </dl>
1583
+ </dd>
1584
+ </dl>
1585
+
1586
+ </dd>
1587
+ </dl>
1588
+ </details>
1589
+
1590
+ ## Users
1591
+
1592
+ <details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">createOrUpdate</a>({ ...params }) -> MavenAGI.AppUserResponse</code></summary>
1593
+ <dl>
1594
+ <dd>
1595
+
1596
+ #### 📝 Description
1597
+
1598
+ <dl>
1599
+ <dd>
1600
+
1601
+ <dl>
1602
+ <dd>
1603
+
1604
+ Update a user or create it if it doesn't exist.
1605
+
1606
+ </dd>
1607
+ </dl>
1608
+ </dd>
1609
+ </dl>
1610
+
1611
+ #### 🔌 Usage
1612
+
1613
+ <dl>
1614
+ <dd>
1615
+
1616
+ <dl>
1617
+ <dd>
1618
+
1619
+ ```typescript
1620
+ await client.users.createOrUpdate({
1621
+ userId: {
1622
+ referenceId: "user-0",
1623
+ },
1624
+ identifiers: new Set([
1625
+ {
1626
+ value: "joe@myapp.com",
1627
+ type: MavenAGI.AppUserIdentifyingPropertyType.Email,
1628
+ },
1629
+ ]),
1630
+ data: {
1631
+ name: {
1632
+ value: "Joe",
1633
+ visibility: MavenAGI.VisibilityType.Visible,
1634
+ },
1635
+ },
1636
+ });
1637
+ ```
1638
+
1639
+ </dd>
1640
+ </dl>
1641
+ </dd>
1642
+ </dl>
1643
+
1644
+ #### ⚙️ Parameters
1645
+
1646
+ <dl>
1647
+ <dd>
1648
+
1649
+ <dl>
1650
+ <dd>
1651
+
1652
+ **request:** `MavenAGI.AppUserRequest`
1653
+
1654
+ </dd>
1655
+ </dl>
1656
+
1657
+ <dl>
1658
+ <dd>
1659
+
1660
+ **requestOptions:** `Users.RequestOptions`
1661
+
1662
+ </dd>
1663
+ </dl>
1664
+ </dd>
1665
+ </dl>
1666
+
1667
+ </dd>
1668
+ </dl>
1669
+ </details>
1670
+
1671
+ <details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">get</a>(userId) -> MavenAGI.AppUserResponse</code></summary>
1672
+ <dl>
1673
+ <dd>
1674
+
1675
+ #### 📝 Description
1676
+
1677
+ <dl>
1678
+ <dd>
1679
+
1680
+ <dl>
1681
+ <dd>
1682
+
1683
+ Get a user by its supplied ID
1684
+
1685
+ </dd>
1686
+ </dl>
1687
+ </dd>
1688
+ </dl>
1689
+
1690
+ #### 🔌 Usage
1691
+
1692
+ <dl>
1693
+ <dd>
1694
+
1695
+ <dl>
1696
+ <dd>
1697
+
1698
+ ```typescript
1699
+ await client.users.get("user-0");
1700
+ ```
1701
+
1702
+ </dd>
1703
+ </dl>
1704
+ </dd>
1705
+ </dl>
1706
+
1707
+ #### ⚙️ Parameters
1708
+
1709
+ <dl>
1710
+ <dd>
1711
+
1712
+ <dl>
1713
+ <dd>
1714
+
1715
+ **userId:** `string` — The reference ID of the user to get. All other entity ID fields are inferred from the request.
1716
+
1717
+ </dd>
1718
+ </dl>
1719
+
1720
+ <dl>
1721
+ <dd>
1722
+
1723
+ **requestOptions:** `Users.RequestOptions`
1724
+
1725
+ </dd>
1726
+ </dl>
1727
+ </dd>
1728
+ </dl>
1729
+
1730
+ </dd>
1731
+ </dl>
1732
+ </details>