Skip to content

Conversation

@esafwan
Copy link
Contributor

@esafwan esafwan commented Nov 10, 2025

This PR introduces the foundation for multi-run agent orchestration, enabling agents to perform multi-step reasoning style execution. This is a work-in-progress feature that adds the necessary data models and documentation updates.

Changes

Documentation Updates

  • Updated AGENTS.md with comprehensive documentation:
    • Added frontend architecture section covering React 18, TypeScript, Vite, and shadcn/ui
    • Documented Agent Trigger system migration (separate DocType for triggers)
    • Added Agent Tool Type DocType documentation
    • Documented agent_hooks.py and agent_scheduler.py modules
    • Added Recent Changes section documenting migrations and additions
    • Updated Agent DocType fields documentation

New DocTypes

Agent Orchestration Config

Configuration DocType for multi-run orchestration:

  • Links to Agent
  • Mode selection (single_multi_run)
  • Plan template JSON
  • Policy JSON
  • Active status flag

Agent Orchestration Run

Execution tracking DocType for orchestration runs:

  • Links to Agent and Orchestration Config
  • Status tracking (Started, Running, Paused, Halted, Done, Failed)
  • Budget tracking (used tokens, time, cost estimate)
  • Plan and scratchpad JSON fields
  • Halt reason field

Agent Doctype Updates

Added orchestration configuration fields:

  • Orchestration Tab:
    • enable_orchestration flag
    • orchestration_mode (single_multi_run)
    • Budget controls: max_steps, time_budget_s, token_budget
  • Planning Configuration:
    • planning_prompt (Code field)
    • plan_template_json
    • step_prompt_template

Also includes scheduling and doc event fields for backward compatibility during migration.

Status

Work in Progress - This PR contains the foundational data models and documentation. Implementation of the orchestration execution logic is pending.

Related

Part of the multi-run agent orchestration feature implementation.

Notes

  • All changes are marked as WIP in commit messages
  • This is a foundational PR - execution logic will follow in subsequent PRs
  • Agent Trigger system migration is documented but not yet fully implemented in this branch
…ystem

- Add frontend directory structure to repo layout
- Document Agent Trigger DocType with all trigger types
- Update Agent DocType fields (removed condition, added statistics)
- Add Agent Tool Type DocType documentation
- Document agent_hooks.py and agent_scheduler.py modules
- Add comprehensive Frontend Architecture section covering:
  * Technology stack (React 18, TypeScript, Vite, shadcn/ui)
  * Frontend structure and components
  * Dashboard framework
  * Agent management UI
  * Flow builder
  * API integration
- Add Recent Changes section documenting migrations and additions

This update reflects the current state of the codebase including the
Agent Trigger system migration and React frontend implementation.
Add two new doctypes for multi-run agent orchestration:

- Agent Orchestration Config: Configuration for orchestration mode
  * Links to Agent
  * Mode selection (single_multi_run)
  * Plan template JSON
  * Policy JSON
  * Active status flag

- Agent Orchestration Run: Tracks orchestration execution
  * Links to Agent and Orchestration Config
  * Status tracking (Started, Running, Paused, Halted, Done, Failed)
  * Budget tracking (used tokens, time, cost estimate)
  * Plan and scratchpad JSON fields
  * Halt reason field

These doctypes support multi-step reasoning style execution
for agents with orchestration capabilities.

WIP: Part of multi-run agent orchestration feature.
Add orchestration configuration fields to Agent doctype:

- Orchestration tab with enable_orchestration flag
- Orchestration mode selection (single_multi_run)
- Budget controls: max_steps, time_budget_s, token_budget
- Planning configuration:
  * planning_prompt (Code field)
  * plan_template_json
  * step_prompt_template

Also includes scheduling and doc event fields for backward
compatibility during migration.

WIP: Part of multi-run agent orchestration feature.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants