Skip to main content

Windows implementation stack

The Windows Messaging application uses C++20, Win32 APIs and CMake/MSVC. Its Settings interface is HTML, CSS and JavaScript hosted inside a native WebView2 shell.

LayerImplementationOperational boundary
Application and CLINative C++ executablesRuns with the selected user's identity and filesystem access
Settings interfaceLocal HTML/JavaScript with a native request bridgeUI actions call native handlers; page content is not a provider
Web renderingSeparately installed system Evergreen WebView2The release does not redistribute the WebView2 runtime
Provider packagesNative workers plus declared plugin/extension/bridge assetsInstalled and versioned per provider
Shared host runtimeNative Core, Transport and provider componentsLocal runtime and remote enablement are distinct
Local controlOwner-scoped Windows IPC; applicable loopback interfacesA listening port alone is not authorization
Account protectionWindows protected account state and native helpersAxiOwl identity is separate from provider identity
DistributionSigned MSI and required companion mediaPlatform signing and per-component outcomes have separate meanings

User and service contexts​

A Windows service may run outside the interactive provider user's environment. Provider delivery must preserve that user's profile, native account, graphical session and conversation. Elevation or a service account does not make another user's provider session interchangeable.

The Settings network view reads local service state. Installation, configured service enablement and actual running state are separate columns; an unavailable configuration read must not fabricate a service result.

Optional network features​

The November 1 source defaults new A2A selections off and preserves existing explicit choices. Remote Connections and Relay are separately selected/enabled. The local IPC runtime can be necessary without a Relay internet connection. These source changes require matching built media; see release status.

Failure and recovery​

Installation attempts every selected integration, preserves verified siblings and reports incomplete integrations as warnings. Required media, signature/identity admission, elevation refusal, package-engine failure and cancellation remain blocking failures.

A provider hot update closes its selected application and confirms exit before changing owned assets. It retains signature/hash/descriptor checks. Provider login, extension activation and successful delivery are not proved by MSI completion.

Related references: local IPC, installation, credential storage, network inventory.