From fc4b4be455e8a61ae203715f18673fbba60c2513 Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sat, 14 Feb 2026 16:58:12 +0000 Subject: [PATCH 1/7] Add project WIKI.md with overview and architecture docs --- papi-core/docs/WIKI.md | 63 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 papi-core/docs/WIKI.md diff --git a/papi-core/docs/WIKI.md b/papi-core/docs/WIKI.md new file mode 100644 index 0000000..4d1927b --- /dev/null +++ b/papi-core/docs/WIKI.md @@ -0,0 +1,63 @@ +# PapiAI Project Wiki + +## 1. Project Overview + +**PapiAI** is a modern, framework-agnostic PHP library designed for building robust AI agents. It provides a unified interface to interact with various Large Language Models (LLMs) like Anthropic Claude and Google Gemini, making it easy to integrate AI capabilities into any PHP application (Laravel, Symfony, or standalone). + +### Key Philosophy +- **Simplicity**: Clean, intuitive API for creating agents. +- **Type Safety**: Built on PHP 8.2+ with strict typing. +- **Modularity**: Core logic is separated from specific provider implementations. + +## 2. Architecture + +The project is structured around a few key abstractions: + +### Core Components (`papi-ai/papi-core`) +- **Agent**: The main entry point. It orchestrates interactions between the user, the LLM provider, and available tools. +- **ProviderInterface**: The contract that all LLM providers must implement. It standardizes: + - `chat()`: Standard request/response. + - `stream()`: Real-time streaming responses. + - Capabilities: `supportsTool()`, `supportsVision()`, `supportsStructuredOutput()`. +- **Tool**: encapsulations of functions or class methods that the AI can "call" to perform actions (e.g., fetching weather, querying a database). +- **Schema**: A fluent builder (Zod-like) for defining structured output requirements, ensuring the AI returns data in a predictable format. + +### Providers +Specific implementations are handled in separate packages to keep the core lightweight: +- `papi-ai/anthropic`: Adapter for Anthropic's Claude models. +- `papi-ai/google`: Adapter for Google's Gemini models. +- `papi-ai/openai`: (Planned/In-progress) Adapter for OpenAI. + +## 3. Getting Started + +### Installation +Install the core package and your desired provider: + +```bash +composer require papi-ai/core +composer require papi-ai/anthropic +``` + +### Basic Usage +Here is how to create a simple agent using Claude: + +```php +use PapiAI\Core\Agent; +use PapiAI\Anthropic\AnthropicProvider; + +$agent = new Agent( + provider: new AnthropicProvider(apiKey: $_ENV['ANTHROPIC_API_KEY']), + model: 'claude-3-5-sonnet-20240620', + instructions: 'You are a helpful coding assistant.' +); + +$response = $agent->run('Refactor this class for me...'); +echo $response->text; +``` + +## 4. Advanced Features + +- **Tool Calling**: Define PHP functions or class methods as tools. The Agent handles the LLM's request to execute them. +- **Structured Output**: Enforce JSON schemas on responses for reliable data extraction. +- **Streaming**: Subscribe to event streams for real-time UI updates. +- **Observability**: Hooks available for logging and monitoring agent performance. From 3e59c4b46e5a6afb9178ae3f2b2a95ea431a2cee Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sat, 14 Feb 2026 17:08:01 +0000 Subject: [PATCH 2/7] Add project wiki and roadmap to docs --- docs/wiki.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/wiki.md diff --git a/docs/wiki.md b/docs/wiki.md new file mode 100644 index 0000000..076be9a --- /dev/null +++ b/docs/wiki.md @@ -0,0 +1,30 @@ +# Project Overview + +**PapiAI Core** is a framework-agnostic, type-safe PHP library designed for building robust AI agents. It abstracts the complexity of interacting with various LLM providers (like Anthropic and Google) while offering powerful features such as tool calling, structured output validation via Zod-like schemas, and event-driven streaming. Built for PHP 8.2+, it serves as a lightweight foundation for integrating AI capabilities into any PHP application, from simple scripts to complex Laravel or Symfony projects. + +# Roadmap + +### Phase 1: Foundation (Current) +- [x] Core Agent & Tool architecture +- [x] Type-safe Schema validation +- [x] Provider interface abstraction +- [x] Anthropic (Claude) integration +- [x] Google (Gemini) integration +- [x] Event-driven streaming support + +### Phase 2: Expansion (Short-term) +- [ ] **OpenAI Integration**: Full support for GPT-4o and other OpenAI models. +- [ ] **Memory Management**: Standardized interfaces for conversation history (Redis, Database adapters). +- [ ] **Resilience**: Built-in retry mechanisms and rate-limit handling. +- [ ] **Documentation**: Comprehensive guides and API references. + +### Phase 3: Advanced Capabilities (Mid-term) +- [ ] **Middleware System**: Hooks for logging, cost tracking, and content filtering. +- [ ] **Vector Store Integration**: Native support for RAG (Retrieval-Augmented Generation). +- [ ] **CLI Tooling**: Scaffolding commands for generating agents and tools. +- [ ] **Local LLM Support**: Integration with Ollama and local inference servers. + +### Phase 4: Ecosystem (Long-term) +- [ ] **Multi-Agent Orchestration**: Patterns for agents working in teams. +- [ ] **Async Runtime**: Optimized support for Swoole/ReactPHP/Amp. +- [ ] **Visual Builder**: UI tools for designing agent workflows. From 6b4ef0eb4dbaceba0b4eb95ecd0f63be3dfb377a Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sat, 14 Feb 2026 17:14:35 +0000 Subject: [PATCH 3/7] Add project wiki and roadmap documentation --- docs/wiki.md | 54 ++++++++++++++++++++++++++++------------------------ 1 file changed, 29 insertions(+), 25 deletions(-) diff --git a/docs/wiki.md b/docs/wiki.md index 076be9a..9d865a5 100644 --- a/docs/wiki.md +++ b/docs/wiki.md @@ -1,30 +1,34 @@ # Project Overview -**PapiAI Core** is a framework-agnostic, type-safe PHP library designed for building robust AI agents. It abstracts the complexity of interacting with various LLM providers (like Anthropic and Google) while offering powerful features such as tool calling, structured output validation via Zod-like schemas, and event-driven streaming. Built for PHP 8.2+, it serves as a lightweight foundation for integrating AI capabilities into any PHP application, from simple scripts to complex Laravel or Symfony projects. +**PapiAI Core** is a framework-agnostic, type-safe PHP (8.2+) library designed for building robust AI agents. It serves as a foundational layer that abstracts the complexities of interacting with various LLM providers while offering powerful features like: + +* **Multi-Provider Support:** Seamless integration with Anthropic (Claude) and Google (Gemini), with more on the way. +* **Tool Calling:** flexible definition of tools using closures or class-based attributes. +* **Structured Output:** Strong validation of LLM responses using a Zod-like schema builder. +* **Event-Driven Streaming:** First-class support for streaming responses and events. +* **Observability:** Built-in hooks for logging, metrics, and error handling. + +It is designed to be lightweight and easily embeddable into any PHP project, whether it's a standalone script, a Laravel application, or a Symfony service. # Roadmap -### Phase 1: Foundation (Current) -- [x] Core Agent & Tool architecture -- [x] Type-safe Schema validation -- [x] Provider interface abstraction -- [x] Anthropic (Claude) integration -- [x] Google (Gemini) integration -- [x] Event-driven streaming support - -### Phase 2: Expansion (Short-term) -- [ ] **OpenAI Integration**: Full support for GPT-4o and other OpenAI models. -- [ ] **Memory Management**: Standardized interfaces for conversation history (Redis, Database adapters). -- [ ] **Resilience**: Built-in retry mechanisms and rate-limit handling. -- [ ] **Documentation**: Comprehensive guides and API references. - -### Phase 3: Advanced Capabilities (Mid-term) -- [ ] **Middleware System**: Hooks for logging, cost tracking, and content filtering. -- [ ] **Vector Store Integration**: Native support for RAG (Retrieval-Augmented Generation). -- [ ] **CLI Tooling**: Scaffolding commands for generating agents and tools. -- [ ] **Local LLM Support**: Integration with Ollama and local inference servers. - -### Phase 4: Ecosystem (Long-term) -- [ ] **Multi-Agent Orchestration**: Patterns for agents working in teams. -- [ ] **Async Runtime**: Optimized support for Swoole/ReactPHP/Amp. -- [ ] **Visual Builder**: UI tools for designing agent workflows. +## Phase 1: Foundation (Completed) +* [x] Core Agent and Provider architecture +* [x] Anthropic and Google provider implementations +* [x] Tool calling and execution logic +* [x] Structured output parsing and validation +* [x] Basic event-driven streaming + +## Phase 2: Capabilities & Resilience (Short-term) +* [ ] **OpenAI Integration:** Add support for GPT-4 and other OpenAI models. +* [ ] **Memory Management:** Implement flexible memory stores (Redis, Database) to maintain conversation context. +* [ ] **Resilience:** Add built-in retry mechanisms, rate-limiting handling, and circuit breakers. + +## Phase 3: Expansion (Mid-term) +* [ ] **Middleware Pipeline:** Allow intercepting and modifying requests/responses globally. +* [ ] **RAG Integration:** Native support for Vector Stores to enable Retrieval-Augmented Generation. +* [ ] **CLI Tooling:** A dedicated CLI for scaffolding agents and testing prompts. + +## Phase 4: Advanced Orchestration (Long-term) +* [ ] **Multi-Agent Systems:** Patterns and tools for coordinating multiple agents working together. +* [ ] **Async Runtime:** Better support for asynchronous execution environments (e.g., Swoole, Amphp). From a7ba961f6648ad1f83e48184eac55c67a5079479 Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sat, 14 Feb 2026 17:19:00 +0000 Subject: [PATCH 4/7] Docs: Add Project Wiki and Roadmap v2 --- docs/wiki.md | 59 ++++++++++++++++++++++------------------------------ 1 file changed, 25 insertions(+), 34 deletions(-) diff --git a/docs/wiki.md b/docs/wiki.md index 9d865a5..3802fe8 100644 --- a/docs/wiki.md +++ b/docs/wiki.md @@ -1,34 +1,25 @@ -# Project Overview - -**PapiAI Core** is a framework-agnostic, type-safe PHP (8.2+) library designed for building robust AI agents. It serves as a foundational layer that abstracts the complexities of interacting with various LLM providers while offering powerful features like: - -* **Multi-Provider Support:** Seamless integration with Anthropic (Claude) and Google (Gemini), with more on the way. -* **Tool Calling:** flexible definition of tools using closures or class-based attributes. -* **Structured Output:** Strong validation of LLM responses using a Zod-like schema builder. -* **Event-Driven Streaming:** First-class support for streaming responses and events. -* **Observability:** Built-in hooks for logging, metrics, and error handling. - -It is designed to be lightweight and easily embeddable into any PHP project, whether it's a standalone script, a Laravel application, or a Symfony service. - -# Roadmap - -## Phase 1: Foundation (Completed) -* [x] Core Agent and Provider architecture -* [x] Anthropic and Google provider implementations -* [x] Tool calling and execution logic -* [x] Structured output parsing and validation -* [x] Basic event-driven streaming - -## Phase 2: Capabilities & Resilience (Short-term) -* [ ] **OpenAI Integration:** Add support for GPT-4 and other OpenAI models. -* [ ] **Memory Management:** Implement flexible memory stores (Redis, Database) to maintain conversation context. -* [ ] **Resilience:** Add built-in retry mechanisms, rate-limiting handling, and circuit breakers. - -## Phase 3: Expansion (Mid-term) -* [ ] **Middleware Pipeline:** Allow intercepting and modifying requests/responses globally. -* [ ] **RAG Integration:** Native support for Vector Stores to enable Retrieval-Augmented Generation. -* [ ] **CLI Tooling:** A dedicated CLI for scaffolding agents and testing prompts. - -## Phase 4: Advanced Orchestration (Long-term) -* [ ] **Multi-Agent Systems:** Patterns and tools for coordinating multiple agents working together. -* [ ] **Async Runtime:** Better support for asynchronous execution environments (e.g., Swoole, Amphp). +# PapiAI Core - Project Wiki + +## Project Overview +PapiAI Core is a framework-agnostic, type-safe PHP 8.2+ library designed to simplify the creation of AI agents. It provides a robust abstraction layer over various LLM providers (currently supporting Anthropic Claude and Google Gemini), enabling developers to build agentic workflows with structured outputs, tool calling, and event-driven streaming without being tied to a specific framework like Laravel or Symfony. The goal is to offer a lightweight yet powerful foundation for integrating AI capabilities into any PHP application. + +## Roadmap + +### Phase 1: Foundation (Current) +- [x] Core Agent and Tool architecture +- [x] Provider abstractions (Anthropic, Google) +- [x] Type-safe Schema definitions for structured output +- [x] Event-driven streaming support +- [x] Basic observability hooks + +### Phase 2: Expansion (Next) +- [ ] OpenAI Provider integration +- [ ] Conversation History and Memory management +- [ ] Middleware support for request/response modification +- [ ] Enhanced error handling and retry mechanisms + +### Phase 3: Advanced Features +- [ ] Multi-agent orchestration and delegation +- [ ] Vector database integration for RAG (Retrieval-Augmented Generation) +- [ ] CLI tools for scaffolding agents and tools +- [ ] Pre-built toolkits for common APIs (GitHub, Slack, etc.) From 15c30f166f7a9713e64248729988a0976487ec2b Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sun, 15 Feb 2026 08:30:46 +0000 Subject: [PATCH 5/7] Docs: Add project wiki and roadmap --- docs/wiki.md | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/docs/wiki.md b/docs/wiki.md index 3802fe8..9f8035d 100644 --- a/docs/wiki.md +++ b/docs/wiki.md @@ -1,25 +1,28 @@ -# PapiAI Core - Project Wiki +# PapiAI Project Wiki ## Project Overview -PapiAI Core is a framework-agnostic, type-safe PHP 8.2+ library designed to simplify the creation of AI agents. It provides a robust abstraction layer over various LLM providers (currently supporting Anthropic Claude and Google Gemini), enabling developers to build agentic workflows with structured outputs, tool calling, and event-driven streaming without being tied to a specific framework like Laravel or Symfony. The goal is to offer a lightweight yet powerful foundation for integrating AI capabilities into any PHP application. +PapiAI Core is a professional, type-safe PHP library designed for building robust AI agents. It decouples the agent logic from specific LLM providers, allowing developers to switch between Anthropic (Claude), Google (Gemini), and others with ease. It focuses on developer experience with strict typing (PHP 8.2+), intuitive interfaces for tool calling, and structured data extraction. + +## Architecture +The library is built around a few key components: +- **Agent**: The main orchestrator that manages context, instructions, and the conversation loop. +- **Provider**: An interface for LLM backends (e.g., `AnthropicProvider`, `GoogleProvider`). +- **Tool**: Encapsulates capabilities the agent can use, definable via closures or class attributes. +- **Schema**: A fluent builder for defining structured output expectations (Zod-like). ## Roadmap ### Phase 1: Foundation (Current) -- [x] Core Agent and Tool architecture -- [x] Provider abstractions (Anthropic, Google) -- [x] Type-safe Schema definitions for structured output -- [x] Event-driven streaming support -- [x] Basic observability hooks +- Core architecture (Agent, Provider, Tool, Schema). +- Support for Anthropic Claude and Google Gemini. +- Event-driven streaming and observability hooks. ### Phase 2: Expansion (Next) -- [ ] OpenAI Provider integration -- [ ] Conversation History and Memory management -- [ ] Middleware support for request/response modification -- [ ] Enhanced error handling and retry mechanisms +- **OpenAI Integration**: Add support for GPT-4o and o1 models. +- **Memory Systems**: Abstract persistence layers for conversation history (Redis, SQL). +- **RAG Support**: Simple interfaces for vector store retrieval. -### Phase 3: Advanced Features -- [ ] Multi-agent orchestration and delegation -- [ ] Vector database integration for RAG (Retrieval-Augmented Generation) -- [ ] CLI tools for scaffolding agents and tools -- [ ] Pre-built toolkits for common APIs (GitHub, Slack, etc.) +### Phase 3: Advanced Capabilities +- **Multi-Agent Systems**: Patterns for agent delegation and collaboration. +- **Framework Integrations**: Dedicated packages for Laravel and Symfony. +- **Local LLM Support**: Adapters for Ollama/Llama.cpp. From 04c8b83f4c10a4590a3b9db118208392086f89f4 Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sun, 15 Feb 2026 08:49:39 +0000 Subject: [PATCH 6/7] Docs: Add Project Wiki and Roadmap v4 --- docs/wiki.md | 54 ++++++++++++++++++++++++++++++++++------------------ 1 file changed, 35 insertions(+), 19 deletions(-) diff --git a/docs/wiki.md b/docs/wiki.md index 9f8035d..970db2c 100644 --- a/docs/wiki.md +++ b/docs/wiki.md @@ -1,28 +1,44 @@ # PapiAI Project Wiki ## Project Overview -PapiAI Core is a professional, type-safe PHP library designed for building robust AI agents. It decouples the agent logic from specific LLM providers, allowing developers to switch between Anthropic (Claude), Google (Gemini), and others with ease. It focuses on developer experience with strict typing (PHP 8.2+), intuitive interfaces for tool calling, and structured data extraction. -## Architecture -The library is built around a few key components: -- **Agent**: The main orchestrator that manages context, instructions, and the conversation loop. -- **Provider**: An interface for LLM backends (e.g., `AnthropicProvider`, `GoogleProvider`). -- **Tool**: Encapsulates capabilities the agent can use, definable via closures or class attributes. -- **Schema**: A fluent builder for defining structured output expectations (Zod-like). +**PapiAI Core** is a robust, type-safe PHP library designed for building AI agents. It provides a unified interface for interacting with various Large Language Models (LLMs) while handling the complexities of tool calling, structured output, and conversation state management. + +The library is framework-agnostic, meaning it can be dropped into any PHP 8.2+ project, whether it's a standalone script, a Laravel application, or a Symfony microservice. + +### Key Concepts + +* **Agent**: The central orchestrator that manages instructions, tools, and the provider connection. +* **Provider**: An abstraction layer for AI models (currently supporting Anthropic and Google Gemini). +* **Tool**: Capabilities given to the agent, defined as simple functions or class methods with attributes. +* **Schema**: A Zod-like fluent interface for defining structured output requirements. +* **Stream**: First-class support for real-time streaming of text and tool execution events. ## Roadmap -### Phase 1: Foundation (Current) -- Core architecture (Agent, Provider, Tool, Schema). -- Support for Anthropic Claude and Google Gemini. -- Event-driven streaming and observability hooks. +This roadmap outlines the development phases for PapiAI, moving from the current foundational state to a full-featured AI ecosystem. + +### Phase 1: Foundation (Current Status) +* [x] Core `Agent` logic and conversation management. +* [x] Provider interfaces for Anthropic (Claude) and Google (Gemini). +* [x] Function and Class-based Tool definitions. +* [x] Structured output validation using Schemas. +* [x] Event-based streaming support. +* [x] Basic test suite with Pest. + +### Phase 2: Expansion & Integration +* [ ] **OpenAI Provider**: Add support for GPT-4o and o1 models. +* [ ] **Memory Management**: Implement interfaces for short-term and long-term memory (Redis, Vector DBs). +* [ ] **Middleware Pipelines**: Allow intercepting requests/responses for logging, moderation, or modification. +* [ ] **Http Client Abstraction**: Decouple from specific HTTP clients to allow deeper customization. -### Phase 2: Expansion (Next) -- **OpenAI Integration**: Add support for GPT-4o and o1 models. -- **Memory Systems**: Abstract persistence layers for conversation history (Redis, SQL). -- **RAG Support**: Simple interfaces for vector store retrieval. +### Phase 3: Developer Experience +* [ ] **Laravel Bundle**: dedicated service providers, facades, and artisan commands. +* [ ] **Symfony Bundle**: Dependency injection configuration and debug toolbar integration. +* [ ] **CLI Mode**: Run agents directly from the command line for testing and automation. +* [ ] **Documentation Site**: Comprehensive static site with API references and cookbooks. -### Phase 3: Advanced Capabilities -- **Multi-Agent Systems**: Patterns for agent delegation and collaboration. -- **Framework Integrations**: Dedicated packages for Laravel and Symfony. -- **Local LLM Support**: Adapters for Ollama/Llama.cpp. +### Phase 4: Advanced Features +* [ ] **Multi-Agent Orchestration**: Patterns for agents to communicate and delegate tasks to one another. +* [ ] **Evaluations**: Tools for measuring agent performance and accuracy against test sets. +* [ ] **Observability Dashboard**: specialized UI for tracing agent thoughts and tool executions. From 5eaadd7044c20d1d8aec3bc3ebf08e9579e7b006 Mon Sep 17 00:00:00 2001 From: Rafael Duarte Date: Sun, 15 Feb 2026 09:12:52 +0000 Subject: [PATCH 7/7] Docs: Add project wiki and roadmap v5 --- docs/wiki.md | 64 ++++++++++++++++++++++++---------------------------- 1 file changed, 29 insertions(+), 35 deletions(-) diff --git a/docs/wiki.md b/docs/wiki.md index 970db2c..d6c3863 100644 --- a/docs/wiki.md +++ b/docs/wiki.md @@ -2,43 +2,37 @@ ## Project Overview -**PapiAI Core** is a robust, type-safe PHP library designed for building AI agents. It provides a unified interface for interacting with various Large Language Models (LLMs) while handling the complexities of tool calling, structured output, and conversation state management. +PapiAI is a powerful, framework-agnostic PHP library designed for building robust AI agents. It provides a type-safe, fluent interface for interacting with Large Language Models (LLMs) from multiple providers. -The library is framework-agnostic, meaning it can be dropped into any PHP 8.2+ project, whether it's a standalone script, a Laravel application, or a Symfony microservice. +At its core, PapiAI abstracts the complexity of different AI APIs, offering a unified way to handle: +- **Tool Calling:** Define tools as simple functions or class methods. +- **Structured Output:** Enforce strict JSON schemas on model responses. +- **Streaming:** Real-time response streaming with event hooks. +- **Provider Flexibility:** Swap between Anthropic, Google Gemini, and others without rewriting application logic. -### Key Concepts - -* **Agent**: The central orchestrator that manages instructions, tools, and the provider connection. -* **Provider**: An abstraction layer for AI models (currently supporting Anthropic and Google Gemini). -* **Tool**: Capabilities given to the agent, defined as simple functions or class methods with attributes. -* **Schema**: A Zod-like fluent interface for defining structured output requirements. -* **Stream**: First-class support for real-time streaming of text and tool execution events. +Designed for modern PHP (8.2+), PapiAI fits seamlessly into Laravel, Symfony, or standalone scripts, making it the ideal foundation for building chatbots, data extraction pipelines, and autonomous agents. ## Roadmap -This roadmap outlines the development phases for PapiAI, moving from the current foundational state to a full-featured AI ecosystem. - -### Phase 1: Foundation (Current Status) -* [x] Core `Agent` logic and conversation management. -* [x] Provider interfaces for Anthropic (Claude) and Google (Gemini). -* [x] Function and Class-based Tool definitions. -* [x] Structured output validation using Schemas. -* [x] Event-based streaming support. -* [x] Basic test suite with Pest. - -### Phase 2: Expansion & Integration -* [ ] **OpenAI Provider**: Add support for GPT-4o and o1 models. -* [ ] **Memory Management**: Implement interfaces for short-term and long-term memory (Redis, Vector DBs). -* [ ] **Middleware Pipelines**: Allow intercepting requests/responses for logging, moderation, or modification. -* [ ] **Http Client Abstraction**: Decouple from specific HTTP clients to allow deeper customization. - -### Phase 3: Developer Experience -* [ ] **Laravel Bundle**: dedicated service providers, facades, and artisan commands. -* [ ] **Symfony Bundle**: Dependency injection configuration and debug toolbar integration. -* [ ] **CLI Mode**: Run agents directly from the command line for testing and automation. -* [ ] **Documentation Site**: Comprehensive static site with API references and cookbooks. - -### Phase 4: Advanced Features -* [ ] **Multi-Agent Orchestration**: Patterns for agents to communicate and delegate tasks to one another. -* [ ] **Evaluations**: Tools for measuring agent performance and accuracy against test sets. -* [ ] **Observability Dashboard**: specialized UI for tracing agent thoughts and tool executions. +### Phase 1: Foundation (Current) +- [x] Core Agent Architecture (Agent, Tool, Schema) +- [x] Provider Interfaces +- [x] Anthropic (Claude) Integration +- [x] Google (Gemini) Integration +- [x] Tool Calling & Structured Output +- [x] Basic Event Streaming + +### Phase 2: Expansion (Next Up) +- [ ] **OpenAI Provider:** Full support for GPT-4o and o1 models. +- [ ] **Memory System:** Built-in conversation history management (short-term & long-term). +- [ ] **Middleware/Hooks:** Deeper observability for logging and monitoring agent actions. + +### Phase 3: Advanced Capabilities +- [ ] **RAG Support:** Native document loading and vector store integration. +- [ ] **Multi-Agent Orchestration:** Patterns for agents to communicate and delegate tasks. +- [ ] **CLI Tool:** Helper commands for generating agents and tools. + +### Phase 4: Ecosystem +- [ ] **Laravel Bundle:** Dedicated service provider and facades for Laravel. +- [ ] **Symfony Bundle:** Dependency injection configuration for Symfony. +- [ ] **Community Plugin System:** Easier sharing of custom tools and providers.