@coffer-org/plugin-webchat 4.0.0 → 6.0.0

package/dist/{ChatWidget-Bs8zrQVZ.js → ChatWidget-DFVDexpD.js}

@@ -1,5 +1,5 @@
 import * as __fedReact from "react";
-import { Dialog, DialogContent, getPluginRoutes, getSiteLinks, getSiteShelves, uploadFile, useMinWidth } from "@coffer-org/web-ui";
+import { Dialog, DialogContent, classifySiteHref, uploadFile, useMinWidth } from "@coffer-org/web-ui";
 import { createContext, createElement, forwardRef, memo, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { useLocation, useNavigate } from "react-router-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -23722,54 +23722,6 @@ function remarkGfm(options) {
 	toMarkdownExtensions.push(gfmToMarkdown(settings));
 }
 //#endregion
-//#region src/ui/internal-link.ts
-var SEGMENT = /^[A-Za-z0-9._~%-]+$/;
-/** Returns captured ':param' values on a match, or null. '*' is legal only as the
-*  last pattern segment, so this branch may return immediately without reading got to the end. */
-function matchesPattern(pathname, pattern) {
-	const got = pathname.split("/").filter(Boolean);
-	const want = pattern.split("/").filter(Boolean);
-	const captured = {};
-	for (let i = 0; i < want.length; i++) {
-		const w = want[i];
-		if (w === "*") return got.length >= i ? captured : null;
-		const g = got[i];
-		if (g === void 0) return null;
-		if (w.startsWith(":")) {
-			if (!SEGMENT.test(g)) return null;
-			captured[w.slice(1)] = g;
-		} else if (w !== g) return null;
-	}
-	return got.length === want.length ? captured : null;
-}
-function classifyHref(href, origin, routes, pairs = []) {
-	const raw = href.trim();
-	if (!raw || raw.startsWith("//")) return { kind: "text" };
-	if (!raw.startsWith("/") && !/^https?:\/\//i.test(raw)) return { kind: "text" };
-	let url;
-	try {
-		url = new URL(raw, origin);
-	} catch {
-		return { kind: "text" };
-	}
-	if (url.origin !== origin) return {
-		kind: "external",
-		href: url.href
-	};
-	for (const r of routes) {
-		const captured = matchesPattern(url.pathname, r.pattern);
-		if (!captured) continue;
-		if (pairs.length && captured["library"] !== void 0 && captured["shelf"] !== void 0) {
-			if (!pairs.some((p) => p.library === captured["library"] && p.shelf === captured["shelf"])) return { kind: "text" };
-		}
-		return {
-			kind: "internal",
-			to: `${url.pathname}${url.search}${url.hash}`
-		};
-	}
-	return { kind: "text" };
-}
-//#endregion
 //#region src/ui/chat-nav.tsx
 /** What to do with the widget when the user follows a link from a response.
 *  ChatWidget supplies the callback (it owns mode/open), avoiding a prop
@@ -23811,8 +23763,7 @@ function ChatTable(props) {
 function ChatLink({ href, children }) {
 	const onNavigate = useChatNav();
 	const navigate = useNavigate();
-	const routes = [...getSiteLinks(), ...getPluginRoutes().map((r) => ({ pattern: `/${r.path}` }))];
-	const kind = classifyHref(href ?? "", window.location.origin, routes, getSiteShelves());
+	const kind = classifySiteHref(href ?? "");
 	if (kind.kind === "internal") return /* @__PURE__ */ jsx("a", {
 		href: kind.to,
 		onClick: (event) => {
@@ -23966,15 +23917,6 @@ function starLadder(rows, multi) {
 	}
 	return byLevel.every((r) => r !== void 0) ? byLevel : null;
 }
-/** The stars as a picture: `filled` of `max` lit. Same palette as the `f.rating` widget
-*  (filled yellow, empty at border colour), so the gesture reads the same in both places. */
-function Stars({ filled, max, size }) {
-	return /* @__PURE__ */ jsx(Fragment, { children: Array.from({ length: max }, (_, i) => /* @__PURE__ */ jsx(Star, {
-		size,
-		"aria-hidden": true,
-		className: i < filled ? "shrink-0 fill-yellow-400 text-yellow-400" : "shrink-0 text-border"
-	}, i)) });
-}
 /** Flatten the catalog to one list: with a single registered agent the agent
 *  level is noise, and with several the agent name simply prefixes its presets. */
 function AgentPicker({ agents, defaultAgentId, selection, onChange }) {
@@ -24001,9 +23943,6 @@ function AgentPicker({ agents, defaultAgentId, selection, onChange }) {
 			document.removeEventListener("keydown", onKeyDown);
 		};
 	}, [open]);
-	useEffect(() => {
-		if (!open) setPreview(null);
-	}, [open]);
 	const multi = agents.length > 1;
 	const rows = agents.flatMap((a) => a.presets.map((p) => ({
 		agentId: a.id,
@@ -24017,73 +23956,58 @@ function AgentPicker({ agents, defaultAgentId, selection, onChange }) {
 	if (rows.length === 0) return null;
 	const current = rows.find((r) => r.agentId === selection.agentId && r.presetId === selection.presetId) ?? rows.find((r) => r.agentId === defaultAgentId && r.isDefault) ?? rows.find((r) => r.isDefault) ?? rows[0];
 	const ladder = starLadder(rows, multi);
-	const level = ladder ? ladder.indexOf(current) + 1 : 0;
-	const shown = ladder ? preview ?? level : 0;
-	const shownRow = ladder ? ladder[shown - 1] : void 0;
-	const levelName = (row, n) => `${row.label} · ${t("webchat.level", {
-		value: n,
-		max: ladder.length
-	})}`;
+	if (ladder) {
+		const level = ladder.indexOf(current) + 1;
+		const shown = preview ?? level;
+		const levelName = (row, n) => `${row.label} · ${t("webchat.level", {
+			value: n,
+			max: ladder.length
+		})}`;
+		return /* @__PURE__ */ jsx("ul", {
+			"aria-label": t("webchat.agentPicker"),
+			className: "flex shrink-0 items-center",
+			onPointerLeave: () => setPreview(null),
+			children: ladder.map((r, i) => {
+				const n = i + 1;
+				return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("button", {
+					type: "button",
+					...r === current ? { "aria-current": true } : {},
+					"aria-label": levelName(r, n),
+					className: "flex rounded p-1 focus-visible:outline-2 focus-visible:outline-accent",
+					onPointerEnter: () => setPreview(n),
+					onFocus: () => setPreview(n),
+					onBlur: () => setPreview(null),
+					onClick: () => onChange({
+						agentId: r.agentId,
+						presetId: r.presetId
+					}),
+					children: /* @__PURE__ */ jsx(Star, {
+						size: 16,
+						"aria-hidden": true,
+						className: n <= shown ? "fill-yellow-400 text-yellow-400" : "text-border"
+					})
+				}) }, `${r.agentId}/${r.presetId}`);
+			})
+		});
+	}
 	return /* @__PURE__ */ jsxs("div", {
 		className: "relative",
 		ref: rootRef,
-		children: [/* @__PURE__ */ jsx("button", {
+		children: [/* @__PURE__ */ jsxs("button", {
 			ref: triggerRef,
 			type: "button",
 			"aria-haspopup": "menu",
 			"aria-expanded": open,
 			className: "flex items-center gap-1 rounded-md px-2 py-1 text-xs text-muted hover:text-text focus-visible:outline-2 focus-visible:outline-accent",
 			onClick: () => setOpen((v) => !v),
-			...ladder ? { "aria-label": levelName(current, level) } : {},
-			children: ladder ? /* @__PURE__ */ jsx("span", {
-				className: "flex items-center gap-0.5",
-				children: /* @__PURE__ */ jsx(Stars, {
-					filled: level,
-					max: ladder.length,
-					size: 14
-				})
-			}) : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
+			children: [/* @__PURE__ */ jsx("span", {
 				className: "max-w-40 truncate",
 				children: current.label
 			}), /* @__PURE__ */ jsx(ChevronDown, {
 				size: 12,
 				className: "shrink-0"
-			})] })
-		}), open && (ladder ? /* @__PURE__ */ jsxs("div", {
-			className: "absolute bottom-full left-0 z-10 mb-1 rounded-md border border-border bg-elevated px-2 py-1.5 shadow-lg",
-			children: [/* @__PURE__ */ jsx("ul", {
-				"aria-label": t("webchat.agentPicker"),
-				className: "flex items-center",
-				onPointerLeave: () => setPreview(null),
-				children: ladder.map((r, i) => {
-					const n = i + 1;
-					return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("button", {
-						type: "button",
-						...r === current ? { "aria-current": true } : {},
-						"aria-label": levelName(r, n),
-						className: "flex p-0.5 focus-visible:outline-2 focus-visible:outline-accent",
-						onPointerEnter: () => setPreview(n),
-						onFocus: () => setPreview(n),
-						onBlur: () => setPreview(null),
-						onClick: () => {
-							setOpen(false);
-							onChange({
-								agentId: r.agentId,
-								presetId: r.presetId
-							});
-						},
-						children: /* @__PURE__ */ jsx(Star, {
-							size: 20,
-							"aria-hidden": true,
-							className: n <= shown ? "fill-yellow-400 text-yellow-400" : "text-border"
-						})
-					}) }, `${r.agentId}/${r.presetId}`);
-				})
-			}), /* @__PURE__ */ jsx("p", {
-				className: "mt-0.5 text-center text-xs text-muted",
-				children: shownRow?.hint || shownRow?.label
 			})]
-		}) : /* @__PURE__ */ jsx("ul", {
+		}), open && /* @__PURE__ */ jsx("ul", {
 			"aria-label": t("webchat.agentPicker"),
 			className: "absolute bottom-full left-0 z-10 mb-1 max-h-64 w-64 max-w-[calc(100vw-2rem)] overflow-y-auto rounded-md border border-border bg-elevated py-1 shadow-lg",
 			children: rows.map((r) => {
@@ -24116,7 +24040,7 @@ function AgentPicker({ agents, defaultAgentId, selection, onChange }) {
 					]
 				}) }, `${r.agentId}/${r.presetId}`);
 			})
-		}))]
+		})]
 	});
 }
 //#endregion
