@nomix-ai/nomix-harness 0.2.5 → 0.2.6

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.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

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

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tool-workflow",
   "description": "Model-facing workflow tool: run a JavaScript orchestration script over ctx.workflowEngine",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/tools/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-tools",
   "description": "Tool registry and execution pipeline for the Nomix Harness",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/typert-generator/lib/index.js

@@ -3859,6 +3859,11 @@ function githubSlug(heading) {
 function anchorFor(headingText) {
 	return [`<a id="${githubSlug(headingText)}"></a>`, ""];
 }
+/** Render a subsystem `file:line` source pointer as a file-only link. */
+function sourceLink(source) {
+	const file = source.split(":")[0];
+	return `[\`${file}\`](../../${file})`;
+}
 /** Render one harness event entry onto its owning page, nested under its scope heading. */
 function renderEvent(e, onPage, linkedTypePages) {
 	const out = [
@@ -3870,7 +3875,7 @@ function renderEvent(e, onPage, linkedTypePages) {
 	out.push("```ts cordis-catalog", e.jsDoc, e.signature, "```", "");
 	const links = typeLinks(e.signature, onPage, linkedTypePages);
 	if (links) out.push(links, "");
-	out.push(`Source: [\`${e.source}\`](../../${e.source.split(":")[0]})`, "");
+	out.push(`Source: ${sourceLink(e.source)}`, "");
 	return out;
 }
 /** Render one harness service entry onto its owning page. */
@@ -3893,7 +3898,7 @@ function renderService(s, onPage, linkedTypePages) {
 		const links = typeLinks(methods.map((method) => method.signature).join("\n"), onPage, linkedTypePages);
 		if (links) out.push(links, "");
 	}
-	out.push(`Source: [\`${s.source}\`](../../${s.source.split(":")[0]})`, "");
+	out.push(`Source: ${sourceLink(s.source)}`, "");
 	return out;
 }
 /** The shared generated-file banner comment. */
@@ -3922,7 +3927,7 @@ function renderPageRegion(page, services, events, policy) {
 		"",
 		"## Cordis API",
 		"",
-		"Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — this section is byte-identical in both language sides of the page. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).",
+		"Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — the language sides differ only in locale-specific paired document paths. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).",
 		""
 	];
 	for (const s of services) lines.push(...renderService(s, page, policy.linkedTypePages));

package/dist/kernel/typert-generator/lib/types/cordis-catalog.js

@@ -704,6 +704,11 @@ function githubSlug(heading) {
 function anchorFor(headingText) {
     return [`<a id="${githubSlug(headingText)}"></a>`, ''];
 }
+/** Render a subsystem `file:line` source pointer as a file-only link. */
+function sourceLink(source) {
+    const file = source.split(':')[0];
+    return `[\`${file}\`](../../${file})`;
+}
 /** Render one harness event entry onto its owning page, nested under its scope heading. */
 function renderEvent(e, onPage, linkedTypePages) {
     const out = [...anchorFor(`${e.name} — ${e.mode}`), `#### \`${e.name}\` — ${e.mode}`, ''];
@@ -713,7 +718,7 @@ function renderEvent(e, onPage, linkedTypePages) {
     const links = typeLinks(e.signature, onPage, linkedTypePages);
     if (links)
         out.push(links, '');
-    out.push(`Source: [\`${e.source}\`](../../${e.source.split(':')[0]})`, '');
+    out.push(`Source: ${sourceLink(e.source)}`, '');
     return out;
 }
 /** Render one harness service entry onto its owning page. */
@@ -734,7 +739,7 @@ function renderService(s, onPage, linkedTypePages) {
         if (links)
             out.push(links, '');
     }
-    out.push(`Source: [\`${s.source}\`](../../${s.source.split(':')[0]})`, '');
+    out.push(`Source: ${sourceLink(s.source)}`, '');
     return out;
 }
 /** The shared generated-file banner comment. */
@@ -763,7 +768,7 @@ export function renderPageRegion(page, services, events, policy) {
         '',
         '## Cordis API',
         '',
-        'Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — this section is byte-identical in both language sides of the page. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).',
+        'Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — the language sides differ only in locale-specific paired document paths. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).',
         '',
     ];
     for (const s of services)

package/dist/kernel/typert-generator/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-typert-generator",
   "description": "TypeScript project analyzer and model-driven Typert artifact generator",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/typert-loader/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-typert-loader",
   "description": "Loader integration for generated Typert package contributions",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/typert-protocol/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-typert-protocol",
   "description": "Compiler-independent Remote metadata and Typert provider protocols",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/typert-registry/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-typert-registry",
   "description": "Runtime registry for generated package reflection and Zod schemas",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/user-approval/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-user-approval",
   "description": "User-approval seam (ctx.approval) for the Nomix Harness: one-shot permission decisions dispatched to composed answerers over the approval/request waterfall, fail-closed by default",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/user-questions/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-user-questions",
   "description": "Abstract user-questions seam (ctx.userQuestions) for asking the human during agent runs",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/web/lib/types/types.d.ts

@@ -6,9 +6,10 @@
  */
 import { HarnessError } from '../../../llm/lib/index.js';
 /**
- * What one search-capable backend can return. The model-facing argument is just
- * a query; `maxResults` is a `nomix-tool-web`-layer bound passed through unchanged
- * and enforced on the way back by the seam (see {@link WebSearchResult}).
+ * What one search-capable backend is asked to search. Each request carries one
+ * query; a consumer may issue several requests. `maxResults` is a
+ * `nomix-tool-web`-layer bound passed through unchanged and enforced on the way
+ * back by the seam (see {@link WebSearchResult}).
  */
 export interface WebSearchRequest {
     readonly query: string;

package/dist/kernel/web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-web",
   "description": "Abstract web access capability seam (ctx.web) for the Nomix Harness — search/fetch provider registry, registration-order-independent selection, request/result vocabulary, and the WebError taxonomy",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },

package/dist/kernel/web-app/cordis.patch.yml

@@ -79,6 +79,12 @@
         writeEveryEvents: 200
         writeIntervalMs: 5000
 
+    - id: session-reference
+      name: '@nomix-ai/nomix-session-reference'
+
+    - id: file-reference-local
+      name: '@nomix-ai/nomix-file-reference-local'
+
     # Whole-log turn/step counts for the chat stats strip (the sessionStats
     # projection key); the projection registry itself is a base-layer row.
     - id: session-stats
@@ -122,15 +128,17 @@
     # Web glue owned by this bundle: resolves the built frontend dist (an
     # assembly fact of nomix-web-app, never user config), mounts the
     # frontend-static fallback owner, registers the web-surface prompt
-    # section and the bash runtime variable, and prints the URL line. The
-    # webStartup provider supplies invocation-only values; after the server
-    # binds, this row samples LAN trust once and provides `webRuntime`. A
-    # complete agent-preset persona suppresses the prompt section for that
-    # agent while retaining the host-owned shell variable.
+    # section and the bash runtime variable, prints the URL line, and opens the
+    # canonical local URL after the full tree settles. The webStartup provider
+    # supplies invocation-only values; after the server binds, this row samples
+    # LAN trust once and provides `webRuntime`. A complete agent-preset persona
+    # suppresses the prompt section for that agent while retaining the host-owned
+    # shell variable.
     - id: web-runtime
       name: '@nomix-ai/nomix-web-app'
       inject: [webStartup]
       config:
+        openBrowser: !!js ctx.webStartup.openBrowser
         printUrl: true
         surfaceContext: true
         trustedHosts: !!js ctx.webStartup.trustedHosts
@@ -180,6 +188,9 @@
     - id: ui-layout
       name: '@nomix-ai/nomix-client-ui-layout'
 
+    - id: ui-renderer
+      name: '@nomix-ai/nomix-client-ui-renderer'
+
     - id: ui-sidebar
       name: '@nomix-ai/nomix-client-ui-sidebar'
 
@@ -198,6 +209,13 @@
     - id: ui-conversation
       name: '@nomix-ai/nomix-client-ui-conversation'
 
+    # Official occupants for the generic sidebar and conversation brand slots.
+    - id: ui-brand-official
+      name: '@nomix-ai/nomix-client-ui-brand-official'
+
+    - id: ui-attachment
+      name: '@nomix-ai/nomix-client-ui-attachment'
+
     # Tool call tree, generic fallback, and keyed business Tool views.
     - id: ui-tool
       name: '@nomix-ai/nomix-client-ui-tool'
@@ -220,7 +238,7 @@
       name: '@nomix-ai/nomix-client-ui-workspace'
 
     # Input triggers: the '/' | '@' pipeline (ui-input-trigger), the command surface over
-    # it (ui-commands), and the two reference sources (ui-skill / ui-subagent).
+    # it (ui-commands), and the reference sources (ui-skill / ui-reference).
     - id: ui-input-trigger
       name: '@nomix-ai/nomix-client-ui-input-trigger'
 
@@ -233,6 +251,9 @@
     - id: ui-subagent
       name: '@nomix-ai/nomix-client-ui-subagent'
 
+    - id: ui-reference
+      name: '@nomix-ai/nomix-client-ui-reference'
+
     # Background jobs: the session-header list over the jobsBySession mirror.
     - id: ui-jobs
       name: '@nomix-ai/nomix-client-ui-jobs'