capabilities • AI Agent SDK

Runtime Capability System for PraisonAI Agents.

capabilities

AI Agent

Runtime Capability System for PraisonAI Agents.

Defines capability flags and validation logic to detect runtime incompatibilities at config/preflight time rather than during agent execution.

This addresses the issue where hooks, tools, streaming, and context compaction behave differently across native and plugin harness runtimes, causing users to discover incompatibilities mid-turn instead of at startup.

Import

python

from praisonaiagents.runtime import capabilities

Classes

RuntimeCapability

Enumeration of runtime capabilities that agents may require.

RuntimeCapabilityMatrix

Matrix of capabilities supported by a specific runtime implementation.

CapabilityValidationError

Raised when runtime capability validation fails.

Functions

validate_capabilities()

Validate that a runtime supports all required capabilities.

get_native_runtime_capabilities()

Get the capability matrix for the built-in native runtime.

get_reduced_harness_capabilities()

Get an example capability matrix for a reduced plugin harness.