@trygentic/agentloop 0.15.0-alpha.11 → 0.16.0-alpha.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trygentic/agentloop",
-  "version": "0.15.0-alpha.11",
+  "version": "0.16.0-alpha.11",
   "description": "AI-powered autonomous coding agent",
   "bin": {
     "agentloop": "./bin/agentloop"
@@ -9,8 +9,8 @@
     "postinstall": "node ./scripts/postinstall.mjs"
   },
   "optionalDependencies": {
-    "@trygentic/agentloop-darwin-arm64": "0.15.0-alpha.11",
-    "@trygentic/agentloop-linux-x64": "0.15.0-alpha.11"
+    "@trygentic/agentloop-darwin-arm64": "0.16.0-alpha.11",
+    "@trygentic/agentloop-linux-x64": "0.16.0-alpha.11"
   },
   "engines": {
     "node": ">=18.0.0"

package/templates/agents/chat/chat.bt.json

@@ -0,0 +1,346 @@
+{
+  "name": "chat-continuous-agent-tree",
+  "description": "Continuous behavior tree for the Chat agent. Processes messages in a loop from users and other agents. Unlike task-based agents, chat uses a message queue model with support for async task delegation.",
+  "version": "1.0.0",
+  "tree": {
+    "type": "root",
+    "child": {
+      "type": "sequence",
+      "comment": "Main continuous loop - processes messages indefinitely",
+      "children": [
+        {
+          "type": "action",
+          "call": "WaitForMessage",
+          "comment": "Block until a message arrives (user input or agent message). Polls the message queue."
+        },
+        {
+          "type": "action",
+          "call": "FetchMessageContext",
+          "comment": "Load message details, sender info, conversation history, and any relevant context"
+        },
+        {
+          "type": "selector",
+          "comment": "Handle the message based on its type and content",
+          "children": [
+            {
+              "type": "sequence",
+              "comment": "Slash command handling - process commands like /help, /tasks, /orchestrator",
+              "children": [
+                {
+                  "type": "condition",
+                  "call": "IsSlashCommand"
+                },
+                {
+                  "type": "action",
+                  "call": "ProcessSlashCommand",
+                  "comment": "Execute the slash command and store result"
+                },
+                {
+                  "type": "action",
+                  "call": "SendCommandResponse"
+                }
+              ]
+            },
+            {
+              "type": "sequence",
+              "comment": "Async task request - delegate work to orchestrator without blocking",
+              "children": [
+                {
+                  "type": "condition",
+                  "call": "IsAsyncTaskRequest"
+                },
+                {
+                  "type": "action",
+                  "call": "QueueAsyncTask",
+                  "comment": "Create task in orchestrator and return immediately (fire-and-forget)"
+                },
+                {
+                  "type": "action",
+                  "call": "SendTaskQueuedResponse",
+                  "comment": "Acknowledge to user that task was queued"
+                }
+              ]
+            },
+            {
+              "type": "sequence",
+              "comment": "Agent message handling - respond to messages from other agents",
+              "children": [
+                {
+                  "type": "condition",
+                  "call": "IsAgentMessage"
+                },
+                {
+                  "type": "selector",
+                  "comment": "Handle different agent message types",
+                  "children": [
+                    {
+                      "type": "sequence",
+                      "comment": "Query from another agent - needs immediate response",
+                      "children": [
+                        {
+                          "type": "condition",
+                          "call": "IsAgentQuery"
+                        },
+                        {
+                          "type": "llm-action",
+                          "name": "ProcessAgentQuery",
+                          "prompt": "You are the chat agent responding to a query from another agent in the system.\n\nQuery from {{messageSender}}:\n{{messageContent}}\n\nConversation context:\n{{conversationHistory}}\n\nProvide a helpful response that addresses the agent's query. Be concise but complete.",
+                          "contextKeys": ["messageSender", "messageContent", "conversationHistory"],
+                          "outputSchema": {
+                            "type": "object",
+                            "properties": {
+                              "response": { "type": "string", "description": "Response to the agent's query" },
+                              "requiresFollowUp": { "type": "boolean", "description": "Whether this query needs additional follow-up" }
+                            },
+                            "required": ["response"]
+                          },
+                          "outputKey": "agentQueryResponse",
+                          "temperature": 0.4
+                        },
+                        {
+                          "type": "action",
+                          "call": "SendAgentResponse"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "sequence",
+                      "comment": "Notification from another agent - acknowledge and optionally relay to user",
+                      "children": [
+                        {
+                          "type": "condition",
+                          "call": "IsAgentNotification"
+                        },
+                        {
+                          "type": "action",
+                          "call": "ProcessAgentNotification",
+                          "comment": "Log the notification and determine if user should be notified"
+                        },
+                        {
+                          "type": "selector",
+                          "comment": "Optionally relay important notifications to user",
+                          "children": [
+                            {
+                              "type": "sequence",
+                              "children": [
+                                {
+                                  "type": "condition",
+                                  "call": "ShouldRelayToUser"
+                                },
+                                {
+                                  "type": "action",
+                                  "call": "SendUserNotification"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "action",
+                              "call": "NoOp",
+                              "comment": "Notification processed silently"
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "sequence",
+                      "comment": "Coordination message - update internal state",
+                      "children": [
+                        {
+                          "type": "condition",
+                          "call": "IsCoordinationMessage"
+                        },
+                        {
+                          "type": "action",
+                          "call": "ProcessCoordination"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            },
+            {
+              "type": "sequence",
+              "comment": "Standard user message - process with LLM and respond",
+              "children": [
+                {
+                  "type": "llm-selector",
+                  "name": "ClassifyUserIntent",
+                  "prompt": "Classify the user's intent based on their message.\n\nUser message: {{messageContent}}\n\nConversation history:\n{{conversationHistory}}\n\nClassify the intent to determine the best response strategy.",
+                  "contextKeys": ["messageContent", "conversationHistory"],
+                  "branches": {
+                    "general_chat": {
+                      "description": "General conversation, questions, or discussion not requiring code changes",
+                      "child": {
+                        "type": "llm-action",
+                        "name": "GenerateGeneralResponse",
+                        "prompt": "You are a helpful AI assistant. Respond to the user's message naturally and helpfully.\n\nUser message: {{messageContent}}\n\nConversation history:\n{{conversationHistory}}\n\nProvide a thoughtful, helpful response.",
+                        "contextKeys": ["messageContent", "conversationHistory", "codebaseContext"],
+                        "subagent": "chat",
+                        "maxTurns": 20,
+                        "outputSchema": {
+                          "type": "object",
+                          "properties": {
+                            "response": { "type": "string", "description": "The response to send to the user" },
+                            "suggestedActions": { "type": "array", "items": { "type": "string" }, "description": "Optional suggested follow-up actions" }
+                          },
+                          "required": ["response"]
+                        },
+                        "outputKey": "chatResponse",
+                        "temperature": 0.7
+                      }
+                    },
+                    "code_question": {
+                      "description": "Question about the codebase requiring analysis but not changes",
+                      "child": {
+                        "type": "sequence",
+                        "children": [
+                          {
+                            "type": "action",
+                            "call": "AnalyzeCodebase",
+                            "comment": "Gather codebase context for informed response"
+                          },
+                          {
+                            "type": "llm-action",
+                            "name": "AnswerCodeQuestion",
+                            "prompt": "The user has a question about the codebase. Analyze and answer their question.\n\nUser question: {{messageContent}}\n\nCodebase context:\n{{codebaseContext}}\n\nUse the code-graph-rag MCP tools (semantic_search, list_file_entities, analyze_code_impact, find_similar_code) and Read/Grep/Glob to examine specific files as needed. If code-graph-rag tools fail, fall back to Grep/Glob.\n\nProvide a clear, accurate answer based on the actual codebase.",
+                            "contextKeys": ["messageContent", "codebaseContext", "conversationHistory"],
+                            "subagent": "chat",
+                            "maxTurns": 30,
+                            "outputSchema": {
+                              "type": "object",
+                              "properties": {
+                                "response": { "type": "string", "description": "Answer to the code question" },
+                                "referencedFiles": { "type": "array", "items": { "type": "string" }, "description": "Files referenced in the answer" },
+                                "relatedTopics": { "type": "array", "items": { "type": "string" }, "description": "Related topics the user might want to explore" }
+                              },
+                              "required": ["response"]
+                            },
+                            "outputKey": "chatResponse",
+                            "temperature": 0.4
+                          }
+                        ]
+                      }
+                    },
+                    "task_request": {
+                      "description": "User wants to create a task or make code changes - delegate to orchestrator",
+                      "child": {
+                        "type": "sequence",
+                        "children": [
+                          {
+                            "type": "llm-action",
+                            "name": "ExtractTaskDetails",
+                            "prompt": "The user wants to create a task or make code changes. Extract the task details from their message.\n\nUser message: {{messageContent}}\n\nConversation history:\n{{conversationHistory}}\n\nExtract a clear task title and description that an engineer agent can execute.",
+                            "contextKeys": ["messageContent", "conversationHistory"],
+                            "outputSchema": {
+                              "type": "object",
+                              "properties": {
+                                "taskTitle": { "type": "string", "description": "Concise task title" },
+                                "taskDescription": { "type": "string", "description": "Detailed task description with acceptance criteria" },
+                                "priority": { "type": "string", "enum": ["low", "medium", "high", "critical"], "description": "Suggested task priority" },
+                                "isAsync": { "type": "boolean", "description": "Whether this should be processed asynchronously" }
+                              },
+                              "required": ["taskTitle", "taskDescription"]
+                            },
+                            "outputKey": "extractedTask",
+                            "temperature": 0.3
+                          },
+                          {
+                            "type": "action",
+                            "call": "QueueAsyncTask"
+                          },
+                          {
+                            "type": "action",
+                            "call": "SendTaskQueuedResponse"
+                          }
+                        ]
+                      }
+                    },
+                    "status_inquiry": {
+                      "description": "User asking about task status, agent status, or system state",
+                      "child": {
+                        "type": "sequence",
+                        "children": [
+                          {
+                            "type": "action",
+                            "call": "FetchSystemStatus",
+                            "comment": "Get current orchestrator and task status"
+                          },
+                          {
+                            "type": "llm-action",
+                            "name": "FormatStatusResponse",
+                            "prompt": "The user is asking about system status. Format a clear status update based on the data.\n\nUser question: {{messageContent}}\n\nSystem status:\n{{systemStatus}}\n\nProvide a clear, informative status update.",
+                            "contextKeys": ["messageContent", "systemStatus", "conversationHistory"],
+                            "outputSchema": {
+                              "type": "object",
+                              "properties": {
+                                "response": { "type": "string", "description": "Formatted status response" },
+                                "hasActiveWork": { "type": "boolean", "description": "Whether there's active work in progress" }
+                              },
+                              "required": ["response"]
+                            },
+                            "outputKey": "chatResponse",
+                            "temperature": 0.3
+                          }
+                        ]
+                      }
+                    }
+                  },
+                  "defaultBranch": "general_chat",
+                  "confidenceThreshold": 0.6
+                },
+                {
+                  "type": "action",
+                  "call": "SendChatResponse"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "type": "action",
+          "call": "UpdateConversationHistory",
+          "comment": "Add this exchange to conversation history"
+        },
+        {
+          "type": "action",
+          "call": "ClearMessageContext",
+          "comment": "Reset message-specific blackboard keys for next message"
+        },
+        {
+          "type": "action",
+          "call": "Loop",
+          "comment": "Return to start to wait for next message"
+        }
+      ]
+    }
+  },
+  "blackboardDefaults": {
+    "currentMessage": null,
+    "messageSender": null,
+    "messageType": null,
+    "messageContent": null,
+    "conversationHistory": [],
+    "agentQueryResponse": null,
+    "chatResponse": null,
+    "extractedTask": null,
+    "systemStatus": null,
+    "commandResult": null,
+    "codebaseContext": null,
+    "isSlashCommand": false,
+    "isAsyncRequest": false,
+    "isAgentMessage": false,
+    "shouldRelayToUser": false,
+    "notificationContent": null,
+    "queuedTaskId": null,
+    "currentTaskId": null,
+    "taskAssignedAt": null,
+    "loopCount": 0,
+    "messageCount": 0,
+    "lastActivityAt": null,
+    "maxConversationHistoryLength": 50,
+    "projectPath": null,
+    "workingDirectory": null
+  }
+}

package/templates/agents/chat/chat.md

@@ -0,0 +1,84 @@
+---
+name: chat
+description: >-
+  Chat agent that handles interactive user messages and delegates work to the
+  orchestrator. This is the user-facing interface for AgentLoop. Does NOT
+  create tasks directly - always delegates via delegate_work which routes
+  to the appropriate agent.
+model: inherit
+instanceCount: 1
+showInLiveView: true
+tools:
+  - AskUserQuestion
+  - mcp__agentloop__delegate_work
+  - mcp__agentloop__list_tasks
+  - mcp__agentloop__get_task
+  - mcp__agentloop__list_subprojects
+  - mcp__agentloop__get_subproject
+  - mcp__agentloop__run_orchestrator
+  - mcp__agentloop__stop_orchestrator
+  - mcp__agentloop__get_orchestrator_status
+  - mcp__agentloop__get_system_health
+  - mcp__agentloop__get_daemon_status
+---
+
+# AgentLoop
+
+You are **AgentLoop** - the primary user-facing interface for the multi-agent development system.
+
+## Core Responsibilities
+
+1. **Conversational Interface**: Answer user questions, explain concepts, provide summaries
+2. **Work Delegation**: When users request development work, delegate to the product-manager via `delegate_work`
+3. **Status Reporting**: Show task status, orchestrator health, and project progress
+4. **Orchestrator Control**: Start/stop the orchestrator when users request it
+
+## CRITICAL: Delegation Rules
+
+You MUST use `delegate_work` for ALL development work requests.
+The product-manager will handle task breakdown, subproject creation, and dependency setup.
+
+**You do NOT have access to `create_task`.** This is by design.
+
+### delegate_work Usage
+
+Submit a HIGH-LEVEL work request. Call this ONCE per user request.
+
+You describe WHAT the user wants at a high level. The product-manager agent
+will decompose it into specific implementation tasks with dependencies.
+
+CORRECT - One high-level call:
+  delegate_work(title: "Add user authentication", description: "The app needs login, signup, OAuth, JWT tokens, and protected routes")
+
+WRONG - Multiple specific calls (this is the PM's job, NOT yours):
+  delegate_work(title: "Create auth database schema", ...)
+  delegate_work(title: "Implement JWT token service", ...)
+  delegate_work(title: "Build login endpoint", ...)
+  delegate_work(title: "Build registration endpoint", ...)
+
+RULE: If you find yourself wanting to call delegate_work more than once,
+you are decomposing the work yourself. STOP. Combine everything into ONE call
+and let the product-manager handle the decomposition.
+
+If the user asks for multiple unrelated things, make ONE call per distinct project/feature.
+Each call creates a subproject that the PM will break into tasks.
+
+## When to Delegate vs Respond Directly
+
+**Delegate to PM (use delegate_work):**
+- Feature implementation requests
+- Bug fixes that require code changes
+- Multi-step workflows needing coordination
+
+**Respond directly (no delegation needed):**
+- Questions, explanations, summaries
+- Writing requests (paragraphs, documentation drafts)
+- Analysis and discussion
+- Status queries (use list_tasks, get_task, get_orchestrator_status)
+
+## Communication Style
+
+- Be conversational and friendly
+- Be proactive - suggest next steps
+- Be clear about what you're doing
+- Be concise - no unnecessary technical details