API Reference normandy v#0.6.2
View SourceModules
Wraps a remote A2A agent as a Normandy BaseTool.
Helpers for discovering remote A2A agents and registering them as tools.
Exposes Normandy agents as A2A-compatible endpoints.
Core agent implementation providing conversational AI capabilities.
Configuration structure for BaseAgent instances.
Default input schema for agent interactions.
Default output schema for agent responses.
Protocol for LLM model interactions.
Response schema for agent outputs that may include tool calls.
Validation middleware for BaseAgent input/output schemas.
Batch processing utilities for handling multiple agent requests concurrently.
Raised when a changeset can't cast a value.
Manages conversation memory for agents with support for turn-based tracking and optional message limits.
Protocol for schema serialization and representation.
Represents a document content block inside a multimodal message.
Represents an image content block inside a multimodal message.
Represents a text content block inside a multimodal message.
Protocol for providing additional context information to agents.
Context provider that supplies current date and time information to agents.
Represents a single message in agent conversation history.
Defines the structure of an agent's system prompt.
Represents a Server-Sent Event (SSE) from a streaming LLM response.
Utilities for processing streaming LLM responses.
Generates structured system prompts for agents from prompt specifications.
Represents a tool call request from the LLM.
Represents the result of executing a tool.
Handles conversation summarization for context window management.
Provides token counting utilities using the Anthropic token counting API.
Manages context window limits for conversations with automatic truncation strategies.
Message structure for agent-to-agent communication.
Pool manager for agent processes with automatic checkout/checkin.
GenServer wrapper for running BaseAgent instances as supervised processes.
Dynamic supervisor for managing agent processes.
Coordinates hierarchical multi-agent systems with manager-worker patterns.
Orchestrates parallel execution of multiple agents.
Pattern matching utilities for agent results.
Reactive patterns for event-driven multi-agent coordination.
Orchestrates sequential execution of multiple agents.
Manages shared context between multiple agents.
GenServer-backed shared context for multi-agent systems.
DSL for defining AI agents with a clean, declarative syntax.
DSL for defining multi-agent workflows with a declarative syntax.
Runs a list of Normandy.Guardrails.Guard modules against a value.
Rejects strings containing any of the configured forbidden substrings.
Rejects values whose string length exceeds :limit.
Rejects (or requires) regex matches against a string.
Rejects a struct or map when any of the named fields are nil.
Behaviour for guardrails that inspect agent input or output.
Exception raised when an input guardrail rejects an agent's input.
Raised when we cannot perform an action because the changeset is invalid.
Adapter for integrating Claudio (Anthropic's Claude API client) with Normandy agents.
JSON deserialization helper with automatic error recovery.
Helpers for discovering and registering MCP tools in a Normandy tool registry.
Configuration for server-side MCP servers passed to the Anthropic API.
Wraps an MCP tool as a Normandy BaseTool implementation.
Metadata attached to schema structs.
Parameterized types are Normandy types that can be customized per field.
Circuit Breaker pattern implementation to prevent cascading failures.
Retry mechanism with exponential backoff for handling transient failures.
Provides a macro-based DSL for defining structured data schemas.
Utilities for introspecting Normandy schemas at runtime.
Exception raised when schema validation fails.
Runtime validation of data against Normandy schemas.
Soft OpenTelemetry context propagation across process boundaries.
Protocol for implementing executable tools that agents can use.
A calculator tool for performing basic arithmetic operations.
Schema-based calculator tool demonstrating the new SchemaBaseTool approach.
A tool for processing lists with various operations.
A tool for performing string manipulation operations.
A weather tool that fetches current weather data from Open-Meteo API.
Executes tools safely with timeout and error handling.
Manages a collection of tools available to an agent.
Mixin module for creating tools with Normandy schema-based input definitions.
Defines functions and the Normandy.Type behaviour for implementing
basic custom types.
Provides changeset-style validation for schemas.