@orq-ai/node 3.14.8 → 4.0.0-rc.1

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 (494) hide show
  1. package/bin/mcp-server.js +210 -213
  2. package/bin/mcp-server.js.map +38 -38
  3. package/docs/sdks/agents/README.md +8 -4
  4. package/docs/sdks/budgets/README.md +4 -2
  5. package/docs/sdks/tools/README.md +4 -2
  6. package/examples/package-lock.json +5 -6
  7. package/jsr.json +1 -1
  8. package/lib/config.d.ts +2 -2
  9. package/lib/config.js +2 -2
  10. package/lib/config.js.map +1 -1
  11. package/mcp-server/mcp-server.js +1 -1
  12. package/mcp-server/mcp-server.js.map +1 -1
  13. package/mcp-server/server.js +1 -1
  14. package/mcp-server/server.js.map +1 -1
  15. package/models/operations/createbudget.js +2 -2
  16. package/models/operations/createcontact.js +2 -2
  17. package/models/operations/createdataset.js +2 -2
  18. package/models/operations/createdatasetitem.js +8 -8
  19. package/models/operations/createdatasource.js +2 -2
  20. package/models/operations/createeval.js +28 -28
  21. package/models/operations/createtool.js +10 -10
  22. package/models/operations/duplicatetool.js +10 -10
  23. package/models/operations/fileget.js +2 -2
  24. package/models/operations/filelist.js +2 -2
  25. package/models/operations/fileupload.js +2 -2
  26. package/models/operations/getalltools.js +10 -10
  27. package/models/operations/getbudget.js +2 -2
  28. package/models/operations/getevals.js +28 -28
  29. package/models/operations/listbudgets.js +2 -2
  30. package/models/operations/listcontacts.js +2 -2
  31. package/models/operations/listdatasetdatapoints.js +8 -8
  32. package/models/operations/listdatasets.js +2 -2
  33. package/models/operations/listdatasources.js +2 -2
  34. package/models/operations/retrievecontact.js +2 -2
  35. package/models/operations/retrievedatapoint.js +8 -8
  36. package/models/operations/retrievedataset.js +2 -2
  37. package/models/operations/retrievedatasource.js +2 -2
  38. package/models/operations/retrievetool.js +10 -10
  39. package/models/operations/updatebudget.js +2 -2
  40. package/models/operations/updatecontact.js +2 -2
  41. package/models/operations/updatedatapoint.js +8 -8
  42. package/models/operations/updatedataset.js +2 -2
  43. package/models/operations/updatedatasource.js +2 -2
  44. package/models/operations/updateeval.js +28 -28
  45. package/models/operations/updatetool.js +10 -10
  46. package/package.json +4 -4
  47. package/src/lib/config.ts +2 -2
  48. package/src/mcp-server/mcp-server.ts +1 -1
  49. package/src/mcp-server/server.ts +1 -1
  50. package/src/models/operations/createbudget.ts +2 -2
  51. package/src/models/operations/createcontact.ts +2 -2
  52. package/src/models/operations/createdataset.ts +2 -2
  53. package/src/models/operations/createdatasetitem.ts +8 -8
  54. package/src/models/operations/createdatasource.ts +2 -2
  55. package/src/models/operations/createeval.ts +28 -28
  56. package/src/models/operations/createtool.ts +10 -10
  57. package/src/models/operations/duplicatetool.ts +10 -10
  58. package/src/models/operations/fileget.ts +2 -2
  59. package/src/models/operations/filelist.ts +2 -2
  60. package/src/models/operations/fileupload.ts +2 -2
  61. package/src/models/operations/getalltools.ts +10 -10
  62. package/src/models/operations/getbudget.ts +2 -2
  63. package/src/models/operations/getevals.ts +28 -28
  64. package/src/models/operations/listbudgets.ts +2 -2
  65. package/src/models/operations/listcontacts.ts +2 -2
  66. package/src/models/operations/listdatasetdatapoints.ts +8 -8
  67. package/src/models/operations/listdatasets.ts +2 -2
  68. package/src/models/operations/listdatasources.ts +2 -2
  69. package/src/models/operations/retrievecontact.ts +2 -2
  70. package/src/models/operations/retrievedatapoint.ts +8 -8
  71. package/src/models/operations/retrievedataset.ts +2 -2
  72. package/src/models/operations/retrievedatasource.ts +2 -2
  73. package/src/models/operations/retrievetool.ts +10 -10
  74. package/src/models/operations/updatebudget.ts +2 -2
  75. package/src/models/operations/updatecontact.ts +2 -2
  76. package/src/models/operations/updatedatapoint.ts +8 -8
  77. package/src/models/operations/updatedataset.ts +2 -2
  78. package/src/models/operations/updatedatasource.ts +2 -2
  79. package/src/models/operations/updateeval.ts +28 -28
  80. package/src/models/operations/updatetool.ts +10 -10
  81. package/packages/orq-rc/FUNCTIONS.md +0 -103
  82. package/packages/orq-rc/README.md +0 -909
  83. package/packages/orq-rc/RUNTIMES.md +0 -48
  84. package/packages/orq-rc/docs/sdks/agents/README.md +0 -1319
  85. package/packages/orq-rc/docs/sdks/budgets/README.md +0 -401
  86. package/packages/orq-rc/docs/sdks/chunking/README.md +0 -95
  87. package/packages/orq-rc/docs/sdks/contacts/README.md +0 -450
  88. package/packages/orq-rc/docs/sdks/datasets/README.md +0 -836
  89. package/packages/orq-rc/docs/sdks/deployments/README.md +0 -312
  90. package/packages/orq-rc/docs/sdks/evals/README.md +0 -339
  91. package/packages/orq-rc/docs/sdks/feedback/README.md +0 -89
  92. package/packages/orq-rc/docs/sdks/files/README.md +0 -301
  93. package/packages/orq-rc/docs/sdks/knowledge/README.md +0 -1489
  94. package/packages/orq-rc/docs/sdks/memorystores/README.md +0 -1172
  95. package/packages/orq-rc/docs/sdks/metrics/README.md +0 -83
  96. package/packages/orq-rc/docs/sdks/models/README.md +0 -76
  97. package/packages/orq-rc/docs/sdks/prompts/README.md +0 -591
  98. package/packages/orq-rc/docs/sdks/remoteconfigs/README.md +0 -77
  99. package/packages/orq-rc/docs/sdks/tools/README.md +0 -490
  100. package/packages/orq-rc/examples/README.md +0 -31
  101. package/packages/orq-rc/examples/contactsCreate.example.ts +0 -42
  102. package/packages/orq-rc/examples/package-lock.json +0 -627
  103. package/packages/orq-rc/examples/package.json +0 -18
  104. package/packages/orq-rc/jsr.json +0 -28
  105. package/packages/orq-rc/package-lock.json +0 -3071
  106. package/packages/orq-rc/package.json +0 -43
  107. package/packages/orq-rc/src/core.ts +0 -13
  108. package/packages/orq-rc/src/funcs/agentsCreate.ts +0 -172
  109. package/packages/orq-rc/src/funcs/agentsDelete.ts +0 -176
  110. package/packages/orq-rc/src/funcs/agentsInvoke.ts +0 -167
  111. package/packages/orq-rc/src/funcs/agentsList.ts +0 -167
  112. package/packages/orq-rc/src/funcs/agentsListActions.ts +0 -169
  113. package/packages/orq-rc/src/funcs/agentsListTasks.ts +0 -183
  114. package/packages/orq-rc/src/funcs/agentsRetrieve.ts +0 -175
  115. package/packages/orq-rc/src/funcs/agentsRetrieveAction.ts +0 -173
  116. package/packages/orq-rc/src/funcs/agentsRetrieveTask.ts +0 -179
  117. package/packages/orq-rc/src/funcs/agentsRun.ts +0 -163
  118. package/packages/orq-rc/src/funcs/agentsStream.ts +0 -190
  119. package/packages/orq-rc/src/funcs/agentsStreamRun.ts +0 -188
  120. package/packages/orq-rc/src/funcs/agentsUpdate.ts +0 -176
  121. package/packages/orq-rc/src/funcs/budgetsCreate.ts +0 -160
  122. package/packages/orq-rc/src/funcs/budgetsDelete.ts +0 -167
  123. package/packages/orq-rc/src/funcs/budgetsGet.ts +0 -166
  124. package/packages/orq-rc/src/funcs/budgetsList.ts +0 -170
  125. package/packages/orq-rc/src/funcs/budgetsUpdate.ts +0 -167
  126. package/packages/orq-rc/src/funcs/chunkingParse.ts +0 -160
  127. package/packages/orq-rc/src/funcs/contactsCreate.ts +0 -165
  128. package/packages/orq-rc/src/funcs/contactsDelete.ts +0 -176
  129. package/packages/orq-rc/src/funcs/contactsList.ts +0 -169
  130. package/packages/orq-rc/src/funcs/contactsRetrieve.ts +0 -175
  131. package/packages/orq-rc/src/funcs/contactsUpdate.ts +0 -176
  132. package/packages/orq-rc/src/funcs/datasetsClear.ts +0 -167
  133. package/packages/orq-rc/src/funcs/datasetsCreate.ts +0 -165
  134. package/packages/orq-rc/src/funcs/datasetsCreateDatapoint.ts +0 -171
  135. package/packages/orq-rc/src/funcs/datasetsDelete.ts +0 -167
  136. package/packages/orq-rc/src/funcs/datasetsDeleteDatapoint.ts +0 -182
  137. package/packages/orq-rc/src/funcs/datasetsList.ts +0 -167
  138. package/packages/orq-rc/src/funcs/datasetsListDatapoints.ts +0 -174
  139. package/packages/orq-rc/src/funcs/datasetsRetrieve.ts +0 -175
  140. package/packages/orq-rc/src/funcs/datasetsRetrieveDatapoint.ts +0 -181
  141. package/packages/orq-rc/src/funcs/datasetsUpdate.ts +0 -176
  142. package/packages/orq-rc/src/funcs/datasetsUpdateDatapoint.ts +0 -179
  143. package/packages/orq-rc/src/funcs/deploymentsGetConfig.ts +0 -168
  144. package/packages/orq-rc/src/funcs/deploymentsInvoke.ts +0 -176
  145. package/packages/orq-rc/src/funcs/deploymentsList.ts +0 -176
  146. package/packages/orq-rc/src/funcs/deploymentsMetricsCreate.ts +0 -168
  147. package/packages/orq-rc/src/funcs/deploymentsStream.ts +0 -183
  148. package/packages/orq-rc/src/funcs/evalsAll.ts +0 -173
  149. package/packages/orq-rc/src/funcs/evalsCreate.ts +0 -169
  150. package/packages/orq-rc/src/funcs/evalsDelete.ts +0 -173
  151. package/packages/orq-rc/src/funcs/evalsUpdate.ts +0 -173
  152. package/packages/orq-rc/src/funcs/feedbackCreate.ts +0 -160
  153. package/packages/orq-rc/src/funcs/filesCreate.ts +0 -187
  154. package/packages/orq-rc/src/funcs/filesDelete.ts +0 -164
  155. package/packages/orq-rc/src/funcs/filesGet.ts +0 -166
  156. package/packages/orq-rc/src/funcs/filesList.ts +0 -167
  157. package/packages/orq-rc/src/funcs/knowledgeCreate.ts +0 -158
  158. package/packages/orq-rc/src/funcs/knowledgeCreateChunks.ts +0 -171
  159. package/packages/orq-rc/src/funcs/knowledgeCreateDatasource.ts +0 -166
  160. package/packages/orq-rc/src/funcs/knowledgeDelete.ts +0 -167
  161. package/packages/orq-rc/src/funcs/knowledgeDeleteChunk.ts +0 -174
  162. package/packages/orq-rc/src/funcs/knowledgeDeleteChunks.ts +0 -170
  163. package/packages/orq-rc/src/funcs/knowledgeDeleteDatasource.ts +0 -173
  164. package/packages/orq-rc/src/funcs/knowledgeGetChunksCount.ts +0 -170
  165. package/packages/orq-rc/src/funcs/knowledgeList.ts +0 -169
  166. package/packages/orq-rc/src/funcs/knowledgeListChunks.ts +0 -178
  167. package/packages/orq-rc/src/funcs/knowledgeListChunksPaginated.ts +0 -171
  168. package/packages/orq-rc/src/funcs/knowledgeListDatasources.ts +0 -174
  169. package/packages/orq-rc/src/funcs/knowledgeRetrieve.ts +0 -166
  170. package/packages/orq-rc/src/funcs/knowledgeRetrieveChunk.ts +0 -173
  171. package/packages/orq-rc/src/funcs/knowledgeRetrieveDatasource.ts +0 -169
  172. package/packages/orq-rc/src/funcs/knowledgeSearch.ts +0 -167
  173. package/packages/orq-rc/src/funcs/knowledgeUpdate.ts +0 -164
  174. package/packages/orq-rc/src/funcs/knowledgeUpdateChunk.ts +0 -174
  175. package/packages/orq-rc/src/funcs/knowledgeUpdateDatasource.ts +0 -170
  176. package/packages/orq-rc/src/funcs/memoryStoresCreate.ts +0 -171
  177. package/packages/orq-rc/src/funcs/memoryStoresCreateDocument.ts +0 -175
  178. package/packages/orq-rc/src/funcs/memoryStoresCreateMemory.ts +0 -170
  179. package/packages/orq-rc/src/funcs/memoryStoresDelete.ts +0 -168
  180. package/packages/orq-rc/src/funcs/memoryStoresDeleteDocument.ts +0 -184
  181. package/packages/orq-rc/src/funcs/memoryStoresDeleteMemory.ts +0 -179
  182. package/packages/orq-rc/src/funcs/memoryStoresList.ts +0 -178
  183. package/packages/orq-rc/src/funcs/memoryStoresListDocuments.ts +0 -181
  184. package/packages/orq-rc/src/funcs/memoryStoresListMemories.ts +0 -176
  185. package/packages/orq-rc/src/funcs/memoryStoresRetrieve.ts +0 -177
  186. package/packages/orq-rc/src/funcs/memoryStoresRetrieveDocument.ts +0 -178
  187. package/packages/orq-rc/src/funcs/memoryStoresRetrieveMemory.ts +0 -173
  188. package/packages/orq-rc/src/funcs/memoryStoresUpdate.ts +0 -168
  189. package/packages/orq-rc/src/funcs/memoryStoresUpdateDocument.ts +0 -179
  190. package/packages/orq-rc/src/funcs/memoryStoresUpdateMemory.ts +0 -174
  191. package/packages/orq-rc/src/funcs/modelsList.ts +0 -142
  192. package/packages/orq-rc/src/funcs/promptsCreate.ts +0 -160
  193. package/packages/orq-rc/src/funcs/promptsDelete.ts +0 -164
  194. package/packages/orq-rc/src/funcs/promptsGetVersion.ts +0 -181
  195. package/packages/orq-rc/src/funcs/promptsList.ts +0 -167
  196. package/packages/orq-rc/src/funcs/promptsListVersions.ts +0 -173
  197. package/packages/orq-rc/src/funcs/promptsRetrieve.ts +0 -166
  198. package/packages/orq-rc/src/funcs/promptsUpdate.ts +0 -173
  199. package/packages/orq-rc/src/funcs/remoteconfigsRetrieve.ts +0 -161
  200. package/packages/orq-rc/src/funcs/toolsCreate.ts +0 -163
  201. package/packages/orq-rc/src/funcs/toolsDelete.ts +0 -167
  202. package/packages/orq-rc/src/funcs/toolsDuplicate.ts +0 -175
  203. package/packages/orq-rc/src/funcs/toolsList.ts +0 -176
  204. package/packages/orq-rc/src/funcs/toolsRetrieve.ts +0 -166
  205. package/packages/orq-rc/src/funcs/toolsUpdate.ts +0 -176
  206. package/packages/orq-rc/src/hooks/global.ts +0 -44
  207. package/packages/orq-rc/src/hooks/hooks.ts +0 -132
  208. package/packages/orq-rc/src/hooks/index.ts +0 -6
  209. package/packages/orq-rc/src/hooks/registration.ts +0 -15
  210. package/packages/orq-rc/src/hooks/types.ts +0 -112
  211. package/packages/orq-rc/src/index.ts +0 -9
  212. package/packages/orq-rc/src/lib/base64.ts +0 -37
  213. package/packages/orq-rc/src/lib/config.ts +0 -74
  214. package/packages/orq-rc/src/lib/dlv.ts +0 -53
  215. package/packages/orq-rc/src/lib/encodings.ts +0 -483
  216. package/packages/orq-rc/src/lib/env.ts +0 -89
  217. package/packages/orq-rc/src/lib/event-streams.ts +0 -135
  218. package/packages/orq-rc/src/lib/files.ts +0 -82
  219. package/packages/orq-rc/src/lib/http.ts +0 -323
  220. package/packages/orq-rc/src/lib/is-plain-object.ts +0 -43
  221. package/packages/orq-rc/src/lib/logger.ts +0 -9
  222. package/packages/orq-rc/src/lib/matchers.ts +0 -345
  223. package/packages/orq-rc/src/lib/primitives.ts +0 -150
  224. package/packages/orq-rc/src/lib/retries.ts +0 -218
  225. package/packages/orq-rc/src/lib/schemas.ts +0 -91
  226. package/packages/orq-rc/src/lib/sdks.ts +0 -407
  227. package/packages/orq-rc/src/lib/security.ts +0 -264
  228. package/packages/orq-rc/src/lib/url.ts +0 -33
  229. package/packages/orq-rc/src/mcp-server/cli/start/command.ts +0 -111
  230. package/packages/orq-rc/src/mcp-server/cli/start/impl.ts +0 -136
  231. package/packages/orq-rc/src/mcp-server/cli.ts +0 -13
  232. package/packages/orq-rc/src/mcp-server/console-logger.ts +0 -71
  233. package/packages/orq-rc/src/mcp-server/extensions.ts +0 -17
  234. package/packages/orq-rc/src/mcp-server/mcp-server.ts +0 -26
  235. package/packages/orq-rc/src/mcp-server/prompts.ts +0 -117
  236. package/packages/orq-rc/src/mcp-server/resources.ts +0 -172
  237. package/packages/orq-rc/src/mcp-server/scopes.ts +0 -7
  238. package/packages/orq-rc/src/mcp-server/server.ts +0 -259
  239. package/packages/orq-rc/src/mcp-server/shared.ts +0 -74
  240. package/packages/orq-rc/src/mcp-server/tools/agentsCreate.ts +0 -37
  241. package/packages/orq-rc/src/mcp-server/tools/agentsDelete.ts +0 -35
  242. package/packages/orq-rc/src/mcp-server/tools/agentsInvoke.ts +0 -37
  243. package/packages/orq-rc/src/mcp-server/tools/agentsList.ts +0 -37
  244. package/packages/orq-rc/src/mcp-server/tools/agentsListActions.ts +0 -35
  245. package/packages/orq-rc/src/mcp-server/tools/agentsListTasks.ts +0 -37
  246. package/packages/orq-rc/src/mcp-server/tools/agentsRetrieve.ts +0 -37
  247. package/packages/orq-rc/src/mcp-server/tools/agentsRetrieveAction.ts +0 -35
  248. package/packages/orq-rc/src/mcp-server/tools/agentsRetrieveTask.ts +0 -37
  249. package/packages/orq-rc/src/mcp-server/tools/agentsRun.ts +0 -37
  250. package/packages/orq-rc/src/mcp-server/tools/agentsStream.ts +0 -37
  251. package/packages/orq-rc/src/mcp-server/tools/agentsStreamRun.ts +0 -37
  252. package/packages/orq-rc/src/mcp-server/tools/agentsUpdate.ts +0 -37
  253. package/packages/orq-rc/src/mcp-server/tools/budgetsCreate.ts +0 -37
  254. package/packages/orq-rc/src/mcp-server/tools/budgetsDelete.ts +0 -35
  255. package/packages/orq-rc/src/mcp-server/tools/budgetsGet.ts +0 -37
  256. package/packages/orq-rc/src/mcp-server/tools/budgetsList.ts +0 -37
  257. package/packages/orq-rc/src/mcp-server/tools/budgetsUpdate.ts +0 -37
  258. package/packages/orq-rc/src/mcp-server/tools/chunkingParse.ts +0 -37
  259. package/packages/orq-rc/src/mcp-server/tools/contactsCreate.ts +0 -37
  260. package/packages/orq-rc/src/mcp-server/tools/contactsDelete.ts +0 -35
  261. package/packages/orq-rc/src/mcp-server/tools/contactsList.ts +0 -37
  262. package/packages/orq-rc/src/mcp-server/tools/contactsRetrieve.ts +0 -37
  263. package/packages/orq-rc/src/mcp-server/tools/contactsUpdate.ts +0 -37
  264. package/packages/orq-rc/src/mcp-server/tools/datasetsClear.ts +0 -35
  265. package/packages/orq-rc/src/mcp-server/tools/datasetsCreate.ts +0 -37
  266. package/packages/orq-rc/src/mcp-server/tools/datasetsCreateDatapoint.ts +0 -37
  267. package/packages/orq-rc/src/mcp-server/tools/datasetsDelete.ts +0 -35
  268. package/packages/orq-rc/src/mcp-server/tools/datasetsDeleteDatapoint.ts +0 -35
  269. package/packages/orq-rc/src/mcp-server/tools/datasetsList.ts +0 -37
  270. package/packages/orq-rc/src/mcp-server/tools/datasetsListDatapoints.ts +0 -37
  271. package/packages/orq-rc/src/mcp-server/tools/datasetsRetrieve.ts +0 -37
  272. package/packages/orq-rc/src/mcp-server/tools/datasetsRetrieveDatapoint.ts +0 -37
  273. package/packages/orq-rc/src/mcp-server/tools/datasetsUpdate.ts +0 -37
  274. package/packages/orq-rc/src/mcp-server/tools/datasetsUpdateDatapoint.ts +0 -35
  275. package/packages/orq-rc/src/mcp-server/tools/deploymentsGetConfig.ts +0 -37
  276. package/packages/orq-rc/src/mcp-server/tools/deploymentsInvoke.ts +0 -37
  277. package/packages/orq-rc/src/mcp-server/tools/deploymentsList.ts +0 -37
  278. package/packages/orq-rc/src/mcp-server/tools/deploymentsMetricsCreate.ts +0 -37
  279. package/packages/orq-rc/src/mcp-server/tools/deploymentsStream.ts +0 -37
  280. package/packages/orq-rc/src/mcp-server/tools/evalsAll.ts +0 -35
  281. package/packages/orq-rc/src/mcp-server/tools/evalsCreate.ts +0 -35
  282. package/packages/orq-rc/src/mcp-server/tools/evalsDelete.ts +0 -33
  283. package/packages/orq-rc/src/mcp-server/tools/evalsUpdate.ts +0 -35
  284. package/packages/orq-rc/src/mcp-server/tools/feedbackCreate.ts +0 -37
  285. package/packages/orq-rc/src/mcp-server/tools/filesCreate.ts +0 -37
  286. package/packages/orq-rc/src/mcp-server/tools/filesDelete.ts +0 -33
  287. package/packages/orq-rc/src/mcp-server/tools/filesGet.ts +0 -37
  288. package/packages/orq-rc/src/mcp-server/tools/filesList.ts +0 -37
  289. package/packages/orq-rc/src/mcp-server/tools/knowledgeCreate.ts +0 -35
  290. package/packages/orq-rc/src/mcp-server/tools/knowledgeCreateChunks.ts +0 -35
  291. package/packages/orq-rc/src/mcp-server/tools/knowledgeCreateDatasource.ts +0 -35
  292. package/packages/orq-rc/src/mcp-server/tools/knowledgeDelete.ts +0 -35
  293. package/packages/orq-rc/src/mcp-server/tools/knowledgeDeleteChunk.ts +0 -33
  294. package/packages/orq-rc/src/mcp-server/tools/knowledgeDeleteChunks.ts +0 -35
  295. package/packages/orq-rc/src/mcp-server/tools/knowledgeDeleteDatasource.ts +0 -35
  296. package/packages/orq-rc/src/mcp-server/tools/knowledgeGetChunksCount.ts +0 -35
  297. package/packages/orq-rc/src/mcp-server/tools/knowledgeList.ts +0 -37
  298. package/packages/orq-rc/src/mcp-server/tools/knowledgeListChunks.ts +0 -35
  299. package/packages/orq-rc/src/mcp-server/tools/knowledgeListChunksPaginated.ts +0 -35
  300. package/packages/orq-rc/src/mcp-server/tools/knowledgeListDatasources.ts +0 -35
  301. package/packages/orq-rc/src/mcp-server/tools/knowledgeRetrieve.ts +0 -37
  302. package/packages/orq-rc/src/mcp-server/tools/knowledgeRetrieveChunk.ts +0 -35
  303. package/packages/orq-rc/src/mcp-server/tools/knowledgeRetrieveDatasource.ts +0 -35
  304. package/packages/orq-rc/src/mcp-server/tools/knowledgeSearch.ts +0 -37
  305. package/packages/orq-rc/src/mcp-server/tools/knowledgeUpdate.ts +0 -35
  306. package/packages/orq-rc/src/mcp-server/tools/knowledgeUpdateChunk.ts +0 -35
  307. package/packages/orq-rc/src/mcp-server/tools/knowledgeUpdateDatasource.ts +0 -35
  308. package/packages/orq-rc/src/mcp-server/tools/memoryStoresCreate.ts +0 -35
  309. package/packages/orq-rc/src/mcp-server/tools/memoryStoresCreateDocument.ts +0 -37
  310. package/packages/orq-rc/src/mcp-server/tools/memoryStoresCreateMemory.ts +0 -37
  311. package/packages/orq-rc/src/mcp-server/tools/memoryStoresDelete.ts +0 -35
  312. package/packages/orq-rc/src/mcp-server/tools/memoryStoresDeleteDocument.ts +0 -40
  313. package/packages/orq-rc/src/mcp-server/tools/memoryStoresDeleteMemory.ts +0 -40
  314. package/packages/orq-rc/src/mcp-server/tools/memoryStoresList.ts +0 -37
  315. package/packages/orq-rc/src/mcp-server/tools/memoryStoresListDocuments.ts +0 -37
  316. package/packages/orq-rc/src/mcp-server/tools/memoryStoresListMemories.ts +0 -37
  317. package/packages/orq-rc/src/mcp-server/tools/memoryStoresRetrieve.ts +0 -37
  318. package/packages/orq-rc/src/mcp-server/tools/memoryStoresRetrieveDocument.ts +0 -37
  319. package/packages/orq-rc/src/mcp-server/tools/memoryStoresRetrieveMemory.ts +0 -37
  320. package/packages/orq-rc/src/mcp-server/tools/memoryStoresUpdate.ts +0 -37
  321. package/packages/orq-rc/src/mcp-server/tools/memoryStoresUpdateDocument.ts +0 -37
  322. package/packages/orq-rc/src/mcp-server/tools/memoryStoresUpdateMemory.ts +0 -37
  323. package/packages/orq-rc/src/mcp-server/tools/modelsList.ts +0 -30
  324. package/packages/orq-rc/src/mcp-server/tools/promptsCreate.ts +0 -35
  325. package/packages/orq-rc/src/mcp-server/tools/promptsDelete.ts +0 -33
  326. package/packages/orq-rc/src/mcp-server/tools/promptsGetVersion.ts +0 -37
  327. package/packages/orq-rc/src/mcp-server/tools/promptsList.ts +0 -37
  328. package/packages/orq-rc/src/mcp-server/tools/promptsListVersions.ts +0 -37
  329. package/packages/orq-rc/src/mcp-server/tools/promptsRetrieve.ts +0 -37
  330. package/packages/orq-rc/src/mcp-server/tools/promptsUpdate.ts +0 -35
  331. package/packages/orq-rc/src/mcp-server/tools/remoteconfigsRetrieve.ts +0 -36
  332. package/packages/orq-rc/src/mcp-server/tools/toolsCreate.ts +0 -37
  333. package/packages/orq-rc/src/mcp-server/tools/toolsDelete.ts +0 -35
  334. package/packages/orq-rc/src/mcp-server/tools/toolsDuplicate.ts +0 -37
  335. package/packages/orq-rc/src/mcp-server/tools/toolsList.ts +0 -37
  336. package/packages/orq-rc/src/mcp-server/tools/toolsRetrieve.ts +0 -37
  337. package/packages/orq-rc/src/mcp-server/tools/toolsUpdate.ts +0 -37
  338. package/packages/orq-rc/src/mcp-server/tools.ts +0 -129
  339. package/packages/orq-rc/src/models/components/deployments.ts +0 -8147
  340. package/packages/orq-rc/src/models/components/index.ts +0 -6
  341. package/packages/orq-rc/src/models/components/security.ts +0 -71
  342. package/packages/orq-rc/src/models/errors/apierror.ts +0 -40
  343. package/packages/orq-rc/src/models/errors/createagent.ts +0 -80
  344. package/packages/orq-rc/src/models/errors/createeval.ts +0 -80
  345. package/packages/orq-rc/src/models/errors/deleteagent.ts +0 -80
  346. package/packages/orq-rc/src/models/errors/deletecontact.ts +0 -91
  347. package/packages/orq-rc/src/models/errors/deleteeval.ts +0 -80
  348. package/packages/orq-rc/src/models/errors/duplicatetool.ts +0 -91
  349. package/packages/orq-rc/src/models/errors/getagent.ts +0 -80
  350. package/packages/orq-rc/src/models/errors/getagenttask.ts +0 -80
  351. package/packages/orq-rc/src/models/errors/getevals.ts +0 -80
  352. package/packages/orq-rc/src/models/errors/getpromptversion.ts +0 -80
  353. package/packages/orq-rc/src/models/errors/honoapierror.ts +0 -90
  354. package/packages/orq-rc/src/models/errors/httpclienterrors.ts +0 -62
  355. package/packages/orq-rc/src/models/errors/index.ts +0 -29
  356. package/packages/orq-rc/src/models/errors/listagenttasks.ts +0 -80
  357. package/packages/orq-rc/src/models/errors/orqerror.ts +0 -35
  358. package/packages/orq-rc/src/models/errors/responsevalidationerror.ts +0 -50
  359. package/packages/orq-rc/src/models/errors/retrievecontact.ts +0 -91
  360. package/packages/orq-rc/src/models/errors/sdkvalidationerror.ts +0 -109
  361. package/packages/orq-rc/src/models/errors/streamagent.ts +0 -80
  362. package/packages/orq-rc/src/models/errors/streamrunagent.ts +0 -80
  363. package/packages/orq-rc/src/models/errors/updateagent.ts +0 -80
  364. package/packages/orq-rc/src/models/errors/updatecontact.ts +0 -83
  365. package/packages/orq-rc/src/models/errors/updateeval.ts +0 -80
  366. package/packages/orq-rc/src/models/errors/updateprompt.ts +0 -80
  367. package/packages/orq-rc/src/models/errors/updatetool.ts +0 -91
  368. package/packages/orq-rc/src/models/operations/cleardataset.ts +0 -78
  369. package/packages/orq-rc/src/models/operations/createagent.ts +0 -3104
  370. package/packages/orq-rc/src/models/operations/createbudget.ts +0 -745
  371. package/packages/orq-rc/src/models/operations/createchunk.ts +0 -428
  372. package/packages/orq-rc/src/models/operations/createcontact.ts +0 -267
  373. package/packages/orq-rc/src/models/operations/createdataset.ts +0 -302
  374. package/packages/orq-rc/src/models/operations/createdatasetitem.ts +0 -6943
  375. package/packages/orq-rc/src/models/operations/createdatasource.ts +0 -852
  376. package/packages/orq-rc/src/models/operations/createeval.ts +0 -9341
  377. package/packages/orq-rc/src/models/operations/createfeedback.ts +0 -286
  378. package/packages/orq-rc/src/models/operations/createknowledge.ts +0 -1850
  379. package/packages/orq-rc/src/models/operations/creatememory.ts +0 -274
  380. package/packages/orq-rc/src/models/operations/creatememorydocument.ts +0 -287
  381. package/packages/orq-rc/src/models/operations/creatememorystore.ts +0 -2032
  382. package/packages/orq-rc/src/models/operations/createprompt.ts +0 -7812
  383. package/packages/orq-rc/src/models/operations/createtool.ts +0 -4077
  384. package/packages/orq-rc/src/models/operations/deleteagent.ts +0 -78
  385. package/packages/orq-rc/src/models/operations/deletebudget.ts +0 -69
  386. package/packages/orq-rc/src/models/operations/deletechunk.ts +0 -96
  387. package/packages/orq-rc/src/models/operations/deletechunks.ts +0 -243
  388. package/packages/orq-rc/src/models/operations/deletecontact.ts +0 -69
  389. package/packages/orq-rc/src/models/operations/deletedatapoint.ts +0 -87
  390. package/packages/orq-rc/src/models/operations/deletedataset.ts +0 -78
  391. package/packages/orq-rc/src/models/operations/deletedatasource.ts +0 -87
  392. package/packages/orq-rc/src/models/operations/deleteeval.ts +0 -66
  393. package/packages/orq-rc/src/models/operations/deleteknowledge.ts +0 -78
  394. package/packages/orq-rc/src/models/operations/deletememory.ts +0 -87
  395. package/packages/orq-rc/src/models/operations/deletememorydocument.ts +0 -98
  396. package/packages/orq-rc/src/models/operations/deletememorystore.ts +0 -78
  397. package/packages/orq-rc/src/models/operations/deleteprompt.ts +0 -69
  398. package/packages/orq-rc/src/models/operations/deletetool.ts +0 -75
  399. package/packages/orq-rc/src/models/operations/deploymentcreatemetric.ts +0 -6547
  400. package/packages/orq-rc/src/models/operations/deploymentgetconfig.ts +0 -10532
  401. package/packages/orq-rc/src/models/operations/deploymentinvoke.ts +0 -1266
  402. package/packages/orq-rc/src/models/operations/deployments.ts +0 -2606
  403. package/packages/orq-rc/src/models/operations/deploymentstream.ts +0 -10655
  404. package/packages/orq-rc/src/models/operations/duplicatetool.ts +0 -2349
  405. package/packages/orq-rc/src/models/operations/filedelete.ts +0 -78
  406. package/packages/orq-rc/src/models/operations/fileget.ts +0 -223
  407. package/packages/orq-rc/src/models/operations/filelist.ts +0 -337
  408. package/packages/orq-rc/src/models/operations/fileupload.ts +0 -327
  409. package/packages/orq-rc/src/models/operations/getagent.ts +0 -957
  410. package/packages/orq-rc/src/models/operations/getagenttask.ts +0 -259
  411. package/packages/orq-rc/src/models/operations/getallmemories.ts +0 -318
  412. package/packages/orq-rc/src/models/operations/getallmemorydocuments.ts +0 -338
  413. package/packages/orq-rc/src/models/operations/getallmemorystores.ts +0 -1277
  414. package/packages/orq-rc/src/models/operations/getallprompts.ts +0 -2572
  415. package/packages/orq-rc/src/models/operations/getalltools.ts +0 -2308
  416. package/packages/orq-rc/src/models/operations/getbudget.ts +0 -441
  417. package/packages/orq-rc/src/models/operations/getchunkscount.ts +0 -230
  418. package/packages/orq-rc/src/models/operations/getevals.ts +0 -7486
  419. package/packages/orq-rc/src/models/operations/getonechunk.ts +0 -315
  420. package/packages/orq-rc/src/models/operations/getoneknowledge.ts +0 -1292
  421. package/packages/orq-rc/src/models/operations/getoneprompt.ts +0 -2437
  422. package/packages/orq-rc/src/models/operations/getpromptversion.ts +0 -2444
  423. package/packages/orq-rc/src/models/operations/index.ts +0 -102
  424. package/packages/orq-rc/src/models/operations/invokeagent.ts +0 -1569
  425. package/packages/orq-rc/src/models/operations/listactions.ts +0 -526
  426. package/packages/orq-rc/src/models/operations/listagents.ts +0 -1077
  427. package/packages/orq-rc/src/models/operations/listagenttasks.ts +0 -1106
  428. package/packages/orq-rc/src/models/operations/listbudgets.ts +0 -617
  429. package/packages/orq-rc/src/models/operations/listchunks.ts +0 -494
  430. package/packages/orq-rc/src/models/operations/listchunkspaginated.ts +0 -507
  431. package/packages/orq-rc/src/models/operations/listcontacts.ts +0 -500
  432. package/packages/orq-rc/src/models/operations/listdatasetdatapoints.ts +0 -4086
  433. package/packages/orq-rc/src/models/operations/listdatasets.ts +0 -406
  434. package/packages/orq-rc/src/models/operations/listdatasources.ts +0 -454
  435. package/packages/orq-rc/src/models/operations/listknowledgebases.ts +0 -1303
  436. package/packages/orq-rc/src/models/operations/listmodels.ts +0 -273
  437. package/packages/orq-rc/src/models/operations/listpromptversions.ts +0 -2580
  438. package/packages/orq-rc/src/models/operations/parse.ts +0 -1295
  439. package/packages/orq-rc/src/models/operations/remoteconfigsgetconfig.ts +0 -190
  440. package/packages/orq-rc/src/models/operations/retrieveaction.ts +0 -426
  441. package/packages/orq-rc/src/models/operations/retrievecontact.ts +0 -210
  442. package/packages/orq-rc/src/models/operations/retrievedatapoint.ts +0 -3853
  443. package/packages/orq-rc/src/models/operations/retrievedataset.ts +0 -291
  444. package/packages/orq-rc/src/models/operations/retrievedatasource.ts +0 -273
  445. package/packages/orq-rc/src/models/operations/retrievememory.ts +0 -201
  446. package/packages/orq-rc/src/models/operations/retrievememorydocument.ts +0 -220
  447. package/packages/orq-rc/src/models/operations/retrievememorystore.ts +0 -1160
  448. package/packages/orq-rc/src/models/operations/retrievetool.ts +0 -2333
  449. package/packages/orq-rc/src/models/operations/runagent.ts +0 -4342
  450. package/packages/orq-rc/src/models/operations/searchknowledge.ts +0 -3573
  451. package/packages/orq-rc/src/models/operations/streamagent.ts +0 -1367
  452. package/packages/orq-rc/src/models/operations/streamrunagent.ts +0 -4355
  453. package/packages/orq-rc/src/models/operations/updateagent.ts +0 -3321
  454. package/packages/orq-rc/src/models/operations/updatebudget.ts +0 -628
  455. package/packages/orq-rc/src/models/operations/updatechunk.ts +0 -448
  456. package/packages/orq-rc/src/models/operations/updatecontact.ts +0 -325
  457. package/packages/orq-rc/src/models/operations/updatedatapoint.ts +0 -6934
  458. package/packages/orq-rc/src/models/operations/updatedataset.ts +0 -386
  459. package/packages/orq-rc/src/models/operations/updatedatasource.ts +0 -345
  460. package/packages/orq-rc/src/models/operations/updateeval.ts +0 -9704
  461. package/packages/orq-rc/src/models/operations/updateknowledge.ts +0 -2341
  462. package/packages/orq-rc/src/models/operations/updatememory.ts +0 -283
  463. package/packages/orq-rc/src/models/operations/updatememorydocument.ts +0 -296
  464. package/packages/orq-rc/src/models/operations/updatememorystore.ts +0 -1363
  465. package/packages/orq-rc/src/models/operations/updateprompt.ts +0 -8176
  466. package/packages/orq-rc/src/models/operations/updatetool.ts +0 -4288
  467. package/packages/orq-rc/src/sdk/agents.ts +0 -238
  468. package/packages/orq-rc/src/sdk/budgets.ts +0 -99
  469. package/packages/orq-rc/src/sdk/chunking.ts +0 -27
  470. package/packages/orq-rc/src/sdk/contacts.ts +0 -99
  471. package/packages/orq-rc/src/sdk/datasets.ts +0 -204
  472. package/packages/orq-rc/src/sdk/deployments.ts +0 -89
  473. package/packages/orq-rc/src/sdk/evals.ts +0 -69
  474. package/packages/orq-rc/src/sdk/feedback.ts +0 -27
  475. package/packages/orq-rc/src/sdk/files.ts +0 -78
  476. package/packages/orq-rc/src/sdk/index.ts +0 -5
  477. package/packages/orq-rc/src/sdk/knowledge.ts +0 -309
  478. package/packages/orq-rc/src/sdk/memorystores.ts +0 -286
  479. package/packages/orq-rc/src/sdk/metrics.ts +0 -27
  480. package/packages/orq-rc/src/sdk/models.ts +0 -25
  481. package/packages/orq-rc/src/sdk/prompts.ts +0 -126
  482. package/packages/orq-rc/src/sdk/remoteconfigs.ts +0 -24
  483. package/packages/orq-rc/src/sdk/sdk.ts +0 -97
  484. package/packages/orq-rc/src/sdk/tools.ts +0 -117
  485. package/packages/orq-rc/src/types/async.ts +0 -68
  486. package/packages/orq-rc/src/types/blobs.ts +0 -32
  487. package/packages/orq-rc/src/types/constdatetime.ts +0 -15
  488. package/packages/orq-rc/src/types/enums.ts +0 -16
  489. package/packages/orq-rc/src/types/fp.ts +0 -50
  490. package/packages/orq-rc/src/types/index.ts +0 -11
  491. package/packages/orq-rc/src/types/operations.ts +0 -105
  492. package/packages/orq-rc/src/types/rfcdate.ts +0 -54
  493. package/packages/orq-rc/src/types/streams.ts +0 -21
  494. package/packages/orq-rc/tsconfig.json +0 -41
@@ -1,909 +0,0 @@
1
- # @orq-ai/node
2
-
3
- Developer-friendly & type-safe Typescript SDK specifically catered to leverage *@orq-ai/node* API.
4
-
5
- <div align="left">
6
- <a href="https://www.speakeasy.com/?utm_source=@orq-ai/node&utm_campaign=typescript"><img src="https://custom-icon-badges.demolab.com/badge/-Built%20By%20Speakeasy-212015?style=for-the-badge&logoColor=FBE331&logo=speakeasy&labelColor=545454" /></a>
7
- <a href="https://opensource.org/licenses/MIT">
8
- <img src="https://img.shields.io/badge/License-MIT-blue.svg" style="width: 100px; height: 28px;" />
9
- </a>
10
- </div>
11
-
12
- <!-- Start Summary [summary] -->
13
- ## Summary
14
-
15
- orq.ai API: orq.ai API documentation
16
-
17
- For more information about the API: [orq.ai Documentation](https://docs.orq.ai)
18
- <!-- End Summary [summary] -->
19
-
20
- <!-- Start Table of Contents [toc] -->
21
- ## Table of Contents
22
- <!-- $toc-max-depth=2 -->
23
- * [@orq-ai/node](#orq-ainode)
24
- * [SDK Installation](#sdk-installation)
25
- * [Requirements](#requirements)
26
- * [SDK Example Usage](#sdk-example-usage)
27
- * [Authentication](#authentication)
28
- * [Available Resources and Operations](#available-resources-and-operations)
29
- * [Standalone functions](#standalone-functions)
30
- * [Server-sent event streaming](#server-sent-event-streaming)
31
- * [File uploads](#file-uploads)
32
- * [Retries](#retries)
33
- * [Error Handling](#error-handling)
34
- * [Server Selection](#server-selection)
35
- * [Custom HTTP Client](#custom-http-client)
36
- * [Debugging](#debugging)
37
- * [Development](#development)
38
- * [Maturity](#maturity)
39
- * [Contributions](#contributions)
40
-
41
- <!-- End Table of Contents [toc] -->
42
-
43
- <!-- Start SDK Installation [installation] -->
44
- ## SDK Installation
45
-
46
- The SDK can be installed with either [npm](https://www.npmjs.com/), [pnpm](https://pnpm.io/), [bun](https://bun.sh/) or [yarn](https://classic.yarnpkg.com/en/) package managers.
47
-
48
- ### NPM
49
-
50
- ```bash
51
- npm add @orq-ai/node
52
- ```
53
-
54
- ### PNPM
55
-
56
- ```bash
57
- pnpm add @orq-ai/node
58
- ```
59
-
60
- ### Bun
61
-
62
- ```bash
63
- bun add @orq-ai/node
64
- ```
65
-
66
- ### Yarn
67
-
68
- ```bash
69
- yarn add @orq-ai/node
70
- ```
71
-
72
-
73
-
74
- ### Model Context Protocol (MCP) Server
75
-
76
- This SDK is also an installable MCP server where the various SDK methods are
77
- exposed as tools that can be invoked by AI applications.
78
-
79
- > Node.js v20 or greater is required to run the MCP server from npm.
80
-
81
- <details>
82
- <summary>Claude installation steps</summary>
83
-
84
- Add the following server definition to your `claude_desktop_config.json` file:
85
-
86
- ```json
87
- {
88
- "mcpServers": {
89
- "Orq": {
90
- "command": "npx",
91
- "args": [
92
- "-y", "--package", "@orq-ai/node",
93
- "--",
94
- "mcp", "start",
95
- "--api-key", "...",
96
- "--contact-id", "...",
97
- "--environment", "..."
98
- ]
99
- }
100
- }
101
- }
102
- ```
103
-
104
- </details>
105
-
106
- <details>
107
- <summary>Cursor installation steps</summary>
108
-
109
- Create a `.cursor/mcp.json` file in your project root with the following content:
110
-
111
- ```json
112
- {
113
- "mcpServers": {
114
- "Orq": {
115
- "command": "npx",
116
- "args": [
117
- "-y", "--package", "@orq-ai/node",
118
- "--",
119
- "mcp", "start",
120
- "--api-key", "...",
121
- "--contact-id", "...",
122
- "--environment", "..."
123
- ]
124
- }
125
- }
126
- }
127
- ```
128
-
129
- </details>
130
-
131
- You can also run MCP servers as a standalone binary with no additional dependencies. You must pull these binaries from available Github releases:
132
-
133
- ```bash
134
- curl -L -o mcp-server \
135
- https://github.com/{org}/{repo}/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
136
- chmod +x mcp-server
137
- ```
138
-
139
- If the repo is a private repo you must add your Github PAT to download a release `-H "Authorization: Bearer {GITHUB_PAT}"`.
140
-
141
-
142
- ```json
143
- {
144
- "mcpServers": {
145
- "Todos": {
146
- "command": "./DOWNLOAD/PATH/mcp-server",
147
- "args": [
148
- "start"
149
- ]
150
- }
151
- }
152
- }
153
- ```
154
-
155
- For a full list of server arguments, run:
156
-
157
- ```sh
158
- npx -y --package @orq-ai/node -- mcp start --help
159
- ```
160
- <!-- End SDK Installation [installation] -->
161
-
162
- <!-- Start Requirements [requirements] -->
163
- ## Requirements
164
-
165
- For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
166
- <!-- End Requirements [requirements] -->
167
-
168
- <!-- Start SDK Example Usage [usage] -->
169
- ## SDK Example Usage
170
-
171
- ### Example
172
-
173
- ```typescript
174
- import { Orq } from "@orq-ai/node";
175
-
176
- const orq = new Orq({
177
- apiKey: process.env["ORQ_API_KEY"] ?? "",
178
- });
179
-
180
- async function run() {
181
- const result = await orq.contacts.create({
182
- externalId: "user_12345",
183
- displayName: "Jane Smith",
184
- email: "jane.smith@example.com",
185
- avatarUrl: "https://example.com/avatars/jane-smith.jpg",
186
- tags: [
187
- "premium",
188
- "beta-user",
189
- "enterprise",
190
- ],
191
- metadata: {
192
- "department": "Engineering",
193
- "role": "Senior Developer",
194
- "subscription_tier": "premium",
195
- "last_login": "2024-01-15T10:30:00Z",
196
- },
197
- });
198
-
199
- console.log(result);
200
- }
201
-
202
- run();
203
-
204
- ```
205
- <!-- End SDK Example Usage [usage] -->
206
-
207
- <!-- Start Authentication [security] -->
208
- ## Authentication
209
-
210
- ### Per-Client Security Schemes
211
-
212
- This SDK supports the following security scheme globally:
213
-
214
- | Name | Type | Scheme | Environment Variable |
215
- | -------- | ---- | ----------- | -------------------- |
216
- | `apiKey` | http | HTTP Bearer | `ORQ_API_KEY` |
217
-
218
- To authenticate with the API the `apiKey` parameter must be set when initializing the SDK client instance. For example:
219
- ```typescript
220
- import { Orq } from "@orq-ai/node";
221
-
222
- const orq = new Orq({
223
- apiKey: process.env["ORQ_API_KEY"] ?? "",
224
- });
225
-
226
- async function run() {
227
- const result = await orq.contacts.create({
228
- externalId: "user_12345",
229
- displayName: "Jane Smith",
230
- email: "jane.smith@example.com",
231
- avatarUrl: "https://example.com/avatars/jane-smith.jpg",
232
- tags: [
233
- "premium",
234
- "beta-user",
235
- "enterprise",
236
- ],
237
- metadata: {
238
- "department": "Engineering",
239
- "role": "Senior Developer",
240
- "subscription_tier": "premium",
241
- "last_login": "2024-01-15T10:30:00Z",
242
- },
243
- });
244
-
245
- console.log(result);
246
- }
247
-
248
- run();
249
-
250
- ```
251
- <!-- End Authentication [security] -->
252
-
253
- <!-- Start Available Resources and Operations [operations] -->
254
- ## Available Resources and Operations
255
-
256
- <details open>
257
- <summary>Available methods</summary>
258
-
259
- ### [agents](docs/sdks/agents/README.md)
260
-
261
- * [retrieveTask](docs/sdks/agents/README.md#retrievetask) - Retrieve a specific agent task
262
- * [create](docs/sdks/agents/README.md#create) - Create a new agent
263
- * [list](docs/sdks/agents/README.md#list) - List all agents
264
- * [delete](docs/sdks/agents/README.md#delete) - Delete an agent
265
- * [retrieve](docs/sdks/agents/README.md#retrieve) - Get an agent
266
- * [update](docs/sdks/agents/README.md#update) - Update an agent
267
- * [invoke](docs/sdks/agents/README.md#invoke) - Invoke an agent
268
- * [listTasks](docs/sdks/agents/README.md#listtasks) - List all tasks for an agent
269
- * [run](docs/sdks/agents/README.md#run) - Run an agent
270
- * [streamRun](docs/sdks/agents/README.md#streamrun) - Run and stream agent execution
271
- * [stream](docs/sdks/agents/README.md#stream) - Stream agent execution events
272
- * [listActions](docs/sdks/agents/README.md#listactions) - List all actions
273
- * [retrieveAction](docs/sdks/agents/README.md#retrieveaction) - Retrieve an action executed by an agent task.
274
-
275
- ### [budgets](docs/sdks/budgets/README.md)
276
-
277
- * [list](docs/sdks/budgets/README.md#list) - List budget configurations
278
- * [create](docs/sdks/budgets/README.md#create) - Create budget configuration
279
- * [get](docs/sdks/budgets/README.md#get) - Get budget configuration
280
- * [update](docs/sdks/budgets/README.md#update) - Update budget configuration
281
- * [delete](docs/sdks/budgets/README.md#delete) - Delete budget configuration
282
-
283
- ### [chunking](docs/sdks/chunking/README.md)
284
-
285
- * [parse](docs/sdks/chunking/README.md#parse) - Parse text
286
-
287
- ### [contacts](docs/sdks/contacts/README.md)
288
-
289
- * [create](docs/sdks/contacts/README.md#create) - Create a contact
290
- * [list](docs/sdks/contacts/README.md#list) - List contacts
291
- * [retrieve](docs/sdks/contacts/README.md#retrieve) - Retrieve a contact
292
- * [update](docs/sdks/contacts/README.md#update) - Update a contact
293
- * [delete](docs/sdks/contacts/README.md#delete) - Delete a contact
294
-
295
- ### [datasets](docs/sdks/datasets/README.md)
296
-
297
- * [list](docs/sdks/datasets/README.md#list) - List datasets
298
- * [create](docs/sdks/datasets/README.md#create) - Create a dataset
299
- * [retrieve](docs/sdks/datasets/README.md#retrieve) - Retrieve a dataset
300
- * [update](docs/sdks/datasets/README.md#update) - Update a dataset
301
- * [delete](docs/sdks/datasets/README.md#delete) - Delete a dataset
302
- * [listDatapoints](docs/sdks/datasets/README.md#listdatapoints) - List datapoints
303
- * [createDatapoint](docs/sdks/datasets/README.md#createdatapoint) - Create a datapoint
304
- * [retrieveDatapoint](docs/sdks/datasets/README.md#retrievedatapoint) - Retrieve a datapoint
305
- * [updateDatapoint](docs/sdks/datasets/README.md#updatedatapoint) - Update a datapoint
306
- * [deleteDatapoint](docs/sdks/datasets/README.md#deletedatapoint) - Delete a datapoint
307
- * [clear](docs/sdks/datasets/README.md#clear) - Delete all datapoints
308
-
309
- ### [deployments](docs/sdks/deployments/README.md)
310
-
311
- * [list](docs/sdks/deployments/README.md#list) - List all deployments
312
- * [getConfig](docs/sdks/deployments/README.md#getconfig) - Get config
313
- * [invoke](docs/sdks/deployments/README.md#invoke) - Invoke
314
- * [stream](docs/sdks/deployments/README.md#stream) - Stream
315
-
316
- #### [deployments.metrics](docs/sdks/metrics/README.md)
317
-
318
- * [create](docs/sdks/metrics/README.md#create) - Add metrics
319
-
320
- ### [evals](docs/sdks/evals/README.md)
321
-
322
- * [all](docs/sdks/evals/README.md#all) - Get all Evaluators
323
- * [create](docs/sdks/evals/README.md#create) - Create an Evaluator
324
- * [update](docs/sdks/evals/README.md#update) - Update an Evaluator
325
- * [delete](docs/sdks/evals/README.md#delete) - Delete an Evaluator
326
-
327
- ### [feedback](docs/sdks/feedback/README.md)
328
-
329
- * [create](docs/sdks/feedback/README.md#create) - Submit feedback
330
-
331
- ### [files](docs/sdks/files/README.md)
332
-
333
- * [create](docs/sdks/files/README.md#create) - Create file
334
- * [list](docs/sdks/files/README.md#list) - List all files
335
- * [get](docs/sdks/files/README.md#get) - Retrieve a file
336
- * [delete](docs/sdks/files/README.md#delete) - Delete file
337
-
338
- ### [knowledge](docs/sdks/knowledge/README.md)
339
-
340
- * [list](docs/sdks/knowledge/README.md#list) - List all knowledge bases
341
- * [create](docs/sdks/knowledge/README.md#create) - Create a knowledge
342
- * [retrieve](docs/sdks/knowledge/README.md#retrieve) - Retrieves a knowledge base
343
- * [update](docs/sdks/knowledge/README.md#update) - Updates a knowledge
344
- * [delete](docs/sdks/knowledge/README.md#delete) - Deletes a knowledge
345
- * [search](docs/sdks/knowledge/README.md#search) - Search knowledge base
346
- * [listDatasources](docs/sdks/knowledge/README.md#listdatasources) - List all datasources
347
- * [createDatasource](docs/sdks/knowledge/README.md#createdatasource) - Create a new datasource
348
- * [retrieveDatasource](docs/sdks/knowledge/README.md#retrievedatasource) - Retrieve a datasource
349
- * [deleteDatasource](docs/sdks/knowledge/README.md#deletedatasource) - Deletes a datasource
350
- * [updateDatasource](docs/sdks/knowledge/README.md#updatedatasource) - Update a datasource
351
- * [createChunks](docs/sdks/knowledge/README.md#createchunks) - Create chunks for a datasource
352
- * [listChunks](docs/sdks/knowledge/README.md#listchunks) - List all chunks for a datasource
353
- * [deleteChunks](docs/sdks/knowledge/README.md#deletechunks) - Delete multiple chunks
354
- * [listChunksPaginated](docs/sdks/knowledge/README.md#listchunkspaginated) - List chunks with offset-based pagination
355
- * [getChunksCount](docs/sdks/knowledge/README.md#getchunkscount) - Get chunks total count
356
- * [updateChunk](docs/sdks/knowledge/README.md#updatechunk) - Update a chunk
357
- * [deleteChunk](docs/sdks/knowledge/README.md#deletechunk) - Delete a chunk
358
- * [retrieveChunk](docs/sdks/knowledge/README.md#retrievechunk) - Retrieve a chunk
359
-
360
- ### [memoryStores](docs/sdks/memorystores/README.md)
361
-
362
- * [list](docs/sdks/memorystores/README.md#list) - List memory stores
363
- * [create](docs/sdks/memorystores/README.md#create) - Create memory store
364
- * [retrieve](docs/sdks/memorystores/README.md#retrieve) - Retrieve memory store
365
- * [update](docs/sdks/memorystores/README.md#update) - Update memory store
366
- * [delete](docs/sdks/memorystores/README.md#delete) - Delete memory store
367
- * [listMemories](docs/sdks/memorystores/README.md#listmemories) - List all memories
368
- * [createMemory](docs/sdks/memorystores/README.md#creatememory) - Create a new memory
369
- * [retrieveMemory](docs/sdks/memorystores/README.md#retrievememory) - Retrieve a specific memory
370
- * [updateMemory](docs/sdks/memorystores/README.md#updatememory) - Update a specific memory
371
- * [deleteMemory](docs/sdks/memorystores/README.md#deletememory) - Delete a specific memory
372
- * [listDocuments](docs/sdks/memorystores/README.md#listdocuments) - List all documents for a memory
373
- * [createDocument](docs/sdks/memorystores/README.md#createdocument) - Create a new memory document
374
- * [retrieveDocument](docs/sdks/memorystores/README.md#retrievedocument) - Retrieve a specific memory document
375
- * [updateDocument](docs/sdks/memorystores/README.md#updatedocument) - Update a specific memory document
376
- * [deleteDocument](docs/sdks/memorystores/README.md#deletedocument) - Delete a specific memory document
377
-
378
- ### [models](docs/sdks/models/README.md)
379
-
380
- * [list](docs/sdks/models/README.md#list) - List models
381
-
382
- ### [prompts](docs/sdks/prompts/README.md)
383
-
384
- * [list](docs/sdks/prompts/README.md#list) - List all prompts
385
- * [create](docs/sdks/prompts/README.md#create) - Create a prompt
386
- * [retrieve](docs/sdks/prompts/README.md#retrieve) - Retrieve a prompt
387
- * [update](docs/sdks/prompts/README.md#update) - Update a prompt
388
- * [delete](docs/sdks/prompts/README.md#delete) - Delete a prompt
389
- * [listVersions](docs/sdks/prompts/README.md#listversions) - List all prompt versions
390
- * [getVersion](docs/sdks/prompts/README.md#getversion) - Retrieve a prompt version
391
-
392
- ### [remoteconfigs](docs/sdks/remoteconfigs/README.md)
393
-
394
- * [retrieve](docs/sdks/remoteconfigs/README.md#retrieve) - Retrieve a remote config
395
-
396
- ### [tools](docs/sdks/tools/README.md)
397
-
398
- * [list](docs/sdks/tools/README.md#list) - List tools
399
- * [create](docs/sdks/tools/README.md#create) - Create tool
400
- * [update](docs/sdks/tools/README.md#update) - Update tool
401
- * [delete](docs/sdks/tools/README.md#delete) - Delete tool
402
- * [retrieve](docs/sdks/tools/README.md#retrieve) - Retrieve tool
403
- * [duplicate](docs/sdks/tools/README.md#duplicate) - Duplicate tool
404
-
405
- </details>
406
- <!-- End Available Resources and Operations [operations] -->
407
-
408
- <!-- Start Standalone functions [standalone-funcs] -->
409
- ## Standalone functions
410
-
411
- All the methods listed above are available as standalone functions. These
412
- functions are ideal for use in applications running in the browser, serverless
413
- runtimes or other environments where application bundle size is a primary
414
- concern. When using a bundler to build your application, all unused
415
- functionality will be either excluded from the final bundle or tree-shaken away.
416
-
417
- To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
418
-
419
- <details>
420
-
421
- <summary>Available standalone functions</summary>
422
-
423
- - [`agentsCreate`](docs/sdks/agents/README.md#create) - Create a new agent
424
- - [`agentsDelete`](docs/sdks/agents/README.md#delete) - Delete an agent
425
- - [`agentsInvoke`](docs/sdks/agents/README.md#invoke) - Invoke an agent
426
- - [`agentsList`](docs/sdks/agents/README.md#list) - List all agents
427
- - [`agentsListActions`](docs/sdks/agents/README.md#listactions) - List all actions
428
- - [`agentsListTasks`](docs/sdks/agents/README.md#listtasks) - List all tasks for an agent
429
- - [`agentsRetrieve`](docs/sdks/agents/README.md#retrieve) - Get an agent
430
- - [`agentsRetrieveAction`](docs/sdks/agents/README.md#retrieveaction) - Retrieve an action executed by an agent task.
431
- - [`agentsRetrieveTask`](docs/sdks/agents/README.md#retrievetask) - Retrieve a specific agent task
432
- - [`agentsRun`](docs/sdks/agents/README.md#run) - Run an agent
433
- - [`agentsStream`](docs/sdks/agents/README.md#stream) - Stream agent execution events
434
- - [`agentsStreamRun`](docs/sdks/agents/README.md#streamrun) - Run and stream agent execution
435
- - [`agentsUpdate`](docs/sdks/agents/README.md#update) - Update an agent
436
- - [`budgetsCreate`](docs/sdks/budgets/README.md#create) - Create budget configuration
437
- - [`budgetsDelete`](docs/sdks/budgets/README.md#delete) - Delete budget configuration
438
- - [`budgetsGet`](docs/sdks/budgets/README.md#get) - Get budget configuration
439
- - [`budgetsList`](docs/sdks/budgets/README.md#list) - List budget configurations
440
- - [`budgetsUpdate`](docs/sdks/budgets/README.md#update) - Update budget configuration
441
- - [`chunkingParse`](docs/sdks/chunking/README.md#parse) - Parse text
442
- - [`contactsCreate`](docs/sdks/contacts/README.md#create) - Create a contact
443
- - [`contactsDelete`](docs/sdks/contacts/README.md#delete) - Delete a contact
444
- - [`contactsList`](docs/sdks/contacts/README.md#list) - List contacts
445
- - [`contactsRetrieve`](docs/sdks/contacts/README.md#retrieve) - Retrieve a contact
446
- - [`contactsUpdate`](docs/sdks/contacts/README.md#update) - Update a contact
447
- - [`datasetsClear`](docs/sdks/datasets/README.md#clear) - Delete all datapoints
448
- - [`datasetsCreate`](docs/sdks/datasets/README.md#create) - Create a dataset
449
- - [`datasetsCreateDatapoint`](docs/sdks/datasets/README.md#createdatapoint) - Create a datapoint
450
- - [`datasetsDelete`](docs/sdks/datasets/README.md#delete) - Delete a dataset
451
- - [`datasetsDeleteDatapoint`](docs/sdks/datasets/README.md#deletedatapoint) - Delete a datapoint
452
- - [`datasetsList`](docs/sdks/datasets/README.md#list) - List datasets
453
- - [`datasetsListDatapoints`](docs/sdks/datasets/README.md#listdatapoints) - List datapoints
454
- - [`datasetsRetrieve`](docs/sdks/datasets/README.md#retrieve) - Retrieve a dataset
455
- - [`datasetsRetrieveDatapoint`](docs/sdks/datasets/README.md#retrievedatapoint) - Retrieve a datapoint
456
- - [`datasetsUpdate`](docs/sdks/datasets/README.md#update) - Update a dataset
457
- - [`datasetsUpdateDatapoint`](docs/sdks/datasets/README.md#updatedatapoint) - Update a datapoint
458
- - [`deploymentsGetConfig`](docs/sdks/deployments/README.md#getconfig) - Get config
459
- - [`deploymentsInvoke`](docs/sdks/deployments/README.md#invoke) - Invoke
460
- - [`deploymentsList`](docs/sdks/deployments/README.md#list) - List all deployments
461
- - [`deploymentsMetricsCreate`](docs/sdks/metrics/README.md#create) - Add metrics
462
- - [`deploymentsStream`](docs/sdks/deployments/README.md#stream) - Stream
463
- - [`evalsAll`](docs/sdks/evals/README.md#all) - Get all Evaluators
464
- - [`evalsCreate`](docs/sdks/evals/README.md#create) - Create an Evaluator
465
- - [`evalsDelete`](docs/sdks/evals/README.md#delete) - Delete an Evaluator
466
- - [`evalsUpdate`](docs/sdks/evals/README.md#update) - Update an Evaluator
467
- - [`feedbackCreate`](docs/sdks/feedback/README.md#create) - Submit feedback
468
- - [`filesCreate`](docs/sdks/files/README.md#create) - Create file
469
- - [`filesDelete`](docs/sdks/files/README.md#delete) - Delete file
470
- - [`filesGet`](docs/sdks/files/README.md#get) - Retrieve a file
471
- - [`filesList`](docs/sdks/files/README.md#list) - List all files
472
- - [`knowledgeCreate`](docs/sdks/knowledge/README.md#create) - Create a knowledge
473
- - [`knowledgeCreateChunks`](docs/sdks/knowledge/README.md#createchunks) - Create chunks for a datasource
474
- - [`knowledgeCreateDatasource`](docs/sdks/knowledge/README.md#createdatasource) - Create a new datasource
475
- - [`knowledgeDelete`](docs/sdks/knowledge/README.md#delete) - Deletes a knowledge
476
- - [`knowledgeDeleteChunk`](docs/sdks/knowledge/README.md#deletechunk) - Delete a chunk
477
- - [`knowledgeDeleteChunks`](docs/sdks/knowledge/README.md#deletechunks) - Delete multiple chunks
478
- - [`knowledgeDeleteDatasource`](docs/sdks/knowledge/README.md#deletedatasource) - Deletes a datasource
479
- - [`knowledgeGetChunksCount`](docs/sdks/knowledge/README.md#getchunkscount) - Get chunks total count
480
- - [`knowledgeList`](docs/sdks/knowledge/README.md#list) - List all knowledge bases
481
- - [`knowledgeListChunks`](docs/sdks/knowledge/README.md#listchunks) - List all chunks for a datasource
482
- - [`knowledgeListChunksPaginated`](docs/sdks/knowledge/README.md#listchunkspaginated) - List chunks with offset-based pagination
483
- - [`knowledgeListDatasources`](docs/sdks/knowledge/README.md#listdatasources) - List all datasources
484
- - [`knowledgeRetrieve`](docs/sdks/knowledge/README.md#retrieve) - Retrieves a knowledge base
485
- - [`knowledgeRetrieveChunk`](docs/sdks/knowledge/README.md#retrievechunk) - Retrieve a chunk
486
- - [`knowledgeRetrieveDatasource`](docs/sdks/knowledge/README.md#retrievedatasource) - Retrieve a datasource
487
- - [`knowledgeSearch`](docs/sdks/knowledge/README.md#search) - Search knowledge base
488
- - [`knowledgeUpdate`](docs/sdks/knowledge/README.md#update) - Updates a knowledge
489
- - [`knowledgeUpdateChunk`](docs/sdks/knowledge/README.md#updatechunk) - Update a chunk
490
- - [`knowledgeUpdateDatasource`](docs/sdks/knowledge/README.md#updatedatasource) - Update a datasource
491
- - [`memoryStoresCreate`](docs/sdks/memorystores/README.md#create) - Create memory store
492
- - [`memoryStoresCreateDocument`](docs/sdks/memorystores/README.md#createdocument) - Create a new memory document
493
- - [`memoryStoresCreateMemory`](docs/sdks/memorystores/README.md#creatememory) - Create a new memory
494
- - [`memoryStoresDelete`](docs/sdks/memorystores/README.md#delete) - Delete memory store
495
- - [`memoryStoresDeleteDocument`](docs/sdks/memorystores/README.md#deletedocument) - Delete a specific memory document
496
- - [`memoryStoresDeleteMemory`](docs/sdks/memorystores/README.md#deletememory) - Delete a specific memory
497
- - [`memoryStoresList`](docs/sdks/memorystores/README.md#list) - List memory stores
498
- - [`memoryStoresListDocuments`](docs/sdks/memorystores/README.md#listdocuments) - List all documents for a memory
499
- - [`memoryStoresListMemories`](docs/sdks/memorystores/README.md#listmemories) - List all memories
500
- - [`memoryStoresRetrieve`](docs/sdks/memorystores/README.md#retrieve) - Retrieve memory store
501
- - [`memoryStoresRetrieveDocument`](docs/sdks/memorystores/README.md#retrievedocument) - Retrieve a specific memory document
502
- - [`memoryStoresRetrieveMemory`](docs/sdks/memorystores/README.md#retrievememory) - Retrieve a specific memory
503
- - [`memoryStoresUpdate`](docs/sdks/memorystores/README.md#update) - Update memory store
504
- - [`memoryStoresUpdateDocument`](docs/sdks/memorystores/README.md#updatedocument) - Update a specific memory document
505
- - [`memoryStoresUpdateMemory`](docs/sdks/memorystores/README.md#updatememory) - Update a specific memory
506
- - [`modelsList`](docs/sdks/models/README.md#list) - List models
507
- - [`promptsCreate`](docs/sdks/prompts/README.md#create) - Create a prompt
508
- - [`promptsDelete`](docs/sdks/prompts/README.md#delete) - Delete a prompt
509
- - [`promptsGetVersion`](docs/sdks/prompts/README.md#getversion) - Retrieve a prompt version
510
- - [`promptsList`](docs/sdks/prompts/README.md#list) - List all prompts
511
- - [`promptsListVersions`](docs/sdks/prompts/README.md#listversions) - List all prompt versions
512
- - [`promptsRetrieve`](docs/sdks/prompts/README.md#retrieve) - Retrieve a prompt
513
- - [`promptsUpdate`](docs/sdks/prompts/README.md#update) - Update a prompt
514
- - [`remoteconfigsRetrieve`](docs/sdks/remoteconfigs/README.md#retrieve) - Retrieve a remote config
515
- - [`toolsCreate`](docs/sdks/tools/README.md#create) - Create tool
516
- - [`toolsDelete`](docs/sdks/tools/README.md#delete) - Delete tool
517
- - [`toolsDuplicate`](docs/sdks/tools/README.md#duplicate) - Duplicate tool
518
- - [`toolsList`](docs/sdks/tools/README.md#list) - List tools
519
- - [`toolsRetrieve`](docs/sdks/tools/README.md#retrieve) - Retrieve tool
520
- - [`toolsUpdate`](docs/sdks/tools/README.md#update) - Update tool
521
-
522
- </details>
523
- <!-- End Standalone functions [standalone-funcs] -->
524
-
525
- <!-- Start Server-sent event streaming [eventstream] -->
526
- ## Server-sent event streaming
527
-
528
- [Server-sent events][mdn-sse] are used to stream content from certain
529
- operations. These operations will expose the stream as an async iterable that
530
- can be consumed using a [`for await...of`][mdn-for-await-of] loop. The loop will
531
- terminate when the server no longer has any events to send and closes the
532
- underlying connection.
533
-
534
- ```typescript
535
- import { Orq } from "@orq-ai/node";
536
-
537
- const orq = new Orq({
538
- environment: "<value>",
539
- contactId: "<id>",
540
- apiKey: process.env["ORQ_API_KEY"] ?? "",
541
- });
542
-
543
- async function run() {
544
- const result = await orq.deployments.stream({
545
- key: "<key>",
546
- });
547
-
548
- for await (const event of result) {
549
- console.log(event);
550
- }
551
- }
552
-
553
- run();
554
-
555
- ```
556
-
557
- [mdn-sse]: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events
558
- [mdn-for-await-of]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of
559
- <!-- End Server-sent event streaming [eventstream] -->
560
-
561
- <!-- Start File uploads [file-upload] -->
562
- ## File uploads
563
-
564
- Certain SDK methods accept files as part of a multi-part request. It is possible and typically recommended to upload files as a stream rather than reading the entire contents into memory. This avoids excessive memory consumption and potentially crashing with out-of-memory errors when working with very large files. The following example demonstrates how to attach a file stream to a request.
565
-
566
- > [!TIP]
567
- >
568
- > Depending on your JavaScript runtime, there are convenient utilities that return a handle to a file without reading the entire contents into memory:
569
- >
570
- > - **Node.js v20+:** Since v20, Node.js comes with a native `openAsBlob` function in [`node:fs`](https://nodejs.org/docs/latest-v20.x/api/fs.html#fsopenasblobpath-options).
571
- > - **Bun:** The native [`Bun.file`](https://bun.sh/docs/api/file-io#reading-files-bun-file) function produces a file handle that can be used for streaming file uploads.
572
- > - **Browsers:** All supported browsers return an instance to a [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File) when reading the value from an `<input type="file">` element.
573
- > - **Node.js v18:** A file stream can be created using the `fileFrom` helper from [`fetch-blob/from.js`](https://www.npmjs.com/package/fetch-blob).
574
-
575
- ```typescript
576
- import { Orq } from "@orq-ai/node";
577
- import { openAsBlob } from "node:fs";
578
-
579
- const orq = new Orq({
580
- apiKey: process.env["ORQ_API_KEY"] ?? "",
581
- });
582
-
583
- async function run() {
584
- const result = await orq.files.create({
585
- file: await openAsBlob("example.file"),
586
- });
587
-
588
- console.log(result);
589
- }
590
-
591
- run();
592
-
593
- ```
594
- <!-- End File uploads [file-upload] -->
595
-
596
- <!-- Start Retries [retries] -->
597
- ## Retries
598
-
599
- Some of the endpoints in this SDK support retries. If you use the SDK without any configuration, it will fall back to the default retry strategy provided by the API. However, the default retry strategy can be overridden on a per-operation basis, or across the entire SDK.
600
-
601
- To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
602
- ```typescript
603
- import { Orq } from "@orq-ai/node";
604
-
605
- const orq = new Orq({
606
- apiKey: process.env["ORQ_API_KEY"] ?? "",
607
- });
608
-
609
- async function run() {
610
- const result = await orq.contacts.create({
611
- externalId: "user_12345",
612
- displayName: "Jane Smith",
613
- email: "jane.smith@example.com",
614
- avatarUrl: "https://example.com/avatars/jane-smith.jpg",
615
- tags: [
616
- "premium",
617
- "beta-user",
618
- "enterprise",
619
- ],
620
- metadata: {
621
- "department": "Engineering",
622
- "role": "Senior Developer",
623
- "subscription_tier": "premium",
624
- "last_login": "2024-01-15T10:30:00Z",
625
- },
626
- }, {
627
- retries: {
628
- strategy: "backoff",
629
- backoff: {
630
- initialInterval: 1,
631
- maxInterval: 50,
632
- exponent: 1.1,
633
- maxElapsedTime: 100,
634
- },
635
- retryConnectionErrors: false,
636
- },
637
- });
638
-
639
- console.log(result);
640
- }
641
-
642
- run();
643
-
644
- ```
645
-
646
- If you'd like to override the default retry strategy for all operations that support retries, you can provide a retryConfig at SDK initialization:
647
- ```typescript
648
- import { Orq } from "@orq-ai/node";
649
-
650
- const orq = new Orq({
651
- retryConfig: {
652
- strategy: "backoff",
653
- backoff: {
654
- initialInterval: 1,
655
- maxInterval: 50,
656
- exponent: 1.1,
657
- maxElapsedTime: 100,
658
- },
659
- retryConnectionErrors: false,
660
- },
661
- apiKey: process.env["ORQ_API_KEY"] ?? "",
662
- });
663
-
664
- async function run() {
665
- const result = await orq.contacts.create({
666
- externalId: "user_12345",
667
- displayName: "Jane Smith",
668
- email: "jane.smith@example.com",
669
- avatarUrl: "https://example.com/avatars/jane-smith.jpg",
670
- tags: [
671
- "premium",
672
- "beta-user",
673
- "enterprise",
674
- ],
675
- metadata: {
676
- "department": "Engineering",
677
- "role": "Senior Developer",
678
- "subscription_tier": "premium",
679
- "last_login": "2024-01-15T10:30:00Z",
680
- },
681
- });
682
-
683
- console.log(result);
684
- }
685
-
686
- run();
687
-
688
- ```
689
- <!-- End Retries [retries] -->
690
-
691
- <!-- Start Error Handling [errors] -->
692
- ## Error Handling
693
-
694
- [`OrqError`](./src/models/errors/orqerror.ts) is the base class for all HTTP error responses. It has the following properties:
695
-
696
- | Property | Type | Description |
697
- | ------------------- | ---------- | --------------------------------------------------------------------------------------- |
698
- | `error.message` | `string` | Error message |
699
- | `error.statusCode` | `number` | HTTP response status code eg `404` |
700
- | `error.headers` | `Headers` | HTTP response headers |
701
- | `error.body` | `string` | HTTP body. Can be empty string if no body is returned. |
702
- | `error.rawResponse` | `Response` | Raw HTTP response |
703
- | `error.data$` | | Optional. Some errors may contain structured data. [See Error Classes](#error-classes). |
704
-
705
- ### Example
706
- ```typescript
707
- import { Orq } from "@orq-ai/node";
708
- import * as errors from "@orq-ai/node/models/errors";
709
-
710
- const orq = new Orq({
711
- apiKey: process.env["ORQ_API_KEY"] ?? "",
712
- });
713
-
714
- async function run() {
715
- try {
716
- const result = await orq.contacts.retrieve({
717
- id: "<id>",
718
- });
719
-
720
- console.log(result);
721
- } catch (error) {
722
- // The base class for HTTP error responses
723
- if (error instanceof errors.OrqError) {
724
- console.log(error.message);
725
- console.log(error.statusCode);
726
- console.log(error.body);
727
- console.log(error.headers);
728
-
729
- // Depending on the method different errors may be thrown
730
- if (error instanceof errors.RetrieveContactResponseBody) {
731
- console.log(error.data$.error); // string
732
- }
733
- }
734
- }
735
- }
736
-
737
- run();
738
-
739
- ```
740
-
741
- ### Error Classes
742
- **Primary error:**
743
- * [`OrqError`](./src/models/errors/orqerror.ts): The base class for HTTP error responses.
744
-
745
- <details><summary>Less common errors (26)</summary>
746
-
747
- <br />
748
-
749
- **Network errors:**
750
- * [`ConnectionError`](./src/models/errors/httpclienterrors.ts): HTTP client was unable to make a request to a server.
751
- * [`RequestTimeoutError`](./src/models/errors/httpclienterrors.ts): HTTP request timed out due to an AbortSignal signal.
752
- * [`RequestAbortedError`](./src/models/errors/httpclienterrors.ts): HTTP request was aborted by the client.
753
- * [`InvalidRequestError`](./src/models/errors/httpclienterrors.ts): Any input used to create a request is invalid.
754
- * [`UnexpectedClientError`](./src/models/errors/httpclienterrors.ts): Unrecognised or unexpected error.
755
-
756
-
757
- **Inherit from [`OrqError`](./src/models/errors/orqerror.ts)**:
758
- * [`HonoApiError`](./src/models/errors/honoapierror.ts): Applicable to 10 of 98 methods.*
759
- * [`RetrieveContactResponseBody`](./src/models/errors/retrievecontactresponsebody.ts): Contact not found. Status code `404`. Applicable to 1 of 98 methods.*
760
- * [`UpdateContactResponseBody`](./src/models/errors/updatecontactresponsebody.ts): Contact not found. Status code `404`. Applicable to 1 of 98 methods.*
761
- * [`DeleteContactResponseBody`](./src/models/errors/deletecontactresponsebody.ts): Contact not found. Status code `404`. Applicable to 1 of 98 methods.*
762
- * [`GetEvalsResponseBody`](./src/models/errors/getevalsresponsebody.ts): Workspace ID is not found on the request. Status code `404`. Applicable to 1 of 98 methods.*
763
- * [`CreateEvalResponseBody`](./src/models/errors/createevalresponsebody.ts): Workspace ID is not found on the request. Status code `404`. Applicable to 1 of 98 methods.*
764
- * [`UpdateEvalResponseBody`](./src/models/errors/updateevalresponsebody.ts): Workspace ID is not found on the request. Status code `404`. Applicable to 1 of 98 methods.*
765
- * [`DeleteEvalResponseBody`](./src/models/errors/deleteevalresponsebody.ts): Workspace ID is not found on the request. Status code `404`. Applicable to 1 of 98 methods.*
766
- * [`GetAgentTaskResponseBody`](./src/models/errors/getagenttaskresponsebody.ts): Agent task not found. Status code `404`. Applicable to 1 of 98 methods.*
767
- * [`DeleteAgentResponseBody`](./src/models/errors/deleteagentresponsebody.ts): Agent not found. Status code `404`. Applicable to 1 of 98 methods.*
768
- * [`GetAgentResponseBody`](./src/models/errors/getagentresponsebody.ts): Agent not found. Status code `404`. Applicable to 1 of 98 methods.*
769
- * [`UpdateAgentResponseBody`](./src/models/errors/updateagentresponsebody.ts): Agent not found. Status code `404`. Applicable to 1 of 98 methods.*
770
- * [`ListAgentTasksResponseBody`](./src/models/errors/listagenttasksresponsebody.ts): No agent tasks found. Status code `404`. Applicable to 1 of 98 methods.*
771
- * [`StreamRunAgentResponseBody`](./src/models/errors/streamrunagentresponsebody.ts): Model not found. Status code `404`. Applicable to 1 of 98 methods.*
772
- * [`StreamAgentResponseBody`](./src/models/errors/streamagentresponsebody.ts): Agent not found. Status code `404`. Applicable to 1 of 98 methods.*
773
- * [`UpdatePromptResponseBody`](./src/models/errors/updatepromptresponsebody.ts): Prompt not found. Status code `404`. Applicable to 1 of 98 methods.*
774
- * [`GetPromptVersionResponseBody`](./src/models/errors/getpromptversionresponsebody.ts): Not Found - The prompt or prompt version does not exist. Status code `404`. Applicable to 1 of 98 methods.*
775
- * [`UpdateToolResponseBody`](./src/models/errors/updatetoolresponsebody.ts): Tool not found. Status code `404`. Applicable to 1 of 98 methods.*
776
- * [`DuplicateToolResponseBody`](./src/models/errors/duplicatetoolresponsebody.ts): Tool not found. Status code `404`. Applicable to 1 of 98 methods.*
777
- * [`CreateAgentResponseBody`](./src/models/errors/createagentresponsebody.ts): Agent with this key already exists in the workspace. Status code `409`. Applicable to 1 of 98 methods.*
778
- * [`ResponseValidationError`](./src/models/errors/responsevalidationerror.ts): Type mismatch between the data returned from the server and the structure expected by the SDK. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
779
-
780
- </details>
781
-
782
- \* Check [the method documentation](#available-resources-and-operations) to see if the error is applicable.
783
- <!-- End Error Handling [errors] -->
784
-
785
- <!-- Start Server Selection [server] -->
786
- ## Server Selection
787
-
788
- ### Override Server URL Per-Client
789
-
790
- The default server can be overridden globally by passing a URL to the `serverURL: string` optional parameter when initializing the SDK client instance. For example:
791
- ```typescript
792
- import { Orq } from "@orq-ai/node";
793
-
794
- const orq = new Orq({
795
- serverURL: "https://my.orq.ai",
796
- apiKey: process.env["ORQ_API_KEY"] ?? "",
797
- });
798
-
799
- async function run() {
800
- const result = await orq.contacts.create({
801
- externalId: "user_12345",
802
- displayName: "Jane Smith",
803
- email: "jane.smith@example.com",
804
- avatarUrl: "https://example.com/avatars/jane-smith.jpg",
805
- tags: [
806
- "premium",
807
- "beta-user",
808
- "enterprise",
809
- ],
810
- metadata: {
811
- "department": "Engineering",
812
- "role": "Senior Developer",
813
- "subscription_tier": "premium",
814
- "last_login": "2024-01-15T10:30:00Z",
815
- },
816
- });
817
-
818
- console.log(result);
819
- }
820
-
821
- run();
822
-
823
- ```
824
- <!-- End Server Selection [server] -->
825
-
826
- <!-- Start Custom HTTP Client [http-client] -->
827
- ## Custom HTTP Client
828
-
829
- The TypeScript SDK makes API calls using an `HTTPClient` that wraps the native
830
- [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). This
831
- client is a thin wrapper around `fetch` and provides the ability to attach hooks
832
- around the request lifecycle that can be used to modify the request or handle
833
- errors and response.
834
-
835
- The `HTTPClient` constructor takes an optional `fetcher` argument that can be
836
- used to integrate a third-party HTTP client or when writing tests to mock out
837
- the HTTP client and feed in fixtures.
838
-
839
- The following example shows how to use the `"beforeRequest"` hook to to add a
840
- custom header and a timeout to requests and how to use the `"requestError"` hook
841
- to log errors:
842
-
843
- ```typescript
844
- import { Orq } from "@orq-ai/node";
845
- import { HTTPClient } from "@orq-ai/node/lib/http";
846
-
847
- const httpClient = new HTTPClient({
848
- // fetcher takes a function that has the same signature as native `fetch`.
849
- fetcher: (request) => {
850
- return fetch(request);
851
- }
852
- });
853
-
854
- httpClient.addHook("beforeRequest", (request) => {
855
- const nextRequest = new Request(request, {
856
- signal: request.signal || AbortSignal.timeout(5000)
857
- });
858
-
859
- nextRequest.headers.set("x-custom-header", "custom value");
860
-
861
- return nextRequest;
862
- });
863
-
864
- httpClient.addHook("requestError", (error, request) => {
865
- console.group("Request Error");
866
- console.log("Reason:", `${error}`);
867
- console.log("Endpoint:", `${request.method} ${request.url}`);
868
- console.groupEnd();
869
- });
870
-
871
- const sdk = new Orq({ httpClient: httpClient });
872
- ```
873
- <!-- End Custom HTTP Client [http-client] -->
874
-
875
- <!-- Start Debugging [debug] -->
876
- ## Debugging
877
-
878
- You can setup your SDK to emit debug logs for SDK requests and responses.
879
-
880
- You can pass a logger that matches `console`'s interface as an SDK option.
881
-
882
- > [!WARNING]
883
- > Beware that debug logging will reveal secrets, like API tokens in headers, in log messages printed to a console or files. It's recommended to use this feature only during local development and not in production.
884
-
885
- ```typescript
886
- import { Orq } from "@orq-ai/node";
887
-
888
- const sdk = new Orq({ debugLogger: console });
889
- ```
890
-
891
- You can also enable a default debug logger by setting an environment variable `ORQ_DEBUG` to true.
892
- <!-- End Debugging [debug] -->
893
-
894
- <!-- Placeholder for Future Speakeasy SDK Sections -->
895
-
896
- # Development
897
-
898
- ## Maturity
899
-
900
- This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage
901
- to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally
902
- looking for the latest version.
903
-
904
- ## Contributions
905
-
906
- While we value open-source contributions to this SDK, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation.
907
- We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release.
908
-
909
- ### SDK Created by [Speakeasy](https://www.speakeasy.com/?utm_source=@orq-ai/node&utm_campaign=typescript)