@ai-matrx/chat 0.3.28 → 0.3.31

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 0.3.31
+
+The route map follows the Applet rename: `/applets/**` (the list, `/applets/build`, `/applets/manage/<id>/**`) resolves to `matrx-user/agent-apps` and `/administration/applets/**` to `matrx-admin/agent-apps`. The stale `/agent-apps` prefixes matched nothing, so every Applet page fell through to the generic surface (the Agents menu said "Canvas" on `/applets/build`).
+
+Consumer action: none.
+
+## 0.3.30
+
+The composer rail's Scratch pill no longer dead-ends: with no scratchpad attached it used to toast "Nothing to show in the canvas yet" and open nothing. It now opens the scratchpad canvas tab, whose body hydrates the active scratchpad and creates one when the pool is empty.
+
+Consumer action: none.
+
+## 0.3.29
+
+Never reached npm: the tag commit failed CI typecheck on a content-ir-react error fixed right after. These changes ship in 0.3.30.
+
+Package-twins collapse onto `@ai-matrx/kit`: character counts across context, memory, scrape and tool-call views use `formatCount` (compact where the view was compact); sandbox activity and context-compare durations use `formatDurationMs` compact; the document link picker and surface-check age use `formatRelativeTime` ("5h ago" / "5h" where they said "today"); reserved-conversation, table-variable and canvas conversation ids use `isUuidShape`. The `isUuidValue` slot's DEFAULT now matches the registered host rule (trimmed RFC 9562); hosts still override it.
+
+Consumer action: none.
+
 ## 0.3.28
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/components/chat/begin-fresh-chat.js

@@ -1,4 +1,5 @@
 "use client";
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { clearFocus } from "../../redux/execution-system/conversation-focus/conversation-focus.slice.js";
 import { resolveMandateAsking } from "../../../mandates/resolve-asking.js";
 import { isOrganizationSelectionCancelled } from "../../../host/org.js";
@@ -38,9 +39,8 @@ function getFreshChatHref(activeAgentId, defaultAgentId) {
   }
   return `/chat/a/${encodeURIComponent(activeAgentId)}`;
 }
-const RESERVED_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function reservedConversationIdOf(param) {
-  return param && RESERVED_ID_RE.test(param) ? param.toLowerCase() : null;
+  return param && isUuidShape(param) ? param.toLowerCase() : null;
 }
 function getReservedFreshChatHref(activeAgentId, defaultAgentId, conversationId) {
   return `${getFreshChatHref(activeAgentId, defaultAgentId)}?c=${conversationId}`;

package/dist/agents/components/chat/sandbox-insight/SandboxActivityFeed.d.ts

@@ -1,13 +1,3 @@
-/**
- * SandboxActivityFeed — "what has the agent actually done inside the box?"
- *
- * One line per sandbox tool call, oldest → newest: the tool, its subject (the
- * command, or the path), how it ended (exit code / failed / still running),
- * how long it took, and the output on expand. It is the transcript's sandbox
- * work, extracted and put in one place — reading the SAME tool calls the
- * thread renders from (`sandbox-activity.ts` merges the live lifecycle map
- * with the persisted `cx_tool_call` rows), never a second data path.
- */
 import React from "react";
 export declare function SandboxActivityFeed({ conversationId, }: {
     conversationId: string;

package/dist/agents/components/chat/sandbox-insight/SandboxActivityFeed.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatDurationMs } from "@ai-matrx/kit/format";
 import React from "react";
 import { AlertTriangle, ChevronRight, Loader2, Terminal } from "lucide-react";
 import { cn, ErrorBox } from "@ai-matrx/design-system";
@@ -13,9 +14,7 @@ import { DURABLE_VFS_BADGE_TEXT } from "../../../../tool-call-visualization/rend
 import { ErrorAlchemyMenu } from "../../../../host/ui-slots.js";
 import { getToolDisplayName } from "../../../../tool-call-visualization/registry/registry.js";
 function formatDuration(ms) {
-  if (ms === null) return null;
-  if (ms < 1e3) return `${ms}ms`;
-  return `${(ms / 1e3).toFixed(ms < 1e4 ? 1 : 0)}s`;
+  return ms === null ? null : formatDurationMs(ms, { style: "compact" });
 }
 const ActivityRow = ({ row }) => {
   const [open, setOpen] = React.useState(false);

package/dist/agents/components/context-policies-display/contextPolicyPreview.js

@@ -1,3 +1,4 @@
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   previewKnownContext,
   resolveContextEntryValue
@@ -6,7 +7,7 @@ import { unwrapRichContextValue } from "./contextValueUtils.js";
 const PREVIEW_MAX = 32;
 const SIZE_HINT_RE = /^\d[\d,]*\s*chars$/i;
 function formatCharCount(n) {
-  return `~${n.toLocaleString()} chars`;
+  return `~${formatCount(n)} chars`;
 }
 function extractCharCount(value) {
   if (value === void 0 || value === null) return null;

package/dist/agents/components/context-preview/AttachedContextSection.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { Badge, Chip, Button } from "@ai-matrx/design-system/controls";
 import { useMemo } from "react";
 import {
@@ -272,7 +273,7 @@ function AttachedContextSection({
               ),
               /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-sm font-medium text-foreground", children: item.title }),
               /* @__PURE__ */ jsxs("span", { className: "shrink-0 text-[10px] tabular-nums text-muted-foreground", children: [
-                item.chars.toLocaleString(),
+                formatCount(item.chars),
                 " chars"
               ] }),
               item.onRemove && /* @__PURE__ */ jsx(RemoveX, { label: item.title, onRemove: item.onRemove })
@@ -306,7 +307,7 @@ function AttachedContextSection({
       ] }),
       " ",
       "\xB7 ~",
-      totalChars.toLocaleString(),
+      formatCount(totalChars),
       " characters of content"
     ] })
   ] });

