@orq-ai/node 3.9.3 → 3.9.5

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 (168) hide show
  1. package/README.md +2 -5
  2. package/bin/mcp-server.js +560 -866
  3. package/bin/mcp-server.js.map +36 -36
  4. package/docs/sdks/knowledge/README.md +77 -0
  5. package/examples/README.md +26 -0
  6. package/examples/contactsCreate.example.ts +40 -0
  7. package/examples/package-lock.json +626 -0
  8. package/examples/package.json +18 -0
  9. package/funcs/deploymentsStream.js +7 -7
  10. package/funcs/deploymentsStream.js.map +1 -1
  11. package/funcs/{knowledgeBasesChunkText.d.ts → knowledgeCreate.d.ts} +3 -6
  12. package/funcs/knowledgeCreate.d.ts.map +1 -0
  13. package/funcs/{knowledgeBasesChunkText.js → knowledgeCreate.js} +7 -10
  14. package/funcs/knowledgeCreate.js.map +1 -0
  15. package/jsr.json +1 -1
  16. package/lib/config.d.ts +3 -3
  17. package/lib/config.js +3 -3
  18. package/lib/event-streams.d.ts +4 -10
  19. package/lib/event-streams.d.ts.map +1 -1
  20. package/lib/event-streams.js +110 -194
  21. package/lib/event-streams.js.map +1 -1
  22. package/lib/matchers.d.ts.map +1 -1
  23. package/lib/matchers.js +1 -4
  24. package/lib/matchers.js.map +1 -1
  25. package/mcp-server/mcp-server.js +1 -1
  26. package/mcp-server/server.js +3 -3
  27. package/mcp-server/server.js.map +1 -1
  28. package/mcp-server/tools/knowledgeCreate.d.ts +8 -0
  29. package/mcp-server/tools/knowledgeCreate.d.ts.map +1 -0
  30. package/mcp-server/tools/{knowledgeBasesChunkText.js → knowledgeCreate.js} +8 -10
  31. package/mcp-server/tools/knowledgeCreate.js.map +1 -0
  32. package/models/operations/createcontact.js +2 -2
  33. package/models/operations/createdataset.js +2 -2
  34. package/models/operations/createdatasetitem.js +2 -2
  35. package/models/operations/createdatasource.js +2 -2
  36. package/models/operations/createeval.js +16 -16
  37. package/models/operations/createknowledge.d.ts +426 -0
  38. package/models/operations/createknowledge.d.ts.map +1 -0
  39. package/models/operations/createknowledge.js +431 -0
  40. package/models/operations/createknowledge.js.map +1 -0
  41. package/models/operations/fileget.js +2 -2
  42. package/models/operations/filelist.js +2 -2
  43. package/models/operations/fileupload.js +2 -2
  44. package/models/operations/getevals.js +28 -28
  45. package/models/operations/index.d.ts +1 -1
  46. package/models/operations/index.d.ts.map +1 -1
  47. package/models/operations/index.js +1 -1
  48. package/models/operations/index.js.map +1 -1
  49. package/models/operations/listcontacts.js +2 -2
  50. package/models/operations/listdatasetdatapoints.js +2 -2
  51. package/models/operations/listdatasets.js +2 -2
  52. package/models/operations/listdatasources.js +2 -2
  53. package/models/operations/retrievecontact.js +2 -2
  54. package/models/operations/retrievedatapoint.js +2 -2
  55. package/models/operations/retrievedataset.js +2 -2
  56. package/models/operations/retrievedatasource.js +2 -2
  57. package/models/operations/updatecontact.js +2 -2
  58. package/models/operations/updatedatapoint.js +2 -2
  59. package/models/operations/updatedataset.js +2 -2
  60. package/models/operations/updatedatasource.js +2 -2
  61. package/models/operations/updateeval.js +16 -16
  62. package/models/operations/updateknowledge.d.ts +106 -106
  63. package/models/operations/updateknowledge.d.ts.map +1 -1
  64. package/models/operations/updateknowledge.js +125 -129
  65. package/models/operations/updateknowledge.js.map +1 -1
  66. package/package.json +1 -1
  67. package/packages/orq-rc/README.md +5 -2
  68. package/packages/orq-rc/docs/sdks/knowledge/README.md +0 -87
  69. package/packages/orq-rc/examples/README.md +26 -0
  70. package/packages/orq-rc/examples/contactsCreate.example.ts +40 -0
  71. package/packages/orq-rc/examples/package-lock.json +626 -0
  72. package/packages/orq-rc/examples/package.json +18 -0
  73. package/packages/orq-rc/jsr.json +1 -1
  74. package/packages/orq-rc/package-lock.json +56 -67
  75. package/packages/orq-rc/package.json +3 -3
  76. package/packages/orq-rc/src/funcs/deploymentsStream.ts +7 -8
  77. package/packages/orq-rc/src/lib/config.ts +3 -3
  78. package/packages/orq-rc/src/lib/event-streams.ts +114 -231
  79. package/packages/orq-rc/src/lib/matchers.ts +1 -4
  80. package/packages/orq-rc/src/mcp-server/mcp-server.ts +1 -1
  81. package/packages/orq-rc/src/mcp-server/server.ts +3 -3
  82. package/packages/orq-rc/src/models/operations/chunktext.ts +63 -57
  83. package/packages/orq-rc/src/models/operations/createcontact.ts +2 -2
  84. package/packages/orq-rc/src/models/operations/createdataset.ts +2 -2
  85. package/packages/orq-rc/src/models/operations/createdatasetitem.ts +2 -2
  86. package/packages/orq-rc/src/models/operations/createdatasource.ts +2 -2
  87. package/packages/orq-rc/src/models/operations/createeval.ts +16 -16
  88. package/packages/orq-rc/src/models/operations/fileget.ts +2 -2
  89. package/packages/orq-rc/src/models/operations/filelist.ts +2 -2
  90. package/packages/orq-rc/src/models/operations/fileupload.ts +2 -2
  91. package/packages/orq-rc/src/models/operations/getevals.ts +28 -28
  92. package/packages/orq-rc/src/models/operations/listcontacts.ts +2 -2
  93. package/packages/orq-rc/src/models/operations/listdatasetdatapoints.ts +2 -2
  94. package/packages/orq-rc/src/models/operations/listdatasets.ts +2 -2
  95. package/packages/orq-rc/src/models/operations/listdatasources.ts +2 -2
  96. package/packages/orq-rc/src/models/operations/retrievecontact.ts +2 -2
  97. package/packages/orq-rc/src/models/operations/retrievedatapoint.ts +2 -2
  98. package/packages/orq-rc/src/models/operations/retrievedataset.ts +2 -2
  99. package/packages/orq-rc/src/models/operations/retrievedatasource.ts +2 -2
  100. package/packages/orq-rc/src/models/operations/updatecontact.ts +2 -2
  101. package/packages/orq-rc/src/models/operations/updatedatapoint.ts +2 -2
  102. package/packages/orq-rc/src/models/operations/updatedataset.ts +2 -2
  103. package/packages/orq-rc/src/models/operations/updatedatasource.ts +2 -2
  104. package/packages/orq-rc/src/models/operations/updateeval.ts +16 -16
  105. package/packages/orq-rc/src/sdk/knowledge.ts +0 -18
  106. package/packages/orq-rc/src/sdk/sdk.ts +6 -0
  107. package/sdk/knowledge.d.ts +4 -0
  108. package/sdk/knowledge.d.ts.map +1 -1
  109. package/sdk/knowledge.js +7 -0
  110. package/sdk/knowledge.js.map +1 -1
  111. package/sdk/sdk.d.ts +0 -3
  112. package/sdk/sdk.d.ts.map +1 -1
  113. package/sdk/sdk.js +0 -4
  114. package/sdk/sdk.js.map +1 -1
  115. package/src/funcs/deploymentsStream.ts +7 -8
  116. package/{packages/orq-rc/src/funcs/knowledgeChunkText.ts → src/funcs/knowledgeCreate.ts} +11 -13
  117. package/src/lib/config.ts +3 -3
  118. package/src/lib/event-streams.ts +114 -231
  119. package/src/lib/matchers.ts +1 -4
  120. package/src/mcp-server/mcp-server.ts +1 -1
  121. package/src/mcp-server/server.ts +3 -3
  122. package/src/mcp-server/tools/knowledgeCreate.ts +35 -0
  123. package/src/models/operations/createcontact.ts +2 -2
  124. package/src/models/operations/createdataset.ts +2 -2
  125. package/src/models/operations/createdatasetitem.ts +2 -2
  126. package/src/models/operations/createdatasource.ts +2 -2
  127. package/src/models/operations/createeval.ts +16 -16
  128. package/src/models/operations/createknowledge.ts +846 -0
  129. package/src/models/operations/fileget.ts +2 -2
  130. package/src/models/operations/filelist.ts +2 -2
  131. package/src/models/operations/fileupload.ts +2 -2
  132. package/src/models/operations/getevals.ts +28 -28
  133. package/src/models/operations/index.ts +1 -1
  134. package/src/models/operations/listcontacts.ts +2 -2
  135. package/src/models/operations/listdatasetdatapoints.ts +2 -2
  136. package/src/models/operations/listdatasets.ts +2 -2
  137. package/src/models/operations/listdatasources.ts +2 -2
  138. package/src/models/operations/retrievecontact.ts +2 -2
  139. package/src/models/operations/retrievedatapoint.ts +2 -2
  140. package/src/models/operations/retrievedataset.ts +2 -2
  141. package/src/models/operations/retrievedatasource.ts +2 -2
  142. package/src/models/operations/updatecontact.ts +2 -2
  143. package/src/models/operations/updatedatapoint.ts +2 -2
  144. package/src/models/operations/updatedataset.ts +2 -2
  145. package/src/models/operations/updatedatasource.ts +2 -2
  146. package/src/models/operations/updateeval.ts +16 -16
  147. package/src/models/operations/updateknowledge.ts +266 -206
  148. package/src/sdk/knowledge.ts +15 -0
  149. package/src/sdk/sdk.ts +0 -6
  150. package/funcs/knowledgeBasesChunkText.d.ts.map +0 -1
  151. package/funcs/knowledgeBasesChunkText.js.map +0 -1
  152. package/mcp-server/tools/knowledgeBasesChunkText.d.ts +0 -8
  153. package/mcp-server/tools/knowledgeBasesChunkText.d.ts.map +0 -1
  154. package/mcp-server/tools/knowledgeBasesChunkText.js.map +0 -1
  155. package/models/operations/chunktext.d.ts +0 -961
  156. package/models/operations/chunktext.d.ts.map +0 -1
  157. package/models/operations/chunktext.js +0 -883
  158. package/models/operations/chunktext.js.map +0 -1
  159. package/packages/orq-rc/src/mcp-server/tools/knowledgeChunkText.ts +0 -37
  160. package/sdk/knowledgebases.d.ts +0 -12
  161. package/sdk/knowledgebases.d.ts.map +0 -1
  162. package/sdk/knowledgebases.js +0 -22
  163. package/sdk/knowledgebases.js.map +0 -1
  164. package/src/models/operations/chunktext.ts +0 -1629
  165. /package/{docs → packages/orq-rc/docs}/sdks/knowledgebases/README.md +0 -0
  166. /package/{src → packages/orq-rc/src}/funcs/knowledgeBasesChunkText.ts +0 -0
  167. /package/{src → packages/orq-rc/src}/mcp-server/tools/knowledgeBasesChunkText.ts +0 -0
  168. /package/{src → packages/orq-rc/src}/sdk/knowledgebases.ts +0 -0
