Skip to content

feat(vz-runner): bridge guest shims to the host broker - #641

Open
nappa85 wants to merge 1 commit into
fir-429-v3/03-vz-launch-contractfrom
fir-429-v3/04-vz-host-broker-bridge
Open

feat(vz-runner): bridge guest shims to the host broker#641
nappa85 wants to merge 1 commit into
fir-429-v3/03-vz-launch-contractfrom
fir-429-v3/04-vz-host-broker-bridge

Conversation

@nappa85

@nappa85 nappa85 commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Why

An isolated VZ guest cannot connect directly to the host Unix broker socket. The runner needs a lifecycle-owned VSOCK bridge that preserves custody and fails before boot when the upstream broker is unavailable.

What Changed

  • Add a VSOCK-to-Unix broker bridge plan and Virtualization.framework socket-device installation.
  • Preflight the host broker connection before VM startup.
  • Forward bytes bidirectionally without interpreting the broker protocol.
  • Reap completed connections during normal operation and shut down active workers with the VM.
  • Add forwarding, preflight, reaping, and teardown coverage.

Risks / Notes

  • Descriptor ownership and worker shutdown are security-sensitive lifecycle boundaries.
  • Virtualization.framework behavior still requires native macOS CI and runtime validation.

AI Assistance

Prepared with openai/gpt-5.6-sol.

@nappa85
nappa85 requested a review from a team September 7, 2026 11:32
@nappa85
nappa85 force-pushed the fir-429-v3/04-vz-host-broker-bridge branch 2 times, most recently from ee8971b to abb69e9 Compare September 7, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant