Skip to main content

Interface: ILanguageService

Defined in: packages/agentos/src/core/language/interfaces.ts:132

High-level language orchestration service used by AgentOS runtime.

Methods

detectLanguages()

detectLanguages(text): Promise<DetectedLanguageResult[]>

Defined in: packages/agentos/src/core/language/interfaces.ts:137

Perform language detection across configured providers & merge results.

Parameters

text

string

Returns

Promise<DetectedLanguageResult[]>


initialize()

initialize(): Promise<void>

Defined in: packages/agentos/src/core/language/interfaces.ts:134

Initialize providers and internal caches.

Returns

Promise<void>


maybeNormalizeForPivot()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:143

Optional normalization before prompt construction (pivot).

Parameters

content

string

source

string

pivot?

string

Returns

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


maybeTranslateForDisplay()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:146

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

Parameters

content

string

source

string

target

string

Returns

Promise<TranslationResult | null>


negotiate()

negotiate(params): LanguageNegotiationResult

Defined in: packages/agentos/src/core/language/interfaces.ts:140

Determine target/pivot languages given negotiation inputs.

Parameters

params

LanguageNegotiationParams

Returns

LanguageNegotiationResult


shutdown()

shutdown(): Promise<void>

Defined in: packages/agentos/src/core/language/interfaces.ts:161

Graceful shutdown for providers.

Returns

Promise<void>


translateQueryForRag()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:149

Translate query for RAG pivot search.

Parameters

query

string

source

string

pivot

string

Returns

Promise<TranslationResult | null>


translateRagResults()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:152

Translate retrieved RAG results back to target language.

Parameters

results

object[]

target

string

Returns

Promise<object[]>


translateToolArguments()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:155

Wrap tool input translation logic.

Parameters

args

Record<string, any>

source

string

toolLanguage

string

Returns

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


translateToolResult()

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

Defined in: packages/agentos/src/core/language/interfaces.ts:158

Wrap tool result translation logic.

Parameters

result

any

source

string

target

string

Returns

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