agentcore-sdk

Agent substrate: event schemas, identity, telemetry bridge, plugin registry

Part of the AumOS open-source agent infrastructure portfolio.

Features

• Canonical AgentEvent taxonomy (started, stopped, tool call, decision, cost incurred, and more) with full serde support and causal parent-event links
• Thread-safe in-process EventBus with type-scoped and global subscriptions, configurable history buffer, and exception-safe async dispatch
• AgentIdentity dataclass and IdentityRegistry for stable agent identity across restarts
• OpenTelemetry bridge that maps agent lifecycle events to OTel spans without requiring OTel to be installed
• YAML-driven config loader with Pydantic v2 validation and environment-variable override support
• Extensible plugin architecture via Python entry-points — implement AgentPlugin, declare an entry-point, and the registry auto-discovers your plugin at startup
• Adapters for LangChain and CrewAI that translate framework-native events into AgentEvent payloads

Quick Start

Install from PyPI:

pip install agentcore-sdk

Verify the installation:

agentcore-sdk version

Basic usage:

import agentcore

# See examples/01_quickstart.py for a working example

Documentation

• Architecture
• Contributing
• Changelog
• Examples

Enterprise Upgrade

For production deployments requiring SLA-backed support and advanced integrations, contact the maintainers or see the commercial extensions documentation.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

Apache 2.0 — see LICENSE for full terms.

Part of AumOS — open-source agent infrastructure.