title: Modules and package owners description: Locate AIRI character modules and the packages that own configuration, conversation execution, rendering, and audio.

Modules and package owners

A module name describes one part of the character experience. It does not prove that the required provider or external service is available.

Most product module stores live under packages/stage-ui/src/stores/modules. Shared settings pages live under packages/stage-pages/src/pages/settings/modules.

Character modules

Module	Source file under `packages/stage-ui/src/stores/modules/`	What the source owns
Consciousness	`consciousness.ts`	Generation provider and model selections, model discovery state, and sampling selections
Hearing	`hearing.ts`	Transcription provider and model selections, audio-input orchestration, and optional automatic sending
Speech	`speech.ts`	Speech provider, model, voice selection, voice catalogs, and speech generation
AIRI card	`airi-card.ts`	Character information and relationships to module selections
External game settings	`gaming-minecraft.ts`, `gaming-factorio.ts`	Stage-side integration modules, not proof of a game process inside the browser

The Consciousness store considers its selection configured only when a provider and model are present. That condition does not prove an authenticated request can succeed.

Hearing and Speech are independent. Selecting a chat provider does not select a transcription provider or a voice. Hearing automatic sending defaults to disabled.

Speech defaults to the speech-noop provider. A silent stage can therefore reflect its selected configuration rather than an audio failure.

Supporting owners

The current provider stores are stores/providers/config.ts and stores/providers/provider.ts. There is no stores/providers.ts file at the reviewed revision.

The configuration store owns serializable provider records and local persistence. The provider store owns executable instances and inference-specific runtime state.

The display-model store is stores/display-models.ts. It records imported files, format identifiers, and optional previews. Its role is separate from character prompts and generation providers.

flowchart TD
    Card[AIRI card] --> Character[Character information]
    Card --> Selections[Module selections]
    Selections --> Thought[Consciousness]
    Selections --> Voice[Speech]
    Thought --> ProviderState[Provider state]
    Voice --> ProviderState
    Hearing[Hearing] --> ProviderState
    ProviderState --> Definitions[Portable provider definitions]
    Display[Display-model store] --> Renderer[Character renderer]

Find the right place for a change

For a provider definition or generation protocol, start with packages/provider-inference.
For saved provider configuration, start with packages/stage-ui/src/stores/providers/config.ts.
For conversation scheduling or tool rounds, start with packages/core-agent.
For a shared settings screen, start with packages/stage-pages and its stage-ui component.
For transcript buffering or playback scheduling, start with packages/pipelines-audio.
For a platform-specific feature, start with the relevant application shell.

These boundaries reduce duplicate policies across browser, desktop, and mobile applications. See architecture for the connections between them.

Incomplete surfaces remain incomplete

The long-term memory settings page renders a WIP component at the reviewed revision. Its route is not evidence of a complete memory product.

The repository also contains integration settings and development tools. A visible page or exported store is not an end-to-end acceptance result.

Read character-and-audio for assets and voice, providers-and-models for inference, and services-and-integrations for external processes.

Source context

Revision details and evidence limits are in provenance.

Navigation: index · architecture · workflows

Project AIRI

Explorer