package/dist/agents/components/context-preview/ContextCompareView.js

@@ -21,7 +21,7 @@ import { usePageCaptureContribution } from "../../../host/ui-slots.js";
 import { useContextPreview } from "./useContextPreview.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { AGENT_ICON } from "@ai-matrx/icons/domain";
-import { formatCount } from "@ai-matrx/kit/format";
+import { formatCount, formatDurationMs } from "@ai-matrx/kit/format";
 import { getUserId } from "../../../host/identity.js";
 import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
 import { useAgentName } from "../../identity/agent-identity.js";
@@ -525,7 +525,7 @@ function AnswerBoth({
             /* @__PURE__ */ jsx("span", { className: "text-[11px] font-semibold uppercase tracking-wider text-primary", children: p === "old" ? "Current system" : "Record store" }),
             /* @__PURE__ */ jsxs("span", { className: "text-[10px] tabular-nums text-muted-foreground", children: [
               a?.model && !/^[0-9a-f-]{36}$/i.test(a.model) ? a.model : "",
-              typeof a?.duration_ms === "number" ? ` ${(a.duration_ms / 1e3).toFixed(1)} s` : "",
+              typeof a?.duration_ms === "number" ? ` ${formatDurationMs(a.duration_ms, { style: "compact" })}` : "",
               typeof a?.input_tokens === "number" ? ` \xB7 ${formatCount(a.input_tokens)} tokens in` : ""
             ] })
           ] }),

package/dist/agents/components/inputs/smart-input/ComposerDraftNotice.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { RotateCcw, TriangleAlert } from "lucide-react";
 import { useComposerDraftRestore } from "../../../redux/execution-system/instance-user-input/useComposerDraftRestore.js";
 import { Button } from "@ai-matrx/design-system/controls";
