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

package/src/lib/event-streams.ts

@@ -2,6 +2,15 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+// Ensure ReadableStream always declares [Symbol.asyncIterator] so the
+// override keyword works consistently regardless of installed type
+// definitions (e.g. bun-types omits it from its ReadableStream).
+declare global {
+  interface ReadableStream<R = any> {
+    [Symbol.asyncIterator](): AsyncIterableIterator<R>;
+  }
+}
+
 export type SseMessage<T> = {
   data?: T | undefined;
   event?: string | null | undefined;
@@ -48,7 +57,7 @@ export class EventStream<T extends SseMessage<unknown>>
   }
 
   // Polyfill for older browsers
-  [Symbol.asyncIterator](): AsyncIterableIterator<T> {
+  override [Symbol.asyncIterator](): AsyncIterableIterator<T> {
     const fn = (ReadableStream.prototype as any)[Symbol.asyncIterator];
     if (typeof fn === "function") return fn.call(this);
     const reader = this.getReader();

package/src/lib/matchers.ts

@@ -248,8 +248,9 @@ export function match<T, E>(
         raw = body;
         break;
       default:
-        encoding satisfies never;
-        throw new Error(`Unsupported response type: ${encoding}`);
+        throw new Error(
+          `Unsupported response type: ${encoding satisfies never}`,
+        );
     }
 
     if (matcher.enc === "fail") {

package/src/lib/security.ts

@@ -198,8 +198,7 @@ export function resolveSecurity(
         applyBearer(state, spec);
         break;
       default:
-        spec satisfies never;
-        throw SecurityError.unrecognizedType(type);
+        throw SecurityError.unrecognizedType((spec satisfies never, type));
     }
   });
 

package/src/models/components/createagentresponse.ts

@@ -12,6 +12,7 @@ import {
   AgentResponseMessage,
   AgentResponseMessage$inboundSchema,
 } from "./agentresponsemessage.js";
+import { Telemetry, Telemetry$inboundSchema } from "./telemetry.js";
 
 export type PromptTokensDetails = {
   cachedTokens?: number | null | undefined;
@@ -123,6 +124,10 @@ export type CreateAgentResponse = {
    * Tool calls awaiting user response (when finish_reason is function_call)
    */
   pendingToolCalls?: Array<PendingToolCalls> | undefined;
+  /**
+   * Telemetry information for correlating the response with traces
+   */
+  telemetry?: Telemetry | undefined;
 };
 
 /** @internal */
@@ -278,6 +283,7 @@ export const CreateAgentResponse$inboundSchema: z.ZodType<
   finish_reason: FinishReason$inboundSchema.optional(),
   pending_tool_calls: z.array(z.lazy(() => PendingToolCalls$inboundSchema))
     .optional(),
+  telemetry: Telemetry$inboundSchema.optional(),
 }).transform((v) => {
   return remap$(v, {
     "_id": "id",

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`,
+  );
+}

package/src/models/components/index.ts

@@ -20,8 +20,10 @@ export * from "./errorstreamingevent.js";
 export * from "./executionnamedstreamingevent.js";
 export * from "./executionreviewedstreamingevent.js";
 export * from "./executionreviewrequiredstreamingevent.js";
+export * from "./extendedmessage.js";
 export * from "./filecontentpartschema.js";
 export * from "./filepart.js";
+export * from "./getagentresponse.js";
 export * from "./imagecontentpartschema.js";
 export * from "./invokedeploymentrequest.js";
 export * from "./partdelta.js";
@@ -39,6 +41,7 @@ export * from "./responsestartedevent.js";
 export * from "./responsestreamingevent.js";
 export * from "./reviewoutcome.js";
 export * from "./security.js";
+export * from "./telemetry.js";
 export * from "./textcontentpartschema.js";
 export * from "./textpart.js";
 export * from "./thinkingconfigdisabledschema.js";

package/src/models/components/partdoneevent.ts

@@ -76,7 +76,7 @@ export const PartReasoningPart$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("reasoning_01kj8f9bq7ag836hhcpkvbxfjb"),
+  _id: z.string().default("reasoning_01kjz6j2j4jm79rvv8nmq2wm7m"),
   metadata: z.record(z.any()).optional(),
   kind: PartKind$inboundSchema,
   reasoning: z.string(),

package/src/models/components/reasoningpart.ts

@@ -40,7 +40,7 @@ export const ReasoningPart$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  _id: z.string().default("reasoning_01kj8f9bphyq3tpwfd5gt9gbny"),
+  _id: z.string().default("reasoning_01kjz6j2hwc2e1ea5npjnhgvmy"),
   metadata: z.record(z.any()).optional(),
   kind: z.literal("reasoning"),
   reasoning: z.string(),

package/src/models/components/responsedoneevent.ts

@@ -8,6 +8,7 @@ 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 { Telemetry, Telemetry$inboundSchema } from "./telemetry.js";
 
 /**
  * The reason why the agent stopped generating
@@ -110,6 +111,10 @@ export type ResponseDoneEventData = {
    * Tool calls awaiting user response (when finishReason is function_call)
    */
   pendingToolCalls?: Array<ResponseDoneEventPendingToolCalls> | undefined;
+  /**
+   * Telemetry information for correlating the response with traces
+   */
+  telemetry?: Telemetry | undefined;
 };
 
 /**
@@ -284,6 +289,7 @@ export const ResponseDoneEventData$inboundSchema: z.ZodType<
   pendingToolCalls: z.array(
     z.lazy(() => ResponseDoneEventPendingToolCalls$inboundSchema),
   ).optional(),
+  telemetry: Telemetry$inboundSchema.optional(),
 });
 
 export function responseDoneEventDataFromJSON(

package/src/models/components/responsestartedevent.ts

@@ -6,6 +6,7 @@ import * as z from "zod/v3";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { Telemetry, Telemetry$inboundSchema } from "./telemetry.js";
 
 export type Data = {
   /**
@@ -34,6 +35,10 @@ export type Data = {
    * Server-generated ID for the assistant message. Use this ID for frontend state consistency.
    */
   assistantMessageId?: string | undefined;
+  /**
+   * Telemetry information for correlating the response with traces
+   */
+  telemetry?: Telemetry | undefined;
 };
 
 /**
@@ -57,6 +62,7 @@ export const Data$inboundSchema: z.ZodType<Data, z.ZodTypeDef, unknown> = z
     workflowRunId: z.string(),
     userMessageId: z.string().optional(),
     assistantMessageId: z.string().optional(),
+    telemetry: Telemetry$inboundSchema.optional(),
   });
 
 export function dataFromJSON(