Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
import i18n from '#/i18n/core'
import axios, { AxiosError } from 'axios'
import type { OvClientErrorOptions, OvErrorEnvelope, OvResponse } from './types'
const MAX_ERROR_TEXT_LENGTH = 2000
function isRecord(value: unknown): value is Record<string, unknown> {
return value !== null && typeof value === 'object' && !Array.isArray(value)
}
function truncateText(
value: unknown,
maxLength = MAX_ERROR_TEXT_LENGTH,
): string {
const text = String(value || '')
if (text.length <= maxLength) {
return text
}
return `${text.slice(0, maxLength)}\n${i18n.t('studio:errors.truncated', { count: text.length })}`
}
function withMissingApiKeyHint(code: string, message: string): string {
if (
code === 'UNAUTHENTICATED' &&
message.toLowerCase().includes('missing api key')
) {
return `${message} ${i18n.t('studio:errors.missingApiKeyHint')}`
}
return message
}
function getEnvelope(value: unknown): OvErrorEnvelope | undefined {
return isRecord(value) ? (value as OvErrorEnvelope) : undefined
}
function getRequestId(headers: unknown): string | undefined {
if (!isRecord(headers)) {
return undefined
}
const requestId = headers['x-request-id']
return typeof requestId === 'string' ? requestId : undefined
}
function hasResult(value: unknown): value is { result: unknown } {
return isRecord(value) && 'result' in value
}
function isResponseLike(value: unknown): value is OvResponse<unknown> {
return (
isRecord(value) &&
'data' in value &&
'headers' in value &&
'status' in value
)
}
export class OvClientError extends Error {
code: string
details?: unknown
requestId?: string
responseBody?: unknown
statusCode?: number
constructor(options: OvClientErrorOptions, cause?: unknown) {
super(
withMissingApiKeyHint(options.code, options.message),
cause ? { cause } : undefined,
)
this.name = 'OvClientError'
this.code = options.code
this.details = options.details
this.requestId = options.requestId
this.responseBody = options.responseBody
this.statusCode = options.statusCode
}
}
export function isOvClientError(error: unknown): error is OvClientError {
return error instanceof OvClientError
}
export function normalizeOvClientError(error: unknown): OvClientError {
if (error instanceof OvClientError) {
return error
}
if (axios.isAxiosError(error)) {
const axiosError = error as AxiosError<unknown>
const envelope = getEnvelope(axiosError.response?.data)
const statusCode = axiosError.response?.status
const rawBody = axiosError.response?.data
if (envelope?.error) {
const normalized = new OvClientError(
{
code: envelope.error.code || 'ERROR',
details: envelope.error.details ?? envelope.error.detail,
message:
envelope.error.message ||
i18n.t('studio:errors.httpStatus', { status: statusCode ?? i18n.t('studio:errors.unknown') }),
requestId: getRequestId(axiosError.response?.headers),
responseBody: rawBody,
statusCode,
},
axiosError,
)
normalized.stack = axiosError.stack ?? normalized.stack
return normalized
}
if (typeof rawBody === 'string' && rawBody.trim()) {
const normalized = new OvClientError(
{
code: 'HTTP_ERROR',
message: truncateText(rawBody),
requestId: getRequestId(axiosError.response?.headers),
responseBody: rawBody,
statusCode,
},
axiosError,
)
normalized.stack = axiosError.stack ?? normalized.stack
return normalized
}
const normalized = new OvClientError(
{
code:
axiosError.code === AxiosError.ERR_NETWORK
? 'NETWORK_ERROR'
: 'HTTP_ERROR',
message:
axiosError.message ||
i18n.t('studio:errors.httpStatus', { status: statusCode ?? i18n.t('studio:errors.unknown') }),
requestId: getRequestId(axiosError.response?.headers),
responseBody: rawBody,
statusCode,
},
axiosError,
)
normalized.stack = axiosError.stack ?? normalized.stack
return normalized
}
if (error instanceof Error) {
const normalized = new OvClientError(
{
code: 'UNKNOWN_ERROR',
message: error.message,
},
error,
)
normalized.stack = error.stack ?? normalized.stack
return normalized
}
return new OvClientError({
code: 'UNKNOWN_ERROR',
message: String(error),
})
}
export function unwrapOvResponse<TResult>(response: unknown): TResult {
if (!isResponseLike(response)) {
throw normalizeOvClientError(response)
}
const payload = response.data
const envelope = getEnvelope(payload)
if (envelope?.status === 'error') {
const error = envelope.error
throw new OvClientError({
code: error?.code || 'ERROR',
details: error?.details ?? error?.detail,
message: error?.message || i18n.t('studio:errors.requestFailed'),
requestId: getRequestId(response.headers),
responseBody: payload,
statusCode: response.status,
})
}
if (hasResult(payload)) {
return payload.result as TResult
}
return payload as TResult
}
export async function getOvResult<TResult>(
request: Promise<unknown>,
): Promise<TResult> {
try {
return unwrapOvResponse(await request)
} catch (error) {
throw normalizeOvClientError(error)
}
}