Skip to content

Interface: IVocabularyProvider

Makaio Framework


Makaio Framework / contracts / IVocabularyProvider

Defined in: ../../../packages/contracts/src/capabilities/voice/types.ts:198

Provides context-derived vocabulary terms for ASR bias.

Implementations extract terms from open files, codebase indexes, or agent/session metadata. Used by VoiceService to merge with user-managed vocabulary before transcription.

Register via the capability registry with capabilityId: 'voice-vocabulary' so VoiceService can discover and query all active providers at transcription time.

readonly capabilityId: "voice-vocabulary"

Defined in: ../../../packages/contracts/src/capabilities/voice/types.ts:200

Discriminant that identifies the vocabulary capability slot in the registry.


readonly displayName: string

Defined in: ../../../packages/contracts/src/capability/types.ts:11

Human-readable name for display in UI

ICapabilityProvider.displayName


readonly id: string

Defined in: ../../../packages/contracts/src/capability/types.ts:9

Unique identifier for this provider instance

ICapabilityProvider.id


readonly optional providerKey?: string

Defined in: ../../../packages/contracts/src/capability/types.ts:17

Stable provider identity used for joins across registries.

Unlike id, this should remain stable across runtime re-registration.

ICapabilityProvider.providerKey

getTerms(sessionId): Promise<string[]>

Defined in: ../../../packages/contracts/src/capabilities/voice/types.ts:207

Get vocabulary terms relevant to the current session context.

string

The active session

Promise<string[]>

Domain-specific terms to bias ASR toward


optional validate(): Promise<{ error?: string; valid: boolean; }>

Defined in: ../../../packages/contracts/src/capability/types.ts:22

Optional validation method to check provider configuration/credentials.

Promise<{ error?: string; valid: boolean; }>

Validation result with optional error message

ICapabilityProvider.validate