Bridge

This library is in flux. APIs may change without notice. Generated from source on 6/15/2026.

Resource Bridge Standard Library

bridge.kz

Resource Bridge Standard Library Persistent handle storage for long-running interactive sessions (Hollywood OS mode) DESIGN: - Bridge holds a HandlePool with persistent allocation - Multiple interpreter runs share the same bridge - Per-handle locking for concurrent access - No return values from runs - side effects accumulate on bridge - Session end triggers discharge_all

// ============================================================================
// CREATE - Create a new bridge session
// ============================================================================
~pub event create {
    id: []const u8
}
| session *Bridge<session!>

// ============================================================================
// GET_HANDLES - Query handles currently on the bridge
// ============================================================================
~pub event get-handles {
    br: *Bridge
}
| handles u32

// ============================================================================
// CLOSE - End a bridge session, discharge all handles
// ============================================================================
~pub event close {
    br: *Bridge<!session>
}
| closed u32

// ============================================================================
// TEST_RUN - Test helper: create bridge, run source, report handle count
// ============================================================================
~pub event test-run {
    source: []const u8,
    scope: []const u8,
    budget: u64
}
| pass u32
| fail []const u8