@ai-matrx/chat 0.5.6 → 0.5.11

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # @ai-matrx/chat
 
+## 0.5.11
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.5.8..npm/chat/v0.5.11 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.5.10 — message Print is the one message print
+
+- `conversation/utils/markdown-print` delegates to `@ai-matrx/rich-content/copy/print-message`
+  (`printMarkdownContent` now always returns a Promise). Needs rich-content ≥ 0.2.58.
+
+Consumer action: none.
+
+## Unreleased — lane L4b rendered-output
+### an artifact edit shows its new version
+
+`getToolArtifact` maps a completed `edit_artifact` call to a new `canvas_item` kind (`id` = the new
+version's `canvas_items.id`, `version`); the tool card draws a "Page · Edited" bar and, under it, the
+host slot **`CanvasItemCard`** (`{ canvasItemId, version? }`) — the version's own card rendered through
+the host's block registry. Unregistered, the slot draws nothing. **Consumer action:** register
+`CanvasItemCard` (matrx-frontend renders the item through its artifact renderer registry).
+
+## 0.5.9
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.5.5..npm/chat/v0.5.9 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.5.8 — attach from outside React
+
+- `attachResourceToConversation(store, conversationId, resource)` — THE attach path without a hook
+  (`useAttachResource` is it bound to the app store); `attachRenderedArtifact(store, conversationId,
+  args)` — the same for a rendered page, for a canvas "Attach to chat ▸" entry or any host port.
+- Consumer action: none required; a canvas host may wire `attachRenderedArtifact` into
+  `CanvasOutputPorts.attachOptions`.
+
+## 0.5.7 — a registry/list disagreement no longer crashes the page
+
+- The context-items load-time drift check logs a loud console error instead of throwing; the
+  unregistered type renders through the generic fallback body. A jest test fails on any disagreement.
+
 ## 0.5.6 — 0.5.5 threw at load
 
 - `CONTEXT_ITEM_BLOCK_TYPES` lists `rendered_artifact`: 0.5.5 registered the def without it, so the

package/dist/agent-copy/RichCopySplit.d.ts

@@ -12,8 +12,9 @@ export type RichCopySplitProps = MatrxCopyMenuProps & {
     exportTitle?: string;
 };
 /**
- * THE content action set of a markdown host (ContentActions, Arman 2026-10-08: copy, Plain,
- * Export, Print and Transform each one click away; Transform opens the Alchemy palette below).
+ * THE content action set of a markdown host (ContentActions, Arman 2026-10-08 revised): ONE Copy icon
+ * (raw, then Copy raw / formatted / for AI — the host's `agent` envelope), Raw/Formatted, and "…" with
+ * Alchemy… (the palette below), the downloads and Print.
  * Formerly the split Copy of a markdown host (Arman, 2026-10-04: "one click to get either the markdown
  * version or the no-markup version"). One click copies the person's flavor (`copy.default_flavor`);
  * the chevron offers exactly Copy markdown and Copy plain text (2026-10-07). The Alchemy palette

package/dist/agent-copy/RichCopySplit.js

@@ -5,6 +5,7 @@ import { ContentActions } from "@ai-matrx/rich-content/copy/ContentActions";
 import { copyRichContent } from "@ai-matrx/rich-content/copy/copy-commands";
 import { ExportPaletteAnchor, openExportPalette, useExportPaletteKey } from "@ai-matrx/rich-content/copy/ExportPalette";
 import { cn } from "@ai-matrx/design-system";
+import { buildAgentPayload } from "@ai-matrx/alchemy/operate";
 import { CopyButtons } from "../host/ui-slots.js";
 function RichCopySplit(props) {
   const { human, className, size } = props;
@@ -25,7 +26,11 @@ function RichCopySplit(props) {
         },
         copy,
         size: splitSize,
-        label: `Copy ${props.label ?? ""}`.trim(),
+        label: props.label ?? "content",
+        copyForAi: props.agent ? async () => {
+          const built = typeof props.agent === "function" ? await props.agent() : props.agent;
+          return typeof built === "string" ? built : buildAgentPayload(built, { url: window.location.href, capturedAt: (/* @__PURE__ */ new Date()).toISOString() });
+        } : void 0,
         title: props.exportTitle ?? props.label,
         viewKey: props.viewKey,
         onTransform: () => void openExportPalette(exportKey)

package/dist/agents/components/context-items/registry.d.ts

