@cortexkit/aft-bridge
Shared NDJSON transport, binary resolution, and ONNX runtime helpers used by AFT agent-host plugins (OpenCode, Pi, and future MCP-based hosts).
This package is not intended for direct end-user consumption — it powers
@cortexkit/aft-opencode
and @cortexkit/aft-pi.
What it owns
- Transport —
BinaryBridge(one persistentaftchild process),BridgePool(one bridge per canonical project root), wire envelope and push-frame types. - Binary resolution — versioned cache, npm platform package lookup, PATH / cargo fallback, GitHub release download with SHA-256 verification.
- ONNX runtime — auto-download for supported targets, install detection and version probing, manual-install hints for unsupported platforms.
What it does not own
Host-specific behaviour stays in the plugin packages:
- Configuration loading (each host has its own conventions and config paths).
- Permission UX (
ctx.ask()and prompt rendering belong to the host SDK). - Tool registration and rendering.
- Notifications, slash commands, and TUI integration.
- Session-ID lookup and per-request session injection.
Versioning
Released in lock-step with @cortexkit/aft-opencode and @cortexkit/aft-pi.
The bridge protocol is versioned end-to-end: a plugin running an older bridge
package will detect a newer aft binary and refuse to talk to it.