Skip to main content

LambdaA2aHandler

Struct LambdaA2aHandler 

Source
pub struct LambdaA2aHandler { /* private fields */ }
Expand description

Lambda handler wrapping the axum Router.

Implementations§

Source§

impl LambdaA2aHandler

Source

pub fn builder() -> LambdaA2aServerBuilder

Source

pub async fn cancel_idle_tasks(&self) -> Result<IdleSweep, A2aStorageError>

Cancel tasks left waiting on their client for longer than the runtime configuration’s idle_task_timeout; see turul_a2a::server::A2aServerBuilder::idle_task_timeout. With no timeout set this does nothing. Run by LambdaScheduledRecoveryHandler::with_idle_task_sweep.

Source

pub async fn handle(&self, event: Request) -> Result<Response<Body>, Error>

Handle a Lambda HTTP request. An executor still running when the response is ready (work after it reported its result) is aborted before this returns, so no storage request it started outlives the invocation.

Source

pub async fn handle_http_event_value( &self, value: Value, ) -> Result<Value, Error>

Handle a raw Lambda HTTP event delivered as serde_json::Value and return a response envelope matching the inbound event shape:

Inbound shape detected by lambda_http::LambdaRequestResponse envelope
API Gateway v1 (REST) — top-level httpMethod + pathApiGatewayProxyResponse
API Gateway v2 / Function URL — requestContext.httpApiGatewayV2httpResponse
ALB target group — requestContext.elbAlbTargetGroupResponse
WebSocket / unrecognisedErr(...)

Mismatching envelopes — most commonly a v2 response sent in response to a v1 invocation — cause API Gateway to return 502 Bad Gateway regardless of the body, because the response fails the gateway’s contract validation. This method ensures symmetry: response shape is always picked from the inbound shape, never hardcoded.

This is the framework’s canonical HTTP envelope conversion primitive — useful when a single Lambda function routes among HTTP and one or more non-framework triggers (EventBridge, DynamoDB streams, custom invoke) and the adopter drives lambda_runtime::run with serde_json::Value directly. Handles the LambdaRequest deserialization, the text-vs-base64 content-type detection, and the response envelope rebuild.

Body encoding: text for text/*, application/json, application/xml, application/javascript, any +json / +xml structured-syntax suffix (RFC 6839, e.g. application/a2a+json), or anything with charset=; base64 otherwise.

Path-prefix stripping (see LambdaA2aServerBuilder::strip_path_prefix) is applied because dispatch flows through Self::handle. Adopters who only serve HTTP should continue to use Self::run_http_only or LambdaA2aServerBuilder::run; this entry point exists for composition with adopter-owned third triggers.

Source§

impl LambdaA2aHandler

Source

pub async fn run_http_only(self) -> Result<(), Error>

Run this handler as a pure HTTP Lambda. Strict: any non-HTTP event shape (SQS, DynamoDB stream, scheduler, …) causes lambda_http::run to return a deserialization error on invocation.

Appropriate for Lambdas whose only trigger is a Function URL, API Gateway, or ALB. The request Lambda in the two-Lambda durable-executor topology is the canonical caller.

Source§

impl LambdaA2aHandler

Source

pub async fn run(self) -> Result<(), Error>

Default Lambda runner. Dispatches based on the event shape the binary receives. Without the sqs feature this is HTTP-only (equivalent to LambdaA2aHandler::run_http_only).

Trait Implementations§

Source§

impl Clone for LambdaA2aHandler

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromRef<T> for T
where T: Clone,

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
Source§

impl<A, B, T> HttpServerConnExec<A, B> for T
where B: Body,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more