@@ -24363,12 +24287,31 @@ function ChatDropSurface({ children, onFiles, className }) {
 		})]
 	});
 }
-/** What to do with the widget after following a link from a response. On desktop a 380px
-*  panel does not obstruct the page (a darkened modal does, so it collapses into it);
-*  on narrow screens the chat remains expanded so the user does not lose the active
-*  conversation after an in-app navigation. */
-function nextModeAfterNav(wideNav) {
-	return wideNav ? "panel" : "modal";
+/** The states the VIEWPORT offers, ordered from least to most expanded. `panel` — the 380px
+*  floating window — exists only where it does not obstruct the page: on a narrow screen the
+*  widget has exactly two states, the bubble and the full sheet. Every mode transition is a
+*  move along this ladder, so no call site can put the widget into a mode its screen lacks. */
+function chatModes(wide) {
+	return wide ? [
+		"bubble",
+		"panel",
+		"modal"
+	] : ["bubble", "modal"];
+}
+/** Where the widget rests once it is opened — expanded, but as little as the viewport allows.
+*  Also where it returns after following a link from a response: on a wide screen the panel
+*  does not obstruct the page the user just navigated to, while on a narrow one the sheet is
+*  the only visible state, so the active conversation survives the navigation either way. */
+function restingMode(wide) {
+	return chatModes(wide)[1];
+}
+/** One step along the ladder, clamped at both ends: `-1` is what collapse, Esc and a dialog
+*  dismiss do, `+1` is expand. A mode this viewport no longer offers is re-homed by the effect
+*  in the widget, not by stepping — the step always returns a mode from the current ladder. */
+function stepMode(mode, wide, delta) {
+	const ladder = chatModes(wide);
+	const next = ladder.indexOf(mode) + delta;
+	return ladder[Math.min(ladder.length - 1, Math.max(0, next))];
 }
 function ChatWidget() {
 	const { t } = useTranslation();
@@ -24382,20 +24325,22 @@ function ChatWidget() {
 	const [uploadError, setUploadError] = useState(null);
 	const [retryFiles, setRetryFiles] = useState([]);
 	const wide = useMinWidth("sm", 640);
-	const wideNav = useMinWidth("nav", 768);
 	const onChatNavigate = useCallback(() => {
-		setMode(nextModeAfterNav(wideNav));
-	}, [wideNav]);
+		setMode(restingMode(wide));
+	}, [wide]);
 	const expandBtnRef = useRef(null);
 	const prevModeRef = useRef("bubble");
 	useEffect(() => {
 		if (mode !== "modal") return;
 		const onKey = (e) => {
-			if (e.key === "Escape") setMode("panel");
+			if (e.key === "Escape") setMode(stepMode("modal", wide, -1));
 		};
 		window.addEventListener("keydown", onKey);
 		return () => window.removeEventListener("keydown", onKey);
-	}, [mode]);
+	}, [mode, wide]);
+	useEffect(() => {
+		if (!chatModes(wide).includes(mode)) setMode(restingMode(wide));
+	}, [mode, wide]);
 	useEffect(() => {
 		if (mode === "panel" && prevModeRef.current === "modal") expandBtnRef.current?.focus();
 		if (mode !== "modal") setThreadsOpen(false);
@@ -24498,11 +24443,11 @@ function ChatWidget() {
 					onClick: startNew,
 					children: /* @__PURE__ */ jsx(Plus, { size: 16 })
 				}),
-				/* @__PURE__ */ jsx("button", {
+				chatModes(wide).includes("panel") && /* @__PURE__ */ jsx("button", {
 					ref: expandBtnRef,
 					"aria-label": mode === "modal" ? t("webchat.collapse") : t("webchat.expand"),
 					className: "rounded p-1 hover:bg-elevated",
-					onClick: () => setMode(mode === "modal" ? "panel" : "modal"),
+					onClick: () => setMode(stepMode(mode, wide, mode === "modal" ? -1 : 1)),
 					children: mode === "modal" ? /* @__PURE__ */ jsx(Minimize2, { size: 16 }) : /* @__PURE__ */ jsx(Maximize2, { size: 16 })
 				}),
 				/* @__PURE__ */ jsx("button", {
@@ -24558,7 +24503,7 @@ function ChatWidget() {
 	});
 	if (mode === "bubble") return /* @__PURE__ */ jsx("button", {
 		"aria-label": t("webchat.open"),
-		onClick: () => setMode(wide ? "panel" : "modal"),
+		onClick: () => setMode(restingMode(wide)),
 		className: "fixed bottom-20 right-4 z-40 grid h-14 w-14 place-items-center rounded-full bg-accent text-white shadow-lg nav:bottom-4",
 		children: /* @__PURE__ */ jsx(MessageCircle, { size: 24 })
 	});
@@ -24570,7 +24515,7 @@ function ChatWidget() {
 	return /* @__PURE__ */ jsxs(Dialog, {
 		open: true,
 		modal: false,
-		onOpenChange: (open) => !open && setMode("panel"),
+		onOpenChange: (open) => !open && setMode(stepMode("modal", wide, -1)),
 		children: [/* @__PURE__ */ jsx("div", {
 			"data-chat-backdrop": true,
 			"aria-hidden": "true",
@@ -24605,4 +24550,4 @@ function ChatWidget() {
 	});
 }
 //#endregion
-export { ChatWidget, ChatWidget as default, nextModeAfterNav };
+export { ChatWidget, ChatWidget as default, chatModes, restingMode, stepMode };

package/dist/index.js

@@ -12,7 +12,7 @@ export default definePlugin({
                 label: 'webchat.settings.reasoning_display',
                 default: 'live',
                 strict: true,
-                view: { noSearch: true },
+                noSearch: true,
                 options: [
                     { value: 'live', title: 'webchat.settings.reasoning_display_live' },
                     { value: 'off', title: 'webchat.settings.reasoning_display_off' },

package/dist/runtime/format.d.ts

@@ -1 +1,2 @@
 export declare const WEB_FORMAT: string;
+export declare function webChannelSystem(): Promise<string>;

package/dist/runtime/format.js

@@ -1,3 +1,4 @@
+import { frontendInstructions } from '@coffer-org/server/frontend-agent';
 export const WEB_FORMAT = [
     'CRITICAL OUTPUT FORMAT — MARKDOWN ONLY. Format the reply strictly as Markdown (GFM). NEVER emit raw HTML tags — they are stripped before rendering and their content may be lost.',
     'Inline: **bold**, *italic*, `inline code`, ~~strikethrough~~. Links: [text](https://…).',
@@ -8,3 +9,7 @@ export const WEB_FORMAT = [
     'The reply is read in a narrow chat panel (~360px) — keep it short and skimmable: short paragraphs, lists over prose, narrow tables.',
     'Use Unicode symbols and emoji to structure replies: arrows (→), status marks (✅ ⚠️ ❌ ⏳), topic emoji (📅 💰 🏥 🛒 🌱 …).',
 ].join('\n');
+export async function webChannelSystem() {
+    const site = await frontendInstructions('');
+    return [WEB_FORMAT, site].filter(Boolean).join('\n\n');
+}

package/dist/runtime/send.js

@@ -3,7 +3,7 @@ import { handleIncoming, liveAgentId } from '@coffer-org/server/orchestrator';
 import { chatIdFor, recordUser, buildChain, history, readSelectionForTurn } from "./chain-store.js";
 import { policy } from "./config.js";
 import { makeStreamingConnector } from "./connector.js";
-import { WEB_FORMAT } from "./format.js";
+import { webChannelSystem } from "./format.js";
 import { loadReasoningDisplay } from "./settings.js";
 export function pageContext(ctx) {
     if (typeof ctx !== 'object' || ctx === null)
@@ -47,11 +47,11 @@ export async function sendAction(body, ctx, deps = {}) {
         emit: ctx.emit,
         display: await loadReasoningDisplay(),
     });
-    const volatileSystem = pageContext(body['context']);
+    const turnContext = pageContext(body['context']);
     await doHandle(connector, {
         connectorId: 'webchat',
-        channelSystem: WEB_FORMAT,
-        ...(volatileSystem ? { volatileSystem } : {}),
+        channelSystem: await webChannelSystem(),
+        ...(turnContext ? { turnContext } : {}),
         ...(agentId ? { agentId } : {}),
         ...(selection.presetId ? { presetId: selection.presetId } : {}),
         chatId,

package/dist/schema.js

@@ -4082,6 +4082,23 @@ function typeErr(code = "invalid_type") {
 function reqTypeErr() {
 	return { error: (iss) => iss.code === "invalid_type" ? iss.input === void 0 ? vmsg("required") : vmsg("invalid_type") : void 0 };
 }
+/**
+* A string schema whose CONTENT checks only speak once the value is known to be a string.
+*
+* zod's length checks are not type-guarded: `min`/`max` read `input.length`, and an ARRAY has
+* one. So `z.string().min(1)` answers `[]` with `invalid_type` AND `too_small` — two messages
+* about a single wrongness, both of which reach the user, since `mutate.ts` and `extend-io.ts`
+* turn every issue into its own `ValidationError`. (A number answers with `invalid_type`
+* alone, having no `length` to read — so the redundancy was array-shaped and invisible until
+* the golden matrix started recording the whole issue list instead of `issues[0]`.)
+*
+* Piping puts the type question first and alone: `add` never runs on a non-string. Pass the
+* content checks as a builder rather than chaining them onto the result, because a `ZodPipe`
+* has no `.min`/`.max`/`.regex` to chain.
+*/
+function stringContent(add) {
+	return string$1(reqTypeErr()).pipe(add(string$1()));
+}
 /** Parse a JSON string, else return the native value (object/array) as-is.
 *  Tolerant input for native form-state AND legacy JSON-string payloads.
 *  A string that fails JSON.parse is returned unchanged — callers detect
@@ -4337,6 +4354,13 @@ function wrapKey(key, opts, meta) {
 			editor: opts.editor
 		}
 	};
+	if (opts.activate) m = {
+		...m,
+		hints: {
+			...m.hints,
+			activate: opts.activate
+		}
+	};
 	if (opts.span !== void 0) m = {
 		...m,
 		hints: {
@@ -4709,18 +4733,37 @@ var UNITS_MAP = {
 		label: "core.units.ppm"
 	}]
 };
+/**
+* Resolve a unit spec — a named scale or an explicit option list — to its options.
+*
+* Throws rather than returning `undefined`, because both ways of reaching `undefined` here
+* produce a field that CONSTRUCTS and then crashes when someone tries to save through it:
+* `measured`'s unit role closes over these options and calls `.some(…)` on them inside its
+* refine, so a missing spec or a typo'd scale name turns a user's save into a
+* `Cannot read properties of undefined` instead of a validation message. The golden matrix
+* recorded exactly that for `f.measured({})`.
+*
+* A declaration error belongs at declaration time, where the plugin author sees it and the
+* message can name the scale they meant — the same reason the host-services seam fails at
+* registration rather than at first render.
+*/
 function resolveUnits(u) {
-	return typeof u === "string" ? UNITS_MAP[u] : u;
+	if (typeof u === "string") {
+		const known = UNITS_MAP[u];
+		if (!known) throw new Error(`units: unknown scale '${u}' (known: ${Object.keys(UNITS_MAP).sort().join(", ")})`);
+		return known;
+	}
+	if (!Array.isArray(u)) throw new Error("units: a unit spec is required — a named scale, or an explicit list of options");
+	return u;
 }
 //#endregion
 //#region ../sdk/src/fields/normalize.ts
 function normalizeOpts(rawIn) {
 	const raw = rawIn;
+	if (raw["view"] !== void 0) throw new Error("[normalizeOpts] `view` is gone — presentational options live in `ui: {}` (see CLAUDE.md § field author options and the field-types skill).");
+	if (raw.ui?.["agent"] !== void 0) throw new Error("[normalizeOpts] `agent` is not presentation — declare it at the top level of the field call, not in `ui: {}`.");
 	const r = raw.rules ?? {};
-	const v = {
-		...raw.view ?? {},
-		...raw.ui ?? {}
-	};
+	const v = raw.ui ?? {};
 	const config = {};
 	if (r.min != null && typeof r.min === "number") config.min = r.min;
 	if (r.max != null && typeof r.max === "number") config.max = r.max;
@@ -4729,7 +4772,7 @@ function normalizeOpts(rawIn) {
 	if (r.messageKey != null) config.messageKey = r.messageKey;
 	if (r.granularity != null) config.granularity = r.granularity;
 	if (r.language != null) config.language = r.language;
-	const { rules: _r, view: _v, ui: _ui, ...flat } = raw;
+	const { rules: _r, ui: _ui, ...flat } = raw;
 	const result = {
 		...flat,
 		...Object.keys(config).length ? { config } : {},
@@ -4744,7 +4787,6 @@ function normalizeOpts(rawIn) {
 		step: r.step,
 		hidden: v.hidden,
 		noEditControl: v.noEditControl,
-		noSearch: v.noSearch,
 		display: v.display,
 		kind: v.kind,
 		icon: v.icon,
@@ -4752,7 +4794,12 @@ function normalizeOpts(rawIn) {
 		...v.keyLabel !== void 0 ? { keyLabel: v.keyLabel } : {},
 		...v.valueLabel !== void 0 ? { valueLabel: v.valueLabel } : {},
 		compareWith: v.compareWith,
-		span: v.span
+		span: v.span,
+		emphasis: v.emphasis,
+		noLabel: v.noLabel,
+		role: v.role,
+		editor: v.editor,
+		activate: v.activate
 	};
 	return Object.fromEntries(Object.entries(result).filter(([, val]) => val !== void 0));
 }
@@ -5002,7 +5049,7 @@ function internalApiToken(o) {
 		label: o.label,
 		multiple: true,
 		rules: { unique: ["name"] },
-		view: { kind: "internalApiToken" },
+		ui: { kind: "internalApiToken" },
 		fields: {
 			name: string({}),
 			token: password({}),
@@ -5028,7 +5075,7 @@ function internalOauthGrants(o) {
 		scope: "nest",
 		label: o.label,
 		multiple: true,
-		view: { kind: "internalOauthGrants" },
+		ui: { kind: "internalOauthGrants" },
 		fields: {
 			clientName: string({}),
 			createdAt: string({}),
@@ -5655,10 +5702,8 @@ function country(raw) {
 		...raw,
 		options: "countries",
 		strict: true,
-		view: {
-			...raw.view ?? {},
-			noSearch: true
-		}
+		ui: { ...raw.ui ?? {} },
+		noSearch: true
 	});
 }
 /**
@@ -5682,10 +5727,8 @@ function currency(raw) {
 		...raw,
 		options: "currencies",
 		strict: true,
-		view: {
-			...raw.view ?? {},
-			noSearch: true
-		}
+		ui: { ...raw.ui ?? {} },
+		noSearch: true
 	});
 }
 /**
@@ -5845,7 +5888,7 @@ function bento(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields,
-			view: { kind: "bento" }
+			ui: { kind: "bento" }
 		}),
 		view: {
 			kind: "bento",
@@ -5874,7 +5917,7 @@ function split(opts) {
 	return {
 		...group({
 			fields: merge("split", opts.columns[0], opts.columns[1]),
-			view: { kind: "split" }
+			ui: { kind: "split" }
 		}),
 		view: {
 			kind: "split",
@@ -5898,7 +5941,7 @@ function grid(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "grid" }
+			ui: { kind: "grid" }
 		}),
 		view: {
 			kind: "grid",
@@ -5923,7 +5966,7 @@ function spread(opts) {
 	return {
 		...group({
 			fields: merge("spread", visual, quote, opts.facts),
-			view: { kind: "spread" }
+			ui: { kind: "spread" }
 		}),
 		view: {
 			kind: "spread",
@@ -5948,7 +5991,7 @@ function aside(opts) {
 	return {
 		...group({
 			fields: merge("aside", opts.fields, opts.aside),
-			view: { kind: "aside" }
+			ui: { kind: "aside" }
 		}),
 		view: {
 			kind: "aside",
@@ -5980,7 +6023,7 @@ function tabs(opts) {
 	return {
 		...group({
 			fields,
-			view: { kind: "tabs" }
+			ui: { kind: "tabs" }
 		}),
 		view: {
 			kind: "tabs",
@@ -6012,7 +6055,7 @@ function accordion(opts) {
 	return {
 		...group({
 			fields,
-			view: { kind: "accordion" }
+			ui: { kind: "accordion" }
 		}),
 		view: {
 			kind: "accordion",
@@ -6042,7 +6085,7 @@ function prose(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "prose" }
+			ui: { kind: "prose" }
 		}),
 		view: {
 			kind: "prose",
@@ -6068,7 +6111,7 @@ function plaque(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: merge("plaque", title, opts.subtitle),
-			view: { kind: "plaque" }
+			ui: { kind: "plaque" }
 		}),
 		view: {
 			kind: "plaque",
@@ -6091,7 +6134,7 @@ function ledger(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "ledger" }
+			ui: { kind: "ledger" }
 		}),
 		view: { kind: "ledger" }
 	};
@@ -6110,7 +6153,7 @@ function stats(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "stats" }
+			ui: { kind: "stats" }
 		}),
 		view: { kind: "stats" }
 	};
@@ -6129,7 +6172,7 @@ function facets(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "facets" }
+			ui: { kind: "facets" }
 		}),
 		view: { kind: "facets" }
 	};
@@ -6148,7 +6191,7 @@ function terminal(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "terminal" }
+			ui: { kind: "terminal" }
 		}),
 		view: {
 			kind: "terminal",
@@ -6170,7 +6213,7 @@ function callout(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "callout" }
+			ui: { kind: "callout" }
 		}),
 		view: {
 			kind: "callout",
@@ -6195,7 +6238,7 @@ function compare(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: merge("compare", opts.left, opts.right),
-			view: { kind: "compare" }
+			ui: { kind: "compare" }
 		}),
 		view: {
 			kind: "compare",
@@ -6226,7 +6269,7 @@ function figure(opts) {
 	return {
 		...group({
 			fields: merge("figure", image, caption),
-			view: { kind: "figure" }
+			ui: { kind: "figure" }
 		}),
 		view: {
 			kind: "figure",
@@ -6251,7 +6294,7 @@ function epigraph(opts) {
 	return {
 		...group({
 			fields: merge("epigraph", source, attribution),
-			view: { kind: "epigraph" }
+			ui: { kind: "epigraph" }
 		}),
 		view: {
 			kind: "epigraph",
@@ -6277,7 +6320,7 @@ function masthead(opts) {
 	return {
 		...group({
 			fields: merge("masthead", overline, title, opts.meta),
-			view: { kind: "masthead" }
+			ui: { kind: "masthead" }
 		}),
 		view: {
 			kind: "masthead",
@@ -6301,7 +6344,7 @@ function timeline(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "timeline" }
+			ui: { kind: "timeline" }
 		}),
 		view: { kind: "timeline" }
 	};
@@ -6320,7 +6363,7 @@ function countdown(opts) {
 		...group({
 			label: opts.label,
 			fields: source,
-			view: { kind: "countdown" }
+			ui: { kind: "countdown" }
 		}),
 		view: {
 			kind: "countdown",
@@ -6343,7 +6386,7 @@ function deck(opts) {
 		...group({
 			label: opts.label,
 			fields: source,
-			view: { kind: "deck" }
+			ui: { kind: "deck" }
 		}),
 		view: {
 			kind: "deck",
@@ -6365,7 +6408,7 @@ function people(opts) {
 		...group({
 			label: opts.label,
 			fields: source,
-			view: { kind: "people" }
+			ui: { kind: "people" }
 		}),
 		view: {
 			kind: "people",
@@ -6391,7 +6434,7 @@ function identity(opts) {
 	return {
 		...group({
 			fields: merge("identity", avatar, name, role, opts.channels),
-			view: { kind: "identity" }
+			ui: { kind: "identity" }
 		}),
 		view: {
 			kind: "identity",
@@ -6417,7 +6460,7 @@ function score(opts) {
 		...group({
 			label: opts.label,
 			fields: merge("score", source, verdict),
-			view: { kind: "score" }
+			ui: { kind: "score" }
 		}),
 		view: {
 			kind: "score",
@@ -6442,7 +6485,7 @@ function status(opts) {
 		...group({
 			label: opts.label,
 			fields: merge("status", source, since),
-			view: { kind: "status" }
+			ui: { kind: "status" }
 		}),
 		view: {
 			kind: "status",
@@ -6466,7 +6509,7 @@ function meter(opts) {
 		...group({
 			label: opts.label,
 			fields: merge("meter", source, of),
-			view: { kind: "meter" }
+			ui: { kind: "meter" }
 		}),
 		view: {
 			kind: "meter",
@@ -6493,7 +6536,7 @@ function receipt(opts) {
 		...group({
 			label: opts.label,
 			fields: merge("receipt", opts.fields, total),
-			view: { kind: "receipt" }
+			ui: { kind: "receipt" }
 		}),
 		view: {
 			kind: "receipt",
@@ -6516,7 +6559,7 @@ function balance(opts) {
 		...group({
 			label: opts.label,
 			fields: source,
-			view: { kind: "balance" }
+			ui: { kind: "balance" }
 		}),
 		view: {
 			kind: "balance",
@@ -6544,7 +6587,7 @@ function route(opts) {
 	return {
 		...group({
 			fields: merge("route", from, to, depart, arrive, duration),
-			view: { kind: "route" }
+			ui: { kind: "route" }
 		}),
 		view: {
 			kind: "route",
@@ -6693,7 +6736,7 @@ function nutrition(opts) {
 		...group({
 			label: opts.label,
 			fields: merge("nutrition", energy, opts.fields),
-			view: { kind: "nutrition" }
+			ui: { kind: "nutrition" }
 		}),
 		view: {
 			kind: "nutrition",
@@ -6719,7 +6762,7 @@ function specimen(opts) {
 	return {
 		...group({
 			fields: merge("specimen", title, subtitle, opts.conditions),
-			view: { kind: "specimen" }
+			ui: { kind: "specimen" }
 		}),
 		view: {
 			kind: "specimen",
@@ -6796,7 +6839,7 @@ function idcard(opts) {
 	return {
 		...group({
 			fields: merge("idcard", overline, number, opts.meta),
-			view: { kind: "idcard" }
+			ui: { kind: "idcard" }
 		}),
 		view: {
 			kind: "idcard",
@@ -6822,7 +6865,7 @@ function properties(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "properties" }
+			ui: { kind: "properties" }
 		}),
 		view: {
 			kind: "properties",
@@ -6844,7 +6887,7 @@ function stack(opts) {
 			label: opts.label,
 			icon: opts.icon,
 			fields: opts.fields,
-			view: { kind: "stack" }
+			ui: { kind: "stack" }
 		}),
 		view: { kind: "stack" }
 	};
@@ -7725,8 +7768,9 @@ var hasChildren = (x) => Array.isArray(x.fields);
 * @example f.group({ scope: 'nest', label: 'mod.fields.contact', fields: { name: f.string({}) } })
 */
 function group(o) {
+	if (o["view"] !== void 0) throw new Error("[group] `view` is gone — presentational options live in `ui: {}` (see CLAUDE.md § field author options and the field-types skill).");
 	const r = o.rules ?? {};
-	const v = o.view ?? {};
+	const v = o.ui ?? {};
 	const fields = materializeTree(o.fields);
 	const scope = o.scope ?? "hoist";
 	if (scope === "nest") {
@@ -7772,7 +7816,7 @@ function row(o) {
 		multiple: o.multiple,
 		required: o.required,
 		rules: o.rules,
-		view: { display: "scroll" }
+		ui: { display: "scroll" }
 	});
 }
 /**
@@ -7800,7 +7844,7 @@ function sheet(o) {
 		label: o.label,
 		icon: o.icon,
 		fields: rows,
-		view: { display: "sheet" }
+		ui: { display: "sheet" }
 	});
 }
 /**
@@ -7819,7 +7863,7 @@ function url(o) {
 		scope: "nest",
 		label: o.label,
 		required: o.required,
-		view: { kind: "url" },
+		ui: { kind: "url" },
 		fields: {
 			scheme: string({}),
 			username: string({}),
@@ -7961,13 +8005,15 @@ registerType("string", {
 	build(o) {
 		const cfg = o.config ?? {};
 		const min = cfg.min ?? (o.required === true ? 1 : 0);
-		let s = string$1(reqTypeErr());
-		if (min > 0) s = s.min(min, { message: vmsg("min_length", { min }) });
-		if (cfg.max != null) s = s.max(cfg.max, { message: vmsg("max_length", { max: cfg.max }) });
-		if (cfg.pattern) s = s.regex(new RegExp(cfg.pattern), { message: vmsg("pattern", cfg.messageKey ? { messageKey: cfg.messageKey } : void 0) });
 		return {
 			column: "text",
-			zod: s,
+			zod: stringContent((str) => {
+				let c = str;
+				if (min > 0) c = c.min(min, { message: vmsg("min_length", { min }) });
+				if (cfg.max != null) c = c.max(cfg.max, { message: vmsg("max_length", { max: cfg.max }) });
+				if (cfg.pattern) c = c.regex(new RegExp(cfg.pattern), { message: vmsg("pattern", cfg.messageKey ? { messageKey: cfg.messageKey } : void 0) });
+				return c;
+			}),
 			hints: {
 				minLength: cfg.min,
 				maxLength: cfg.max
@@ -7988,9 +8034,7 @@ function string(o) {
 }
 /** Shared by localDir/localFile's build(): a server path, min-length-1 when required. */
 function pathZod(o) {
-	let s = string$1(reqTypeErr());
-	if (o.required === true) s = s.min(1, { message: vmsg("min_length", { min: 1 }) });
-	return s;
+	return stringContent((s) => o.required === true ? s.min(1, { message: vmsg("min_length", { min: 1 }) }) : s);
 }
 registerType("localDir", {
 	kind: "localDir",
@@ -8652,7 +8696,8 @@ var MEASURED_ROLES = (opts) => {
 				label,
 				required,
 				value,
-				view: viewOf(d?.opts),
+				noSearch: d?.opts.noSearch,
+				ui: uiOf(d?.opts),
 				options: opts.units,
 				strict: true
 			});
@@ -9021,7 +9066,7 @@ function periodMkSubDecl(granularity) {
 * (`mkSubDecl`), so it writes its own `normalize` rather than using `role()`. A CORRECTED
 * filling still keeps the composite's own granularity (`canonical.opts`) — the same
 * `date`/`datetime` config the role's own default carries — with the author's
-* label/required/view/value layered on top, exactly like `retypeTo`'s default.
+* label/required/ui/value layered on top, exactly like `retypeTo`'s default.
 */
 function periodRole(key, label, mkSubDecl) {
 	const def = {
@@ -9037,7 +9082,8 @@ function periodRole(key, label, mkSubDecl) {
 				label: l ?? canonical.opts.label,
 				required,
 				value,
-				view: viewOf(d.opts)
+				noSearch: d.opts.noSearch,
+				ui: uiOf(d.opts)
 			});
 		}
 	};
@@ -9505,10 +9551,11 @@ var field = new Proxy({}, {
 	has: (_t, k) => k in composedField()
 });
 function toClient(field) {
-	const { kind, label, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
+	const { kind, label, agent, required, prim, hints, options, strict, relation, json, hidden, derived, parts, cache } = field;
 	return {
 		kind,
 		label,
+		...agent !== void 0 && { agent },
 		required,
 		prim,
 		hints,
@@ -9542,15 +9589,14 @@ function toClient(field) {
 * open: a magnitude may be real/int/rating, a unit may be a select or a relation.
 */
 /**
-* `NormalizedOpts` (what `FieldDecl.opts` actually is) has no single `view` property — the
-* author's `view`/`ui` are flattened into individual fields (`hidden`, `display`, `kind`, …)
-* by `normalizeOpts`. A correction that wants to carry "view" forward has to collect those
-* flat fields back into the nested shape `declare()`'s own `normalizeOpts` call expects.
+* `NormalizedOpts` (what `FieldDecl.opts` actually is) has no single `ui` property — the
+* author's `ui` is flattened into individual fields (`hidden`, `display`, `kind`, …)
+* by `normalizeOpts`. A correction that wants to carry presentation forward has to collect
+* those flat fields back into the nested shape `declare()`'s own `normalizeOpts` call expects.
 */
-var VIEW_KEYS = [
+var UI_KEYS = [
 	"hidden",
 	"noEditControl",
-	"noSearch",
 	"display",
 	"kind",
 	"icon",
@@ -9561,11 +9607,11 @@ var VIEW_KEYS = [
 	"span"
 ];
 /** The author's presentation opts, re-nested from `opts`'s flat fields — `undefined` when
-*  none were set, so a correction never adds an empty `view: {}` no filling ever had. */
-function viewOf(opts) {
+*  none were set, so a correction never adds an empty `ui: {}` no filling ever had. */
+function uiOf(opts) {
 	if (!opts) return void 0;
 	const v = {};
-	for (const k of VIEW_KEYS) if (opts[k] !== void 0) v[k] = opts[k];
+	for (const k of UI_KEYS) if (opts[k] !== void 0) v[k] = opts[k];
 	return Object.keys(v).length ? v : void 0;
 }
 /** A filling built from a ported factory arrives as a FieldDecl — build it into the
@@ -9588,7 +9634,7 @@ function accepts(def, d) {
 }
 /**
 * The correction every role gets for free: keep what the author said ABOUT the field
-* (`label`, `required`, `view`, `value` — a constant or a ComputeFn), replace the type, and
+* (`label`, `required`, `ui`, `value` — a constant or a ComputeFn), replace the type, and
 * drop what belonged to the OLD type (`rules` — a number's min/max mean nothing to a
 * picture — and `multiple`, because a composite role owns exactly one column). A role whose
 * own default needs more than a bare factory (`measured`'s unit, `period`'s endpoints)
@@ -9601,7 +9647,8 @@ function retypeTo(factory) {
 			label,
 			required,
 			value,
-			view: viewOf(d?.opts)
+			noSearch: d?.opts.noSearch,
+			ui: uiOf(d?.opts)
 		});
 	};
 }
@@ -9784,56 +9831,13 @@ function partColumns(parts) {
 	}
 	return cols;
 }
-/**
-* A composite's write-time row shape, DERIVED from its resolved parts. `shape` carries
-* the composite's DEFAULT schema per role — the literal the factory writes by hand
-* (`{ value: numSchema, unit: z.string().refine(…) }`) — and each part decides which
-* schema guards its (role-named) key:
-*
-*  - a plain STORED part is keyed by its role name, matching the value object and the
-*    column `<field>__<role>` that `flattenEmbeddedAt`/`nestEmbeddedAt` read. A role left
-*    to its default filling keeps the default schema — byte-identical to the hand-written
-*    literal, so every existing structure/unit/range code and message is preserved.
-*  - an OVERRIDDEN stored part is validated by its OWN zod (`meta.zod`) instead of the
-*    default schema for that role. This is what makes a RETYPED filling real: an
-*    `f.int({})` magnitude rejects 5.5 (its own `int` check) and gets an integer column,
-*    and an `f.relation({…})` currency accepts a record id instead of being measured
-*    against an ISO-4217 string rule it was never meant to satisfy. The filling also
-*    brings its own optionality and its own min/max — an author replacing a filling
-*    takes over that role's constraints, so `f.real({ rules: { min: 0 } })` is how a
-*    replaced magnitude keeps a bound.
-*  - a COMPUTED-AND-STORED part ('computedStored') is keyed by its role name like any
-*    other part, but its schema is `z.unknown().optional()`: the SERVER owns the value, so
-*    whatever the client sends there is ignored — `stripServerOwnedParts` deletes it a
-*    moment later and the write path recomputes the column. It is stripped rather than
-*    `z.never()`-rejected because a read hands the client that key (it is a real column,
-*    present in every response), so rejecting it would break a read → PATCH-the-whole-object
-*    round trip.
-*  - a CLIENT-OWNED stored part of a composite that is not `required: true` also accepts
-*    an explicit `null` (`tolerateNull`), which is what closes the read → write round trip
-*    for a PARTIALLY FILLED composite. A SELECT returns every sub-column, so a record whose
-*    magnitude column is set and whose unit column is empty reads back as
-*    `{value: 900, unit: null}` (`nestEmbeddedAt` drops the key only when EVERY column is
-*    empty — `0` is a value), and feeding that exact object back used to fail with
-*    `measured_structure`: the write path refused the shape its own read produced. The null
-*    slot now parses through and is written back as NULL, so the round trip is closed and
-*    clearing ONE role of a filled composite works instead of erroring.
-*    NULL, not absence: a read emits every stored role (empty ones as `null`), so `null` is
-*    how "this record has no value there" arrives, while an ABSENT key is a writer that
-*    never mentioned a role it owns — which stays the structure error it has always been
-*    (`{unit: 'kg'}` with no magnitude, `{lat: 50}` with no longitude). That is the
-*    all-or-nothing rule for a DECLARATION, and it is untouched.
-*    A `required: true` composite keeps every client-owned slot MANDATORY, null included —
-*    "tolerate null" must not turn a required field optional, so an empty or half-empty
-*    value still fails with the same structure code it fails with today. A filling the
-*    author declared `required` keeps its own mandate too.
-*/
-function partsRowShape(shape, parts, tolerateNull = false) {
+function partsRowShape(shape, parts, tolerance = "strict") {
 	const out = { ...shape };
 	for (const p of parts) if (p.mode === "computedStored") out[p.key] = unknown().optional();
 	else {
 		const own = p.overridden ? p.meta.zod : shape[p.role] ?? unknown().optional();
-		out[p.key] = tolerateNull && !(p.overridden && p.meta.required === true) ? own.nullable() : own;
+		const relaxed = tolerance !== "strict" && !(p.overridden && p.meta.required === true);
+		out[p.key] = relaxed ? tolerance === "null-or-missing" ? own.nullish() : own.nullable() : own;
 	}
 	return out;
 }
@@ -9874,16 +9878,17 @@ function stripServerOwnedParts(value, parts) {
 function buildComposite(def, opts, parts) {
 	const required = opts.required ?? false;
 	const roleZod = def.roleZod(opts, parts);
-	const rowSchema = object(partsRowShape(roleZod, parts, required !== true));
-	const absentRowSchema = required === true ? object(partsRowShape(roleZod, parts, true)) : rowSchema;
+	const rowSchema = object(partsRowShape(roleZod, parts, required === true ? "strict" : "null"));
+	const absentRowSchema = required === true ? object(partsRowShape(roleZod, parts, "null-or-missing")) : rowSchema;
 	const roleKeys = (which) => parts.filter((p) => p.mode === "stored" && (which?.(p) ?? true)).map(partValueKey);
 	const absenceKeys = def.absenceRoles ? roleKeys((p) => def.absenceRoles.includes(p.role)) : void 0;
 	const clientKeys = def.absenceRoles ? roleKeys() : void 0;
 	const zod = unknown().transform((raw, ctx) => {
 		const parsed = jsonValue(raw);
 		const p = parsed;
+		const isRow = p == null || typeof p === "object" && !Array.isArray(p);
 		/** Every one of `keys` empty in this value — `null`/absent alike. */
-		const allEmpty = (keys) => p == null || typeof p === "object" && keys.length > 0 && keys.every((k) => p[k] == null);
+		const allEmpty = (keys) => isRow && (p == null || keys.length > 0 && keys.every((k) => p[k] == null));
 		let absent = false;
 		if (absenceKeys && clientKeys) {
 			absent = allEmpty(absenceKeys);
@@ -9957,6 +9962,7 @@ function materialize(decl, name) {
 	const base = {
 		kind: type.kind,
 		label: opts.label ?? "",
+		...opts.agent !== void 0 && { agent: opts.agent },
 		required,
 		prim: type.prim,
 		column: built.column,
@@ -10000,6 +10006,7 @@ function collectionGroup(key, opts, parts, collectionView) {
 		multiple: true,
 		required: opts.required ?? false,
 		label: opts.label ?? key,
+		...opts.agent !== void 0 && { agent: opts.agent },
 		display: "wrap",
 		kind: collectionView,
 		fields: rowFields
@@ -10132,7 +10139,7 @@ var src_default = definePlugin({
 			label: "webchat.settings.reasoning_display",
 			default: "live",
 			strict: true,
-			view: { noSearch: true },
+			noSearch: true,
 			options: [{
 				value: "live",
 				title: "webchat.settings.reasoning_display_live"

package/dist/web.js

@@ -11,7 +11,7 @@ import { definePluginUI } from "@coffer-org/web-ui";
 var ui_default = definePluginUI({ slots: [{
 	slot: "overlay",
 	id: "webchat",
-	load: () => import("./ChatWidget-Bs8zrQVZ.js")
+	load: () => import("./ChatWidget-DFVDexpD.js")
 }] });
 //#endregion
 export { ui_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-webchat",
-  "version": "4.0.0",
+  "version": "6.0.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -27,8 +27,8 @@
     "test:ui": "vitest run --root ."
   },
   "dependencies": {
-    "@coffer-org/sdk": "^4.0.0",
-    "@coffer-org/server": "^4.0.0",
+    "@coffer-org/sdk": "^6.0.0",
+    "@coffer-org/server": "^6.0.0",
     "lucide-react": "^1.17.0",
     "react-markdown": "^10.1.0",
     "remark-gfm": "^4.0.1"