@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-input-trigger/lib/client.js

@@ -9,7 +9,37 @@ window.__ModuleLoader__.load({
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
 		let _nomix_ai_nomix_client_ui_primitives = require("@nomix-ai/nomix-client-ui-primitives");
+		//#region ../../context/file-reference/src/grammar.ts
+		/**
+		* Extract an `@path` or `@"path with spaces` token at the cursor. An `@`
+		* inside another token, such as an email address, is not a completion trigger.
+		* @param line - current editor line.
+		* @param cursorCol - cursor column within that line.
+		* @returns the active token, or `undefined` outside an `@` token.
+		*/
+		function activeAtToken(line, cursorCol) {
+			const beforeCursor = line.slice(0, cursorCol);
+			const quoted = /(?:^|\s)(@"([^"]*))$/u.exec(beforeCursor);
+			if (quoted?.[1] !== void 0 && quoted[2] !== void 0) return {
+				prefix: quoted[1],
+				query: quoted[2],
+				quoted: true
+			};
+			const plain = /(?:^|\s)(@([^\s]*))$/u.exec(beforeCursor);
+			if (plain?.[1] === void 0 || plain[2] === void 0) return void 0;
+			return {
+				prefix: plain[1],
+				query: plain[2],
+				quoted: false
+			};
+		}
+		//#endregion
 		//#region lib/types/core/detect.js
