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

package/dist/index.d.cts

@@ -268,12 +268,32 @@ interface DirectiveFallbackCardProps {
 }
 declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
 
+/** The directive slug of a partial document, once its closing quote has arrived. */
+declare function provisionalDirectiveSlug(content: string): string | null;
+interface DirectiveProvisionalCardProps {
+    /** The partial fence body as received so far. */
+    content: string;
+    /**
+     * Whether the document may still be arriving. `false` means the stream is
+     * over and the document never completed — the card says it was cut off.
+     */
+    streaming: boolean;
+    className?: string | undefined;
+}
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
     content: unknown;
     className?: string;
+    /**
+     * Whether the document may still be arriving. A host that knows its stream
+     * has ended passes `false`, so an undecodable directive head is shown as CUT
+     * OFF rather than "writing…" forever. Omitted = it may still be arriving.
+     */
+    streaming?: boolean;
 }
-declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ content, className, streaming }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -538,4 +558,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, provisionalDirectiveSlug, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };

package/dist/index.d.ts

@@ -268,12 +268,32 @@ interface DirectiveFallbackCardProps {
 }
 declare function DirectiveFallbackCard({ directive, reason }: DirectiveFallbackCardProps): react.JSX.Element;
 
+/** The directive slug of a partial document, once its closing quote has arrived. */
+declare function provisionalDirectiveSlug(content: string): string | null;
+interface DirectiveProvisionalCardProps {
+    /** The partial fence body as received so far. */
+    content: string;
+    /**
+     * Whether the document may still be arriving. `false` means the stream is
+     * over and the document never completed — the card says it was cut off.
+     */
+    streaming: boolean;
+    className?: string | undefined;
+}
+declare function DirectiveProvisionalCard({ content, streaming, className }: DirectiveProvisionalCardProps): react.JSX.Element;
+
 interface DirectiveRenderProps {
     /** The fence body (JSON string) or an already-parsed shell / value. */
     content: unknown;
     className?: string;
+    /**
+     * Whether the document may still be arriving. A host that knows its stream
+     * has ended passes `false`, so an undecodable directive head is shown as CUT
+     * OFF rather than "writing…" forever. Omitted = it may still be arriving.
+     */
+    streaming?: boolean;
 }
-declare function DirectiveRender({ content, className }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ content, className, streaming }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * The DB-component COMPILE CACHE — session-scoped, keyed per winning row
@@ -538,4 +558,4 @@ declare class DbKindComponentErrorBoundary extends react.Component<DbKindCompone
     render(): react.ReactNode;
 }
 
-export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };
+export { ApplyDirectiveButton, type ApplyDirectiveButtonProps, type CompiledDbKindComponent, ComponentResolution, ComponentResolutionSource, ContentIrErrorReporter, ContentIrHost, ContentIrRenderProvider, type ContentIrRenderProviderProps, type DbKindActionResult, type DbKindCompileResult, type DbKindComponentCache, type DbKindComponentCachePorts, type DbKindComponentCompiler, DbKindComponentErrorBoundary, type DbKindComponentErrorBoundaryProps, type DbKindComponentIncident, type DbKindComponentIncidentSink, type DbKindComponentIncidentType, type DbKindComponentRenderProps, DelegatedOutput, type DelegatedOutputProps, DirectiveFallbackCard, type DirectiveFallbackCardProps, DirectiveProvisionalCard, type DirectiveProvisionalCardProps, DirectiveRender, type DirectiveRenderProps, type DirectiveRenderer, type DirectiveRendererProps, GenericStructuredView, type GenericStructuredViewProps, type KindComponentUiOptions, KindDefinitionSource, KindInstanceRender, type KindInstanceRenderProps, KindRouteEnv, type KindVersionSources, NodeOutcomeView, type NodeOutcomeViewProps, ProvisionalKindBoundary, ProvisionalKindFrame, type ResolveKindValue, type RunDbKindAction, RunResultView, type RunResultViewProps, SideEffectDirectiveCard, type SideEffectDirectiveCardProps, createDbKindComponentCache, getDirectiveRenderer, isDbKindComponentBodyPending, isRecordValue, kindIsRoutable, provisionalDirectiveSlug, registerDirectiveRenderer, resetDirectiveRenderers, useContentIrHost, useContentIrHostOrNull, useContentIrKindVersion, useKindRouteEnv };

package/dist/index.js

@@ -708,7 +708,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";
@@ -907,6 +907,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
@@ -932,13 +972,13 @@ function resetDirectiveRenderers() {
 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,
@@ -952,20 +992,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",
@@ -983,7 +1023,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" })
   ] });
 }
@@ -992,37 +1032,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`
         ]
       }
@@ -1031,8 +1071,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}`;
@@ -1040,8 +1088,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}` : ""}`,
@@ -1050,13 +1101,13 @@ 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 });
 }
 
 // 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);
 }
@@ -1069,7 +1120,7 @@ function kindIsRoutable(kind, host) {
 }
 function KindInstanceRender(props) {
   if (isReservedDirectiveSlug2(props.kind)) {
-    return /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx9(
       DirectiveRender,
       {
         content: props.value,
@@ -1077,7 +1128,7 @@ function KindInstanceRender(props) {
       }
     );
   }
-  return /* @__PURE__ */ jsx8(KindInstanceRenderInner, { ...props });
+  return /* @__PURE__ */ jsx9(KindInstanceRenderInner, { ...props });
 }
 function KindInstanceRenderInner({
   kind,
@@ -1128,19 +1179,19 @@ 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) })
   ] });
 }
 
 // react/ProvisionalKindBoundary.tsx
 import React from "react";
-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() {
@@ -1165,14 +1216,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 }) })
   ] });
 }
 
@@ -1183,7 +1234,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) {
@@ -1208,19 +1259,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);
 }
@@ -1236,16 +1287,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,
@@ -1262,7 +1313,7 @@ function NodeOutcomeView({ serverData, fallback }) {
     readNodeOutcomeValue
   );
   if (!wrapper) return null;
-  return /* @__PURE__ */ jsx11(
+  return /* @__PURE__ */ jsx12(
     DelegatedOutput,
     {
       output: wrapper.output,
@@ -1277,14 +1328,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,
@@ -1490,6 +1541,7 @@ export {
   DelegatedOutput,
   DirectiveFallbackCard,
   DirectiveHostProvider,
+  DirectiveProvisionalCard,
   DirectiveRender,
   GENERIC_STRUCTURED_COMPONENT_KEY,
   GenericStructuredView,
@@ -1514,6 +1566,7 @@ export {
   kindIsRoutable,
   kindServerDataFromStoredValue,
   markKindPartialUnsafe,
+  provisionalDirectiveSlug,
   readIrRouteMarker,
   registerDirectiveRenderer,
   resetDirectiveRenderers,