@orq-ai/node 4.5.0-rc.26 → 4.5.0-rc.33

package/src/funcs/agentsResponsesGet.ts

@@ -0,0 +1,182 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { 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 * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.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";
+
+/**
+ * Get response
+ *
+ * @remarks
+ * Retrieves the current state of an agent response by task ID. Returns the response output, model information, token usage, and execution status. When the agent is still processing, the output array will be empty and status will be `in_progress`. Once completed, the response includes the full output, usage statistics, and finish reason.
+ */
+export function agentsResponsesGet(
+  client: OrqCore,
+  request: operations.GetAgentResponseRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.GetAgentResponse,
+    | errors.HonoApiError
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request: operations.GetAgentResponseRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.GetAgentResponse,
+      | errors.HonoApiError
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetAgentResponseRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    agent_key: encodeSimple("agent_key", payload.agent_key, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    task_id: encodeSimple("task_id", payload.task_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v2/agents/{agent_key}/responses/{task_id}")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    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: "GetAgentResponse",
+    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: "GET",
+    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: ["404", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.GetAgentResponse,
+    | errors.HonoApiError
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.GetAgentResponse$inboundSchema),
+    M.jsonErr(404, errors.HonoApiError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/agentsUpdate.ts

@@ -33,7 +33,7 @@ import { Result } from "../types/fp.js";
  */
 export function agentsUpdate(
   client: OrqCore,
-  requestBody: operations.UpdateAgentUpdateAgentRequest,
+  requestBody: operations.UpdateAgentRequestBody,
   agentKey: string,
   options?: RequestOptions,
 ): APIPromise<
@@ -60,7 +60,7 @@ export function agentsUpdate(
 
 async function $do(
   client: OrqCore,
-  requestBody: operations.UpdateAgentUpdateAgentRequest,
+  requestBody: operations.UpdateAgentRequestBody,
   agentKey: string,
   options?: RequestOptions,
 ): Promise<

package/src/lib/config.ts

@@ -68,7 +68,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0",
-  sdkVersion: "4.5.0-rc.26",
-  genVersion: "2.846.4",
-  userAgent: "speakeasy-sdk/typescript 4.5.0-rc.26 2.846.4 2.0 @orq-ai/node",
+  sdkVersion: "4.5.0-rc.33",
+  genVersion: "2.849.8",
+  userAgent: "speakeasy-sdk/typescript 4.5.0-rc.33 2.849.8 2.0 @orq-ai/node",
 } as const;

package/src/models/components/extendedmessage.ts

@@ -0,0 +1,146 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { DataPart, DataPart$inboundSchema } from "./datapart.js";
+import { ErrorPart, ErrorPart$inboundSchema } from "./errorpart.js";
+import { FilePart, FilePart$inboundSchema } from "./filepart.js";
+import { TextPart, TextPart$inboundSchema } from "./textpart.js";
+import { ToolCallPart, ToolCallPart$inboundSchema } from "./toolcallpart.js";
+import {
+  ToolResultPart,
+  ToolResultPart$inboundSchema,
+} from "./toolresultpart.js";
+
+export const ExtendedMessageKind = {
+  Message: "message",
+} as const;
+export type ExtendedMessageKind = ClosedEnum<typeof ExtendedMessageKind>;
+
+/**
+ * Role of the message sender in the A2A protocol. Values: user (end user), agent (AI agent), tool (tool execution result), system (system instructions/prompts).
+ */
+export const ExtendedMessageRole = {
+  User: "user",
+  Agent: "agent",
+  Tool: "tool",
+  System: "system",
+} as const;
+/**
+ * Role of the message sender in the A2A protocol. Values: user (end user), agent (AI agent), tool (tool execution result), system (system instructions/prompts).
+ */
+export type ExtendedMessageRole = ClosedEnum<typeof ExtendedMessageRole>;
+
+export type ExtendedMessageParts =
+  | TextPart
+  | ErrorPart
+  | DataPart
+  | FilePart
+  | ToolCallPart
+  | ToolResultPart;
+
+/**
+ * Extended Agent-to-Agent protocol message with support for tool calls and tool results. Extends the base A2A message format with Orquesta-specific features.
+ */
+export type ExtendedMessage = {
+  kind: ExtendedMessageKind;
+  /**
+   * Unique identifier for the message
+   */
+  messageId: string;
+  /**
+   * Role of the message sender in the A2A protocol. Values: user (end user), agent (AI agent), tool (tool execution result), system (system instructions/prompts).
+   */
+  role: ExtendedMessageRole;
+  /**
+   * Array of message parts (text, file, tool_call, tool_result)
+   */
+  parts: Array<
+    TextPart | ErrorPart | DataPart | FilePart | ToolCallPart | ToolResultPart
+  >;
+  /**
+   * Associated task ID if applicable
+   */
+  taskId?: string | undefined;
+  /**
+   * Correlation ID for execution tracking
+   */
+  contextId?: string | undefined;
+  /**
+   * Additional message metadata
+   */
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const ExtendedMessageKind$inboundSchema: z.ZodNativeEnum<
+  typeof ExtendedMessageKind
+> = z.nativeEnum(ExtendedMessageKind);
+
+/** @internal */
+export const ExtendedMessageRole$inboundSchema: z.ZodNativeEnum<
+  typeof ExtendedMessageRole
+> = z.nativeEnum(ExtendedMessageRole);
+
+/** @internal */
+export const ExtendedMessageParts$inboundSchema: z.ZodType<
+  ExtendedMessageParts,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  TextPart$inboundSchema,
+  ErrorPart$inboundSchema,
+  DataPart$inboundSchema,
+  FilePart$inboundSchema,
+  ToolCallPart$inboundSchema,
+  ToolResultPart$inboundSchema,
+]);
+
+export function extendedMessagePartsFromJSON(
+  jsonString: string,
+): SafeParseResult<ExtendedMessageParts, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExtendedMessageParts$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExtendedMessageParts' from JSON`,
+  );
+}
+
+/** @internal */
+export const ExtendedMessage$inboundSchema: z.ZodType<
+  ExtendedMessage,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  kind: ExtendedMessageKind$inboundSchema,
+  messageId: z.string(),
+  role: ExtendedMessageRole$inboundSchema,
+  parts: z.array(
+    z.union([
+      TextPart$inboundSchema,
+      ErrorPart$inboundSchema,
+      DataPart$inboundSchema,
+      FilePart$inboundSchema,
+      ToolCallPart$inboundSchema,
+      ToolResultPart$inboundSchema,
+    ]),
+  ),
+  taskId: z.string().optional(),
+  contextId: z.string().optional(),
+  metadata: z.record(z.any()).optional(),
+});
+
+export function extendedMessageFromJSON(
+  jsonString: string,
+): SafeParseResult<ExtendedMessage, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ExtendedMessage$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ExtendedMessage' from JSON`,
+  );
+}

