chore: bump version to 1.8.6

- Bump core, node-sdk, and python-sdk to 1.8.6
- Add HeadlessConfig and BrowserBackend types to config
- Add WebSearchParams type and web_search() method to SDKs
- Fix issue #25: return error on unknown params (engine vs engines)
- Change engines parameter type from string to array in schema
- Update changelog

Author: claude

CHANGELOG.md

@@ -5,11 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] - 2026-04-05
+## [Unreleased] - 2026-04-10
 
 ---
 
-## [v1.7.0] - 2026-04-05
+## [v1.8.6] - 2026-04-10
+
+### Fixed
+
+#### web_search Tool
+
+- **Issue #25 Fix**: The `web_search` tool now returns an error when unknown parameters are passed (e.g., `engine` instead of `engines`). Previously, unknown parameters were silently ignored, causing confusion when users specified the wrong field name.
+
+### Changed
+
+- `engines` parameter type changed from `string` to `array` in schema to match actual API
+- Updated a3s-search integration to v1.0.0
+
+---
+
+## [v1.8.5] - 2026-04-05
 
 ### Added
 

core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "a3s-code-core"
-version = "1.8.5"
+version = "1.8.6"
 edition = "2021"
 authors = ["A3S Lab Team"]
 license = "MIT"

core/skills/builtin-tools.md

@@ -265,8 +265,10 @@ tools:
           type: string
           description: The search query
         engines:
-          type: string
-          description: "Comma-separated list of engines to use (default: ddg,wiki). Available: ddg, brave, google, wiki, baidu, sogou, bing_cn, 360"
+          type: array
+          items:
+            type: string
+          description: "List of engines to use (default: [\"ddg\",\"wiki\"]). Available: ddg (DuckDuckGo), brave (Brave Search), wiki (Wikipedia), sogou (Sogou), 360 / so360 (360 Search). Note: use 'engines' (plural), not 'engine' (singular)."
         limit:
           type: integer
           description: "Maximum number of results to return (default: 10, max: 50)"
@@ -381,7 +383,7 @@ Parameters are passed as JSON objects matching each tool's parameter schema defi
 {"url": "https://example.com", "format": "markdown", "timeout": 30}
 
 // Search the web
