@orq-ai/node 4.7.0-rc.58 → 4.7.3

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

@@ -0,0 +1,960 @@
+/*
+ * 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";
+
+export const CreateKnowledgeRequestBodyKnowledgeType = {
+  External: "external",
+} as const;
+export type CreateKnowledgeRequestBodyKnowledgeType = ClosedEnum<
+  typeof CreateKnowledgeRequestBodyKnowledgeType
+>;
+
+export type ExternalConfig = {
+  /**
+   * The name of the external knowledge base.
+   */
+  name: string;
+  /**
+   * The API URL of the external knowledge base.
+   */
+  apiUrl: string;
+  /**
+   * The API key to access the external knowledge base.
+   */
+  apiKey: string;
+};
+
+export type CreateKnowledgeRequestBody2 = {
+  type?: CreateKnowledgeRequestBodyKnowledgeType | undefined;
+  key: string;
+  description?: string | undefined;
+  externalConfig: ExternalConfig;
+};
+
+export const CreateKnowledgeRequestBodyType = {
+  Internal: "internal",
+} as const;
+export type CreateKnowledgeRequestBodyType = ClosedEnum<
+  typeof CreateKnowledgeRequestBodyType
+>;
+
+/**
+ * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+ */
+export const RetrievalType = {
+  VectorSearch: "vector_search",
+  KeywordSearch: "keyword_search",
+  HybridSearch: "hybrid_search",
+} as const;
+/**
+ * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+ */
+export type RetrievalType = ClosedEnum<typeof RetrievalType>;
+
+/**
+ * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+ */
+export type CreateKnowledgeRequestBodyRerankConfig = {
+  /**
+   * The number of results to return by the reranking model
+   */
+  topK?: number | undefined;
+  /**
+   * The threshold value used to filter the rerank results, only documents with a relevance score greater than the threshold will be returned
+   */
+  rerankThreshold?: number | undefined;
+  /**
+   * The rerank model to use for the knowledge base.
+   */
+  rerankModel: string;
+};
+
+/**
+ * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+ */
+export type CreateKnowledgeRequestBodyAgenticRagConfig = {
+  /**
+   * The model to use for the Agentic RAG
+   */
+  model: string;
+};
+
+/**
+ * The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.
+ */
+export type RetrievalSettings = {
+  /**
+   * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+   */
+  retrievalType?: RetrievalType | undefined;
+  /**
+   * The number of results to return from the search.
+   */
+  topK?: number | undefined;
+  /**
+   * The threshold value used to filter the search results, only documents with a relevance score greater than the threshold will be returned
+   */
+  threshold?: number | undefined;
+  /**
+   * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+   */
+  rerankConfig?: CreateKnowledgeRequestBodyRerankConfig | null | undefined;
+  /**
+   * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+   */
+  agenticRagConfig?:
+    | CreateKnowledgeRequestBodyAgenticRagConfig
+    | null
+    | undefined;
+};
+
+export type CreateKnowledgeRequestBody1 = {
+  type?: CreateKnowledgeRequestBodyType | undefined;
+  key: string;
+  description?: string | undefined;
+  /**
+   * The embeddings model to use for the knowledge base in the format "provider/model" for public models or "workspaceKey@provider/model" for private workspace models. This model will be used to embed the chunks when they are added to the knowledge base.
+   */
+  embeddingModel: string;
+  /**
+   * The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.
+   */
+  retrievalSettings?: RetrievalSettings | undefined;
+  /**
+   * Entity storage path in the format: `project/folder/subfolder/...`
+   *
+   * @remarks
+   *
+   * The first element identifies the project, followed by nested folders (auto-created as needed).
+   *
+   * With project-based API keys, the first element is treated as a folder name, as the project is predetermined by the API key.
+   */
+  path: string;
+};
+
+export type CreateKnowledgeRequestBody =
+  | CreateKnowledgeRequestBody1
+  | CreateKnowledgeRequestBody2;
+
+export const CreateKnowledgeResponseBodyKnowledgeType = {
+  External: "external",
+} as const;
+export type CreateKnowledgeResponseBodyKnowledgeType = ClosedEnum<
+  typeof CreateKnowledgeResponseBodyKnowledgeType
+>;
+
+/**
+ * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+ */
+export type CreateKnowledgeResponseBodyRerankConfig = {
+  /**
+   * The number of results to return by the reranking model
+   */
+  topK: number;
+  /**
+   * The threshold value used to filter the rerank results, only documents with a relevance score greater than the threshold will be returned
+   */
+  rerankThreshold: number;
+  /**
+   * The rerank model to use for the knowledge base.
+   */
+  rerankModel: string;
+};
+
+/**
+ * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+ */
+export type CreateKnowledgeResponseBodyAgenticRagConfig = {
+  /**
+   * The model to use for the Agentic RAG
+   */
+  model: string;
+};
+
+/**
+ * The retrieval settings for the knowledge base.
+ */
+export type CreateKnowledgeResponseBodyRetrievalSettings = {
+  /**
+   * The number of results to return from the search.
+   */
+  topK: number;
+  /**
+   * The threshold value used to filter the search results, only documents with a relevance score greater than the threshold will be returned
+   */
+  threshold: number;
+  /**
+   * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+   */
+  rerankConfig?: CreateKnowledgeResponseBodyRerankConfig | null | undefined;
+  /**
+   * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+   */
+  agenticRagConfig?:
+    | CreateKnowledgeResponseBodyAgenticRagConfig
+    | null
+    | undefined;
+};
+
+export type ResponseBodyExternalConfig = {
+  /**
+   * The name of the external knowledge base.
+   */
+  name: string;
+  /**
+   * The API URL of the external knowledge base.
+   */
+  apiUrl: string;
+};
+
+export type CreateKnowledgeResponseBody2 = {
+  /**
+   * The unique identifier of the knowledge base.
+   */
+  id: string;
+  /**
+   * The creation date of the knowledge base.
+   */
+  created: string;
+  /**
+   * The description of the knowledge base.
+   */
+  description?: string | undefined;
+  /**
+   * The unique key of the knowledge base.
+   */
+  key: string;
+  /**
+   * The project/domain ID of the knowledge base.
+   */
+  domainId: string;
+  /**
+   * Entity storage path in the format: `project/folder/subfolder/...`
+   *
+   * @remarks
+   *
+   * The first element identifies the project, followed by nested folders (auto-created as needed).
+   *
+   * With project-based API keys, the first element is treated as a folder name, as the project is predetermined by the API key.
+   */
+  path?: string | undefined;
+  createdById?: string | null | undefined;
+  updatedById?: string | null | undefined;
+  /**
+   * The last update date of the knowledge base.
+   */
+  updated: string;
+  type: CreateKnowledgeResponseBodyKnowledgeType;
+  /**
+   * The retrieval settings for the knowledge base.
+   */
+  retrievalSettings?: CreateKnowledgeResponseBodyRetrievalSettings | undefined;
+  externalConfig: ResponseBodyExternalConfig;
+};
+
+export const CreateKnowledgeResponseBodyType = {
+  Internal: "internal",
+} as const;
+export type CreateKnowledgeResponseBodyType = ClosedEnum<
+  typeof CreateKnowledgeResponseBodyType
+>;
+
+/**
+ * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+ */
+export const ResponseBodyRetrievalType = {
+  VectorSearch: "vector_search",
+  KeywordSearch: "keyword_search",
+  HybridSearch: "hybrid_search",
+} as const;
+/**
+ * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+ */
+export type ResponseBodyRetrievalType = ClosedEnum<
+  typeof ResponseBodyRetrievalType
+>;
+
+/**
+ * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+ */
+export type ResponseBodyRerankConfig = {
+  /**
+   * The number of results to return by the reranking model
+   */
+  topK: number;
+  /**
+   * The threshold value used to filter the rerank results, only documents with a relevance score greater than the threshold will be returned
+   */
+  rerankThreshold: number;
+  /**
+   * The rerank model to use for the knowledge base.
+   */
+  rerankModel: string;
+};
+
+/**
+ * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+ */
+export type ResponseBodyAgenticRagConfig = {
+  /**
+   * The model to use for the Agentic RAG
+   */
+  model: string;
+};
+
+/**
+ * The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.
+ */
+export type ResponseBodyRetrievalSettings = {
+  /**
+   * The retrieval type to use for the knowledge base. If not provided, Hybrid Search will be used as a default query strategy.
+   */
+  retrievalType: ResponseBodyRetrievalType;
+  /**
+   * The number of results to return from the search.
+   */
+  topK: number;
+  /**
+   * The threshold value used to filter the search results, only documents with a relevance score greater than the threshold will be returned
+   */
+  threshold: number;
+  /**
+   * The rerank configuration for the knowledge base. In case the model is provided it will be used to enhance the search precision.
+   */
+  rerankConfig?: ResponseBodyRerankConfig | null | undefined;
+  /**
+   * The Agentic RAG configuration for the knowledge base. If `null` is provided, Agentic RAG will be disabled.
+   */
+  agenticRagConfig?: ResponseBodyAgenticRagConfig | null | undefined;
+};
+
+export type CreateKnowledgeResponseBody1 = {
+  /**
+   * The unique identifier of the knowledge base.
+   */
+  id: string;
+  /**
+   * The creation date of the knowledge base.
+   */
+  created: string;
+  /**
+   * The description of the knowledge base.
+   */
+  description?: string | undefined;
+  /**
+   * The unique key of the knowledge base.
+   */
+  key: string;
+  /**
+   * The project/domain ID of the knowledge base.
+   */
+  domainId: string;
+  /**
+   * Entity storage path in the format: `project/folder/subfolder/...`
+   *
+   * @remarks
+   *
+   * The first element identifies the project, followed by nested folders (auto-created as needed).
+   *
+   * With project-based API keys, the first element is treated as a folder name, as the project is predetermined by the API key.
+   */
+  path?: string | undefined;
+  createdById?: string | null | undefined;
+  updatedById?: string | null | undefined;
+  /**
+   * The last update date of the knowledge base.
+   */
+  updated: string;
+  type: CreateKnowledgeResponseBodyType;
+  /**
+   * The retrieval settings for the knowledge base. If not provider, Hybrid Search will be used as a default query strategy.
+   */
+  retrievalSettings?: ResponseBodyRetrievalSettings | undefined;
+  /**
+   * The embeddings model used for the knowledge base.
+   */
+  model: string;
+};
+
+/**
+ * Knowledge successfully created
+ */
+export type CreateKnowledgeResponseBody =
+  | CreateKnowledgeResponseBody1
+  | CreateKnowledgeResponseBody2;
+
+/** @internal */
+export const CreateKnowledgeRequestBodyKnowledgeType$outboundSchema:
+  z.ZodNativeEnum<typeof CreateKnowledgeRequestBodyKnowledgeType> = z
+    .nativeEnum(CreateKnowledgeRequestBodyKnowledgeType);
+
+/** @internal */
+export type ExternalConfig$Outbound = {
+  name: string;
+  api_url: string;
+  api_key: string;
+};
+
+/** @internal */
+export const ExternalConfig$outboundSchema: z.ZodType<
+  ExternalConfig$Outbound,
+  z.ZodTypeDef,
+  ExternalConfig
+> = z.object({
+  name: z.string(),
+  apiUrl: z.string(),
+  apiKey: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    apiUrl: "api_url",
+    apiKey: "api_key",
+  });
+});
+
+export function externalConfigToJSON(externalConfig: ExternalConfig): string {
+  return JSON.stringify(ExternalConfig$outboundSchema.parse(externalConfig));
+}
+
+/** @internal */
+export type CreateKnowledgeRequestBody2$Outbound = {
+  type: string;
+  key: string;
+  description?: string | undefined;
+  external_config: ExternalConfig$Outbound;
+};
+
+/** @internal */
+export const CreateKnowledgeRequestBody2$outboundSchema: z.ZodType<
+  CreateKnowledgeRequestBody2$Outbound,
+  z.ZodTypeDef,
+  CreateKnowledgeRequestBody2
+> = z.object({
+  type: CreateKnowledgeRequestBodyKnowledgeType$outboundSchema.default(
+    "external",
+  ),
+  key: z.string(),
+  description: z.string().optional(),
+  externalConfig: z.lazy(() => ExternalConfig$outboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    externalConfig: "external_config",
+  });
+});
+
+export function createKnowledgeRequestBody2ToJSON(
+  createKnowledgeRequestBody2: CreateKnowledgeRequestBody2,
+): string {
+  return JSON.stringify(
+    CreateKnowledgeRequestBody2$outboundSchema.parse(
+      createKnowledgeRequestBody2,
+    ),
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeRequestBodyType$outboundSchema: z.ZodNativeEnum<
+  typeof CreateKnowledgeRequestBodyType
+> = z.nativeEnum(CreateKnowledgeRequestBodyType);
+
+/** @internal */
+export const RetrievalType$outboundSchema: z.ZodNativeEnum<
+  typeof RetrievalType
+> = z.nativeEnum(RetrievalType);
+
+/** @internal */
+export type CreateKnowledgeRequestBodyRerankConfig$Outbound = {
+  top_k: number;
+  rerank_threshold: number;
+  rerank_model: string;
+};
+
+/** @internal */
+export const CreateKnowledgeRequestBodyRerankConfig$outboundSchema: z.ZodType<
+  CreateKnowledgeRequestBodyRerankConfig$Outbound,
+  z.ZodTypeDef,
+  CreateKnowledgeRequestBodyRerankConfig
+> = z.object({
+  topK: z.number().int().default(5),
+  rerankThreshold: z.number().default(0.5),
+  rerankModel: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    topK: "top_k",
+    rerankThreshold: "rerank_threshold",
+    rerankModel: "rerank_model",
+  });
+});
+
+export function createKnowledgeRequestBodyRerankConfigToJSON(
+  createKnowledgeRequestBodyRerankConfig:
+    CreateKnowledgeRequestBodyRerankConfig,
+): string {
+  return JSON.stringify(
+    CreateKnowledgeRequestBodyRerankConfig$outboundSchema.parse(
+      createKnowledgeRequestBodyRerankConfig,
+    ),
+  );
+}
+
+/** @internal */
+export type CreateKnowledgeRequestBodyAgenticRagConfig$Outbound = {
+  model: string;
+};
+
+/** @internal */
+export const CreateKnowledgeRequestBodyAgenticRagConfig$outboundSchema:
+  z.ZodType<
+    CreateKnowledgeRequestBodyAgenticRagConfig$Outbound,
+    z.ZodTypeDef,
+    CreateKnowledgeRequestBodyAgenticRagConfig
+  > = z.object({
+    model: z.string(),
+  });
+
+export function createKnowledgeRequestBodyAgenticRagConfigToJSON(
+  createKnowledgeRequestBodyAgenticRagConfig:
+    CreateKnowledgeRequestBodyAgenticRagConfig,
+): string {
+  return JSON.stringify(
+    CreateKnowledgeRequestBodyAgenticRagConfig$outboundSchema.parse(
+      createKnowledgeRequestBodyAgenticRagConfig,
+    ),
+  );
+}
+
+/** @internal */
+export type RetrievalSettings$Outbound = {
+  retrieval_type: string;
+  top_k: number;
+  threshold: number;
+  rerank_config?:
+    | CreateKnowledgeRequestBodyRerankConfig$Outbound
+    | null
+    | undefined;
+  agentic_rag_config?:
+    | CreateKnowledgeRequestBodyAgenticRagConfig$Outbound
+    | null
+    | undefined;
+};
+
+/** @internal */
+export const RetrievalSettings$outboundSchema: z.ZodType<
+  RetrievalSettings$Outbound,
+  z.ZodTypeDef,
+  RetrievalSettings
+> = z.object({
+  retrievalType: RetrievalType$outboundSchema.default("hybrid_search"),
+  topK: z.number().int().default(5),
+  threshold: z.number().default(0),
+  rerankConfig: z.nullable(
+    z.lazy(() => CreateKnowledgeRequestBodyRerankConfig$outboundSchema),
+  ).optional(),
+  agenticRagConfig: z.nullable(
+    z.lazy(() => CreateKnowledgeRequestBodyAgenticRagConfig$outboundSchema),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    retrievalType: "retrieval_type",
+    topK: "top_k",
+    rerankConfig: "rerank_config",
+    agenticRagConfig: "agentic_rag_config",
+  });
+});
+
+export function retrievalSettingsToJSON(
+  retrievalSettings: RetrievalSettings,
+): string {
+  return JSON.stringify(
+    RetrievalSettings$outboundSchema.parse(retrievalSettings),
+  );
+}
+
+/** @internal */
+export type CreateKnowledgeRequestBody1$Outbound = {
+  type: string;
+  key: string;
+  description?: string | undefined;
+  embedding_model: string;
+  retrieval_settings?: RetrievalSettings$Outbound | undefined;
+  path: string;
+};
+
+/** @internal */
+export const CreateKnowledgeRequestBody1$outboundSchema: z.ZodType<
+  CreateKnowledgeRequestBody1$Outbound,
+  z.ZodTypeDef,
+  CreateKnowledgeRequestBody1
+> = z.object({
+  type: CreateKnowledgeRequestBodyType$outboundSchema.default("internal"),
+  key: z.string(),
+  description: z.string().optional(),
+  embeddingModel: z.string(),
+  retrievalSettings: z.lazy(() => RetrievalSettings$outboundSchema).optional(),
+  path: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    embeddingModel: "embedding_model",
+    retrievalSettings: "retrieval_settings",
+  });
+});
+
+export function createKnowledgeRequestBody1ToJSON(
+  createKnowledgeRequestBody1: CreateKnowledgeRequestBody1,
+): string {
+  return JSON.stringify(
+    CreateKnowledgeRequestBody1$outboundSchema.parse(
+      createKnowledgeRequestBody1,
+    ),
+  );
+}
+
+/** @internal */
+export type CreateKnowledgeRequestBody$Outbound =
+  | CreateKnowledgeRequestBody1$Outbound
+  | CreateKnowledgeRequestBody2$Outbound;
+
+/** @internal */
+export const CreateKnowledgeRequestBody$outboundSchema: z.ZodType<
+  CreateKnowledgeRequestBody$Outbound,
+  z.ZodTypeDef,
+  CreateKnowledgeRequestBody
+> = z.union([
+  z.lazy(() => CreateKnowledgeRequestBody1$outboundSchema),
+  z.lazy(() => CreateKnowledgeRequestBody2$outboundSchema),
+]);
+
+export function createKnowledgeRequestBodyToJSON(
+  createKnowledgeRequestBody: CreateKnowledgeRequestBody,
+): string {
+  return JSON.stringify(
+    CreateKnowledgeRequestBody$outboundSchema.parse(createKnowledgeRequestBody),
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBodyKnowledgeType$inboundSchema:
+  z.ZodNativeEnum<typeof CreateKnowledgeResponseBodyKnowledgeType> = z
+    .nativeEnum(CreateKnowledgeResponseBodyKnowledgeType);
+
+/** @internal */
+export const CreateKnowledgeResponseBodyRerankConfig$inboundSchema: z.ZodType<
+  CreateKnowledgeResponseBodyRerankConfig,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  top_k: z.number().int().default(5),
+  rerank_threshold: z.number().default(0.5),
+  rerank_model: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "top_k": "topK",
+    "rerank_threshold": "rerankThreshold",
+    "rerank_model": "rerankModel",
+  });
+});
+
+export function createKnowledgeResponseBodyRerankConfigFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateKnowledgeResponseBodyRerankConfig,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateKnowledgeResponseBodyRerankConfig$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateKnowledgeResponseBodyRerankConfig' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBodyAgenticRagConfig$inboundSchema:
+  z.ZodType<
+    CreateKnowledgeResponseBodyAgenticRagConfig,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    model: z.string(),
+  });
+
+export function createKnowledgeResponseBodyAgenticRagConfigFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateKnowledgeResponseBodyAgenticRagConfig,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateKnowledgeResponseBodyAgenticRagConfig$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateKnowledgeResponseBodyAgenticRagConfig' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBodyRetrievalSettings$inboundSchema:
+  z.ZodType<
+    CreateKnowledgeResponseBodyRetrievalSettings,
+    z.ZodTypeDef,
+    unknown
+  > = z.object({
+    top_k: z.number().int().default(5),
+    threshold: z.number().default(0),
+    rerank_config: z.nullable(
+      z.lazy(() => CreateKnowledgeResponseBodyRerankConfig$inboundSchema),
+    ).optional(),
+    agentic_rag_config: z.nullable(
+      z.lazy(() => CreateKnowledgeResponseBodyAgenticRagConfig$inboundSchema),
+    ).optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "top_k": "topK",
+      "rerank_config": "rerankConfig",
+      "agentic_rag_config": "agenticRagConfig",
+    });
+  });
+
+export function createKnowledgeResponseBodyRetrievalSettingsFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateKnowledgeResponseBodyRetrievalSettings,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateKnowledgeResponseBodyRetrievalSettings$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateKnowledgeResponseBodyRetrievalSettings' from JSON`,
+  );
+}
+
+/** @internal */
+export const ResponseBodyExternalConfig$inboundSchema: z.ZodType<
+  ResponseBodyExternalConfig,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  api_url: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "api_url": "apiUrl",
+  });
+});
+
+export function responseBodyExternalConfigFromJSON(
+  jsonString: string,
+): SafeParseResult<ResponseBodyExternalConfig, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResponseBodyExternalConfig$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResponseBodyExternalConfig' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBody2$inboundSchema: z.ZodType<
+  CreateKnowledgeResponseBody2,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _id: z.string(),
+  created: z.string(),
+  description: z.string().optional(),
+  key: z.string(),
+  domain_id: z.string(),
+  path: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
+  updated: z.string(),
+  type: CreateKnowledgeResponseBodyKnowledgeType$inboundSchema.default(
+    "external",
+  ),
+  retrieval_settings: z.lazy(() =>
+    CreateKnowledgeResponseBodyRetrievalSettings$inboundSchema
+  ).optional(),
+  external_config: z.lazy(() => ResponseBodyExternalConfig$inboundSchema),
+}).transform((v) => {
+  return remap$(v, {
+    "_id": "id",
+    "domain_id": "domainId",
+    "created_by_id": "createdById",
+    "updated_by_id": "updatedById",
+    "retrieval_settings": "retrievalSettings",
+    "external_config": "externalConfig",
+  });
+});
+
+export function createKnowledgeResponseBody2FromJSON(
+  jsonString: string,
+): SafeParseResult<CreateKnowledgeResponseBody2, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateKnowledgeResponseBody2$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateKnowledgeResponseBody2' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBodyType$inboundSchema: z.ZodNativeEnum<
+  typeof CreateKnowledgeResponseBodyType
+> = z.nativeEnum(CreateKnowledgeResponseBodyType);
+
+/** @internal */
+export const ResponseBodyRetrievalType$inboundSchema: z.ZodNativeEnum<
+  typeof ResponseBodyRetrievalType
+> = z.nativeEnum(ResponseBodyRetrievalType);
+
+/** @internal */
+export const ResponseBodyRerankConfig$inboundSchema: z.ZodType<
+  ResponseBodyRerankConfig,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  top_k: z.number().int().default(5),
+  rerank_threshold: z.number().default(0.5),
+  rerank_model: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "top_k": "topK",
+    "rerank_threshold": "rerankThreshold",
+    "rerank_model": "rerankModel",
+  });
+});
+
+export function responseBodyRerankConfigFromJSON(
+  jsonString: string,
+): SafeParseResult<ResponseBodyRerankConfig, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResponseBodyRerankConfig$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResponseBodyRerankConfig' from JSON`,
+  );
+}
+
+/** @internal */
+export const ResponseBodyAgenticRagConfig$inboundSchema: z.ZodType<
+  ResponseBodyAgenticRagConfig,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  model: z.string(),
+});
+
+export function responseBodyAgenticRagConfigFromJSON(
+  jsonString: string,
+): SafeParseResult<ResponseBodyAgenticRagConfig, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResponseBodyAgenticRagConfig$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResponseBodyAgenticRagConfig' from JSON`,
+  );
+}
+
+/** @internal */
+export const ResponseBodyRetrievalSettings$inboundSchema: z.ZodType<
+  ResponseBodyRetrievalSettings,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  retrieval_type: ResponseBodyRetrievalType$inboundSchema.default(
+    "hybrid_search",
+  ),
+  top_k: z.number().int().default(5),
+  threshold: z.number().default(0),
+  rerank_config: z.nullable(
+    z.lazy(() => ResponseBodyRerankConfig$inboundSchema),
+  ).optional(),
+  agentic_rag_config: z.nullable(
+    z.lazy(() => ResponseBodyAgenticRagConfig$inboundSchema),
+  ).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "retrieval_type": "retrievalType",
+    "top_k": "topK",
+    "rerank_config": "rerankConfig",
+    "agentic_rag_config": "agenticRagConfig",
+  });
+});
+
+export function responseBodyRetrievalSettingsFromJSON(
+  jsonString: string,
+): SafeParseResult<ResponseBodyRetrievalSettings, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResponseBodyRetrievalSettings$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResponseBodyRetrievalSettings' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBody1$inboundSchema: z.ZodType<
+  CreateKnowledgeResponseBody1,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  _id: z.string(),
+  created: z.string(),
+  description: z.string().optional(),
+  key: z.string(),
+  domain_id: z.string(),
+  path: z.string().optional(),
+  created_by_id: z.nullable(z.string()).optional(),
+  updated_by_id: z.nullable(z.string()).optional(),
+  updated: z.string(),
+  type: CreateKnowledgeResponseBodyType$inboundSchema.default("internal"),
+  retrieval_settings: z.lazy(() => ResponseBodyRetrievalSettings$inboundSchema)
+    .optional(),
+  model: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "_id": "id",
+    "domain_id": "domainId",
+    "created_by_id": "createdById",
+    "updated_by_id": "updatedById",
+    "retrieval_settings": "retrievalSettings",
+  });
+});
+
+export function createKnowledgeResponseBody1FromJSON(
+  jsonString: string,
+): SafeParseResult<CreateKnowledgeResponseBody1, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateKnowledgeResponseBody1$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateKnowledgeResponseBody1' from JSON`,
+  );
+}
+
+/** @internal */
+export const CreateKnowledgeResponseBody$inboundSchema: z.ZodType<
+  CreateKnowledgeResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => CreateKnowledgeResponseBody1$inboundSchema),
+  z.lazy(() => CreateKnowledgeResponseBody2$inboundSchema),
+]);
+
+export function createKnowledgeResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateKnowledgeResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateKnowledgeResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateKnowledgeResponseBody' from JSON`,
+  );
+}