@@ -15,7 +16,7 @@ function ComposerDraftNotice({
       /* @__PURE__ */ jsx(RotateCcw, { className: "w-3 h-3 shrink-0" }),
       /* @__PURE__ */ jsxs("span", { className: "min-w-0", children: [
         "We put your unsent draft back (",
-        restoredChars.toLocaleString(),
+        formatCount(restoredChars),
         " ",
         "characters)."
       ] }),

package/dist/agents/components/inputs/smart-input/ConversationContextRail.js

@@ -36,7 +36,6 @@ import {
   useOpenScratchpadPanel,
   useOpenWorkingDocumentPanel
 } from "../../../../host/window-openers.js";
-import { reportCanvasOpenDrop } from "../../../../host/ui-slots.js";
 import { selectCloudBrowserRunLive } from "../../../../host/ui-slots.js";
 import {
   selectInstanceContextEntries,
@@ -182,14 +181,6 @@ function ConversationContextRail({
     contextTab.toggle(key);
   };
   const toggleDocInCanvas = (kind) => {
-    if (kind === "scratch" && !activeScratchId) {
-      reportCanvasOpenDrop({
-        reason: "nothing-to-show",
-        requested: scratchTitle?.trim() || "Scratchpad",
-        detail: "no scratchpad is attached to this conversation yet"
-      });
-      return;
-    }
     const tabId = kind === "scratch" ? scratchpadTabId() : conversationDocumentsTabId(conversationId);
     if (canvasOpen && currentCanvasSourceId === tabId) {
       canvas.hide();

package/dist/agents/components/observational-memory/components/MemoryStateInspector.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useClipboard } from "@ai-matrx/kit/clipboard";
 import { toast } from "../../../../host/notify.js";
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -335,7 +336,7 @@ function BufferedObservationCard({
                   "t"
                 ] }),
                 hasText && /* @__PURE__ */ jsxs("span", { children: [
-                  /* @__PURE__ */ jsx("span", { className: "text-foreground/70 font-mono", children: text.length.toLocaleString() }),
+                  /* @__PURE__ */ jsx("span", { className: "text-foreground/70 font-mono", children: formatCount(text.length) }),
                   " ",
                   "chars"
                 ] })
@@ -523,7 +524,7 @@ function TextPayload({
       ] }),
       hasText && text && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsxs("span", { className: "text-[10px] font-mono text-muted-foreground shrink-0", children: [
-          text.length.toLocaleString(),
+          formatCount(text.length),
           " chars"
         ] }),
         /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: copied ? /* @__PURE__ */ jsx(Check, {}) : /* @__PURE__ */ jsx(Copy, {}), glyphTone: copied ? "success" : void 0, onClick: handleCopy, title: "Copy", "aria-label": "Copy", className: "shrink-0" })

package/dist/agents/components/run-controls/panels/ModelContextPanel.js

@@ -1,6 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { formatDurationSeconds } from "@ai-matrx/kit/format";
+import { formatDurationSeconds, formatCount } from "@ai-matrx/kit/format";
 import { useEffect, useMemo, useState } from "react";
 import { useAppDispatch, useAppSelector } from "../../../../store/hooks.js";
 import { useOrganizationRequired } from "../../../../host/ui-slots.js";
@@ -178,7 +178,7 @@ function TrimSummaryView({ trim }) {
         valueClassName: skipped ? "text-amber-500" : rewrittenCount > 0 ? "text-emerald-500" : "text-muted-foreground"
       }
     ),
