internals library

AppPlayer Core — advanced integration barrel.

Exposes internal wiring components (connection/runtime/bundle/dashboard managers and dispatchers) so advanced hosts can construct custom flows that the public AppSession abstraction does not cover.

No semver guarantee. Anything exported here may change or be removed across minor versions. Prefer package:appplayer_core/appplayer_core.dart whenever possible.

Classes

ApplicationLoader

Discovers and loads application definitions from an MCP server (MOD-RUNTIME-002, FR-APP-001003, FR-APP-ONLINE-001005).

AppMetadataProvider

Fetches and publishes AppMetadata from Online / Local Bundle sources (MOD-RUNTIME-006, FR-META-001~005, UI DSL v1.2 §6.2).

BundleApplicationAdapter

Converts McpBundle into a runtime-ready ApplicationDefinition (MOD-BUNDLE-004, FR-APP-LOCAL-004~008).

BundleLoaderAdapter

Loads McpBundle objects from inline / remote / installed sources and validates schema and manifest (MOD-BUNDLE-001, FR-BUNDLE-001/004~010).

BundleResolver

Parses BundleManifest.entryPoint and validates type/entry compatibility (MOD-BUNDLE-002, FR-BUNDLE-002 / FR-APP-LOCAL-002~003).

BundleUriResolver

Resolves bundle:// URIs into runtime-consumable URIs (MOD-BUNDLE-003, FR-BUNDLE-003 / FR-APP-LOCAL-005, UI DSL v1.2 §5.3).

ConnectionManager

Manages MCP server connections: create, reuse, disconnect, reconnect, and notify listeners on state changes (MOD-CONN-001, FR-CONN-001~010).

DashboardBundleLoader

Loads dashboard bundles from market URL, inline, Aggregator server, or synthesizes a grid fallback (MOD-DASH-002, FR-DASH-001~003).

DashboardOrchestrator

Composes Dashboard Mode: loads a bundle, binds slots to devices, mounts each device's summary view (MOD-DASH-001, FR-DASH-001, 007~008).

HttpBundleFetcher

Host-injected fetcher for market/URL bundles.

NotificationRouter

Routes MCP server-initiated notifications into the runtime / host:

ResolvedBundleUri

Resolved target for a bundle:// URI (MOD-BUNDLE-003).

ResourceSubscriber

Handles MCP resource subscribe / unsubscribe, initial read, and runtime binding registration (MOD-RUNTIME-004, FR-RES-001~004).

RuntimeManager

Owns the lifecycle of per-AppHandle MCPUIRuntime instances (MOD-RUNTIME-001, FR-RUNTIME-001~004).

SlotBinder

Matches SlotDefinitions to concrete device IDs using their binding rules (MOD-DASH-003, FR-DASH-004).

SummaryViewResolver

Locates and parses a device's summary view definition (MOD-DASH-004, FR-DASH-005~006).

TenantResolver

Resolves app codes into TenantContext and guards allowlists (MOD-TENANT-001, FR-TENANT-001~006).

ToolDispatcher

Dispatches MCP tool calls and returns the parsed JSON response so the runtime can apply spec §3.10 auto-merge against its own state. Host responsibilities here are limited to MCP forwarding, listTools-based existence checks (for clearer error messaging), and exception modelling (MOD-RUNTIME-003, FR-TOOL-001~005).

TransportFactory

Translates ServerConfig into an mcp_client.TransportConfig (MOD-CONN-002, FR-CONN-009).

Typedefs

ClientConnector = Future<Client> Function(TransportConfig transport)

Abstraction over McpClient.createAndConnect to allow injection in tests.

McpLogMessageHandler = void Function(String serverId, Map<String, dynamic> params)

Callback invoked when a notifications/message (MCP logging spec) arrives. Hosts typically push the payload into a LogBuffer for the in-app log viewer.

PageLoader = Future<Map<String, dynamic>> Function(String uri)

Page-loader closure accepted by MCPUIRuntime.initialize.