+		/**
+		* Trigger detection pure core. Scans backward from
+		* the caret for a live trigger char under the guard tier and applies the
+		* word-boundary rules. Zero React / DOM / cordis.
+		*/
 		const WORD_CHAR = /[\p{L}\p{N}_]/u;
 		const WHITESPACE = /\s/u;
 		/**
@@ -31,10 +61,10 @@ window.__ModuleLoader__.load({
 			return true;
 		}
 		/**
-		* Detect a trigger token at the caret. Scans left from the caret and stops
-		* at the first whitespace (the token under edit never spans whitespace);
-		* trigger chars failing the guard tier or the word boundary are treated as
-		* ordinary token chars and the scan continues (`user@host`, URL slashes).
+		* Detect a trigger token at the caret. `@` first uses the shared grammar,
+		* including an open quoted token that may span whitespace. Slash detection
+		* scans left to the first whitespace; slashes failing the word boundary are
+		* treated as ordinary token chars and the scan continues (URL slashes).
 		* Guard tiers: plain = both chars live; claimed = '/' fully suppressed,
 		* '@' live; frozen = none.
 		*
@@ -48,15 +78,31 @@ window.__ModuleLoader__.load({
 		*/
 		const detectTrigger = (draft, caret, guard) => {
 			if (guard.tier === "frozen") return null;
+			const at = activeAtToken(draft, caret);
+			if (at !== void 0) {
+				const start = caret - at.prefix.length;
+				return {
+					trigger: "@",
+					query: at.query,
+					quoted: at.quoted,
+					position: draft.search(/\S/) === start ? "leading" : "inline",
+					span: {
+						start,
+						end: caret,
+						draftRev: 0
+					}
+				};
+			}
 			for (let i = caret - 1; i >= 0; i--) {
 				const ch = draft.charAt(i);
 				if (WHITESPACE.test(ch)) return null;
-				if (ch !== "/" && ch !== "@") continue;
-				if (guard.tier === "claimed" && ch === "/") continue;
+				if (ch !== "/") continue;
+				if (guard.tier === "claimed") continue;
 				if (!boundaryOk(draft, i, ch)) continue;
 				return {
 					trigger: ch,
 					query: draft.slice(i + 1, caret),
+					quoted: false,
 					position: draft.search(/\S/) === i ? "leading" : "inline",
 					span: {
 						start: i,
@@ -82,14 +128,15 @@ window.__ModuleLoader__.load({
 		* Shell-side step before dispatching `hit` on a fresh menu open.
 		*
 		* @param state - Current menu state.
-		* @param sources - Source names registered for the hit trigger, menu order.
+		* @param sources - Sources registered for the hit trigger, in menu order.
 		* @returns State carrying the new pending roster; highlight cleared.
 		*/
 		function seedGroups(state, sources) {
 			return {
 				...state,
 				groups: sources.map((source) => ({
-					source,
+					source: source.name,
+					...source.showGroupTitle === false ? { showGroupTitle: false } : {},
 					status: "pending",
 					items: []
 				})),
@@ -153,7 +200,7 @@ window.__ModuleLoader__.load({
 						hit: ev.hit,
 						generation: state.generation + 1,
 						groups: state.groups.map((g) => ({
-							source: g.source,
+							...g,
 							status: "pending",
 							items: []
 						})),
@@ -165,7 +212,7 @@ window.__ModuleLoader__.load({
 					if (idx < 0) return state;
 					const items = ev.items ?? [];
 					const groups = state.groups.map((g, i) => i === idx ? {
-						source: g.source,
+						...g,
 						status: "ready",
 						items
 					} : g);
@@ -276,7 +323,7 @@ window.__ModuleLoader__.load({
 					}
 				};
 				const prev = this.menu.getSnapshot();
-				const same = !launched && prev.open && prev.hit !== null && prev.hit.trigger === hit.trigger && prev.hit.query === hit.query && prev.hit.span.start === hit.span.start && prev.hit.span.end === hit.span.end;
+				const same = !launched && prev.open && prev.hit !== null && prev.hit.trigger === hit.trigger && prev.hit.query === hit.query && prev.hit.quoted === hit.quoted && prev.hit.span.start === hit.span.start && prev.hit.span.end === hit.span.end;
 				this.hit = hit;
 				if (same) return;
 				const roster = this.deps.roster.sources(hit.trigger);
@@ -285,7 +332,7 @@ window.__ModuleLoader__.load({
 					this.reduce({ type: "close" });
 					return;
 				}
-				if (launched || !prev.open || prev.hit === null || prev.hit.trigger !== hit.trigger) this.menu.set(seedGroups(this.menu.getSnapshot(), roster.map((s) => s.name)));
+				if (launched || !prev.open || prev.hit === null || prev.hit.trigger !== hit.trigger) this.menu.set(seedGroups(this.menu.getSnapshot(), roster));
 				this.reduce({
 					type: "hit",
 					hit
@@ -314,7 +361,7 @@ window.__ModuleLoader__.load({
 				this.stopFetch();
 				this.hit = hit;
 				this.launcher.set(source);
-				this.menu.set(seedGroups(this.menu.getSnapshot(), [source]));
+				this.menu.set(seedGroups(this.menu.getSnapshot(), [match]));
 				this.reduce({
 					type: "hit",
 					hit
@@ -421,15 +468,17 @@ window.__ModuleLoader__.load({
 			* input machine applies it inside the same submit attempt — no event).
 			* @param line - trimmed draft; the leading char selects the trigger roster.
 			* @param signal - attempt-scoped abort from the input machine.
+			* @param envelope - non-text submission state accompanying the draft.
 			* @returns the winning outcome or undefined (default sink). Rejects when a
-			* polled source's warmup fails — the caller must not silently downgrade.
+			* polled source's warmup fails or the winning source refuses the envelope —
+			* the caller must not silently downgrade.
 			*/
-			async adjudicate(line, signal) {
+			async adjudicate(line, signal, envelope) {
 				const projection = this.project();
 				for (const src of this.deps.roster.all()) {
 					if (signal.aborted) throw signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("slash adjudication aborted");
 					if (src.matchEnter === void 0 || !line.startsWith(src.trigger)) continue;
-					const outcome = await src.matchEnter(projection, line, signal);
+					const outcome = await src.matchEnter(projection, line, signal, envelope);
 					if (outcome !== void 0) return outcome;
 				}
 			}
@@ -490,7 +539,8 @@ window.__ModuleLoader__.load({
 				}) === true;
 				if ("text" in outcome) return actx.bail(actx, "slash/input-insert-text", {
 					text: outcome.text,
-					span
+					span,
+					...outcome.continue === true ? { continue: true } : {}
 				}) === true;
 				return actx.bail(actx, "slash/input-insert-reference", {
 					reference: outcome.insert,
@@ -532,6 +582,7 @@ window.__ModuleLoader__.load({
 				const projection = this.project();
 				for (const source of roster) source.candidates(projection, {
 					query: hit.query,
+					quoted: hit.quoted,
 					position: hit.position,
 					signal: controller.signal
 				}).then((items) => {
@@ -663,7 +714,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0nomix-css:/home/runner/work/nomix-harness/nomix-harness/packages/client/ui-input-trigger/src/client/MenuView.module.css.mjs
-		const css = "._4OjIBa_menu{z-index:100;--nomix-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--nomix-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:1px solid var(--dsw-alias-border-inverted);background:var(--dsw-specific-menu);min-width:min(260px,100%);max-width:min(537px,100%);max-height:320px;box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;padding:4px;display:flex;position:absolute;bottom:calc(100% + 4px);left:0;overflow:hidden}._4OjIBa_viewport{flex-direction:column;min-height:0;display:flex;overflow-y:auto}._4OjIBa_item{cursor:pointer;width:100%;min-height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:10px;align-items:center;gap:8px;padding:8px 10px;font-size:14px;line-height:22px;display:flex}._4OjIBa_item:hover,._4OjIBa_item._4OjIBa_active{background:var(--dsw-alias-interactive-bg-hover)}._4OjIBa_itemIcon{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;display:inline-flex}._4OjIBa_itemName{text-overflow:ellipsis;white-space:nowrap;flex:none;max-width:40%;overflow:hidden}._4OjIBa_itemDescription{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-tertiary);flex:1;overflow:hidden}._4OjIBa_groupTitle{color:var(--dsw-alias-label-tertiary);padding:8px 10px;font-size:12px;line-height:16px}._4OjIBa_loading{min-height:40px;color:var(--dsw-alias-label-dimmed);align-items:center;padding:8px 10px;font-size:14px;line-height:22px;display:flex}";
+		const css = "._4OjIBa_menu{z-index:100;--nomix-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--nomix-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:1px solid var(--dsw-alias-border-inverted);background:var(--dsw-specific-menu);min-width:min(260px,100%);max-width:min(537px,100%);max-height:320px;box-shadow:var(--dsw-shadow-lv3);border-radius:12px;flex-direction:column;padding:4px;display:flex;position:absolute;bottom:calc(100% + 4px);left:0;overflow:hidden}._4OjIBa_viewport{flex-direction:column;min-height:0;display:flex;overflow-y:auto}._4OjIBa_item{cursor:pointer;width:100%;min-height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:10px;align-items:center;gap:8px;padding:8px 10px;font-size:14px;line-height:22px;display:flex}._4OjIBa_item:hover,._4OjIBa_item._4OjIBa_active{background:var(--dsw-alias-interactive-bg-hover)}._4OjIBa_sectionTitle{min-height:26px;color:var(--dsw-alias-label-tertiary);flex:none;padding:6px 10px 2px;font-size:12px;font-weight:500;line-height:18px}._4OjIBa_sectionTitle:not(:first-child){margin-top:4px}._4OjIBa_itemIcon{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;display:inline-flex}._4OjIBa_itemName{text-overflow:ellipsis;white-space:nowrap;flex:none;max-width:40%;overflow:hidden}._4OjIBa_itemDescription{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-tertiary);flex:1;overflow:hidden}._4OjIBa_groupTitle{color:var(--dsw-alias-label-tertiary);padding:8px 10px;font-size:12px;line-height:16px}._4OjIBa_loading{min-height:40px;color:var(--dsw-alias-label-dimmed);align-items:center;padding:8px 10px;font-size:14px;line-height:22px;display:flex}";
 		const tagId = "@nomix-ai/nomix-client-ui-input-trigger/MenuView.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -673,15 +724,16 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var MenuView_module_css_default = {
-			"item": "_4OjIBa_item",
+			"active": "_4OjIBa_active",
 			"groupTitle": "_4OjIBa_groupTitle",
+			"item": "_4OjIBa_item",
+			"itemDescription": "_4OjIBa_itemDescription",
 			"itemIcon": "_4OjIBa_itemIcon",
+			"itemName": "_4OjIBa_itemName",
 			"loading": "_4OjIBa_loading",
 			"menu": "_4OjIBa_menu",
-			"active": "_4OjIBa_active",
-			"viewport": "_4OjIBa_viewport",
-			"itemName": "_4OjIBa_itemName",
-			"itemDescription": "_4OjIBa_itemDescription"
+			"sectionTitle": "_4OjIBa_sectionTitle",
+			"viewport": "_4OjIBa_viewport"
 		};
 		//#endregion
 		//#region lib/types/client/MenuView.js
@@ -737,7 +789,7 @@ window.__ModuleLoader__.load({
 				"aria-activedescendant": highlight !== null ? optionId(highlight.source, highlight.index) : void 0,
 				children: (0, react_jsx_runtime.jsx)("div", {
 					className: MenuView_module_css_default.viewport,
-					children: state.groups.map((group) => group.status === "ready" && group.items.length === 0 ? null : (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [(0, react_jsx_runtime.jsx)("div", {
+					children: state.groups.map((group) => group.status === "ready" && group.items.length === 0 ? null : (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [group.showGroupTitle === false || group.items.some((item) => item.section !== void 0) ? null : (0, react_jsx_runtime.jsx)("div", {
 						className: MenuView_module_css_default.groupTitle,
 						role: "presentation",
 						"data-source": group.source,
@@ -748,7 +800,11 @@ window.__ModuleLoader__.load({
 						children: t("loading")
 					}) : group.items.map((item, index) => {
 						const active = highlight !== null && highlight.source === group.source && highlight.index === index;
-						return (0, react_jsx_runtime.jsxs)("button", {
+						return (0, react_jsx_runtime.jsxs)(react.Fragment, { children: [item.section !== void 0 && item.section !== group.items[index - 1]?.section ? (0, react_jsx_runtime.jsx)("div", {
+							className: MenuView_module_css_default.sectionTitle,
+							role: "presentation",
+							children: item.section
+						}) : null, (0, react_jsx_runtime.jsxs)("button", {
 							id: optionId(group.source, index),
 							type: "button",
 							role: "option",
@@ -773,7 +829,7 @@ window.__ModuleLoader__.load({
 									children: item.description
 								})
 							]
-						}, `${group.source}:${item.name}`);
+						})] }, optionId(group.source, index));
 					})] }, group.source))
 				})
 			});

package/dist/kernel/client-ui-input-trigger/lib/types/client/MenuView.js

@@ -61,18 +61,22 @@ export function MenuView({ menu, onPick, onDismiss, t }) {
         return null;
     return (_jsx("div", { ref: listRef, className: css.menu, style: { maxHeight }, role: "listbox", "aria-label": t('suggestions.aria'), "aria-activedescendant": highlight !== null ? optionId(highlight.source, highlight.index) : undefined, children: _jsx("div", { className: css.viewport, children: state.groups.map(group => (group.status === 'ready' && group.items.length === 0)
                 ? null
-                : (_jsxs(Fragment, { children: [_jsx("div", { className: css.groupTitle, role: "presentation", "data-source": group.source, children: t(group.source) }), group.status === 'pending'
+                : (_jsxs(Fragment, { children: [group.showGroupTitle === false || group.items.some(item => item.section !== undefined)
+                            ? null
+                            : _jsx("div", { className: css.groupTitle, role: "presentation", "data-source": group.source, children: t(group.source) }), group.status === 'pending'
                             ? _jsx("div", { className: css.loading, "data-source": group.source, children: t('loading') })
                             : group.items.map((item, index) => {
                                 const active = highlight !== null && highlight.source === group.source && highlight.index === index;
-                                return (_jsxs("button", { id: optionId(group.source, index), type: "button", role: "option", "aria-selected": active, className: clsx(css.item, active && css.active), 
-                                    // mousedown, not click: the textarea keeps focus (combobox
-                                    // pattern) — preventing default stops the focus steal, and the
-                                    // pick runs before any blur-driven teardown.
-                                    onMouseDown: (ev) => {
-                                        ev.preventDefault();
-                                        onPick(group.source, index);
-                                    }, children: [item.icon !== undefined && _jsx("span", { className: css.itemIcon, "aria-hidden": true, children: item.icon }), _jsx("span", { className: css.itemName, children: item.name }), item.description !== undefined && _jsx("span", { className: css.itemDescription, children: item.description })] }, `${group.source}:${item.name}`));
+                                return (_jsxs(Fragment, { children: [item.section !== undefined && item.section !== group.items[index - 1]?.section
+                                            ? _jsx("div", { className: css.sectionTitle, role: "presentation", children: item.section })
+                                            : null, _jsxs("button", { id: optionId(group.source, index), type: "button", role: "option", "aria-selected": active, className: clsx(css.item, active && css.active), 
+                                            // mousedown, not click: the textarea keeps focus (combobox
+                                            // pattern) — preventing default stops the focus steal, and the
+                                            // pick runs before any blur-driven teardown.
+                                            onMouseDown: (ev) => {
+                                                ev.preventDefault();
+                                                onPick(group.source, index);
+                                            }, children: [item.icon !== undefined && _jsx("span", { className: css.itemIcon, "aria-hidden": true, children: item.icon }), _jsx("span", { className: css.itemName, children: item.name }), item.description !== undefined && _jsx("span", { className: css.itemDescription, children: item.description })] })] }, optionId(group.source, index)));
                             })] }, group.source))) }) }));
 }
 //# sourceMappingURL=MenuView.js.map

package/dist/kernel/client-ui-input-trigger/lib/types/client/controller.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ClientContext, SessionId, SnapshotStore } from '../../../../client-runtime/lib/client.js';
 import type { MenuState, TriggerHit } from '../core/contract.ts';
-import type { ArbitrateKey, ArbitrateOutcome, PickOutcome, InputTriggerSource, TriggerChar, TriggerGuard } from '../types.ts';
+import type { ArbitrateKey, ArbitrateOutcome, PickOutcome, InputTriggerSource, SubmitEnvelope, TriggerChar, TriggerGuard } from '../types.ts';
 /** Roster access the controller borrows from the root service (registration order preserved). */
 export interface SourceRoster {
     sources(trigger: string): readonly InputTriggerSource[];
@@ -113,10 +113,12 @@ export declare class InputTriggerController {
      * input machine applies it inside the same submit attempt — no event).
      * @param line - trimmed draft; the leading char selects the trigger roster.
      * @param signal - attempt-scoped abort from the input machine.
+     * @param envelope - non-text submission state accompanying the draft.
      * @returns the winning outcome or undefined (default sink). Rejects when a
-     * polled source's warmup fails — the caller must not silently downgrade.
+     * polled source's warmup fails or the winning source refuses the envelope —
+     * the caller must not silently downgrade.
      */
-    adjudicate(line: string, signal: AbortSignal): Promise<PickOutcome>;
+    adjudicate(line: string, signal: AbortSignal, envelope: SubmitEnvelope): Promise<PickOutcome>;
     /**
      * Drop the menu group of a disposed source (root registry change notification).
      * @param source - the source whose registration was disposed.

package/dist/kernel/client-ui-input-trigger/lib/types/client/controller.js

@@ -69,6 +69,7 @@ export class InputTriggerController {
         const prev = this.menu.getSnapshot();
         const same = !launched && prev.open && prev.hit !== null
             && prev.hit.trigger === hit.trigger && prev.hit.query === hit.query
+            && prev.hit.quoted === hit.quoted
             && prev.hit.span.start === hit.span.start && prev.hit.span.end === hit.span.end;
         this.hit = hit;
         if (same)
@@ -80,7 +81,7 @@ export class InputTriggerController {
             return;
         }
         if (launched || !prev.open || prev.hit === null || prev.hit.trigger !== hit.trigger) {
-            this.menu.set(seedGroups(this.menu.getSnapshot(), roster.map(s => s.name)));
+            this.menu.set(seedGroups(this.menu.getSnapshot(), roster));
         }
         this.reduce({ type: 'hit', hit });
         this.fetchCandidates(hit, roster);
@@ -108,7 +109,7 @@ export class InputTriggerController {
         this.stopFetch();
         this.hit = hit;
         this.launcher.set(source);
-        this.menu.set(seedGroups(this.menu.getSnapshot(), [source]));
+        this.menu.set(seedGroups(this.menu.getSnapshot(), [match]));
         this.reduce({ type: 'hit', hit });
         this.fetchCandidates(hit, [match]);
     }
@@ -222,10 +223,12 @@ export class InputTriggerController {
      * input machine applies it inside the same submit attempt — no event).
      * @param line - trimmed draft; the leading char selects the trigger roster.
      * @param signal - attempt-scoped abort from the input machine.
+     * @param envelope - non-text submission state accompanying the draft.
      * @returns the winning outcome or undefined (default sink). Rejects when a
-     * polled source's warmup fails — the caller must not silently downgrade.
+     * polled source's warmup fails or the winning source refuses the envelope —
+     * the caller must not silently downgrade.
      */
-    async adjudicate(line, signal) {
+    async adjudicate(line, signal, envelope) {
         const projection = this.project();
         for (const src of this.deps.roster.all()) {
             if (signal.aborted) {
@@ -233,7 +236,7 @@ export class InputTriggerController {
             }
             if (src.matchEnter === undefined || !line.startsWith(src.trigger))
                 continue;
-            const outcome = await src.matchEnter(projection, line, signal);
+            const outcome = await src.matchEnter(projection, line, signal, envelope);
             if (outcome !== undefined)
                 return outcome;
         }
@@ -295,7 +298,11 @@ export class InputTriggerController {
             return actx.bail(actx, 'slash/input-begin-command', { claim: outcome.claim, span }) === true;
         }
         if ('text' in outcome) {
-            return actx.bail(actx, 'slash/input-insert-text', { text: outcome.text, span }) === true;
+            return actx.bail(actx, 'slash/input-insert-text', {
+                text: outcome.text,
+                span,
+                ...outcome.continue === true ? { continue: true } : {},
+            }) === true;
         }
         return actx.bail(actx, 'slash/input-insert-reference', { reference: outcome.insert, span }) === true;
     }
@@ -339,7 +346,12 @@ export class InputTriggerController {
         const projection = this.project();
         for (const source of roster) {
             void source
-                .candidates(projection, { query: hit.query, position: hit.position, signal: controller.signal })
+                .candidates(projection, {
+                query: hit.query,
+                quoted: hit.quoted,
+                position: hit.position,
+                signal: controller.signal,
+            })
                 .then((items) => {
                 if (controller.signal.aborted)
                     return;

package/dist/kernel/client-ui-input-trigger/lib/types/client/index.d.ts

@@ -6,7 +6,7 @@ export type { InputTriggerControllerDeps, SourceRoster } from './controller.ts';
 export type { MenuViewInjected } from './slots.ts';
 export type { MenuViewProps } from './MenuView.tsx';
 export type { MenuKey } from './locales.ts';
-export type { ArbitrateKey, ArbitrateOutcome, BeginCommandRequest, CandidateRequest, ClientSessionContext, CommandClaim, ConsumeTokenRequest, InsertReferenceRequest, PickOutcome, PickVia, ReferenceCodec, ReferenceInsert, InputTriggerCandidate, InputTriggerPick, InputTriggerSource, SubmitOutcome, TokenSpan, TriggerChar, TriggerGuard, TriggerPosition, } from '../types.ts';
+export type { ArbitrateKey, ArbitrateOutcome, BeginCommandRequest, CandidateRequest, ClientSessionContext, CommandClaim, ConsumeTokenRequest, InsertReferenceRequest, PickOutcome, PickVia, ReferenceCodec, ReferenceInsert, InputTriggerCandidate, InputTriggerPick, InputTriggerSource, SubmitEnvelope, SubmitImageAttachment, SubmitOutcome, TokenSpan, TriggerChar, TriggerGuard, TriggerPosition, } from '../types.ts';
 export type { DetectTrigger, ExactMatch, MenuEvent, MenuReduce, MenuState, TriggerHit } from '../core/contract.ts';
 export type { InputTriggerServiceContract } from './contract.ts';
 declare module '@nomix-ai/cordis' {

package/dist/kernel/client-ui-input-trigger/lib/types/core/contract.d.ts

@@ -10,6 +10,8 @@ export interface TriggerHit {
     readonly trigger: TriggerChar;
     /** Text between the trigger char and the caret, live-filtered. */
     readonly query: string;
+    /** True only for an open quoted `@file` token. */
+    readonly quoted: boolean;
     /** leading = draft trimmed (whitespace incl. newlines) starts with the token. */
     readonly position: TriggerPosition;
     /** Token span; draftRev injected by the caller. */
@@ -17,8 +19,9 @@ export interface TriggerHit {
 }
 /**
  * Detect a trigger token at the caret under the given guard tier.
- * Word-boundary rule: the char before the trigger is start-of-line,
- * whitespace, or punctuation; `user@host` and URL '/' do not trigger.
+ * `@` uses the shared file-reference start/whitespace grammar; `/` accepts
+ * punctuation boundaries with URL carve-outs. `user@host` and URL `/` do not
+ * trigger.
  * Returns null when no trigger is live at the caret.
  */
 export type DetectTrigger = (draft: string, caret: number, guard: TriggerGuard) => TriggerHit | null;
@@ -30,6 +33,8 @@ export interface MenuState {
     readonly generation: number;
     readonly groups: readonly {
         readonly source: string;
+        /** False when candidate section rows own all visible group labeling. */
+        readonly showGroupTitle?: boolean;
         readonly status: 'pending' | 'ready';
         readonly items: readonly InputTriggerCandidate[];
     }[];

package/dist/kernel/client-ui-input-trigger/lib/types/core/detect.d.ts

@@ -1,9 +1,9 @@
 import type { DetectTrigger } from './contract.ts';
 /**
- * Detect a trigger token at the caret. Scans left from the caret and stops
- * at the first whitespace (the token under edit never spans whitespace);
- * trigger chars failing the guard tier or the word boundary are treated as
- * ordinary token chars and the scan continues (`user@host`, URL slashes).
+ * Detect a trigger token at the caret. `@` first uses the shared grammar,
+ * including an open quoted token that may span whitespace. Slash detection
+ * scans left to the first whitespace; slashes failing the word boundary are
+ * treated as ordinary token chars and the scan continues (URL slashes).
  * Guard tiers: plain = both chars live; claimed = '/' fully suppressed,
  * '@' live; frozen = none.
  *

package/dist/kernel/client-ui-input-trigger/lib/types/core/detect.js

@@ -1,3 +1,9 @@
+/**
+ * Trigger detection pure core. Scans backward from
+ * the caret for a live trigger char under the guard tier and applies the
+ * word-boundary rules. Zero React / DOM / cordis.
+ */
+import { activeAtToken } from '../../../../file-reference/lib/types/grammar.js';
 const WORD_CHAR = /[\p{L}\p{N}_]/u;
 const WHITESPACE = /\s/u;
 /**
@@ -24,10 +30,10 @@ function boundaryOk(draft, index, char) {
     return true;
 }
 /**
- * Detect a trigger token at the caret. Scans left from the caret and stops
- * at the first whitespace (the token under edit never spans whitespace);
- * trigger chars failing the guard tier or the word boundary are treated as
- * ordinary token chars and the scan continues (`user@host`, URL slashes).
+ * Detect a trigger token at the caret. `@` first uses the shared grammar,
+ * including an open quoted token that may span whitespace. Slash detection
+ * scans left to the first whitespace; slashes failing the word boundary are
+ * treated as ordinary token chars and the scan continues (URL slashes).
  * Guard tiers: plain = both chars live; claimed = '/' fully suppressed,
  * '@' live; frozen = none.
  *
@@ -42,19 +48,31 @@ function boundaryOk(draft, index, char) {
 export const detectTrigger = (draft, caret, guard) => {
     if (guard.tier === 'frozen')
         return null;
+    const at = activeAtToken(draft, caret);
+    if (at !== undefined) {
+        const start = caret - at.prefix.length;
+        return {
+            trigger: '@',
+            query: at.query,
+            quoted: at.quoted,
+            position: draft.search(/\S/) === start ? 'leading' : 'inline',
+            span: { start, end: caret, draftRev: 0 },
+        };
+    }
     for (let i = caret - 1; i >= 0; i--) {
         const ch = draft.charAt(i);
         if (WHITESPACE.test(ch))
             return null;
-        if (ch !== '/' && ch !== '@')
+        if (ch !== '/')
             continue;
-        if (guard.tier === 'claimed' && ch === '/')
+        if (guard.tier === 'claimed')
             continue;
         if (!boundaryOk(draft, i, ch))
             continue;
         return {
             trigger: ch,
             query: draft.slice(i + 1, caret),
+            quoted: false,
             position: draft.search(/\S/) === i ? 'leading' : 'inline',
             span: { start: i, end: caret, draftRev: 0 },
         };

package/dist/kernel/client-ui-input-trigger/lib/types/core/menu.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Menu reduction pure core. One group per source;
+ * generation-gated settlement; empty ready groups auto-close. Zero React /
+ * DOM / cordis. Stale or no-op events return the same state reference so
+ * store subscribers skip re-renders.
+ *
+ * Roster protocol: the frozen `hit` event carries no source roster, so the
+ * reducer cannot invent groups. Opening from a closed state, the shell seeds
+ * the roster with {@link seedGroups} and then dispatches `hit`; a `hit`
+ * while open (query refinement) resets the existing groups to pending under
+ * a new generation. Auto-close and explicit close drop the groups.
+ */
+import type { InputTriggerSource } from '../types.ts';
 import type { ExactMatch, MenuReduce, MenuState } from './contract.ts';
 /** Closed rest state with generation 0; store initializer and test seed. */
 export declare const MENU_CLOSED: MenuState;
@@ -6,10 +19,10 @@ export declare const MENU_CLOSED: MenuState;
  * Shell-side step before dispatching `hit` on a fresh menu open.
  *
  * @param state - Current menu state.
- * @param sources - Source names registered for the hit trigger, menu order.
+ * @param sources - Sources registered for the hit trigger, in menu order.
  * @returns State carrying the new pending roster; highlight cleared.
  */
-export declare function seedGroups(state: MenuState, sources: readonly string[]): MenuState;
+export declare function seedGroups(state: MenuState, sources: readonly Pick<InputTriggerSource, 'name' | 'showGroupTitle'>[]): MenuState;
 /**
  * Pure menu reducer. `hit` opens a new generation over the seeded roster
  * (null hit closes); `source-settled` outside the current generation, the

package/dist/kernel/client-ui-input-trigger/lib/types/core/menu.js

@@ -5,11 +5,20 @@ export const MENU_CLOSED = { open: false, hit: null, generation: 0, groups: [],
  * Shell-side step before dispatching `hit` on a fresh menu open.
  *
  * @param state - Current menu state.
- * @param sources - Source names registered for the hit trigger, menu order.
+ * @param sources - Sources registered for the hit trigger, in menu order.
  * @returns State carrying the new pending roster; highlight cleared.
  */
 export function seedGroups(state, sources) {
-    return { ...state, groups: sources.map(source => ({ source, status: 'pending', items: [] })), highlight: null };
+    return {
+        ...state,
+        groups: sources.map(source => ({
+            source: source.name,
+            ...(source.showGroupTitle === false ? { showGroupTitle: false } : {}),
+            status: 'pending',
+            items: [],
+        })),
+        highlight: null,
+    };
 }
 /** Close, preserving the generation so in-flight settlements stay droppable. */
 const closed = (state) => state.open || state.hit !== null || state.groups.length > 0 || state.highlight !== null
@@ -64,7 +73,7 @@ export const menuReduce = (state, ev) => {
                 open: true,
                 hit: ev.hit,
                 generation: state.generation + 1,
-                groups: state.groups.map(g => ({ source: g.source, status: 'pending', items: [] })),
+                groups: state.groups.map(g => ({ ...g, status: 'pending', items: [] })),
                 highlight: null,
             };
         }
@@ -75,7 +84,7 @@ export const menuReduce = (state, ev) => {
             if (idx < 0)
                 return state;
             const items = ev.items ?? [];
-            const groups = state.groups.map((g, i) => i === idx ? { source: g.source, status: 'ready', items } : g);
+            const groups = state.groups.map((g, i) => i === idx ? { ...g, status: 'ready', items } : g);
             if (allReadyEmpty(groups))
                 return closed(state);
             const highlight = validHighlight(state.highlight, groups) ?? firstHighlight(groups);