@ai-matrx/content-ir-react 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.11.1 — 2026-09-09
+
+- **A completed partial kind now hands off directly to its real renderer.**
+  Workflow run pages shadow the raw text channel while server-built blocks
+  stream, so a `superseded` terminal can arrive on a completed `code` block
+  without a verified `__ir` envelope. The shared route now reconstructs a
+  render-local complete envelope from the block's closed JSON, verifies that
+  its root `__kind` matches the producer-confirmed kind, and routes through the
+  normal component path in that same frame. Retracted, malformed, and
+  mismatched terminals remain on the host's honest fallback.
+
+### Consumer action
+
+- Hosts rendering server-built workflow blocks should call the new
+  `resolveSupersededKindRender` binding before ordinary kind routing so a
+  finished node cannot flash raw Shape JSON while sibling nodes continue.
+
 ## 0.11.0 — 2026-09-08
 
 **THE DIRECTIVE TIER — `/directives`.** Every AI Matrx UI draws a Kind

package/dist/index.cjs

@@ -70,6 +70,7 @@ __export(index_exports, {
   resetSourcelessDbRowReports: () => resetSourcelessDbRowReports,
   resolveAnnouncedKindLoading: () => resolveAnnouncedKindLoading,
   resolveProvisionalKindRender: () => resolveProvisionalKindRender,
+  resolveSupersededKindRender: () => resolveSupersededKindRender,
   routeEnvOf: () => routeEnvOf,
   useContentIrHost: () => useContentIrHost,
   useContentIrHostOrNull: () => useContentIrHostOrNull,
@@ -653,6 +654,36 @@ function resolveAnnouncedKindLoading(block, options) {
   if (verified && verified.root.status === "complete") return null;
   return { kind, envelope: envelopeFromPartialKind(event) };
 }
+function parseCompletedJsonObject(content) {
+  let source = content.trim();
+  const fenced = source.match(/^```(?:json)?\s*\n?([\s\S]*?)\n?```$/i);
+  if (fenced?.[1]) source = fenced[1].trim();
+  try {
+    const value = JSON.parse(source);
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+function resolveSupersededKindRender(block, env, options) {
+  const event = (0, import_content_ir2.readPartialKindEvent)(block.metadata);
+  if (event?.state !== "superseded") return null;
+  if ((0, import_content_ir2.readEnvelope)(block.metadata)?.root.status === "complete") return null;
+  const value = parseCompletedJsonObject(block.content);
+  if (!value || (0, import_content_ir2.readObjectKind)(value) !== event.kind) return null;
+  const { [import_content_ir2.IR_PARTIAL_KEY]: _partial, ...rest } = block.metadata ?? {};
+  void _partial;
+  const envelope = (0, import_content_ir2.envelopeFromCompleteValue)(value, event.kind);
+  const terminalBlock = {
+    ...block,
+    // A code/json block's serverData is an annotation, not kind data.
+    serverData: void 0,
+    metadata: { ...rest, [import_content_ir2.IR_ENVELOPE_KEY]: envelope }
+  };
+  const routed = applyIrKindRoute(terminalBlock, env, options);
+  if (routed === terminalBlock) return null;
+  return { block: routed, kind: event.kind, seq: event.seq, envelope };
+}
 function resolveProvisionalKindRender(block, env, options) {
   if (options?.streamActive === false) return null;
   const event = (0, import_content_ir2.readPartialKindEvent)(block.metadata);
@@ -693,7 +724,12 @@ function createKindRouteBinding(env, options) {
     resolveProvisionalKindRender: (block, streamOptions) => resolveProvisionalKindRender(block, env, {
       ...streamOptions,
       ...ownedTypes ? { ownedTypes } : null
-    })
+    }),
+    resolveSupersededKindRender: (block) => resolveSupersededKindRender(
+      block,
+      env,
+      ownedTypes ? { ownedTypes } : void 0
+    )
   };
 }