@ai-matrx/content-ir-react 0.11.10 → 0.12.0

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ApplyDirectiveButton: () => ApplyDirectiveButton,
+  CHANGE_VALUE_MAX: () => CHANGE_VALUE_MAX,
   ComponentResolver: () => ComponentResolver,
   ContentIrRenderProvider: () => ContentIrRenderProvider,
   DB_KIND_COMPONENT_KEY: () => DB_KIND_COMPONENT_KEY,
@@ -39,6 +40,7 @@ __export(index_exports, {
   DelegatedOutput: () => DelegatedOutput,
   DirectiveFallbackCard: () => DirectiveFallbackCard,
   DirectiveHostProvider: () => DirectiveHostProvider,
+  DirectiveProvisionalCard: () => DirectiveProvisionalCard,
   DirectiveRender: () => DirectiveRender,
   GENERIC_STRUCTURED_COMPONENT_KEY: () => GENERIC_STRUCTURED_COMPONENT_KEY,
   GenericStructuredView: () => GenericStructuredView,
@@ -50,20 +52,26 @@ __export(index_exports, {
   ProvisionalKindFrame: () => ProvisionalKindFrame,
   RunResultView: () => RunResultView,
   SideEffectDirectiveCard: () => SideEffectDirectiveCard,
+  TARGETING_CLASSES: () => TARGETING_CLASSES,
   applyIrKindRoute: () => applyIrKindRoute,
   consoleErrorReporter: () => consoleErrorReporter,
   createDbKindComponentCache: () => createDbKindComponentCache,
   createKindRouteBinding: () => createKindRouteBinding,
   envelopeFromPartialKind: () => envelopeFromPartialKind,
+  fieldLabel: () => fieldLabel,
   getDirectiveRenderer: () => getDirectiveRenderer,
   isDbKindComponentBodyPending: () => isDbKindComponentBodyPending,
   isPartialReadyKind: () => isPartialReadyKind,
   isProvisionalBlock: () => isProvisionalBlock,
   isRecordValue: () => isRecordValue,
+  itemChanges: () => itemChanges,
+  itemRecordId: () => itemRecordId,
   kindIsRoutable: () => kindIsRoutable,
   kindServerDataFromStoredValue: () => kindServerDataFromStoredValue,
   markKindPartialUnsafe: () => markKindPartialUnsafe,
+  provisionalDirectiveSlug: () => provisionalDirectiveSlug,
   readIrRouteMarker: () => readIrRouteMarker,
+  recordFallbackName: () => recordFallbackName,
   registerDirectiveRenderer: () => registerDirectiveRenderer,
   resetDirectiveRenderers: () => resetDirectiveRenderers,
   resetPartialUnsafeKinds: () => resetPartialUnsafeKinds,
@@ -769,16 +777,73 @@ function useContentIrKindVersion(kind, sources) {
 
 // react/KindInstanceRender.tsx
 var import_react6 = require("react");
-var import_content_ir7 = require("@ai-matrx/content-ir");
+var import_content_ir9 = require("@ai-matrx/content-ir");
 
 // directives/DirectiveRender.tsx
-var import_content_ir6 = require("@ai-matrx/content-ir");
+var import_content_ir8 = require("@ai-matrx/content-ir");
 
 // directives/DirectiveFallbackCard.tsx
-var import_content_ir3 = require("@ai-matrx/content-ir");
+var import_content_ir4 = require("@ai-matrx/content-ir");
 
 // directives/ApplyDirectiveButton.tsx
 var import_react4 = require("react");
+var import_content_ir3 = require("@ai-matrx/content-ir");
+
+// directives/item-changes.ts
+var TARGETING_CLASSES = /* @__PURE__ */ new Set(["update", "delete"]);
+var NOT_A_CHANGE = /* @__PURE__ */ new Set(["__kind", "id"]);
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var CHANGE_VALUE_MAX = 60;
+function itemRecordId(item) {
+  const id = item.id;
+  if (typeof id === "string" && id.trim()) return id.trim();
+  if (typeof id === "number") return String(id);
+  return null;
+}
+function fieldLabel(key) {
+  const spaced = key.replace(/_/g, " ").trim();
+  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+function recordFallbackName(nounLabel3, id) {
+  const short = UUID_RE.test(id) ? id.slice(0, 8) : id.length > 12 ? `${id.slice(0, 12)}\u2026` : id;
+  return `${nounLabel3} ${short}`;
+}
+function describeValue(value) {
+  if (value === null || value === void 0) return { value: "cleared", full: "cleared", clears: true };
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed) return { value: "cleared", full: "cleared", clears: true };
+    const oneLine = trimmed.replace(/\s+/g, " ");
+    const shown = oneLine.length > CHANGE_VALUE_MAX ? `${oneLine.slice(0, CHANGE_VALUE_MAX - 1)}\u2026` : oneLine;
+    return { value: shown, full: trimmed, clears: false };
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return { value: String(value), full: String(value), clears: false };
+  }
+  if (Array.isArray(value)) {
+    const n2 = value.length;
+    const text2 = n2 === 0 ? "cleared" : `${n2} ${n2 === 1 ? "entry" : "entries"}`;
+    return { value: text2, full: safeJson(value), clears: n2 === 0 };
+  }
+  const n = Object.keys(value).length;
+  const text = n === 0 ? "cleared" : `${n} ${n === 1 ? "field" : "fields"}`;
+  return { value: text, full: safeJson(value), clears: n === 0 };
+}
+function safeJson(value) {
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+function itemChanges(item) {
+  const out = [];
+  for (const [key, raw] of Object.entries(item)) {
+    if (NOT_A_CHANGE.has(key)) continue;
+    out.push({ key, label: fieldLabel(key), ...describeValue(raw) });
+  }
+  return out;
+}
 
 // directives/icons.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
@@ -896,10 +961,38 @@ function ApplyDirectiveButton({
   const items = directive.items;
   async function handleApply() {
     if (!confirm) return;
+    if (host.ask) {
+      setState({ status: "asking" });
+      let ok = false;
+      try {
+        ok = await host.ask({
+          directive,
+          items,
+          nounLabel: (0, import_content_ir3.nounLabel)(directive.noun, host.nouns)
+        });
+      } catch (error) {
+        setState({
+          status: "error",
+          message: error instanceof Error && error.message ? error.message : "We could not ask you to confirm this, so nothing was done."
+        });
+        return;
+      }
+      if (!ok) {
+        setState({ status: "idle" });
+        return;
+      }
+    }
+    setElapsed(0);
     setState({ status: "applying" });
     try {
       const result = await confirm({ __kind: directive.slug, items });
-      setState({ status: "applied", applied: result.applied, failed: result.failed });
+      setState({
+        status: "applied",
+        applied: result.applied,
+        failed: result.failed,
+        message: result.message?.trim() ? result.message.trim() : null,
+        records: result.records ?? []
+      });
       onApplied?.();
     } catch (error) {
       setState({
@@ -910,15 +1003,26 @@ function ApplyDirectiveButton({
   }
   if (state.status === "applied") {
     const bad = state.failed > 0;
+    const trashed = directive.directiveClass === "delete";
+    const label2 = (0, import_content_ir3.nounLabel)(directive.noun, host.nouns);
+    const records = host.renderRecord ? state.records : [];
     return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
       "span",
       {
-        className: `inline-flex items-center gap-1 text-xs ${bad ? "text-destructive" : "text-primary"}`,
+        className: `inline-flex min-w-0 flex-wrap items-center gap-1 text-xs ${bad ? "text-destructive" : "text-primary"}`,
+        "data-apply-state": "applied",
         children: [
-          bad ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(AlertIcon, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(CheckCircleIcon, { className: "h-3.5 w-3.5" }),
-          "Applied ",
-          state.applied,
-          bad ? ` \xB7 ${state.failed} failed` : ""
+          bad ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(AlertIcon, { className: "h-3.5 w-3.5 shrink-0" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(CheckCircleIcon, { className: "h-3.5 w-3.5 shrink-0" }),
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("span", { children: [
+            state.message ?? `Applied ${state.applied}`,
+            bad && !state.message ? ` \xB7 ${state.failed} failed` : ""
+          ] }),
+          records.map((record) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("span", { className: "inline-flex min-w-0 items-center", children: host.renderRecord?.({
+            ...record,
+            fallback: recordFallbackName(label2, record.id),
+            context: "applied",
+            trashed
+          }) }, `${record.noun}:${record.id}`))
         ]
       }
     );
@@ -929,7 +1033,7 @@ function ApplyDirectiveButton({
       {
         type: "button",
         onClick: () => void handleApply(),
-        disabled: state.status === "applying" || items.length === 0,
+        disabled: state.status === "applying" || state.status === "asking" || items.length === 0,
         className: "inline-flex items-center gap-1 rounded-md border border-border bg-background px-2 py-1 text-xs font-medium hover:bg-accent disabled:opacity-50",
         children: [
           state.status === "applying" ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PlayIcon, { className: "h-3.5 w-3.5" }),
@@ -949,7 +1053,7 @@ var import_jsx_runtime5 = require("react/jsx-runtime");
 function DirectiveFallbackCard({ directive, reason }) {
   const host = useDirectiveHost();
   const count = directive.items.length;
-  const display = (0, import_content_ir3.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
+  const display = (0, import_content_ir4.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { className: "my-3 inline-flex flex-wrap items-center gap-2 rounded-md border border-border bg-muted px-2.5 py-1 text-sm", children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(BoxesIcon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "text-foreground", children: display.title }),
@@ -971,15 +1075,55 @@ function DirectiveFallbackCard({ directive, reason }) {
   ] });
 }
 
+// directives/DirectiveProvisionalCard.tsx
+var import_content_ir5 = require("@ai-matrx/content-ir");
+var import_jsx_runtime6 = require("react/jsx-runtime");
+var COMPLETE_SLUG_RE = /^\{\s*"__kind"\s*:\s*"([^"]+)"/;
+function provisionalDirectiveSlug(content) {
+  const match = content.trimStart().match(COMPLETE_SLUG_RE);
+  return match?.[1] ?? null;
+}
+function DirectiveProvisionalCard({ content, streaming, className }) {
+  const host = useDirectiveHost();
+  const slug = provisionalDirectiveSlug(content);
+  const known = slug ? (0, import_content_ir5.parseDirectiveSlug)(slug) : null;
+  const display = known ? (0, import_content_ir5.directiveDisplay)(known.directiveClass, known.noun, host.nouns) : null;
+  const Icon = known ? classIcon(known.directiveClass, known.noun) : BoxesIcon;
+  const title = display?.title ?? "Structured action";
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+    "div",
+    {
+      className: `my-3 rounded-md border border-border bg-card px-2.5 py-1.5${className ? ` ${className}` : ""}`,
+      "data-directive": slug ?? void 0,
+      "data-directive-state": streaming ? "streaming" : "incomplete",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "text-sm font-medium text-foreground", children: title }),
+          display?.family ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
+          streaming ? /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { className: "inline-flex items-center gap-1.5 text-xs text-muted-foreground", role: "status", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "h-1.5 w-1.5 animate-pulse rounded-full bg-primary", "aria-hidden": true }),
+            "Writing\u2026"
+          ] }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "text-xs text-destructive", role: "status", children: "Cut off before it finished \u2014 nothing can be applied." })
+        ] }),
+        streaming ? null : /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("details", { className: "mt-1 text-xs text-muted-foreground", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("summary", { className: "cursor-pointer select-none hover:text-foreground", children: "Show what arrived" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("pre", { className: "mt-1 max-h-64 overflow-auto whitespace-pre-wrap break-all rounded bg-muted px-2 py-1 text-[11px]", children: content })
+        ] })
+      ]
+    }
+  );
+}
+
 // directives/registry.ts
-var import_content_ir4 = require("@ai-matrx/content-ir");
+var import_content_ir6 = require("@ai-matrx/content-ir");
 var REGISTRY_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.content-ir-react.directive-renderers");
 var registry = globalThis[REGISTRY_SLOT] ??= {
   bySlug: /* @__PURE__ */ new Map(),
   byClass: /* @__PURE__ */ new Map()
 };
 function registerDirectiveRenderer(directiveClass, renderer, noun) {
-  if (noun) registry.bySlug.set((0, import_content_ir4.buildDirectiveSlug)(directiveClass, noun), renderer);
+  if (noun) registry.bySlug.set((0, import_content_ir6.buildDirectiveSlug)(directiveClass, noun), renderer);
   else registry.byClass.set(directiveClass, renderer);
 }
 function getDirectiveRenderer(directive) {
@@ -992,8 +1136,8 @@ function resetDirectiveRenderers() {
 
 // directives/SideEffectDirectiveCard.tsx
 var import_react5 = require("react");
-var import_content_ir5 = require("@ai-matrx/content-ir");
-var import_jsx_runtime6 = require("react/jsx-runtime");
+var import_content_ir7 = require("@ai-matrx/content-ir");
+var import_jsx_runtime7 = require("react/jsx-runtime");
 var ROWS_BEFORE_FOLD = 3;
 function ItemRow({
   directive,
@@ -1002,31 +1146,35 @@ function ItemRow({
   total
 }) {
   const host = useDirectiveHost();
-  const titleColumn = (0, import_content_ir5.nounTitleColumn)(directive.noun, host.nouns);
-  const title = (0, import_content_ir5.itemTitle)(item, titleColumn, index, total);
-  const subtitle = (0, import_content_ir5.itemSubtitle)(item);
-  const facts = (0, import_content_ir5.itemFacts)(item);
+  const recordId = TARGETING_CLASSES.has(directive.directiveClass) ? itemRecordId(item) : null;
+  if (recordId) {
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(TargetRow, { directive, item, recordId });
+  }
+  const titleColumn = (0, import_content_ir7.nounTitleColumn)(directive.noun, host.nouns);
+  const title = (0, import_content_ir7.itemTitle)(item, titleColumn, index, total);
+  const subtitle = (0, import_content_ir7.itemSubtitle)(item);
+  const facts = (0, import_content_ir7.itemFacts)(item);
   const kind = host.itemKind?.(directive.slug) ?? null;
-  const display = (0, import_content_ir5.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
+  const display = (0, import_content_ir7.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
   const openItem = host.openItem;
-  const body = /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(import_jsx_runtime6.Fragment, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { className: "truncate text-[11px] text-muted-foreground", children: [
+  const body = /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "truncate text-[11px] text-muted-foreground", children: [
       fact.value,
       " ",
       fact.label
     ] }, fact.key)) }),
-    subtitle && facts.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "hidden truncate text-[11px] text-muted-foreground sm:inline", children: subtitle }) : null,
-    openItem ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(MaximizeIcon, { className: "ml-auto h-3 w-3 shrink-0 text-muted-foreground" }) : null
+    subtitle && facts.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "hidden truncate text-[11px] text-muted-foreground sm:inline", children: subtitle }) : null,
+    openItem ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(MaximizeIcon, { className: "ml-auto h-3 w-3 shrink-0 text-muted-foreground" }) : null
   ] });
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "flex items-center gap-2 py-1 text-xs", children: [
-    openItem ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex items-center gap-2 py-1 text-xs", children: [
+    openItem ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       "button",
       {
         type: "button",
         onClick: () => openItem({
           // Stamped so the panel's kind pipeline types it from its own first key.
-          item: (0, import_content_ir5.asKindInstance)(item, kind) ?? item,
+          item: (0, import_content_ir7.asKindInstance)(item, kind) ?? item,
           itemKind: kind,
           title,
           subtitle: `${display.title} \xB7 item ${index + 1} of ${total}`,
@@ -1038,46 +1186,81 @@ function ItemRow({
         title: "Open to read it",
         children: body
       }
-    ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "flex min-w-0 flex-1 items-center gap-2 px-1 py-0.5", children: body }),
+    ) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "flex min-w-0 flex-1 items-center gap-2 px-1 py-0.5", children: body }),
     host.renderCopy?.({ label: title, value: item, kind, size: "xs" })
   ] });
 }
