synapse-orch-ai 1.5.0 → 1.5.2

package/backend/core/builder_tools.py

@@ -98,7 +98,8 @@ BUILDER_TOOL_SCHEMAS = [
             "description": (
                 "Create a new agent and save it. Returns the created agent with its new ID. "
                 "Use type='conversational' for general-purpose agents, 'code' for agents that work with repos/files, "
-                "'orchestrator' for agents that run orchestrations. "
+                "'orchestrator' for agents that run orchestrations, "
+                "'delegate' for agents that dynamically route queries to sub-agents (set delegate_agent_ids to restrict which agents it can delegate to; empty = all agents). "
                 "Set tools=['all'] to give access to all tools, or list specific tool names."
             ),
             "parameters": {
@@ -134,6 +135,11 @@ BUILDER_TOOL_SCHEMAS = [
                         "items": {"type": "string"},
                         "description": "List of DB config IDs (for agents needing database access).",
                     },
+                    "delegate_agent_ids": {
+                        "type": "array",
+                        "items": {"type": "string"},
+                        "description": "For delegate agents: list of agent IDs to restrict delegation to. Leave empty to allow delegation to any agent.",
+                    },
                 },
                 "required": ["name", "description", "type", "tools", "system_prompt"],
             },
@@ -184,6 +190,11 @@ BUILDER_TOOL_SCHEMAS = [
                                     "type": "array",
                                     "items": {"type": "string"},
                                 },
+                                "delegate_agent_ids": {
+                                    "type": "array",
+                                    "items": {"type": "string"},
+                                    "description": "For delegate agents: agent IDs to restrict delegation to. Empty = allow any agent.",
+                                },
                             },
                             "required": ["name", "description", "type", "tools", "system_prompt"],
                         },
@@ -623,6 +634,14 @@ BUILDER_TOOL_SCHEMAS = [
                     "max_turns": {"type": "integer", "description": "Max agent turns (default 15)"},
                     "timeout_seconds": {"type": "integer", "description": "Step timeout (default 300)"},
                     "model": {"type": "string", "description": "LLM model override for this step"},
+                    "include_full_history": {
+                        "type": "boolean",
+                        "description": (
+                            "For agent/llm/tool steps: on re-invocation (evaluator loop-back or retry), "
+                            "include every prior turn's inputs, tools, and output instead of only the last attempt. "
+                            "Useful for feedback loops; increases prompt length."
+                        ),
+                    },
                 },
                 "required": ["orch_id", "step_id", "name", "type"],
             },
@@ -679,6 +698,7 @@ BUILDER_TOOL_SCHEMAS = [
                                 "max_turns": {"type": "integer"},
                                 "timeout_seconds": {"type": "integer"},
                                 "model": {"type": "string"},
+                                "include_full_history": {"type": "boolean", "description": "Include full revision history on re-invocation (agent/llm/tool steps)"},
                             },
                             "required": ["step_id", "name", "type"],
                         },
@@ -752,6 +772,7 @@ async def _dispatch(tool_name: str, args: dict, server_module: Any) -> Any:
             "model": args.get("model") or None,
             "provider": None,
             "max_turns": None,
+            "delegate_agent_ids": args.get("delegate_agent_ids", []) or [],
         }
         agents.append(agent)
         save_user_agents(agents)
@@ -793,6 +814,7 @@ async def _dispatch(tool_name: str, args: dict, server_module: Any) -> Any:
                     "model": spec.get("model") or None,
                     "provider": None,
                     "max_turns": None,
