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

package/packages/orq-rc/src/models/operations/createagentresponserequest.ts

@@ -0,0 +1,670 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { EventStream } from "../../lib/event-streams.js";
+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 * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Message containing tool execution results
+ */
+export const RoleToolMessage = {
+  Tool: "tool",
+} as const;
+/**
+ * Message containing tool execution results
+ */
+export type RoleToolMessage = ClosedEnum<typeof RoleToolMessage>;
+
+/**
+ * Message from the end user
+ */
+export const RoleUserMessage = {
+  User: "user",
+} as const;
+/**
+ * Message from the end user
+ */
+export type RoleUserMessage = ClosedEnum<typeof RoleUserMessage>;
+
+/**
+ * Message role (user or tool for continuing executions)
+ */
+export type CreateAgentResponseRequestRole = RoleUserMessage | RoleToolMessage;
+
+/**
+ * Message part that can be provided by users. Use "text" for regular messages, "file" for attachments, or "tool_result" when responding to tool call requests.
+ */
+export type PublicMessagePart =
+  | components.TextPart
+  | components.FilePart
+  | components.ToolResultPart
+  | components.ErrorPart;
+
+/**
+ * The A2A message to send to the agent (user input or tool results)
+ */
+export type A2AMessage = {
+  /**
+   * Optional A2A message ID in ULID format
+   */
+  messageId?: string | undefined;
+  /**
+   * Message role (user or tool for continuing executions)
+   */
+  role: RoleUserMessage | RoleToolMessage;
+  /**
+   * A2A message parts (text, file, or tool_result only). Note: Tool role messages must only contain tool_result parts.
+   */
+  parts: Array<
+    | components.TextPart
+    | components.FilePart
+    | components.ToolResultPart
+    | components.ErrorPart
+  >;
+};
+
+/**
+ * Information about the identity making the request. If the identity does not exist, it will be created automatically.
+ */
+export type Identity = {
+  /**
+   * Unique identifier for the contact
+   */
+  id: string;
+  /**
+   * Display name of the contact
+   */
+  displayName?: string | undefined;
+  /**
+   * Email address of the contact
+   */
+  email?: string | undefined;
+  /**
+   * A hash of key/value pairs containing any other data about the contact
+   */
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  /**
+   * URL to the contact's avatar or logo
+   */
+  logoUrl?: string | undefined;
+  /**
+   * A list of tags associated with the contact
+   */
+  tags?: Array<string> | undefined;
+};
+
+/**
+ * @deprecated Use identity instead. Information about the contact making the request.
+ *
+ * @deprecated class: This will be removed in a future release, please migrate away from it as soon as possible.
+ */
+export type Contact = {
+  /**
+   * Unique identifier for the contact
+   */
+  id: string;
+  /**
+   * Display name of the contact
+   */
+  displayName?: string | undefined;
+  /**
+   * Email address of the contact
+   */
+  email?: string | undefined;
+  /**
+   * A hash of key/value pairs containing any other data about the contact
+   */
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  /**
+   * URL to the contact's avatar or logo
+   */
+  logoUrl?: string | undefined;
+  /**
+   * A list of tags associated with the contact
+   */
+  tags?: Array<string> | undefined;
+};
+
+/**
+ * Thread information to group related requests
+ */
+export type CreateAgentResponseRequestThread = {
+  /**
+   * Unique thread identifier to group related invocations.
+   */
+  id: string;
+  /**
+   * Optional tags to differentiate or categorize threads
+   */
+  tags?: Array<string> | undefined;
+};
+
+/**
+ * Memory configuration for the agent execution. Used to associate memory stores with specific entities like users or sessions.
+ */
+export type Memory = {
+  /**
+   * An entity ID used to link memory stores to a specific user, session, or conversation. This ID is used to isolate and retrieve memories specific to the entity across agent executions.
+   */
+  entityId: string;
+};
+
+/**
+ * Override template engine for this invocation. If not provided, uses the agent default.
+ */
+export const CreateAgentResponseRequestEngine = {
+  Text: "text",
+  Jinja: "jinja",
+  Mustache: "mustache",
+} as const;
+/**
+ * Override template engine for this invocation. If not provided, uses the agent default.
+ */
+export type CreateAgentResponseRequestEngine = ClosedEnum<
+  typeof CreateAgentResponseRequestEngine
+>;
+
+/**
+ * Configuration options for the agent invocation
+ */
+export type Configuration = {
+  /**
+   * Whether to block until the agent task completes. When true, the response will include the full task with messages. When false (default), returns immediately with task ID and status.
+   */
+  blocking?: boolean | undefined;
+};
+
+/**
+ * Conversation context for chat studio integration
+ */
+export type Conversation = {
+  /**
+   * Unique ULID identifier for the conversation, prefixed with "conv_". Used to link agent executions to a specific conversation thread.
+   */
+  id: string;
+};
+
+export type CreateAgentResponseRequestRequestBody = {
+  /**
+   * Optional task ID to continue an existing agent execution. When provided, the agent will continue the conversation from the existing task state. The task must be in an inactive state to continue.
+   */
+  taskId?: string | undefined;
+  /**
+   * The A2A message to send to the agent (user input or tool results)
+   */
+  message: A2AMessage;
+  /**
+   * Optional variables for template replacement in system prompt, instructions, and messages
+   */
+  variables?: { [k: string]: any } | undefined;
+  /**
+   * Information about the identity making the request. If the identity does not exist, it will be created automatically.
+   */
+  identity?: Identity | undefined;
+  /**
+   * @deprecated Use identity instead. Information about the contact making the request.
+   *
+   * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
+   */
+  contact?: Contact | undefined;
+  /**
+   * Thread information to group related requests
+   */
+  thread?: CreateAgentResponseRequestThread | undefined;
+  /**
+   * Memory configuration for the agent execution. Used to associate memory stores with specific entities like users or sessions.
+   */
+  memory?: Memory | undefined;
+  /**
+   * Optional metadata for the agent invocation as key-value pairs that will be included in traces
+   */
+  metadata?: { [k: string]: any } | undefined;
+  /**
+   * Override template engine for this invocation. If not provided, uses the agent default.
+   */
+  engine?: CreateAgentResponseRequestEngine | undefined;
+  /**
+   * Configuration options for the agent invocation
+   */
+  configuration?: Configuration | undefined;
+  /**
+   * If true, returns immediately without waiting for completion. If false (default), waits until the agent becomes inactive or errors.
+   */
+  background?: boolean | undefined;
+  /**
+   * If true, returns Server-Sent Events (SSE) streaming response with real-time events. If false (default), returns standard JSON response.
+   */
+  stream?: boolean | undefined;
+  /**
+   * Conversation context for chat studio integration
+   */
+  conversation?: Conversation | undefined;
+};
+
+export type CreateAgentResponseRequestRequest = {
+  /**
+   * The unique key of identifier of the agent to invoke
+   */
+  agentKey: string;
+  requestBody: CreateAgentResponseRequestRequestBody;
+};
+
+/**
+ * Agent response successfully created and completed. Returns the full conversation including all messages, tool interactions, model used, and token usage statistics. In background mode, returns immediately with initial task details. In streaming mode, returns Server-Sent Events (SSE) with real-time events.
+ */
+export type CreateAgentResponseRequestResponseBody = {
+  /**
+   * Union of all possible streaming events. Each event has a type field for discrimination.
+   */
+  data?: components.ResponseStreamingEvent | undefined;
+};
+
+export type CreateAgentResponseRequestResponse =
+  | components.CreateAgentResponse
+  | EventStream<CreateAgentResponseRequestResponseBody>;
+
+/** @internal */
+export const RoleToolMessage$outboundSchema: z.ZodNativeEnum<
+  typeof RoleToolMessage
+> = z.nativeEnum(RoleToolMessage);
+
+/** @internal */
+export const RoleUserMessage$outboundSchema: z.ZodNativeEnum<
+  typeof RoleUserMessage
+> = z.nativeEnum(RoleUserMessage);
+
+/** @internal */
+export type CreateAgentResponseRequestRole$Outbound = string | string;
+
+/** @internal */
+export const CreateAgentResponseRequestRole$outboundSchema: z.ZodType<
+  CreateAgentResponseRequestRole$Outbound,
+  z.ZodTypeDef,
+  CreateAgentResponseRequestRole
+> = z.union([RoleUserMessage$outboundSchema, RoleToolMessage$outboundSchema]);
+
+export function createAgentResponseRequestRoleToJSON(
+  createAgentResponseRequestRole: CreateAgentResponseRequestRole,
+): string {
+  return JSON.stringify(
+    CreateAgentResponseRequestRole$outboundSchema.parse(
+      createAgentResponseRequestRole,
+    ),
+  );
+}
+
+/** @internal */
+export type PublicMessagePart$Outbound =
+  | components.TextPart$Outbound
+  | components.FilePart$Outbound
+  | components.ToolResultPart$Outbound
+  | components.ErrorPart$Outbound;
+
+/** @internal */
+export const PublicMessagePart$outboundSchema: z.ZodType<
+  PublicMessagePart$Outbound,
+  z.ZodTypeDef,
+  PublicMessagePart
+> = z.union([
+  components.TextPart$outboundSchema,
+  components.FilePart$outboundSchema,
+  components.ToolResultPart$outboundSchema,
+  components.ErrorPart$outboundSchema,
+]);
+
+export function publicMessagePartToJSON(
+  publicMessagePart: PublicMessagePart,
+): string {
+  return JSON.stringify(
+    PublicMessagePart$outboundSchema.parse(publicMessagePart),
+  );
+}
+
+/** @internal */
+export type A2AMessage$Outbound = {
+  messageId?: string | undefined;
+  role: string | string;
+  parts: Array<
+    | components.TextPart$Outbound
+    | components.FilePart$Outbound
+    | components.ToolResultPart$Outbound
+    | components.ErrorPart$Outbound
+  >;
+};
+
+/** @internal */
+export const A2AMessage$outboundSchema: z.ZodType<
+  A2AMessage$Outbound,
+  z.ZodTypeDef,
+  A2AMessage
+> = z.object({
+  messageId: z.string().optional(),
+  role: z.union([
+    RoleUserMessage$outboundSchema,
+    RoleToolMessage$outboundSchema,
+  ]),
+  parts: z.array(
+    z.union([
+      components.TextPart$outboundSchema,
+      components.FilePart$outboundSchema,
+      components.ToolResultPart$outboundSchema,
+      components.ErrorPart$outboundSchema,
+    ]),
+  ),
+});
+
+export function a2AMessageToJSON(a2AMessage: A2AMessage): string {
+  return JSON.stringify(A2AMessage$outboundSchema.parse(a2AMessage));
+}
+
+/** @internal */
+export type Identity$Outbound = {
+  id: string;
+  display_name?: string | undefined;
+  email?: string | undefined;
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  logo_url?: string | undefined;
+  tags?: Array<string> | undefined;
+};
+
+/** @internal */
+export const Identity$outboundSchema: z.ZodType<
+  Identity$Outbound,
+  z.ZodTypeDef,
+  Identity
+> = z.object({
+  id: z.string(),
+  displayName: z.string().optional(),
+  email: z.string().optional(),
+  metadata: z.array(z.record(z.any())).optional(),
+  logoUrl: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    displayName: "display_name",
+    logoUrl: "logo_url",
+  });
+});
+
+export function identityToJSON(identity: Identity): string {
+  return JSON.stringify(Identity$outboundSchema.parse(identity));
+}
+
+/** @internal */
+export type Contact$Outbound = {
+  id: string;
+  display_name?: string | undefined;
+  email?: string | undefined;
+  metadata?: Array<{ [k: string]: any }> | undefined;
+  logo_url?: string | undefined;
+  tags?: Array<string> | undefined;
+};
+
+/** @internal */
+export const Contact$outboundSchema: z.ZodType<
+  Contact$Outbound,
+  z.ZodTypeDef,
+  Contact
+> = z.object({
+  id: z.string(),
+  displayName: z.string().optional(),
+  email: z.string().optional(),
+  metadata: z.array(z.record(z.any())).optional(),
+  logoUrl: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    displayName: "display_name",
+    logoUrl: "logo_url",
+  });
+});
+
+export function contactToJSON(contact: Contact): string {
+  return JSON.stringify(Contact$outboundSchema.parse(contact));
+}
+
+/** @internal */
+export type CreateAgentResponseRequestThread$Outbound = {
+  id: string;
+  tags?: Array<string> | undefined;
+};
+
+/** @internal */
+export const CreateAgentResponseRequestThread$outboundSchema: z.ZodType<
+  CreateAgentResponseRequestThread$Outbound,
+  z.ZodTypeDef,
+  CreateAgentResponseRequestThread
+> = z.object({
+  id: z.string(),
+  tags: z.array(z.string()).optional(),
+});
+
+export function createAgentResponseRequestThreadToJSON(
+  createAgentResponseRequestThread: CreateAgentResponseRequestThread,
+): string {
+  return JSON.stringify(
+    CreateAgentResponseRequestThread$outboundSchema.parse(
+      createAgentResponseRequestThread,
+    ),
+  );
+}
+
+/** @internal */
+export type Memory$Outbound = {
+  entity_id: string;
+};
+
+/** @internal */
+export const Memory$outboundSchema: z.ZodType<
+  Memory$Outbound,
+  z.ZodTypeDef,
+  Memory
+> = z.object({
+  entityId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    entityId: "entity_id",
+  });
+});
+
+export function memoryToJSON(memory: Memory): string {
+  return JSON.stringify(Memory$outboundSchema.parse(memory));
+}
+
+/** @internal */
+export const CreateAgentResponseRequestEngine$outboundSchema: z.ZodNativeEnum<
+  typeof CreateAgentResponseRequestEngine
+> = z.nativeEnum(CreateAgentResponseRequestEngine);
+
+/** @internal */
+export type Configuration$Outbound = {
+  blocking: boolean;
+};
+
+/** @internal */
+export const Configuration$outboundSchema: z.ZodType<
+  Configuration$Outbound,
+  z.ZodTypeDef,
+  Configuration
+> = z.object({
+  blocking: z.boolean().default(false),
+});
+
+export function configurationToJSON(configuration: Configuration): string {
+  return JSON.stringify(Configuration$outboundSchema.parse(configuration));
+}
+
+/** @internal */
+export type Conversation$Outbound = {
+  _id: string;
+};
+
+/** @internal */
+export const Conversation$outboundSchema: z.ZodType<
+  Conversation$Outbound,
+  z.ZodTypeDef,
+  Conversation
+> = z.object({
+  id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    id: "_id",
+  });
+});
+
+export function conversationToJSON(conversation: Conversation): string {
+  return JSON.stringify(Conversation$outboundSchema.parse(conversation));
+}
+
+/** @internal */
+export type CreateAgentResponseRequestRequestBody$Outbound = {
+  task_id?: string | undefined;
+  message: A2AMessage$Outbound;
+  variables?: { [k: string]: any } | undefined;
+  identity?: Identity$Outbound | undefined;
+  contact?: Contact$Outbound | undefined;
+  thread?: CreateAgentResponseRequestThread$Outbound | undefined;
+  memory?: Memory$Outbound | undefined;
+  metadata?: { [k: string]: any } | undefined;
+  engine?: string | undefined;
+  configuration?: Configuration$Outbound | undefined;
+  background: boolean;
+  stream: boolean;
+  conversation?: Conversation$Outbound | undefined;
+};
+
+/** @internal */
+export const CreateAgentResponseRequestRequestBody$outboundSchema: z.ZodType<
+  CreateAgentResponseRequestRequestBody$Outbound,
+  z.ZodTypeDef,
+  CreateAgentResponseRequestRequestBody
+> = z.object({
+  taskId: z.string().optional(),
+  message: z.lazy(() => A2AMessage$outboundSchema),
+  variables: z.record(z.any()).optional(),
+  identity: z.lazy(() => Identity$outboundSchema).optional(),
+  contact: z.lazy(() => Contact$outboundSchema).optional(),
+  thread: z.lazy(() => CreateAgentResponseRequestThread$outboundSchema)
+    .optional(),
+  memory: z.lazy(() => Memory$outboundSchema).optional(),
+  metadata: z.record(z.any()).optional(),
+  engine: CreateAgentResponseRequestEngine$outboundSchema.optional(),
+  configuration: z.lazy(() => Configuration$outboundSchema).optional(),
+  background: z.boolean().default(false),
+  stream: z.boolean().default(false),
+  conversation: z.lazy(() => Conversation$outboundSchema).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    taskId: "task_id",
+  });
+});
+
+export function createAgentResponseRequestRequestBodyToJSON(
+  createAgentResponseRequestRequestBody: CreateAgentResponseRequestRequestBody,
+): string {
+  return JSON.stringify(
+    CreateAgentResponseRequestRequestBody$outboundSchema.parse(
+      createAgentResponseRequestRequestBody,
+    ),
+  );
+}
+
+/** @internal */
+export type CreateAgentResponseRequestRequest$Outbound = {
+  agent_key: string;
+  RequestBody: CreateAgentResponseRequestRequestBody$Outbound;
+};
+
+/** @internal */
+export const CreateAgentResponseRequestRequest$outboundSchema: z.ZodType<
+  CreateAgentResponseRequestRequest$Outbound,
+  z.ZodTypeDef,
+  CreateAgentResponseRequestRequest
+> = z.object({
+  agentKey: z.string(),
+  requestBody: z.lazy(() =>
+    CreateAgentResponseRequestRequestBody$outboundSchema
+  ),
+}).transform((v) => {
+  return remap$(v, {
+    agentKey: "agent_key",
+    requestBody: "RequestBody",
+  });
+});
+
+export function createAgentResponseRequestRequestToJSON(
+  createAgentResponseRequestRequest: CreateAgentResponseRequestRequest,
+): string {
+  return JSON.stringify(
+    CreateAgentResponseRequestRequest$outboundSchema.parse(
+      createAgentResponseRequestRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const CreateAgentResponseRequestResponseBody$inboundSchema: z.ZodType<
+  CreateAgentResponseRequestResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  data: z.string().optional().transform((v, ctx) => {
+    if (v === undefined) return undefined;
+    try {
+      return JSON.parse(v);
+    } catch (err) {
+      ctx.addIssue({ code: "custom", message: `malformed json: ${err}` });
+      return z.NEVER;
+    }
+  }).pipe(components.ResponseStreamingEvent$inboundSchema.optional()),
+});
+
+export function createAgentResponseRequestResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateAgentResponseRequestResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateAgentResponseRequestResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateAgentResponseRequestResponseBody' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateAgentResponseRequestResponse$inboundSchema: z.ZodType<
+  CreateAgentResponseRequestResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  components.CreateAgentResponse$inboundSchema,
+  z.instanceof(ReadableStream<Uint8Array>)
+    .transform(stream => {
+      return new EventStream(stream, rawEvent => {
+        if (rawEvent.data === "[DONE]") return { done: true, value: undefined };
+        return {
+          done: false,
+          value: z.lazy(() =>
+            CreateAgentResponseRequestResponseBody$inboundSchema
+          ).parse(rawEvent),
+        };
+      }, { dataRequired: false });
+    }),
+]);
+
+export function createAgentResponseRequestResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateAgentResponseRequestResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateAgentResponseRequestResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateAgentResponseRequestResponse' from JSON`,
+  );
+}