-    rewrittenCount > 0 && /* @__PURE__ */ jsx(StatRow, { label: "Freed", value: `${freed.toLocaleString()} chars` }),
+    rewrittenCount > 0 && /* @__PURE__ */ jsx(StatRow, { label: "Freed", value: `${formatCount(freed)} chars` }),
     rewrittenBlocks.length > 0 && /* @__PURE__ */ jsxs("div", { className: "text-[10px] font-mono text-muted-foreground space-y-0.5 mt-1", children: [
       rewrittenBlocks.slice(0, 8).map((b) => /* @__PURE__ */ jsxs("div", { className: "truncate", children: [
         "pos ",
@@ -189,9 +189,9 @@ function TrimSummaryView({ trim }) {
         b.tier,
         ") \xB7",
         " ",
-        b.before_chars.toLocaleString(),
+        formatCount(b.before_chars),
         " \u2192 ",
-        b.after_chars.toLocaleString()
+        formatCount(b.after_chars)
       ] }, `${b.message_position}:${b.call_id}`)),
       rewrittenBlocks.length > 8 && /* @__PURE__ */ jsxs("div", { className: "italic", children: [
         "\u2026and ",

package/dist/agents/components/working-document/DocumentLinkPicker.d.ts

@@ -1,11 +1,3 @@
-/**
- * DocumentLinkPicker — pick an existing document (working / scratch) of the
- * current user to LINK this conversation to. Powers cross-conversation sharing:
- * both conversations then point at the same `content.document` row, so
- * edits round-trip to all of them.
- *
- * Desktop: Popover. Mobile: BottomSheet (nested pickers must not use Popover).
- */
 import React from "react";
 import { type WorkingDocumentKind } from "../../redux/execution-system/instance-working-document/cx-working-document.service.js";
 interface DocumentLinkPickerProps {

package/dist/agents/components/working-document/DocumentLinkPicker.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatRelativeTime } from "@ai-matrx/kit/format";
 import React, { useCallback, useMemo, useState } from "react";
 import { FileText, Loader2, NotebookPen, Search } from "lucide-react";
 import { Input, Tabs, Tile } from "@ai-matrx/design-system/controls";
@@ -23,14 +24,7 @@ function previewOf(content) {
   return trimmed.length > 80 ? `${trimmed.slice(0, 80)}\u2026` : trimmed;
 }
 function formatWhen(iso) {
-  const then = new Date(iso).getTime();
-  if (Number.isNaN(then)) return "";
-  const diff = Date.now() - then;
-  const day = 864e5;
-  if (diff < day) return "today";
-  if (diff < 2 * day) return "yesterday";
-  if (diff < 7 * day) return `${Math.floor(diff / day)}d ago`;
-  return new Date(iso).toLocaleDateString();
+  return formatRelativeTime(iso, { fallback: "" });
 }
 const SCOPES = [
   { value: "mine", label: "Mine" },

package/dist/agents/utils/table-variable.js

@@ -1,4 +1,4 @@
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 function isTableVariableType(type) {
   return type === "table" || type === "tables";
 }
@@ -7,7 +7,7 @@ function tableVariableTypeOf(customComponent) {
   return typeof type === "string" && isTableVariableType(type) ? type : null;
 }
 function isTableId(value) {
-  return typeof value === "string" && UUID_RE.test(value.trim());
+  return typeof value === "string" && isUuidShape(value.trim());
 }
 function readTableReference(value) {
   const out = [];

package/dist/canvas/workspace/useCanvasWorkspaceConversation.js

@@ -1,4 +1,5 @@
 "use client";
+import { isUuidShape } from "@ai-matrx/kit/uuid";
 import { useEffect, useRef, useState } from "react";
 import { useAgentLauncher } from "../../agents/hooks/useAgentLauncher.js";
 import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "../../agents/components/chat/chat-quick-actions.config.js";
@@ -15,10 +16,9 @@ function initialRequest(start) {
     return { kind: "open", conversationId: start.conversationId, agentId: start.agentId ?? null, nonce: 0 };
   return { kind: "new", nonce: 0 };
 }
-const CONVERSATION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function conversationInAddress(param, search) {
   const value = new URLSearchParams(search).get(param);
-  return value && CONVERSATION_ID.test(value) ? value : null;
+  return value && isUuidShape(value) ? value : null;
 }
 function workspaceChatMemoryKey(surfaceKey) {
   return `matrx:workspace-chat:${surfaceKey}`;
@@ -26,7 +26,7 @@ function workspaceChatMemoryKey(surfaceKey) {
 function recallWorkspaceConversation(surfaceKey) {
   try {
     const value = window.localStorage.getItem(workspaceChatMemoryKey(surfaceKey));
-    return value && CONVERSATION_ID.test(value) ? value : null;
+    return value && isUuidShape(value) ? value : null;
   } catch {
     return null;
   }
@@ -46,7 +46,7 @@ function reserveWorkspaceConversationId(surfaceKey, fresh) {
   try {
     const key = reservedChatKey(surfaceKey);
     const kept = fresh ? null : window.localStorage.getItem(key);
-    if (kept && CONVERSATION_ID.test(kept)) return kept;
+    if (kept && isUuidShape(kept)) return kept;
     const id = window.crypto.randomUUID();
     window.localStorage.setItem(key, id);
     return id;

package/dist/host/defaults/webpage-snapshot-view.js

@@ -1,3 +1,4 @@
+import { formatCount } from "@ai-matrx/kit/format";
 import { createElement } from "react";
 function DefaultWebpageSnapshotView({
   snapshot,
@@ -17,7 +18,7 @@ function DefaultWebpageSnapshotView({
         { className: "font-medium text-foreground" },
         variant === "submitted" ? "Snapshot sent with this message" : "Snapshot attached to this draft"
       ),
-      createElement("span", null, `${charCount.toLocaleString()} characters`),
+      createElement("span", null, `${formatCount(charCount)} characters`),
       scrapedAt ? createElement("span", null, scrapedAt) : null
     ) : null,
     createElement(

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

@@ -1,16 +1,3 @@
-/**
- * host/ui-slots — host registrations for app UI the package draws but does not own
- * (PACKAGE-INDEPENDENCE.md: "a host registration", not an import of app code).
- *
- * The host registers once at startup with `registerChatUi({...})`; package code
- * imports the named wrappers below. A component the host did not register renders
- * nothing (or its plain stand-in, marked `data-chat-slot-fallback`) and reports itself
- * ONCE through the host diagnostics port (never silent: Law 4); a function or hook it
- * did not register throws, naming the slot (or runs its declared stand-in, reported once). A test registers a stand-in the same way (`registerChatUi`).
- *
- * Slot shapes are the host component's own props — package call sites keep passing
- * exactly what they passed when they imported the component directly.
- */
 import { type ComponentType, type ChangeEvent, type ReactNode } from "react";
 import type { EditableContextMenuProps, NonEditableContextMenuProps } from "../context-menu/types.js";
 /** The host context menu's props (its registration is typed against them). */

package/dist/host/ui-slots.js

@@ -1,4 +1,5 @@
 "use client";
+import { isRfc9562Uuid } from "@ai-matrx/kit/uuid";
 import { createElement, Fragment, useRef } from "react";
 import { formatCost, usdToPoints } from "@ai-matrx/kit/format";
 import { reportUnregisteredHostSlot as reportUnregistered } from "./diagnostics.js";
@@ -143,7 +144,7 @@ const STAND_INS = {
   bookmarksToReferenceDirectives: () => NONE,
   notifyPrintOutcome: () => void 0,
   awaitEffectiveOrganizationId: async () => ({ status: "unavailable", reason: "This host registers no organization source.", cause: "no-selection" }),
-  isUuidValue: (value) => typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value),
+  isUuidValue: (value) => typeof value === "string" && isRfc9562Uuid(value.trim()),
   useClippedContentGuard: () => void 0,
   answerPreviewText: (text) => String(text ?? ""),
   beginPlaybackSession: () => ({ id: "", update: () => void 0, end: () => void 0 }),

package/dist/surfaces/utils/route-to-surface.js

@@ -20,7 +20,8 @@ const SURFACE_ROUTE_MAPPINGS = [
     surface: "matrx-user/connections-skills"
   },
   { prefix: "/agent-connections", surface: "matrx-user/agent-connections" },
-  { prefix: "/agent-apps", surface: "matrx-user/agent-apps" },
+  // An Applet's pages: the list, /applets/build, /applets/manage/<id>/**.
+  { prefix: "/applets", surface: "matrx-user/agent-apps" },
   // Standalone top-level pages.
   { prefix: "/chat/voice", surface: "matrx-user/chat-voice" },
   { prefix: "/chat/a/", surface: "matrx-user/chat" },
@@ -237,7 +238,7 @@ const SURFACE_ROUTE_MAPPINGS = [
     surface: "matrx-admin/system-agents"
   },
   {
-    prefix: "/administration/agents/agent-apps",
+    prefix: "/administration/applets",
     surface: "matrx-admin/agent-apps"
   },
   { prefix: "/administration/agents/bundles", surface: "matrx-admin/bundles" },

package/dist/surfaces/utils/surface-check-ledger.js

@@ -1,3 +1,4 @@
+import { formatRelativeTime } from "@ai-matrx/kit/format";
 const SURFACE_CHECK_FRESH_DAYS = 30;
 function daysSinceCheck(row, now = Date.now()) {
   if (!row.last_checked_at) return null;
@@ -11,13 +12,7 @@ function surfaceCheckState(row, now = Date.now()) {
   return days > SURFACE_CHECK_FRESH_DAYS ? "stale" : "fresh";
 }
 function checkAgeLabel(row, now = Date.now()) {
-  const days = daysSinceCheck(row, now);
-  if (days === null) return "never";
-  if (days === 0) return "today";
-  if (days === 1) return "1d";
-  if (days < 30) return `${days}d`;
-  const months = Math.floor(days / 30);
-  return months < 12 ? `${months}mo` : `${Math.floor(days / 365)}y`;
+  return formatRelativeTime(row.last_checked_at, { style: "short", suffix: false, now, fallback: "never" });
 }
 function checkSortWeight(row, now = Date.now()) {
   const days = daysSinceCheck(row, now);

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

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   CheckCircle,
   FileSearch,
@@ -139,7 +140,7 @@ function scrapeHeaderExtras(entry) {
       "read"
     ] }),
     parsed.totalChars > 0 && /* @__PURE__ */ jsxs("span", { children: [
-      parsed.totalChars.toLocaleString(),
+      formatCount(parsed.totalChars),
       " chars"
     ] })
   ] });

package/dist/tool-call-visualization/renderers/ctx/CtxItemCard.d.ts

@@ -1,18 +1,3 @@
-/**
- * CtxItemCard — the note-card display for ONE context item.
- *
- * Shared by every CTX renderer (`ctx_get`, `ctx_batch`). Renders a single
- * resolved context object — `{ key, type, label, content }` (or `summary`
- * in summary mode) — as a polished note card: a header row carrying the
- * type icon, the human label, the raw key, and an optional size badge, then
- * the value itself via the recursive `<ResultValue>` field library.
- *
- * The component is deliberately shape-tolerant: the server `type` field is a
- * free string, so the icon is resolved through a string-keyed map with a
- * `Layers` fallback. `content` is handed straight to `<ResultValue>`, which
- * already knows how to render markdown, tables, json, media, and scalars by
- * shape — this card never reimplements rendering.
- */
 import React from "react";
 import { type ResultDensity } from "../../result-fields/ResultValue.js";
 export interface CtxItem {

package/dist/tool-call-visualization/renderers/ctx/CtxItemCard.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import {
   FileText,
   File,
@@ -34,11 +35,7 @@ function iconForType(type) {
   return CTX_TYPE_ICON[type] ?? Layers;
 }
 function formatCharCount(n) {
-  if (n >= 1e3) {
-    const k = n / 1e3;
-    return `${k >= 10 ? Math.round(k) : k.toFixed(1)}k chars`;
-  }
-  return `${n} char${n === 1 ? "" : "s"}`;
+  return `${formatCount(n, { style: "compact" })} char${n === 1 ? "" : "s"}`;
 }
 const CtxItemCard = ({
   item,

package/dist/tool-call-visualization/renderers/research/ResearchOverlay.d.ts

@@ -1,18 +1,3 @@
-/**
- * Research overlay tabs (`research_web`, `core_web_search_and_read`).
- *
- * Exposes Report · Sources · Full Text, plus a `researchOverlayTabs` array the
- * tool registry hands to `ToolUpdatesOverlay`. When the tool is opened in the
- * overlay these REPLACE the default "Results" tab and sit beside the standard
- * "Input" and "Raw" admin tabs:
- *
- *     [ Report | Sources | Full Text | Input | Raw ]
- *
- * All three parse the raw blob via the ONE canonical `parseSearch` (the
- * deep-research `parser.ts` it used to use is deleted — no duplicate parsers).
- * The Report tab renders through `RichDocument` (full action toolkit); Sources
- * is the dense ranked + deep-read view; Full Text is a copyable synthesized dump.
- */
 import React from "react";
 import type { ToolOverlayTabSpec, ToolRendererProps } from "../../types.js";
 export declare const ResearchReportTab: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/research/ResearchOverlay.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   BookOpen,
@@ -106,7 +107,7 @@ const ReadCard = ({
             content: expanded || !isLong ? read.text : `${read.text.slice(0, 500)}\u2026`
           }
         ),
-        isLong && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", onClick: () => setExpanded((p) => !p), className: "mt-2", children: expanded ? "Show less" : `Show full content (${Math.round(read.text.length / 1e3)}k chars)` })
+        isLong && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", onClick: () => setExpanded((p) => !p), className: "mt-2", children: expanded ? "Show less" : `Show full content (${formatCount(read.text.length, { style: "compact" })} chars)` })
       ] })
     ] })
   ] });

package/dist/tool-call-visualization/renderers/scrape/ScrapeInline.d.ts

@@ -1,33 +1,3 @@
-/**
- * ScrapeInline — the canonical inline renderer for the page-read / scrape family
- * (`web_read`, `core_web_read_web_pages`).
- *
- * Reading 40k tokens off a page is NOT a one-line event — so each page gets a
- * full rectangular CARD (favicon + title + domain + meta; a preview image when
- * one is present; an AI-review line ONLY when present). ONE card per page,
- * multiple cards when reading several pages at once.
- *
- * ─── The two phases ──────────────────────────────────────────────────────────
- *
- *   • READING (live): a left-to-right "reading wave" shimmer sweeps across each
- *     card (the `readingWave` keyframe in globals.css), mimicking a person
- *     reading the page top-to-bottom while the content is fetched. While reading
- *     we know the URLs (from `arguments.urls` and/or the real-time "Browsing
- *     <url>" activity on `entry.events`) but not yet the body — so the card
- *     shows the favicon + domain + a shimmering placeholder.
- *   • DONE (persistent): the card fills in — title, a content snippet, the char
- *     count, the optional preview image (durable, via `InlineMediaRef`), and the
- *     optional AI-review line. A "View page" affordance opens the overlay.
- *
- * Phase is keyed on `selectIsLatestToolActivity(requestId, callId)` when a live
- * requestId is threaded (the card keeps reading until the model moves on), and
- * falls back to `entry.status` for the simulator / persisted snapshots.
- *
- * Images go through `InlineMediaRef` ONLY (never a raw <img>) so a page's
- * preview image self-heals if it's an expiring signed URL. Favicons use the
- * Google favicon service (not owned media → a plain <img> with a Globe fallback
- * is correct). Semantic tokens only; React Compiler is on (no manual memo).
- */
 import React from "react";
 import type { ToolRendererProps } from "../../types.js";
 export declare const ScrapeInline: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/scrape/ScrapeInline.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   Globe,
@@ -168,7 +169,7 @@ const ReadPageCard = ({ page, index, onOpen }) => {
           /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 pt-0.5 text-xs text-muted-foreground", children: [
             /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1", children: [
               /* @__PURE__ */ jsx(FileText, { className: "h-3 w-3" }),
-              page.charCount.toLocaleString(),
+              formatCount(page.charCount),
               " chars"
             ] }),
             onOpen && /* @__PURE__ */ jsx(Button, { variant: "quiet", tone: "primary", iconEnd: /* @__PURE__ */ jsx(ArrowRight, {}), onClick: (e) => {

package/dist/tool-call-visualization/renderers/scrape/ScrapeOverlay.d.ts

@@ -1,14 +1,3 @@
-/**
- * ScrapeOverlay — the full "hide nothing" page-read view for the scrape family
- * (`web_read`, `core_web_read_web_pages`), rendered in the fullscreen overlay
- * and the floating window panel.
- *
- * Layout: a page list on the left, the selected page's FULL content on the
- * right (rendered as markdown), plus the optional preview image and AI-review
- * when present. Same canonical `parseScrape` as the inline renderer; semantic
- * tokens only; favicons via the Google favicon service; the preview image via
- * `InlineMediaRef` (durable, never a raw <img>).
- */
 import React from "react";
 import type { ToolRendererProps } from "../../types.js";
 export declare const ScrapeOverlay: React.FC<ToolRendererProps>;

package/dist/tool-call-visualization/renderers/scrape/ScrapeOverlay.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import { useMemo, useState } from "react";
 import {
   Globe,
@@ -58,7 +59,7 @@ const ScrapeOverlay = ({ entry }) => {
         ] })
       ] }),
       parsed.totalChars > 0 && /* @__PURE__ */ jsxs("span", { className: "ml-auto text-xs tabular-nums text-muted-foreground", children: [
-        parsed.totalChars.toLocaleString(),
+        formatCount(parsed.totalChars),
         " chars total"
       ] })
     ] }),
@@ -88,7 +89,7 @@ const ScrapeOverlay = ({ entry }) => {
               /* @__PURE__ */ jsxs("div", { className: "truncate text-xs text-muted-foreground", children: [
                 p.domain,
                 " \xB7 ",
-                p.charCount.toLocaleString(),
+                formatCount(p.charCount),
                 " chars"
               ] })
             ] })

package/dist/tool-call-visualization/result-fields/KeyValueGrid.d.ts

@@ -1,36 +1,3 @@
-/**
- * KeyValueGrid — renders a plain object as a compact, shape-aware field layout.
- *
- * Fields are partitioned by what their VALUE is, not treated uniformly:
- *
- *   inline  — short values (scalar / uuid / url / boolean / empty) render as
- *             single-line `Label  value` rows on a two-column grid. Key, Type,
- *             Label never burn two lines each again.
- *   chips   — numeric metadata (total_chars, count, duration_ms, tokens…)
- *             renders as one wrapping row of quiet badges.
- *   blocks  — anything of unknown length (text, markdown, nested objects,
- *             tables, lists, media) keeps a full-width section: small label
- *             header, value beneath, recursing through {@link ResultValue}.
- *
- * Display order is inline rows → chips → blocks so unknown-length content
- * always sits last. Identifier keys (`id`, `*_id`, `uuid`) render the full
- * UUID with an always-visible copy button.
- *
- * Every key is reachable: nothing is dropped, only deferred behind a toggle.
- *
- * FIELDS THAT DO NOT APPLY (wall W61, 2026-09-12) obey the document's optional
- * -field policy (`document-presentation.tsx`), not the density. Before that,
- * `inline` silently skipped them and `full` printed the word "None" — the same
- * payload read two different ways, and the `full` reading put "Physician note:
- * None" at the top of a page written for a parent. Under the default `omit`
- * policy they leave the field list and are COUNTED on a quiet trailing line
- * that opens them; under `note` they keep their row with a quiet "Not
- * applicable"; under `show` the producer's value renders untouched.
- *
- * FIELD LABELS come from the producer's own JSON Schema `title` when the host
- * supplied one, and from the key otherwise. The key is the machine's name for
- * a field; the schema's title is the author's.
- */
 import React from "react";
 import { type ResultDensity } from "./ResultValue.js";
 export interface KeyValueGridProps {

package/dist/tool-call-visualization/result-fields/KeyValueGrid.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { formatCount } from "@ai-matrx/kit/format";
 import React from "react";
 import { cn } from "@ai-matrx/design-system";
 import {
@@ -53,13 +54,7 @@ function isMetaCountField(key, val) {
   return typeof val === "number" && Number.isFinite(val) && META_COUNT_KEY.test(key);
 }
 function formatMetaNumber(n) {
-  if (Number.isInteger(n) && Math.abs(n) >= 1e4) {
-    return new Intl.NumberFormat("en-US", {
-      notation: "compact",
-      maximumFractionDigits: 1
-    }).format(n);
-  }
-  return n.toLocaleString("en-US");
+  return Number.isInteger(n) && Math.abs(n) >= 1e4 ? formatCount(n, { style: "compact" }) : formatCount(n, { locale: "en-US" });
 }
 function isInlineValue(key, val) {
   if (typeof val === "string" && isIdentifierKey(key)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.28",
+  "version": "0.3.31",
   "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; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -226,23 +226,23 @@
     "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/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/records": "latest",
+    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {