add 2 subagents

Author: ericdallo

docs/config/agents.md

@@ -9,8 +9,12 @@ There are 2 types of agents defined via `mode` field (when absent, defaults to p
 
 ## Built-in agents
 
-- `code`: default primary agent, generic, used to do most tasks.
-- `plan`: specialized primary agent to build a plan before switching to code agent and executing the complex task.
+| name         | mode     | description                                                                                                                                                             |
+|--------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| __code__     | primary  | Default, generic, used to do most tasks, has access to all tools by default                                                                                             |
+| __plan__     | primary  | Specialized in building a plan before user switches to code agent and executes the complex task. Has no edit tools available, only preview changes.                     |
+| __explorer__ | subagent | Fast agent specialized for exploring codebases. Finds files by patterns, searches code for keywords, or answers questions about the codebase. Read-only, no edit tools. |
+| __general__  | subagent | General-purpose agent for researching complex questions and executing multi-step tasks. Can be used to execute multiple units of work in parallel.                      |
 
 ## Custom agents and prompts
 
@@ -46,7 +50,7 @@ You can create an agent and define its prompt, tool call approval and default mo
 
 ECA can spawn foreground subagents in a chat, they are agents which `mode` is `subagent`.
 
-Subagents can be configured in config or markdown and require `description` and `prompt` (or markdown content):
+Subagents can be configured in config or markdown and require `description` and `systemPrompt` (or markdown content):
 
 === "Markdown"
 

resources/META-INF/native-image/eca/eca/native-image.properties

@@ -17,6 +17,7 @@ Args=-J-Dborkdude.dynaload.aot=true \
      -H:IncludeResources=ECA_VERSION \
      -H:IncludeResources=prompts/plan_agent.md \
      -H:IncludeResources=prompts/code_agent.md \
+     -H:IncludeResources=prompts/explorer_agent.md \
      -H:IncludeResources=prompts/additional_system_info.md \
      -H:IncludeResources=prompts/init.md \
      -H:IncludeResources=prompts/skill_create.md \

resources/prompts/explorer.md

@@ -0,0 +1,15 @@
+You are a file search specialist. You excel at thoroughly navigating and exploring codebases.
+
+Your strengths:
+- Rapidly finding files using glob patterns
+- Searching code and text with powerful regex patterns
+- Reading and analyzing file contents
+
+Guidelines:
+- Return file paths as absolute paths in your final response
+- For clear communication, avoid using emojis
+- Adapt your search approach based on the thoroughness level specified by the caller
+- Do not create any files, or run bash commands that modify the user's system state in any way
+
+Complete the user's search request efficiently and report your findings clearly.
+

src/eca/config.clj

@@ -40,6 +40,17 @@
 (defn get-env [env] (System/getenv env))
 (defn get-property [property] (System/getProperty property))
 
+(def ^:private dangerous-commands-regexes
+  ["[12&]?>>?\\s*(?!/dev/null($|\\s))\\S+"
+   ".*>.*",
+   ".*\\|\\s*(tee|dd|xargs).*",
+   ".*\\b(sed|awk|perl)\\s+.*-i.*",
+   ".*\\b(rm|mv|cp|touch|mkdir)\\b.*",
+   ".*git\\s+(add|commit|push).*",
+   ".*npm\\s+install.*",
+   ".*-c\\s+[\"'].*open.*[\"']w[\"'].*",
+   ".*bash.*-c.*>.*"])
+
 (def ^:private initial-config*
   {:providers {"openai" {:api "openai-responses"
                          :url "${env:OPENAI_API_URL:https://api.openai.com}"
@@ -66,10 +77,10 @@
                          :models {"gemini-2.5-pro" {}}}
                "ollama" {:url "${env:OLLAMA_API_URL:http://localhost:11434}"}}
    :defaultAgent "code"
-   :agent {"code" {:mode :primary
+   :agent {"code" {:mode "primary"
                    :prompts {:chat "${classpath:prompts/code_agent.md}"}
                    :disabledTools ["preview_file_change"]}
-           "plan" {:mode :primary
+           "plan" {:mode "primary"
                    :prompts {:chat "${classpath:prompts/plan_agent.md}"}
                    :disabledTools ["edit_file" "write_file" "move_file"]
                    :toolCall {:approval {:allow {"eca__shell_command"
@@ -79,15 +90,22 @@
                                                  "eca__read_file" {}
                                                  "eca__directory_tree" {}}
                                          :deny {"eca__shell_command"
-                                                {:argsMatchers {"command" ["[12&]?>>?\\s*(?!/dev/null($|\\s))\\S+"
-                                                                           ".*>.*",
-                                                                           ".*\\|\\s*(tee|dd|xargs).*",
-                                                                           ".*\\b(sed|awk|perl)\\s+.*-i.*",
-                                                                           ".*\\b(rm|mv|cp|touch|mkdir)\\b.*",
-                                                                           ".*git\\s+(add|commit|push).*",
-                                                                           ".*npm\\s+install.*",
-                                                                           ".*-c\\s+[\"'].*open.*[\"']w[\"'].*",
-                                                                           ".*bash.*-c.*>.*"]}}}}}}}
+                                                {:argsMatchers {"command" dangerous-commands-regexes}}}}}}
+           "explorer" {:mode "subagent"
+                       :description "Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns, search code for keywords, or answer questions about the codebase."
+                       :systemPrompt "${classpath:prompts/explorer_agent.md}"
+                       :disabledTools ["edit_file" "write_file" "move_file" "preview_file_change"]
+                       :toolCall {:approval {:allow {"eca__shell_command"
+                                                     {:argsMatchers {"command" ["pwd"]}}
+                                                     "eca__grep" {}
+                                                     "eca__read_file" {}
+                                                     "eca__directory_tree" {}}
+                                             :deny {"eca__shell_command"
+                                                    {:argsMatchers {"command" dangerous-commands-regexes}}}}}}
+           "general" {:mode "subagent"
+                      :description "General-purpose agent for researching complex questions and executing multi-step tasks. Use this agent to execute multiple units of work in parallel."
+                      :systemPrompt "${classpath:prompts/code_agent.md}"
+                      :disabledTools ["preview_file_change"]}}
    :defaultModel nil
    :prompts {:chat "${classpath:prompts/code_agent.md}" ;; default to code agent
              :chatTitle "${classpath:prompts/title.md}"