@cellarnode/ui 0.201.1 → 0.203.0

package/dist/agent/role-cards/host-contract.js

@@ -0,0 +1,348 @@
+import { parseCard } from "@cellarnode/agent-cards/zod4";
+import { cleanInline } from "./text-safety.js";
+const lookup = (catalog, tool) => tool !== undefined && Object.hasOwn(catalog, tool) ? catalog[tool] : undefined;
+/**
+ * Rules 1 and 3 over a card's actions. Keeps an action only when it is safe to offer: an `open`/`navigate` carries no tool,
+ * an `edit`/`propose` names a tool the catalog knows, and a declared `tier` equals the catalog's. Everything else is dropped
+ * (never "corrected"), and the reasons are returned for logging.
+ */
+export function resolveCardActions(actions, catalog) {
+    const kept = [];
+    const dropped = [];
+    for (const a of actions ?? []) {
+        if (a.kind === "open" || a.kind === "navigate") {
+            if (a.tool !== undefined || a.args !== undefined)
+                dropped.push({ id: a.id, reason: "tool_on_navigation" });
+            else
+                kept.push(a);
+            continue;
+        }
+        if (a.tool === undefined) {
+            if (a.kind === "edit" || a.kind === "propose")
+                dropped.push({ id: a.id, reason: "tool_missing" });
+            else
+                kept.push(a);
+            continue;
+        }
+        const entry = lookup(catalog, a.tool);
+        if (!entry)
+            dropped.push({ id: a.id, reason: "unknown_tool" });
+        else if (a.tier !== undefined && a.tier !== entry.tier)
+            dropped.push({ id: a.id, reason: "tier_mismatch" });
+        else
+            kept.push(a);
+    }
+    return { actions: kept, dropped };
+}
+/**
+ * `resolveCardActions`, then what the person SEES comes from the catalog, not the model: a write is labelled with the catalog
+ * title ("Tidy up" cannot front a delete) and its `tier` is stamped from the catalog, so danger styling and the confirm hint
+ * never depend on what the model declared. A read tool keeps the model's caption and carries no tier.
+ */
+export function actionsForDisplay(actions, catalog) {
+    const cat = catalog ?? {};
+    return resolveCardActions(actions, cat).actions.map((a) => {
+        const entry = lookup(cat, a.tool);
+        if (!entry)
+            return a;
+        if (entry.tier === "read")
+            return { ...a, tier: undefined };
+        return { ...a, label: entry.title, tier: entry.tier };
+    });
+}
+/**
+ * The actions a card actually OFFERS the person: what `actionsForDisplay` accepts, and then only what the host can act on. A tool
+ * action needs the host's `onAction` (`canRunTools`); a link needs the host's `allowLink` to accept its `href`. The one rule behind
+ * both the action row and anything that decides whether to draw a row at all.
+ */
+export function offeredActions(actions, catalog, host) {
+    return actionsForDisplay(actions, catalog).filter((a) => (a.tool && host.canRunTools) || (a.href && host.allowLink?.(a.href)));
+}
+const show = (v) => v === null || v === undefined ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+function plan(entry, args, subject) {
+    return {
+        tool: entry.name,
+        title: subject ? `${entry.title}: ${subject}` : entry.title,
+        tier: entry.tier,
+        requiresConfirm: entry.tier !== "read",
+        args,
+        rows: Object.entries(args).map(([label, value]) => ({ label, value: show(value) })),
+        ...(subject ? { subject } : {}),
+    };
+}
+const validated = (entry, args) => {
+    const parsed = entry.inputSchema.safeParse(args);
+    if (!parsed.success)
+        return null;
+    const data = parsed.data;
+    return typeof data === "object" && data !== null && !Array.isArray(data)
+        ? data
+        : {};
+};
+/**
+ * Rules 1, 2, 3 and 5 for one action: the plan the confirm UI renders. Its title, tier and rows come from the catalog and
+ * the tool's validated args; the action's `label` is not read.
+ */
+export function buildConfirm(action, catalog) {
+    if (action.kind === "open" || action.kind === "navigate" || action.tool === undefined)
+        return { ok: false, reason: "not_a_tool_action" };
+    const entry = lookup(catalog, action.tool);
+    if (!entry)
+        return { ok: false, reason: "unknown_tool" };
+    if (action.tier !== undefined && action.tier !== entry.tier)
+        return { ok: false, reason: "tier_mismatch" };
+    const args = validated(entry, action.args ?? {});
+    if (!args)
+        return { ok: false, reason: "invalid_args" };
+    return { ok: true, plan: plan(entry, args) };
+}
+/**
+ * Find a dotted or bracketed path (`a.b[0].c`) in a record. `found` is false for a missing key, so "absent" is not confused with
+ * a present `null`. Refuses prototype keys and array `length`.
+ */
+export function lookupPath(record, path) {
+    let cur = record;
+    for (const seg of path.split(/[.[\]]/).filter((s) => s !== "")) {
+        if (seg === "__proto__" || seg === "constructor" || seg === "prototype")
+            return { found: false, value: undefined };
+        if (typeof cur !== "object" || cur === null || !Object.hasOwn(cur, seg))
+            return { found: false, value: undefined };
+        if (Array.isArray(cur) && !/^\d+$/.test(seg))
+            return { found: false, value: undefined };
+        cur = cur[seg];
+    }
+    return { found: true, value: cur };
+}
+/** The value at a path, or `undefined` when absent. */
+export function readPath(record, path) {
+    return lookupPath(record, path).value;
+}
+/**
+ * Value equality for the server-vs-proposal diff. Deliberately lenient about number vs string (`12.5` vs `"12.5"`): the backend
+ * returns decimals as strings, the model writes numbers. Two non-null scalars are the same when their String forms match;
+ * `null` and absent are the same; objects are never the same as anything but themselves.
+ */
+const same = (a, b) => {
+    const x = a ?? null;
+    const y = b ?? null;
+    return (x === y ||
+        (x !== null &&
+            y !== null &&
+            typeof x !== "object" &&
+            typeof y !== "object" &&
+            String(x) === String(y)));
+};
+/** A fetched record's label for the confirm title: short, single-line text, or nothing (never the uuid). */
+function subjectLabel(entry, record) {
+    return cleanInline(entry.recordLabel?.(record) ?? recordName(record), 80);
+}
+/** The record's own name: the first of `name`, `title`, `label` that is a string. Not yet cleaned. */
+export const recordName = (record) => [record.name, record.title, record.label].find((v) => typeof v === "string");
+/**
+ * The host's own label for a fetched record, when its catalog has one: the `recordLabel` of a tool that acts on this kind of record
+ * (the tools a card names come first). Cleaned like a confirm title. `undefined` when no tool has one or it yields nothing. A
+ * `recordLabel` is host code: one that throws is skipped, never allowed to take the drawer down.
+ */
+export function catalogRecordLabel(catalog, kind, record, toolsNamedByCard = []) {
+    const cat = catalog ?? {};
+    const entries = [...toolsNamedByCard.map((t) => lookup(cat, t)), ...Object.values(cat)];
+    for (const entry of entries) {
+        if (!entry?.recordLabel || entry.targetKind !== kind)
+            continue;
+        try {
+            const label = cleanInline(entry.recordLabel(record), 120, true);
+            if (label)
+                return label;
+        }
+        catch {
+            // host code: fall through to the next tool, then to the record's own name
+        }
+    }
+    return undefined;
+}
+/**
+ * Rule 4 (with 1, 2 and 5): what a proposal's Apply may do. `expected` is the subject the CARD is about (its `detail`, or its
+ * offerId or matchId): a proposal for any other record is refused, as is one whose `kind` is not the tool's `targetKind`.
+ * Re-fetches the record by `kind` + `id`; a change whose path is absent from it is refused, a change whose `before` no longer
+ * matches is STALE and refuses the whole proposal, one already at `after` is skipped; the tool's `targetArg` is bound to
+ * `proposal.id` (a change that tries to set it is refused); the args go through the tool's input schema; the plan title names
+ * the fetched record.
+ */
+export async function planProposalApply(proposal, catalog, fetchRecord, expected) {
+    const entry = lookup(catalog, proposal.tool);
+    if (!entry)
+        return { ok: false, reason: "unknown_tool" };
+    if (proposal.tier !== entry.tier)
+        return { ok: false, reason: "tier_mismatch" };
+    const targetArg = entry.targetArg;
+    if (!targetArg)
+        return { ok: false, reason: "no_target_arg" };
+    if (!entry.targetKind)
+        return { ok: false, reason: "no_target_kind" };
+    if (proposal.kind !== entry.targetKind)
+        return { ok: false, reason: "kind_mismatch" };
+    if (proposal.kind !== expected.kind || proposal.id !== expected.id)
+        return { ok: false, reason: "subject_mismatch" };
+    if (proposal.changes.some((c) => c.path === targetArg))
+        return { ok: false, reason: "target_override" };
+    let fetched;
+    try {
+        fetched = await fetchRecord(proposal.kind, proposal.id);
+    }
+    catch {
+        return { ok: false, reason: "record_unavailable" };
+    }
+    if (fetched === null ||
+        fetched === undefined ||
+        typeof fetched !== "object" ||
+        Array.isArray(fetched))
+        return { ok: false, reason: "record_unavailable" };
+    const record = fetched;
+    const absent = proposal.changes
+        .filter((c) => !lookupPath(record, c.path).found)
+        .map((c) => c.path);
+    if (absent.length > 0)
+        return { ok: false, reason: "unknown_path", paths: absent };
+    const diff = [];
+    const conflicts = [];
+    for (const c of proposal.changes) {
+        const current = readPath(record, c.path);
+        const row = { path: c.path, before: current, after: c.after, claimedBefore: c.before };
+        if (same(current, c.after))
+            diff.push({ ...row, state: "already_applied" });
+        else if (same(current, c.before))
+            diff.push({ ...row, state: "pending" });
+        else
+            conflicts.push({ ...row, state: "pending" });
+    }
+    if (conflicts.length > 0)
+        return { ok: false, reason: "stale", conflicts };
+    const pending = proposal.changes.filter((_, i) => diff[i].state === "pending");
+    if (pending.length === 0)
+        return { ok: false, reason: "nothing_to_apply" };
+    const base = entry.argsFromChanges
+        ? entry.argsFromChanges(pending, proposal.id)
+        : Object.fromEntries(pending.map((c) => [c.path, c.after]));
+    const args = validated(entry, { ...base, [targetArg]: proposal.id });
+    if (!args)
+        return { ok: false, reason: "invalid_args" };
+    return { ok: true, plan: plan(entry, args, subjectLabel(entry, record)), diff, proposal };
+}
+/** The subject a card is about: its `detail` pointer. Cards that carry an id of their own (offer, match) pass it explicitly. */
+export const subjectOf = (detail, fallback) => detail ? { kind: detail.kind, id: detail.id } : fallback;
+/**
+ * Rules 1 and 3 over a whole parsed card: keeps only the actions `actionsForDisplay` accepts and drops a `proposal` whose tool is
+ * unknown, whose tier differs from the catalog's or whose tool lacks a `targetArg` or `targetKind`. With NO catalog every
+ * tool-bearing action and every proposal is dropped (secure default): only `open`/`navigate`/tool-less actions remain.
+ */
+export function sanitizeCardForHost(card, catalog) {
+    const actions = actionsForDisplay(card.actions, catalog);
+    const entry = card.proposal ? lookup(catalog ?? {}, card.proposal.tool) : undefined;
+    const proposalOk = card.proposal !== undefined &&
+        entry !== undefined &&
+        entry.tier === card.proposal.tier &&
+        entry.targetArg !== undefined &&
+        entry.targetKind === card.proposal.kind;
+    return {
+        ...card,
+        actions: actions.length > 0 ? actions : undefined,
+        proposal: proposalOk ? card.proposal : undefined,
+    };
+}
+export const ROLE_AGENT_CARD_TYPES = [
+    "OfferCard",
+    "ProductCard",
+    "OpportunityCard",
+    "MatchCard",
+    "DataTable",
+];
+const isRoleCardType = (t) => ROLE_AGENT_CARD_TYPES.includes(t);
+/** The record kinds a card's `detail` pointer may name, per card type. A pointer to any other kind is a steered or broken card. */
+const DETAIL_KINDS_BY_CARD = {
+    OfferCard: ["offer"],
+    MatchCard: ["match"],
+    ProductCard: ["product", "variant"],
+    OpportunityCard: ["opportunity"],
+};
+/**
+ * Does the card's `detail` pointer name what the card is about? An offer's or a match's must name its own id, a product's must be a
+ * product or a variant, an opportunity's an opportunity. A card with no pointer agrees (nothing to disagree with). The cards and
+ * `readRoleCard` both call this, so a disagreeing card is refused the same way everywhere, never reconciled.
+ */
+export function detailAgrees(cardType, data) {
+    const d = data.detail;
+    if (!d)
+        return true;
+    if (!DETAIL_KINDS_BY_CARD[cardType].includes(d.kind))
+        return false;
+    if (cardType === "OfferCard")
+        return d.id === data.offerId;
+    if (cardType === "MatchCard")
+        return d.id === data.matchId;
+    return true;
+}
+/**
+ * The ONE way a host turns what an agent sent into a role card it may draw: parse against the agent-cards schema, refuse a card
+ * whose `detail` disagrees with it (`detailAgrees`), then `sanitizeCardForHost` against the host catalog. `null` for an unknown
+ * type, data that fails the schema, or a disagreeing card. `subject` is the record THIS card is about (its offerId or matchId, or its
+ * `detail`), what a proposal is bound to. `renderRoleAgentCard` and the inspector drawer both read through here.
+ */
+export function readRoleCard(cardType, data, catalog) {
+    if (!isRoleCardType(cardType))
+        return null;
+    switch (cardType) {
+        case "OfferCard": {
+            const parsed = parseCard("OfferCard", data);
+            if (!parsed || !detailAgrees(cardType, parsed))
+                return null;
+            return {
+                cardType,
+                data: sanitizeCardForHost(parsed, catalog),
+                subject: { kind: "offer", id: parsed.offerId },
+            };
+        }
+        case "MatchCard": {
+            const parsed = parseCard("MatchCard", data);
+            if (!parsed || !detailAgrees(cardType, parsed))
+                return null;
+            return {
+                cardType,
+                data: sanitizeCardForHost(parsed, catalog),
+                subject: { kind: "match", id: parsed.matchId },
+            };
+        }
+        case "ProductCard": {
+            const parsed = parseCard("ProductCard", data);
+            if (!parsed || !detailAgrees(cardType, parsed))
+                return null;
+            return {
+                cardType,
+                data: sanitizeCardForHost(parsed, catalog),
+                subject: subjectOf(parsed.detail),
+            };
+        }
+        case "OpportunityCard": {
+            const parsed = parseCard("OpportunityCard", data);
+            if (!parsed || !detailAgrees(cardType, parsed))
+                return null;
+            return {
+                cardType,
+                data: sanitizeCardForHost(parsed, catalog),
+                subject: subjectOf(parsed.detail),
+            };
+        }
+        case "DataTable": {
+            const parsed = parseCard("DataTable", data);
+            if (!parsed)
+                return null;
+            // A table is a list, not one record: no pointer to open and nothing a proposal could be bound to. Only its `actions` survive,
+            // and only the ones the host catalog accepts (a link is checked against the host's `allowLink` when the card is drawn).
+            return {
+                cardType,
+                data: { ...sanitizeCardForHost(parsed, catalog), detail: undefined, proposal: undefined },
+                subject: undefined,
+            };
+        }
+    }
+}
+//# sourceMappingURL=host-contract.js.map

