@cellarnode/ui 0.201.1 → 0.202.0

package/dist/agent/role-cards/host-contract.d.ts

@@ -0,0 +1,214 @@
+import type { CardAction, CardDetail, CardProposal, DataTableData, MatchCardData, OfferCardData, OpportunityCardData, ProductCardData } from "@cellarnode/agent-cards/zod4";
+/**
+ * @internal The HOST side of the card contract (CEL-2445, `@cellarnode/agent-cards` README "Host contract (MUST)").
+ * A card's `actions` and `proposal` are claims by the model. These pure helpers are where a host turns a claim into
+ * something it may act on, or refuses. The card composites call them THEMSELVES, so the safe path is the only path:
+ * `AgentCardActions` hands the host a `CardConfirmPlan` (never the raw action) and `AgentProposalDiff` hands it the result of
+ * `planProposalApply` (never the raw proposal).
+ *
+ * 1. the tier comes ONLY from the host catalog, by `tool` (`card.tier` is advisory; a mismatch or unknown tool drops the action);
+ * 2. the confirm plan is built from the catalog's tool title and the ACTUAL validated args, never the model's `label`;
+ * 3. `open` and `navigate` never run a tool;
+ * 4. a proposal's Apply re-fetches the record, diffs server truth against `after`, binds the tool's target-id arg to `proposal.id`,
+ *    and binds the proposal to the card's subject (`expected`) and to the tool's `targetKind`;
+ * 5. args go through the tool's own input schema.
+ *
+ * No I/O except the host-supplied `fetchRecord`; nothing here runs a tool.
+ */
+export type CatalogTier = "read" | "reversible" | "destructive" | "costly";
+export type DetailKind = CardProposal["kind"];
+export interface AgentToolCatalogEntry {
+    name: string;
+    /** What the confirm UI calls the tool. Comes from the catalog, never from a card. */
+    title: string;
+    tier: CatalogTier;
+    /** The tool's own input schema (any zod 3.25 or 4 schema, or anything with `safeParse`). */
+    inputSchema: {
+        safeParse: (value: unknown) => {
+            success: true;
+            data: unknown;
+        } | {
+            success: false;
+            error?: unknown;
+        };
+    };
+    /** The argument that carries the id of the record the tool acts on. Required for any tool a proposal may name. */
+    targetArg?: string;
+    /** The kind of record the tool acts on. Required for any tool a proposal may name; a proposal of another kind is refused. */
+    targetKind?: DetailKind;
+    /** How a proposal's changes become this tool's args. Default: one arg per change path. `targetArg` is bound to `proposal.id` AFTER this runs. */
+    argsFromChanges?: (changes: CardProposal["changes"], id: string) => Record<string, unknown>;
+    /** The human label of a fetched record for the confirm title. Default: its `name`, `title` or `label` string. */
+    recordLabel?: (record: Record<string, unknown>) => string | undefined;
+}
+export type AgentToolCatalog = Readonly<Record<string, AgentToolCatalogEntry>>;
+export type DropReason = "unknown_tool" | "tier_mismatch" | "tool_on_navigation" | "tool_missing";
+export interface DroppedAction {
+    id: string;
+    reason: DropReason;
+}
+/**
+ * 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 declare function resolveCardActions(actions: readonly CardAction[] | undefined, catalog: AgentToolCatalog): {
+    actions: CardAction[];
+    dropped: DroppedAction[];
+};
+/**
+ * `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 declare function actionsForDisplay(actions: readonly CardAction[] | undefined, catalog: AgentToolCatalog | undefined): CardAction[];
+/**
+ * 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 declare function offeredActions(actions: readonly CardAction[] | undefined, catalog: AgentToolCatalog | undefined, host: {
+    canRunTools: boolean;
+    allowLink?: (path: string) => boolean;
+}): CardAction[];
+export interface ConfirmRow {
+    /** The argument name. */
+    label: string;
+    value: string;
+}
+export interface CardConfirmPlan {
+    tool: string;
+    /** The catalog's title for the tool, followed by the fetched record's name when there is one. NEVER the card's `label`. */
+    title: string;
+    /** The catalog's tier. */
+    tier: CatalogTier;
+    /** Every non-read tool confirms. */
+    requiresConfirm: boolean;
+    /** The validated arguments the tool would receive. */
+    args: Record<string, unknown>;
+    /** The same arguments, one row each, for the confirm UI. */
+    rows: ConfirmRow[];
+    /** The fetched record's label (a proposal's subject), when it has one. */
+    subject?: string;
+}
+export type BuildConfirmFailure = "not_a_tool_action" | "unknown_tool" | "tier_mismatch" | "invalid_args";
+/**
+ * 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 declare function buildConfirm(action: CardAction, catalog: AgentToolCatalog): {
+    ok: true;
+    plan: CardConfirmPlan;
+} | {
+    ok: false;
+    reason: BuildConfirmFailure;
+};
+/**
+ * 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 declare function lookupPath(record: unknown, path: string): {
+    found: boolean;
+    value: unknown;
+};
+/** The value at a path, or `undefined` when absent. */
+export declare function readPath(record: unknown, path: string): unknown;
+/** The record's own name: the first of `name`, `title`, `label` that is a string. Not yet cleaned. */
+export declare const recordName: (record: Record<string, unknown>) => string | undefined;
+/**
+ * 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 declare function catalogRecordLabel(catalog: AgentToolCatalog | undefined, kind: DetailKind, record: Record<string, unknown>, toolsNamedByCard?: readonly (string | undefined)[]): string | undefined;
+export interface ProposalDiffRow {
+    path: string;
+    /** What the SERVER has now (from the re-fetched record). The model's `before` is never shown as truth. */
+    before: unknown;
+    after: CardProposal["changes"][number]["after"];
+    /** What the model claimed `before` was ("proposed from"); kept so a stale refusal can show the mismatch. */
+    claimedBefore: CardProposal["changes"][number]["before"];
+    /** `already_applied`: the server already has `after`. `pending`: the server still has what the model said. */
+    state: "pending" | "already_applied";
+}
+export type ApplyProposalFailure = "unknown_tool" | "tier_mismatch" | "no_target_arg" | "no_target_kind" | "kind_mismatch" | "subject_mismatch" | "target_override" | "record_unavailable" | "unknown_path" | "stale" | "nothing_to_apply" | "invalid_args";
+export interface ProposalApplyPlan {
+    plan: CardConfirmPlan;
+    /** Server truth against `after`, one row per change (already-applied rows included, marked). */
+    diff: ProposalDiffRow[];
+    /** The proposal this plan was built for. */
+    proposal: CardProposal;
+}
+export type PlanProposalResult = ({
+    ok: true;
+} & ProposalApplyPlan) | {
+    ok: false;
+    reason: ApplyProposalFailure;
+    conflicts?: ProposalDiffRow[];
+    paths?: string[];
+};
+/**
+ * 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 declare function planProposalApply(proposal: CardProposal, catalog: AgentToolCatalog, fetchRecord: (kind: DetailKind, id: string) => Promise<unknown>, expected: Pick<CardDetail, "kind" | "id">): Promise<PlanProposalResult>;
+/** The subject a card is about: its `detail` pointer. Cards that carry an id of their own (offer, match) pass it explicitly. */
+export declare const subjectOf: (detail: CardDetail | undefined, fallback?: Pick<CardDetail, "kind" | "id">) => Pick<CardDetail, "kind" | "id"> | undefined;
+/**
+ * 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 declare function sanitizeCardForHost<T extends {
+    actions?: CardAction[];
+    proposal?: CardProposal;
+}>(card: T, catalog: AgentToolCatalog | undefined): T;
+export declare const ROLE_AGENT_CARD_TYPES: readonly ["OfferCard", "ProductCard", "OpportunityCard", "MatchCard", "DataTable"];
+export type RoleAgentCardType = (typeof ROLE_AGENT_CARD_TYPES)[number];
+/** The cards that are about ONE record. A `DataTable` is a list: it has no subject, and `readRoleCard` drops any pointer it carries. */
+type RecordCardType = Exclude<RoleAgentCardType, "DataTable">;
+/**
+ * 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 declare function detailAgrees(cardType: RecordCardType, data: {
+    detail?: CardDetail;
+    offerId?: string;
+    matchId?: string;
+}): boolean;
+type Subject = Pick<CardDetail, "kind" | "id">;
+export type RoleCardRead = {
+    cardType: "OfferCard";
+    data: OfferCardData;
+    subject: Subject;
+} | {
+    cardType: "MatchCard";
+    data: MatchCardData;
+    subject: Subject;
+} | {
+    cardType: "ProductCard";
+    data: ProductCardData;
+    subject: Subject | undefined;
+} | {
+    cardType: "OpportunityCard";
+    data: OpportunityCardData;
+    subject: Subject | undefined;
+} | {
+    cardType: "DataTable";
+    data: DataTableData;
+    subject: undefined;
+};
+/**
+ * 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 declare function readRoleCard(cardType: string, data: unknown, catalog: AgentToolCatalog | undefined): RoleCardRead | null;
+export {};
+//# sourceMappingURL=host-contract.d.ts.map

package/dist/agent/role-cards/host-contract.d.ts.map

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

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"}