@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.
- package/README.md +2 -5
- package/bin/mcp-server.js +560 -866
- package/bin/mcp-server.js.map +36 -36
- package/docs/sdks/knowledge/README.md +77 -0
- package/examples/README.md +26 -0
- package/examples/contactsCreate.example.ts +40 -0
- package/examples/package-lock.json +626 -0
- package/examples/package.json +18 -0
- package/funcs/deploymentsStream.js +7 -7
- package/funcs/deploymentsStream.js.map +1 -1
- package/funcs/{knowledgeBasesChunkText.d.ts → knowledgeCreate.d.ts} +3 -6
- package/funcs/knowledgeCreate.d.ts.map +1 -0
- package/funcs/{knowledgeBasesChunkText.js → knowledgeCreate.js} +7 -10
- package/funcs/knowledgeCreate.js.map +1 -0
- package/jsr.json +1 -1
- package/lib/config.d.ts +3 -3
- package/lib/config.js +3 -3
- package/lib/event-streams.d.ts +4 -10
- package/lib/event-streams.d.ts.map +1 -1
- package/lib/event-streams.js +110 -194
- package/lib/event-streams.js.map +1 -1
- package/lib/matchers.d.ts.map +1 -1
- package/lib/matchers.js +1 -4
- package/lib/matchers.js.map +1 -1
- package/mcp-server/mcp-server.js +1 -1
- package/mcp-server/server.js +3 -3
- package/mcp-server/server.js.map +1 -1
- package/mcp-server/tools/knowledgeCreate.d.ts +8 -0
- package/mcp-server/tools/knowledgeCreate.d.ts.map +1 -0
- package/mcp-server/tools/{knowledgeBasesChunkText.js → knowledgeCreate.js} +8 -10
- package/mcp-server/tools/knowledgeCreate.js.map +1 -0
- package/models/operations/createcontact.js +2 -2
- package/models/operations/createdataset.js +2 -2
- package/models/operations/createdatasetitem.js +2 -2
- package/models/operations/createdatasource.js +2 -2
- package/models/operations/createeval.js +16 -16
- package/models/operations/createknowledge.d.ts +426 -0
- package/models/operations/createknowledge.d.ts.map +1 -0
- package/models/operations/createknowledge.js +431 -0
- package/models/operations/createknowledge.js.map +1 -0
- package/models/operations/fileget.js +2 -2
- package/models/operations/filelist.js +2 -2
- package/models/operations/fileupload.js +2 -2
- package/models/operations/getevals.js +28 -28
- package/models/operations/index.d.ts +1 -1
- package/models/operations/index.d.ts.map +1 -1
- package/models/operations/index.js +1 -1
- package/models/operations/index.js.map +1 -1
- package/models/operations/listcontacts.js +2 -2
- package/models/operations/listdatasetdatapoints.js +2 -2
- package/models/operations/listdatasets.js +2 -2
- package/models/operations/listdatasources.js +2 -2
- package/models/operations/retrievecontact.js +2 -2
- package/models/operations/retrievedatapoint.js +2 -2
- package/models/operations/retrievedataset.js +2 -2
- package/models/operations/retrievedatasource.js +2 -2
- package/models/operations/updatecontact.js +2 -2
- package/models/operations/updatedatapoint.js +2 -2
- package/models/operations/updatedataset.js +2 -2
- package/models/operations/updatedatasource.js +2 -2
- package/models/operations/updateeval.js +16 -16
- package/models/operations/updateknowledge.d.ts +106 -106
- package/models/operations/updateknowledge.d.ts.map +1 -1
- package/models/operations/updateknowledge.js +125 -129
- package/models/operations/updateknowledge.js.map +1 -1
- package/package.json +1 -1
- package/packages/orq-rc/README.md +5 -2
- package/packages/orq-rc/docs/sdks/knowledge/README.md +0 -87
- package/packages/orq-rc/examples/README.md +26 -0
- package/packages/orq-rc/examples/contactsCreate.example.ts +40 -0
- package/packages/orq-rc/examples/package-lock.json +626 -0
- package/packages/orq-rc/examples/package.json +18 -0
- package/packages/orq-rc/jsr.json +1 -1
- package/packages/orq-rc/package-lock.json +56 -67
- package/packages/orq-rc/package.json +3 -3
- package/packages/orq-rc/src/funcs/deploymentsStream.ts +7 -8
- package/packages/orq-rc/src/lib/config.ts +3 -3
- package/packages/orq-rc/src/lib/event-streams.ts +114 -231
- package/packages/orq-rc/src/lib/matchers.ts +1 -4
- package/packages/orq-rc/src/mcp-server/mcp-server.ts +1 -1
- package/packages/orq-rc/src/mcp-server/server.ts +3 -3
- package/packages/orq-rc/src/models/operations/chunktext.ts +63 -57
- package/packages/orq-rc/src/models/operations/createcontact.ts +2 -2
- package/packages/orq-rc/src/models/operations/createdataset.ts +2 -2
- package/packages/orq-rc/src/models/operations/createdatasetitem.ts +2 -2
- package/packages/orq-rc/src/models/operations/createdatasource.ts +2 -2
- package/packages/orq-rc/src/models/operations/createeval.ts +16 -16
- package/packages/orq-rc/src/models/operations/fileget.ts +2 -2
- package/packages/orq-rc/src/models/operations/filelist.ts +2 -2
- package/packages/orq-rc/src/models/operations/fileupload.ts +2 -2
- package/packages/orq-rc/src/models/operations/getevals.ts +28 -28
- package/packages/orq-rc/src/models/operations/listcontacts.ts +2 -2
- package/packages/orq-rc/src/models/operations/listdatasetdatapoints.ts +2 -2
- package/packages/orq-rc/src/models/operations/listdatasets.ts +2 -2
- package/packages/orq-rc/src/models/operations/listdatasources.ts +2 -2
- package/packages/orq-rc/src/models/operations/retrievecontact.ts +2 -2
- package/packages/orq-rc/src/models/operations/retrievedatapoint.ts +2 -2
- package/packages/orq-rc/src/models/operations/retrievedataset.ts +2 -2
- package/packages/orq-rc/src/models/operations/retrievedatasource.ts +2 -2
- package/packages/orq-rc/src/models/operations/updatecontact.ts +2 -2
- package/packages/orq-rc/src/models/operations/updatedatapoint.ts +2 -2
- package/packages/orq-rc/src/models/operations/updatedataset.ts +2 -2
- package/packages/orq-rc/src/models/operations/updatedatasource.ts +2 -2
- package/packages/orq-rc/src/models/operations/updateeval.ts +16 -16
- package/packages/orq-rc/src/sdk/knowledge.ts +0 -18
- package/packages/orq-rc/src/sdk/sdk.ts +6 -0
- package/sdk/knowledge.d.ts +4 -0
- package/sdk/knowledge.d.ts.map +1 -1
- package/sdk/knowledge.js +7 -0
- package/sdk/knowledge.js.map +1 -1
- package/sdk/sdk.d.ts +0 -3
- package/sdk/sdk.d.ts.map +1 -1
- package/sdk/sdk.js +0 -4
- package/sdk/sdk.js.map +1 -1
- package/src/funcs/deploymentsStream.ts +7 -8
- package/{packages/orq-rc/src/funcs/knowledgeChunkText.ts → src/funcs/knowledgeCreate.ts} +11 -13
- package/src/lib/config.ts +3 -3
- package/src/lib/event-streams.ts +114 -231
- package/src/lib/matchers.ts +1 -4
- package/src/mcp-server/mcp-server.ts +1 -1
- package/src/mcp-server/server.ts +3 -3
- package/src/mcp-server/tools/knowledgeCreate.ts +35 -0
- package/src/models/operations/createcontact.ts +2 -2
- package/src/models/operations/createdataset.ts +2 -2
- package/src/models/operations/createdatasetitem.ts +2 -2
- package/src/models/operations/createdatasource.ts +2 -2
- package/src/models/operations/createeval.ts +16 -16
- package/src/models/operations/createknowledge.ts +846 -0
- package/src/models/operations/fileget.ts +2 -2
- package/src/models/operations/filelist.ts +2 -2
- package/src/models/operations/fileupload.ts +2 -2
- package/src/models/operations/getevals.ts +28 -28
- package/src/models/operations/index.ts +1 -1
- package/src/models/operations/listcontacts.ts +2 -2
- package/src/models/operations/listdatasetdatapoints.ts +2 -2
- package/src/models/operations/listdatasets.ts +2 -2
- package/src/models/operations/listdatasources.ts +2 -2
- package/src/models/operations/retrievecontact.ts +2 -2
- package/src/models/operations/retrievedatapoint.ts +2 -2
- package/src/models/operations/retrievedataset.ts +2 -2
- package/src/models/operations/retrievedatasource.ts +2 -2
- package/src/models/operations/updatecontact.ts +2 -2
- package/src/models/operations/updatedatapoint.ts +2 -2
- package/src/models/operations/updatedataset.ts +2 -2
- package/src/models/operations/updatedatasource.ts +2 -2
- package/src/models/operations/updateeval.ts +16 -16
- package/src/models/operations/updateknowledge.ts +266 -206
- package/src/sdk/knowledge.ts +15 -0
- package/src/sdk/sdk.ts +0 -6
- package/funcs/knowledgeBasesChunkText.d.ts.map +0 -1
- package/funcs/knowledgeBasesChunkText.js.map +0 -1
- package/mcp-server/tools/knowledgeBasesChunkText.d.ts +0 -8
- package/mcp-server/tools/knowledgeBasesChunkText.d.ts.map +0 -1
- package/mcp-server/tools/knowledgeBasesChunkText.js.map +0 -1
- package/models/operations/chunktext.d.ts +0 -961
- package/models/operations/chunktext.d.ts.map +0 -1
- package/models/operations/chunktext.js +0 -883
- package/models/operations/chunktext.js.map +0 -1
- package/packages/orq-rc/src/mcp-server/tools/knowledgeChunkText.ts +0 -37
- package/sdk/knowledgebases.d.ts +0 -12
- package/sdk/knowledgebases.d.ts.map +0 -1
- package/sdk/knowledgebases.js +0 -22
- package/sdk/knowledgebases.js.map +0 -1
- package/src/models/operations/chunktext.ts +0 -1629
- /package/{docs → packages/orq-rc/docs}/sdks/knowledgebases/README.md +0 -0
- /package/{src → packages/orq-rc/src}/funcs/knowledgeBasesChunkText.ts +0 -0
- /package/{src → packages/orq-rc/src}/mcp-server/tools/knowledgeBasesChunkText.ts +0 -0
- /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);
|