package/src/models/components/getagentresponse.ts

@@ -0,0 +1,348 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AgentResponseMessage,
+  AgentResponseMessage$inboundSchema,
+} from "./agentresponsemessage.js";
+import { Telemetry, Telemetry$inboundSchema } from "./telemetry.js";
+
+export type GetAgentResponsePromptTokensDetails = {
+  cachedTokens?: number | null | undefined;
+  cacheCreationTokens?: number | null | undefined;
+  /**
+   * The number of audio input tokens consumed by the request.
+   */
+  audioTokens?: number | null | undefined;
+};
+
+export type GetAgentResponseCompletionTokensDetails = {
+  reasoningTokens?: number | null | undefined;
+  acceptedPredictionTokens?: number | null | undefined;
+  rejectedPredictionTokens?: number | null | undefined;
+  /**
+   * The number of audio output tokens produced by the response.
+   */
+  audioTokens?: number | null | undefined;
+};
+
+/**
+ * Token usage from the agent execution
+ */
+export type GetAgentResponseUsage = {
+  /**
+   * Number of tokens in the generated completion.
+   */
+  completionTokens?: number | undefined;
+  /**
+   * Number of tokens in the prompt.
+   */
+  promptTokens?: number | undefined;
+  /**
+   * Total number of tokens used in the request (prompt + completion).
+   */
+  totalTokens?: number | undefined;
+  promptTokensDetails?: GetAgentResponsePromptTokensDetails | null | undefined;
+  completionTokensDetails?:
+    | GetAgentResponseCompletionTokensDetails
+    | null
+    | undefined;
+};
+
+/**
+ * The reason why the agent stopped generating
+ */
+export const GetAgentResponseFinishReason = {
+  Stop: "stop",
+  Length: "length",
+  ToolCalls: "tool_calls",
+  ContentFilter: "content_filter",
+  FunctionCall: "function_call",
+  MaxIterations: "max_iterations",
+  MaxTime: "max_time",
+} as const;
+/**
+ * The reason why the agent stopped generating
+ */
+export type GetAgentResponseFinishReason = ClosedEnum<
+  typeof GetAgentResponseFinishReason
+>;
+
+export const GetAgentResponseType = {
+  Function: "function",
+} as const;
+export type GetAgentResponseType = ClosedEnum<typeof GetAgentResponseType>;
+
+export type GetAgentResponseFunction = {
+  name?: string | undefined;
+  arguments?: string | undefined;
+};
+
+export type GetAgentResponsePendingToolCalls = {
+  id: string;
+  type: GetAgentResponseType;
+  function: GetAgentResponseFunction;
+};
+
+/**
+ * Current status of the agent response
+ */
+export const Status = {
+  InProgress: "in_progress",
+  Completed: "completed",
+  Failed: "failed",
+} as const;
+/**
+ * Current status of the agent response
+ */
+export type Status = ClosedEnum<typeof Status>;
+
+/**
+ * Response type from the get-response endpoint. Includes a status field indicating the current state of the agent execution.
+ */
+export type GetAgentResponse = {
+  /**
+   * The unique response ID
+   */
+  id: string;
+  /**
+   * The agent execution task ID
+   */
+  taskId: string;
+  /**
+   * Array of messages from the agent execution
+   */
+  output: Array<AgentResponseMessage>;
+  /**
+   * ISO timestamp of response creation
+   */
+  createdAt: string;
+  /**
+   * Model used in provider/model format
+   */
+  model: string;
+  /**
+   * Token usage from the agent execution
+   */
+  usage?: GetAgentResponseUsage | null | undefined;
+  /**
+   * The reason why the agent stopped generating
+   */
+  finishReason?: GetAgentResponseFinishReason | undefined;
+  /**
+   * Tool calls awaiting user response (when finish_reason is function_call)
+   */
+  pendingToolCalls?: Array<GetAgentResponsePendingToolCalls> | undefined;
+  /**
+   * Telemetry information for correlating the response with traces
+   */
+  telemetry?: Telemetry | undefined;
+  /**
+   * Current status of the agent response
+   */
+  status: Status;
+  /**
+   * Error message when status is failed
+   */
+  error?: string | undefined;
+};
+
+/** @internal */
+export const GetAgentResponsePromptTokensDetails$inboundSchema: z.ZodType<
+  GetAgentResponsePromptTokensDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  cached_tokens: z.nullable(z.number().int()).optional(),
+  cache_creation_tokens: z.nullable(z.number().int()).optional(),
+  audio_tokens: z.nullable(z.number().int()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "cached_tokens": "cachedTokens",
+    "cache_creation_tokens": "cacheCreationTokens",
+    "audio_tokens": "audioTokens",
+  });
+});
+
+export function getAgentResponsePromptTokensDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAgentResponsePromptTokensDetails, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetAgentResponsePromptTokensDetails$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAgentResponsePromptTokensDetails' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetAgentResponseCompletionTokensDetails$inboundSchema: z.ZodType<
+  GetAgentResponseCompletionTokensDetails,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  reasoning_tokens: z.nullable(z.number()).optional(),
+  accepted_prediction_tokens: z.nullable(z.number()).optional(),
+  rejected_prediction_tokens: z.nullable(z.number()).optional(),
+  audio_tokens: z.nullable(z.number().int()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "reasoning_tokens": "reasoningTokens",
+    "accepted_prediction_tokens": "acceptedPredictionTokens",
+    "rejected_prediction_tokens": "rejectedPredictionTokens",
+    "audio_tokens": "audioTokens",
+  });
+});
+
+export function getAgentResponseCompletionTokensDetailsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  GetAgentResponseCompletionTokensDetails,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetAgentResponseCompletionTokensDetails$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'GetAgentResponseCompletionTokensDetails' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetAgentResponseUsage$inboundSchema: z.ZodType<
+  GetAgentResponseUsage,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  completion_tokens: z.number().optional(),
+  prompt_tokens: z.number().optional(),
+  total_tokens: z.number().optional(),
+  prompt_tokens_details: z.nullable(
+    z.lazy(() => GetAgentResponsePromptTokensDetails$inboundSchema),
+  ).optional(),
+  completion_tokens_details: z.nullable(
+    z.lazy(() => GetAgentResponseCompletionTokensDetails$inboundSchema),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "completion_tokens": "completionTokens",
+    "prompt_tokens": "promptTokens",
+    "total_tokens": "totalTokens",
+    "prompt_tokens_details": "promptTokensDetails",
+    "completion_tokens_details": "completionTokensDetails",
+  });
+});
+
+export function getAgentResponseUsageFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAgentResponseUsage, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAgentResponseUsage$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAgentResponseUsage' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetAgentResponseFinishReason$inboundSchema: z.ZodNativeEnum<
+  typeof GetAgentResponseFinishReason
+> = z.nativeEnum(GetAgentResponseFinishReason);
+
+/** @internal */
+export const GetAgentResponseType$inboundSchema: z.ZodNativeEnum<
+  typeof GetAgentResponseType
+> = z.nativeEnum(GetAgentResponseType);
+
+/** @internal */
+export const GetAgentResponseFunction$inboundSchema: z.ZodType<
+  GetAgentResponseFunction,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string().optional(),
+  arguments: z.string().optional(),
+});
+
+export function getAgentResponseFunctionFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAgentResponseFunction, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAgentResponseFunction$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAgentResponseFunction' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetAgentResponsePendingToolCalls$inboundSchema: z.ZodType<
+  GetAgentResponsePendingToolCalls,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  type: GetAgentResponseType$inboundSchema,
+  function: z.lazy(() => GetAgentResponseFunction$inboundSchema),
+});
+
+export function getAgentResponsePendingToolCallsFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAgentResponsePendingToolCalls, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAgentResponsePendingToolCalls$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAgentResponsePendingToolCalls' from JSON`,
+  );
+}
+
+/** @internal */
+export const Status$inboundSchema: z.ZodNativeEnum<typeof Status> = z
+  .nativeEnum(Status);
+
+/** @internal */
+export const GetAgentResponse$inboundSchema: z.ZodType<
+  GetAgentResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _id: z.string(),
+  task_id: z.string(),
+  output: z.array(AgentResponseMessage$inboundSchema),
+  created_at: z.string(),
+  model: z.string(),
+  usage: z.nullable(z.lazy(() => GetAgentResponseUsage$inboundSchema))
+    .optional(),
+  finish_reason: GetAgentResponseFinishReason$inboundSchema.optional(),
+  pending_tool_calls: z.array(
+    z.lazy(() => GetAgentResponsePendingToolCalls$inboundSchema),
+  ).optional(),
+  telemetry: Telemetry$inboundSchema.optional(),
+  status: Status$inboundSchema,
+  error: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_id": "id",
+    "task_id": "taskId",
+    "created_at": "createdAt",
+    "finish_reason": "finishReason",
+    "pending_tool_calls": "pendingToolCalls",
+  });
+});
+
+export function getAgentResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetAgentResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetAgentResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetAgentResponse' from JSON`,
+  );
+}