// Koru Standard Library: the `run` part of runtime.kz — the scoped
// run / run-cached tors. 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,
    host_dispatch: ?@import("root").koru_std.koru_interpreter.HostDispatchFn,
    session_env: ?*@import("root").koru_std.koru_interpreter.Environment,
    session_bind_fn: ?@import("root").koru_std.koru_interpreter.SessionBindFn,
    session_bind_env: ?*@import("root").koru_std.koru_interpreter.Environment,
    session_bind_counter: ?*u64
}
| result {
    value: @import("root").koru_std.koru_interpreter.Value,
    used: u64,
    handles: u32,
    bound: string,
    trace: string
}
| 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, trace: string }
| scope-not-found string

// `run-cached` is `run` with parse reuse — identical contract, cached
// parsing for repeated source. Its proc rides in the `runcached` part.
~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,
    host_dispatch: ?@import("root").koru_std.koru_interpreter.HostDispatchFn,
    session_env: ?*@import("root").koru_std.koru_interpreter.Environment,
    session_bind_fn: ?@import("root").koru_std.koru_interpreter.SessionBindFn,
    session_bind_env: ?*@import("root").koru_std.koru_interpreter.Environment,
    session_bind_counter: ?*u64
}
| result {
    value: @import("root").koru_std.koru_interpreter.Value,
    used: u64,
    handles: u32,
    bound: string,
    trace: string
}
| 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, trace: string }
| scope-not-found string