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
status?
number
cause?
unknown
usage?
TokenUsage | null
unansweredAttempts?
number = 0
Returns
TranslationProviderError
Overrides
Error.constructor
Properties
cause?
readonlyoptionalcause:unknown
Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:235
The underlying error, when there was one.
code
readonlycode: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
readonlyproviderId: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?
optionalstack:string
Defined in: apps/agentos-live-docs/node_modules/typescript/lib/lib.es5.d.ts:1078
Inherited from
Error.stack
status?
readonlyoptionalstatus:number
Defined in: packages/agentos/src/cognition/nlp/language/interfaces.ts:233
The HTTP status the provider answered with, when it answered.
unansweredAttempts
readonlyunansweredAttempts: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
readonlyusage: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
staticstackTraceLimit: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()
staticcaptureStackTrace(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()
staticprepareStackTrace(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