chnjinlei/hive
1
0
Fork 0
Code Issues Pull Requests Actions 41 Packages Projects Releases Wiki Activity
Files
v0.5.2
hive/docs/roadmap.md
T

9.9 KiB
Raw Permalink Blame History

Product Roadmap

Aden Agent Framework aims to help developers build outcome-oriented, self-adaptive agents. Please find our roadmap here

flowchart TB
    %% Main Entity
    User([User])

    %% =========================================
    %% EXTERNAL EVENT SOURCES
    %% =========================================
    subgraph ExtEventSource [External Event Source]
        E_Sch["Schedulers"]
        E_WH["Webhook"]
        E_SSE["SSE"]
    end

    %% =========================================
    %% SYSTEM NODES
    %% =========================================
    subgraph WorkerBees [Worker Bees]
        WB_C["Conversation"]
        WB_SP["System prompt"]

        subgraph Graph [Graph]
            direction TB
            N1["Node"] --> N2["Node"] --> N3["Node"]
            N1 -.-> AN["Active Node"]
            N2 -.-> AN
            N3 -.-> AN

            %% Nested Event Loop Node
            subgraph EventLoopNode [Event Loop Node]
                ELN_L["listener"]
                ELN_SP["System Prompt<br/>(Task)"]
                ELN_EL["Event loop"]
                ELN_C["Conversation"]
            end
        end
    end

    subgraph JudgeNode [Judge]
        J_C["Criteria"]
        J_P["Principles"]
        J_EL["Event loop"] <--> J_S["Scheduler"]
    end

    subgraph QueenBee [Queen Bee]
        QB_SP["System prompt"]
        QB_EL["Event loop"]
        QB_C["Conversation"]
    end

    subgraph Infra [Infra]
        SA["Sub Agent"]
        TR["Tool Registry"]
        WTM["Write through Conversation Memory<br/>(Logs/RAM/Harddrive)"]
        SM["Shared Memory<br/>(State/Harddrive)"]
        EB["Event Bus<br/>(RAM)"]
        CS["Credential Store<br/>(Harddrive/Cloud)"]
    end

    subgraph PC [PC]
        B["Browser"]
        CB["Codebase<br/>v 0.0.x ... v n.n.n"]
    end

    %% =========================================
    %% CONNECTIONS & DATA FLOW
    %% =========================================

    %% External Event Routing
    E_Sch --> ELN_L
    E_WH --> ELN_L
    E_SSE --> ELN_L
    ELN_L -->|"triggers"| ELN_EL

    %% User Interactions
    User -->|"Talk"| WB_C
    User -->|"Talk"| QB_C
    User -->|"Read/Write Access"| CS

    %% Inter-System Logic
    ELN_C <-->|"Mirror"| WB_C
    WB_C -->|"Focus"| AN

    WorkerBees -->|"Inquire"| JudgeNode
    JudgeNode -->|"Approve"| WorkerBees

    %% Judge Alignments
    J_C <-.->|"aligns"| WB_SP
    J_P <-.->|"aligns"| QB_SP

    %% Escalate path
    J_EL -->|"Report (Escalate)"| QB_EL

    %% Pub/Sub Logic
    AN -->|"publish"| EB
    EB -->|"subscribe"| QB_C

    %% Infra and Process Spawning
    ELN_EL -->|"Spawn"| SA
    SA -->|"Inform"| ELN_EL
    SA -->|"Starts"| B
    B -->|"Report"| ELN_EL
    TR -->|"Assigned"| EventLoopNode
    CB -->|"Modify Worker Bee"| WorkerBees

    %% =========================================
    %% SHARED MEMORY & LOGS ACCESS
    %% =========================================

    %% Worker Bees Access
    Graph <-->|"Read/Write"| WTM
    Graph <-->|"Read/Write"| SM

    %% Queen Bee Access
    QB_C <-->|"Read/Write"| WTM
    QB_EL <-->|"Read/Write"| SM

    %% Credentials Access
    CS -->|"Read Access"| QB_C

Phase 1: Foundation

Backbone Architecture

  • Node-Based Architecture (Agent as a node)
    • Object schema definition
    • Node wrapper SDK
    • Shared memory access
    • Default monitoring hooks
    • Tool access layer
    • LLM integration layer (Natively supports all mainstream LLMs through LiteLLM)
      • Anthropic
      • OpenAI
      • Google
  • Communication protocol between nodes
  • [Coding Agent] Goal Creation Session (separate from coding session)
    • Instruction back and forth
    • Goal Object schema definition
    • Being able to generate the test cases
    • Test case validation for worker agent (Outcome driven)
  • [Coding Agent] Worker Agent Creation
    • Coding Agent tools
    • Use Template Agent as a start
    • Use our MCP tools
  • [Worker Agent] Human-in-the-Loop
    • Worker Agents request with questions and options
    • Callback Handler System to receive events throughout execution
    • Tool-Based Intervention Points (tool to pause execution and request human input)
    • Multiple entrypoint for different event source (e.g. Human input, webhook)
    • Streaming Interface for Real-time Monitoring
    • Request State Management

Credential Management

  • Credentials Setup Process
    • Install Credential MCP
  • Pluggable Credential Sources
    • Abstraction & Local Sources
      • Introduce CredentialSource base class
      • Refactor existing logic into EnvVarSource
      • Implementation of Source Priority Chain mechanism
      • Foundation unit tests
    • Enterprise Secret Managers
      • VaultSource (HashiCorp Vault)
      • AWSSecretsSource (AWS Secrets Manager)
      • AzureKeyVaultSource (Azure Key Vault)
      • Management of optional provider dependencies
    • Advanced Features
      • Credential expiration and auto-refresh
      • Audit logging for compliance/tracking
      • Per-environment configuration support
    • Documentation & DX
      • Comprehensive source documentation
      • Example configurations for all providers
    • Integration as tools coverage
      • Gsuite Tools
      • Social Media
        • Twitter(X)
        • Github
        • Instagram
      • SAAS
        • Hubspot
        • Slack
        • Teams
        • Zoom
        • Stripe
        • Salesforce

Important

Community Contribution Wanted: We appreciate help from the community to expand the "Integration as tools" capability. Leave an issue of the integration you want to support via Hive!

Essential Tools

  • File Use Tool Kit
  • Memory Tools
    • STM Layer Tool (state-based short-term memory)
    • LTM Layer Tool (RLM - long-term memory)
  • Infrastructure Tools
    • Runtime Log Tool (logs for coding agent)
    • Web Search
    • Web Scraper
    • CSV tools
    • PDF tools
    • Excel tools
    • Email Tools
    • Recipe for "Add your own tools"

Memory & File System

  • DB for long-term persistent memory (Filesystem as durable scratchpad pattern)
  • Session Local memory isolation

Eval System (Basic)

  • Test Driven - Run test case for all agent iteration
  • Failure recording mechanism
  • SDK for defining failure conditions
  • Basic observability hooks
  • User-driven log analysis (OSS approach)

Data Validation

  • Natively Support data validation of LLMs output with Pydantic

Developer Experience

  • MVP Features
    • Debugging mode
    • CLI tools for memory management
    • CLI tools for credential management
  • MVP Resources & Documentation
    • Quick start guide
    • Goal creation guide
    • Agent creation guide
    • GitHub Page setup
    • README with examples
    • Contributing guidelines
    • Introduction Video

Adaptiveness

  • Runtime data feedback loop
  • Instant Developer Feedback for improvement

Sample Agents

  • Knowledge Agent
  • Blog Writer Agent
  • SDR Agent

Phase 2: Expansion

Basic Guardrails

  • Support Basic Monitoring from Agent node SDK
  • SDK guardrail implementation (in node)
  • Guardrail type support (Determined Condition as Guardrails)

Agent Capability

  • Streaming mode support
  • Image Generation support
  • Take end user input Image and flatfile understand capability

Event-loop For Nodes (Opencode-style)

  • Event bus

Memory System Iteration

  • Message Model & Session Management
    • Introduce Message class with structured content types
    • Implement Session classes for conversation state
  • Storage Migration
    • Implement granular per-message file persistence (/message/[agentID]/...)
    • Migrate from monolithic run storage
  • Context Building & Conversation Loop
    • Implement Message.stream(sessionID)
    • Update EventLoopNode.execute() for full context building
    • Implement Message.toModelMessages() conversion
  • Proactive Compaction
    • Implement proactive overflow detection
    • Develop backward-scanning pruning strategy (e.g., clearing old tool outputs)
  • Enhanced Token Tracking
    • Extend LLMResponse to track reasoning and cache tokens
    • Integrate granular token metrics into compaction logic

Coding Agent Support

  • Claude Code
  • Cursor
  • Opencode
  • Antigravity
  • Codex CLI (in progress)

File System Enhancement

  • Semantic Search integration
  • Interactive File System in product (frontend integration)

More Worker Tools

  • Custom Tool Integrator
  • Integration as a tool (Credential Store & Support)
  • Core Agent Tools
    • Node Discovery Tool (find other agents in the graph)
    • HITL Tool (pause execution for human approval)
    • Wake-up Tool (resume agent tasks)

Deployment (Self-Hosted)

  • Worker agent docker container standardization
  • Headless backend execution
  • Exposed API for frontend attachment
  • Local monitoring & observability
  • Basic lifecycle APIs (Start, Stop, Pause, Resume)

Deployment (Cloud)

  • Cloud Service Options
  • Support deployment to 3rd-party platforms
  • Self-deploy + orchestrator connection
  • CI/CD Pipeline
    • Automated test execution
    • Agent version control
    • All tests must pass for deployment

Developer Experience Enhancement

  • Tool usage documentation
  • Discord Support Channel

More Agent Templates

  • GTM Sales Agent (workflow)
  • GTM Marketing Agent (workflow)
  • Analytics Agent
  • Training Agent
  • Smart Entry / Form Agent (self-evolution emphasis)

Cross-Platform

  • JavaScript / TypeScript Version SDK
  • Better windows support
Reference in New Issue View Git Blame Copy Permalink