+function TargetRow({
+  directive,
+  item,
+  recordId
+}) {
+  const host = useDirectiveHost();
+  const fallback = recordFallbackName((0, import_content_ir7.nounLabel)(directive.noun, host.nouns), recordId);
+  const changes = directive.directiveClass === "update" ? itemChanges(item) : [];
+  const name = host.renderRecord ? host.renderRecord({ noun: directive.noun, id: recordId, fallback, context: "row" }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "truncate font-medium text-foreground", children: fallback });
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "py-1 text-xs", "data-directive-target": recordId, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex min-w-0 items-center gap-2", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "flex min-w-0 flex-1 items-center gap-1 px-1", children: name }),
+      host.renderCopy?.({ label: fallback, value: item, size: "xs" })
+    ] }),
+    directive.directiveClass === "update" ? changes.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "px-1 text-[11px] text-muted-foreground", children: "Sets no fields \u2014 nothing would change." }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("ul", { className: "mt-0.5 space-y-0.5 px-1", children: changes.map((change) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+      "li",
+      {
+        className: "flex min-w-0 items-baseline gap-1.5 text-[11px]",
+        title: `${change.label} \u2192 ${change.full}`,
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "shrink-0 text-muted-foreground", children: change.label }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { "aria-hidden": true, className: "shrink-0 text-muted-foreground", children: "\u2192" }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+            "span",
+            {
+              className: `min-w-0 truncate ${change.clears ? "italic text-muted-foreground" : "text-foreground"}`,
+              children: change.value
+            }
+          )
+        ]
+      },
+      change.key
+    )) }) : null
+  ] });
+}
 function SideEffectDirectiveCard({ directive }) {
   const host = useDirectiveHost();
   const [expanded, setExpanded] = (0, import_react5.useState)(false);
   const items = directive.items;
   const total = items.length;
-  const display = (0, import_content_ir5.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
+  const display = (0, import_content_ir7.directiveDisplay)(directive.directiveClass, directive.noun, host.nouns);
   const Icon = classIcon(directive.directiveClass, directive.noun);
   const shown = expanded ? items : items.slice(0, ROWS_BEFORE_FOLD);
   const hidden = total - shown.length;
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "text-sm font-medium text-foreground", children: display.title }),
-      display.family ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { className: "text-xs tabular-nums text-muted-foreground", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "text-sm font-medium text-foreground", children: display.title }),
+      display.family ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "text-xs tabular-nums text-muted-foreground", children: [
         total,
         " ",
         total === 1 ? "item" : "items"
       ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "ml-auto flex items-center gap-1", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "ml-auto flex items-center gap-1", children: [
         host.renderCopy?.({ label: display.title, value: directive.shell, size: "icon" }),
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ApplyDirectiveButton, { directive, itemCount: total })
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ApplyDirectiveButton, { directive, itemCount: total })
       ] })
     ] }),
     total === 0 ? (
       // Stated, never silent: an empty batch is a real (and suspicious) state.
-      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
-    ) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ItemRow, { directive, item, index: i, total }, i)) }),
-    hidden > 0 || expanded ? /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
+    ) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ItemRow, { directive, item, index: i, total }, i)) }),
+    hidden > 0 || expanded ? /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
       "button",
       {
         type: "button",
         onClick: () => setExpanded((v) => !v),
         className: "mt-0.5 inline-flex items-center gap-1 rounded px-1 py-0.5 text-[11px] text-muted-foreground hover:text-foreground",
         children: [
-          expanded ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ChevronDownIcon, { className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(ChevronRightIcon, { className: "h-3 w-3" }),
+          expanded ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ChevronDownIcon, { className: "h-3 w-3" }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(ChevronRightIcon, { className: "h-3 w-3" }),
           expanded ? "Show less" : `Show ${hidden} more`
         ]
       }
@@ -1086,17 +1269,28 @@ function SideEffectDirectiveCard({ directive }) {
 }
 
 // directives/DirectiveRender.tsx
-var import_jsx_runtime7 = require("react/jsx-runtime");
-function DirectiveRender({ content, className }) {
+var import_jsx_runtime8 = require("react/jsx-runtime");
+function isWholeJson(content) {
+  try {
+    JSON.parse(content);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function DirectiveRender({ content, className, streaming }) {
   const host = useDirectiveHost();
-  const directive = (0, import_content_ir6.tryDecodeDirectiveContent)(content, (message) => {
+  const directive = (0, import_content_ir8.tryDecodeDirectiveContent)(content, (message) => {
     const line = `[kind-directives] ${message}`;
     if (host.reportError) host.reportError(line);
     else console.error(line);
   });
   if (!directive) {
+    if (typeof content === "string" && (0, import_content_ir8.looksLikeDirectiveHead)(content) && !isWholeJson(content)) {
+      return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DirectiveProvisionalCard, { content, streaming: streaming !== false, className });
+    }
     const raw = typeof content === "string" ? content : JSON.stringify(content, null, 2);
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       "pre",
       {
         className: `my-3 overflow-x-auto rounded-md border border-border bg-muted px-3 py-2 text-xs text-muted-foreground${className ? ` ${className}` : ""}`,
@@ -1105,26 +1299,26 @@ function DirectiveRender({ content, className }) {
     );
   }
   const Renderer = getDirectiveRenderer(directive);
-  if (Renderer) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Renderer, { directive });
-  if (directive.parsed.executes) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(SideEffectDirectiveCard, { directive });
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DirectiveFallbackCard, { directive });
+  if (Renderer) return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Renderer, { directive });
+  if (directive.parsed.executes) return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(SideEffectDirectiveCard, { directive });
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(DirectiveFallbackCard, { directive });
 }
 
 // react/KindInstanceRender.tsx
-var import_jsx_runtime8 = require("react/jsx-runtime");
+var import_jsx_runtime9 = require("react/jsx-runtime");
 function isRecordValue(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function kindIsRoutable(kind, host) {
-  if ((0, import_content_ir7.isReservedDirectiveSlug)(kind)) return true;
+  if ((0, import_content_ir9.isReservedDirectiveSlug)(kind)) return true;
   if (host.kinds.getDefinition(kind)?.legacyBlockType) return true;
   const resolution = host.components.resolve(kind, host.platform, "output");
   if (!resolution?.isActive) return false;
   return resolution.componentKey !== GENERIC_STRUCTURED_COMPONENT_KEY;
 }
 function KindInstanceRender(props) {
-  if ((0, import_content_ir7.isReservedDirectiveSlug)(props.kind)) {
-    return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+  if ((0, import_content_ir9.isReservedDirectiveSlug)(props.kind)) {
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
       DirectiveRender,
       {
         content: props.value,
@@ -1132,7 +1326,7 @@ function KindInstanceRender(props) {
       }
     );
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(KindInstanceRenderInner, { ...props });
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(KindInstanceRenderInner, { ...props });
 }
 function KindInstanceRenderInner({
   kind,
@@ -1178,24 +1372,24 @@ function KindInstanceRenderInner({
     content: JSON.stringify(value, null, 2),
     language: "json",
     metadata: {
-      [import_content_ir7.IR_ENVELOPE_KEY]: (0, import_content_ir7.envelopeFromCompleteValue)(value, kind)
+      [import_content_ir9.IR_ENVELOPE_KEY]: (0, import_content_ir9.envelopeFromCompleteValue)(value, kind)
     }
   } : null;
   const frameClass = variant === "bare" ? void 0 : "rounded-md border border-border bg-card p-3";
   if (routingStatus === "unroutable" && unroutableFallback !== void 0) {
-    return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_jsx_runtime8.Fragment, { children: unroutableFallback });
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_jsx_runtime9.Fragment, { children: unroutableFallback });
   }
   const onTheFloor = block === null || routingStatus === "unroutable";
   const notice = "This shape has no custom component yet, so it renders through the universal viewer \u2014 exactly what production shows today.";
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: className ? `space-y-3 ${className}` : "space-y-3", children: [
-    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { className: "rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-xs text-amber-800 dark:text-amber-200", children: notice }) : null,
-    /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: className ? `space-y-3 ${className}` : "space-y-3", children: [
+    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: "rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-xs text-amber-800 dark:text-amber-200", children: notice }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
   ] });
 }
 
 // react/ProvisionalKindBoundary.tsx
 var import_react7 = __toESM(require("react"), 1);
-var import_jsx_runtime9 = require("react/jsx-runtime");
+var import_jsx_runtime10 = require("react/jsx-runtime");
 var ProvisionalKindBoundaryInner = class extends import_react7.default.Component {
   state = { failed: false };
   static getDerivedStateFromError() {
@@ -1220,25 +1414,25 @@ var ProvisionalKindBoundaryInner = class extends import_react7.default.Component
 };
 function ProvisionalKindBoundary(props) {
   const host = useContentIrHost();
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
 }
 function ProvisionalKindFrame({ children }) {
   const host = useContentIrHost();
   const label = "Still arriving";
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { className: "relative", "aria-busy": "true", children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "relative", "aria-busy": "true", children: [
     children,
-    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "pointer-events-none absolute -top-2 right-4 z-10 select-none rounded-full bg-background px-1.5 leading-4", children: host.renderShimmer?.(label) ?? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("span", { className: "text-[10px] text-muted-foreground", children: label }) })
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { className: "pointer-events-none absolute -top-2 right-4 z-10 select-none rounded-full bg-background px-1.5 leading-4", children: host.renderShimmer?.(label) ?? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { className: "text-[10px] text-muted-foreground", children: label }) })
   ] });
 }
 
 // react/GenericStructuredView.tsx
 var import_react8 = require("react");