@@ -17,6 +17,7 @@ import type { ComponentType } from "react";
 import { hasContextItemDef } from "./context-item-block-types.js";
 import type { ContextItemBodyProps, ContextItemTitleProps, ContextItemTypeDef } from "./types.js";
 export declare const CONTEXT_ITEM_TYPE_DEFS: ContextItemTypeDef[];
+export declare function findContextItemRegistryDrift(): string[];
 export { hasContextItemDef };
 /** Resolve the registered def for a block type, or a graceful fallback. */
 export declare function resolveContextItemDef(blockType: string): ContextItemTypeDef;

package/dist/agents/components/context-items/registry.js

@@ -339,14 +339,17 @@ const FALLBACK_DEF = {
   editable: false,
   Body: GenericBody
 };
-{
+function findContextItemRegistryDrift() {
   const listed = new Set(CONTEXT_ITEM_BLOCK_TYPES);
-  const drift = [
+  return [
     ...[...BY_BLOCK_TYPE.keys()].filter((t) => !listed.has(t)),
     ...CONTEXT_ITEM_BLOCK_TYPES.filter((t) => !BY_BLOCK_TYPE.has(t))
   ];
+}
+{
+  const drift = findContextItemRegistryDrift();
   if (drift.length > 0) {
-    throw new Error(
+    console.error(
       `context-items registry and CONTEXT_ITEM_BLOCK_TYPES disagree: ${drift.join(", ")}`
     );
   }
@@ -371,6 +374,7 @@ function resolveContextItemTitle(blockType) {
 }
 export {
   CONTEXT_ITEM_TYPE_DEFS,
+  findContextItemRegistryDrift,
   hasContextItemDef,
   resolveContextItemBody,
   resolveContextItemDef,

package/dist/agents/components/inputs/resources/attach-resource.d.ts

@@ -1,3 +1,23 @@
+/**
+ * attach-resource — the single mapping from a picked `Resource` to how it gets
+ * attached to a conversation, shared by every surface that attaches resources
+ * (SmartAgentResourcePickerButton, the RunControlsMenu Attach tab, …).
+ *
+ * TWO attach shapes, by kind:
+ *  - A stored FILE → a DURABLE `platform.associations` edge to the conversation
+ *    (`file → conversation`). The file ID means its complete existing family,
+ *    including processed documents and Knowledge. This PERSISTS across turns and reloads; the
+ *    backend reads the conversation's edges at call time and injects the context.
+ *    The chip renders from the edge list (see `AttachedDocumentChips`), NOT the
+ *    ephemeral `instanceResources` slice.
+ *  - Before the conversation row exists, the same stored FILE identity is held
+ *    as a `processed_document` instance resource and emitted in request.context.
+ *    It is never downgraded to a provider-native PDF block.
+ *  - Everything else (media bytes, notes, tasks, webpages, …) → the per-turn
+ *    `instanceResources` block. A document with no durable file identity still
+ *    rides content[] as binary media.
+ */
+import type { Dispatch } from "@reduxjs/toolkit";
 import type { ChatRootState } from "../../../../store/root-state.js";
 import type { Resource } from "../../../resources/types.js";
 import type { ResourceBlockType } from "../../../types/instance.types.js";
@@ -24,7 +44,17 @@ export declare function findIdenticalResourceId(state: ChatRootState, conversati
  * the per-turn binary/instanceResources path unchanged. Closing the hosting
  * popover is the CALLER's job.
  */
+/** The store handles a non-React caller passes to the attach functions. */
+export interface AttachStore {
+    dispatch: Dispatch;
+    getState: () => unknown;
+}
 export declare function useAttachResource(conversationId: string): (resource: Resource) => Promise<boolean>;
+/**
+ * THE attach path, callable outside React (a canvas menu entry, a host port).
+ * `useAttachResource` is this bound to the app store.
+ */
+export declare function attachResourceToConversation(store: AttachStore, conversationId: string, resource: Resource): Promise<boolean>;
 /**
  * Inverse of `useAttachResource` for files toggled in the live picker.
  * Owned media can have both a durable authorization edge and a per-turn media

package/dist/agents/components/inputs/resources/attach-resource.js

@@ -183,7 +183,15 @@ async function attachConversationFileEdge(conversationId, sourceId, fileId, labe
 function useAttachResource(conversationId) {
   const dispatch = useAppDispatch();
   const store = useAppStore();
-  return async (resource) => {
+  return (resource) => attachResourceToConversation(
+    { dispatch, getState: store.getState },
+    conversationId,
+    resource
+  );
+}
+async function attachResourceToConversation(store, conversationId, resource) {
+  const dispatch = store.dispatch;
+  {
     const getState = () => store.getState();
     const baseBlockType = resourceTypeToBlockType(resource.type);
     const blockType = refineBlockType(baseBlockType, resource.data);
@@ -298,7 +306,7 @@ function useAttachResource(conversationId) {
       resourcePreviewLabel
     );
     return true;
-  };
+  }
 }
 function useDetachResource(conversationId) {
   const dispatch = useAppDispatch();
@@ -342,6 +350,7 @@ function useDetachResource(conversationId) {
   };
 }
 export {
+  attachResourceToConversation,
   findIdenticalResourceId,
   resourceLabel,
   resourceTypeToBlockType,

package/dist/agents/components/inputs/resources/useAttachRenderedArtifact.d.ts

@@ -1,5 +1,6 @@
 import type { RenderedArtifactRepresentation } from "../../../types/instance.types.js";
 import { type RenderedArtifactSource } from "../../../utils/renderedArtifactContext.js";
+import { type AttachStore } from "./attach-resource.js";
 /** What a host capture port returns: a stored cloud image, or a local PNG to upload. */
 export type RenderedCaptureResult = {
     kind: "stored";
@@ -18,3 +19,8 @@ export interface AttachRenderedArtifactArgs {
     capture?: () => Promise<RenderedCaptureResult>;
 }
 export declare function useAttachRenderedArtifact(conversationId: string | null | undefined): (args: AttachRenderedArtifactArgs) => Promise<boolean>;
+/**
+ * The same attach outside React (a canvas "Attach to chat ▸" entry). Without
+ * `uploadFiles`, a capture must answer a STORED image (the server engine).
+ */
+export declare function attachRenderedArtifact(store: AttachStore, conversationId: string | null | undefined, { source, representation, capture }: AttachRenderedArtifactArgs, uploadFiles?: (files: File[]) => Promise<void>): Promise<boolean>;

package/dist/agents/components/inputs/resources/useAttachRenderedArtifact.js

@@ -11,7 +11,7 @@ import { generateResourceId } from "../../../redux/execution-system/utils/ids.js
 import {
   RENDERED_ARTIFACT_BLOCK_TYPE
 } from "../../../utils/renderedArtifactContext.js";
-import { useAttachResource } from "./attach-resource.js";
+import { attachResourceToConversation } from "./attach-resource.js";
 import { useUploadAgentResources } from "./usePasteImageResource.js";
 function screenshotName(title) {
   const base = title.trim().replace(/[^\w\s.-]+/g, "").trim().slice(0, 60) || "page";
@@ -20,88 +20,98 @@ function screenshotName(title) {
 function useAttachRenderedArtifact(conversationId) {
   const dispatch = useAppDispatch();
   const store = useAppStore();
-  const attachResource = useAttachResource(conversationId ?? "");
   const uploadResources = useUploadAgentResources(conversationId ?? "", {
     uploadRoot: "attachments",
     uploadPath: "screenshots"
   });
-  return async ({ source, representation, capture }) => {
-    if (!conversationId) {
-      toast.error("Open a chat to attach this to.");
+  return (args) => attachRenderedArtifact(
+    { dispatch, getState: store.getState },
+    conversationId,
+    args,
+    uploadResources
+  );
+}
+async function attachRenderedArtifact(store, conversationId, { source, representation, capture }, uploadFiles) {
+  const { dispatch } = store;
+  if (!conversationId) {
+    toast.error("Open a chat to attach this to.");
+    return false;
+  }
+  if (representation !== "screenshot") {
+    const resourceId = generateResourceId();
+    dispatch(
+      addResource({
+        conversationId,
+        blockType: RENDERED_ARTIFACT_BLOCK_TYPE,
+        resourceId,
+        source,
+        options: { representation }
+      })
+    );
+    dispatch(
+      setResourcePreview({
+        conversationId,
+        resourceId,
+        preview: `${source.title || "Page"} \xB7 ${representation === "code" ? "Code" : "Text"}`
+      })
+    );
+    return true;
+  }
+  if (!capture) {
+    toast.error("This item can't be captured as an image.");
+    return false;
+  }
+  const name = screenshotName(source.title);
+  const placeholderId = generateResourceId();
+  dispatch(
+    addResource({
+      conversationId,
+      blockType: "image",
+      resourceId: placeholderId,
+      source: { filename: name, mime_type: "image/png" }
+    })
+  );
+  try {
+    const result = await capture();
+    const state = store.getState();
+    if (state.instanceResources.byConversationId[conversationId]?.[placeholderId] === void 0) {
       return false;
     }
-    if (representation !== "screenshot") {
-      const resourceId = generateResourceId();
-      dispatch(
-        addResource({
-          conversationId,
-          blockType: RENDERED_ARTIFACT_BLOCK_TYPE,
-          resourceId,
-          source,
-          options: { representation }
-        })
-      );
-      dispatch(
-        setResourcePreview({
-          conversationId,
-          resourceId,
-          preview: `${source.title || "Page"} \xB7 ${representation === "code" ? "Code" : "Text"}`
-        })
-      );
+    if (result.kind === "file") {
+      if (!uploadFiles) throw new Error("This capture needs an upload, which is not available here");
+      dispatch(removeResource({ conversationId, resourceId: placeholderId }));
+      await uploadFiles([result.file]);
       return true;
     }
-    if (!capture) {
-      toast.error("This item can't be captured as an image.");
-      return false;
-    }
-    const name = screenshotName(source.title);
-    const placeholderId = generateResourceId();
+    const attached = await attachResourceToConversation(store, conversationId, {
+      type: "file",
+      data: {
+        id: result.fileId,
+        filename: name,
+        url: result.url ?? void 0,
+        type: "image/png",
+        mime_type: "image/png",
+        details: { filename: name }
+      }
+    });
+    if (!attached) throw new Error("The screenshot could not be attached");
+    dispatch(removeResource({ conversationId, resourceId: placeholderId }));
+    return true;
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : "Capture failed";
     dispatch(
-      addResource({
+      setResourceStatus({
         conversationId,
-        blockType: "image",
         resourceId: placeholderId,
-        source: { filename: name, mime_type: "image/png" }
+        status: "error",
+        errorMessage: reason
       })
     );
-    try {
-      const result = await capture();
-      const stillAttached = store.getState().instanceResources.byConversationId[conversationId]?.[placeholderId] !== void 0;
-      if (!stillAttached) return false;
-      if (result.kind === "file") {
-        dispatch(removeResource({ conversationId, resourceId: placeholderId }));
-        await uploadResources([result.file]);
-        return true;
-      }
-      const attached = await attachResource({
-        type: "file",
-        data: {
-          id: result.fileId,
-          filename: name,
-          url: result.url ?? void 0,
-          type: "image/png",
-          mime_type: "image/png",
-          details: { filename: name }
-        }
-      });
-      if (!attached) throw new Error("The screenshot could not be attached");
-      dispatch(removeResource({ conversationId, resourceId: placeholderId }));
-      return true;
-    } catch (err) {
-      const reason = err instanceof Error ? err.message : "Capture failed";
-      dispatch(
-        setResourceStatus({
-          conversationId,
-          resourceId: placeholderId,
-          status: "error",
-          errorMessage: reason
-        })
-      );
-      toast.error(`Couldn't capture the page: ${reason}`);
-      return false;
-    }
-  };
+    toast.error(`Couldn't capture the page: ${reason}`);
+    return false;
+  }
 }
 export {
+  attachRenderedArtifact,
   useAttachRenderedArtifact
 };

package/dist/agents/components/inputs/smart-input/composer/ComposerAgentPill.js

@@ -152,7 +152,7 @@ function ChatAgentMenu({
     else onSelectAgent(info.customAgentId, { mandateKey: MANDATE_KEYS.chat__cx_default });
   };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    info.agentId ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Webhook, label: `Agent: ${agentLabel}` }, panelClassName: "w-[340px] h-[420px] p-0", children: /* @__PURE__ */ jsx(ComposerAgentPeek, { agentId: info.agentId, onDone: close }) }) : null,
+    info.agentId ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Webhook, label: `Agent: ${agentLabel}` }, pageTitle: "Agent", panelClassName: "w-[340px] h-[420px] p-0", children: /* @__PURE__ */ jsx(ComposerAgentPeek, { agentId: info.agentId, onDone: close }) }) : null,
     isManualMode ? /* @__PURE__ */ jsx(
       ComposerMenuRow,
       {
@@ -165,6 +165,7 @@ function ChatAgentMenu({
       ComposerSubmenu,
       {
         row: { icon: Cpu, label: `Model: ${info.effectiveModelLabel ?? "Choose a model"}` },
+        pageTitle: "Model",
         panelClassName: MODEL_PICKER_PANEL,
         children: (closePanel) => /* @__PURE__ */ jsx(
           QuickRunModelSelect,
@@ -213,7 +214,7 @@ function AnyAgentRow({
   agentFilter,
   choose
 }) {
-  return /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon, label }, panelClassName: AGENT_PICKER_PANEL, children: /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon, label }, pageTitle: "Agents", panelClassName: AGENT_PICKER_PANEL, children: /* @__PURE__ */ jsx(
     AgentListPanel,
     {
       consumerId: "composer-agent-pill",

package/dist/agents/components/inputs/smart-input/composer/ComposerMenu.d.ts

@@ -105,7 +105,7 @@ export declare function ComposerMenuLevel({ children }: {
  * Popover anchored to the row, so Radix treats it as a child layer: clicking
  * inside it never dismisses the parent menu.
  */
-export declare function ComposerSubmenu({ row, children, panelClassName, open: controlledOpen, onOpenChange, drillInPlace, }: {
+export declare function ComposerSubmenu({ row, children, panelClassName, open: controlledOpen, onOpenChange, drillInPlace, pageTitle, }: {
     row: Omit<ComposerMenuRowProps, "onClick" | "chevron" | "active">;
     children: ReactNode | ((close: () => void) => ReactNode);
     /** Width/height of the cascade panel (e.g. "w-[360px] h-[440px]"). */
@@ -118,6 +118,8 @@ export declare function ComposerSubmenu({ row, children, panelClassName, open: c
      * the menu. The phone sheet pushes pages either way.
      */
     drillInPlace?: boolean;
+    /** The phone sheet's page title when the row's label carries a value ("Model: X" → "Model"). */
+    pageTitle?: string;
 }): import("react").JSX.Element;
 /**
  * What a narrow composer folded out of its rows (Arman, 2026-10-04): its own

package/dist/agents/components/inputs/smart-input/composer/ComposerMenu.js

@@ -243,7 +243,8 @@ function ComposerSubmenu({
   panelClassName,
   open: controlledOpen,
   onOpenChange,
-  drillInPlace
+  drillInPlace,
+  pageTitle
 }) {
   const id = useId();
   const level = useContext(ComposerMenuLevelContext);
@@ -269,7 +270,7 @@ function ComposerSubmenu({
         ...row,
         chevron: true,
         onClick: () => sheetNav.push({
-          title: typeof row.label === "string" ? row.label : "",
+          title: pageTitle ?? (typeof row.label === "string" ? row.label : ""),
           // A panel with no fixed height on desktop is content-sized on the
           // phone too — one sizing decision, both presentations.
           fit: panelClassName && !/(^|\s)h-\[/.test(panelClassName) ? "content" : "fill",

package/dist/conversation/utils/markdown-print.d.ts

@@ -12,13 +12,10 @@
  *
  * Fix conversion or styling in the package (SAME-SESSION LAW), never here.
  */
-import { type PrintOutcome } from "@ai-matrx/print/core";
+import type { PrintOutcome } from "@ai-matrx/print/core";
 /**
- * Prints a message: its prose through the article skin, and every embedded
- * block through the SAME adapter its own print uses (`@ai-matrx/print`'s one
- * block-printer registry, keyed by artifact type / `__kind`) — a quiz as its
- * questions, a deck as its study sheet, a diagram as its drawing, an HTML page
- * as its picture (a print window runs no author scripts; the page's own Print
- * is the sharp one, and the person is told so).
+ * Prints a message through THE message print (`@ai-matrx/rich-content/copy/print-message`):
+ * prose plus every embedded block through its own registry adapter — the same
+ * composition the content actions' Print uses.
  */
-export declare function printMarkdownContent(markdown: string, title?: string): PrintOutcome | Promise<PrintOutcome>;
+export declare function printMarkdownContent(markdown: string, title?: string): Promise<PrintOutcome>;

package/dist/conversation/utils/markdown-print.js

@@ -1,74 +1,17 @@
-import { listPrintBlocks, printMarkdown, printMarkdownWhenReady } from "@ai-matrx/print/markdown";
-import { getBlockPrinter } from "@ai-matrx/print/core";
+import { printMessage } from "@ai-matrx/rich-content/copy/print-message";
 import { notifyPrintOutcome } from "../../host/ui-slots.js";
-const FRAME_BLOCK_TYPES = /* @__PURE__ */ new Set(["html", "react", "iframe"]);
-function blockData(block) {
-  const text = block.body.trim();
-  if (text.startsWith("{") || text.startsWith("[")) {
-    try {
-      return JSON.parse(text);
-    } catch {
-      return block.body;
-    }
-  }
-  return block.body;
-}
-function adapterFor(block) {
-  const printer = getBlockPrinter(block.type);
-  return printer?.toPrintHtml ? printer : null;
-}
-function printMarkdownContent(markdown, title = "AI Response") {
-  const blocks = listPrintBlocks(markdown, "article");
-  const hasMermaid = blocks.some((block) => block.source === "fence" && block.type === "mermaid");
-  const adapted = blocks.filter((block) => adapterFor(block) !== null);
-  if (!hasMermaid && adapted.length === 0) {
-    const outcome = printMarkdown(markdown, { skin: "article", title });
-    notifyPrintOutcome(outcome);
-    return outcome;
-  }
-  let drawing = null;
-  const drawAll = () => drawing ??= (async () => {
-    try {
-      const { drawMermaidForPrint } = await import("@ai-matrx/rich-content/mermaid/print-render");
-      const { pictures, failed } = await drawMermaidForPrint(markdown);
-      if (failed > 0) {
-        const { toast } = await import("../../host/notify.js");
-        toast.warning(
-          `${failed} diagram${failed === 1 ? "" : "s"} could not be drawn and print${failed === 1 ? "s" : ""} as source.`
-        );
-      }
-      return pictures;
-    } catch (error) {
-      console.error("[print] diagrams could not be drawn", error);
-      const { toast } = await import("../../host/notify.js");
-      toast.warning("Diagrams could not be drawn, so they print as source.");
-      return null;
-    }
-  })();
-  return printMarkdownWhenReady(markdown, {
+async function printMarkdownContent(markdown, title = "AI Response") {
+  const outcome = await printMessage(markdown, {
     skin: "article",
     title,
-    renderBlock: async (block) => {
-      if (block.source === "fence" && block.type === "mermaid") {
-        const svg = (await drawAll())?.get(block.body);
-        return svg ? { svg, alt: "Diagram" } : null;
-      }
-      const printer = adapterFor(block);
-      if (!printer?.toPrintHtml) return null;
-      return printer.toPrintHtml(blockData(block), {
-        type: block.type,
-        raw: block.body,
-        ...block.title ? { title: block.title } : {}
-      });
-    }
-  }).then(async (outcome) => {
-    notifyPrintOutcome(outcome);
-    if (outcome === "opened" && adapted.some((block) => FRAME_BLOCK_TYPES.has(block.type))) {
+    onNotice: async (level, message) => {
       const { toast } = await import("../../host/notify.js");
-      toast.info("Web pages print as a picture inside a message. For sharp text, print the page from its card.");
+      if (level === "warning") toast.warning(message);
+      else toast.info(message);
     }
-    return outcome;
   });
+  notifyPrintOutcome(outcome);
+  return outcome;
 }
 export {
   printMarkdownContent

package/dist/host/ui-slots.d.ts

@@ -80,6 +80,12 @@ interface ValueChangeProps<T> {
     [extra: string]: any;
 }
 type AnyComponent = ComponentType<any>;
+export interface CanvasItemCardProps {
+    /** `canvas_items.id` of the version to show. */
+    canvasItemId: string;
+    /** Its chain version, when the caller knows it. */
+    version?: number;
+}
 /**
  * A component slot typed by the props the PACKAGE passes. Bivariant on purpose: the host
  * component has its own (usually richer) prop type, and a slot must accept it as long as the
@@ -105,6 +111,8 @@ export interface ChatUiSlots {
     FileResourceChip: AnyComponent;
     ConnectorMark: AnyComponent;
     MessageFilesStrip: AnyComponent;
+    /** A canvas item rendered by id through the host's block registry (a tool's new artifact version). */
+    CanvasItemCard: SlotComponent<CanvasItemCardProps>;
     RulebookNudge: AnyComponent;
     NegativeVerdictFollowUp: AnyComponent;
     SpeakerButton: AnyComponent;
@@ -468,6 +476,7 @@ export declare const TableChooser: AnyComponent;
 export declare const FileResourceChip: AnyComponent;
 export declare const ConnectorMark: AnyComponent;
 export declare const MessageFilesStrip: AnyComponent;
+export declare const CanvasItemCard: SlotComponent<CanvasItemCardProps>;
 export declare const RulebookNudge: AnyComponent;
 export declare const NegativeVerdictFollowUp: AnyComponent;
 export declare const SpeakerButton: AnyComponent;

package/dist/host/ui-slots.js

@@ -232,6 +232,7 @@ const TableChooser = slotComponent("TableChooser");
 const FileResourceChip = slotComponent("FileResourceChip");
 const ConnectorMark = slotComponent("ConnectorMark");
 const MessageFilesStrip = slotComponent("MessageFilesStrip", optionalWidget("MessageFilesStrip"));
+const CanvasItemCard = slotComponent("CanvasItemCard", optionalWidget("CanvasItemCard"));
 const RulebookNudge = slotComponent("RulebookNudge", optionalWidget("RulebookNudge"));
 const NegativeVerdictFollowUp = slotComponent("NegativeVerdictFollowUp", optionalWidget("NegativeVerdictFollowUp"));
 const SpeakerButton = slotComponent("SpeakerButton", optionalWidget("SpeakerButton"));
@@ -527,6 +528,7 @@ export {
   AttachedResourcesSection,
   AuthGateDialog,
   BlockHoverPreview,
+  CanvasItemCard,
   ChangeDiff,
   CitationChip,
   ClampedNumberInput,

package/dist/tool-call-visualization/components/ArtifactResultBar.js

@@ -4,6 +4,7 @@ import {
   ChevronDown,
   FileText,
   Frame,
+  Globe,
   PanelRightOpen,
   Pencil,
   StickyNote,
@@ -35,6 +36,11 @@ const KIND_META = {
     Icon: StickyNote,
     noun: "Note",
     iconTint: "text-amber-600 dark:text-amber-400"
+  },
+  canvas_item: {
+    Icon: Globe,
+    noun: "Page",
+    iconTint: "text-emerald-600 dark:text-emerald-400"
   }
 };
 function ArtifactResultBar({
@@ -134,7 +140,7 @@ function ArtifactResultBar({
                     /* @__PURE__ */ jsx(Frame, { className: "size-4" }),
                     "Canvas"
                   ] }),
-                  /* @__PURE__ */ jsxs(DropdownMenuItem, { onClick: openEdit, className: "gap-2", children: [
+                  artifact.kind !== "canvas_item" && /* @__PURE__ */ jsxs(DropdownMenuItem, { onClick: openEdit, className: "gap-2", children: [
                     /* @__PURE__ */ jsx(Pencil, { className: "size-4" }),
                     "Edit"
                   ] }),

package/dist/tool-call-visualization/components/ToolCallVisualization.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import React, { useEffect, useMemo, useState } from "react";
 import {
   ChevronDown,
@@ -41,7 +41,7 @@ import {
 } from "../result-fields/ToolErrorCard.js";
 import { guardRoutingOf } from "../result-fields/guard-routing.js";
 import { resultAsObject } from "../renderers/_shared.js";
-import { RecordChangeApprovalCard, useHeldWriteTableName } from "../../host/ui-slots.js";
+import { CanvasItemCard, RecordChangeApprovalCard, useHeldWriteTableName } from "../../host/ui-slots.js";
 import { SHOW_PARKED_ASK_EVENT } from "../../agents/runtime-reconnect/show-parked-ask.js";
 import { ParkedOnPersonCard } from "../../action-requests/components/ParkedOnPersonCard.js";
 import {
@@ -193,6 +193,7 @@ const ToolCallVisualizationInner = ({
   const querySubtitle = phase === "error" || heldWait || parkedAsk ? null : headerSubtitle;
   const artifactRaw = phase === "complete" && settled.length === 1 && !heldWait ? getToolArtifact(headerTool) : null;
   const artifact = artifactRaw && (artifactRaw.kind === "working_document" ? typeof conversationId === "string" && conversationId.length > 0 : Boolean(artifactRaw.id)) ? artifactRaw : null;
+  const canvasItemCard = artifact?.kind === "canvas_item" && artifact.id ? /* @__PURE__ */ jsx("div", { className: "mt-1.5", children: /* @__PURE__ */ jsx(CanvasItemCard, { canvasItemId: artifact.id, version: artifact.version }) }) : null;
   if (entries.length === 0) return null;
   const handleOpenOverlay = (tabId) => {
     setInitialOverlayTab(tabId);
@@ -232,17 +233,20 @@ const ToolCallVisualizationInner = ({
         className
       ),
       children: [
-        artifact ? /* @__PURE__ */ jsx(
-          ArtifactResultBar,
-          {
-            artifact,
-            conversationId,
-            peekExpanded: isExpanded,
-            onTogglePeek: toggleExpand,
-            onOpenOverlay: handleOpenOverlay,
-            onOpenWindowPanel: handleOpenWindowPanel
-          }
-        ) : cardMode && headerTool && HeaderInline ? (
+        artifact ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            ArtifactResultBar,
+            {
+              artifact,
+              conversationId,
+              peekExpanded: isExpanded,
+              onTogglePeek: toggleExpand,
+              onOpenOverlay: handleOpenOverlay,
+              onOpenWindowPanel: handleOpenWindowPanel
+            }
+          ),
+          canvasItemCard
+        ] }) : cardMode && headerTool && HeaderInline ? (
           // Self-headed entity card — no fold line; the card's own header carries
           // the name + "Open in" menu. createElement (not JSX) since the component
           // is resolved at runtime from the registry.

package/dist/tool-call-visualization/registry/toolArtifact.d.ts

@@ -14,18 +14,22 @@
  * branch here + one entry in the bar's `KIND_META`.
  */
 import type { ToolLifecycleEntry } from "../../agents/types/request.types.js";
-export type ToolArtifactKind = "working_document" | "note";
+export type ToolArtifactKind = "working_document" | "note" | "canvas_item";
 export interface ToolArtifact {
     kind: ToolArtifactKind;
     /** Generic fallback label; the working-doc bar prefers the live document title. */
     title: string;
     /** Past-tense verb for the sub-label: "Edited" / "Rewrote" / "Saved" / "Updated". */
     verbPast: string;
-    /** Open handle for id-based kinds (note). The working document uses the shell's conversationId. */
+    /** Open handle for id-based kinds (note, canvas_item). The working document uses the shell's conversationId. */
     id?: string;
+    /** canvas_item: the chain version this call produced (the card shows THAT version). */
+    version?: number;
 }
 /** The `ctx_patch` tool and its live production alias — the canonical set of
  *  tool names that carry a working-document (or any ctx key) patch. Shared so
  *  the drawer's live-diff hook matches patch entries the same way. */
 export declare const PATCH_TOOLS: Set<string>;
+/** Tools whose result is a new version of a canvas item (`artifact_id` + `version`). */
+export declare const CANVAS_ITEM_TOOLS: Set<string>;
 export declare function getToolArtifact(entry: ToolLifecycleEntry | null | undefined): ToolArtifact | null;

package/dist/tool-call-visualization/registry/toolArtifact.js

@@ -1,6 +1,7 @@
 import { getArg, resultAsObject } from "../renderers/_shared.js";
 const PATCH_TOOLS = /* @__PURE__ */ new Set(["ctx_patch", "context_patch"]);
 const NOTE_TOOLS = /* @__PURE__ */ new Set(["note", "war_room_update_note"]);
+const CANVAS_ITEM_TOOLS = /* @__PURE__ */ new Set(["edit_artifact"]);
 const WORKING_DOC_KEY = "working_document";
 function pastForPatchCommand(command) {
   switch (command) {
@@ -45,9 +46,23 @@ function getToolArtifact(entry) {
       id
     };
   }
+  if (CANVAS_ITEM_TOOLS.has(tool)) {
+    const facts = result && typeof result.artifact_id === "string" ? result : result && typeof result.details === "object" && result.details !== null ? result.details : null;
+    const id = facts && typeof facts.artifact_id === "string" ? facts.artifact_id : void 0;
+    if (!id) return null;
+    const version = facts && typeof facts.version === "number" ? facts.version : void 0;
+    return {
+      kind: "canvas_item",
+      title: version ? `Version ${version}` : "New version",
+      verbPast: "Edited",
+      id,
+      ...version ? { version } : {}
+    };
+  }
   return null;
 }
 export {
+  CANVAS_ITEM_TOOLS,
   PATCH_TOOLS,
   getToolArtifact
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.5.6",
+  "version": "0.5.11",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -166,25 +166,25 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/media": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/design-system": "latest"
+    "@ai-matrx/rich-editor": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",