Lemon Agent

Implements a two-phase agent architecture where a PlannerAgent analyzes natural language requests and generates high-level execution strategies, while a SolverAgent executes those plans step-by-step through a structured ExecuteWorkflow use case. This separation of concerns improves accuracy by allowing each agent to specialize in planning vs. execution, reducing hallucination and improving task decomposition reliability compared to single-agent approaches.

Provides a centralized tool registry spanning 9 major service categories (GitHub, Slack, HubSpot, Notion, Airtable, Monday.com, Discord, Medium, HackerNews) with 120+ individual tools, each identified by unique toolId and configurable with execution parameters including userPermissionRequired flags. Tools are abstracted through a connector pattern that normalizes API differences across heterogeneous services into a unified invocation interface.

Enables composition of workflows that span multiple services by mapping outputs from one tool as inputs to subsequent tools. The system maintains execution context across steps, allowing data flow between services (e.g., GitHub issue ID → Slack notification, HubSpot contact → Notion database entry). Parameter mapping is configured in the execution plan and validated at runtime.

Implements a connector architecture that abstracts service-specific API differences behind a unified interface. Each service (GitHub, Slack, HubSpot, etc.) has a dedicated connector that handles authentication, API versioning, error translation, and response normalization, allowing agents to invoke tools without knowledge of underlying API details.

Implements supervised execution through userPermissionRequired field in workflow configurations, where the system prompts users for explicit approval before executing potentially sensitive operations (e.g., deleting repositories, posting to public channels, modifying critical data). Approval state is tracked per workflow step and blocks execution until user confirmation is received.

Executes planned workflows through the ExecuteWorkflow use case, which processes each step sequentially, validates inputs against tool schemas, invokes the appropriate service connector, and captures execution results with detailed error information. Failed steps can trigger retry logic or fallback handlers, and execution state is maintained throughout the workflow lifecycle.

Generates visualization of tool usage patterns through execution log analysis, producing heatmaps that show which tools are invoked most frequently and in what temporal patterns. Analytics are computed from historical execution logs and enable identification of automation bottlenecks, most-used integrations, and workflow optimization opportunities.

The PlannerAgent accepts natural language task descriptions and generates structured execution plans by analyzing the request, identifying required tools, determining execution order, and mapping parameters. This leverages LLM reasoning to convert unstructured user intent into a formal workflow specification that the SolverAgent can execute.

Provides 19 GitHub-specific tools covering repository operations (create, clone, delete, list), issue management (create, update, close, search), release management, and file operations (read, write, delete). Each tool is pre-configured with GitHub API bindings and handles authentication through GitHub tokens, enabling agents to perform full repository lifecycle management.

Provides 41 Slack-specific tools covering channel operations (create, list, archive, delete), messaging (send, update, delete, search), file operations (upload, download), and user management (list, invite, remove). Tools handle Slack API authentication through bot tokens and workspace configuration, enabling agents to manage Slack workspaces and automate communication workflows.

Provides 34 HubSpot-specific tools covering contact/company/deal CRUD operations, engagement tracking (calls, emails, meetings), ticketing, and pipeline management. Tools authenticate through HubSpot API keys and enable agents to manage the full HubSpot data model, automating sales and customer success workflows.

Provides 16 Notion-specific tools for database operations (query, create, update, delete records), page management (create, update, delete, retrieve), and block manipulation (add, update, delete content blocks). Tools authenticate through Notion API tokens and enable agents to manage Notion workspaces as structured data sources and documentation systems.