+                    "delegate_agent_ids": spec.get("delegate_agent_ids", []) or [],
                 }
                 agents.append(agent)
                 created.append({
@@ -1559,6 +1581,7 @@ def _fill_step_defaults(steps: list) -> list:
         s.setdefault("switch_expression", None)
         s.setdefault("switch_cases", {})
         s.setdefault("switch_default_step_id", None)
+        s.setdefault("include_full_history", None)
         result.append(s)
     return result
 

package/backend/core/models.py

@@ -59,7 +59,7 @@ class Repo(BaseModel):
     name: str
     path: str
     description: str = ""
-    included_patterns: list[str] = ["*.py", "*.ts", "*.tsx", "*.js", "*.jsx", "*.rs", "*.go", "*.java", "*.md", "*.html", "*.vue", "*.css", "*.scss", "*.cpp", "*.c"]
+    included_patterns: list[str] = ["*.py", "*.ts", "*.tsx", "*.js", "*.jsx", "*.rs", "*.go", "*.java", "*.md", "*.html", "*.vue", "*.svelte", "*.css", "*.scss", "*.cpp", "*.c"]
     excluded_patterns: list[str] = [".*", "node_modules", "__pycache__", "venv", ".git", "*.pyc"]
     last_indexed: str | None = None
     status: str = "pending" # pending | indexing | indexed | error
@@ -152,6 +152,7 @@ class GeneratePromptRequest(BaseModel):
     agent_type: str = "conversational"
     tools: list[str] = []
     existing_prompt: str = ""
+    agents: list[dict] = []  # list of {id, name, description, type} — for delegate agents
 
 
 class GoogleCredsRequest(BaseModel):

package/backend/core/native_builder/__init__.py

@@ -24,7 +24,7 @@ __all__ = [
 # their zero-defaults (`route_map: {}`, `parallel_branches: []`, etc.) so the
 # engine deserialises cleanly.
 STEP_TYPE_CHEATSHEET = """\
-- **agent**: runs a configured sub-agent with a prompt + its tool set. Required: `agent_id`, `prompt_template`. Use for any step that needs multi-turn reasoning or tool use.
+- **agent**: runs a configured sub-agent with a prompt + its tool set. Required: `agent_id`, `prompt_template`. Optional: `include_full_history` (bool) — on re-invocation show every prior turn's inputs/tools/output instead of only the last attempt; useful for feedback/retry loops. Use for any step that needs multi-turn reasoning or tool use.
 - **llm**: single one-shot LLM call, no tools. Required: `prompt_template` (optional `model`). Use for lightweight summarisation, rewriting, or deterministic prose generation.
 - **tool**: forces a single tool call with no LLM reasoning. Required: `forced_tool` (+ `agent_id` for tool-resolution). Use when the arguments are already in state and just need forwarding.
 - **evaluator**: pure routing node. Required: `route_map_json` (JSON-encoded `{label: target_step_id}`), `route_descriptions_json` (JSON), `evaluator_prompt`. Output_key stores the bare route label. Use to fork on a classifier decision.

package/backend/core/native_builder/agents/agent_creator.json

@@ -16,5 +16,5 @@
     ],
     "repos": [],
     "db_configs": [],
-    "system_prompt": "# Role\nYou are the Agent Creator for the Synapse AI Builder. You run AFTER a plan draft has been approved, and only when the plan needs new sub-agents that do not already exist.\n\n# Inputs you receive (via state)\n- `plan_draft` — the approved human-readable plan draft. It lists each role. For each new agent it includes bullets for **purpose**, **tools**, **repos**, and **type**.\n- `selected_agent_ids` — agent IDs the user pre-selected. Treat these as already-existing; do NOT recreate them.\n- `can_create_agents` — must be true to reach this step. If it is somehow false, emit an empty Markdown summary with a note and stop.\n\n# What to do — strict order\n\n1. **Parse the draft.** Read the **New agents to create** section. For each entry collect: role label, name, description, type (`conversational` / `code` / `orchestrator`), tools list, repos list, db_configs list (if any), and a focused single-paragraph system prompt specific to the role.\n\n2. **Resolve repo IDs (only if any new agent has a non-empty repos list).** Call `list_repos` ONCE. Match repo names from the draft to real repo IDs. If a referenced repo does not exist, omit it from that agent's `repos` and note the miss in your final output (do not invent IDs).\n\n3. **Create the agents in ONE batch.** Call `create_agents` exactly once with the full array. This is mandatory whenever more than one new agent is needed — it avoids context bloat and timeouts. Only fall back to `create_agent` (single) if `create_agents` returned an error AND you are creating exactly one agent.\n\n4. **Emit the Markdown summary.** Your final message MUST be only the Markdown agent list below — no preamble, no JSON. One `##` section per agent (new AND pre-existing). For pre-existing agents set **Existing:** yes.\n\n## <Agent Name>\n**Role:** <role label from plan>\n**ID:** <agent_id>\n**Type:** <conversational|code|orchestrator>\n**Description:** <one-line description>\n**Tools:** [tool1, tool2, ...]\n**Repos:** [repo_id, ...] *(omit line if repos is empty)*\n**Existing:** yes|no\n\nInclude BOTH newly-created agents AND pre-existing agents that the draft referenced (from `selected_agent_ids` or explicit `agent_xxxxxxx` IDs in the draft).\n\n# MCP tool names in agent `tools` lists\nWhen the plan specifies MCP server tools for a new agent:\n1. Call `list_tool_servers` ONCE to see available servers (name + type).\n2. Call `list_server_tools(server_name)` to get the raw tool names for any server the plan references.\n3. Compose the correct tool name:\n   - **External MCP** (type = `stdio`, `sse`, or `external_mcp`): `\"{server_name}__{raw_tool_name}\"` (double underscore). Example: server `github`, tool `search_repositories` → `\"github__search_repositories\"`.\n   - **Native MCP** (type = `native_mcp`): just `\"{raw_tool_name}\"` — no prefix.\n4. Use these composed names in the `tools` array when calling `create_agents`.\n\nNever guess MCP tool names — always discover them via the tools above.\n\n# Hard rules\n- **Never invent agent IDs.** Every `**ID:**` in the summary must come from either a `create_agents`/`create_agent` response OR the draft's existing references. If you did not call the tool, you do not have an ID. Period.\n- **Never modify existing agents** in this step.\n- **Keep each new agent's system prompt tight and role-specific.** Do not copy the full plan into it.\n- **Narrow `tools` list.** Include only what the role actually needs. Never `[\"all\"]` unless the role genuinely needs everything.\n- **Repos belong on `code`-type agents** (or any agent that must read/write code). Conversational agents usually have `repos: []`.\n- **Output only the Markdown summary** — no preamble, no explanations, no JSON. The saver reads this directly.\n- If `create_agents` returns `errors` for some specs, still emit the Markdown summary for whatever was successfully created and append a line `**Errors:** <error details>` at the bottom.\n\n# Tool-call budget\n- `list_repos`: at most 1 call\n- `list_agents` / `get_agent`: at most 1 call total, only if you need to verify a pre-existing ID\n- `get_tools_detail`: only if you need to confirm a tool name before attaching it to an agent\n- `create_agents`: exactly 1 call when creating >1 agent\n- `create_agent`: only as a fallback for single-agent creation\n\nStay under 8 turns. Do NOT retry a failed `create_agents` call more than once."
+    "system_prompt": "# Role\nYou are the Agent Creator for the Synapse AI Builder. You run AFTER a plan draft has been approved, and only when the plan needs new sub-agents that do not already exist.\n\n# Inputs you receive (via state)\n- `plan_draft` — the approved human-readable plan draft. It lists each role. For each new agent it includes bullets for **purpose**, **tools**, **repos**, and **type**.\n- `selected_agent_ids` — agent IDs the user pre-selected. Treat these as already-existing; do NOT recreate them.\n- `can_create_agents` — must be true to reach this step. If it is somehow false, emit an empty Markdown summary with a note and stop.\n\n# What to do — strict order\n\n1. **Parse the draft.** Read the **New agents to create** section. For each entry collect: role label, name, description, type (`conversational` / `code` / `orchestrator` / `delegate`), tools list, repos list, db_configs list (if any), delegate_agent_ids list (for delegate type only — empty list means any agent), and a focused single-paragraph system prompt specific to the role.\n\n2. **Resolve repo IDs (only if any new agent has a non-empty repos list).** Call `list_repos` ONCE. Match repo names from the draft to real repo IDs. If a referenced repo does not exist, omit it from that agent's `repos` and note the miss in your final output (do not invent IDs).\n\n3. **Create the agents in ONE batch.** Call `create_agents` exactly once with the full array. This is mandatory whenever more than one new agent is needed — it avoids context bloat and timeouts. Only fall back to `create_agent` (single) if `create_agents` returned an error AND you are creating exactly one agent.\n\n4. **Emit the Markdown summary.** Your final message MUST be only the Markdown agent list below — no preamble, no JSON. One `##` section per agent (new AND pre-existing). For pre-existing agents set **Existing:** yes.\n\n## <Agent Name>\n**Role:** <role label from plan>\n**ID:** <agent_id>\n**Type:** <conversational|code|orchestrator|delegate>\n**Description:** <one-line description>\n**Tools:** [tool1, tool2, ...]\n**Repos:** [repo_id, ...] *(omit line if repos is empty)*\n**Existing:** yes|no\n\nInclude BOTH newly-created agents AND pre-existing agents that the draft referenced (from `selected_agent_ids` or explicit `agent_xxxxxxx` IDs in the draft).\n\n# MCP tool names in agent `tools` lists\nWhen the plan specifies MCP server tools for a new agent:\n1. Call `list_tool_servers` ONCE to see available servers (name + type).\n2. Call `list_server_tools(server_name)` to get the raw tool names for any server the plan references.\n3. Compose the correct tool name:\n   - **External MCP** (type = `stdio`, `sse`, or `external_mcp`): `\"{server_name}__{raw_tool_name}\"` (double underscore). Example: server `github`, tool `search_repositories` → `\"github__search_repositories\"`.\n   - **Native MCP** (type = `native_mcp`): just `\"{raw_tool_name}\"` — no prefix.\n4. Use these composed names in the `tools` array when calling `create_agents`.\n\nNever guess MCP tool names — always discover them via the tools above.\n\n# Hard rules\n- **Never invent agent IDs.** Every `**ID:**` in the summary must come from either a `create_agents`/`create_agent` response OR the draft's existing references. If you did not call the tool, you do not have an ID. Period.\n- **Never modify existing agents** in this step.\n- **Keep each new agent's system prompt tight and role-specific.** Do not copy the full plan into it.\n- **Narrow `tools` list.** Include only what the role actually needs. Never `[\"all\"]` unless the role genuinely needs everything.\n- **Repos belong on `code`-type agents** (or any agent that must read/write code). Conversational agents usually have `repos: []`.\n- **`delegate_agent_ids` belongs on `delegate`-type agents only.** Pass the list of agent IDs the agent may route to, or an empty list to allow routing to any agent. Omit this field for all other types.\n- **Output only the Markdown summary** — no preamble, no explanations, no JSON. The saver reads this directly.\n- If `create_agents` returns `errors` for some specs, still emit the Markdown summary for whatever was successfully created and append a line `**Errors:** <error details>` at the bottom.\n\n# Tool-call budget\n- `list_repos`: at most 1 call\n- `list_agents` / `get_agent`: at most 1 call total, only if you need to verify a pre-existing ID\n- `get_tools_detail`: only if you need to confirm a tool name before attaching it to an agent\n- `create_agents`: exactly 1 call when creating >1 agent\n- `create_agent`: only as a fallback for single-agent creation\n\nStay under 8 turns. Do NOT retry a failed `create_agents` call more than once."
 }

package/backend/core/native_builder/orchestration.json

@@ -196,7 +196,7 @@
             "name": "Draft Plan",
             "type": "llm",
             "agent_id": null,
-            "prompt_template": "You are the Plan Drafter for the Synapse AI Builder. Produce a HUMAN-READABLE markdown draft of the orchestration plan. The user will read this next and either approve it or send revision feedback. After approval, a saver agent reads this draft to materialise the real orchestration JSON, so the draft must be precise enough to act on.\n\n# Inputs\nIntent: {state.intent}\n\nRequirements spec:\n{state.requirements}\n\nExisting orchestration (only on update; empty otherwise):\n{state.existing_orch}\n\nPre-selected agent IDs: {state.selected_agent_ids}\nCan create new agents: {state.can_create_agents}\n\nPrevious draft (empty on first pass):\n{state.plan_draft}\n\nUser's revision feedback on the previous draft (empty on first pass):\n{state.review_feedback}\n\n# Step-type palette (use these — never invent a type)\n{{STEP_TYPE_CHEATSHEET}}\n\n# What to write\nMarkdown with these sections, in this order:\n\n## Overview\nOne paragraph: what the orchestration does end-to-end. On update, call out what is changing vs the existing definition.\n\n## State schema\nBullet list of state keys with type and one-line purpose.\n\n## Steps\nNumbered list. For each step:\n- **Name** (step type: one of agent / llm / evaluator / human / parallel / merge / loop / transform / tool / end)\n- What it does, its input keys, its output key, and its next step (or route map for evaluators).\n- For agent steps: role name AND whether it maps to an existing agent (`agent_xxxxxxx`) or a NEW agent to create (describe its job + tools).\n- For tool steps: the forced tool name. If you are uncertain a tool exists, flag it under Open questions rather than guessing.\n- For human steps: the prompt the user will see and the fields collected.\n\n## Agents summary\nTwo short lists:\n- **Existing agents reused**: one line each — `role → agent_id (name)`.\n- **New agents to create**: one block per new agent. Each block uses this exact shape so the downstream Agent Creator can parse it deterministically:\n  - `role: <role_label>` — short identifier used elsewhere in the plan (e.g. `question_generator`).\n  - `name: <Display Name>` — what the agent will be called.\n  - `type: conversational | code | orchestrator` — pick `code` ONLY if the agent reads/writes a repo; pick `orchestrator` only if it runs a sub-orchestration; everything else is `conversational`.\n  - `purpose: <one sentence>` — what this agent does end-to-end.\n  - `tools: [tool_name, tool_name]` — narrow list, only what the role needs. Use real tool names (confirmed by the analyst via `get_tools_detail`). Never `[\"all\"]`.\n  - `repos: [repo_id, repo_id]` — real repo IDs from `list_repos`. Use `[]` for conversational agents that do not touch code.\n  - `db_configs: [db_id]` — real DB IDs from `list_db_configs`. Use `[]` if none.\n\n  (If `can_create_agents` is false, still list the blocks and add a `status: CANNOT CREATE — creation disabled` line so the user can enable it or pre-select an existing agent.)\n\n## Flow\nClose with a fenced code block tagged `flow` showing the wiring as ASCII. Use the role/step name (not a fabricated step_id) and label the type. Example shape:\n\n```flow\nintake (agent: analyst)\n    ↓\nroute (evaluator)\n    ├─ a → process (llm)\n    └─ b → fallback (human)\n         ↓\n       end (end)\n```\n\nKeep it scannable — one node per line, one arrow per edge, evaluator branches with `├─`/`└─`, convergence shown by sharing the next line. The user uses this diagram to sanity-check wiring before approval.\n\n## Open questions\nOnly include this section if something is genuinely ambiguous. One bullet per question.\n\n# Rules\n- Write plain markdown, no code fences around the whole thing (the `flow` block is the only fenced block).\n- If `review_feedback` is non-empty, treat the previous draft as a starting point and revise per the feedback — do not start from scratch unless the user asked you to.\n- Do NOT produce raw orchestration JSON here. This is the human-facing draft. The JSON is produced by the saver agent later.\n- Keep it concise — the user will read this.",
+            "prompt_template": "You are the Plan Drafter for the Synapse AI Builder. Produce a HUMAN-READABLE markdown draft of the orchestration plan. The user will read this next and either approve it or send revision feedback. After approval, a saver agent reads this draft to materialise the real orchestration JSON, so the draft must be precise enough to act on.\n\n# Inputs\nIntent: {state.intent}\n\nRequirements spec:\n{state.requirements}\n\nExisting orchestration (only on update; empty otherwise):\n{state.existing_orch}\n\nPre-selected agent IDs: {state.selected_agent_ids}\nCan create new agents: {state.can_create_agents}\n\nPrevious draft (empty on first pass):\n{state.plan_draft}\n\nUser's revision feedback on the previous draft (empty on first pass):\n{state.review_feedback}\n\n# Step-type palette (use these — never invent a type)\n{{STEP_TYPE_CHEATSHEET}}\n\n# What to write\nMarkdown with these sections, in this order:\n\n## Overview\nOne paragraph: what the orchestration does end-to-end. On update, call out what is changing vs the existing definition.\n\n## State schema\nBullet list of state keys with type and one-line purpose.\n\n## Steps\nNumbered list. For each step:\n- **Name** (step type: one of agent / llm / evaluator / human / parallel / merge / loop / transform / tool / end)\n- What it does, its input keys, its output key, and its next step (or route map for evaluators).\n- For agent steps: role name AND whether it maps to an existing agent (`agent_xxxxxxx`) or a NEW agent to create (describe its job + tools).\n- For tool steps: the forced tool name. If you are uncertain a tool exists, flag it under Open questions rather than guessing.\n- For human steps: the prompt the user will see and the fields collected.\n\n## Agents summary\nTwo short lists:\n- **Existing agents reused**: one line each — `role → agent_id (name)`.\n- **New agents to create**: one block per new agent. Each block uses this exact shape so the downstream Agent Creator can parse it deterministically:\n  - `role: <role_label>` — short identifier used elsewhere in the plan (e.g. `question_generator`).\n  - `name: <Display Name>` — what the agent will be called.\n  - `type: conversational | code | orchestrator | delegate` — pick `code` ONLY if the agent reads/writes a repo; pick `orchestrator` only if it runs a sub-orchestration; pick `delegate` if the agent dynamically routes to sub-agents; everything else is `conversational`.\n  - `delegate_agent_ids: [agent_id, ...]` — ONLY for delegate type: restrict which agents it can route to. Use `[]` to allow all agents.\n  - `purpose: <one sentence>` — what this agent does end-to-end.\n  - `tools: [tool_name, tool_name]` — narrow list, only what the role needs. Use real tool names (confirmed by the analyst via `get_tools_detail`). Never `[\"all\"]`.\n  - `repos: [repo_id, repo_id]` — real repo IDs from `list_repos`. Use `[]` for conversational agents that do not touch code.\n  - `db_configs: [db_id]` — real DB IDs from `list_db_configs`. Use `[]` if none.\n\n  (If `can_create_agents` is false, still list the blocks and add a `status: CANNOT CREATE — creation disabled` line so the user can enable it or pre-select an existing agent.)\n\n## Flow\nClose with a fenced code block tagged `flow` showing the wiring as ASCII. Use the role/step name (not a fabricated step_id) and label the type. Example shape:\n\n```flow\nintake (agent: analyst)\n    ↓\nroute (evaluator)\n    ├─ a → process (llm)\n    └─ b → fallback (human)\n         ↓\n       end (end)\n```\n\nKeep it scannable — one node per line, one arrow per edge, evaluator branches with `├─`/`└─`, convergence shown by sharing the next line. The user uses this diagram to sanity-check wiring before approval.\n\n## Open questions\nOnly include this section if something is genuinely ambiguous. One bullet per question.\n\n# Rules\n- Write plain markdown, no code fences around the whole thing (the `flow` block is the only fenced block).\n- If `review_feedback` is non-empty, treat the previous draft as a starting point and revise per the feedback — do not start from scratch unless the user asked you to.\n- Do NOT produce raw orchestration JSON here. This is the human-facing draft. The JSON is produced by the saver agent later.\n- Keep it concise — the user will read this.",
             "route_map": {},
             "route_descriptions": {},
             "evaluator_prompt": null,

package/backend/core/routes/agents.py

@@ -104,6 +104,7 @@ Before writing, reason through:
   - `conversational` — multi-turn; handle context shifts and follow-ups
   - `code` — precision required; read before write, cite paths/lines
   - `orchestrator` — decompose tasks, manage sub-agent handoffs, synthesize results
+  - `delegate` — dynamic router; receives queries and routes to sub-agents via delegate_to_agent tool; focus on routing logic, clear task framing, and synthesizing results
 - **Failure Modes:** Where will this agent most likely hallucinate, go off-scope, or stall?
 
 ━━━ PHASE 2: GENERATE THE SYSTEM PROMPT ━━━
@@ -284,6 +285,23 @@ async def generate_agent_prompt(req: GeneratePromptRequest):
             f"---\n{req.existing_prompt.strip()}\n---"
         )
 
+    # Build delegate sub-agents section (only for delegate-type agents)
+    delegates_section = ""
+    if req.agent_type == "delegate" and req.agents:
+        agent_lines = "\n".join(
+            f"  - [{a.get('id', '')}] {a.get('name', '')} ({a.get('type', 'conversational')})"
+            + (f": {a['description']}" if a.get('description') else "")
+            for a in req.agents
+        )
+        delegates_section = (
+            f"\n\n━━━ AVAILABLE SUB-AGENTS (delegation targets) ━━━\n"
+            f"This delegate agent can route tasks to the following sub-agents:\n"
+            f"{agent_lines}\n"
+            f"\nThe generated prompt should reference these agents by name where relevant, "
+            f"describe how to decide which agent to delegate to, and explain how to synthesize "
+            f"results when multiple agents are involved."
+        )
+
     user_message = (
         f"Current Date & Time: {current_datetime}\n\n"
         f"━━━ AGENT TYPE ━━━\n"
@@ -295,6 +313,7 @@ async def generate_agent_prompt(req: GeneratePromptRequest):
         f"What problem are they trying to solve? What would make this agent "
         f"genuinely useful vs. just technically correct?"
         f"{tools_section}"
+        f"{delegates_section}"
         f"{existing_section}"
     )
 

package/backend/core/routes/repos.py

@@ -3,11 +3,16 @@ Repo management endpoints (CRUD + reindex).
 """
 import os
 import json
-from fastapi import APIRouter, HTTPException, BackgroundTasks
+from fastapi import APIRouter, HTTPException, BackgroundTasks, Body
+from pydantic import BaseModel
 from core.models import Repo
 from core.config import DATA_DIR, load_settings
 from core.json_store import JsonStore
 
+
+class ReindexOptions(BaseModel):
+    full_reindex: bool = False
+
 router = APIRouter()
 
 _repos_store = JsonStore(os.path.join(DATA_DIR, "repos.json"))
@@ -147,7 +152,8 @@ async def delete_repo(repo_id: str):
     return {"status": "success"}
 
 @router.post("/api/repos/{repo_id}/reindex")
-async def reindex_repo(repo_id: str, background_tasks: BackgroundTasks):
+async def reindex_repo(repo_id: str, background_tasks: BackgroundTasks,
+                       opts: ReindexOptions = Body(default=ReindexOptions())):
     repos = load_repos()
     repo = next((r for r in repos if r["id"] == repo_id), None)
     if not repo:
@@ -174,14 +180,16 @@ async def reindex_repo(repo_id: str, background_tasks: BackgroundTasks):
     # Run in background
     try:
         from services.code_indexer import run_index
-        background_tasks.add_task(run_index, repo_id, real_path, repo["included_patterns"], repo["excluded_patterns"])
+        background_tasks.add_task(run_index, repo_id, real_path,
+                                  repo["included_patterns"], repo["excluded_patterns"],
+                                  opts.full_reindex)
     except ImportError as e:
         print("Indexer unavailable:", e)
         repo["status"] = "error"
         save_repos(repos)
         raise HTTPException(status_code=500, detail="Indexer service not available")
 
-    return {"status": "indexing_started"}
+    return {"status": "indexing_started", "full_reindex": opts.full_reindex}
 
 
 @router.post("/api/repos/{repo_id}/stop-index")

package/backend/core/routes/tools.py

@@ -35,6 +35,21 @@ async def get_custom_tools():
     return load_custom_tools()
 
 
+_NATIVE_SERVER_LABELS: dict[str, str] = {
+    "code_vault_search": "Code Search",
+    "time": "Time & Date",
+    "sql": "SQL Database",
+    "personal_details": "Personal Details",
+    "collect_data": "Collect Data",
+    "pdf_parser": "PDF Parser",
+    "xlsx_parser": "Excel / XLSX",
+    "vault_sandbox": "Vault Sandbox",
+    "web_scraper": "Web Scraper",
+    "bash": "Bash",
+    "Filesystem": "Filesystem",
+}
+
+
 @router.get("/api/tools/available")
 async def get_available_tools():
     """List all available tools from all sources (Native Agents, External MCP, Custom HTTP)"""
@@ -54,7 +69,7 @@ async def get_available_tools():
                 cfg = _server.mcp_manager.get_server_config(server_name)
                 display_label = (cfg.get("label") or server_name) if cfg else server_name
             else:
-                display_label = server_name
+                display_label = _NATIVE_SERVER_LABELS.get(server_name, server_name)
 
             result = await session.list_tools()
             for t in result.tools:

package/backend/core/server.py

@@ -189,7 +189,7 @@ def _build_native_mcp_servers() -> list[dict]:
         servers.append({
             "name": "Browser Automation",
             "command": _NPX_CMD,
-            "args": ["-y", "@playwright/mcp@latest", "--browser", "chromium", "--output-dir", "data/vault/playwright"],
+            "args": ["-y", "@playwright/mcp@latest", "--browser", "chrome", "--output-dir", "data/vault/playwright"],
             "env": env_dict,
         })
 

package/backend/core/tools.py

@@ -29,6 +29,10 @@ DEFAULT_TOOLS_BY_TYPE = {
     },
     "code": {
         "search_codebase",
+        "multi_repo_search",
+        "find_similar_code",
+        "list_indexed_files",
+        "get_file_chunks",
     },
     "orchestrator": set(),  # orchestrator agents delegate to sub-agents; no extra tools needed
     "delegate": set(),      # delegate agents route to sub-agents via synthetic delegate_to_agent tool
@@ -90,10 +94,12 @@ async def aggregate_all_tools(agent_sessions, active_agent, custom_tools_list):
                 if tool_name not in allowed_tools:
                     allowed_tools.append(tool_name)
 
-    # Remove search_codebase if embed_code is disabled
+    # Remove embedding tools if embed_code is disabled
     settings = load_settings()
     if not settings.get("embed_code", False):
-        allowed_tools = [t for t in allowed_tools if t != "search_codebase"]
+        _embed_tools = {"search_codebase", "multi_repo_search", "find_similar_code",
+                        "list_indexed_files", "get_file_chunks"}
+        allowed_tools = [t for t in allowed_tools if t not in _embed_tools]
 
     # Standard MCP Tools
     for session_name, session in agent_sessions.items():
@@ -207,6 +213,18 @@ def build_system_prompt(agent_system_template, tools_json, session_id, session_s
     """
     # Determine if code embedding is enabled (for conditional tool description)
     _embed_code = load_settings().get("embed_code", False)
+    _embed_tools_desc = (
+        "- **`search_codebase`** - semantic search within specific repos. Requires `repo_ids`."
+        " Add `file_filter` (e.g. `.py`, `components`) to narrow results.\n"
+        "- **`multi_repo_search`** - like search_codebase but `repo_ids` is optional;"
+        " omit to search ALL indexed repos at once.\n"
+        "- **`find_similar_code`** - pass a code snippet to find similar patterns across repos"
+        " (vs. natural language in search_codebase).\n"
+        "- **`list_indexed_files`** - list every file in the embedding index with chunk counts."
+        " Use before searching to understand coverage.\n"
+        "- **`get_file_chunks`** - retrieve all indexed chunks for a specific file"
+        " (the semantic outline). Use after finding a relevant file."
+    ) if _embed_code else ""
 
     # Get current date/time for context injection
     now = datetime.datetime.now(zoneinfo.ZoneInfo("UTC"))
@@ -279,7 +297,7 @@ You have access to the following tools:
 {tools_json}
 
 **CODE & FILE NAVIGATION:**
-{"- **`search_codebase`** — semantic search across indexed repos. Requires `repo_ids`. Best for broad symbol or concept search." if _embed_code else ""}
+{_embed_tools_desc}
 - **`grep`** — search for a pattern inside a file or across all files in a folder. Pass a file path to search that file, or a folder path to search all files within it. Use `file_pattern` to filter by extension (e.g. `*.py`, `*.ts`).
 - **`glob`** — discover file paths by pattern (e.g. `**/*.py`, `src/**/*.ts`).
 - **`read_file`** — read an entire file. Use when you already know the path and the file is small. For large files, prefer `read_file_by_lines` or `grep`.

package/backend/services/code_indexer.py

@@ -356,6 +356,31 @@ def get_index_status(repo_id: str) -> dict:
         return {"status": "error", "message": str(e), "count": 0}
 
 
+def _get_current_vector_dim(repo_id: str) -> int | None:
+    """Return the vector column dimension currently in the DB, or None if absent."""
+    if not COCOINDEX_AVAILABLE:
+        return None
+    table_name = get_table_name(repo_id)
+    db_url = _get_db_url()
+    if not db_url:
+        return None
+    try:
+        with psycopg.connect(db_url) as conn:
+            with conn.cursor() as cur:
+                cur.execute("""
+                    SELECT atttypmod
+                    FROM pg_attribute
+                    JOIN pg_class ON pg_class.oid = pg_attribute.attrelid
+                    WHERE pg_class.relname = %s
+                      AND pg_attribute.attname = 'embedding'
+                      AND atttypmod > 0
+                """, (table_name,))
+                row = cur.fetchone()
+                return row[0] if row else None
+    except Exception:
+        return None
+
+
 def drop_index(repo_id: str):
     """Drop all tables and CocoIndex metadata for a repo — ensures clean rebuild."""
     if not COCOINDEX_AVAILABLE:
@@ -399,7 +424,7 @@ def _update_repo_status(repo_id: str, **fields):
             json.dump(repos, f, indent=4)
 
 
-def run_index_task(repo_id: str, repo_path: str, included_patterns: list[str], excluded_patterns: list[str]):
+def run_index_task(repo_id: str, repo_path: str, included_patterns: list[str], excluded_patterns: list[str], full_reindex: bool = True):
     if not COCOINDEX_AVAILABLE:
         msg = (
             "CocoIndex not installed in the backend venv — indexing skipped.\n"
@@ -416,11 +441,31 @@ def run_index_task(repo_id: str, repo_path: str, included_patterns: list[str], e
     stop = _stop_events.setdefault(repo_id, threading.Event())
     stop.clear()  # reset from any previous stop request
 
-    print(f"Starting index builder for {repo_id}...")
+    print(f"Starting index builder for {repo_id} (full_reindex={full_reindex})...")
     _update_repo_status(repo_id, status="indexing", error_message=None)
     try:
-        print("[index] Step 0: drop stale tables + CocoIndex metadata")
-        drop_index(repo_id)
+        if full_reindex:
+            print("[index] Step 0: drop stale tables + CocoIndex metadata")
+            drop_index(repo_id)
+        else:
+            # Schema guard: if the embedding dim stored in the DB differs from the currently
+            # configured model's dim, a full rebuild is unavoidable (vector columns are fixed-width).
+            try:
+                model = get_configured_embedding_model()
+                settings = load_settings()
+                dim = probe_embedding_dim(model, settings)
+                current_dim = _get_current_vector_dim(repo_id)
+                if current_dim is not None and current_dim != dim:
+                    print(f"[index] Embedding dim changed ({current_dim} → {dim}), promoting to full reindex")
+                    drop_index(repo_id)
+                    full_reindex = True
+                else:
+                    print("[index] Incremental reindex — tracking table preserved, only changed files will be processed")
+            except Exception as e:
+                print(f"[index] Schema check failed ({e}), falling back to full reindex")
+                drop_index(repo_id)
+                full_reindex = True
+
         if stop.is_set():
             print(f"[index] Stop requested after step 0 — aborting {repo_id}")
             _update_repo_status(repo_id, status="stopped", error_message=None)
@@ -451,7 +496,10 @@ def run_index_task(repo_id: str, repo_path: str, included_patterns: list[str], e
         # update() is a long-running Rust call — we can't interrupt it mid-way,
         # but we check the stop flag immediately after it returns.
         print("[index] Step 4: repo_flow.update()")
-        repo_flow.update(full_reprocess=True)
+        if full_reindex:
+            repo_flow.update(full_reprocess=True)
+        else:
+            repo_flow.update()  # incremental — CocoIndex processes only changed/new files
 
         if stop.is_set():
             print(f"[index] Stop requested — marking {repo_id} as stopped")
@@ -493,10 +541,10 @@ def stop_index(repo_id: str) -> bool:
     return False
 
 
-def run_index(repo_id: str, repo_path: str, included_patterns: list[str], excluded_patterns: list[str]):
+def run_index(repo_id: str, repo_path: str, included_patterns: list[str], excluded_patterns: list[str], full_reindex: bool = True):
     t = threading.Thread(
         target=run_index_task,
-        args=(repo_id, repo_path, included_patterns, excluded_patterns),
+        args=(repo_id, repo_path, included_patterns, excluded_patterns, full_reindex),
         daemon=True,
     )
     _active_threads[repo_id] = t