How maestroerror/laragent works
LarAgent is a Laravel framework for defining conversational AI agents. A user invokes an agent directly or through the documented OpenAI-compatible API; the agent prepares a request for a configured provider, supports tool calls and structured or multimodal interactions, and maintains conversation context and history. Context storage, truncation, events, and usage tracking provide supporting capabilities. The README documents broader features, but several implementations were not sampled, so their internal connections are not asserted here.
Main entry points: Agent.php Agent · Completions.php Completions · SingleAgentController.php Single-agent API · MultiAgentController.php Multi-agent API
Components 22
Agent runtime
- Agent
src/Agent.php - Agent tools
src/Tool.php - Message models
src/Messages/ToolCallMessage.php
API exposure
- Single-agent API
src/API/Completion/Controllers/SingleAgentController.php - Multi-agent API
src/API/Completion/Controllers/MultiAgentController.php - Completions
src/API/Completions.php
LLM providers
- Driver contract
src/Core/Contracts/LlmDriver.php - OpenAI drivers
src/Drivers/OpenAi/BaseOpenAiDriver.php - Provider drivers
src/Drivers/Anthropic/ClaudeDriver.php - Driver configuration
src/Core/DTO/DriverConfig.php
Context and memory
- Chat histories
src/History/InMemoryChatHistory.php - Context manager
src/Context/ContextManager.php - Session identity
src/Context/SessionIdentity.php - Identity storage
src/Context/Storages/IdentityStorage.php - Storage failover
src/Context/StorageManager.php - Storage drivers
src/Context/Drivers/CacheStorage.php - History truncation
src/Context/Truncation/SimpleTruncationStrategy.php
Agent capabilities
- Structured output
src/Core/Helpers/SchemaGenerator.php - Lifecycle events
src/Core/Traits/Events.php - Usage tracking
src/Usage/UsageStorage.php
Other components
- Application user
- LLM provider
Connections 22
- Application user → Agent: invokes
- Application user → Single-agent API: submits completion
- Application user → Multi-agent API: submits completion
- Single-agent API → Completions: delegates to
src/API/Completion/Controllers/SingleAgentController.php - Multi-agent API → Completions: delegates to
src/API/Completion/Controllers/MultiAgentController.php - Completions → Agent: uses
src/API/Completions.php - Agent → Driver contract: sends requests
src/Agent.php - Agent → Chat histories: maintains history
- Agent → Agent tools: offers tools
- Agent → Structured output: supports output schemas
- Agent → Message models: uses tool-call messages
src/Agent.php - Driver contract → LLM provider: sends prompts
src/Core/Contracts/LlmDriver.php - OpenAI drivers → LLM provider: calls provider
- Provider drivers → LLM provider: calls provider
- Driver configuration → OpenAI drivers: configures
src/Drivers/OpenAi/OpenAiDriver.php - Agent → Context manager: uses context
src/Agent.php - Agent → Session identity: creates identity
src/Agent.php - Agent → History truncation: supports truncation
src/Agent.php - Identity storage → Storage failover: persists identities
src/Context/Storages/IdentityStorage.php - Storage failover → Storage drivers: reads and writes
- Agent → Lifecycle events: dispatches lifecycle events
src/Core/Traits/Events.php - Agent → Usage tracking: tracks usage
src/Agent.php