package/dist/agent/role-cards/host-contract.js.map

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

package/dist/agent/role-cards/inspector-drawer.d.ts

@@ -0,0 +1,42 @@
+import { type AgentInspectorViewCopyOverride, type AgentInspectorViewProps } from "./inspector-view.js";
+export declare const DEFAULT_INSPECTOR_CLOSE = "Close details";
+/** Handed to `onCloseAutoFocus`: call `preventDefault()` to take over focus instead of the drawer returning it to its opener. */
+export interface AgentInspectorCloseFocusEvent {
+    preventDefault: () => void;
+}
+export type AgentInspectorDrawerCopy = AgentInspectorViewCopyOverride & {
+    /** The accessible name of the built-in close button. */
+    close?: string;
+};
+export interface AgentInspectorDrawerProps extends Omit<AgentInspectorViewProps, "heading" | "onHandOff" | "active" | "copy" | "className"> {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /**
+     * Where focus goes when the drawer closes: the button that opened it. Hand it the `opener` that `onOpenDetail(detail, opener)`
+     * received. Without it the drawer returns focus to whatever was focused when it opened, which is nothing in a browser that does
+     * not focus a button on click (Safari) and is lost if the card re-rendered in between.
+     */
+    returnFocus?: HTMLElement | null;
+    /**
+     * Called as the drawer finishes closing, before it returns focus. Call `event.preventDefault()` to take focus yourself: a host
+     * that has just rendered a confirm card for a hand-off should focus that card here, since the drawer closes on every hand-off.
+     */
+    onCloseAutoFocus?: (event: AgentInspectorCloseFocusEvent) => void;
+    copy?: AgentInspectorDrawerCopy;
+}
+/**
+ * @internal The inspector drawer (CEL-2487, tier 2 of inline card, drawer, canvas): `AgentInspectorView` in a right-hand side
+ * drawer on desktop and a full-width, full-height sheet on a narrow screen. Built on the shared `Sheet` (Radix Dialog): focus lands
+ * on the drawer, is trapped, Escape and the scrim close it, and focus returns to the control that opened it.
+ *
+ * The view owns the content and the host contract (see `AgentInspectorView`); this owns the chrome. The confirm UI is the host's
+ * (the conversation's confirm card), so the drawer CLOSES once the view has handed something to the host: a modal drawer would
+ * otherwise sit on top of the confirmation it is waiting for. A refused action stays open and says so. Hosts that want focus to go
+ * to the confirm card use `onCloseAutoFocus`.
+ *
+ * Opening: the host renders `AgentCardActions` (inside any role card) with `onOpenDetail(detail, opener)`, remembers which card was
+ * clicked and its opener, and opens this with that card's `cardType` and `data`. A card with no `detail` pointer (or one that
+ * disagrees with the card) cannot be inspected: the drawer asks to close instead of showing an empty dialog.
+ */
+export declare function AgentInspectorDrawer({ open, onOpenChange, returnFocus, onCloseAutoFocus, copy, ...view }: AgentInspectorDrawerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=inspector-drawer.d.ts.map

package/dist/agent/role-cards/inspector-drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-drawer.d.ts","sourceRoot":"","sources":["../../../src/agent/role-cards/inspector-drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAGvD,iIAAiI;AACjI,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,GAAG;IACtE,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CACrD,uBAAuB,EACvB,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAC1D;IACC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAClE,IAAI,CAAC,EAAE,wBAAwB,CAAC;CACjC;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,IAAI,EACJ,GAAG,IAAI,EACR,EAAE,yBAAyB,kDA2D3B"}

package/dist/agent/role-cards/inspector-drawer.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { Sheet, SheetContent, SheetDescription, SheetTitle } from "../../components/sheet.js";
+import { AgentInspectorView, useInspectorCard, } from "./inspector-view.js";
+export const DEFAULT_INSPECTOR_CLOSE = "Close details";
+const DEFAULT_CLOSE = DEFAULT_INSPECTOR_CLOSE;
+function DrawerHeading({ eyebrow, title, description, aside }) {
+    return (_jsxs("div", { className: "flex shrink-0 flex-col gap-1 border-b border-border/60 pt-[max(0.75rem,env(safe-area-inset-top))] pr-16 pb-3 pl-4", children: [eyebrow && _jsx("p", { className: "text-xs/4 text-muted-foreground", children: eyebrow }), _jsx(SheetTitle, { className: "text-base/6 font-semibold text-balance break-words", children: title }), _jsx(SheetDescription, { className: "sr-only", children: description }), aside] }));
+}
+/**
+ * @internal The inspector drawer (CEL-2487, tier 2 of inline card, drawer, canvas): `AgentInspectorView` in a right-hand side
+ * drawer on desktop and a full-width, full-height sheet on a narrow screen. Built on the shared `Sheet` (Radix Dialog): focus lands
+ * on the drawer, is trapped, Escape and the scrim close it, and focus returns to the control that opened it.
+ *
+ * The view owns the content and the host contract (see `AgentInspectorView`); this owns the chrome. The confirm UI is the host's
+ * (the conversation's confirm card), so the drawer CLOSES once the view has handed something to the host: a modal drawer would
+ * otherwise sit on top of the confirmation it is waiting for. A refused action stays open and says so. Hosts that want focus to go
+ * to the confirm card use `onCloseAutoFocus`.
+ *
+ * Opening: the host renders `AgentCardActions` (inside any role card) with `onOpenDetail(detail, opener)`, remembers which card was
+ * clicked and its opener, and opens this with that card's `cardType` and `data`. A card with no `detail` pointer (or one that
+ * disagrees with the card) cannot be inspected: the drawer asks to close instead of showing an empty dialog.
+ */
+export function AgentInspectorDrawer({ open, onOpenChange, returnFocus, onCloseAutoFocus, copy, ...view }) {
+    const card = useInspectorCard(view.cardType, view.data, view.catalog);
+    const contentRef = useRef(null);
+    const openerRef = useRef(null);
+    const cannotInspect = !card;
+    useEffect(() => {
+        if (open && cannotInspect)
+            onOpenChange(false);
+    }, [open, cannotInspect, onOpenChange]);
+    if (!card)
+        return null;
+    const { close = DEFAULT_CLOSE, ...viewCopy } = copy ?? {};
+    return (_jsx(Sheet, { open: open, onOpenChange: onOpenChange, children: _jsx(SheetContent, { ref: contentRef, side: "right", closeLabel: close, className: "flex h-dvh w-full flex-col gap-0 p-0 outline-hidden sm:max-w-lg", onOpenAutoFocus: (event) => {
+                // Radix returns focus only to a `Trigger`, and this drawer is opened by a card's own button, so remember it here.
+                const active = document.activeElement;
+                openerRef.current =
+                    active instanceof HTMLElement && active !== document.body ? active : null;
+                // Land on the drawer itself: a screen reader announces its name and description before any control.
+                event.preventDefault();
+                contentRef.current?.focus({ preventScroll: true });
+            }, onCloseAutoFocus: (event) => {
+                event.preventDefault();
+                const remembered = openerRef.current;
+                openerRef.current = null;
+                let hostTookFocus = false;
+                onCloseAutoFocus?.({
+                    preventDefault: () => {
+                        hostTookFocus = true;
+                    },
+                });
+                if (hostTookFocus)
+                    return;
+                // A host that moved focus on purpose (to the confirm card it just rendered) wins over the opener.
+                const active = document.activeElement;
+                if (active instanceof HTMLElement && active !== document.body)
+                    return;
+                const target = returnFocus?.isConnected
+                    ? returnFocus
+                    : remembered?.isConnected
+                        ? remembered
+                        : null;
+                target?.focus();
+            }, children: _jsx(AgentInspectorView, { ...view, copy: viewCopy, active: open, onHandOff: () => onOpenChange(false), heading: (parts) => _jsx(DrawerHeading, { ...parts }) }) }) }));
+}
+//# sourceMappingURL=inspector-drawer.js.map

package/dist/agent/role-cards/inspector-drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-drawer.js","sourceRoot":"","sources":["../../../src/agent/role-cards/inspector-drawer.tsx"],"names":[],"mappings":"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"}

package/dist/agent/role-cards/inspector-fixtures.d.ts

@@ -0,0 +1,84 @@
+import type { DetailKind } from "./host-contract.js";
+import type { AgentInspectorRecordState } from "./inspector-view.js";
+/**
+ * The records behind the fixture cards' `detail` pointers, keyed `kind:id`. They extend `fixtureRecords`, so a story's proposal
+ * Apply (which re-fetches by `kind:id`) and the drawer's record view read the same server truth.
+ */
+export declare const inspectorRecords: Record<string, Record<string, unknown>>;
+/** The `fetchRecord` a story or test host passes: the same records as `inspectorRecords`, `null` for an unknown pointer. */
+export declare const inspectorFetchRecord: (kind: string, id: string) => Promise<unknown>;
+/** A record with many fields and nesting, to prove the drawer scrolls and the caps hold. */
+export declare const largeRecord: Record<string, unknown>;
+/** A `ready` record state for the pointer it was fetched for; the record defaults to the fixture behind that pointer. */
+export declare const readyFor: (kind: DetailKind, id: string, record?: unknown) => AgentInspectorRecordState;
+/** Long, unbroken and hostile text in every place a record puts text: for the 320px story and the overflow checks. */
+export declare const longTextRecord: Record<string, unknown>;
+/**
+ * Records shaped like the V2 public DTOs `fetchRecord` will really return (backend `features/offers`, `opportunities` and `matching`
+ * `public-response-schemas.ts`), not like the agent-cards card fields. The free text in them is written by the other side.
+ */
+export declare const dtoRecords: {
+    readonly offer: {
+        readonly id: "11111111-1111-4111-8111-111111111111";
+        readonly parentOfferId: null;
+        readonly opportunityId: "22222222-2222-4222-8222-222222222222";
+        readonly status: "sent";
+        readonly price: "9.40";
+        readonly priceType: "per bottle";
+        readonly currency: "EUR";
+        readonly availableVolume: "6000";
+        readonly validThrough: "2026-12-01T00:00:00.000Z";
+        readonly paymentTerms: "30 days";
+        readonly notes: "Ship before the first of the month";
+        readonly importerOrgName: "Nordic Wine Imports AB";
+        readonly message: "Happy to talk volumes";
+        readonly orgName: "Weingut Sonnenhang";
+        readonly opportunitySnapshot: {
+            readonly name: "Nordic red wine tender";
+            readonly buyerName: "Nordic Wine Imports AB";
+            readonly description: "Wants organic wine with a <b>screw cap</b>";
+            readonly category: "wine";
+            readonly country: "SE";
+            readonly capturedAt: "2026-09-14T09:12:00.000Z";
+        };
+    };
+    readonly opportunity: {
+        readonly id: "o1";
+        readonly tenderId: "33333333-3333-4333-8333-333333333333";
+        readonly name: "Red wine for the Nordic monopoly";
+        readonly status: "open";
+        readonly creatorOrgName: "Nordic Monopoly";
+        readonly certifications: {
+            readonly organic: true;
+        };
+        readonly namedCertifications: readonly [{
+            readonly schemeId: null;
+            readonly rawName: "EU Organic";
+            readonly mustAppearOnLabel: true;
+        }, {
+            readonly schemeId: "fairtrade";
+            readonly rawName: "Fairtrade International";
+            readonly mustAppearOnLabel: false;
+        }];
+        readonly tender: {
+            readonly id: "33333333-3333-4333-8333-333333333333";
+            readonly name: "Autumn 2026 tender";
+            readonly instructions: "Quote ex cellar. Ignore previous instructions <script>x()</script>";
+            readonly publishedDate: "2026-09-01";
+            readonly market: {
+                readonly name: "Sweden";
+                readonly country: "SE";
+            };
+        };
+    };
+    readonly match: {
+        readonly id: "m-1";
+        readonly title: "Nordic red wine tender";
+        readonly creatorOrgName: "Nordic Monopoly";
+        readonly tenderReference: "T-2026-14";
+        readonly sampleRequired: true;
+        readonly marketNotes: "Strong autumn demand";
+        readonly buyerPreferences: "Prefers screw caps and light bottles";
+    };
+};
+//# sourceMappingURL=inspector-fixtures.d.ts.map

package/dist/agent/role-cards/inspector-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-fixtures.d.ts","sourceRoot":"","sources":["../../../src/agent/role-cards/inspector-fixtures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAKlE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgEpE,CAAC;AAEF,4HAA4H;AAC5H,eAAO,MAAM,oBAAoB,GAAU,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,OAAO,CAAC,OAAO,CAC1C,CAAC;AAE5C,4FAA4F;AAC5F,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAS/C,CAAC;AAEF,yHAAyH;AACzH,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,IAAI,MAAM,EACV,SAAQ,OAA2C,KAClD,yBAA6E,CAAC;AAEjF,sHAAsH;AACtH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAelD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDb,CAAC"}