-var import_content_ir8 = require("@ai-matrx/content-ir");
-var import_jsx_runtime10 = require("react/jsx-runtime");
+var import_content_ir10 = require("@ai-matrx/content-ir");
+var import_jsx_runtime11 = require("react/jsx-runtime");
 function readStructuredValue(content, metadata) {
-  const envelope = (0, import_content_ir8.readEnvelope)(metadata);
+  const envelope = (0, import_content_ir10.readEnvelope)(metadata);
   if (envelope) {
-    return { value: (0, import_content_ir8.reconstructRegionValue)(envelope), recovered: true };
+    return { value: (0, import_content_ir10.reconstructRegionValue)(envelope), recovered: true };
   }
   try {
     return { value: JSON.parse(content), recovered: true };
@@ -1253,25 +1447,25 @@ function GenericStructuredView({
   className
 }) {
   const host = useContentIrHost();
-  const envelope = (0, import_content_ir8.readEnvelope)(metadata);
+  const envelope = (0, import_content_ir10.readEnvelope)(metadata);
   const status = envelope?.root.status ?? "complete";
   const { value, recovered } = readStructuredValue(content, metadata);
-  const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? (0, import_content_ir8.readObjectKind)(value) : null) ?? "";
+  const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? (0, import_content_ir10.readObjectKind)(value) : null) ?? "";
   const marker = readIrRouteMarker(metadata);
   const note = marker?.reason === "inactive" ? "a custom view is registered but held inactive" : marker?.reason === "broken-instance" ? "this instance did not match the shape's schema" : marker?.reason === "unregistered" ? "this shape isn't registered on this platform" : "no custom view yet";
-  return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
-    status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
+  return /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
+    status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
     recovered ? host.renderValue({ value, ...kind ? { kind } : {}, note }) : (
       // Zero-data-loss backstop: the region never parsed, so show the source
       // verbatim rather than swallowing it.
-      /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
+      /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
     )
   ] });
 }
 
 // react/RuntimeWrapperViews.tsx
