@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/web-theme.d.ts

@@ -0,0 +1,121 @@
+/**
+ * #1629 (first design §1, §8; r2 §8): an agent's web theme — a small, closed, typed object. One module validates and
+ * canonicalises it; the store keeps only what this returns, and the page applies only canonical values (colours as
+ * "#rrggbb", choices as fixed tokens, numbers in range). Nothing here is CSS text.
+ *
+ * The theme is the look only. Where an agent's effects and widgets are placed is the store's (web-theme-store.ts
+ * placements): `set_web_theme` never places anything.
+ */
+import { type IdentityColor, type Placement } from "./web-identity-palette.js";
+export type Color = string;
+export type AssetId = string;
+export interface Palette {
+    bg?: Color;
+    surface?: Color;
+    text?: Color;
+    text2?: Color;
+    accent?: Color;
+    userBubble?: Color;
+    agentBubble?: Color;
+}
+export type ThemeMode = "light" | "dark";
+export interface Theme {
+    v: 1;
+    colors?: {
+        light?: Palette;
+        dark?: Palette;
+    };
+    accent?: Color;
+    bubble?: {
+        radius?: number;
+        border?: "none" | "thin" | "accent";
+    };
+    font?: "inter" | "system" | "mono";
+    background?: {
+        image: AssetId;
+        fit: "cover" | "contain";
+        opacity: number;
+    };
+    avatar?: AssetId;
+    workingLabel?: string;
+    /** r4 §1: the agent's identity card. A person's card fields (View's Edit profile) win field by field. */
+    card?: ThemeCard;
+    /**
+     * #1958: the agent's identity colour (a preset or #rrggbb; without it, its accent) and where it shows. A person's
+     * choice for this instance wins, field by field.
+     */
+    identity?: ThemeIdentity;
+}
+export interface ThemeIdentity {
+    color?: IdentityColor;
+    show?: Placement[];
+}
+export interface ThemeCard {
+    portrait?: AssetId;
+    banner?: AssetId;
+    tagline?: string;
+    bio?: string;
+}
+export interface ThemeProblem {
+    path: string;
+    problem: string;
+}
+export declare const THEME_MAX_BYTES = 4096;
+export declare const PALETTE_KEYS: readonly ["bg", "surface", "text", "text2", "accent", "userBubble", "agentBubble"];
+/**
+ * The token defaults (src/ui/shared/tokens.css) the contrast check measures a theme against — a test pins these equal
+ * to the stylesheet. An agent message has no bubble of its own: its "bubble" is the page background.
+ */
+export declare const THEME_DEFAULTS: Record<ThemeMode, Required<Palette>>;
+/** WCAG AA: [foreground, background, minimum ratio]. */
+export declare const CONTRAST_PAIRS: ReadonlyArray<readonly [keyof Palette, keyof Palette, number]>;
+/** "#rgb" | "#rrggbb", any case → "#rrggbb" lowercase; anything else (names, alpha, functions, text after it) → null. */
+export declare function canonicalColor(v: unknown): Color | null;
+/** A card's bio (r4 §1): NFC, 1..280 graphemes, at most 3 line breaks ("\n" only), otherwise as one line. */
+export declare const BIO_MAX_GRAPHEMES = 280;
+export declare const BIO_MAX_BREAKS = 3;
+export declare const TAGLINE_MAX_GRAPHEMES = 60;
+/**
+ * #1889 review: one explicit bound in UTF-16 units too, for the host and the page alike — a grapheme may be many units
+ * (an emoji family is 8), so 10 per grapheme keeps every ordinary text and still bounds what is stored.
+ */
+export declare const TAGLINE_MAX_UNITS: number;
+export declare const BIO_MAX_UNITS = 2800;
+/** A card's tagline: one line of 1..60 graphemes, at most TAGLINE_MAX_UNITS units. */
+export declare function canonicalTagline(v: unknown): string | null;
+export declare function canonicalBio(v: unknown): string | null;
+/** One line of text: NFC, `min..max` graphemes, nothing invisible or directional. */
+export declare function canonicalText(v: unknown, min: number, max: number): string | null;
+export declare function contrastRatio(a: Color, b: Color): number;
+/** The palette a mode renders with: the theme's colours over the defaults (a mode's accent, else the theme's). */
+export declare function effectivePalette(theme: Theme, mode: ThemeMode): Required<Palette>;
+export interface ThemeContext {
+    /** The asset ids this instance has (background and avatar must name one). */
+    assets: ReadonlySet<string>;
+    /** r4 §1: each asset's slot — a card's portrait and banner must name a picture uploaded for that slot. */
+    slotOf?: (id: string) => string | undefined;
+}
+/**
+ * The whole theme, checked and canonicalised: closed schema at every level, types never coerced, integers and steps,
+ * colours re-serialised, text NFC and counted in graphemes, asset ids this instance has, contrast per mode, ≤ 4 KiB.
+ */
+export declare function checkTheme(input: unknown, ctx: ThemeContext): {
+    ok: true;
+    theme: Theme;
+} | {
+    ok: false;
+    errors: ThemeProblem[];
+};
+/** One key order, so the stored, served and tool-returned JSON are the same bytes for the same theme. */
+export declare function canonicalTheme(t: Theme): Theme;
+/**
+ * set_web_theme's patch on the current theme: `set` merges (objects by key, values replace), then `clear` removes
+ * dotted paths ("colors.dark.bg", "bubble", …). The result is checked whole: all or nothing.
+ */
+export declare function applyThemePatch(current: Theme, patch: unknown, ctx: ThemeContext): {
+    ok: true;
+    theme: Theme;
+} | {
+    ok: false;
+    errors: ThemeProblem[];
+};

