mirror of
https://github.com/BerriAI/litellm.git
synced 2026-09-23 00:41:40 +00:00
63d994ade4
Extracted from #41733 without the router loop, the cache machine layer, streaming, or the error, timeout and route-pruning work that moved to #41745 litellm-callbacks holds the contract a native call and its host share: Machine, HostOp, CallEvent, the in-process run loop, and Passthrough, which is built only by comparing the caller's inputs with the body the route sends, so a route can never mark a key it rewrote. litellm-host-python (formerly python-interop) owns the CPython driver and the Execution handle, and litellm-callbacks-legacy is the @client wrapper as the native call sees it: function_setup, the deployment hooks, pre_call and post_call, the success and failure fan-out and the deferred proxy release. OCR is the one route on it, and the old core and bridge lifecycles are gone The passthrough rule is the structural fix for the bug #41719 patched in core and #41716 reworks: an inlined remote document no longer counts as the caller's value, so the legacy adapter never hands the caller's URL back into the body. core/tests/ocr/passthrough.rs pins it for every route and document source, including that unchanged values stay passthrough, and callbacks-legacy/tests/payload.rs pins the adapter side with a real pre_call callback Python OCR integration tests that only exercised core behavior now live as Rust tests, so tests/test_litellm_rust keeps the cases that need the full Python stack
63 lines
1.7 KiB
Rust
63 lines
1.7 KiB
Rust
use std::future::Future;
|
|
use std::pin::Pin;
|
|
|
|
use crate::host::{HostOp, HostResult};
|
|
use crate::route::Route;
|
|
|
|
pub enum MachineStep<R: Route, C> {
|
|
Host(HostOp<R>),
|
|
Complete(C),
|
|
}
|
|
|
|
pub type Step<'a, M> = Pin<
|
|
Box<
|
|
dyn Future<
|
|
Output = Result<
|
|
MachineStep<<M as Machine>::Route, <M as Machine>::Complete>,
|
|
<<M as Machine>::Route as Route>::Error,
|
|
>,
|
|
> + Send
|
|
+ 'a,
|
|
>,
|
|
>;
|
|
|
|
pub type Interrupted<'a, M> = Pin<
|
|
Box<
|
|
dyn Future<
|
|
Output = Result<<M as Machine>::Complete, <<M as Machine>::Route as Route>::Error>,
|
|
> + Send
|
|
+ 'a,
|
|
>,
|
|
>;
|
|
|
|
#[derive(Clone, Debug, PartialEq, Eq)]
|
|
pub enum HostFailure<E> {
|
|
Error(E),
|
|
Cancelled(E),
|
|
}
|
|
|
|
impl<E> HostFailure<E> {
|
|
pub fn into_error(self) -> E {
|
|
match self {
|
|
Self::Error(error) | Self::Cancelled(error) => error,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// A resumable call. Core implements it per route; a host drives it. Every suspension
|
|
/// point is an op the host performs and answers with a result.
|
|
pub trait Machine: Send {
|
|
type Route: Route;
|
|
type Complete: Send + 'static;
|
|
|
|
/// `None` on the first call and whenever the previous step completed without
|
|
/// yielding an op; otherwise the result of the op last yielded.
|
|
fn resume(&mut self, result: Option<HostResult<Self::Route>>) -> Step<'_, Self>;
|
|
|
|
/// The host failed to perform the pending op, or the caller cancelled. The call
|
|
/// yields no further ops.
|
|
fn interrupt(
|
|
&mut self,
|
|
failure: HostFailure<<Self::Route as Route>::Error>,
|
|
) -> Interrupted<'_, Self>;
|
|
}
|