Skip to main content

Class: LanguageService

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:45

High-level language orchestration service used by AgentOS runtime.

Implements​

Constructors​

Constructor​

new LanguageService(config): LanguageService

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:51

Parameters​

config​

AgentOSLanguageConfig

Returns​

LanguageService

Methods​

detectLanguages()​

detectLanguages(text): Promise<DetectedLanguageResult[]>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:86

Perform language detection across configured providers & merge results.

Parameters​

text​

string

Returns​

Promise<DetectedLanguageResult[]>

Implementation of​

ILanguageService.detectLanguages


initialize()​

initialize(): Promise<void>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:53

Initialize providers and internal caches.

Returns​

Promise<void>

Implementation of​

ILanguageService.initialize


maybeNormalizeForPivot()​

maybeNormalizeForPivot(content, source, pivot?): Promise<{ normalized: string; providerId?: string; } | null>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:147

Attempt pivot normalization of content (source->pivot) if pivot provided.

Parameters​

content​

string

source​

string

pivot?​

string

Returns​

Promise<{ normalized: string; providerId?: string; } | null>

Implementation of​

ILanguageService.maybeNormalizeForPivot


maybeTranslateForDisplay()​

maybeTranslateForDisplay(content, source, target): Promise<TranslationResult | null>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:154

Translate post-generation to user display target (if differs).

Parameters​

content​

string

source​

string

target​

string

Returns​

Promise<TranslationResult | null>

Implementation of​

ILanguageService.maybeTranslateForDisplay


negotiate()​

negotiate(params): LanguageNegotiationResult

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:103

Determine target/pivot languages given negotiation inputs.

Parameters​

params​

LanguageNegotiationParams

Returns​

LanguageNegotiationResult

Implementation of​

ILanguageService.negotiate


shutdown()​

shutdown(): Promise<void>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:201

Graceful shutdown for providers.

Returns​

Promise<void>

Implementation of​

ILanguageService.shutdown


translateQueryForRag()​

translateQueryForRag(query, source, pivot): Promise<TranslationResult | null>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:159

Translate query for RAG pivot search.

Parameters​

query​

string

source​

string

pivot​

string

Returns​

Promise<TranslationResult | null>

Implementation of​

ILanguageService.translateQueryForRag


translateRagResults()​

translateRagResults(results, target): Promise<object[]>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:164

Translate retrieved RAG results back to target language.

Parameters​

results​

object[]

target​

string

Returns​

Promise<object[]>

Implementation of​

ILanguageService.translateRagResults


translateToolArguments()​

translateToolArguments(args, source, toolLanguage): Promise<{ providerId?: string; translatedArgs: Record<string, any>; } | null>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:177

Wrap tool input translation logic.

Parameters​

args​

Record<string, any>

source​

string

toolLanguage​

string

Returns​

Promise<{ providerId?: string; translatedArgs: Record<string, any>; } | null>

Implementation of​

ILanguageService.translateToolArguments


translateToolResult()​

translateToolResult(result, source, target): Promise<{ providerId?: string; translatedResult: any; } | null>

Defined in: packages/agentos/src/cognition/nlp/language/LanguageService.ts:189

Wrap tool result translation logic.

Parameters​

result​

any

source​

string

target​

string

Returns​

Promise<{ providerId?: string; translatedResult: any; } | null>

Implementation of​

ILanguageService.translateToolResult