Skip to main content

Class: TranslationProviderError

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:227

Thrown by a translation provider, and so by every LanguageService method that translates, when no translation came back. A provider never returns its input as the output of a failed call, so a caller that receives a TranslationResult holds a real translation, and a caller that wants to show the original line on failure catches this error and decides so.

Example​

try {
const res = await languageService.maybeTranslateForDisplay(line, 'en', 'es');
show(res?.output ?? line);
} catch (err) {
if (err instanceof TranslationProviderError) showUntranslated(line, err.code, err.status);
else throw err;
}

Extends​

  • Error

Constructors​

Constructor​

new TranslationProviderError(message, providerId, code, status?, cause?, usage?, unansweredAttempts?): TranslationProviderError

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:252

Parameters​

message​

string

providerId​

string

code​

TranslationErrorCode

status?​

number

cause?​

unknown

usage?​

TokenUsage | null

unansweredAttempts?​

number = 0

Returns​

TranslationProviderError

Overrides​

Error.constructor

Properties​

cause?​

readonly optional cause: unknown

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:235

The underlying error, when there was one.


code​

readonly code: TranslationErrorCode

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:229

TranslationErrorCode: what failed.


message​

message: string

Defined in: apps/agentos-live-docs/node_modules/typescript/lib/lib.es5.d.ts:1077

Inherited from​

Error.message


name​

name: string

Defined in: apps/agentos-live-docs/node_modules/typescript/lib/lib.es5.d.ts:1076

Inherited from​

Error.name


providerId​

readonly providerId: string

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:231

The id of the provider that failed, as configured (openai_chat, deepl).


stack?​

optional stack: string

Defined in: apps/agentos-live-docs/node_modules/typescript/lib/lib.es5.d.ts:1078

Inherited from​

Error.stack


status?​

readonly optional status: number

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:233

The HTTP status the provider answered with, when it answered.


unansweredAttempts​

readonly unansweredAttempts: number

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:250

The attempts of the call that got no usable answer before the one this error reports: no HTTP answer (a network failure, the provider layer's own timeout), or a success status whose body was lost while it was read. Each may have been billed for a whole answer nobody saw, so a caller records such a call at its bound rather than at usage or at nothing; 0 when every attempt was answered, and from every provider but the transcript translator.


usage​

readonly usage: TokenUsage | null

Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:242

The tokens the provider reported for an answer it billed and the translator refused (an empty answer, a length finish, an answer a filter stopped, a body the provider could not use), so the caller records what the failed call cost; null when no answer came back or the provider reported none.


stackTraceLimit​

static stackTraceLimit: number

Defined in: packages/agentos/node_modules/.pnpm/@types+node@22.20.5/node_modules/@types/node/globals.d.ts:68

The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by new Error().stack or Error.captureStackTrace(obj)).

The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.

If set to a non-number value, or set to a negative number, stack traces will not capture any frames.

Inherited from​

Error.stackTraceLimit

Methods​

captureStackTrace()​

static captureStackTrace(targetObject, constructorOpt?): void

Defined in: packages/agentos/node_modules/.pnpm/@types+node@22.20.5/node_modules/@types/node/globals.d.ts:52

Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack; // Similar to `new Error().stack`

The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

function a() {
b();
}

function b() {
c();
}

function c() {
// Create an error without stack trace to avoid calculating the stack trace twice.
const { stackTraceLimit } = Error;
Error.stackTraceLimit = 0;
const error = new Error();
Error.stackTraceLimit = stackTraceLimit;

// Capture the stack trace above function b
Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
throw error;
}

a();

Parameters​

targetObject​

object

constructorOpt?​

Function

Returns​

void

Inherited from​

Error.captureStackTrace


prepareStackTrace()​

static prepareStackTrace(err, stackTraces): any

Defined in: packages/agentos/node_modules/.pnpm/@types+node@22.20.5/node_modules/@types/node/globals.d.ts:56

Parameters​

err​

Error

stackTraces​

CallSite[]

Returns​

any

See​

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Inherited from​

Error.prepareStackTrace