feat: add brave search container and toolset

docs/api/TOOLS.md

@@ -871,9 +871,62 @@ Search the web.
         "type": "string",
         "description": "Search query"
       },
-      "limit": {
+      "count": {
         "type": "number",
-        "description": "Number of results to return (default: 10)"
+        "description": "Number of results to return (default: 5, max: 20)"
+      },
+      "country": {
+        "type": "string",
+        "description": "Optional country code (Brave provider)"
+      },
+      "searchLang": {
+        "type": "string",
+        "description": "Optional language code (Brave provider)"
+      },
+      "safeSearch": {
+        "type": "string",
+        "description": "Brave-only safesearch mode: off | moderate | strict"
+      },
+      "freshness": {
+        "type": "string",
+        "description": "Brave freshness filter: pd | pw | pm | py"
+      }
+    },
+    "required": ["query"]
+  }
+}
+```
+
+#### `web.search.news`
+
+Search Brave News results (available when `web_search.provider: brave`).
+
+```json
+{
+  "name": "web.search.news",
+  "description": "Search Brave News and return results",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "query": {
+        "type": "string",
+        "description": "News search query"
+      },
+      "count": {
+        "type": "number",
+        "description": "Number of results to return (default: 5, max: 20)"
+      },
+      "country": {
+        "type": "string",
+        "description": "Optional country code"
+      },
+      "searchLang": {
+        "type": "string",
+        "description": "Optional language code"
+      },
+      "freshness": {
+        "type": "string",
+        "description": "Freshness filter: pd | pw | pm | py"
       }
     },
     "required": ["query"]

docs/plans/state.json

@@ -3,6 +3,37 @@
   "updated_at": "2026-02-23",
   "description": "Tracks the status of all Flynn plans and implementation phases",
   "plans": {
+    "brave-search-tooling-docs": {
+      "status": "completed",
+      "date": "2026-02-23",
+      "updated": "2026-02-23",
+      "summary": "Documented Brave web-search tooling in operator-facing docs: added README guidance for `web.search`/`web.search.news` provider config (Brave + SearXNG), Brave-specific query parameters, and clarified how the optional `brave-search` compose container relates to built-in tools. Added matching commented config block in `config/default.yaml`.",
+      "files_modified": [
+        "README.md",
+        "config/default.yaml",
+        "docs/plans/state.json"
+      ],
+      "test_status": "docs/config comments update only; no runtime code changes"
+    },
+    "brave-search-toolset-expansion": {
+      "status": "completed",
+      "date": "2026-02-23",
+      "updated": "2026-02-23",
+      "summary": "Expanded Brave web tooling with richer query controls (`country`, `searchLang`, `safeSearch`, `freshness`) and added dedicated `web.search.news` mapped to Brave's news endpoint. Updated tool policy/profile allowlists and prompt-injection secret-arg safeguards so `web.search.*` inherits network secret protections.",
+      "files_modified": [
+        "src/tools/builtin/web-search.ts",
+        "src/tools/builtin/web-search.test.ts",
+        "src/tools/builtin/index.test.ts",
+        "src/tools/builtin/index.ts",
+        "src/tools/policy.ts",
+        "src/tools/policy.test.ts",
+        "src/tools/executor.ts",
+        "src/tools/executor.test.ts",
+        "docs/api/TOOLS.md",
+        "docs/plans/state.json"
+      ],
+      "test_status": "pnpm test:run src/tools/builtin/index.test.ts src/tools/builtin/web-search.test.ts src/tools/policy.test.ts src/tools/executor.test.ts + pnpm typecheck passing"
+    },
     "dashboard-docker-dependency-controls": {
       "status": "completed",
       "date": "2026-02-23",
@@ -6132,7 +6163,7 @@
     }
   },
   "overall_progress": {
-    "total_test_count": 1942,
+    "total_test_count": 1951,
     "all_tests_passing": true,
     "p0_completion": "3/3 (100%)",
     "p1_completion": "4/4 (100%)",