@orq-ai/node 4.4.0-rc.9 → 4.4.0

package/packages/orq-rc/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@orq-ai/node",
+  "version": "4.4.0-rc.37",
+  "author": "Orq",
+  "main": "./index.js",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orq-ai/orq-node.git",
+    "directory": "packages/orq-rc"
+  },
+  "scripts": {
+    "lint": "eslint --cache --max-warnings=0 src",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.26.0",
+    "eslint": "^9.26.0",
+    "globals": "^15.14.0",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.26.0"
+  },
+  "dependencies": {
+    "zod": "^3.25.0 || ^4.0.0"
+  }
+}

package/packages/orq-rc/src/core.ts

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientSDK } from "./lib/sdks.js";
+
+/**
+ * A minimal client to use when calling standalone SDK functions. Typically, an
+ * instance of this class would be instantiated once at the start of an
+ * application and passed around through some dependency injection mechanism  to
+ * parts of an application that need to make SDK calls.
+ */
+export class OrqCore extends ClientSDK {}

package/packages/orq-rc/src/funcs/agentsCreate.ts

@@ -0,0 +1,161 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Create agent
+ *
+ * @remarks
+ * Creates a new agent with the specified configuration, including model selection, instructions, tools, and knowledge bases. Agents are intelligent assistants that can execute tasks, interact with tools, and maintain context through memory stores. The agent can be configured with a primary model and optional fallback models for automatic failover, custom instructions for behavior control, and various settings to control execution limits and tool usage.
+ */
+export function agentsCreate(
+  client: OrqCore,
+  request: operations.CreateAgentRequestRequestBody,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.CreateAgentRequestResponseBody,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request: operations.CreateAgentRequestRequestBody,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.CreateAgentRequestResponseBody,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.CreateAgentRequestRequestBody$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/agents")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "CreateAgentRequest",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    operations.CreateAgentRequestResponseBody,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(201, operations.CreateAgentRequestResponseBody$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/{src/funcs/conversationsRetrieve.ts → packages/orq-rc/src/funcs/agentsDelete.ts}

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { OrqCore } from "../core.js";
 import { encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
@@ -10,7 +11,6 @@ import { safeParse } from "../lib/schemas.js";
 import { RequestOptions } from "../lib/sdks.js";
 import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
-import * as components from "../models/components/index.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -27,19 +27,19 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Retrieve conversation
+ * Delete agent
  *
  * @remarks
- * Retrieves detailed information about a specific conversation identified by its unique ID. Returns the complete conversation object including metadata and timestamps.
+ * Permanently removes an agent from the workspace. This operation is irreversible and will delete all associated configuration including model assignments, tools, knowledge bases, memory stores, and cached data. Active agent sessions will be terminated, and the agent key will become available for reuse.
  */
-export function conversationsRetrieve(
+export function agentsDelete(
   client: OrqCore,
-  conversationId: string,
+  agentKey: string,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    components.ConversationWithMessagesResponse,
-    | errors.RetrieveConversationResponseBody
+    void,
+    | errors.DeleteAgentResponseBody
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -52,20 +52,20 @@ export function conversationsRetrieve(
 > {
   return new APIPromise($do(
     client,
-    conversationId,
+    agentKey,
     options,
   ));
 }
 
 async function $do(
   client: OrqCore,
-  conversationId: string,
+  agentKey: string,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      components.ConversationWithMessagesResponse,
-      | errors.RetrieveConversationResponseBody
+      void,
+      | errors.DeleteAgentResponseBody
       | OrqError
       | ResponseValidationError
       | ConnectionError
@@ -78,14 +78,13 @@ async function $do(
     APICall,
   ]
 > {
-  const input: operations.RetrieveConversationRequest = {
-    conversationId: conversationId,
+  const input: operations.DeleteAgentRequest = {
+    agentKey: agentKey,
   };
 
   const parsed = safeParse(
     input,
-    (value) =>
-      operations.RetrieveConversationRequest$outboundSchema.parse(value),
+    (value) => operations.DeleteAgentRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -95,13 +94,13 @@ async function $do(
   const body = null;
 
   const pathParams = {
-    conversation_id: encodeSimple("conversation_id", payload.conversation_id, {
+    agent_key: encodeSimple("agent_key", payload.agent_key, {
       explode: false,
       charEncoding: "percent",
     }),
   };
 
-  const path = pathToFunc("/v2/conversations/{conversation_id}")(pathParams);
+  const path = pathToFunc("/v2/agents/{agent_key}")(pathParams);
 
   const headers = new Headers(compactMap({
     Accept: "application/json",
@@ -114,7 +113,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "RetrieveConversation",
+    operationID: "DeleteAgent",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
@@ -128,7 +127,7 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "GET",
+    method: "DELETE",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
@@ -157,8 +156,8 @@ async function $do(
   };
 
   const [result] = await M.match<
-    components.ConversationWithMessagesResponse,
-    | errors.RetrieveConversationResponseBody
+    void,
+    | errors.DeleteAgentResponseBody
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -168,8 +167,8 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, components.ConversationWithMessagesResponse$inboundSchema),
-    M.jsonErr(404, errors.RetrieveConversationResponseBody$inboundSchema),
+    M.nil(204, z.void()),
+    M.jsonErr(404, errors.DeleteAgentResponseBody$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req, { extraFields: responseFields });

package/packages/orq-rc/src/funcs/agentsInvoke.ts

@@ -0,0 +1,177 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Execute an agent task
+ *
+ * @remarks
+ * Invokes an agent to perform a task with the provided input message. The agent will process the request using its configured model and tools, maintaining context through memory stores if configured. Supports automatic model fallback on primary model failure, tool execution, knowledge base retrieval, and continuation of previous conversations. Returns a task response that can be used to track execution status and retrieve results.
+ *
+ * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
+ */
+export function agentsInvoke(
+  client: OrqCore,
+  key: string,
+  requestBody?: operations.InvokeAgentRequestBody | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.InvokeAgentA2ATaskResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    key,
+    requestBody,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  key: string,
+  requestBody?: operations.InvokeAgentRequestBody | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.InvokeAgentA2ATaskResponse,
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const input: operations.InvokeAgentRequest = {
+    key: key,
+    requestBody: requestBody,
+  };
+
+  const parsed = safeParse(
+    input,
+    (value) => operations.InvokeAgentRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.RequestBody, { explode: true });
+
+  const pathParams = {
+    key: encodeSimple("key", payload.key, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v2/agents/{key}/task")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "InvokeAgent",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    operations.InvokeAgentA2ATaskResponse,
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.InvokeAgentA2ATaskResponse$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/{src/funcs/conversationsList.ts → packages/orq-rc/src/funcs/agentsList.ts}

@@ -25,21 +25,20 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * List conversations
+ * List agents
  *
  * @remarks
- * Retrieves a paginated list of conversations in your workspace. Conversations are returned sorted by creation date (newest first). Use pagination parameters to efficiently navigate through large collections.
+ * Retrieves a comprehensive list of agents configured in your workspace. Supports pagination for large datasets and returns agents sorted by creation date (newest first). Each agent in the response includes its complete configuration: model settings with fallback options, instructions, tools, knowledge bases, memory stores, and execution parameters. Use pagination parameters to efficiently navigate through large collections of agents.
  */
-export function conversationsList(
+export function agentsList(
   client: OrqCore,
   limit?: number | undefined,
   startingAfter?: string | undefined,
   endingBefore?: string | undefined,
-  entityId?: string | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    operations.ListConversationsResponseBody,
+    operations.ListAgentsResponseBody,
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -55,7 +54,6 @@ export function conversationsList(
     limit,
     startingAfter,
     endingBefore,
-    entityId,
     options,
   ));
 }
@@ -65,12 +63,11 @@ async function $do(
   limit?: number | undefined,
   startingAfter?: string | undefined,
   endingBefore?: string | undefined,
-  entityId?: string | undefined,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      operations.ListConversationsResponseBody,
+      operations.ListAgentsResponseBody,
       | OrqError
       | ResponseValidationError
       | ConnectionError
@@ -83,19 +80,16 @@ async function $do(
     APICall,
   ]
 > {
-  const input: operations.ListConversationsRequest | undefined = {
+  const input: operations.ListAgentsRequest | undefined = {
     limit: limit,
     startingAfter: startingAfter,
     endingBefore: endingBefore,
-    entityId: entityId,
   };
 
   const parsed = safeParse(
     input,
     (value) =>
-      operations.ListConversationsRequest$outboundSchema.optional().parse(
-        value,
-      ),
+      operations.ListAgentsRequest$outboundSchema.optional().parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -104,13 +98,12 @@ async function $do(
   const payload = parsed.value;
   const body = null;
 
-  const path = pathToFunc("/v2/conversations/")();
+  const path = pathToFunc("/v2/agents")();
 
   const query = encodeFormQuery({
-    "endingBefore": payload?.endingBefore,
-    "entityId": payload?.entityId,
+    "ending_before": payload?.ending_before,
     "limit": payload?.limit,
-    "startingAfter": payload?.startingAfter,
+    "starting_after": payload?.starting_after,
   });
 
   const headers = new Headers(compactMap({
@@ -124,7 +117,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "ListConversations",
+    operationID: "ListAgents",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
@@ -164,7 +157,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    operations.ListConversationsResponseBody,
+    operations.ListAgentsResponseBody,
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -174,7 +167,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.ListConversationsResponseBody$inboundSchema),
+    M.json(200, operations.ListAgentsResponseBody$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);