Tracks active background tasks so the /ping endpoint can report PingStatus.HEALTHY_BUSY instead of PingStatus.HEALTHY, preventing the runtime from scaling the agent down while long-running work is in progress.

InvocationInput

sealed interface InvocationInput

Structured input handed to the unified invocation handler.

InvocationResult

sealed interface InvocationResult

Structured result of an invocation. Each variant maps to a specific HTTP response shape.

PingStatus

enum PingStatus : Enum<PingStatus>

Health status for AgentCore ping responses.

StaticAgentCorePingService

class StaticAgentCorePingService(taskTracker: AgentCoreTaskTracker) : AgentCorePingService

Default ping service that uses AgentCoreTaskTracker for busy detection.

TypedInvocationHandler

typealias TypedInvocationHandler<I, O> = suspend RoutingContext.(input: I, context: AgentCoreContext) -> O

Typed handler for invocation requests — convenience for the common JSON-in / JSON-out case.

UnifiedInvocationHandler

typealias UnifiedInvocationHandler = suspend RoutingContext.(input: InvocationInput, context: AgentCoreContext) -> InvocationResult

Unified handler for invocation requests — single entry point for all input/output shapes.

Functions

agentCoreRuntime

fun Route.agentCoreRuntime(configure: AgentCoreRuntimeConfig.() -> Unit): Route

Installs routes implementing the Amazon Bedrock AgentCore Runtime contract:

handle

inline fun <I : Any, O> AgentCoreRuntimeConfig.handle(crossinline handler: TypedInvocationHandler<I, O>)

Registers a typed invocation handler — convenience for JSON-in / JSON-out flows.

streamingBytesFlow

fun streamingBytesFlow(producer: suspend SendChannel<ByteArray>.() -> Unit): Flow<ByteArray>

Symmetric helper for binary streams used with InvocationResult.BinaryStream.

streamingFlow

fun streamingFlow(producer: suspend SendChannel<String>.() -> Unit): Flow<String>

Helper that builds a context-safe Flow<String> suitable for InvocationResult.TextStream.

toInvocationResult

fun ContentBlock.toInvocationResult(): InvocationResult

Converts a Bedrock ContentBlock (typically from a Converse/ConverseStream output message) into an InvocationResult suitable for an HTTP response.