@nomix-ai/nomix-harness 0.2.4 → 0.2.6

package/dist/kernel/tool-web/lib/index.js

@@ -1,4 +1,4 @@
-import z from "@nomix-ai/schemastery";
+import z from "../../schemastery/lib/index.mjs";
 import { defineTool } from "../../tools/lib/index.js";
 import TurndownService from "turndown";
 import { gfm } from "@joplin/turndown-plugin-gfm";
@@ -17,16 +17,24 @@ import { assertNever } from "../../llm/lib/index.js";
 * context returns. The default `8` aligns with OpenCode's Exa default.
 */
 const WEB_SEARCH_MAX_RESULTS = 8;
+/** Default upper bound on concurrent searches in one tool call. */
+const WEB_SEARCH_MAX_QUERIES = 4;
 /**
-* Validate value constraints the schema DSL can't express: a non-blank
-* `query`. Throws a plain `Error` otherwise.
+* Validate value constraints the schema DSL can't express: `queries` is
+* non-empty, contains only non-blank strings, and fits the deployment's
+* query-count bound. Exact duplicate strings are collapsed after the bound
+* check. Throws a plain `Error` otherwise.
 *
 * @param args - the schema-validated `web_search` arguments.
-* @returns the accepted arguments, passed through unchanged.
+* @param maxQueries - the deployment's upper bound on queries in one call.
+* @returns the accepted queries in their first-occurrence order.
 */