@@ -20,7 +20,6 @@
20
20
  * [updateChunk](#updatechunk) - Update a chunk
21
21
  * [deleteChunk](#deletechunk) - Delete a chunk
22
22
  * [retrieveChunk](#retrievechunk) - Retrieve a chunk
23
- * [chunkText](#chunktext) - Chunk text content using various strategies
24
23
 
25
24
  ## list
26
25
 
@@ -1146,92 +1145,6 @@ run();
1146
1145
 
1147
1146
  ### Errors
1148
1147
 
1149
- | Error Type | Status Code | Content Type |
1150
- | --------------- | --------------- | --------------- |
1151
- | errors.APIError | 4XX, 5XX | \*/\* |
1152
-
1153
- ## chunkText
1154
-
1155
- Split large text documents into smaller, manageable chunks using different chunking strategies optimized for RAG (Retrieval-Augmented Generation) workflows. This endpoint supports multiple chunking algorithms including token-based, sentence-based, recursive, semantic, and specialized strategies.
1156
-
1157
- ### Example Usage
1158
-
1159
- ```typescript
1160
- import { Orq } from "@orq-ai/node";
1161
-
1162
- const orq = new Orq({
1163
- apiKey: process.env["ORQ_API_KEY"] ?? "",
1164
- });
1165
-
1166
- async function run() {
1167
- const result = await orq.knowledge.chunkText({
1168
- text: "The quick brown fox jumps over the lazy dog. This is a sample text that will be chunked into smaller pieces. Each chunk will maintain context while respecting the maximum chunk size.",
1169
- metadata: true,
1170
- strategy: "semantic",
1171
- chunkSize: 256,
1172
- threshold: 0.8,
1173
- embeddingModel: "openai/text-embedding-3-small",
1174
- mode: "window",
1175
- similarityWindow: 1,
1176
- });
1177
-
1178
- console.log(result);
1179
- }
1180
-
1181
- run();
1182
- ```
1183
-
1184
- ### Standalone function
1185
-
1186
- The standalone function version of this method:
1187
-
1188
- ```typescript
1189
- import { OrqCore } from "@orq-ai/node/core.js";
1190
- import { knowledgeChunkText } from "@orq-ai/node/funcs/knowledgeChunkText.js";
1191
-
1192
- // Use `OrqCore` for best tree-shaking performance.
1193
- // You can create one instance of it to use across an application.
1194
- const orq = new OrqCore({
1195
- apiKey: process.env["ORQ_API_KEY"] ?? "",
1196
- });
1197
-
1198
- async function run() {
1199
- const res = await knowledgeChunkText(orq, {
1200
- text: "The quick brown fox jumps over the lazy dog. This is a sample text that will be chunked into smaller pieces. Each chunk will maintain context while respecting the maximum chunk size.",
1201
- metadata: true,
1202
- strategy: "semantic",
1203
- chunkSize: 256,
1204
- threshold: 0.8,
1205
- embeddingModel: "openai/text-embedding-3-small",
1206
- mode: "window",
1207
- similarityWindow: 1,
1208
- });
1209
- if (res.ok) {
1210
- const { value: result } = res;
1211
- console.log(result);
1212
- } else {
1213
- console.log("knowledgeChunkText failed:", res.error);
1214
- }
1215
- }
1216
-
1217
- run();
1218
- ```
1219
-
1220
- ### Parameters
1221
-
1222
- | Parameter | Type | Required | Description |
1223
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1224
- | `request` | [operations.ChunkTextChunkingRequest](../../models/operations/chunktextchunkingrequest.md) | :heavy_check_mark: | The request object to use for the request. |
1225
- | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
1226
- | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
1227
- | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
1228
-
1229
- ### Response
1230
-
1231
- **Promise\<[operations.ChunkTextResponseBody](../../models/operations/chunktextresponsebody.md)\>**
1232
-
1233
- ### Errors
1234
-
1235
1148
  | Error Type | Status Code | Content Type |
1236
1149
  | --------------- | --------------- | --------------- |
1237
1150
  | errors.APIError | 4XX, 5XX | \*/\* |
@@ -0,0 +1,26 @@
1
+ # @orq-ai/node Examples
2
+
3
+ This directory contains example scripts demonstrating how to use the @orq-ai/node SDK.
4
+
5
+ ## Prerequisites
6
+
7
+ - Node.js (v18 or higher)
8
+ - npm
9
+
10
+ ## Setup
11
+
12
+ 1. Copy `.env.template` to `.env`:
13
+ ```bash
14
+ cp .env.template .env
15
+ ```
16
+
17
+ 2. Edit `.env` and add your actual credentials (API keys, tokens, etc.)
18
+
19
+ ## Running the Examples
20
+
21
+ To run an example file from the examples directory:
22
+
23
+ ```bash
24
+ npm run build && npx tsx example.ts
25
+ ```
26
+
@@ -0,0 +1,40 @@
1
+ /*
2
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
3
+ */
4
+
5
+ /**
6
+ * Example usage of the @orq-ai/node SDK
7
+ *
8
+ * To run this example from the examples directory:
9
+ * npm run build && npx tsx contactsCreate.ts
10
+ */
11
+
12
+ import { Orq } from "@orq-ai/node";
13
+
14
+ const orq = new Orq({
15
+ apiKey: process.env["ORQ_API_KEY"] ?? "",
16
+ });
17
+
18
+ async function main() {
19
+ const result = await orq.create({
20
+ externalId: "user_12345",
21
+ displayName: "Jane Smith",
22
+ email: "jane.smith@example.com",
23
+ avatarUrl: "https://example.com/avatars/jane-smith.jpg",
24
+ tags: [
25
+ "premium",
26
+ "beta-user",
27
+ "enterprise",
28
+ ],
29
+ metadata: {
30
+ "department": "Engineering",
31
+ "role": "Senior Developer",
32
+ "subscription_tier": "premium",
33
+ "last_login": "2024-01-15T10:30:00Z",
34
+ },
35
+ });
36
+
37
+ console.log(result);
38
+ }
39
+
40
+ main().catch(console.error);