@kitn.ai/ui 0.25.2 → 0.26.0

package/dist/schemas.js

@@ -1,114 +1,114 @@
-var R = Object.defineProperty;
-var P = (e, t, i) => t in e ? R(e, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : e[t] = i;
-var w = (e, t, i) => P(e, typeof t != "symbol" ? t + "" : t, i);
-const N = "https://json-schema.org/draft/2020-12/schema", _ = "https://kitn.ai/schemas/card/artifact.schema.json", D = "ArtifactCardData", z = "Generated-artifact viewer payload: a framed preview plus the source files behind it. A deliberately NARROW subset of the Artifact component's props — it says WHAT to show, never how the viewer behaves. Toolbar composition, view-state and the iframe `sandbox` are host-owned and stay off the wire, so a model cannot widen its own sandbox or hide the chrome the user needs to inspect what it built.", M = "object";
-const U = [{ required: ["src"] }, { required: ["files"] }], F = { src: { type: "string", format: "uri", description: "URL the preview iframe frames, and the target of the Home button. Omit for a source-only artifact (`tab: 'code'` with `files`).", "x-kai-format": "url" }, files: { type: "array", description: "Files behind the artifact: the Code tab's tree, each optionally carrying its own preview url and source.", maxItems: 500, items: { type: "object", required: ["path"], additionalProperties: !1, properties: { path: { type: "string", description: "Tree label/key. Folders are built from `/`-delimited segments.", maxLength: 1024 }, url: { type: "string", format: "uri", description: "Where the preview loads this file. Defaults to `path` resolved against `src`.", "x-kai-format": "url" }, code: { type: "string", description: "Source shown in the Code tab. Omit for binary files (image/pdf), which have no code view." }, language: { type: "string", description: "Language id for syntax highlighting (e.g. 'html', 'css', 'tsx').", maxLength: 40 }, type: { type: "string", enum: ["html", "pdf", "image", "other"], description: "File kind. Drives the tree icon and whether the Code view applies; 'pdf' also routes the preview to the inline PDF viewer.", "x-kai-control": "select" }, additions: { type: "integer", minimum: 0, description: "Lines added vs the base. Rendered as a trailing '+N' stat." }, deletions: { type: "integer", minimum: 0, description: "Lines removed vs the base. Rendered as a trailing '-N' stat." }, status: { type: "string", enum: ["added", "modified", "deleted", "renamed", "untracked"], description: "Change status vs the base. Drives a trailing status letter in the conventional VCS hue.", "x-kai-control": "select" } } } }, tab: { type: "string", enum: ["preview", "code"], default: "preview", description: "Which view the card OPENS on. SEED ONLY: the user can switch freely afterwards and a revision of this card will NOT move them back, because the user's choice wins over the model's. A switch is reported back as a `state` patch.", "x-kai-control": "select" }, activeFile: { type: "string", description: "Path of the file selected in the tree when the card FIRST renders (must match a `files[].path`). Seeds the tree highlight, the Code source and the preview. SEED ONLY, like `tab`: revising this card will not move a user who has since selected a different file.", maxLength: 1024 }, displayUrl: { type: "string", description: "Friendly address shown in the path field INSTEAD of the real url, which also makes the field read-only. Use when `src` is not consumer-facing (e.g. a `data:` blob) so a clean address is shown rather than leaking it.", maxLength: 2048 }, height: { description: "Frame height. A bare number is px; a string is any CSS length. Defaults to 420px. REQUIRED CONCEPT, not decoration: the viewer is built to fill its container, and a message thread supplies no height, so the card sets one explicitly or the artifact collapses to zero and renders invisible.", oneOf: [{ type: "number", minimum: 1 }, { type: "string", maxLength: 32 }] } }, J = {
-  $schema: N,
-  $id: _,
-  title: D,
-  description: z,
-  type: M,
+var z = Object.defineProperty;
+var M = (e, t, i) => t in e ? z(e, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : e[t] = i;
+var w = (e, t, i) => M(e, typeof t != "symbol" ? t + "" : t, i);
+const U = "https://json-schema.org/draft/2020-12/schema", F = "https://kitn.ai/schemas/card/artifact.schema.json", J = "ArtifactCardData", B = "Generated-artifact viewer payload: a framed preview plus the source files behind it. A deliberately NARROW subset of the Artifact component's props — it says WHAT to show, never how the viewer behaves. Toolbar composition, view-state and the iframe `sandbox` are host-owned and stay off the wire, so a model cannot widen its own sandbox or hide the chrome the user needs to inspect what it built.", Y = "object";
+const H = [{ required: ["src"] }, { required: ["files"] }], K = { src: { type: "string", format: "uri", description: "URL the preview iframe frames, and the target of the Home button. Omit for a source-only artifact (`tab: 'code'` with `files`).", "x-kai-format": "url" }, files: { type: "array", description: "Files behind the artifact: the Code tab's tree, each optionally carrying its own preview url and source.", maxItems: 500, items: { type: "object", required: ["path"], additionalProperties: !1, properties: { path: { type: "string", description: "Tree label/key. Folders are built from `/`-delimited segments.", maxLength: 1024 }, url: { type: "string", format: "uri", description: "Where the preview loads this file. Defaults to `path` resolved against `src`.", "x-kai-format": "url" }, code: { type: "string", description: "Source shown in the Code tab. Omit for binary files (image/pdf), which have no code view." }, language: { type: "string", description: "Language id for syntax highlighting (e.g. 'html', 'css', 'tsx').", maxLength: 40 }, type: { type: "string", enum: ["html", "pdf", "image", "other"], description: "File kind. Drives the tree icon and whether the Code view applies; 'pdf' also routes the preview to the inline PDF viewer.", "x-kai-control": "select" }, additions: { type: "integer", minimum: 0, description: "Lines added vs the base. Rendered as a trailing '+N' stat." }, deletions: { type: "integer", minimum: 0, description: "Lines removed vs the base. Rendered as a trailing '-N' stat." }, status: { type: "string", enum: ["added", "modified", "deleted", "renamed", "untracked"], description: "Change status vs the base. Drives a trailing status letter in the conventional VCS hue.", "x-kai-control": "select" } } } }, tab: { type: "string", enum: ["preview", "code"], default: "preview", description: "Which view the card OPENS on. SEED ONLY: the user can switch freely afterwards and a revision of this card will NOT move them back, because the user's choice wins over the model's. A switch is reported back as a `state` patch.", "x-kai-control": "select" }, activeFile: { type: "string", description: "Path of the file selected in the tree when the card FIRST renders (must match a `files[].path`). Seeds the tree highlight, the Code source and the preview. SEED ONLY, like `tab`: revising this card will not move a user who has since selected a different file.", maxLength: 1024 }, displayUrl: { type: "string", description: "Friendly address shown in the path field INSTEAD of the real url, which also makes the field read-only. Use when `src` is not consumer-facing (e.g. a `data:` blob) so a clean address is shown rather than leaking it.", maxLength: 2048 }, height: { description: "Frame height. A bare number is px; a string is any CSS length. Defaults to 420px. REQUIRED CONCEPT, not decoration: the viewer is built to fill its container, and a message thread supplies no height, so the card sets one explicitly or the artifact collapses to zero and renders invisible.", oneOf: [{ type: "number", minimum: 1 }, { type: "string", maxLength: 32 }] } }, W = {
+  $schema: U,
+  $id: F,
+  title: J,
+  description: B,
+  type: Y,
   additionalProperties: !1,
-  anyOf: U,
-  properties: F
-}, Y = "https://json-schema.org/draft/2020-12/schema", B = "https://kitn.ai/schemas/card/card-envelope.schema.json", H = "CardEnvelope", K = "A card the agent/server asks the chat to render. `data` validates against the per-type schema.", W = "object", V = ["type", "id", "data"], G = { type: { type: "string", minLength: 1 }, id: { type: "string", minLength: 1 }, data: {}, title: { type: "string" } }, Q = {
-  $schema: Y,
-  $id: B,
-  title: H,
-  description: K,
-  type: W,
-  required: V,
-  properties: G
-}, X = "https://json-schema.org/draft/2020-12/schema", Z = "https://kitn.ai/schemas/card/card-event.schema.json", ee = "CardEvent", te = "An event a card emits up to the host. `kind` discriminates the payload.", ie = "object", ne = ["kind"], se = { kind: { enum: ["ready", "submit", "action", "send-prompt", "open", "resize", "state", "dismiss", "error"] }, cardId: { type: "string" } }, oe = {
-  $schema: X,
-  $id: Z,
-  title: ee,
-  description: te,
-  type: ie,
-  required: ne,
-  properties: se
-}, re = "https://json-schema.org/draft/2020-12/schema", ae = "https://kitn.ai/schemas/card/choice.schema.json", pe = "ChoiceCardData", de = "Data payload for a `choice` card (CardEnvelope.data when type='choice'). A single-select 'pick one of N rich options' card; activating an option emits the `action` verb.", ce = "object", ue = ["options"], le = { prompt: { type: "string", description: "Optional question/body text rendered above the options. Distinct from CardEnvelope.title (the card chrome heading)." }, submitLabel: { type: "string", description: "Label for the Submit button; default 'Submit'." }, options: { type: "array", minItems: 1, description: "The selectable options, rendered in order. Exactly one can be chosen.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Emitted as CardEvent.action. Must be unique within `options`. (The reserved id '__other__' is used by the allowOther escape.)", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Visible option label." }, description: { type: "string", description: "Optional secondary line under the label." }, media: { type: "object", description: "Optional leading media: an image URL or a named icon.", properties: { image: { type: "string", description: "Image URL rendered as a leading thumbnail in the row." }, imageAlt: { type: "string", description: "Accessible alt text for `image` (decorative if omitted)." }, icon: { type: "string", description: "Named icon rendered as a leading glyph." } } }, meta: { type: "string", description: "Trailing freeform text (e.g. a price or badge), right-aligned in the row." }, recommended: { type: "boolean", default: !1, description: "Renders a small 'Recommended' pill near the label." }, disabled: { type: "boolean", default: !1, description: "Option is shown but not selectable, and skipped in keyboard nav." }, payload: { description: "Optional opaque payload echoed back in CardEvent.payload (any JSON)." } } } }, allowOther: { description: "Optional free-text escape ('none of these / specify'). `true` appends a final 'Other…' option; an object customizes its `label`/`placeholder`. Selecting it reveals a text input; the shared Submit button then emits `{ kind:'action', action:'__other__', payload:{ text } }`.", "x-kai-control": "allow-other" }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb. The card collapses to a re-openable 'dismissed' stub; the host decides via `onReopen` whether it comes back live or `expired`." } }, me = {
-  $schema: re,
-  $id: ae,
-  title: pe,
-  description: de,
-  type: ce,
-  required: ue,
-  properties: le
-}, he = "https://json-schema.org/draft/2020-12/schema", ye = "https://kitn.ai/schemas/card/confirm.schema.json", fe = "ConfirmCardData", ge = "Data payload for a `confirm` card (CardEnvelope.data when type='confirm').", be = "object", $e = ["actions"], ve = { heading: { type: "string", description: "Optional in-body heading. Distinct from CardEnvelope.title (the card chrome title)." }, body: { type: "string", description: "Body text. Plain text in v1 (rendered safely; no HTML injection)." }, tone: { type: "string", enum: ["default", "warning", "danger"], default: "default", description: "Overall card tone; 'danger' adds a warning icon + accent for destructive approvals.", "x-kai-control": "tone" }, actions: { type: "array", minItems: 1, maxItems: 4, description: "The choice set. Rendered as buttons in order; max 4 keeps it a decision, not a menu.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Emitted as CardEvent.action. Must be unique within `actions`.", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Visible button label." }, style: { type: "string", enum: ["primary", "default", "destructive"], default: "default", description: "Button emphasis. 'destructive' = red/danger; 'primary' = filled accent.", "x-kai-control": "button-style" }, payload: { description: "Optional opaque payload echoed back in CardEvent.payload (any JSON)." }, default: { type: "boolean", default: !1, description: "If true, this action is the keyboard default (Enter) and gets initial focus. At most one should be true; the card uses the first if several are.", "x-kai-default-action": !0 } } } }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb." } }, we = {
-  $schema: he,
-  $id: ye,
-  title: fe,
-  description: ge,
-  type: be,
-  required: $e,
-  properties: ve
-}, xe = "https://json-schema.org/draft/2020-12/schema", ke = "https://kitn.ai/schemas/card/embed.schema.json", Oe = "EmbedCardData", je = "Lazy media-embed payload (YouTube / Vimeo / generic player URL).", Se = "object", Ae = ["provider"], Ie = !1, qe = { provider: { type: "string", enum: ["youtube", "vimeo", "generic"], description: "Media provider. 'generic' frames `url` directly (must be an https embeddable player URL whose origin is app-allowlisted).", "x-kai-control": "select" }, id: { type: "string", description: "Provider video id (required for youtube/vimeo when `url` is absent). e.g. 'dQw4w9WgXcQ'.", maxLength: 64, pattern: "^[A-Za-z0-9_-]+$" }, url: { type: "string", format: "uri", description: "Full media/watch URL. For youtube/vimeo it is parsed to an id; for 'generic' it is the embeddable player src (https only).", "x-kai-format": "url" }, title: { type: "string", description: "Accessible title for the player iframe + the poster label. Strongly recommended for a11y.", maxLength: 300 }, poster: { type: "string", format: "uri", description: "Thumbnail shown before play. When omitted, youtube/vimeo derive a default thumbnail; 'generic' shows a neutral play placeholder.", "x-kai-format": "url" }, start: { type: "integer", minimum: 0, description: "Optional start offset in seconds.", "x-kai-unit": "seconds" }, aspectRatio: { type: "string", enum: ["16:9", "4:3", "1:1", "9:16"], default: "16:9", description: "Player box aspect ratio (CSS aspect-ratio).", "x-kai-control": "select" } }, Le = [{ if: { properties: { provider: { const: "generic" } } }, then: { required: ["url"] } }, { if: { properties: { provider: { enum: ["youtube", "vimeo"] } } }, then: { anyOf: [{ required: ["id"] }, { required: ["url"] }] } }], Ce = {
-  $schema: xe,
-  $id: ke,
-  title: Oe,
-  description: je,
-  type: Se,
-  required: Ae,
-  additionalProperties: Ie,
-  properties: qe,
-  allOf: Le
-}, Ee = "https://json-schema.org/draft/2020-12/schema", Te = "https://kitn.ai/schemas/card/form.result.schema.json", Re = "kai-form submit payload", Pe = "The CardEvent {kind:'submit'} `data` for a form card: an object that validates against the form-definition schema that was sent down in CardEnvelope.data. Standard JSON Schema validation (type/enum/required/min-max/length/pattern) holds. Optional empty strings are omitted.", Ne = "object", _e = {
-  $schema: Ee,
-  $id: Te,
-  title: Re,
-  description: Pe,
-  type: Ne
-}, De = "https://json-schema.org/draft/2020-12/schema", ze = "https://kitn.ai/schemas/card/form.schema.json", Me = "kai-form data (a form definition)", Ue = "The CardEnvelope.data for a card of type 'form': a JSON Schema (type:'object') describing the fields kai-form renders, plus optional x-kai-* UI hints. The same schema validates the submission.", Fe = "object", Je = ["type", "properties"], Ye = { type: { const: "object" }, title: { type: "string" }, description: { type: "string" }, required: { type: "array", items: { type: "string" } }, properties: { type: "object" }, "x-kai-order": { type: "array", items: { type: "string" } }, "x-kai-inlineMax": { type: "integer", minimum: 1 }, "x-kai-submitLabel": { type: "string" }, "x-kai-dismissible": { type: "boolean" }, "x-kai-actions": { type: "array", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string" }, label: { type: "string" }, variant: { enum: ["default", "ghost", "outline"] } } } } }, Be = {
-  $schema: De,
-  $id: ze,
-  title: Me,
-  description: Ue,
-  type: Fe,
-  required: Je,
-  properties: Ye
-}, He = "https://json-schema.org/draft/2020-12/schema", Ke = "https://kitn.ai/schemas/card/link.schema.json", We = "LinkPreviewData", Ve = "Rich link / Open-Graph preview payload. The card renders from this; it never fetches.", Ge = "object", Qe = ["url"], Xe = !1, Ze = { url: { type: "string", format: "uri", description: "Canonical destination. Opened via the contract `open` verb (target 'tab').", "x-kai-format": "url" }, title: { type: "string", description: "OG title (og:title). Falls back to the domain when absent.", maxLength: 300 }, description: { type: "string", description: "OG description (og:description). Clamped to 3 lines in the UI.", maxLength: 1e3 }, image: { type: "string", format: "uri", description: "Preview image (og:image). Optional; the card degrades gracefully when missing or it fails to load.", "x-kai-format": "url" }, imageAlt: { type: "string", description: "Alt text for the preview image. Defaults to the title (or empty = decorative) when omitted.", maxLength: 300 }, favicon: { type: "string", format: "uri", description: "Site favicon shown next to the domain.", "x-kai-format": "url" }, domain: { type: "string", description: "Display domain (e.g. 'example.com'). Derived from `url` when omitted.", maxLength: 253 }, siteName: { type: "string", description: "OG site name (og:site_name). Shown in place of the domain when present.", maxLength: 200 } }, et = {
-  $schema: He,
-  $id: Ke,
-  title: We,
-  description: Ve,
-  type: Ge,
-  required: Qe,
-  additionalProperties: Xe,
-  properties: Ze
-}, tt = "https://json-schema.org/draft/2020-12/schema", it = "https://kitn.ai/schemas/card/tasks.result.schema.json", nt = "TasksCardResult", st = "Payload of CardEvent { kind: 'submit' } from a tasks card.", ot = "object", rt = ["selected"], at = { selected: { type: "array", description: "Ids of the checked tasks, in the order they appear in `tasks`. Subset of the input task ids.", items: { type: "string", minLength: 1 }, uniqueItems: !0 } }, pt = {
-  $schema: tt,
-  $id: it,
-  title: nt,
-  description: st,
-  type: ot,
-  required: rt,
-  properties: at
-}, dt = "https://json-schema.org/draft/2020-12/schema", ct = "https://kitn.ai/schemas/card/tasks.schema.json", ut = "TasksCardData", lt = "Data payload for a `tasks` card (CardEnvelope.data when type='tasks').", mt = "object", ht = ["tasks"], yt = { mode: { type: "string", enum: ["select", "progress"], default: "select", description: "'select' (default) = toggle + a confirm button that emits `submit`. 'progress' = an onboarding-checklist look (header `done / total` count, circular indicators, per-item title/description, no confirm button, where checking a row IS the action). Both share the selection model.", "x-kai-mode": !0 }, heading: { type: "string", description: "Optional in-body heading; distinct from CardEnvelope.title." }, tasks: { type: "array", minItems: 1, description: "The selectable rows, rendered in order.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Stable id; the selected ids are returned in the result. Unique within `tasks`.", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Row label." }, description: { type: "string", description: "Optional secondary line under the label." }, checked: { type: "boolean", default: !1, description: "Initial checked state of the row." }, disabled: { type: "boolean", default: !1, description: "Row is shown but not toggleable (and excluded from select-all)." } } } }, selectAll: { type: "boolean", default: !1, description: "Render a master select-all checkbox above the list.", "x-kai-control": "select-all" }, confirmLabel: { type: "string", default: "Confirm", description: "Label for the confirm button." }, allowEmpty: { type: "boolean", default: !1, description: "If true, confirm is enabled with zero selected (emits { selected: [] }). If false, confirm is disabled until >=1 selected." }, min: { type: "integer", minimum: 0, description: "Optional minimum number that must be selected to confirm.", "x-kai-select-min": !0 }, max: { type: "integer", minimum: 1, description: "Optional maximum selectable; further toggles are blocked once reached.", "x-kai-select-max": !0 }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb. The card collapses to a re-openable 'dismissed' stub; the host decides via `onReopen` whether it comes back live or `expired`." } }, ft = {
-  $schema: dt,
-  $id: ct,
-  title: ut,
-  description: lt,
-  type: mt,
-  required: ht,
-  properties: yt
+  anyOf: H,
+  properties: K
+}, V = "https://json-schema.org/draft/2020-12/schema", G = "https://kitn.ai/schemas/card/card-envelope.schema.json", X = "CardEnvelope", Q = "A card the agent/server asks the chat to render. `data` validates against the per-type schema.", Z = "object", ee = ["type", "id", "data"], te = { type: { type: "string", minLength: 1 }, id: { type: "string", minLength: 1 }, data: {}, title: { type: "string" } }, ie = {
+  $schema: V,
+  $id: G,
+  title: X,
+  description: Q,
+  type: Z,
+  required: ee,
+  properties: te
+}, ne = "https://json-schema.org/draft/2020-12/schema", oe = "https://kitn.ai/schemas/card/card-event.schema.json", re = "CardEvent", se = "An event a card emits up to the host. `kind` discriminates the payload.", ae = "object", pe = ["kind"], de = { kind: { enum: ["ready", "submit", "action", "send-prompt", "open", "resize", "state", "dismiss", "error"] }, cardId: { type: "string" } }, ce = {
+  $schema: ne,
+  $id: oe,
+  title: re,
+  description: se,
+  type: ae,
+  required: pe,
+  properties: de
+}, ue = "https://json-schema.org/draft/2020-12/schema", le = "https://kitn.ai/schemas/card/choice.schema.json", me = "ChoiceCardData", he = "Data payload for a `choice` card (CardEnvelope.data when type='choice'). A single-select 'pick one of N rich options' card; activating an option emits the `action` verb.", fe = "object", ye = ["options"], ge = { prompt: { type: "string", description: "Optional question/body text rendered above the options. Distinct from CardEnvelope.title (the card chrome heading)." }, submitLabel: { type: "string", description: "Label for the Submit button; default 'Submit'." }, options: { type: "array", minItems: 1, description: "The selectable options, rendered in order. Exactly one can be chosen.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Emitted as CardEvent.action. Must be unique within `options`. (The reserved id '__other__' is used by the allowOther escape.)", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Visible option label." }, description: { type: "string", description: "Optional secondary line under the label." }, media: { type: "object", description: "Optional leading media: an image URL or a named icon.", properties: { image: { type: "string", description: "Image URL rendered as a leading thumbnail in the row." }, imageAlt: { type: "string", description: "Accessible alt text for `image` (decorative if omitted)." }, icon: { type: "string", description: "Named icon rendered as a leading glyph." } } }, meta: { type: "string", description: "Trailing freeform text (e.g. a price or badge), right-aligned in the row." }, recommended: { type: "boolean", default: !1, description: "Renders a small 'Recommended' pill near the label." }, disabled: { type: "boolean", default: !1, description: "Option is shown but not selectable, and skipped in keyboard nav." }, payload: { description: "Optional opaque payload echoed back in CardEvent.payload (any JSON)." } } } }, allowOther: { description: "Optional free-text escape ('none of these / specify'). `true` appends a final 'Other…' option; an object customizes its `label`/`placeholder`. Selecting it reveals a text input; the shared Submit button then emits `{ kind:'action', action:'__other__', payload:{ text } }`.", "x-kai-control": "allow-other" }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb. The card collapses to a re-openable 'dismissed' stub; the host decides via `onReopen` whether it comes back live or `expired`." } }, be = {
+  $schema: ue,
+  $id: le,
+  title: me,
+  description: he,
+  type: fe,
+  required: ye,
+  properties: ge
+}, ve = "https://json-schema.org/draft/2020-12/schema", $e = "https://kitn.ai/schemas/card/confirm.schema.json", we = "ConfirmCardData", xe = "Data payload for a `confirm` card (CardEnvelope.data when type='confirm').", ke = "object", Oe = ["actions"], je = { heading: { type: "string", description: "Optional in-body heading. Distinct from CardEnvelope.title (the card chrome title)." }, body: { type: "string", description: "Body text. Plain text in v1 (rendered safely; no HTML injection)." }, tone: { type: "string", enum: ["default", "warning", "danger"], default: "default", description: "Overall card tone; 'danger' adds a warning icon + accent for destructive approvals.", "x-kai-control": "tone" }, actions: { type: "array", minItems: 1, maxItems: 4, description: "The choice set. Rendered as buttons in order; max 4 keeps it a decision, not a menu.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Emitted as CardEvent.action. Must be unique within `actions`.", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Visible button label." }, style: { type: "string", enum: ["primary", "default", "destructive"], default: "default", description: "Button emphasis. 'destructive' = red/danger; 'primary' = filled accent.", "x-kai-control": "button-style" }, payload: { description: "Optional opaque payload echoed back in CardEvent.payload (any JSON)." }, default: { type: "boolean", default: !1, description: "If true, this action is the keyboard default (Enter) and gets initial focus. At most one should be true; the card uses the first if several are.", "x-kai-default-action": !0 } } } }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb." } }, Se = {
+  $schema: ve,
+  $id: $e,
+  title: we,
+  description: xe,
+  type: ke,
+  required: Oe,
+  properties: je
+}, Ae = "https://json-schema.org/draft/2020-12/schema", qe = "https://kitn.ai/schemas/card/embed.schema.json", Ie = "EmbedCardData", Le = "Lazy media-embed payload (YouTube / Vimeo / generic player URL).", Ee = "object", Te = ["provider"], Ce = !1, Re = { provider: { type: "string", enum: ["youtube", "vimeo", "generic"], description: "Media provider. 'generic' frames `url` directly (must be an https embeddable player URL whose origin is app-allowlisted).", "x-kai-control": "select" }, id: { type: "string", description: "Provider video id (required for youtube/vimeo when `url` is absent). e.g. 'dQw4w9WgXcQ'.", maxLength: 64, pattern: "^[A-Za-z0-9_-]+$" }, url: { type: "string", format: "uri", description: "Full media/watch URL. For youtube/vimeo it is parsed to an id; for 'generic' it is the embeddable player src (https only).", "x-kai-format": "url" }, title: { type: "string", description: "Accessible title for the player iframe + the poster label. Strongly recommended for a11y.", maxLength: 300 }, poster: { type: "string", format: "uri", description: "Thumbnail shown before play. When omitted, youtube/vimeo derive a default thumbnail; 'generic' shows a neutral play placeholder.", "x-kai-format": "url" }, start: { type: "integer", minimum: 0, description: "Optional start offset in seconds.", "x-kai-unit": "seconds" }, aspectRatio: { type: "string", enum: ["16:9", "4:3", "1:1", "9:16"], default: "16:9", description: "Player box aspect ratio (CSS aspect-ratio).", "x-kai-control": "select" } }, Ne = [{ if: { properties: { provider: { const: "generic" } } }, then: { required: ["url"] } }, { if: { properties: { provider: { enum: ["youtube", "vimeo"] } } }, then: { anyOf: [{ required: ["id"] }, { required: ["url"] }] } }], Pe = {
+  $schema: Ae,
+  $id: qe,
+  title: Ie,
+  description: Le,
+  type: Ee,
+  required: Te,
+  additionalProperties: Ce,
+  properties: Re,
+  allOf: Ne
+}, _e = "https://json-schema.org/draft/2020-12/schema", De = "https://kitn.ai/schemas/card/form.result.schema.json", ze = "kai-form submit payload", Me = "The CardEvent {kind:'submit'} `data` for a form card: an object that validates against the form-definition schema that was sent down in CardEnvelope.data. Standard JSON Schema validation (type/enum/required/min-max/length/pattern) holds. Optional empty strings are omitted.", Ue = "object", Fe = {
+  $schema: _e,
+  $id: De,
+  title: ze,
+  description: Me,
+  type: Ue
+}, Je = "https://json-schema.org/draft/2020-12/schema", Be = "https://kitn.ai/schemas/card/form.schema.json", Ye = "kai-form data (a form definition)", He = "The CardEnvelope.data for a card of type 'form': a JSON Schema (type:'object') describing the fields kai-form renders, plus optional x-kai-* UI hints. The same schema validates the submission.", Ke = "object", We = ["type", "properties"], Ve = { type: { const: "object" }, title: { type: "string" }, description: { type: "string" }, required: { type: "array", items: { type: "string" } }, properties: { type: "object" }, "x-kai-order": { type: "array", items: { type: "string" } }, "x-kai-inlineMax": { type: "integer", minimum: 1 }, "x-kai-submitLabel": { type: "string" }, "x-kai-dismissible": { type: "boolean" }, "x-kai-actions": { type: "array", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string" }, label: { type: "string" }, variant: { enum: ["default", "ghost", "outline"] } } } } }, Ge = {
+  $schema: Je,
+  $id: Be,
+  title: Ye,
+  description: He,
+  type: Ke,
+  required: We,
+  properties: Ve
+}, Xe = "https://json-schema.org/draft/2020-12/schema", Qe = "https://kitn.ai/schemas/card/link.schema.json", Ze = "LinkPreviewData", et = "Rich link / Open-Graph preview payload. The card renders from this; it never fetches.", tt = "object", it = ["url"], nt = !1, ot = { url: { type: "string", format: "uri", description: "Canonical destination. Opened via the contract `open` verb (target 'tab').", "x-kai-format": "url" }, title: { type: "string", description: "OG title (og:title). Falls back to the domain when absent.", maxLength: 300 }, description: { type: "string", description: "OG description (og:description). Clamped to 3 lines in the UI.", maxLength: 1e3 }, image: { type: "string", format: "uri", description: "Preview image (og:image). Optional; the card degrades gracefully when missing or it fails to load.", "x-kai-format": "url" }, imageAlt: { type: "string", description: "Alt text for the preview image. Defaults to the title (or empty = decorative) when omitted.", maxLength: 300 }, favicon: { type: "string", format: "uri", description: "Site favicon shown next to the domain.", "x-kai-format": "url" }, domain: { type: "string", description: "Display domain (e.g. 'example.com'). Derived from `url` when omitted.", maxLength: 253 }, siteName: { type: "string", description: "OG site name (og:site_name). Shown in place of the domain when present.", maxLength: 200 } }, rt = {
+  $schema: Xe,
+  $id: Qe,
+  title: Ze,
+  description: et,
+  type: tt,
+  required: it,
+  additionalProperties: nt,
+  properties: ot
+}, st = "https://json-schema.org/draft/2020-12/schema", at = "https://kitn.ai/schemas/card/tasks.result.schema.json", pt = "TasksCardResult", dt = "Payload of CardEvent { kind: 'submit' } from a tasks card.", ct = "object", ut = ["selected"], lt = { selected: { type: "array", description: "Ids of the checked tasks, in the order they appear in `tasks`. Subset of the input task ids.", items: { type: "string", minLength: 1 }, uniqueItems: !0 } }, mt = {
+  $schema: st,
+  $id: at,
+  title: pt,
+  description: dt,
+  type: ct,
+  required: ut,
+  properties: lt
+}, ht = "https://json-schema.org/draft/2020-12/schema", ft = "https://kitn.ai/schemas/card/tasks.schema.json", yt = "TasksCardData", gt = "Data payload for a `tasks` card (CardEnvelope.data when type='tasks').", bt = "object", vt = ["tasks"], $t = { mode: { type: "string", enum: ["select", "progress"], default: "select", description: "'select' (default) = toggle + a confirm button that emits `submit`. 'progress' = an onboarding-checklist look (header `done / total` count, circular indicators, per-item title/description, no confirm button, where checking a row IS the action). Both share the selection model.", "x-kai-mode": !0 }, heading: { type: "string", description: "Optional in-body heading; distinct from CardEnvelope.title." }, tasks: { type: "array", minItems: 1, description: "The selectable rows, rendered in order.", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1, description: "Stable id; the selected ids are returned in the result. Unique within `tasks`.", "x-kai-unique": !0 }, label: { type: "string", minLength: 1, description: "Row label." }, description: { type: "string", description: "Optional secondary line under the label." }, checked: { type: "boolean", default: !1, description: "Initial checked state of the row." }, disabled: { type: "boolean", default: !1, description: "Row is shown but not toggleable (and excluded from select-all)." } } } }, selectAll: { type: "boolean", default: !1, description: "Render a master select-all checkbox above the list.", "x-kai-control": "select-all" }, confirmLabel: { type: "string", default: "Confirm", description: "Label for the confirm button." }, allowEmpty: { type: "boolean", default: !1, description: "If true, confirm is enabled with zero selected (emits { selected: [] }). If false, confirm is disabled until >=1 selected." }, min: { type: "integer", minimum: 0, description: "Optional minimum number that must be selected to confirm.", "x-kai-select-min": !0 }, max: { type: "integer", minimum: 1, description: "Optional maximum selectable; further toggles are blocked once reached.", "x-kai-select-max": !0 }, dismissible: { type: "boolean", default: !1, description: "Show a close affordance that emits the `dismiss` verb. The card collapses to a re-openable 'dismissed' stub; the host decides via `onReopen` whether it comes back live or `expired`." } }, wt = {
+  $schema: ht,
+  $id: ft,
+  title: yt,
+  description: gt,
+  type: bt,
+  required: vt,
+  properties: $t
 }, S = "kai_";
-function q(e) {
+function C(e) {
   if (!e.startsWith(S)) return null;
   const t = e.slice(S.length);
   return t.length > 0 ? t : null;
 }
-function gt(e) {
+function R(e) {
   return `${S}${e}`;
 }
-function Ht(e) {
-  return q(e) !== null;
+function oi(e) {
+  return C(e) !== null;
 }
-function Kt(e, t, i) {
-  const s = q(e);
-  return s === null ? null : { type: s, id: i.id, data: t === void 0 ? {} : t };
+function ri(e, t, i) {
+  const n = C(e);
+  return n === null ? null : { type: n, id: i.id, data: t === void 0 ? {} : t };
 }
-const L = (e) => Object.freeze(e), C = Object.freeze({
+const N = (e) => Object.freeze(e), P = Object.freeze({
   id: "openai",
   label: "OpenAI strict",
   source: "https://developers.openai.com/api/docs/guides/structured-outputs",
@@ -117,7 +117,7 @@ const L = (e) => Object.freeze(e), C = Object.freeze({
   requireAllPropertiesRequired: !0,
   allowRootAnyOf: !1,
   allowRecursion: !0,
-  keywords: L({
+  keywords: N({
     // core
     type: { status: "supported", note: "String, Number, Boolean, Integer, Object, Array are the supported types" },
     properties: { status: "supported", note: "objects are a supported type" },
@@ -196,7 +196,7 @@ const L = (e) => Object.freeze(e), C = Object.freeze({
     dependentRequired: { status: "unsupported", note: "explicitly listed as not supported under Composition" },
     dependentSchemas: { status: "unsupported", note: "explicitly listed as not supported under Composition" }
   })
-}), E = Object.freeze({
+}), _ = Object.freeze({
   id: "anthropic",
   label: "Anthropic strict",
   source: "https://platform.claude.com/docs/en/build-with-claude/structured-outputs#json-schema-limitations",
@@ -206,7 +206,7 @@ const L = (e) => Object.freeze(e), C = Object.freeze({
   requireAllPropertiesRequired: !1,
   allowRootAnyOf: !0,
   allowRecursion: !1,
-  keywords: L({
+  keywords: N({
     // core
     type: { status: "supported", note: "all basic types: object, array, string, integer, number, boolean, null" },
     properties: { status: "supported", note: "objects are a supported type" },
@@ -286,93 +286,93 @@ const L = (e) => Object.freeze(e), C = Object.freeze({
     dependentRequired: { status: "unsupported", note: "not in the supported list" },
     dependentSchemas: { status: "unsupported", note: "not in the supported list" }
   })
-}), Wt = Object.freeze({
-  openai: C,
-  anthropic: E
-}), bt = ["items", "if", "then", "else", "not", "contains", "propertyNames", "unevaluatedItems", "additionalItems"], $t = ["properties", "patternProperties", "$defs", "definitions", "dependentSchemas"], vt = ["allOf", "anyOf", "oneOf", "prefixItems"], O = (e) => typeof e == "object" && e !== null && !Array.isArray(e);
-function wt(e, t) {
+}), si = Object.freeze({
+  openai: P,
+  anthropic: _
+}), xt = ["items", "if", "then", "else", "not", "contains", "propertyNames", "unevaluatedItems", "additionalItems"], kt = ["properties", "patternProperties", "$defs", "definitions", "dependentSchemas"], Ot = ["allOf", "anyOf", "oneOf", "prefixItems"], O = (e) => typeof e == "object" && e !== null && !Array.isArray(e);
+function jt(e, t) {
   return e === "(root)" ? t : `${e}.${t}`;
 }
-function xt(e, t) {
+function St(e, t) {
   const i = [];
   return x(e, t, "(root)", !0, i), i;
 }
-function x(e, t, i, s, a) {
+function x(e, t, i, n, r) {
   if (typeof e == "boolean") return;
   if (!O(e)) {
-    a.push({ path: i, keyword: "(schema)", reason: `expected a schema object, got ${e === null ? "null" : typeof e}` });
+    r.push({ path: i, keyword: "(schema)", reason: `expected a schema object, got ${e === null ? "null" : typeof e}` });
     return;
   }
   for (const [p, c] of Object.entries(e)) {
-    const u = t.keywords[p];
-    if (!u) {
-      a.push({
+    const l = t.keywords[p];
+    if (!l) {
+      r.push({
         path: i,
         keyword: p,
         reason: p.startsWith("x-") ? `vendor extension keyword, not in the ${t.label} subset` : `unknown keyword, not classified by the ${t.label} subset`
       });
       continue;
     }
-    if (u.status === "unsupported") {
-      a.push({ path: i, keyword: p, reason: `not supported (${u.note})` });
+    if (l.status === "unsupported") {
+      r.push({ path: i, keyword: p, reason: `not supported (${l.note})` });
       continue;
     }
-    if (u.status === "supported" && u.value) {
-      const h = u.value(c);
-      h && a.push({ path: i, keyword: p, reason: h });
+    if (l.status === "supported" && l.value) {
+      const h = l.value(c);
+      h && r.push({ path: i, keyword: p, reason: h });
     }
   }
-  const n = O(e.properties), r = e.type === "object" || n;
-  if (r && t.requireAdditionalPropertiesFalse && e.additionalProperties !== !1 && a.push({
+  const o = O(e.properties), a = e.type === "object" || o;
+  if (a && t.requireAdditionalPropertiesFalse && e.additionalProperties !== !1 && r.push({
     path: i,
     keyword: "additionalProperties",
     reason: `missing; ${t.label} requires \`additionalProperties: false\` on every object`
-  }), r && !n && a.push({
+  }), a && !o && r.push({
     path: i,
     keyword: "properties",
     reason: `a free-form object (\`type: "object"\` with no \`properties\`) has no grammar under ${t.label}; with the mandatory \`additionalProperties: false\` it can only ever be \`{}\`, which is not what the schema means`
-  }), r && t.requireAllPropertiesRequired && n) {
-    const p = Array.isArray(e.required) ? e.required.map(String) : [], c = Object.keys(e.properties).filter((u) => !p.includes(u));
-    c.length > 0 && a.push({
+  }), a && t.requireAllPropertiesRequired && o) {
+    const p = Array.isArray(e.required) ? e.required.map(String) : [], c = Object.keys(e.properties).filter((l) => !p.includes(l));
+    c.length > 0 && r.push({
       path: i,
       keyword: "required",
-      reason: `${t.label} requires every property in \`required\`; missing ${c.map((u) => `\`${u}\``).join(", ")} (emulate optional with a \`null\` union)`
+      reason: `${t.label} requires every property in \`required\`; missing ${c.map((l) => `\`${l}\``).join(", ")} (emulate optional with a \`null\` union)`
     });
   }
-  s && !t.allowRootAnyOf && "anyOf" in e && a.push({
+  n && !t.allowRootAnyOf && "anyOf" in e && r.push({
     path: i,
     keyword: "anyOf",
     reason: `${t.label} forbids \`anyOf\` at the ROOT ("Root level object of a schema must be an object, and not use anyOf")`
   }), Object.keys(e).filter((p) => {
     var c;
     return ((c = t.keywords[p]) == null ? void 0 : c.status) !== "annotation";
-  }).length === 0 && a.push({
+  }).length === 0 && r.push({
     path: i,
     keyword: "type",
     reason: `unconstrained subschema (annotations only); ${t.label} compiles the schema to a grammar and has no way to express "any JSON". Give it a \`type\``
   });
-  const m = (p) => {
+  const u = (p) => {
     var c;
     return ((c = t.keywords[p]) == null ? void 0 : c.status) === "unsupported";
   };
-  for (const p of $t) {
+  for (const p of kt) {
     const c = e[p];
-    if (!(!O(c) || m(p)))
-      for (const [u, h] of Object.entries(c))
-        x(h, t, p === "properties" ? wt(i, u) : `${i}/${p}[${u}]`, !1, a);
+    if (!(!O(c) || u(p)))
+      for (const [l, h] of Object.entries(c))
+        x(h, t, p === "properties" ? jt(i, l) : `${i}/${p}[${l}]`, !1, r);
   }
-  for (const p of bt) {
-    if (!(p in e) || m(p)) continue;
+  for (const p of xt) {
+    if (!(p in e) || u(p)) continue;
     const c = e[p];
-    typeof c != "boolean" && x(c, t, p === "items" ? `${i === "(root)" ? "(root)" : i}[]` : `${i}/${p}`, !1, a);
+    typeof c != "boolean" && x(c, t, p === "items" ? `${i === "(root)" ? "(root)" : i}[]` : `${i}/${p}`, !1, r);
   }
-  O(e.additionalProperties) && x(e.additionalProperties, t, `${i}/additionalProperties`, !1, a);
-  for (const p of vt) {
+  O(e.additionalProperties) && x(e.additionalProperties, t, `${i}/additionalProperties`, !1, r);
+  for (const p of Ot) {
     const c = e[p];
-    !Array.isArray(c) || m(p) || c.forEach((u, h) => x(u, t, `${i}/${p}[${h}]`, !1, a));
+    !Array.isArray(c) || u(p) || c.forEach((l, h) => x(l, t, `${i}/${p}[${h}]`, !1, r));
   }
 }
-const kt = Object.freeze({
+const At = Object.freeze({
   confirm: "Show the user an approval card and wait for their decision before you act. Use this whenever you are about to do something consequential, destructive or irreversible.",
   choice: "Ask the user to pick exactly one option from a list of rich choices. Use this instead of asking in prose when the options are known and finite.",
   tasks: "Show the user a checklist they can tick, either to select several items for you to act on or to track progress through a sequence of steps.",
@@ -381,137 +381,230 @@ const kt = Object.freeze({
   embed: "Embed a video player (YouTube, Vimeo, or a direct player URL) inline in the conversation.",
   artifact: "Show something you built (a page, an app, a set of files) in a framed preview with its source alongside, so the user can look at both."
 });
-class Ot extends Error {
-  constructor(i, s) {
-    super(jt(i, s));
+class qt extends Error {
+  constructor(i, n) {
+    super(It(i, n));
     w(this, "name", "UnsupportedCardToolSchemaError");
     w(this, "provider");
     w(this, "source");
     w(this, "cards");
-    this.provider = i.id, this.source = i.source, this.cards = s;
+    this.provider = i.id, this.source = i.source, this.cards = n;
   }
   /** Every distinct keyword named across every failing card, deduped, in order. */
   get keywords() {
     const i = /* @__PURE__ */ new Set();
-    for (const s of this.cards) for (const a of s.violations) i.add(a.keyword);
+    for (const n of this.cards) for (const r of n.violations) i.add(r.keyword);
     return [...i];
   }
 }
-function jt(e, t) {
-  const i = [], s = t.length === 1 ? "card type" : "card types";
-  i.push(`${t.length} ${s} cannot be a STRICT tool definition under ${e.label}:`);
-  for (const a of t) {
-    i.push(""), i.push(`  ${a.toolName} (card type "${a.cardType}") — ${a.violations.length} problem(s):`);
-    for (const n of a.violations)
-      i.push(`    ${n.path}: \`${n.keyword}\` — ${n.reason}`);
+function It(e, t) {
+  const i = [], n = t.length === 1 ? "card type" : "card types";
+  i.push(`${t.length} ${n} cannot be a STRICT tool definition under ${e.label}:`);
+  for (const r of t) {
+    i.push(""), i.push(`  ${r.toolName} (card type "${r.cardType}") — ${r.violations.length} problem(s):`);
+    for (const o of r.violations)
+      i.push(`    ${o.path}: \`${o.keyword}\` — ${o.reason}`);
   }
   return i.push(""), i.push(`  subset source: ${e.source} (read ${e.checkedOn})`), i.push(
-    "  Fix: drop `strict: true`. Non-strict is the default and is the mode the kit's cards are proven in; both providers accept a loose schema there and ignore what they do not compile. Rewriting a built-in card schema to fit a strict subset would change what a valid card IS, which is a card-contract change, not a projection setting."
+    "  Fix: drop `strict: true`. Non-strict mode projects a provider-valid schema (root combinators are relaxed with the constraint restated in the description and still enforced by card validation). Rewriting a built-in card schema to fit a strict subset would change what a valid card IS, which is a card-contract change, not a projection setting."
   ), i.join(`
 `);
 }
-const g = (e) => typeof e == "object" && e !== null && !Array.isArray(e);
-function St(e) {
+const f = (e) => typeof e == "object" && e !== null && !Array.isArray(e), Lt = {
+  artifact: "Provide `src` (a preview URL) or `files` — at least one. An envelope with neither is rejected.",
+  embed: "For provider 'generic', include `url`. For 'youtube'/'vimeo', include `id` or `url`."
+}, Et = "The root constraint of this schema was relaxed for this provider; consult the card registry for what a valid payload is.", Tt = ["anyOf", "allOf", "oneOf", "not", "enum", "const"];
+function T(e) {
+  if (!f(e)) return null;
+  const t = {};
+  for (const [i, n] of Object.entries(e)) t[i] = { const: n };
+  return { type: "object", properties: t, required: Object.keys(e) };
+}
+function Ct(e, t) {
+  return e === "anyOf" || e === "oneOf" || e === "allOf" ? Array.isArray(t) ? t.filter(f) : [] : e === "const" ? [T(t)].filter((i) => i !== null) : e === "enum" ? Array.isArray(t) ? t.map(T).filter((i) => i !== null) : [] : [];
+}
+function Rt(e, t) {
+  const i = f(e.properties) ? { ...e.properties } : {}, n = new Set(
+    Array.isArray(e.required) ? e.required.map(String) : []
+  );
+  for (const o of t) {
+    const a = Ct(o, e[o]);
+    if (a.length === 0) continue;
+    for (const u of a)
+      if (f(u.properties))
+        for (const [p, c] of Object.entries(u.properties))
+          p in i || (i[p] = c);
+    const s = a.map(
+      (u) => new Set(Array.isArray(u.required) ? u.required.map(String) : [])
+    );
+    if (o === "allOf")
+      for (const u of s) for (const p of u) n.add(p);
+    else {
+      const [u, ...p] = s;
+      for (const c of u)
+        p.every((l) => l.has(c)) && n.add(c);
+    }
+  }
+  Object.keys(i).length > 0 && (e.properties = i);
+  const r = [...n].filter((o) => o in i);
+  r.length > 0 && (e.required = r);
+}
+function Nt(e, t) {
+  const i = e.type;
+  if (i !== void 0 && i !== "object")
+    throw new TypeError(
+      `cardTools: the '${t}' card schema declares root type '${String(i)}', but a provider tool schema root must be an object (OpenAI and Anthropic reject anything else with HTTP 400). Wrap the payload in an object, or project this card with provider 'jsonschema'.`
+    );
+  e.type = "object";
+}
+function Pt(e, t) {
+  const i = Lt[t], n = Tt.filter((r) => r in e);
+  if (Nt(e, t), n.length !== 0) {
+    Rt(e, n);
+    for (const r of n) delete e[r];
+    return console.warn(
+      `[kai-card-tools] relaxed root ${n.join("/")} on the projected '${R(t)}' tool schema for this provider (it would be refused with HTTP 400); the constraint now lives in the description and is still enforced by card validation.`
+    ), i ?? Et;
+  }
+}
+function _t(e, t, i) {
+  for (const n of i) {
+    let r = e;
+    if (n.path !== "")
+      for (const a of n.path.split(".")) {
+        const s = f(r.properties) ? r.properties : void 0, u = s == null ? void 0 : s[a];
+        if (!f(u))
+          throw new TypeError(
+            `cardTools: require on '${t}': path '${n.path}' does not resolve in the schema`
+          );
+        r = u;
+      }
+    const o = r.type === "array" || r.type === void 0 && "items" in r;
+    if (o && n.minItems !== void 0 && (r.minItems = n.minItems), !o && n.minItems !== void 0)
+      throw new TypeError(
+        `cardTools: minItems at require path '${n.path}' applies to array nodes only, but '${n.path}' in the '${t}' schema is not one`
+      );
+    if (n.required !== void 0) {
+      const a = o && f(r.items) ? r.items : r, s = f(a.properties) ? a.properties : void 0;
+      for (const p of n.required)
+        if (!s || !(p in s))
+          throw new TypeError(
+            `cardTools: require on '${t}' at path '${n.path}': '${p}' is not a property of that node — a required name with no property would make the tool unsatisfiable`
+          );
+      const u = Array.isArray(a.required) ? a.required.map(String) : [];
+      a.required = [.../* @__PURE__ */ new Set([...u, ...n.required])];
+    }
+  }
+}
+function Dt(e) {
   return e === "$schema" || e === "$id" || e.startsWith("x-");
 }
-const At = ["items", "if", "then", "else", "not", "contains", "propertyNames", "unevaluatedItems", "additionalItems"], It = ["properties", "patternProperties", "$defs", "definitions", "dependentSchemas"], qt = ["allOf", "anyOf", "oneOf", "prefixItems"];
+const zt = ["items", "if", "then", "else", "not", "contains", "propertyNames", "unevaluatedItems", "additionalItems"], Mt = ["properties", "patternProperties", "$defs", "definitions", "dependentSchemas"], Ut = ["allOf", "anyOf", "oneOf", "prefixItems"];
 function k(e, t) {
-  if (!g(e)) return e;
+  if (!f(e)) return e;
   const i = {};
-  for (const [n, r] of Object.entries(e))
-    St(n) || (i[n] = r);
-  for (const n of It) {
-    const r = i[n];
-    if (!g(r)) continue;
-    const o = {};
-    for (const [m, p] of Object.entries(r)) o[m] = k(p, t);
-    i[n] = o;
+  for (const [o, a] of Object.entries(e))
+    Dt(o) || (i[o] = a);
+  for (const o of Mt) {
+    const a = i[o];
+    if (!f(a)) continue;
+    const s = {};
+    for (const [u, p] of Object.entries(a)) s[u] = k(p, t);
+    i[o] = s;
   }
-  for (const n of At)
-    !(n in i) || typeof i[n] == "boolean" || (i[n] = k(i[n], t));
-  g(i.additionalProperties) && (i.additionalProperties = k(i.additionalProperties, t));
-  for (const n of qt) {
-    const r = i[n];
-    Array.isArray(r) && (i[n] = r.map((o) => k(o, t)));
+  for (const o of zt)
+    !(o in i) || typeof i[o] == "boolean" || (i[o] = k(i[o], t));
+  f(i.additionalProperties) && (i.additionalProperties = k(i.additionalProperties, t));
+  for (const o of Ut) {
+    const a = i[o];
+    Array.isArray(a) && (i[o] = a.map((s) => k(s, t)));
   }
-  const s = g(i.properties) ? i.properties : void 0, a = i.type === "object" || s !== void 0;
-  if (a && t.closeObjects && !("additionalProperties" in i) && (i.additionalProperties = !1), a && t.requireEveryProperty && s) {
-    const n = Array.isArray(i.required) ? i.required.map(String) : [], r = Object.keys(s);
-    for (const o of r)
-      n.includes(o) || (s[o] = Lt(s[o]));
-    i.required = r;
+  const n = f(i.properties) ? i.properties : void 0, r = i.type === "object" || n !== void 0;
+  if (r && t.closeObjects && !("additionalProperties" in i) && (i.additionalProperties = !1), r && t.requireEveryProperty && n) {
+    const o = Array.isArray(i.required) ? i.required.map(String) : [], a = Object.keys(n);
+    for (const s of a)
+      o.includes(s) || (n[s] = Ft(n[s]));
+    i.required = a;
   }
   return i;
 }
-function Lt(e) {
-  if (!g(e)) return e;
+function Ft(e) {
+  if (!f(e)) return e;
   const t = { ...e };
   if ("type" in t) {
     const i = Array.isArray(t.type) ? t.type.map(String) : [String(t.type)];
     i.includes("null") || (t.type = [...i, "null"]);
   } else if (Array.isArray(t.anyOf))
-    t.anyOf.some((i) => g(i) && i.type === "null") || (t.anyOf = [...t.anyOf, { type: "null" }]);
+    t.anyOf.some((i) => f(i) && i.type === "null") || (t.anyOf = [...t.anyOf, { type: "null" }]);
   else
     return t;
   return Array.isArray(t.enum) && !t.enum.includes(null) && (t.enum = [...t.enum, null]), t;
 }
-function Ct(e) {
+function Jt(e) {
   const t = e;
-  return g(t.schemas) ? { schemas: t.schemas, descriptions: t.descriptions ?? {} } : { schemas: e, descriptions: {} };
+  return f(t.schemas) ? { schemas: t.schemas, descriptions: t.descriptions ?? {} } : { schemas: e, descriptions: {} };
 }
-function Et(e, t, i) {
-  const s = i[e];
-  if (typeof s == "string" && s.length > 0) return s;
-  const a = kt[e];
-  if (typeof a == "string" && a.length > 0) return a;
-  const n = t.description;
-  return typeof n == "string" && n.length > 0 ? n : `Render a \`${e}\` card.`;
+function Bt(e, t, i) {
+  const n = i[e];
+  if (typeof n == "string" && n.length > 0) return n;
+  const r = At[e];
+  if (typeof r == "string" && r.length > 0) return r;
+  const o = t.description;
+  return typeof o == "string" && o.length > 0 ? o : `Render a \`${e}\` card.`;
 }
 function v(e, t) {
-  const i = t === void 0, s = i ? e : t;
-  if (!g(s) || typeof s.provider != "string")
+  var l;
+  const i = t === void 0, n = i ? e : t;
+  if (!f(n) || typeof n.provider != "string")
     throw new TypeError('cardTools: an options object with a `provider` is required, e.g. cardTools({ provider: "openai" })');
-  const { schemas: a, descriptions: n } = Ct(
-    i ? Tt() : e
-  ), r = s.strict === !0;
-  if (s.provider === "jsonschema" && r)
+  const { schemas: r, descriptions: o } = Jt(
+    i ? Yt() : e
+  ), a = n.strict === !0;
+  if (n.provider === "jsonschema" && a)
     throw new TypeError(
       'cardTools: `strict: true` is provider-specific and cannot be checked for `provider: "jsonschema"`, because the two documented strict subsets differ (see @kitn.ai/ui/schemas provider-subsets). Pass provider "openai" or "anthropic" to project and check strictly, or drop `strict`.'
     );
-  const o = r ? s.provider === "openai" ? C : E : null, m = {
-    closeObjects: o !== null,
-    requireEveryProperty: o !== null && o.requireAllPropertiesRequired
+  const s = a ? n.provider === "openai" ? P : _ : null, u = {
+    closeObjects: s !== null,
+    requireEveryProperty: s !== null && s.requireAllPropertiesRequired
   }, p = [], c = [];
-  for (const [u, h] of Object.entries(a)) {
-    const b = gt(u), f = Et(u, h, n), $ = k(h, m);
-    if (o) {
-      const d = xt($, o);
-      if (d.length > 0) {
-        c.push({ cardType: u, toolName: b, violations: d });
+  if (n.require !== void 0) {
+    for (const h of Object.keys(n.require))
+      if (!(h in r))
+        throw new TypeError(
+          `cardTools: require names card type '${h}', which this call does not carry (carries: ${Object.keys(r).join(", ") || "none"})`
+        );
+  }
+  for (const [h, $] of Object.entries(r)) {
+    const g = R(h), b = Bt(h, $, o), d = k($, u), m = s === null && n.provider !== "jsonschema" ? Pt(d, h) : void 0, I = m ? `${b} ${m}` : b, L = (l = n.require) == null ? void 0 : l[h];
+    if (L !== void 0 && _t(d, h, L), s) {
+      const E = St(d, s);
+      if (E.length > 0) {
+        c.push({ cardType: h, toolName: g, violations: E });
         continue;
       }
     }
-    s.provider === "openai" ? p.push({ type: "function", function: { name: b, description: f, parameters: $, ...r ? { strict: !0 } : {} } }) : s.provider === "anthropic" ? p.push({ name: b, description: f, input_schema: $, ...r ? { strict: !0 } : {} }) : p.push({ name: b, description: f, schema: $ });
+    n.provider === "openai" ? p.push({ type: "function", function: { name: g, description: I, parameters: d, ...a ? { strict: !0 } : {} } }) : n.provider === "anthropic" ? p.push({ name: g, description: I, input_schema: d, ...a ? { strict: !0 } : {} }) : p.push({ name: g, description: b, schema: d });
   }
-  if (o && c.length > 0) throw new Ot(o, c);
+  if (s && c.length > 0) throw new qt(s, c);
   return p;
 }
-function Tt() {
+function Yt() {
   return j;
 }
-function Vt(e, t) {
+function ai(e, t) {
   return e === void 0 ? v({ provider: "openai", strict: t == null ? void 0 : t.strict }) : v(e, { provider: "openai", strict: t == null ? void 0 : t.strict });
 }
-function Gt(e, t) {
+function pi(e, t) {
   return e === void 0 ? v({ provider: "anthropic", strict: t == null ? void 0 : t.strict }) : v(e, { provider: "anthropic", strict: t == null ? void 0 : t.strict });
 }
-function Qt(e) {
+function di(e) {
   return e === void 0 ? v({ provider: "jsonschema" }) : v(e, { provider: "jsonschema" });
 }
 function A(e) {
   return e === null ? "null" : Array.isArray(e) ? "array" : typeof e;
 }
-function Rt(e, t) {
+function Ht(e, t) {
   switch (t) {
     case "integer":
       return typeof e == "number" && Number.isInteger(e);
@@ -527,28 +620,28 @@ function Rt(e, t) {
       return typeof e === t;
   }
 }
-function I(e, t, i, s) {
-  const a = i || "(root)", n = (r, o, m = a) => {
-    s.push({ path: m, keyword: r, message: `${m}: ${o}` });
+function q(e, t, i, n) {
+  const r = i || "(root)", o = (a, s, u = r) => {
+    n.push({ path: u, keyword: a, message: `${u}: ${s}` });
   };
-  if (e.type && !Rt(t, e.type)) {
-    n("type", `expected ${e.type}, got ${A(t)}`);
+  if (e.type && !Ht(t, e.type)) {
+    o("type", `expected ${e.type}, got ${A(t)}`);
     return;
   }
-  if ("const" in e && JSON.stringify(t) !== JSON.stringify(e.const) && n("const", `must equal const ${JSON.stringify(e.const)}`), e.enum && !e.enum.some((r) => JSON.stringify(r) === JSON.stringify(t)) && n("enum", `must be one of ${JSON.stringify(e.enum)}`), typeof t == "number" && (e.minimum !== void 0 && t < e.minimum && n("minimum", `< minimum ${e.minimum}`), e.maximum !== void 0 && t > e.maximum && n("maximum", `> maximum ${e.maximum}`), e.exclusiveMinimum !== void 0 && t <= e.exclusiveMinimum && n("exclusiveMinimum", "<= exclusiveMinimum"), e.exclusiveMaximum !== void 0 && t >= e.exclusiveMaximum && n("exclusiveMaximum", ">= exclusiveMaximum")), typeof t == "string" && (e.minLength !== void 0 && t.length < e.minLength && n("minLength", `shorter than minLength ${e.minLength}`), e.maxLength !== void 0 && t.length > e.maxLength && n("maxLength", `longer than maxLength ${e.maxLength}`), e.pattern !== void 0 && !new RegExp(e.pattern).test(t) && n("pattern", "does not match pattern")), Array.isArray(t) && (e.minItems !== void 0 && t.length < e.minItems && n("minItems", `fewer than minItems ${e.minItems}`), e.maxItems !== void 0 && t.length > e.maxItems && n("maxItems", `more than maxItems ${e.maxItems}`), e.uniqueItems && new Set(t.map((o) => JSON.stringify(o))).size !== t.length && n("uniqueItems", "items not unique"), e.items && t.forEach((r, o) => I(e.items, r, `${a}[${o}]`, s))), A(t) === "object") {
-    const r = t;
-    for (const o of e.required ?? [])
-      (!(o in r) || r[o] === void 0) && n("required", "required", `${a}.${o}`);
+  if ("const" in e && JSON.stringify(t) !== JSON.stringify(e.const) && o("const", `must equal const ${JSON.stringify(e.const)}`), e.enum && !e.enum.some((a) => JSON.stringify(a) === JSON.stringify(t)) && o("enum", `must be one of ${JSON.stringify(e.enum)}`), typeof t == "number" && (e.minimum !== void 0 && t < e.minimum && o("minimum", `< minimum ${e.minimum}`), e.maximum !== void 0 && t > e.maximum && o("maximum", `> maximum ${e.maximum}`), e.exclusiveMinimum !== void 0 && t <= e.exclusiveMinimum && o("exclusiveMinimum", "<= exclusiveMinimum"), e.exclusiveMaximum !== void 0 && t >= e.exclusiveMaximum && o("exclusiveMaximum", ">= exclusiveMaximum")), typeof t == "string" && (e.minLength !== void 0 && t.length < e.minLength && o("minLength", `shorter than minLength ${e.minLength}`), e.maxLength !== void 0 && t.length > e.maxLength && o("maxLength", `longer than maxLength ${e.maxLength}`), e.pattern !== void 0 && !new RegExp(e.pattern).test(t) && o("pattern", "does not match pattern")), Array.isArray(t) && (e.minItems !== void 0 && t.length < e.minItems && o("minItems", `fewer than minItems ${e.minItems}`), e.maxItems !== void 0 && t.length > e.maxItems && o("maxItems", `more than maxItems ${e.maxItems}`), e.uniqueItems && new Set(t.map((s) => JSON.stringify(s))).size !== t.length && o("uniqueItems", "items not unique"), e.items && t.forEach((a, s) => q(e.items, a, `${r}[${s}]`, n))), A(t) === "object") {
+    const a = t;
+    for (const s of e.required ?? [])
+      (!(s in a) || a[s] === void 0) && o("required", "required", `${r}.${s}`);
     if (e.properties)
-      for (const [o, m] of Object.entries(e.properties))
-        o in r && r[o] !== void 0 && I(m, r[o], `${a}.${o}`, s);
+      for (const [s, u] of Object.entries(e.properties))
+        s in a && a[s] !== void 0 && q(u, a[s], `${r}.${s}`, n);
   }
 }
-function Pt(e, t) {
+function Kt(e, t) {
   const i = [];
-  return I(e, t, "", i), { valid: i.length === 0, errors: i.map((s) => s.message), issues: i };
+  return q(e, t, "", i), { valid: i.length === 0, errors: i.map((n) => n.message), issues: i };
 }
-const T = {
+const D = {
   artifact: { type: "object", properties: { src: { type: "string" }, files: { type: "array", maxItems: 500, items: { type: "object", required: ["path"], properties: { path: { type: "string", maxLength: 1024 }, url: { type: "string" }, code: { type: "string" }, language: { type: "string", maxLength: 40 }, type: { type: "string", enum: ["html", "pdf", "image", "other"] }, additions: { type: "integer", minimum: 0 }, deletions: { type: "integer", minimum: 0 }, status: { type: "string", enum: ["added", "modified", "deleted", "renamed", "untracked"] } } } }, tab: { type: "string", enum: ["preview", "code"] }, activeFile: { type: "string", maxLength: 1024 }, displayUrl: { type: "string", maxLength: 2048 } } },
   choice: { type: "object", required: ["options"], properties: { prompt: { type: "string" }, submitLabel: { type: "string" }, options: { type: "array", minItems: 1, items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1 }, label: { type: "string", minLength: 1 }, description: { type: "string" }, media: { type: "object", properties: { image: { type: "string" }, imageAlt: { type: "string" }, icon: { type: "string" } } }, meta: { type: "string" }, recommended: { type: "boolean" }, disabled: { type: "boolean" } } } }, dismissible: { type: "boolean" } } },
   confirm: { type: "object", required: ["actions"], properties: { heading: { type: "string" }, body: { type: "string" }, tone: { type: "string", enum: ["default", "warning", "danger"] }, actions: { type: "array", minItems: 1, maxItems: 4, items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1 }, label: { type: "string", minLength: 1 }, style: { type: "string", enum: ["primary", "default", "destructive"] }, default: { type: "boolean" } } } }, dismissible: { type: "boolean" } } },
@@ -556,7 +649,7 @@ const T = {
   form: { type: "object", required: ["type", "properties"], properties: { type: { const: "object" }, title: { type: "string" }, description: { type: "string" }, required: { type: "array", items: { type: "string" } }, properties: { type: "object" }, "x-kai-order": { type: "array", items: { type: "string" } }, "x-kai-inlineMax": { type: "integer", minimum: 1 }, "x-kai-submitLabel": { type: "string" }, "x-kai-dismissible": { type: "boolean" }, "x-kai-actions": { type: "array", items: { type: "object", required: ["id", "label"], properties: { id: { type: "string" }, label: { type: "string" }, variant: { enum: ["default", "ghost", "outline"] } } } } } },
   link: { type: "object", required: ["url"], properties: { url: { type: "string" }, title: { type: "string", maxLength: 300 }, description: { type: "string", maxLength: 1e3 }, image: { type: "string" }, imageAlt: { type: "string", maxLength: 300 }, favicon: { type: "string" }, domain: { type: "string", maxLength: 253 }, siteName: { type: "string", maxLength: 200 } } },
   tasks: { type: "object", required: ["tasks"], properties: { mode: { type: "string", enum: ["select", "progress"] }, heading: { type: "string" }, tasks: { type: "array", minItems: 1, items: { type: "object", required: ["id", "label"], properties: { id: { type: "string", minLength: 1 }, label: { type: "string", minLength: 1 }, description: { type: "string" }, checked: { type: "boolean" }, disabled: { type: "boolean" } } } }, selectAll: { type: "boolean" }, confirmLabel: { type: "string" }, allowEmpty: { type: "boolean" }, min: { type: "integer", minimum: 0 }, max: { type: "integer", minimum: 1 }, dismissible: { type: "boolean" } } }
-}, Nt = Object.freeze({
+}, Wt = Object.freeze({
   // hard: nothing to render
   type: "hard",
   required: "hard",
@@ -575,44 +668,44 @@ const T = {
   exclusiveMinimum: "soft",
   exclusiveMaximum: "soft",
   uniqueItems: "soft"
-}), _t = "soft";
-function Dt(e) {
-  return Object.prototype.hasOwnProperty.call(T, e);
+}), Vt = "soft";
+function Gt(e) {
+  return Object.prototype.hasOwnProperty.call(D, e);
 }
-function zt(e, t) {
+function Xt(e, t) {
   if (t && Object.prototype.hasOwnProperty.call(t, e)) {
     const i = t[e];
     if (i && typeof i == "object") return i;
   }
-  return Dt(e) ? T[e] : null;
+  return Gt(e) ? D[e] : null;
 }
-function Mt(e) {
-  const t = e.slice(0, 3).map((s) => s.message), i = e.length - t.length;
+function Qt(e) {
+  const t = e.slice(0, 3).map((n) => n.message), i = e.length - t.length;
   return t.join("; ") + (i > 0 ? `; and ${i} more` : "");
 }
-function Ut(e, t, i) {
-  const s = zt(e, i);
-  if (s === null) return null;
-  const a = Pt(s, t);
-  if (a.valid) return { ok: !0, tier: "ok", issues: [], hard: [], summary: "" };
-  const n = a.issues.map((o) => ({
-    ...o,
-    tier: Nt[o.keyword] ?? _t
-  })), r = n.filter((o) => o.tier === "hard");
+function Zt(e, t, i) {
+  const n = Xt(e, i);
+  if (n === null) return null;
+  const r = Kt(n, t);
+  if (r.valid) return { ok: !0, tier: "ok", issues: [], hard: [], summary: "" };
+  const o = r.issues.map((s) => ({
+    ...s,
+    tier: Wt[s.keyword] ?? Vt
+  })), a = o.filter((s) => s.tier === "hard");
   return {
     ok: !1,
-    tier: r.length > 0 ? "hard" : "soft",
-    issues: n,
-    hard: r,
-    summary: Mt(r.length > 0 ? r : n)
+    tier: a.length > 0 ? "hard" : "soft",
+    issues: o,
+    hard: a,
+    summary: Qt(a.length > 0 ? a : o)
   };
 }
-function Xt(e) {
+function ci(e) {
   return `invalid card data (${e.tier}): ${e.summary}`;
 }
-const Ft = (e) => typeof e == "object" && e !== null && !Array.isArray(e);
-function Jt(e) {
-  const t = e.map((s) => `"${s}"`).join(", "), i = e.length === 1 ? "type" : "types";
+const ei = (e) => typeof e == "object" && e !== null && !Array.isArray(e);
+function ti(e) {
+  const t = e.map((n) => `"${n}"`).join(", "), i = e.length === 1 ? "type" : "types";
   return [
     `createCardRegistry: ${e.length} custom card ${i} registered with no \`schema\`: ${t}.`,
     "  They will still RENDER (their tag/component is registered), but:",
@@ -624,46 +717,46 @@ function Jt(e) {
   ].join(`
 `);
 }
-function Zt(e = {}) {
+function ui(e = {}) {
   if (typeof e != "object" || e === null || Array.isArray(e))
     throw new TypeError('createCardRegistry: expected a spec object, e.g. createCardRegistry({ use: ["confirm"] })');
-  const t = j, i = e.use ?? Object.keys(t), s = i.filter((d) => !Yt(d));
-  if (s.length > 0)
+  const t = j, i = e.use ?? Object.keys(t), n = i.filter((d) => !ii(d));
+  if (n.length > 0)
     throw new TypeError(
-      `createCardRegistry: \`use\` names ${s.length} type(s) that are not built in: ${s.map((d) => `"${d}"`).join(", ")}. The built-in types are ${Object.keys(t).join(", ")}. A card type of your own goes in \`custom\`, with its schema, not in \`use\`.`
+      `createCardRegistry: \`use\` names ${n.length} type(s) that are not built in: ${n.map((d) => `"${d}"`).join(", ")}. The built-in types are ${Object.keys(t).join(", ")}. A card type of your own goes in \`custom\`, with its schema, not in \`use\`.`
     );
-  const a = new Set(i), n = Object.keys(t).filter((d) => a.has(d)), r = e.custom ?? {}, o = Object.keys(r);
-  if (o.find((d) => d.trim().length === 0) !== void 0)
+  const r = new Set(i), o = Object.keys(t).filter((d) => r.has(d)), a = e.custom ?? {}, s = Object.keys(a);
+  if (s.find((d) => d.trim().length === 0) !== void 0)
     throw new TypeError("createCardRegistry: a custom card type name must be a non-empty string; it becomes `CardEnvelope.type` and the `kai_<type>` tool name.");
   const p = {};
-  for (const d of n) p[d] = t[d];
-  const c = {}, u = {}, h = {}, b = {}, f = [];
-  for (const d of o) {
-    const l = r[d];
-    if (typeof l != "object" || l === null || Array.isArray(l))
+  for (const d of o) p[d] = t[d];
+  const c = {}, l = {}, h = {}, $ = {}, g = [];
+  for (const d of s) {
+    const m = a[d];
+    if (typeof m != "object" || m === null || Array.isArray(m))
       throw new TypeError(`createCardRegistry: custom card type "${d}" must be an object, e.g. { schema, tag }.`);
-    Ft(l.schema) ? (p[d] = l.schema, b[d] = l.schema) : (delete p[d], f.push(d)), typeof l.tag == "string" && l.tag.length > 0 && (u[d] = l.tag), typeof l.component == "function" && (h[d] = l.component), typeof l.description == "string" && l.description.length > 0 && (c[d] = l.description);
+    ei(m.schema) ? (p[d] = m.schema, $[d] = m.schema) : (delete p[d], g.push(d)), typeof m.tag == "string" && m.tag.length > 0 && (l[d] = m.tag), typeof m.component == "function" && (h[d] = m.component), typeof m.description == "string" && m.description.length > 0 && (c[d] = m.description);
   }
-  if (f.length > 0) {
-    const d = e.onIncomplete ?? "warn", l = Jt(f);
-    if (d === "throw") throw new TypeError(l);
-    d !== "silent" && console.warn(l);
+  if (g.length > 0) {
+    const d = e.onIncomplete ?? "warn", m = ti(g);
+    if (d === "throw") throw new TypeError(m);
+    d !== "silent" && console.warn(m);
   }
-  const $ = Object.freeze({ ...b });
+  const b = Object.freeze({ ...$ });
   return Object.freeze({
     schemas: Object.freeze(p),
     descriptions: Object.freeze(c),
-    tags: Object.freeze(u),
+    tags: Object.freeze(l),
     components: Object.freeze(h),
-    types: Object.freeze([...n, ...o]),
-    builtIn: Object.freeze(n),
-    custom: Object.freeze([...o]),
-    incomplete: Object.freeze([...f]),
-    validationSchemas: $,
-    validate: (d, l) => Ut(d, l, $)
+    types: Object.freeze([...o, ...s]),
+    builtIn: Object.freeze(o),
+    custom: Object.freeze([...s]),
+    incomplete: Object.freeze([...g]),
+    validationSchemas: b,
+    validate: (d, m) => Zt(d, m, b)
   });
 }
-const ei = {
+const li = {
   form: "kai-form",
   confirm: "kai-confirm",
   tasks: "kai-tasks",
@@ -672,46 +765,46 @@ const ei = {
   embed: "kai-embed",
   artifact: "kai-artifact"
 }, y = (e) => e, j = Object.freeze({
-  artifact: y(J),
-  choice: y(me),
-  confirm: y(we),
-  embed: y(Ce),
-  form: y(Be),
-  link: y(et),
-  tasks: y(ft)
-}), ti = Object.freeze({
-  "card-envelope": y(Q),
-  "card-event": y(oe),
-  "form.result": y(_e),
-  "tasks.result": y(pt)
-}), ii = Object.freeze(
+  artifact: y(W),
+  choice: y(be),
+  confirm: y(Se),
+  embed: y(Pe),
+  form: y(Ge),
+  link: y(rt),
+  tasks: y(wt)
+}), mi = Object.freeze({
+  "card-envelope": y(ie),
+  "card-event": y(ce),
+  "form.result": y(Fe),
+  "tasks.result": y(mt)
+}), hi = Object.freeze(
   Object.keys(j)
 );
-function Yt(e) {
+function ii(e) {
   return Object.prototype.hasOwnProperty.call(j, e);
 }
 export {
-  E as ANTHROPIC_STRICT,
-  ei as BUILTIN_CARD_TAGS,
-  kt as CARD_TOOL_DESCRIPTIONS,
+  _ as ANTHROPIC_STRICT,
+  li as BUILTIN_CARD_TAGS,
+  At as CARD_TOOL_DESCRIPTIONS,
   S as KAI_TOOL_PREFIX,
-  C as OPENAI_STRICT,
-  Ot as UnsupportedCardToolSchemaError,
-  Kt as cardFromToolCall,
-  ii as cardSchemaNames,
+  P as OPENAI_STRICT,
+  qt as UnsupportedCardToolSchemaError,
+  ri as cardFromToolCall,
+  hi as cardSchemaNames,
   j as cardSchemas,
   v as cardTools,
-  q as cardTypeFromToolName,
-  Xt as cardValidationMessage,
-  xt as checkProviderSubset,
-  ti as contractSchemas,
-  Zt as createCardRegistry,
-  Yt as isCardSchemaName,
-  Ht as isCardTool,
-  Wt as providerSubsets,
-  Gt as toAnthropicTools,
-  Qt as toJsonSchemaTools,
-  Vt as toOpenAITools,
-  gt as toolNameForCardType,
-  Ut as validateCardData
+  C as cardTypeFromToolName,
+  ci as cardValidationMessage,
+  St as checkProviderSubset,
+  mi as contractSchemas,
+  ui as createCardRegistry,
+  ii as isCardSchemaName,
+  oi as isCardTool,
+  si as providerSubsets,
+  pi as toAnthropicTools,
+  di as toJsonSchemaTools,
+  ai as toOpenAITools,
+  R as toolNameForCardType,
+  Zt as validateCardData
 };