-function parseSearchArgs(args) {
-	if (args.query.trim().length === 0) throw new Error("query must be a non-empty string");
-	return { query: args.query };
+function parseSearchArgs(args, maxQueries) {
+	const queries = args.queries;
+	if (queries.length === 0) throw new Error("queries must contain at least one query");
+	if (queries.length > maxQueries) throw new Error(`queries must contain at most ${maxQueries} ${maxQueries === 1 ? "query" : "queries"}`);
+	if (queries.some((query) => query.trim().length === 0)) throw new Error("each query must be a non-empty string");
+	return [...new Set(queries)];
 }
 /** Display label for a source: its title, else its hostname. */
 function sourceLabel(url, title) {
@@ -64,17 +72,18 @@ function formatSearchOutput(result) {
 	return parts.join("\n\n");
 }
 /**
-* Pending-call presentation: a search card titled by the query.
+* Pending-call presentation: a search card titled by the query list.
 *
-* @param args - the raw tool arguments; only `query` feeds the view.
+* @param args - the raw tool arguments; only the query text feeds the view.
 * @returns the generic card view (`kind: 'search'`) shown while the call runs.
 */
 function presentSearchCall(args) {
+	const title = args.queries.join(", ");
 	return {
 		card: "generic",
-		title: args.query,
+		title,
 		kind: "search",
-		rawInput: args.query
+		rawInput: title
 	};
 }
 /**
@@ -139,8 +148,8 @@ function searchMetaFromResult(meta) {
 * `web` capability falls back to the raw `tool/result` content, which is the
 * same text (see the web-result-card Agent Note).
 *
-* @param args - the raw tool arguments; `query` becomes the result-state title so
-*   a window-truncated replay that dropped the call head still has one.
+* @param args - the raw tool arguments; the queries become the result-state
+*   title so a window-truncated replay that dropped the call head still has one.
 * @param result - the final model-facing tool result; `meta` carries the sources.
 * @returns the search result view, or `undefined` (generic card) on failure or
 *   malformed meta.
@@ -152,37 +161,105 @@ function presentSearchResult(args, result) {
 	return {
 		card: "web",
 		kind: "search",
-		title: args.query,
+		title: args.queries.join(", "),
 		sources: meta.sources,
 		truncated: meta.truncated,
 		...meta.answer !== void 0 ? { answer: meta.answer } : {}
 	};
 }
 /**
+* Run one or more searches through the web seam. A single query keeps the
+* provider's exact result; multiple queries run concurrently and are merged
+* into one normalized result capped at `maxResults`. A failed search aborts
+* its siblings, and this function waits for every search to settle before
+* rethrowing the first failure.
+*
+* @param ctx - context whose `web` service performs the searches.
+* @param queries - validated non-empty queries.
+* @param maxResults - the deployment's source cap for the combined result.
+* @param signal - cancellation signal forwarded to every search.
+* @returns the combined search result.
+*/
+async function runSearchQueries(ctx, queries, maxResults, signal) {
+	if (queries.length === 1) return ctx.web.search({
+		query: queries[0],
+		maxResults
+	}, signal);
+	const controller = new AbortController();
+	const batchSignal = AbortSignal.any([signal, controller.signal]);
+	let firstFailure;
+	const results = [];
+	const searches = queries.map(async (query, index) => {
+		try {
+			results[index] = await ctx.web.search({
+				query,
+				maxResults
+			}, batchSignal);
+		} catch (error) {
+			if (firstFailure === void 0) firstFailure = { error };
+			controller.abort(error);
+			throw error;
+		}
+	});
+	await Promise.allSettled(searches);
+	if (firstFailure !== void 0) throw firstFailure.error;
+	return mergeSearchResults(queries, results, maxResults);
+}
+/** Merge per-query results into one deduplicated, round-robin, capped result. */
+function mergeSearchResults(queries, results, maxResults) {
+	const seen = /* @__PURE__ */ new Set();
+	const sources = [];
+	let sourceRanks = 0;
+	for (const result of results) sourceRanks = Math.max(sourceRanks, result.sources.length);
+	let droppedSource = false;
+	merge: for (let rank = 0; rank < sourceRanks; rank++) for (const result of results) {
+		const source = result.sources[rank];
+		if (source !== void 0 && !seen.has(source.url)) {
+			seen.add(source.url);
+			if (sources.length === maxResults) {
+				droppedSource = true;
+				break merge;
+			}
+			sources.push(source);
+		}
+	}
+	const contents = results.flatMap((result, index) => {
+		if (result.content === void 0 || result.content.length === 0) return [];
+		return [`### ${queries[index]}\n\n${result.content}`];
+	});
+	return {
+		...contents.length > 0 ? { content: contents.join("\n\n") } : {},
+		sources,
+		truncated: results.some((result) => result.truncated) || droppedSource
+	};
+}
+/**
 * Register the `web_search` tool and its system-prompt guidance.
 *
 * @param ctx - context whose `tools` and `systemPrompt` registries receive the
 *   registrations; both are effect-scoped and unregister on plugin dispose.
 * @param maxResults - the deployment's source cap, sent as every seam
 *   request's `maxResults`.
+* @param maxQueries - the deployment's query cap enforced before provider calls.
 * @param timeoutMs - the cooperative tool-call budget (ms) attached as the tool's
 *   `ToolDefinition.timeoutMs` for `@nomix-ai/nomix-tool-call-timeout-policy` to enforce.
 * @param fetchEnabled - whether the same composition exposes `web_fetch`, which
 *   controls whether search guidance may recommend that follow-up tool.
 */
-function applyWebSearchTool(ctx, maxResults, timeoutMs, fetchEnabled) {
+function applyWebSearchTool(ctx, maxResults, maxQueries, timeoutMs, fetchEnabled) {
 	ctx.systemPrompt.section({
 		name: "tool:web_search",
 		order: 110,
-		text: fetchEnabled ? "Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links." : "Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Use the returned source snippets when available, and cite the relevant URLs as markdown links."
+		text: fetchEnabled ? `Use the web_search tool to discover current information on the web. The required queries array accepts 1–${maxQueries} non-empty search queries; use a one-item array for a single search. It returns an optional answer plus a list of source URLs. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links.` : `Use the web_search tool to discover current information on the web. The required queries array accepts 1–${maxQueries} non-empty search queries; use a one-item array for a single search. It returns an optional answer plus a list of source URLs. Use the returned source snippets when available, and cite the relevant URLs as markdown links.`
 	});
 	ctx.tools.register(defineTool({
 		name: "web_search",
-		description: "Search the web for current information. Returns an optional summary answer and a list of source URLs.",
-		parameters: { query: {
-			type: "string",
+		description: `Search the web for current information. Provide 1–${maxQueries} queries in the required queries array. Returns an optional summary answer and a list of source URLs.`,
+		parameters: { queries: {
+			type: "array",
 			required: true,
-			description: "The search query."
+			items: { type: "string" },
+			description: `Required search queries; accepts 1–${maxQueries} items and merges their results.`
 		} },
 		output: {
 			schema: {
@@ -222,11 +299,7 @@ function applyWebSearchTool(ctx, maxResults, timeoutMs, fetchEnabled) {
 		timeoutMs,
 		isConcurrencySafe: () => true,
 		async execute(args, exec) {
-			const input = parseSearchArgs(args);
-			const result = await ctx.web.search({
-				query: input.query,
-				maxResults
-			}, exec.signal);
+			const result = await runSearchQueries(ctx, parseSearchArgs(args, maxQueries), maxResults, exec.signal);
 			return {
 				...result.content !== void 0 ? { content: result.content } : {},
 				sources: result.sources.map(projectSource),
@@ -747,6 +820,7 @@ const Config = z.object({
 	search: z.boolean().default(true),
 	fetch: z.boolean().default(true),
 	searchMaxResults: z.number().default(8),
+	searchMaxQueries: z.number().default(4),
 	fetchTimeoutMs: z.number().default(DEFAULT_WEB_TOOL_TIMEOUT_MS),
 	searchTimeoutMs: z.number().default(DEFAULT_WEB_TOOL_TIMEOUT_MS),
 	fetchMaxOutputChars: z.number().default(DEFAULT_FETCH_MAX_OUTPUT_CHARS)
@@ -767,11 +841,12 @@ function assertPositiveInteger(name, value) {
 function apply(ctx, config) {
 	const resolved = config;
 	assertPositiveInteger("searchMaxResults", resolved.searchMaxResults);
+	assertPositiveInteger("searchMaxQueries", resolved.searchMaxQueries);
 	assertPositiveInteger("fetchTimeoutMs", resolved.fetchTimeoutMs);
 	assertPositiveInteger("searchTimeoutMs", resolved.searchTimeoutMs);
 	assertPositiveInteger("fetchMaxOutputChars", resolved.fetchMaxOutputChars);
-	if (resolved.search) applyWebSearchTool(ctx, resolved.searchMaxResults, resolved.searchTimeoutMs, resolved.fetch);
+	if (resolved.search) applyWebSearchTool(ctx, resolved.searchMaxResults, resolved.searchMaxQueries, resolved.searchTimeoutMs, resolved.fetch);
 	if (resolved.fetch) applyWebFetchTool(ctx, resolved.fetchTimeoutMs, resolved.fetchMaxOutputChars);
 }
 //#endregion
-export { Config, DEFAULT_FETCH_MAX_OUTPUT_CHARS, DEFAULT_WEB_TOOL_TIMEOUT_MS, WEB_SEARCH_MAX_RESULTS, apply, applyWebFetchTool, applyWebSearchTool, fetchMetaFromResult, fetchMetaFromValue, formatFetchOutput, formatSearchOutput, inject, name, parseFetchArgs, parseSearchArgs, presentFetchCall, presentFetchResult, presentSearchCall, presentSearchResult, searchMetaFromResult, searchMetaFromValue };
+export { Config, DEFAULT_FETCH_MAX_OUTPUT_CHARS, DEFAULT_WEB_TOOL_TIMEOUT_MS, WEB_SEARCH_MAX_QUERIES, WEB_SEARCH_MAX_RESULTS, apply, applyWebFetchTool, applyWebSearchTool, fetchMetaFromResult, fetchMetaFromValue, formatFetchOutput, formatSearchOutput, inject, name, parseFetchArgs, presentFetchCall, presentFetchResult, presentSearchCall, presentSearchResult, searchMetaFromResult, searchMetaFromValue };

package/dist/kernel/tool-web/lib/types/fetch.d.ts

@@ -4,7 +4,7 @@
  * `ToolDefinition.timeoutMs`, timeout policy enforces it, and this tool forwards the resulting
  * signal. A provider timeout remains a backstop for direct service callers.
  */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 import type { GenericCallView, JsonValue, ToolResult, WebFetchResultView } from '../../../tools/lib/index.js';
 import type { WebFetchResult } from '../../../web/lib/index.js';
 /**

package/dist/kernel/tool-web/lib/types/index.d.ts

@@ -5,9 +5,9 @@
  * and fails with a structured error at execution time.
  * @module @nomix-ai/nomix-tool-web
  */
-import type { Context } from '@nomix-ai/cordis';
-import z from '@nomix-ai/schemastery';
-export { WEB_SEARCH_MAX_RESULTS, applyWebSearchTool, formatSearchOutput, parseSearchArgs, presentSearchCall, presentSearchResult, searchMetaFromValue, searchMetaFromResult } from './search.ts';
+import type { Context } from '../../../cordis/lib/index.js';
+import z from '../../../schemastery/lib/index.mjs';
+export { WEB_SEARCH_MAX_QUERIES, WEB_SEARCH_MAX_RESULTS, applyWebSearchTool, formatSearchOutput, presentSearchCall, presentSearchResult, searchMetaFromValue, searchMetaFromResult } from './search.ts';
 export type { WebSearchMeta } from './search.ts';
 export { applyWebFetchTool, formatFetchOutput, parseFetchArgs, presentFetchCall, presentFetchResult, fetchMetaFromValue, fetchMetaFromResult } from './fetch.ts';
 export type { WebFetchMeta } from './fetch.ts';
@@ -23,7 +23,7 @@ export declare const DEFAULT_WEB_TOOL_TIMEOUT_MS = 30000;
  * 100,000-character body cap while bounding custom providers and rendered output.
  */
 export declare const DEFAULT_FETCH_MAX_OUTPUT_CHARS = 200000;
-/** Plugin config: which web tools to register, the source cap, per-tool budgets, and the fetch output cap. */
+/** Plugin config: which web tools to register, search bounds, per-tool budgets, and the fetch output cap. */
 export interface Config {
     /** Register `web_search`. Defaults to true. */
     search?: boolean;
@@ -31,6 +31,8 @@ export interface Config {
     fetch?: boolean;
     /** Upper bound on sources returned by one `web_search` call. */
     searchMaxResults?: number;
+    /** Upper bound on queries accepted by one `web_search` call. */
+    searchMaxQueries?: number;
     /** Cooperative timeout budget (ms) for `web_fetch`. Defaults to 30000. */
     fetchTimeoutMs?: number;
     /** Cooperative timeout budget (ms) for `web_search`. Defaults to 30000. */

package/dist/kernel/tool-web/lib/types/index.js

@@ -5,10 +5,10 @@
  * and fails with a structured error at execution time.
  * @module @nomix-ai/nomix-tool-web
  */
-import z from '@nomix-ai/schemastery';
-import { applyWebSearchTool, WEB_SEARCH_MAX_RESULTS } from "./search.js";
+import z from '../../../schemastery/lib/index.mjs';
+import { applyWebSearchTool, WEB_SEARCH_MAX_QUERIES, WEB_SEARCH_MAX_RESULTS } from "./search.js";
 import { applyWebFetchTool } from "./fetch.js";
-export { WEB_SEARCH_MAX_RESULTS, applyWebSearchTool, formatSearchOutput, parseSearchArgs, presentSearchCall, presentSearchResult, searchMetaFromValue, searchMetaFromResult } from "./search.js";
+export { WEB_SEARCH_MAX_QUERIES, WEB_SEARCH_MAX_RESULTS, applyWebSearchTool, formatSearchOutput, presentSearchCall, presentSearchResult, searchMetaFromValue, searchMetaFromResult } from "./search.js";
 export { applyWebFetchTool, formatFetchOutput, parseFetchArgs, presentFetchCall, presentFetchResult, fetchMetaFromValue, fetchMetaFromResult } from "./fetch.js";
 /** Cordis plugin name used by loader diagnostics. */
 export const name = 'tool-web';
@@ -26,6 +26,7 @@ export const Config = z.object({
     search: z.boolean().default(true),
     fetch: z.boolean().default(true),
     searchMaxResults: z.number().default(WEB_SEARCH_MAX_RESULTS),
+    searchMaxQueries: z.number().default(WEB_SEARCH_MAX_QUERIES),
     fetchTimeoutMs: z.number().default(DEFAULT_WEB_TOOL_TIMEOUT_MS),
     searchTimeoutMs: z.number().default(DEFAULT_WEB_TOOL_TIMEOUT_MS),
     fetchMaxOutputChars: z.number().default(DEFAULT_FETCH_MAX_OUTPUT_CHARS),
@@ -49,11 +50,12 @@ export function apply(ctx, config) {
     // schemastery (Config) has already filled every defaulted field.
     const resolved = config;
     assertPositiveInteger('searchMaxResults', resolved.searchMaxResults);
+    assertPositiveInteger('searchMaxQueries', resolved.searchMaxQueries);
     assertPositiveInteger('fetchTimeoutMs', resolved.fetchTimeoutMs);
     assertPositiveInteger('searchTimeoutMs', resolved.searchTimeoutMs);
     assertPositiveInteger('fetchMaxOutputChars', resolved.fetchMaxOutputChars);
     if (resolved.search) {
-        applyWebSearchTool(ctx, resolved.searchMaxResults, resolved.searchTimeoutMs, resolved.fetch);
+        applyWebSearchTool(ctx, resolved.searchMaxResults, resolved.searchMaxQueries, resolved.searchTimeoutMs, resolved.fetch);
     }
     if (resolved.fetch)
         applyWebFetchTool(ctx, resolved.fetchTimeoutMs, resolved.fetchMaxOutputChars);

package/dist/kernel/tool-web/lib/types/invariant.d.ts

@@ -2,7 +2,7 @@
  * Package-owned invariant companion for `@nomix-ai/nomix-tool-web`.
  * @module @nomix-ai/nomix-tool-web/invariant
  */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
 export declare const name = "tool-web-invariant";
 /** Service required before the companion can reserve package ownership. */

package/dist/kernel/tool-web/lib/types/search.d.ts

@@ -4,7 +4,7 @@
  * schema, argument validation, the result-count bound, and result formatting,
  * never provider selection or network access.
  */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 import type { GenericCallView, JsonValue, ToolResult, WebSearchResultView, WebSource } from '../../../tools/lib/index.js';
 import type { WebSearchResult } from '../../../web/lib/index.js';
 /**
@@ -14,18 +14,23 @@ import type { WebSearchResult } from '../../../web/lib/index.js';
  * context returns. The default `8` aligns with OpenCode's Exa default.
  */
 export declare const WEB_SEARCH_MAX_RESULTS = 8;
+/** Default upper bound on concurrent searches in one tool call. */
+export declare const WEB_SEARCH_MAX_QUERIES = 4;
+/** Model-facing `web_search` arguments. */
+interface WebSearchArgs {
+    queries: string[];
+}
 /**
- * Validate value constraints the schema DSL can't express: a non-blank
- * `query`. Throws a plain `Error` otherwise.
+ * Validate value constraints the schema DSL can't express: `queries` is
+ * non-empty, contains only non-blank strings, and fits the deployment's
+ * query-count bound. Exact duplicate strings are collapsed after the bound
+ * check. Throws a plain `Error` otherwise.
  *
  * @param args - the schema-validated `web_search` arguments.
- * @returns the accepted arguments, passed through unchanged.
+ * @param maxQueries - the deployment's upper bound on queries in one call.
+ * @returns the accepted queries in their first-occurrence order.
  */
-export declare function parseSearchArgs(args: {
-    query: string;
-}): {
-    query: string;
-};
+export declare function parseSearchArgs(args: WebSearchArgs, maxQueries: number): string[];
 /**
  * Format a search result as one model-facing text block.
  *
@@ -36,14 +41,12 @@ export declare function parseSearchArgs(args: {
  */
 export declare function formatSearchOutput(result: WebSearchResult): string;
 /**
- * Pending-call presentation: a search card titled by the query.
+ * Pending-call presentation: a search card titled by the query list.
  *
- * @param args - the raw tool arguments; only `query` feeds the view.
+ * @param args - the raw tool arguments; only the query text feeds the view.
  * @returns the generic card view (`kind: 'search'`) shown while the call runs.
  */
-export declare function presentSearchCall(args: {
-    query: string;
-}): GenericCallView;
+export declare function presentSearchCall(args: WebSearchArgs): GenericCallView;
 /**
  * The `web_search` tool's private `tool/result` `meta` payload: the structured
  * sources, the optional provider answer, and the truncation flag. Attached
@@ -55,7 +58,7 @@ export declare function presentSearchCall(args: {
 export interface WebSearchMeta {
     /** The faithful structured sources, in result order. */
     sources: WebSource[];
-    /** True when the seam cut the source list to honor the result cap. */
+    /** True when the seam or multi-query merge cut the source list to honor the result cap. */
     truncated: boolean;
     /** The provider-generated answer text, when any. */
     answer?: string;
@@ -83,15 +86,13 @@ export declare function searchMetaFromResult(meta: unknown): WebSearchMeta | und
  * `web` capability falls back to the raw `tool/result` content, which is the
  * same text (see the web-result-card Agent Note).
  *
- * @param args - the raw tool arguments; `query` becomes the result-state title so
- *   a window-truncated replay that dropped the call head still has one.
+ * @param args - the raw tool arguments; the queries become the result-state
+ *   title so a window-truncated replay that dropped the call head still has one.
  * @param result - the final model-facing tool result; `meta` carries the sources.
  * @returns the search result view, or `undefined` (generic card) on failure or
  *   malformed meta.
  */
-export declare function presentSearchResult(args: {
-    query: string;
-}, result: ToolResult): WebSearchResultView | undefined;
+export declare function presentSearchResult(args: WebSearchArgs, result: ToolResult): WebSearchResultView | undefined;
 /**
  * Register the `web_search` tool and its system-prompt guidance.
  *
@@ -99,10 +100,12 @@ export declare function presentSearchResult(args: {
  *   registrations; both are effect-scoped and unregister on plugin dispose.
  * @param maxResults - the deployment's source cap, sent as every seam
  *   request's `maxResults`.
+ * @param maxQueries - the deployment's query cap enforced before provider calls.
  * @param timeoutMs - the cooperative tool-call budget (ms) attached as the tool's
  *   `ToolDefinition.timeoutMs` for `@nomix-ai/nomix-tool-call-timeout-policy` to enforce.
  * @param fetchEnabled - whether the same composition exposes `web_fetch`, which
  *   controls whether search guidance may recommend that follow-up tool.
  */
-export declare function applyWebSearchTool(ctx: Context, maxResults: number, timeoutMs: number, fetchEnabled: boolean): void;
+export declare function applyWebSearchTool(ctx: Context, maxResults: number, maxQueries: number, timeoutMs: number, fetchEnabled: boolean): void;
+export {};
 //# sourceMappingURL=search.d.ts.map

package/dist/kernel/tool-web/lib/types/search.js

@@ -12,17 +12,29 @@ import { defineTool } from '../../../tools/lib/index.js';
  * context returns. The default `8` aligns with OpenCode's Exa default.
  */
 export const WEB_SEARCH_MAX_RESULTS = 8;
+/** Default upper bound on concurrent searches in one tool call. */
+export const WEB_SEARCH_MAX_QUERIES = 4;
 /**
- * Validate value constraints the schema DSL can't express: a non-blank
- * `query`. Throws a plain `Error` otherwise.
+ * Validate value constraints the schema DSL can't express: `queries` is
+ * non-empty, contains only non-blank strings, and fits the deployment's
+ * query-count bound. Exact duplicate strings are collapsed after the bound
+ * check. Throws a plain `Error` otherwise.
  *
  * @param args - the schema-validated `web_search` arguments.
- * @returns the accepted arguments, passed through unchanged.
+ * @param maxQueries - the deployment's upper bound on queries in one call.
+ * @returns the accepted queries in their first-occurrence order.
  */
-export function parseSearchArgs(args) {
-    if (args.query.trim().length === 0)
-        throw new Error('query must be a non-empty string');
-    return { query: args.query };
+export function parseSearchArgs(args, maxQueries) {
+    const queries = args.queries;
+    if (queries.length === 0)
+        throw new Error('queries must contain at least one query');
+    if (queries.length > maxQueries) {
+        const noun = maxQueries === 1 ? 'query' : 'queries';
+        throw new Error(`queries must contain at most ${maxQueries} ${noun}`);
+    }
+    if (queries.some(query => query.trim().length === 0))
+        throw new Error('each query must be a non-empty string');
+    return [...new Set(queries)];
 }
 /** Display label for a source: its title, else its hostname. */
 function sourceLabel(url, title) {
@@ -71,13 +83,14 @@ export function formatSearchOutput(result) {
     return parts.join('\n\n');
 }
 /**
- * Pending-call presentation: a search card titled by the query.
+ * Pending-call presentation: a search card titled by the query list.
  *
- * @param args - the raw tool arguments; only `query` feeds the view.
+ * @param args - the raw tool arguments; only the query text feeds the view.
  * @returns the generic card view (`kind: 'search'`) shown while the call runs.
  */
 export function presentSearchCall(args) {
-    return { card: 'generic', title: args.query, kind: 'search', rawInput: args.query };
+    const title = args.queries.join(', ');
+    return { card: 'generic', title, kind: 'search', rawInput: title };
 }
 /**
  * Project one seam source into a plain object that omits every absent optional
@@ -149,8 +162,8 @@ export function searchMetaFromResult(meta) {
  * `web` capability falls back to the raw `tool/result` content, which is the
  * same text (see the web-result-card Agent Note).
  *
- * @param args - the raw tool arguments; `query` becomes the result-state title so
- *   a window-truncated replay that dropped the call head still has one.
+ * @param args - the raw tool arguments; the queries become the result-state
+ *   title so a window-truncated replay that dropped the call head still has one.
  * @param result - the final model-facing tool result; `meta` carries the sources.
  * @returns the search result view, or `undefined` (generic card) on failure or
  *   malformed meta.
@@ -164,12 +177,82 @@ export function presentSearchResult(args, result) {
     return {
         card: 'web',
         kind: 'search',
-        title: args.query,
+        title: args.queries.join(', '),
         sources: meta.sources,
         truncated: meta.truncated,
         ...meta.answer !== undefined ? { answer: meta.answer } : {},
     };
 }
+/**
+ * Run one or more searches through the web seam. A single query keeps the
+ * provider's exact result; multiple queries run concurrently and are merged
+ * into one normalized result capped at `maxResults`. A failed search aborts
+ * its siblings, and this function waits for every search to settle before
+ * rethrowing the first failure.
+ *
+ * @param ctx - context whose `web` service performs the searches.
+ * @param queries - validated non-empty queries.
+ * @param maxResults - the deployment's source cap for the combined result.
+ * @param signal - cancellation signal forwarded to every search.
+ * @returns the combined search result.
+ */
+async function runSearchQueries(ctx, queries, maxResults, signal) {
+    if (queries.length === 1) {
+        return ctx.web.search({ query: queries[0], maxResults }, signal);
+    }
+    const controller = new AbortController();
+    const batchSignal = AbortSignal.any([signal, controller.signal]);
+    let firstFailure;
+    const results = [];
+    const searches = queries.map(async (query, index) => {
+        try {
+            results[index] = await ctx.web.search({ query, maxResults }, batchSignal);
+        }
+        catch (error) {
+            if (firstFailure === undefined)
+                firstFailure = { error };
+            controller.abort(error);
+            throw error;
+        }
+    });
+    await Promise.allSettled(searches);
+    if (firstFailure !== undefined)
+        throw firstFailure.error;
+    return mergeSearchResults(queries, results, maxResults);
+}
+/** Merge per-query results into one deduplicated, round-robin, capped result. */
+function mergeSearchResults(queries, results, maxResults) {
+    const seen = new Set();
+    const sources = [];
+    let sourceRanks = 0;
+    for (const result of results) {
+        sourceRanks = Math.max(sourceRanks, result.sources.length);
+    }
+    let droppedSource = false;
+    merge: for (let rank = 0; rank < sourceRanks; rank++) {
+        for (const result of results) {
+            const source = result.sources[rank];
+            if (source !== undefined && !seen.has(source.url)) {
+                seen.add(source.url);
+                if (sources.length === maxResults) {
+                    droppedSource = true;
+                    break merge;
+                }
+                sources.push(source);
+            }
+        }
+    }
+    const contents = results.flatMap((result, index) => {
+        if (result.content === undefined || result.content.length === 0)
+            return [];
+        return [`### ${queries[index]}\n\n${result.content}`];
+    });
+    return {
+        ...contents.length > 0 ? { content: contents.join('\n\n') } : {},
+        sources,
+        truncated: results.some(result => result.truncated) || droppedSource,
+    };
+}
 /**
  * Register the `web_search` tool and its system-prompt guidance.
  *
@@ -177,24 +260,30 @@ export function presentSearchResult(args, result) {
  *   registrations; both are effect-scoped and unregister on plugin dispose.
  * @param maxResults - the deployment's source cap, sent as every seam
  *   request's `maxResults`.
+ * @param maxQueries - the deployment's query cap enforced before provider calls.
  * @param timeoutMs - the cooperative tool-call budget (ms) attached as the tool's
  *   `ToolDefinition.timeoutMs` for `@nomix-ai/nomix-tool-call-timeout-policy` to enforce.
  * @param fetchEnabled - whether the same composition exposes `web_fetch`, which
  *   controls whether search guidance may recommend that follow-up tool.
  */
-export function applyWebSearchTool(ctx, maxResults, timeoutMs, fetchEnabled) {
+export function applyWebSearchTool(ctx, maxResults, maxQueries, timeoutMs, fetchEnabled) {
     ctx.systemPrompt.section({
         name: 'tool:web_search',
         order: 110,
         text: fetchEnabled
-            ? 'Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links.'
-            : 'Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Use the returned source snippets when available, and cite the relevant URLs as markdown links.',
+            ? `Use the web_search tool to discover current information on the web. The required queries array accepts 1–${maxQueries} non-empty search queries; use a one-item array for a single search. It returns an optional answer plus a list of source URLs. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links.`
+            : `Use the web_search tool to discover current information on the web. The required queries array accepts 1–${maxQueries} non-empty search queries; use a one-item array for a single search. It returns an optional answer plus a list of source URLs. Use the returned source snippets when available, and cite the relevant URLs as markdown links.`,
     });
     ctx.tools.register(defineTool({
         name: 'web_search',
-        description: 'Search the web for current information. Returns an optional summary answer and a list of source URLs.',
+        description: `Search the web for current information. Provide 1–${maxQueries} queries in the required queries array. Returns an optional summary answer and a list of source URLs.`,
         parameters: {
-            query: { type: 'string', required: true, description: 'The search query.' },
+            queries: {
+                type: 'array',
+                required: true,
+                items: { type: 'string' },
+                description: `Required search queries; accepts 1–${maxQueries} items and merges their results.`,
+            },
         },
         output: {
             schema: {
@@ -226,8 +315,8 @@ export function applyWebSearchTool(ctx, maxResults, timeoutMs, fetchEnabled) {
         // Provider reads do not mutate parent-agent state.
         isConcurrencySafe: () => true,
         async execute(args, exec) {
-            const input = parseSearchArgs(args);
-            const result = await ctx.web.search({ query: input.query, maxResults }, exec.signal);
+            const queries = parseSearchArgs(args, maxQueries);
+            const result = await runSearchQueries(ctx, queries, maxResults, exec.signal);
             return {
                 ...result.content !== undefined ? { content: result.content } : {},
                 sources: result.sources.map(projectSource),

package/dist/kernel/tool-web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-web",
   "description": "Model-facing web tools (web_search, web_fetch) over the Nomix Harness web capability seam (ctx.web)",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/tool-workflow/lib/index.js

@@ -1,4 +1,4 @@
-import z from "@nomix-ai/schemastery";
+import z from "../../schemastery/lib/index.mjs";
 import { defineTool } from "../../tools/lib/index.js";
 //#region lib/types/index.js
 /**

package/dist/kernel/tool-workflow/lib/types/index.d.ts

@@ -9,8 +9,8 @@
  * section rather than deployment persona prose.
  * @module @nomix-ai/nomix-tool-workflow
  */
-import type { Context } from '@nomix-ai/cordis';
-import z from '@nomix-ai/schemastery';
+import type { Context } from '../../../cordis/lib/index.js';
+import z from '../../../schemastery/lib/index.mjs';
 export declare const name = "tool-workflow";
 export declare const inject: string[];
 /** Config: the model-facing tool name plus result rendering caps. */

package/dist/kernel/tool-workflow/lib/types/index.js

@@ -9,7 +9,7 @@
  * section rather than deployment persona prose.
  * @module @nomix-ai/nomix-tool-workflow
  */
-import z from '@nomix-ai/schemastery';
+import z from '../../../schemastery/lib/index.mjs';
 import { defineTool } from '../../../tools/lib/index.js';
 export const name = 'tool-workflow';
 export const inject = ['tools', 'workflowEngine', 'systemPrompt'];