@ai-matrx/content-ir-react 0.11.9 → 0.11.11

package/dist/react.js

@@ -78,7 +78,7 @@ import {
 } from "@ai-matrx/content-ir";
 
 // directives/DirectiveRender.tsx
-import { tryDecodeDirectiveContent } from "@ai-matrx/content-ir";
+import { looksLikeDirectiveHead, tryDecodeDirectiveContent } from "@ai-matrx/content-ir";
 
 // directives/DirectiveFallbackCard.tsx
 import { directiveDisplay } from "@ai-matrx/content-ir";
@@ -277,6 +277,46 @@ function DirectiveFallbackCard({ directive, reason }) {
   ] });
 }
 
+// directives/DirectiveProvisionalCard.tsx
+import { directiveDisplay as directiveDisplay2, parseDirectiveSlug } from "@ai-matrx/content-ir";
+import { jsx as jsx6, jsxs as jsxs4 } from "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 ? parseDirectiveSlug(slug) : null;
+  const display = known ? directiveDisplay2(known.directiveClass, known.noun, host.nouns) : null;
+  const Icon = known ? classIcon(known.directiveClass, known.noun) : BoxesIcon;
+  const title = display?.title ?? "Structured action";
+  return /* @__PURE__ */ jsxs4(
+    "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__ */ jsxs4("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+          /* @__PURE__ */ jsx6(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+          /* @__PURE__ */ jsx6("span", { className: "text-sm font-medium text-foreground", children: title }),
+          display?.family ? /* @__PURE__ */ jsx6("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
+          streaming ? /* @__PURE__ */ jsxs4("span", { className: "inline-flex items-center gap-1.5 text-xs text-muted-foreground", role: "status", children: [
+            /* @__PURE__ */ jsx6("span", { className: "h-1.5 w-1.5 animate-pulse rounded-full bg-primary", "aria-hidden": true }),
+            "Writing\u2026"
+          ] }) : /* @__PURE__ */ jsx6("span", { className: "text-xs text-destructive", role: "status", children: "Cut off before it finished \u2014 nothing can be applied." })
+        ] }),
+        streaming ? null : /* @__PURE__ */ jsxs4("details", { className: "mt-1 text-xs text-muted-foreground", children: [
+          /* @__PURE__ */ jsx6("summary", { className: "cursor-pointer select-none hover:text-foreground", children: "Show what arrived" }),
+          /* @__PURE__ */ jsx6("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
 import {
   buildDirectiveSlug
@@ -294,13 +334,13 @@ function getDirectiveRenderer(directive) {
 import { useState as useState2 } from "react";
 import {
   asKindInstance,
-  directiveDisplay as directiveDisplay2,
+  directiveDisplay as directiveDisplay3,
   itemFacts,
   itemSubtitle,
   itemTitle,
   nounTitleColumn
 } from "@ai-matrx/content-ir";
-import { Fragment, jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var ROWS_BEFORE_FOLD = 3;
 function ItemRow({
   directive,
@@ -314,20 +354,20 @@ function ItemRow({
   const subtitle = itemSubtitle(item);
   const facts = itemFacts(item);
   const kind = host.itemKind?.(directive.slug) ?? null;
-  const display = directiveDisplay2(directive.directiveClass, directive.noun, host.nouns);
+  const display = directiveDisplay3(directive.directiveClass, directive.noun, host.nouns);
   const openItem = host.openItem;
-  const body = /* @__PURE__ */ jsxs4(Fragment, { children: [
-    /* @__PURE__ */ jsx6("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
-    /* @__PURE__ */ jsx6("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ jsxs4("span", { className: "truncate text-[11px] text-muted-foreground", children: [
+  const body = /* @__PURE__ */ jsxs5(Fragment, { children: [
+    /* @__PURE__ */ jsx7("span", { className: "min-w-0 shrink-0 truncate font-medium text-foreground", children: title }),
+    /* @__PURE__ */ jsx7("span", { className: "hidden min-w-0 flex-1 items-baseline gap-2 overflow-hidden sm:flex", children: facts.map((fact) => /* @__PURE__ */ jsxs5("span", { className: "truncate text-[11px] text-muted-foreground", children: [
       fact.value,
       " ",
       fact.label
     ] }, fact.key)) }),
-    subtitle && facts.length === 0 ? /* @__PURE__ */ jsx6("span", { className: "hidden truncate text-[11px] text-muted-foreground sm:inline", children: subtitle }) : null,
-    openItem ? /* @__PURE__ */ jsx6(MaximizeIcon, { className: "ml-auto h-3 w-3 shrink-0 text-muted-foreground" }) : null
+    subtitle && facts.length === 0 ? /* @__PURE__ */ jsx7("span", { className: "hidden truncate text-[11px] text-muted-foreground sm:inline", children: subtitle }) : null,
+    openItem ? /* @__PURE__ */ jsx7(MaximizeIcon, { className: "ml-auto h-3 w-3 shrink-0 text-muted-foreground" }) : null
   ] });
-  return /* @__PURE__ */ jsxs4("div", { className: "flex items-center gap-2 py-1 text-xs", children: [
-    openItem ? /* @__PURE__ */ jsx6(
+  return /* @__PURE__ */ jsxs5("div", { className: "flex items-center gap-2 py-1 text-xs", children: [
+    openItem ? /* @__PURE__ */ jsx7(
       "button",
       {
         type: "button",
@@ -345,7 +385,7 @@ function ItemRow({
         title: "Open to read it",
         children: body
       }
-    ) : /* @__PURE__ */ jsx6("span", { className: "flex min-w-0 flex-1 items-center gap-2 px-1 py-0.5", children: body }),
+    ) : /* @__PURE__ */ jsx7("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" })
   ] });
 }
@@ -354,37 +394,37 @@ function SideEffectDirectiveCard({ directive }) {
   const [expanded, setExpanded] = useState2(false);
   const items = directive.items;
   const total = items.length;
-  const display = directiveDisplay2(directive.directiveClass, directive.noun, host.nouns);
+  const display = directiveDisplay3(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__ */ jsxs4("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
-    /* @__PURE__ */ jsxs4("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-      /* @__PURE__ */ jsx6(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
-      /* @__PURE__ */ jsx6("span", { className: "text-sm font-medium text-foreground", children: display.title }),
-      display.family ? /* @__PURE__ */ jsx6("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
-      /* @__PURE__ */ jsxs4("span", { className: "text-xs tabular-nums text-muted-foreground", children: [
+  return /* @__PURE__ */ jsxs5("div", { className: "my-3 rounded-md border border-border bg-card px-2.5 py-1.5", "data-directive": directive.slug, children: [
+    /* @__PURE__ */ jsxs5("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+      /* @__PURE__ */ jsx7(Icon, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+      /* @__PURE__ */ jsx7("span", { className: "text-sm font-medium text-foreground", children: display.title }),
+      display.family ? /* @__PURE__ */ jsx7("span", { className: "text-xs text-muted-foreground", children: display.family }) : null,
+      /* @__PURE__ */ jsxs5("span", { className: "text-xs tabular-nums text-muted-foreground", children: [
         total,
         " ",
         total === 1 ? "item" : "items"
       ] }),
-      /* @__PURE__ */ jsxs4("div", { className: "ml-auto flex items-center gap-1", children: [
+      /* @__PURE__ */ jsxs5("div", { className: "ml-auto flex items-center gap-1", children: [
         host.renderCopy?.({ label: display.title, value: directive.shell, size: "icon" }),
-        /* @__PURE__ */ jsx6(ApplyDirectiveButton, { directive, itemCount: total })
+        /* @__PURE__ */ jsx7(ApplyDirectiveButton, { directive, itemCount: total })
       ] })
     ] }),
     total === 0 ? (
       // Stated, never silent: an empty batch is a real (and suspicious) state.
-      /* @__PURE__ */ jsx6("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
-    ) : /* @__PURE__ */ jsx6("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx6(ItemRow, { directive, item, index: i, total }, i)) }),
-    hidden > 0 || expanded ? /* @__PURE__ */ jsxs4(
+      /* @__PURE__ */ jsx7("p", { className: "mt-1 text-xs text-muted-foreground", children: "No items \u2014 nothing would be written." })
+    ) : /* @__PURE__ */ jsx7("div", { className: "mt-0.5 divide-y divide-border/60", children: shown.map((item, i) => /* @__PURE__ */ jsx7(ItemRow, { directive, item, index: i, total }, i)) }),
+    hidden > 0 || expanded ? /* @__PURE__ */ jsxs5(
       "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__ */ jsx6(ChevronDownIcon, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx6(ChevronRightIcon, { className: "h-3 w-3" }),
+          expanded ? /* @__PURE__ */ jsx7(ChevronDownIcon, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx7(ChevronRightIcon, { className: "h-3 w-3" }),
           expanded ? "Show less" : `Show ${hidden} more`
         ]
       }
@@ -393,8 +433,16 @@ function SideEffectDirectiveCard({ directive }) {
 }
 
 // directives/DirectiveRender.tsx
-import { jsx as jsx7 } from "react/jsx-runtime";
-function DirectiveRender({ content, className }) {
+import { jsx as jsx8 } from "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 = tryDecodeDirectiveContent(content, (message) => {
     const line = `[kind-directives] ${message}`;
@@ -402,8 +450,11 @@ function DirectiveRender({ content, className }) {
     else console.error(line);
   });
   if (!directive) {
+    if (typeof content === "string" && looksLikeDirectiveHead(content) && !isWholeJson(content)) {
+      return /* @__PURE__ */ jsx8(DirectiveProvisionalCard, { content, streaming: streaming !== false, className });
+    }
     const raw = typeof content === "string" ? content : JSON.stringify(content, null, 2);
-    return /* @__PURE__ */ jsx7(
+    return /* @__PURE__ */ jsx8(
       "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}` : ""}`,
@@ -412,9 +463,9 @@ function DirectiveRender({ content, className }) {
     );
   }
   const Renderer = getDirectiveRenderer(directive);
-  if (Renderer) return /* @__PURE__ */ jsx7(Renderer, { directive });
-  if (directive.parsed.executes) return /* @__PURE__ */ jsx7(SideEffectDirectiveCard, { directive });
-  return /* @__PURE__ */ jsx7(DirectiveFallbackCard, { directive });
+  if (Renderer) return /* @__PURE__ */ jsx8(Renderer, { directive });
+  if (directive.parsed.executes) return /* @__PURE__ */ jsx8(SideEffectDirectiveCard, { directive });
+  return /* @__PURE__ */ jsx8(DirectiveFallbackCard, { directive });
 }
 
 // route/kind-route.ts
@@ -442,7 +493,7 @@ function readIrRouteMarker(metadata) {
 }
 
 // react/KindInstanceRender.tsx
-import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 function isRecordValue(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -455,7 +506,7 @@ function kindIsRoutable(kind, host) {
 }
 function KindInstanceRender(props) {
   if (isReservedDirectiveSlug2(props.kind)) {
-    return /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx9(
       DirectiveRender,
       {
         content: props.value,
@@ -463,7 +514,7 @@ function KindInstanceRender(props) {
       }
     );
   }
-  return /* @__PURE__ */ jsx8(KindInstanceRenderInner, { ...props });
+  return /* @__PURE__ */ jsx9(KindInstanceRenderInner, { ...props });
 }
 function KindInstanceRenderInner({
   kind,
@@ -514,13 +565,13 @@ function KindInstanceRenderInner({
   } : null;
   const frameClass = variant === "bare" ? void 0 : "rounded-md border border-border bg-card p-3";
   if (routingStatus === "unroutable" && unroutableFallback !== void 0) {
-    return /* @__PURE__ */ jsx8(Fragment2, { children: unroutableFallback });
+    return /* @__PURE__ */ jsx9(Fragment2, { 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__ */ jsxs5("div", { className: className ? `space-y-3 ${className}` : "space-y-3", children: [
-    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ jsx8("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__ */ jsx8("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
+  return /* @__PURE__ */ jsxs6("div", { className: className ? `space-y-3 ${className}` : "space-y-3", children: [
+    showRoutingNote && routingStatus === "unroutable" ? host.renderNotice?.(notice) ?? /* @__PURE__ */ jsx9("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__ */ jsx9("div", { className: frameClass, children: onTheFloor ? host.renderValue({ value, kind }) : host.renderBlock(block) })
   ] });
 }
 
@@ -547,7 +598,7 @@ function markKindPartialUnsafe(kind) {
 }
 
 // react/ProvisionalKindBoundary.tsx
-import { jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
 var ProvisionalKindBoundaryInner = class extends React.Component {
   state = { failed: false };
   static getDerivedStateFromError() {
@@ -572,14 +623,14 @@ var ProvisionalKindBoundaryInner = class extends React.Component {
 };
 function ProvisionalKindBoundary(props) {
   const host = useContentIrHost();
-  return /* @__PURE__ */ jsx9(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
+  return /* @__PURE__ */ jsx10(ProvisionalKindBoundaryInner, { ...props, reportError: host.reportError });
 }
 function ProvisionalKindFrame({ children }) {
   const host = useContentIrHost();
   const label = "Still arriving";
-  return /* @__PURE__ */ jsxs6("div", { className: "relative", "aria-busy": "true", children: [
+  return /* @__PURE__ */ jsxs7("div", { className: "relative", "aria-busy": "true", children: [
     children,
-    /* @__PURE__ */ jsx9("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__ */ jsx9("span", { className: "text-[10px] text-muted-foreground", children: label }) })
+    /* @__PURE__ */ jsx10("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__ */ jsx10("span", { className: "text-[10px] text-muted-foreground", children: label }) })
   ] });
 }
 
@@ -590,7 +641,7 @@ import {
   readObjectKind as readObjectKind3,
   reconstructRegionValue
 } from "@ai-matrx/content-ir";
-import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
 function readStructuredValue(content, metadata) {
   const envelope = readEnvelope3(metadata);
   if (envelope) {
@@ -615,19 +666,19 @@ function GenericStructuredView({
   const kind = envelope?.root.kind ?? (typeof value === "object" && value !== null && !Array.isArray(value) ? readObjectKind3(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__ */ jsxs7("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
-    status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ jsx10("div", { className: "mb-2 text-xs text-muted-foreground", children: "Still arriving\u2026" }) : null,
+  return /* @__PURE__ */ jsxs8("div", { className: className ? `my-2 min-w-0 ${className}` : "my-2 min-w-0", children: [
+    status === "streaming" ? streamingIndicator ?? /* @__PURE__ */ jsx11("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__ */ jsx10("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
+      /* @__PURE__ */ jsx11("pre", { className: "max-h-96 overflow-auto font-mono text-xs leading-relaxed text-muted-foreground", children: content })
     )
   ] });
 }
 
 // react/RuntimeWrapperViews.tsx
 import { readNodeOutcomeValue, readObjectKind as readObjectKind4, readRunResultValue } from "@ai-matrx/content-ir";
-import { Fragment as Fragment3, jsx as jsx11 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx12 } from "react/jsx-runtime";
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -643,16 +694,16 @@ function DelegatedOutput({
 }) {
   const host = useContentIrHost();
   if (output === null || output === void 0) {
-    return /* @__PURE__ */ jsx11("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
+    return /* @__PURE__ */ jsx12("p", { className: "text-xs text-muted-foreground", children: emptyLabel });
   }
   if (!isRecord2(output)) {
-    return /* @__PURE__ */ jsx11(Fragment3, { children: host.renderValue({ value: output }) });
+    return /* @__PURE__ */ jsx12(Fragment3, { children: host.renderValue({ value: output }) });
   }
   const kind = readObjectKind4(output) ?? declaredKind;
   if (!kind) {
-    return /* @__PURE__ */ jsx11(Fragment3, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
+    return /* @__PURE__ */ jsx12(Fragment3, { children: fallback?.(output) ?? host.renderValue({ value: output }) });
   }
-  return /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsx12(
     KindInstanceRender,
     {
       kind,
@@ -669,7 +720,7 @@ function NodeOutcomeView({ serverData, fallback }) {
     readNodeOutcomeValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsx12(
     DelegatedOutput,
     {
       output: wrapper.output,
@@ -684,14 +735,14 @@ function RunResultView({ serverData, fallback }) {
     readRunResultValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ jsx11("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsx12("div", { className: "space-y-2", children: wrapper.outputs.length > 0 ? wrapper.outputs.map((outcome) => /* @__PURE__ */ jsx12(
     NodeOutcomeView,
     {
       serverData: { wrapper: outcome },
       ...fallback === void 0 ? {} : { fallback }
     },
     `${outcome.node_id}:${outcome.attempt}`
-  )) : /* @__PURE__ */ jsx11(
+  )) : /* @__PURE__ */ jsx12(
     DelegatedOutput,
     {
       output: wrapper.output,