@orq-ai/node 3.14.43 → 3.14.45

package/packages/orq-rc/docs/sdks/agents/README.md

@@ -5,104 +5,27 @@
 
 ### Available Operations
 
-* [retrieveTask](#retrievetask) - Retrieve a specific agent task
 * [create](#create) - Create a new agent
-* [list](#list) - List all agents
 * [delete](#delete) - Delete an agent
 * [retrieve](#retrieve) - Get an agent
 * [update](#update) - Update an agent
-* [duplicate](#duplicate) - Duplicate an existing agent
 * [invoke](#invoke) - Invoke an agent
 * [listTasks](#listtasks) - List all tasks for an agent
+* [retrieveTask](#retrievetask) - Retrieve a specific agent task
+* [list](#list) - List all agents
 * [run](#run) - Run an agent
 * [streamRun](#streamrun) - Run and stream agent execution
 * [stream](#stream) - Stream agent execution events
 * [listActions](#listactions) - List all actions
 * [retrieveAction](#retrieveaction) - Retrieve an action executed by an agent task.
 
-## retrieveTask
-
-Retrieves detailed information about a specific task for a given agent, including execution status and results.
-
-### Example Usage
-
-<!-- UsageSnippet language="typescript" operationID="GetAgentTask" method="get" path="/v2/agents/{agent_key}/tasks/{task_id}" -->
-```typescript
-import { Orq } from "@orq-ai/node";
-
-const orq = new Orq({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const result = await orq.agents.retrieveTask({
-    agentKey: "<value>",
-    taskId: "<id>",
-  });
-
-  console.log(result);
-}
-
-run();
-```
-
-### Standalone function
-
-The standalone function version of this method:
-
-```typescript
-import { OrqCore } from "@orq-ai/node/core.js";
-import { agentsRetrieveTask } from "@orq-ai/node/funcs/agentsRetrieveTask.js";
-
-// Use `OrqCore` for best tree-shaking performance.
-// You can create one instance of it to use across an application.
-const orq = new OrqCore({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const res = await agentsRetrieveTask(orq, {
-    agentKey: "<value>",
-    taskId: "<id>",
-  });
-  if (res.ok) {
-    const { value: result } = res;
-    console.log(result);
-  } else {
-    console.log("agentsRetrieveTask failed:", res.error);
-  }
-}
-
-run();
-```
-
-### Parameters
-
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.GetAgentTaskRequest](../../models/operations/getagenttaskrequest.md)                                                                                               | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `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. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
-
-### Response
-
-**Promise\<[operations.GetAgentTaskResponseBody](../../models/operations/getagenttaskresponsebody.md)\>**
-
-### Errors
-
-| Error Type                      | Status Code                     | Content Type                    |
-| ------------------------------- | ------------------------------- | ------------------------------- |
-| errors.GetAgentTaskResponseBody | 404                             | application/json                |
-| errors.APIError                 | 4XX, 5XX                        | \*/\*                           |
-
 ## create
 
 Creates a new AI agent with specified configuration. Agents can be configured with a primary model and an optional fallback model that will be used automatically if the primary model fails.
 
 ### Example Usage
 
-<!-- UsageSnippet language="typescript" operationID="CreateAgent" method="post" path="/v2/agents/" -->
+<!-- UsageSnippet language="typescript" operationID="CreateAgent" method="post" path="/v2/agents" -->
 ```typescript
 import { Orq } from "@orq-ai/node";
 
@@ -113,13 +36,21 @@ const orq = new Orq({
 async function run() {
   const result = await orq.agents.create({
     key: "<key>",
-    displayName: "Orion98",
     role: "<value>",
     description: "neatly unless refine aside platter alarmed shampoo shakily yippee",
     instructions: "<value>",
     path: "Default",
     model: "Camaro",
-    settings: {},
+    settings: {
+      tools: [
+        {
+          type: "mcp",
+          id: "01KA84ND5J0SWQMA2Q8HY5WZZZ",
+          toolId: "01KXYZ123456789",
+          requiresApproval: false,
+        },
+      ],
+    },
     knowledgeBases: [
       {
         knowledgeId: "customer-knowledge-base",
@@ -150,13 +81,21 @@ const orq = new OrqCore({
 async function run() {
   const res = await agentsCreate(orq, {
     key: "<key>",
-    displayName: "Orion98",
     role: "<value>",
     description: "neatly unless refine aside platter alarmed shampoo shakily yippee",
     instructions: "<value>",
     path: "Default",
     model: "Camaro",
-    settings: {},
+    settings: {
+      tools: [
+        {
+          type: "mcp",
+          id: "01KA84ND5J0SWQMA2Q8HY5WZZZ",
+          toolId: "01KXYZ123456789",
+          requiresApproval: false,
+        },
+      ],
+    },
     knowledgeBases: [
       {
         knowledgeId: "customer-knowledge-base",
@@ -194,79 +133,6 @@ run();
 | errors.CreateAgentResponseBody | 409                            | application/json               |
 | errors.APIError                | 4XX, 5XX                       | \*/\*                          |
 
-## list
-
-Retrieves a list of all agents in your workspace. When no limit is provided, returns all agents without pagination. When a limit is specified, returns a paginated list. Each agent includes its configuration, primary model, and optional fallback model settings.
-
-### Example Usage
-
-<!-- UsageSnippet language="typescript" operationID="ListAgents" method="get" path="/v2/agents/" -->
-```typescript
-import { Orq } from "@orq-ai/node";
-
-const orq = new Orq({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const result = await orq.agents.list({
-    limit: 10,
-  });
-
-  console.log(result);
-}
-
-run();
-```
-
-### Standalone function
-
-The standalone function version of this method:
-
-```typescript
-import { OrqCore } from "@orq-ai/node/core.js";
-import { agentsList } from "@orq-ai/node/funcs/agentsList.js";
-
-// Use `OrqCore` for best tree-shaking performance.
-// You can create one instance of it to use across an application.
-const orq = new OrqCore({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const res = await agentsList(orq, {
-    limit: 10,
-  });
-  if (res.ok) {
-    const { value: result } = res;
-    console.log(result);
-  } else {
-    console.log("agentsList failed:", res.error);
-  }
-}
-
-run();
-```
-
-### Parameters
-
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.ListAgentsRequest](../../models/operations/listagentsrequest.md)                                                                                                   | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `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. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
-
-### Response
-
-**Promise\<[operations.ListAgentsResponseBody](../../models/operations/listagentsresponsebody.md)\>**
-
-### Errors
-
-| Error Type      | Status Code     | Content Type    |
-| --------------- | --------------- | --------------- |
-| errors.APIError | 4XX, 5XX        | \*/\*           |
-
 ## delete
 
 Permanently deletes an agent and all its configuration, including primary and fallback model settings.
@@ -434,6 +300,16 @@ async function run() {
     agentKey: "<value>",
     requestBody: {
       model: "El Camino",
+      settings: {
+        tools: [
+          {
+            type: "mcp",
+            id: "01KA84ND5J0SWQMA2Q8HY5WZZZ",
+            toolId: "01KXYZ123456789",
+            requiresApproval: false,
+          },
+        ],
+      },
       path: "Default",
       knowledgeBases: [
         {
@@ -468,6 +344,16 @@ async function run() {
     agentKey: "<value>",
     requestBody: {
       model: "El Camino",
+      settings: {
+        tools: [
+          {
+            type: "mcp",
+            id: "01KA84ND5J0SWQMA2Q8HY5WZZZ",
+            toolId: "01KXYZ123456789",
+            requiresApproval: false,
+          },
+        ],
+      },
       path: "Default",
       knowledgeBases: [
         {
@@ -507,81 +393,6 @@ run();
 | errors.UpdateAgentResponseBody | 404                            | application/json               |
 | errors.APIError                | 4XX, 5XX                       | \*/\*                          |
 
-## duplicate
-
-Creates a copy of an existing agent with a new unique key. The duplicated agent will have all the same configuration as the original, including model settings, instructions, tools, and knowledge bases.
-
-### Example Usage
-
-<!-- UsageSnippet language="typescript" operationID="DuplicateAgent" method="post" path="/v2/agents/{id}/duplicate" -->
-```typescript
-import { Orq } from "@orq-ai/node";
-
-const orq = new Orq({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const result = await orq.agents.duplicate({
-    id: "<id>",
-  });
-
-  console.log(result);
-}
-
-run();
-```
-
-### Standalone function
-
-The standalone function version of this method:
-
-```typescript
-import { OrqCore } from "@orq-ai/node/core.js";
-import { agentsDuplicate } from "@orq-ai/node/funcs/agentsDuplicate.js";
-
-// Use `OrqCore` for best tree-shaking performance.
-// You can create one instance of it to use across an application.
-const orq = new OrqCore({
-  apiKey: process.env["ORQ_API_KEY"] ?? "",
-});
-
-async function run() {
-  const res = await agentsDuplicate(orq, {
-    id: "<id>",
-  });
-  if (res.ok) {
-    const { value: result } = res;
-    console.log(result);
-  } else {
-    console.log("agentsDuplicate failed:", res.error);
-  }
-}
-
-run();
-```
-
-### Parameters
-
-| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `request`                                                                                                                                                                      | [operations.DuplicateAgentRequest](../../models/operations/duplicateagentrequest.md)                                                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
-| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
-| `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. |
-| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
-
-### Response
-
-**Promise\<[operations.DuplicateAgentResponseBody](../../models/operations/duplicateagentresponsebody.md)\>**
-
-### Errors
-
-| Error Type                              | Status Code                             | Content Type                            |
-| --------------------------------------- | --------------------------------------- | --------------------------------------- |
-| errors.DuplicateAgentResponseBody       | 404                                     | application/json                        |
-| errors.DuplicateAgentAgentsResponseBody | 409                                     | application/json                        |
-| errors.APIError                         | 4XX, 5XX                                | \*/\*                                   |
-
 ## invoke
 
 Executes an existing agent with the provided input. The agent uses its pre-configured primary model and will automatically fall back to its configured fallback model if the primary model fails. Fallback models are configured at the agent level, not during execution.
@@ -705,7 +516,7 @@ run();
 
 ### Response
 
-**Promise\<[operations.InvokeAgentResponseBody](../../models/operations/invokeagentresponsebody.md)\>**
+**Promise\<[operations.InvokeAgentA2ATaskResponse](../../models/operations/invokeagenta2ataskresponse.md)\>**
 
 ### Errors
 
@@ -778,7 +589,7 @@ run();
 
 ### Response
 
-**Promise\<[operations.ListAgentTasksResponseBody](../../models/operations/listagenttasksresponsebody.md)\>**
+**Promise\<[operations.ListAgentTasksAgentTasksListResponse](../../models/operations/listagenttasksagenttaskslistresponse.md)\>**
 
 ### Errors
 
@@ -787,6 +598,155 @@ run();
 | errors.ListAgentTasksResponseBody | 404                               | application/json                  |
 | errors.APIError                   | 4XX, 5XX                          | \*/\*                             |
 
+## retrieveTask
+
+Retrieves detailed information about a specific task for a given agent, including execution status and results.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="GetAgentTask" method="get" path="/v2/agents/{agent_key}/tasks/{task_id}" -->
+```typescript
+import { Orq } from "@orq-ai/node";
+
+const orq = new Orq({
+  apiKey: process.env["ORQ_API_KEY"] ?? "",
+});
+
+async function run() {
+  const result = await orq.agents.retrieveTask({
+    agentKey: "<value>",
+    taskId: "<id>",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { OrqCore } from "@orq-ai/node/core.js";
+import { agentsRetrieveTask } from "@orq-ai/node/funcs/agentsRetrieveTask.js";
+
+// Use `OrqCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const orq = new OrqCore({
+  apiKey: process.env["ORQ_API_KEY"] ?? "",
+});
+
+async function run() {
+  const res = await agentsRetrieveTask(orq, {
+    agentKey: "<value>",
+    taskId: "<id>",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("agentsRetrieveTask failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.GetAgentTaskRequest](../../models/operations/getagenttaskrequest.md)                                                                                               | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `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. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[operations.GetAgentTaskExtendedTaskResponse](../../models/operations/getagenttaskextendedtaskresponse.md)\>**
+
+### Errors
+
+| Error Type          | Status Code         | Content Type        |
+| ------------------- | ------------------- | ------------------- |
+| errors.HonoApiError | 404                 | application/json    |
+| errors.APIError     | 4XX, 5XX            | \*/\*               |
+
+## list
+
+Retrieves a list of all agents in your workspace. When no limit is provided, returns all agents without pagination. When a limit is specified, returns a paginated list. Each agent includes its configuration, primary model, and optional fallback model settings.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="ListAgents" method="get" path="/v2/agents/" -->
+```typescript
+import { Orq } from "@orq-ai/node";
+
+const orq = new Orq({
+  apiKey: process.env["ORQ_API_KEY"] ?? "",
+});
+
+async function run() {
+  const result = await orq.agents.list({
+    limit: 10,
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { OrqCore } from "@orq-ai/node/core.js";
+import { agentsList } from "@orq-ai/node/funcs/agentsList.js";
+
+// Use `OrqCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const orq = new OrqCore({
+  apiKey: process.env["ORQ_API_KEY"] ?? "",
+});
+
+async function run() {
+  const res = await agentsList(orq, {
+    limit: 10,
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("agentsList failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.ListAgentsRequest](../../models/operations/listagentsrequest.md)                                                                                                   | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `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. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[operations.ListAgentsResponseBody](../../models/operations/listagentsresponsebody.md)\>**
+
+### Errors
+
+| Error Type      | Status Code     | Content Type    |
+| --------------- | --------------- | --------------- |
+| errors.APIError | 4XX, 5XX        | \*/\*           |
+
 ## run
 
 Executes an agent with the provided configuration using A2A message format. If the agent already exists with the same configuration, it will be reused. If the configuration differs, a new version is created. The fallback model is configured at the agent level and will be used automatically if the primary model fails during execution.
@@ -940,7 +900,7 @@ run();
 
 ### Response
 
-**Promise\<[operations.RunAgentResponseBody](../../models/operations/runagentresponsebody.md)\>**
+**Promise\<[operations.RunAgentA2ATaskResponse](../../models/operations/runagenta2ataskresponse.md)\>**
 
 ### Errors
 

package/packages/orq-rc/docs/sdks/chunking/README.md

@@ -29,6 +29,7 @@ async function run() {
     chunkSize: 256,
     threshold: 0.8,
     embeddingModel: "openai/text-embedding-3-small",
+    dimensions: 512,
     mode: "window",
     similarityWindow: 1,
   });
@@ -61,6 +62,7 @@ async function run() {
     chunkSize: 256,
     threshold: 0.8,
     embeddingModel: "openai/text-embedding-3-small",
+    dimensions: 512,
     mode: "window",
     similarityWindow: 1,
   });

package/packages/orq-rc/docs/sdks/memorystores/README.md

@@ -170,10 +170,9 @@ run();
 
 ### Errors
 
-| Error Type          | Status Code         | Content Type        |
-| ------------------- | ------------------- | ------------------- |
-| errors.HonoApiError | 400                 | application/json    |
-| errors.APIError     | 4XX, 5XX            | \*/\*               |
+| Error Type      | Status Code     | Content Type    |
+| --------------- | --------------- | --------------- |
+| errors.APIError | 4XX, 5XX        | \*/\*           |
 
 ## retrieve