Package Documentation Hub
=========================

Welcome to the comprehensive documentation for all Haive packages. Each package provides specialized functionality within the Haive AI Agent Framework ecosystem.

.. grid:: 2
   :gutter: 3
   :margin: 3

   .. grid-item-card:: 🔧 **haive-core**
      :link: ../../packages/haive-core/docs/build/html/index.html
      :class-card: sd-border-primary

      **Core Framework & Infrastructure**
      
      The foundational engine powering all Haive agents. Includes state management, graph workflows, tool integration, and the core execution engine.

      Features: AugLLMConfig • StateGraph • Tool Integration • Vector Stores

   .. grid-item-card:: 🤖 **haive-agents**
      :link: ../../packages/haive-agents/docs/build/html/index.html
      :class-card: sd-border-success

      **Agent Implementations & Patterns**
      
      Pre-built agent implementations including SimpleAgent, ReactAgent, Multi-Agent systems, and specialized patterns like RAG and planning agents.

      Features: SimpleAgent • ReactAgent • Multi-Agent • RAG • Planning

   .. grid-item-card:: 🛠️ **haive-tools**
      :link: ../../packages/haive-tools/docs/build/html/index.html
      :class-card: sd-border-warning

      **Tool Integrations & Utilities**
      
      Comprehensive tool library for agents including web scraping, API integrations, file operations, and custom tool creation patterns.

      Features: Web Tools • File Tools • API Tools • Custom Tools

   .. grid-item-card:: 📡 **haive-mcp**
      :link: ../../packages/haive-mcp/docs/build/html/index.html
      :class-card: sd-border-info

      **Model Context Protocol Integration**
      
      Seamless integration with MCP servers for extended functionality, enabling agents to interact with external systems and data sources.

      Features: MCP Servers • External APIs • Protocol Management

   .. grid-item-card:: 🎮 **haive-games**
      :link: ../../packages/haive-games/docs/build/html/index.html
      :class-card: sd-border-danger

      **Game Environments & Training**
      
      Game environments for training and testing agents, including reinforcement learning scenarios and interactive simulations.

      Features: Game Environments • RL Training • Agent Testing

   .. grid-item-card:: 🌊 **haive-dataflow**
      :link: ../../packages/haive-dataflow/docs/build/html/index.html
      :class-card: sd-border-secondary

      **Stream Processing & Pipelines**
      
      Real-time data processing and streaming pipelines for building reactive agent systems and data-driven workflows.

      Features: Stream Processing • Real-time Data • Pipeline Management

   .. grid-item-card:: 🏗️ **haive-prebuilt**
      :link: ../../packages/haive-prebuilt/docs/build/html/index.html
      :class-card: sd-border-primary

      **Pre-configured Solutions**
      
      Ready-to-use agent configurations and solutions for common use cases, providing quick starts for typical scenarios.

      Features: Ready Solutions • Quick Start • Common Patterns

   .. grid-item-card:: 🔗 **haive-hap**
      :link: ../../packages/haive-hap/docs/build/html/index.html
      :class-card: sd-border-success

      **Hierarchical Agent Protocol**
      
      Advanced agent coordination and hierarchy management for complex multi-agent systems and organizational patterns.

      Features: Agent Hierarchies • Coordination • Protocol Management

Package Overview
----------------

.. list-table:: Package Statistics & Links
   :header-rows: 1
   :widths: 25 15 40 20

   * - Package
     - Version
     - Description
     - Quick Links
   * - **haive-core**
     - 0.1.0
     - Core framework and infrastructure
     - `API <../../packages/haive-core/docs/build/html/autoapi/index.html>`__ • `Examples <../../packages/haive-core/docs/build/html/examples.html>`__
   * - **haive-agents**
     - 0.1.0
     - Agent implementations and patterns
     - `API <../../packages/haive-agents/docs/build/html/autoapi/index.html>`__ • `Gallery <../../packages/haive-agents/docs/build/html/agent_gallery.html>`__
   * - **haive-tools**
     - 0.1.0
     - Tool integrations and utilities
     - `API <../../packages/haive-tools/docs/build/html/autoapi/index.html>`__ • `Tools <../../packages/haive-tools/docs/build/html/tool_catalog.html>`__
   * - **haive-mcp**
     - 0.1.0
     - Model Context Protocol integration
     - `API <../../packages/haive-mcp/docs/build/html/autoapi/index.html>`__ • `Servers <../../packages/haive-mcp/docs/build/html/mcp_servers.html>`__
   * - **haive-games**
     - 0.1.0
     - Game environments and training
     - `API <../../packages/haive-games/docs/build/html/autoapi/index.html>`__ • `Games <../../packages/haive-games/docs/build/html/game_catalog.html>`__
   * - **haive-dataflow**
     - 0.1.0
     - Stream processing and pipelines
     - `API <../../packages/haive-dataflow/docs/build/html/autoapi/index.html>`__ • `Pipelines <../../packages/haive-dataflow/docs/build/html/pipelines.html>`__
   * - **haive-prebuilt**
     - 0.1.0
     - Pre-configured solutions
     - `API <../../packages/haive-prebuilt/docs/build/html/autoapi/index.html>`__ • `Solutions <../../packages/haive-prebuilt/docs/build/html/solutions.html>`__
   * - **haive-hap**
     - 0.1.0
     - Hierarchical Agent Protocol
     - `API <../../packages/haive-hap/docs/build/html/autoapi/index.html>`__ • `Protocols <../../packages/haive-hap/docs/build/html/protocols.html>`__

Development & Contribution
--------------------------

All packages follow the same development standards:

- **Testing**: 100% real component testing (no mocks)
- **Documentation**: Comprehensive API docs with examples
- **Code Style**: Consistent formatting and patterns
- **Purple Theme**: Unified visual identity across all docs

For development setup and contribution guidelines, see the main `Development Guide <development.html>`__.

Quick Navigation
----------------

.. toctree::
   :maxdepth: 1
   :caption: Package Documentation

   Core Framework <../../packages/haive-core/docs/build/html/index>
   Agents Library <../../packages/haive-agents/docs/build/html/index>
   Tools & Utilities <../../packages/haive-tools/docs/build/html/index>
   MCP Integration <../../packages/haive-mcp/docs/build/html/index>
   Game Environments <../../packages/haive-games/docs/build/html/index>
   Data Pipelines <../../packages/haive-dataflow/docs/build/html/index>
   Pre-built Solutions <../../packages/haive-prebuilt/docs/build/html/index>
   Hierarchical Protocol <../../packages/haive-hap/docs/build/html/index>