// Koru Standard Library: the `run` part of runtime.kz — the scoped
// run / run-cached events. Joined via `~part run` in runtime.kz.
~[retain] pub tor run {
    source: string,
    scope: string,
    budget: ?u64,
    handle_pool: ?*@import("root").koru_std.koru_interpreter.HandlePool,
    fail_fast: bool,
    auto_discharge: bool,
    shape: ?string,
    defined: ?*@import("root").koru_std.koru_interpreter.DefinedFlows,
    lenient: bool
}
| result {
    value: @import("root").koru_std.koru_interpreter.Value,
    used: u64,
    handles: u32
}
| unhandled-branch { branch: string, payload: string, handles: string }
| exhausted { used: u64, last_event: string, handles: u32 }
| parse-error { message: string, line: u32, column: u32 }
| validation-error string
| shape-error { branch: string, field: ?string, message: string }
| event-denied string
| dispatch-error { event_name: string, message: string }
| scope-not-found string

// RUN_CACHED - Parse and execute Koru source against a named scope with cached parsing
~pub tor run-cached {
    source: string,
    scope: string,
    budget: ?u64,
    handle_pool: ?*@import("root").koru_std.koru_interpreter.HandlePool,
    fail_fast: bool,
    auto_discharge: bool,
    shape: ?string,
    lenient: bool
}
| result {
    value: @import("root").koru_std.koru_interpreter.Value,
    used: u64,
    handles: u32
}
| unhandled-branch { branch: string, payload: string, handles: string }
| exhausted { used: u64, last_event: string, handles: u32 }
| parse-error { message: string, line: u32, column: u32 }
| validation-error string
| shape-error { branch: string, field: ?string, message: string }
| event-denied string
| dispatch-error { event_name: string, message: string }
| scope-not-found string