-var import_content_ir9 = require("@ai-matrx/content-ir");
-var import_jsx_runtime11 = require("react/jsx-runtime");
+var import_content_ir11 = require("@ai-matrx/content-ir");
+var import_jsx_runtime12 = require("react/jsx-runtime");
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1287,16 +1481,16 @@ function DelegatedOutput({
 }) {
   const host = useContentIrHost();
   if (output === null || output === void 0) {
-    return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
+    return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
   }
   if (!isRecord2(output)) {
-    return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_jsx_runtime11.Fragment, { children: host.renderValue({ value: output }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_jsx_runtime12.Fragment, { children: host.renderValue({ value: output }) });
   }
-  const kind = (0, import_content_ir9.readObjectKind)(output) ?? declaredKind;
+  const kind = (0, import_content_ir11.readObjectKind)(output) ?? declaredKind;
   if (!kind) {
-    return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_jsx_runtime11.Fragment, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_jsx_runtime12.Fragment, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
     KindInstanceRender,
     {
       kind,
@@ -1310,10 +1504,10 @@ function DelegatedOutput({
 function NodeOutcomeView({ serverData, fallback }) {
   const wrapper = readWrapperFrom(
     serverData,
-    import_content_ir9.readNodeOutcomeValue
+    import_content_ir11.readNodeOutcomeValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
     DelegatedOutput,
     {
       output: wrapper.output,
@@ -1325,17 +1519,17 @@ function NodeOutcomeView({ serverData, fallback }) {
 function RunResultView({ serverData, fallback }) {
   const wrapper = readWrapperFrom(
     serverData,
-    import_content_ir9.readRunResultValue
+    import_content_ir11.readRunResultValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
     NodeOutcomeView,
     {
       serverData: { wrapper: outcome },
       ...fallback === void 0 ? {} : { fallback }
     },
     `${outcome.node_id}:${outcome.attempt}`
-  )) : /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
+  )) : /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
     DelegatedOutput,
     {
       output: wrapper.output,