-{"query": "rust async programming", "engines": "ddg,wiki", "limit": 10}
+{"query": "rust async programming", "engines": ["ddg", "wiki"], "limit": 10}
 ```
 
 ### Git Operations

core/src/config.rs

@@ -317,6 +317,60 @@ pub struct SearchConfig {
     /// Engine configurations
     #[serde(default, rename = "engine")]
     pub engines: std::collections::HashMap<String, SearchEngineConfig>,
+
+    /// Headless browser configuration for JS-rendered engines (google, baidu, bing_cn).
+    /// When enabled, the browser binary is auto-detected or downloaded.
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub headless: Option<HeadlessConfig>,
+}
+
+/// Headless browser backend selection.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
+#[serde(rename_all = "lowercase")]
+pub enum BrowserBackend {
+    /// Chrome/Chromium headless. Auto-detected or downloaded from Google.
+    Chrome,
+    /// Lightpanda headless browser. Auto-detected or downloaded from GitHub.
+    /// Supported on Linux and macOS only.
+    Lightpanda,
+}
+
+impl Default for BrowserBackend {
+    fn default() -> Self {
+        BrowserBackend::Chrome
+    }
+}
+
+/// Headless browser configuration.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct HeadlessConfig {
+    /// Which headless backend to use.
+    #[serde(default)]
+    pub backend: BrowserBackend,
+
+    /// Path to the browser executable. If None, auto-detected or downloaded.
+    #[serde(default, skip_serializing_if = "Option::is_none")]
+    pub browser_path: Option<String>,
+
+    /// Maximum number of concurrent browser tabs.
+    #[serde(default = "default_headless_max_tabs")]
+    pub max_tabs: usize,
+
+    /// Additional launch arguments for the browser.
+    #[serde(default, skip_serializing_if = "Vec::is_empty")]
+    pub launch_args: Vec<String>,
+}
+
+impl Default for HeadlessConfig {
+    fn default() -> Self {
+        Self {
+            backend: BrowserBackend::default(),
+            browser_path: None,
+            max_tabs: 4,
+            launch_args: Vec::new(),
+        }
+    }
 }
 
 /// Default configuration for the built-in `agentic_search` tool.
@@ -593,6 +647,10 @@ fn default_search_timeout() -> u64 {
     10
 }
 
+fn default_headless_max_tabs() -> usize {
+    4
+}
+
 fn default_max_failures() -> u32 {
     3
 }

sdk/node/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "a3s-code-node"
-version = "1.8.5"
+version = "1.8.6"
 edition = "2021"
 authors = ["A3S Lab Team"]
 license = "MIT"
@@ -11,7 +11,7 @@ description = "A3S Code Node.js bindings - Native addon via napi-rs"
 crate-type = ["cdylib"]
 
 [dependencies]
-a3s-code-core = { version = "1.8.5", path = "../../core", features = ["ahp"] }
+a3s-code-core = { version = "1.8.6", path = "../../core", features = ["ahp"] }
 napi = { version = "2", features = ["async", "napi6", "serde-json"] }
 napi-derive = "2"
 tokio = { version = "1.35", features = ["full"] }

sdk/node/index.d.ts

@@ -189,6 +189,21 @@ export interface ToolResult {
   /** Convenience JSON view of `metadata.document_runtime` when present. */
   documentRuntimeJson?: string
 }
+/** Parameters for the web_search tool. */
+export interface JsWebSearchParams {
+  /** The search query. */
+  query: string
+  /** List of search engines to use. */
+  engines?: Array<string>
+  /** Maximum number of results to return (default: 10, max: 50). */
+  limit?: number
+  /** Search timeout in seconds (default: 10, max: 60). */
+  timeout?: number
+  /** Proxy URL (e.g., http://127.0.0.1:8080 or socks5://127.0.0.1:1080). */
+  proxy?: string
+  /** Output format: "text" or "json". */
+  format?: string
+}
 /** Result of a single `EventStream.next()` call. */
 export interface NextResult {
   value?: AgentEvent
@@ -670,6 +685,20 @@ export interface SearchEngineConfig {
   weight: number
   timeout?: number
 }
+/** Browser backend for headless search. */
+export const enum BrowserBackend {
+  /** Chrome/Chromium headless. */
+  Chrome = 0,
+  /** Lightpanda headless browser (Linux/macOS only). */
+  Lightpanda = 1
+}
+/** Headless browser configuration. */
+export interface HeadlessConfig {
+  backend: BrowserBackend
+  browserPath?: string
+  maxTabs?: number
+  launchArgs?: Array<string>
+}
 /** Health monitor configuration for search engines. */
 export interface SearchHealthConfig {
   maxFailures: number
@@ -680,6 +709,7 @@ export interface SearchConfig {
   timeout: number
   health?: SearchHealthConfig
   engines: Record<string, SearchEngineConfig>
+  headless?: HeadlessConfig
 }
 /** SubAgent configuration for orchestrator. */
 export interface SubAgentConfig {
@@ -1082,6 +1112,8 @@ export declare class Session {
   glob(pattern: string): Promise<Array<string>>
   /** Search file contents with a regex pattern. */
   grep(pattern: string): Promise<string>
+  /** Search the web using multiple search engines. */
+  webSearch(params: JsWebSearchParams): Promise<ToolResult>
   /** Execute a git command (status, log, branch, checkout, diff, stash, remote, worktree). */
   git(command: string, subcommand?: string | undefined | null, name?: string | undefined | null, path?: string | undefined | null, newBranch?: boolean | undefined | null, base?: string | undefined | null, force?: boolean | undefined | null, maxCount?: number | undefined | null, message?: string | undefined | null, includeUntracked?: boolean | undefined | null, target?: string | undefined | null, reference?: string | undefined | null): Promise<ToolResult>
   /** Check if this session has a lane queue configured. */

sdk/node/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, TeamRole, TeamTaskStatus, TeamTaskBoard, Team, TeamRunner, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
+const { EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, TeamRole, TeamTaskStatus, TeamTaskBoard, Team, TeamRunner, BrowserBackend, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
 
 module.exports.EventStream = EventStream
 module.exports.FileMemoryStore = FileMemoryStore
@@ -330,6 +330,7 @@ module.exports.TeamTaskStatus = TeamTaskStatus
 module.exports.TeamTaskBoard = TeamTaskBoard
 module.exports.Team = Team
 module.exports.TeamRunner = TeamRunner
+module.exports.BrowserBackend = BrowserBackend
 module.exports.SubAgentHandle = SubAgentHandle
 module.exports.SubAgentEventStream = SubAgentEventStream
 module.exports.Orchestrator = Orchestrator

sdk/node/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/code",
-  "version": "1.8.5",
+  "version": "1.8.6",
   "description": "A3S Code - Native AI coding agent library for Node.js",
   "main": "index.js",
   "types": "index.d.ts",
@@ -44,11 +44,11 @@
     "test:loop": "tsx --tsconfig examples/tsconfig.json examples/test_loop_commands.ts"
   },
   "optionalDependencies": {
-    "@a3s-lab/code-darwin-arm64": "1.8.5",
-    "@a3s-lab/code-linux-x64-gnu": "1.8.5",
-    "@a3s-lab/code-linux-x64-musl": "1.8.5",
-    "@a3s-lab/code-linux-arm64-gnu": "1.8.5",
-    "@a3s-lab/code-linux-arm64-musl": "1.8.5",
-    "@a3s-lab/code-win32-x64-msvc": "1.8.5"
+    "@a3s-lab/code-darwin-arm64": "1.8.6",
+    "@a3s-lab/code-linux-x64-gnu": "1.8.6",
+    "@a3s-lab/code-linux-x64-musl": "1.8.6",
+    "@a3s-lab/code-linux-arm64-gnu": "1.8.6",
+    "@a3s-lab/code-linux-arm64-musl": "1.8.6",
+    "@a3s-lab/code-win32-x64-msvc": "1.8.6"
   }
 }

sdk/node/src/lib.rs

@@ -29,6 +29,7 @@ use a3s_code_core::agent_teams::{
 };
 use a3s_code_core::commands::CommandContext as RustCommandContext;
 use a3s_code_core::config::{
+    BrowserBackend as RustBrowserBackend, HeadlessConfig as RustHeadlessConfig,
     SearchConfig as RustSearchConfig, SearchEngineConfig as RustSearchEngineConfig,
     SearchHealthConfig as RustSearchHealthConfig,
 };
@@ -286,6 +287,28 @@ pub struct ToolResult {
     pub document_runtime_json: Option<String>,
 }
 
+// ============================================================================
+// WebSearchParams
+// ============================================================================
+
+/// Parameters for the web_search tool.
+#[napi(object)]
+#[derive(Clone)]
+pub struct JsWebSearchParams {
+    /// The search query.
+    pub query: String,
+    /// List of search engines to use.
+    pub engines: Option<Vec<String>>,
+    /// Maximum number of results to return (default: 10, max: 50).
+    pub limit: Option<u32>,
+    /// Search timeout in seconds (default: 10, max: 60).
+    pub timeout: Option<u32>,
+    /// Proxy URL (e.g., http://127.0.0.1:8080 or socks5://127.0.0.1:1080).
+    pub proxy: Option<String>,
+    /// Output format: "text" or "json".
+    pub format: Option<String>,
+}
+
 // ============================================================================
 // EventStream
 // ============================================================================
@@ -1676,6 +1699,36 @@ impl Session {
             .map_err(|e| napi::Error::from_reason(format!("{e}")))
     }
 
+    /// Search the web using multiple search engines.
+    #[napi]
+    pub async fn web_search(&self, params: JsWebSearchParams) -> napi::Result<ToolResult> {
+        let session = self.inner.clone();
+        let args = serde_json::json!({
+            "query": params.query,
+            "engines": params.engines,
+            "limit": params.limit,
+            "timeout": params.timeout,
+            "proxy": params.proxy,
+            "format": params.format,
+        });
+        get_runtime()
+            .spawn(async move {
+                session
+                    .tool("web_search", args)
+                    .await
+                    .map(|r| ToolResult {
+                        name: r.name,
+                        output: r.output,
+                        exit_code: r.exit_code,
+                        metadata_json: r.metadata.map(|m| serde_json::to_string(&m).ok()).flatten(),
+                        document_runtime_json: None,
+                    })
+            })
+            .await
+            .map_err(|e| napi::Error::from_reason(format!("Task join error: {e}")))?
+            .map_err(|e| napi::Error::from_reason(format!("{e}")))
+    }
+
     /// Execute a git command (status, log, branch, checkout, diff, stash, remote, worktree).
     #[napi]
     pub async fn git(
@@ -3625,6 +3678,45 @@ impl From<SearchEngineConfig> for RustSearchEngineConfig {
     }
 }
 
+/// Browser backend for headless search.
+#[napi]
+pub enum BrowserBackend {
+    /// Chrome/Chromium headless.
+    Chrome,
+    /// Lightpanda headless browser (Linux/macOS only).
+    Lightpanda,
+}
+
+impl From<BrowserBackend> for RustBrowserBackend {
+    fn from(b: BrowserBackend) -> Self {
+        match b {
+            BrowserBackend::Chrome => RustBrowserBackend::Chrome,
+            BrowserBackend::Lightpanda => RustBrowserBackend::Lightpanda,
+        }
+    }
+}
+
+/// Headless browser configuration.
+#[napi(object)]
+#[derive(Clone)]
+pub struct HeadlessConfig {
+    pub backend: BrowserBackend,
+    pub browser_path: Option<String>,
+    pub max_tabs: Option<u32>,
+    pub launch_args: Option<Vec<String>>,
+}
+
+impl From<HeadlessConfig> for RustHeadlessConfig {
+    fn from(c: HeadlessConfig) -> Self {
+        Self {
+            backend: c.backend.into(),
+            browser_path: c.browser_path,
+            max_tabs: c.max_tabs.unwrap_or(4) as usize,
+            launch_args: c.launch_args.unwrap_or_default(),
+        }
+    }
+}
+
 /// Health monitor configuration for search engines.
 #[napi(object)]
 #[derive(Clone)]
@@ -3649,6 +3741,7 @@ pub struct SearchConfig {
     pub timeout: u32,
     pub health: Option<SearchHealthConfig>,
     pub engines: std::collections::HashMap<String, SearchEngineConfig>,
+    pub headless: Option<HeadlessConfig>,
 }
 
 impl From<SearchConfig> for RustSearchConfig {
@@ -3657,6 +3750,7 @@ impl From<SearchConfig> for RustSearchConfig {
             timeout: c.timeout as u64,
             health: c.health.map(|h| h.into()),
             engines: c.engines.into_iter().map(|(k, v)| (k, v.into())).collect(),
+            headless: c.headless.map(|h| h.into()),
         }
     }
 }

sdk/python-bootstrap/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "a3s-code"
-version = "1.8.5"
+version = "1.8.6"
 description = "A3S Code Python bootstrap package that fetches platform-native binaries from GitHub Releases"
 readme = "../python/README.md"
 license = { text = "MIT" }