@ai-matrx/chat 0.5.8 → 0.5.11

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @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

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/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.8",
+  "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",
@@ -169,22 +169,22 @@
     "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
+    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/media": "latest",
-    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/records": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/rich-content": "latest"
+    "@ai-matrx/records-ui": "latest",
+    "@ai-matrx/rich-content": "latest",
+    "@ai-matrx/rich-editor": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",