package/dist/web-theme.js

@@ -0,0 +1,407 @@
+/**
+ * #1629 (first design §1, §8; r2 §8): an agent's web theme — a small, closed, typed object. One module validates and
+ * canonicalises it; the store keeps only what this returns, and the page applies only canonical values (colours as
+ * "#rrggbb", choices as fixed tokens, numbers in range). Nothing here is CSS text.
+ *
+ * The theme is the look only. Where an agent's effects and widgets are placed is the store's (web-theme-store.ts
+ * placements): `set_web_theme` never places anything.
+ */
+import { canonicalIdentityColor, canonicalPlacements } from "./web-identity-palette.js";
+export const THEME_MAX_BYTES = 4096;
+export const PALETTE_KEYS = ["bg", "surface", "text", "text2", "accent", "userBubble", "agentBubble"];
+const MODES = ["light", "dark"];
+const BORDERS = ["none", "thin", "accent"];
+const FONTS = ["inter", "system", "mono"];
+const FITS = ["cover", "contain"];
+const ASSET_ID = /^[0-9a-f]{32}$/;
+/**
+ * The token defaults (src/ui/shared/tokens.css) the contrast check measures a theme against — a test pins these equal
+ * to the stylesheet. An agent message has no bubble of its own: its "bubble" is the page background.
+ */
+export const THEME_DEFAULTS = {
+    dark: { bg: "#212121", surface: "#2f2f2f", text: "#ececec", text2: "#b4b4b4", accent: "#7ab7ff", userBubble: "#2f2f2f", agentBubble: "#212121" },
+    light: { bg: "#ffffff", surface: "#f4f4f4", text: "#0d0d0d", text2: "#5d5d5d", accent: "#0a62c2", userBubble: "#f4f4f4", agentBubble: "#ffffff" },
+};
+/** WCAG AA: [foreground, background, minimum ratio]. */
+export const CONTRAST_PAIRS = [
+    ["text", "bg", 4.5], ["text", "surface", 4.5], ["text", "agentBubble", 4.5], ["text", "userBubble", 4.5],
+    ["text2", "bg", 4.5], ["text2", "surface", 4.5],
+    ["accent", "bg", 3],
+];
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v) && Object.getPrototypeOf(v) === Object.prototype;
+/** "#rgb" | "#rrggbb", any case → "#rrggbb" lowercase; anything else (names, alpha, functions, text after it) → null. */
+export function canonicalColor(v) {
+    if (typeof v !== "string")
+        return null;
+    const m = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.exec(v);
+    if (!m)
+        return null;
+    const h = m[1].toLowerCase();
+    return h.length === 3 ? `#${h[0]}${h[0]}${h[1]}${h[1]}${h[2]}${h[2]}` : `#${h}`;
+}
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+/**
+ * Control, format (incl. bidi overrides, zero-width space), line/paragraph separators: never in a label — except the
+ * zero-width joiner, which emoji sequences (👨‍👩‍👧) are made of.
+ */
+const FORBIDDEN_TEXT = /(?!\u200d)[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
+/**
+ * At least one character that draws something: not a mark, control, format or separator, nor a blank that renders as
+ * nothing (Hangul fillers, braille blank) — so a lone joiner, variation selector or filler is not a label (#1887 P3).
+ */
+const VISIBLE = /[^\p{M}\p{C}\p{Z}\u115f\u1160\u3164\uffa0\u2800]/u;
+/** A card's bio (r4 §1): NFC, 1..280 graphemes, at most 3 line breaks ("\n" only), otherwise as one line. */
+export const BIO_MAX_GRAPHEMES = 280;
+export const BIO_MAX_BREAKS = 3;
+export const TAGLINE_MAX_GRAPHEMES = 60;
+/**
+ * #1889 review: one explicit bound in UTF-16 units too, for the host and the page alike — a grapheme may be many units
+ * (an emoji family is 8), so 10 per grapheme keeps every ordinary text and still bounds what is stored.
+ */
+export const TAGLINE_MAX_UNITS = TAGLINE_MAX_GRAPHEMES * 10;
+export const BIO_MAX_UNITS = 2800;
+/** A card's tagline: one line of 1..60 graphemes, at most TAGLINE_MAX_UNITS units. */
+export function canonicalTagline(v) {
+    const t = canonicalText(v, 1, TAGLINE_MAX_GRAPHEMES);
+    return t !== null && t.length <= TAGLINE_MAX_UNITS ? t : null;
+}
+export function canonicalBio(v) {
+    if (typeof v !== "string")
+        return null;
+    const s = v.normalize("NFC");
+    const lines = s.split("\n");
+    if (s.length > BIO_MAX_UNITS || lines.length > BIO_MAX_BREAKS + 1 || s.trim() !== s || !VISIBLE.test(s))
+        return null;
+    if (lines.some(l => FORBIDDEN_TEXT.test(l)))
+        return null;
+    const n = [...GRAPHEMES.segment(s)].length;
+    return n >= 1 && n <= BIO_MAX_GRAPHEMES ? s : null;
+}
+/** One line of text: NFC, `min..max` graphemes, nothing invisible or directional. */
+export function canonicalText(v, min, max) {
+    if (typeof v !== "string")
+        return null;
+    const s = v.normalize("NFC");
+    if (FORBIDDEN_TEXT.test(s) || s.trim() !== s || !VISIBLE.test(s))
+        return null;
+    const n = [...GRAPHEMES.segment(s)].length;
+    return n >= min && n <= max ? s : null;
+}
+function relLuminance(hex) {
+    const c = [1, 3, 5].map(i => parseInt(hex.slice(i, i + 2), 16) / 255).map(x => (x <= 0.03928 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4));
+    return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
+}
+export function contrastRatio(a, b) {
+    const [l1, l2] = [relLuminance(a), relLuminance(b)].sort((x, y) => y - x);
+    return (l1 + 0.05) / (l2 + 0.05);
+}
+/** The palette a mode renders with: the theme's colours over the defaults (a mode's accent, else the theme's). */
+export function effectivePalette(theme, mode) {
+    return { ...THEME_DEFAULTS[mode], ...(theme.accent ? { accent: theme.accent } : {}), ...(theme.colors?.[mode] ?? {}) };
+}
+/**
+ * The whole theme, checked and canonicalised: closed schema at every level, types never coerced, integers and steps,
+ * colours re-serialised, text NFC and counted in graphemes, asset ids this instance has, contrast per mode, ≤ 4 KiB.
+ */
+export function checkTheme(input, ctx) {
+    const errors = [];
+    const bad = (path, problem) => { errors.push({ path, problem }); };
+    if (!isObj(input))
+        return { ok: false, errors: [{ path: "", problem: "must be an object" }] };
+    const out = { v: 1 };
+    const known = new Set(["v", "colors", "accent", "bubble", "font", "background", "avatar", "workingLabel", "card", "identity"]);
+    for (const k of Object.keys(input))
+        if (!known.has(k))
+            bad(k, "unknown key");
+    if (input.v !== undefined && input.v !== 1)
+        bad("v", "must be 1");
+    if (input.colors !== undefined) {
+        if (!isObj(input.colors))
+            bad("colors", "must be an object");
+        else {
+            const colors = {};
+            for (const k of Object.keys(input.colors))
+                if (!MODES.includes(k))
+                    bad(`colors.${k}`, "unknown key (light or dark)");
+            for (const mode of MODES) {
+                const pal = input.colors[mode];
+                if (pal === undefined)
+                    continue;
+                if (!isObj(pal)) {
+                    bad(`colors.${mode}`, "must be an object");
+                    continue;
+                }
+                const p = {};
+                for (const k of Object.keys(pal)) {
+                    if (!PALETTE_KEYS.includes(k)) {
+                        bad(`colors.${mode}.${k}`, "unknown key");
+                        continue;
+                    }
+                    const c = canonicalColor(pal[k]);
+                    if (!c)
+                        bad(`colors.${mode}.${k}`, "must be a colour #rgb or #rrggbb");
+                    else
+                        p[k] = c;
+                }
+                if (Object.keys(p).length)
+                    colors[mode] = sortPalette(p);
+            }
+            if (Object.keys(colors).length)
+                out.colors = colors;
+        }
+    }
+    if (input.accent !== undefined) {
+        const c = canonicalColor(input.accent);
+        if (!c)
+            bad("accent", "must be a colour #rgb or #rrggbb");
+        else
+            out.accent = c;
+    }
+    if (input.bubble !== undefined) {
+        if (!isObj(input.bubble))
+            bad("bubble", "must be an object");
+        else {
+            const b = {};
+            for (const k of Object.keys(input.bubble))
+                if (k !== "radius" && k !== "border")
+                    bad(`bubble.${k}`, "unknown key");
+            const r = input.bubble.radius;
+            if (r !== undefined) {
+                if (!Number.isInteger(r) || r < 0 || r > 24)
+                    bad("bubble.radius", "a whole number of px, 0..24");
+                else
+                    b.radius = r;
+            }
+            const bd = input.bubble.border;
+            if (bd !== undefined) {
+                if (!BORDERS.includes(bd))
+                    bad("bubble.border", "none, thin or accent");
+                else
+                    b.border = bd;
+            }
+            if (Object.keys(b).length)
+                out.bubble = b;
+        }
+    }
+    if (input.font !== undefined) {
+        if (!FONTS.includes(input.font))
+            bad("font", "inter, system or mono");
+        else
+            out.font = input.font;
+    }
+    if (input.background !== undefined) {
+        const bg = input.background;
+        if (!isObj(bg))
+            bad("background", "must be an object");
+        else {
+            for (const k of Object.keys(bg))
+                if (!["image", "fit", "opacity"].includes(k))
+                    bad(`background.${k}`, "unknown key");
+            const okImage = typeof bg.image === "string" && ASSET_ID.test(bg.image) && ctx.assets.has(bg.image);
+            if (!okImage)
+                bad("background.image", typeof bg.image === "string" && ASSET_ID.test(bg.image) ? "no such asset of this instance" : "an asset id");
+            const okFit = FITS.includes(bg.fit);
+            if (!okFit)
+                bad("background.fit", "cover or contain");
+            const op = bg.opacity;
+            const okOp = typeof op === "number" && Number.isFinite(op) && op >= 0.05 && op <= 1;
+            if (!okOp)
+                bad("background.opacity", "a number 0.05..1");
+            if (okImage && okFit && okOp)
+                out.background = { image: bg.image, fit: bg.fit, opacity: Math.round(op * 20) / 20 };
+        }
+    }
+    if (input.avatar !== undefined) {
+        const a = input.avatar;
+        if (typeof a !== "string" || !ASSET_ID.test(a))
+            bad("avatar", "an asset id");
+        else if (!ctx.assets.has(a))
+            bad("avatar", "no such asset of this instance");
+        else
+            out.avatar = a;
+    }
+    if (input.workingLabel !== undefined) {
+        const t = canonicalText(input.workingLabel, 1, 24);
+        if (t === null)
+            bad("workingLabel", "1..24 characters on one line, no control or direction characters");
+        else
+            out.workingLabel = t;
+    }
+    if (input.card !== undefined) {
+        const c = input.card;
+        if (!isObj(c))
+            bad("card", "must be an object");
+        else {
+            const card = {};
+            for (const k of Object.keys(c))
+                if (!["portrait", "banner", "tagline", "bio"].includes(k))
+                    bad(`card.${k}`, "unknown key");
+            for (const slot of ["portrait", "banner"]) {
+                const id = c[slot];
+                if (id === undefined)
+                    continue;
+                if (typeof id !== "string" || !ASSET_ID.test(id))
+                    bad(`card.${slot}`, "an asset id");
+                else if (!ctx.assets.has(id))
+                    bad(`card.${slot}`, "no such asset of this instance");
+                else if (ctx.slotOf && ctx.slotOf(id) !== slot)
+                    bad(`card.${slot}`, `a picture uploaded for the ${slot} slot`);
+                else
+                    card[slot] = id;
+            }
+            if (c.tagline !== undefined) {
+                const t = canonicalTagline(c.tagline);
+                if (t === null)
+                    bad("card.tagline", `1..${TAGLINE_MAX_GRAPHEMES} characters on one line, no control or direction characters`);
+                else
+                    card.tagline = t;
+            }
+            if (c.bio !== undefined) {
+                const b = canonicalBio(c.bio);
+                if (b === null)
+                    bad("card.bio", `1..${BIO_MAX_GRAPHEMES} characters, at most ${BIO_MAX_BREAKS} line breaks, no control or direction characters`);
+                else
+                    card.bio = b;
+            }
+            if (Object.keys(card).length)
+                out.card = card;
+        }
+    }
+    if (input.identity !== undefined) {
+        const id = input.identity;
+        if (!isObj(id))
+            bad("identity", "must be an object");
+        else {
+            const identity = {};
+            for (const k of Object.keys(id))
+                if (k !== "color" && k !== "show")
+                    bad(`identity.${k}`, "unknown key");
+            if (id.color !== undefined) {
+                const c = canonicalIdentityColor(id.color);
+                if (!c)
+                    bad("identity.color", "a preset (red, orange, amber, lime, green, teal, cyan, blue, indigo, violet, pink, slate) or a colour #rrggbb");
+                else
+                    identity.color = c;
+            }
+            if (id.show !== undefined) {
+                const s = canonicalPlacements(id.show);
+                if (!s)
+                    bad("identity.show", "a list of where the colour shows: name, bar, ring (each once; [] for nowhere)");
+                else
+                    identity.show = s;
+            }
+            if (Object.keys(identity).length)
+                out.identity = identity;
+        }
+    }
+    if (errors.length)
+        return { ok: false, errors };
+    for (const mode of MODES) {
+        const pal = effectivePalette(out, mode);
+        for (const [fg, bgKey, min] of CONTRAST_PAIRS) {
+            const ratio = contrastRatio(pal[fg], pal[bgKey]);
+            if (ratio + 1e-9 < min)
+                bad(`colors.${mode}.${fg}`, `contrast ${fg} on ${bgKey} is ${ratio.toFixed(2)}:1, at least ${min}:1 is needed`);
+        }
+    }
+    if (errors.length)
+        return { ok: false, errors };
+    const canonical = canonicalTheme(out);
+    if (Buffer.byteLength(JSON.stringify(canonical), "utf8") > THEME_MAX_BYTES)
+        return { ok: false, errors: [{ path: "", problem: `larger than ${THEME_MAX_BYTES} bytes` }] };
+    return { ok: true, theme: canonical };
+}
+function sortPalette(p) {
+    const out = {};
+    for (const k of PALETTE_KEYS)
+        if (p[k] !== undefined)
+            out[k] = p[k];
+    return out;
+}
+/** One key order, so the stored, served and tool-returned JSON are the same bytes for the same theme. */
+export function canonicalTheme(t) {
+    const out = { v: 1 };
+    if (t.colors) {
+        const c = {};
+        for (const m of MODES)
+            if (t.colors[m])
+                c[m] = sortPalette(t.colors[m]);
+        out.colors = c;
+    }
+    if (t.accent)
+        out.accent = t.accent;
+    if (t.bubble)
+        out.bubble = { ...(t.bubble.radius !== undefined ? { radius: t.bubble.radius } : {}), ...(t.bubble.border ? { border: t.bubble.border } : {}) };
+    if (t.font)
+        out.font = t.font;
+    if (t.background)
+        out.background = { image: t.background.image, fit: t.background.fit, opacity: t.background.opacity };
+    if (t.avatar)
+        out.avatar = t.avatar;
+    if (t.workingLabel)
+        out.workingLabel = t.workingLabel;
+    if (t.card) {
+        const c = {};
+        for (const k of ["portrait", "banner", "tagline", "bio"])
+            if (t.card[k])
+                c[k] = t.card[k];
+        if (Object.keys(c).length)
+            out.card = c;
+    }
+    if (t.identity && (t.identity.color || t.identity.show)) {
+        out.identity = { ...(t.identity.color ? { color: t.identity.color } : {}), ...(t.identity.show ? { show: [...t.identity.show] } : {}) };
+    }
+    return out;
+}
+/**
+ * set_web_theme's patch on the current theme: `set` merges (objects by key, values replace), then `clear` removes
+ * dotted paths ("colors.dark.bg", "bubble", …). The result is checked whole: all or nothing.
+ */
+export function applyThemePatch(current, patch, ctx) {
+    if (!isObj(patch))
+        return { ok: false, errors: [{ path: "", problem: "a patch { set?, clear? }" }] };
+    for (const k of Object.keys(patch))
+        if (k !== "set" && k !== "clear")
+            return { ok: false, errors: [{ path: k, problem: "unknown key (set or clear)" }] };
+    const next = JSON.parse(JSON.stringify(current));
+    if (patch.set !== undefined) {
+        if (!isObj(patch.set))
+            return { ok: false, errors: [{ path: "set", problem: "must be an object" }] };
+        mergeInto(next, patch.set);
+    }
+    if (patch.clear !== undefined) {
+        if (!Array.isArray(patch.clear) || patch.clear.length > 32 || !patch.clear.every(p => typeof p === "string" && /^[a-zA-Z0-9]+(\.[a-zA-Z0-9]+){0,2}$/.test(p))) {
+            return { ok: false, errors: [{ path: "clear", problem: "a list of dotted paths such as colors.dark.bg" }] };
+        }
+        for (const path of patch.clear)
+            clearPath(next, path.split("."));
+    }
+    return checkTheme(next, ctx);
+}
+function mergeInto(target, src) {
+    for (const k of Object.keys(src)) {
+        const v = src[k];
+        if (Object.hasOwn(target, k) && isObj(v) && isObj(target[k])) {
+            mergeInto(target[k], v);
+            continue;
+        }
+        // An own property, whatever the name ("__proto__" included): the closed-schema check then reports it, never a prototype.
+        Object.defineProperty(target, k, { value: isObj(v) ? JSON.parse(JSON.stringify(v)) : v, enumerable: true, writable: true, configurable: true });
+    }
+}
+function clearPath(target, parts) {
+    const [head, ...rest] = parts;
+    if (!head || !Object.hasOwn(target, head))
+        return;
+    if (!rest.length) {
+        delete target[head];
+        return;
+    }
+    const child = target[head];
+    if (!isObj(child))
+        return;
+    clearPath(child, rest);
+    if (!Object.keys(child).length)
+        delete target[head];
+}
+//# sourceMappingURL=web-theme.js.map

package/dist/web-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-theme.js","sourceRoot":"","sources":["../src/web-theme.ts"],"names":[],"mappings":"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"}

package/dist/web-widget.d.ts

@@ -0,0 +1,72 @@
+export declare const WIDGET_SLOTS: readonly ["chat_header", "details", "sidebar"];
+export type WidgetSlot = typeof WIDGET_SLOTS[number];
+/** The agent's own slots. `sidebar` is a person's (owner_slot for an agent). */
+export declare const AGENT_WIDGET_SLOTS: readonly ["chat_header", "details"];
+export type AgentWidgetSlot = typeof AGENT_WIDGET_SLOTS[number];
+export declare const WIDGET_ITEM_TYPES: readonly ["stat", "progress", "text", "list", "badge", "spark"];
+export type WidgetItemType = typeof WIDGET_ITEM_TYPES[number];
+export declare const WIDGET_TONES: readonly ["ok", "warn", "bad", "info", "muted"];
+export type WidgetTone = typeof WIDGET_TONES[number];
+/** Values the page already has for the instance itself (its status frame entry). */
+export declare const INSTANCE_BINDS: readonly ["state", "context_pct", "cost_usd"];
+/** The fleet's counts: the person's sidebar only (an agent's widget never sees another instance). */
+export declare const FLEET_BINDS: readonly ["fleet.idle", "fleet.working", "fleet.needs_you", "fleet.stopped"];
+export type WidgetBind = typeof INSTANCE_BINDS[number] | typeof FLEET_BINDS[number];
+/** The chat header is one short strip: at most 4 compact items, and no list or sparkline. */
+export declare const SLOT_RULES: Record<WidgetSlot, {
+    maxItems: number;
+    types: readonly WidgetItemType[];
+    binds: readonly WidgetBind[];
+}>;
+export declare const WIDGET_TITLE_MAX = 24;
+export declare const WIDGET_LABEL_MAX = 24;
+export declare const WIDGET_UNIT_MAX = 8;
+export declare const WIDGET_TEXT_MAX = 120;
+export declare const WIDGET_LIST_ITEMS = 6;
+export declare const WIDGET_LIST_TEXT_MAX = 60;
+export declare const WIDGET_SPARK_POINTS = 48;
+export declare const WIDGET_TONES_MAX = 8;
+export declare const WIDGET_NUMBER_MAX = 1000000000000000;
+/** Canonical JSON bytes: the spec, and the data. */
+export declare const WIDGET_SPEC_MAX_BYTES = 2048;
+export declare const WIDGET_DATA_MAX_BYTES = 4096;
+export interface WidgetItem {
+    type: WidgetItemType;
+    label?: string;
+    key?: string;
+    bind?: WidgetBind;
+    unit?: string;
+    max?: number;
+    tone?: WidgetTone;
+    tones?: Record<string, WidgetTone>;
+}
+export interface WidgetSpec {
+    v: 1;
+    title: string;
+    items: WidgetItem[];
+}
+export type WidgetValue = number | string | string[] | number[];
+export type WidgetData = Record<string, WidgetValue>;
+export interface WidgetProblem {
+    path: string;
+    problem: string;
+}
+export type Checked<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    errors: WidgetProblem[];
+};
+/** A spec for `slot`, closed and canonical: unknown keys, types, binds or a component the slot can't hold are refused. */
+export declare function checkWidgetSpec(raw: unknown, slot: WidgetSlot): Checked<WidgetSpec>;
+/** Whether `v` is a value an item of `type` can show (the same rule on the page). */
+export declare function valueFits(type: WidgetItemType, v: unknown): boolean;
+/** Data for `spec`: closed to the keys the spec names, each value fitting every item that shows it. */
+export declare function checkWidgetData(raw: unknown, spec: WidgetSpec): Checked<WidgetData>;
+/** `patch` over `prev`: a key set to null is removed; the result is checked whole. */
+export declare function mergeWidgetData(prev: WidgetData, patch: unknown, spec: WidgetSpec): Checked<WidgetData>;
+/** The data kept when a spec changes: each value that still fits the new spec. */
+export declare function carryWidgetData(prev: WidgetData, spec: WidgetSpec): WidgetData;
+/** A spec's id: its content (canonical JSON). The same spec in two bundles is the same widget. */
+export declare function widgetId(spec: WidgetSpec): string;