# AI Agents OSSA

> OSSA v0.4.6 manifest bridge for Drupal AI agents

## What This Module Does

AI Agents OSSA bridges the Open Standard for Secure Agents (OSSA) specification
into Drupal's AI framework (drupal/ai, drupal/ai_agents). It provides:

- **Manifest Lifecycle**: Build, load, validate, register, discover, and execute
  OSSA agent manifests within Drupal.
- **Config Entities**: OssaAgent and OssaManifest config entities store validated
  manifests and derive AiAgent plugins automatically.
- **Field Mapper**: Bidirectional mapping between OSSA manifest fields and Drupal
  entity fields.
- **Capability Mapper**: Maps OSSA agent capabilities to Drupal FunctionCall/Tool
  plugins, enabling OSSA agents to use Drupal tools.
- **Validator**: JSON Schema validation against OSSA v0.4.x schemas with detailed
  error reporting.
- **REST API**: Endpoints for manifest CRUD and agent invocation.
- **ECA Integration**: 10 lifecycle events for agent orchestration workflows.
- **Tool Plugins**: DiscoverOssaAgents, ValidateOssaManifest, GenerateOssaManifest,
  CheckAgentPermissions.
- **Drush Commands**: ossa:validate, ossa:list, runtime:execute, runtime:status.

## Requirements

- Drupal 10.3+ or 11
- PHP 8.3+
- drupal/ai (^1.0@RC)
- drupal/ai_agents (^1.0@alpha)

## Links

- Project: https://www.drupal.org/project/ai_agents_ossa
- Issue queue: https://www.drupal.org/project/issues/ai_agents_ossa
- OSSA specification: https://openstandardagents.org
