@nomix-ai/nomix-harness 0.2.5 → 0.2.6

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

@@ -74,18 +74,25 @@ function stopReasonError(result) {
     }
 }
 /**
- * Append the child's preserved partial answer to a stop-reason error so a
- * truncated or cancelled child's real text still reaches the parent model.
+ * Append provider-authored failure detail and the child's preserved partial
+ * answer to a stop-reason error, keeping diagnostic text separate from the
+ * child's assistant output.
  * @param error - the stop-reason headline.
- * @param output - the child's selected output (`SubagentResult.output`).
- * @returns the headline, extended with the partial text when any exists.
+ * @param result - the child's terminal result.
+ * @returns the headline, diagnostic, and partial text that are present.
  */
-function withPartialText(error, output) {
-    const text = output
+function withDiagnosticAndPartialText(error, result) {
+    const diagnostic = result.diagnostic === undefined
+        ? ''
+        : `\nDiagnostic: ${result.diagnostic}`;
+    const text = result.output
         .filter((block) => block.type === 'text')
         .map(block => block.text)
         .join('');
-    return text.length === 0 ? error : `${error}\nPartial output before the run ended:\n${text}`;
+    const partial = text.length === 0
+        ? ''
+        : `\nPartial output before the run ended:\n${text}`;
+    return `${error}${diagnostic}${partial}`;
 }
 /**
  * Collect and release one foreground run without letting disposal replace an
@@ -98,7 +105,7 @@ async function settleForegroundRun(run) {
             if (error !== undefined) {
                 // The registry converts this throw to isError; partial output is not
                 // success, but the preserved partial answer still reaches the parent.
-                throw new Error(withPartialText(error, result.output));
+                throw new Error(withDiagnosticAndPartialText(error, result));
             }
             return {
                 kind: 'foreground',

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-subagent",
   "description": "Model-facing subagent delegation tool over the ctx.subagents seam",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/tool-subagent-control/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-subagent-control",
   "description": "Globally named send_message, interrupt_agent, and list_agents tools over ctx.subagents continuations",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/tool-subagent-report/lib/index.js

@@ -16,7 +16,7 @@ const inject = [
 ];
 /** Guidance order after every per-tool section a continuable child can carry. */
 const REPORT_SECTION_ORDER = 117;
-const Config = z.object({ reportDelivery: z.union(["quiet", "wakeup"]).default("wakeup") });
+const Config = z.object({ reportDelivery: z.union(["quiet", "next-step"]).default("next-step") });
 /**
 * Install `report` and its usage guidance into one continuable child's scope.
 * Both registrations are owned by that scope and are therefore invisible to the

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

@@ -13,9 +13,9 @@ export declare const inject: string[];
 /** Config: how accepted reports are scheduled on the parent. */
 export interface Config {
     /**
-     * Parent scheduling (default `wakeup`). `wakeup` creates one ordinary later
-     * parent turn; `quiet` adds context without waking, so a parked parent learns
-     * of the report only when something else wakes it.
+     * Parent scheduling (default `next-step`). `next-step` wakes the parent and
+     * enters at its nearest step boundary; `quiet` adds the same context without
+     * waking, so a parked parent waits for another waking input.
      */
     reportDelivery?: SubagentReportDelivery;
 }

package/dist/kernel/tool-subagent-report/lib/types/index.js

@@ -15,7 +15,7 @@ export const inject = ['subagents', 'tools', 'systemPrompt'];
 /** Guidance order after every per-tool section a continuable child can carry. */
 const REPORT_SECTION_ORDER = 117;
 export const Config = z.object({
-    reportDelivery: z.union(['quiet', 'wakeup']).default('wakeup'),
+    reportDelivery: z.union(['quiet', 'next-step']).default('next-step'),
 });
 /**
  * Install `report` and its usage guidance into one continuable child's scope.

package/dist/kernel/tool-subagent-report/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-subagent-report",
   "description": "Child-scoped report tool over ctx.subagents continuations",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-terminal",
   "description": "Six model-facing persistent PTY tools with owner isolation and generic background-job integration",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

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

@@ -80,14 +80,17 @@ function apply(ctx, config) {
 	ctx.inject(["sessionProjections"], (projectionCtx) => {
 		projectionCtx.sessionProjections.register({
 			key: "todos",
-			schema: todosProjectionSchema,
+			stateSchema: todosProjectionSchema,
 			init: () => null,
 			apply: (state, event) => {
 				if (event.type === "todo/write") return event.data.todos;
 				if (event.type === "turn/start") return null;
 				return state;
 			},
-			view: (state) => state,
+			wire: {
+				viewSchema: todosProjectionSchema,
+				view: (state) => state
+			},
 			stateVersion: 2
 		});
 	});

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

@@ -98,7 +98,7 @@ export function apply(ctx, config) {
     ctx.inject(['sessionProjections'], (projectionCtx) => {
         projectionCtx.sessionProjections.register({
             key: 'todos',
-            schema: todosProjectionSchema,
+            stateSchema: todosProjectionSchema,
             init: () => null,
             apply: (state, event) => {
                 if (event.type === 'todo/write')
@@ -107,7 +107,7 @@ export function apply(ctx, config) {
                     return null;
                 return state;
             },
-            view: state => state,
+            wire: { viewSchema: todosProjectionSchema, view: state => state },
             stateVersion: 2,
         });
     });

package/dist/kernel/tool-todo/lib/types/types.d.ts

@@ -10,6 +10,9 @@
 import type { TodoItem } from '../../../session/lib/types/types.js';
 export type { TodoItem } from '../../../session/lib/types/types.js';
 declare module '@nomix-ai/nomix-session-projection/types' {
+    interface SessionProjectionStateMap {
+        todos: TodoItem[] | null;
+    }
     interface SessionProjectionMap {
         /**
          * The agent's current whole todo list (the latest `todo/write` snapshot),

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-todo",
   "description": "Model-facing todo_write tool over the Nomix Harness event-sourced session log",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

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

@@ -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/index.d.ts

@@ -7,7 +7,7 @@
  */
 import type { Context } from '../../../cordis/lib/index.js';
 import z from '../../../schemastery/lib/index.mjs';
-export { WEB_SEARCH_MAX_RESULTS, applyWebSearchTool, formatSearchOutput, parseSearchArgs, presentSearchCall, presentSearchResult, searchMetaFromValue, searchMetaFromResult } from './search.ts';
+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

@@ -6,9 +6,9 @@
  * @module @nomix-ai/nomix-tool-web
  */
 import z from '../../../schemastery/lib/index.mjs';
-import { applyWebSearchTool, WEB_SEARCH_MAX_RESULTS } from "./search.js";
+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/search.d.ts

@@ -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