@ai-matrx/chat 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @ai-matrx/chat
 
+## 0.5.4 — tree-shakeable, and the first screen sheds its heavy parts
+
+- `"sideEffects"` is no longer `true`: it lists the CSS and the ten files that run on import
+  (registrations, the page-leave listener, diagnostics). Guard: `pnpm check:side-effects`
+  (`apps/shared/scripts/check-side-effects-listed.mjs`, self-tested), now part of `check:package`.
+- Lazy on first use, never on the first chat screen: every tool card in the tool-call registry, the
+  media variable inputs (image/audio/video/document/YouTube), the media, comment and working-document
+  context-item bodies, and the documents workspace tab.
+- Side-panel canary (bare Vite host, npm-installed): first chat screen 1829 → 1738 kB gzip with
+  rich-content 0.2.56; budget ratcheted to 1745.
+
+Consumer action: none. A host that imported a chat module only for an effect not in the list should
+import the module it uses instead.
+
 ## 0.5.3
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

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

@@ -33,12 +33,14 @@ import { NoteBody, NoteFooter, NoteTitleActions } from "./bodies/NoteBody.js";
 import { TaskBody } from "./bodies/TaskBody.js";
 import { WebpageBody, WebpageFooter } from "./bodies/WebpageBody.js";
 import { DataBody } from "./bodies/DataBody.js";
-import { MediaBody, MediaFooter } from "./bodies/MediaBody.js";
-import { WorkingDocumentBody } from "./bodies/WorkingDocumentBody.js";
 import { ProcessedDocumentBody } from "./bodies/ProcessedDocumentBody.js";
 import { ProcessedDocumentTitle } from "./bodies/ProcessedDocumentTitle.js";
 import { GenericBody, GenericFooter } from "./bodies/GenericBody.js";
-import { RemarkBody } from "./bodies/RemarkBody.js";
+import { clientLazy } from "../../../utils/client-lazy.js";
+const MediaBody = clientLazy(() => import("./bodies/MediaBody.js").then((m) => ({ default: m.MediaBody })));
+const MediaFooter = clientLazy(() => import("./bodies/MediaBody.js").then((m) => ({ default: m.MediaFooter })));
+const WorkingDocumentBody = clientLazy(() => import("./bodies/WorkingDocumentBody.js").then((m) => ({ default: m.WorkingDocumentBody })));
+const RemarkBody = clientLazy(() => import("./bodies/RemarkBody.js").then((m) => ({ default: m.RemarkBody })));
 import { BookmarkReferenceBody } from "./bodies/BookmarkReferenceBody.js";
 import { EntityReferenceBody } from "./bodies/EntityReferenceBody.js";
 import { ContextInputBody } from "./bodies/ContextInputBody.js";

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

@@ -29,7 +29,8 @@ import { RunSettingsEditor } from "../../run-controls/RunSettingsEditor.js";
 import { RunModelPicker } from "../../run-controls/RunModelPicker.js";
 import { RunConfigOverrides } from "../../run-controls/RunConfigOverrides.js";
 import { RunInputCapabilities } from "../../run-controls/RunInputCapabilities.js";
-import { DocumentsWorkspace } from "../../working-document/documents-workspace/DocumentsWorkspace.js";
+import { clientLazy } from "@ai-matrx/kit/client-lazy";
+const DocumentsWorkspace = clientLazy(() => import("../../working-document/documents-workspace/DocumentsWorkspace.js").then((m) => ({ default: m.DocumentsWorkspace })));
 import { selectWorkingDocEnabled } from "../../../redux/execution-system/instance-working-document/instance-working-document.selectors.js";
 import { ActiveContextTree } from "../../../../context/sources/scopes.js";
 import { selectHasActiveContext } from "../../../../context/sources/scopes.js";

package/dist/agents/components/inputs/variable-input-variations/AgentVariableCards.js

@@ -10,11 +10,12 @@ import { selectShowVariablePanel } from "../../../redux/execution-system/instanc
 import { setUserVariableValue } from "../../../redux/execution-system/instance-variable-values/instance-variable-values.slice.js";
 import { selectUserVariableValues } from "../../../redux/execution-system/instance-variable-values/instance-variable-values.selectors.js";
 import { isMediaVariableType } from "../../../types/agent-definition.types.js";
-import { ImageVariableInput } from "../input-components/ImageVariableInput.js";
-import { AudioVariableInput } from "../input-components/AudioVariableInput.js";
-import { VideoVariableInput } from "../input-components/VideoVariableInput.js";
-import { DocumentVariableInput } from "../input-components/DocumentVariableInput.js";
-import { YoutubeVariableInput } from "../input-components/YoutubeVariableInput.js";
+import { clientLazy } from "@ai-matrx/kit/client-lazy";
+const ImageVariableInput = clientLazy(() => import("../input-components/ImageVariableInput.js").then((m) => ({ default: m.ImageVariableInput })));
+const AudioVariableInput = clientLazy(() => import("../input-components/AudioVariableInput.js").then((m) => ({ default: m.AudioVariableInput })));
+const VideoVariableInput = clientLazy(() => import("../input-components/VideoVariableInput.js").then((m) => ({ default: m.VideoVariableInput })));
+const DocumentVariableInput = clientLazy(() => import("../input-components/DocumentVariableInput.js").then((m) => ({ default: m.DocumentVariableInput })));
+const YoutubeVariableInput = clientLazy(() => import("../input-components/YoutubeVariableInput.js").then((m) => ({ default: m.YoutubeVariableInput })));
 import { ArrowRight, Minus, Plus } from "lucide-react";
 import { variableRunLabel } from "@ai-matrx/agents";
 import { Button } from "@ai-matrx/design-system/controls";

package/dist/agents/components/inputs/variable-input-variations/AgentVariableForm.js

@@ -28,12 +28,13 @@ import {
 import { VoiceTextarea } from "../../../../host/ui-slots.js";
 import { formatText, humanizeIdentifier } from "@ai-matrx/kit/text-case";
 import { cn } from "@ai-matrx/design-system";
+import { clientLazy } from "@ai-matrx/kit/client-lazy";
 import { isMediaVariableType } from "../../../types/agent-definition.types.js";
-import { ImageVariableInput } from "../input-components/ImageVariableInput.js";
-import { AudioVariableInput } from "../input-components/AudioVariableInput.js";
-import { VideoVariableInput } from "../input-components/VideoVariableInput.js";
-import { DocumentVariableInput } from "../input-components/DocumentVariableInput.js";
-import { YoutubeVariableInput } from "../input-components/YoutubeVariableInput.js";
+const ImageVariableInput = clientLazy(() => import("../input-components/ImageVariableInput.js").then((m) => ({ default: m.ImageVariableInput })));
+const AudioVariableInput = clientLazy(() => import("../input-components/AudioVariableInput.js").then((m) => ({ default: m.AudioVariableInput })));
+const VideoVariableInput = clientLazy(() => import("../input-components/VideoVariableInput.js").then((m) => ({ default: m.VideoVariableInput })));
+const DocumentVariableInput = clientLazy(() => import("../input-components/DocumentVariableInput.js").then((m) => ({ default: m.DocumentVariableInput })));
+const YoutubeVariableInput = clientLazy(() => import("../input-components/YoutubeVariableInput.js").then((m) => ({ default: m.YoutubeVariableInput })));
 const IOS_INPUT_STYLE = { fontSize: "16px" };
 function AgentVariableForm({ conversationId }) {
   const dispatch = useAppDispatch();

package/dist/agents/components/inputs/variable-input-variations/AgentVariablesGuided.js

@@ -9,11 +9,12 @@ import { Minus, Plus } from "lucide-react";
 import { variableRunLabel } from "@ai-matrx/agents";
 import { cn } from "@ai-matrx/design-system";
 import { isMediaVariableType } from "../../../types/agent-definition.types.js";
-import { ImageVariableInput } from "../input-components/ImageVariableInput.js";
-import { AudioVariableInput } from "../input-components/AudioVariableInput.js";
-import { VideoVariableInput } from "../input-components/VideoVariableInput.js";
-import { DocumentVariableInput } from "../input-components/DocumentVariableInput.js";
-import { YoutubeVariableInput } from "../input-components/YoutubeVariableInput.js";
+import { clientLazy } from "@ai-matrx/kit/client-lazy";
+const ImageVariableInput = clientLazy(() => import("../input-components/ImageVariableInput.js").then((m) => ({ default: m.ImageVariableInput })));
+const AudioVariableInput = clientLazy(() => import("../input-components/AudioVariableInput.js").then((m) => ({ default: m.AudioVariableInput })));
+const VideoVariableInput = clientLazy(() => import("../input-components/VideoVariableInput.js").then((m) => ({ default: m.VideoVariableInput })));
+const DocumentVariableInput = clientLazy(() => import("../input-components/DocumentVariableInput.js").then((m) => ({ default: m.DocumentVariableInput })));
+const YoutubeVariableInput = clientLazy(() => import("../input-components/YoutubeVariableInput.js").then((m) => ({ default: m.YoutubeVariableInput })));
 import { useAppSelector, useAppDispatch } from "../../../../store/hooks.js";
 import {
   selectInstanceVariableDefinitions,

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

@@ -1,6 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { formatCount } from "@ai-matrx/kit/format";
+import { clientLazy } from "@ai-matrx/kit/client-lazy";
 import {
   CheckCircle,
   FileSearch,
@@ -37,39 +38,39 @@ import { withSurfaceWriteDiff } from "../surface-write/withSurfaceWriteDiff.js";
 import { DIFF_START_OPEN_KNOB, readSurfaceWrite } from "../surface-write/readSurfaceWrite.js";
 import { getSessionKnob } from "../../host/prefs.js";
 import { reportUnregisteredHostSlot } from "../../host/diagnostics.js";
-import { SearchInline } from "../renderers/search/SearchInline.js";
-import { SearchOverlay } from "../renderers/search/SearchOverlay.js";
-import { ScrapeInline } from "../renderers/scrape/ScrapeInline.js";
-import { ScrapeOverlay } from "../renderers/scrape/ScrapeOverlay.js";
+const SearchInline = clientLazy(() => import("../renderers/search/SearchInline.js").then((m) => ({ default: m.SearchInline })));
+const SearchOverlay = clientLazy(() => import("../renderers/search/SearchOverlay.js").then((m) => ({ default: m.SearchOverlay })));
+const ScrapeInline = clientLazy(() => import("../renderers/scrape/ScrapeInline.js").then((m) => ({ default: m.ScrapeInline })));
+const ScrapeOverlay = clientLazy(() => import("../renderers/scrape/ScrapeOverlay.js").then((m) => ({ default: m.ScrapeOverlay })));
 import { parseScrape } from "../renderers/scrape/parseScrape.js";
-import { WebInline } from "../renderers/web/WebInline.js";
-import { WebOverlay } from "../renderers/web/WebOverlay.js";
+const WebInline = clientLazy(() => import("../renderers/web/WebInline.js").then((m) => ({ default: m.WebInline })));
+const WebOverlay = clientLazy(() => import("../renderers/web/WebOverlay.js").then((m) => ({ default: m.WebOverlay })));
 import { resolveWebActionKind } from "../renderers/web/webAction.js";
-import { NewsInline } from "../renderers/news-api/NewsInline.js";
-import { NewsOverlay } from "../renderers/news-api/NewsOverlay.js";
-import { WorkbookInline } from "../renderers/workbook/WorkbookInline.js";
-import { WorkbookOverlay } from "../renderers/workbook/WorkbookOverlay.js";
-import { DictionaryInline } from "../renderers/dictionary/DictionaryInline.js";
-import { DictionaryOverlay } from "../renderers/dictionary/DictionaryOverlay.js";
-import { ResearchInline } from "../renderers/research/ResearchInline.js";
+const NewsInline = clientLazy(() => import("../renderers/news-api/NewsInline.js").then((m) => ({ default: m.NewsInline })));
+const NewsOverlay = clientLazy(() => import("../renderers/news-api/NewsOverlay.js").then((m) => ({ default: m.NewsOverlay })));
+const WorkbookInline = clientLazy(() => import("../renderers/workbook/WorkbookInline.js").then((m) => ({ default: m.WorkbookInline })));
+const WorkbookOverlay = clientLazy(() => import("../renderers/workbook/WorkbookOverlay.js").then((m) => ({ default: m.WorkbookOverlay })));
+const DictionaryInline = clientLazy(() => import("../renderers/dictionary/DictionaryInline.js").then((m) => ({ default: m.DictionaryInline })));
+const DictionaryOverlay = clientLazy(() => import("../renderers/dictionary/DictionaryOverlay.js").then((m) => ({ default: m.DictionaryOverlay })));
+const ResearchInline = clientLazy(() => import("../renderers/research/ResearchInline.js").then((m) => ({ default: m.ResearchInline })));
 import { researchOverlayTabs } from "../renderers/research/ResearchOverlay.js";
-import { RandomWheelInline } from "../renderers/random-wheel/RandomWheelInline.js";
-import { RecordsInline } from "../renderers/records/RecordsInline.js";
-import { CtxGetInline } from "../renderers/ctx/CtxGetInline.js";
-import { CtxBatchInline } from "../renderers/ctx/CtxBatchInline.js";
-import { CtxPatchInline } from "../renderers/ctx/CtxPatchInline.js";
-import { ContextActionInline } from "../renderers/ctx/ContextActionInline.js";
-import { SqlInline } from "../renderers/sql/SqlInline.js";
-import { FsInline } from "../renderers/fs/FsInline.js";
-import { ShellInline } from "../renderers/shell/ShellInline.js";
-import { SkillInline } from "../renderers/skill/SkillInline.js";
-import { AskInline } from "../renderers/ask/AskInline.js";
-import { AskPersonInline } from "../renderers/ask-person/AskPersonInline.js";
-import { CloudBrowserInline } from "../renderers/cloud-browser/CloudBrowserRunCard.js";
+const RandomWheelInline = clientLazy(() => import("../renderers/random-wheel/RandomWheelInline.js").then((m) => ({ default: m.RandomWheelInline })));
+const RecordsInline = clientLazy(() => import("../renderers/records/RecordsInline.js").then((m) => ({ default: m.RecordsInline })));
+const CtxGetInline = clientLazy(() => import("../renderers/ctx/CtxGetInline.js").then((m) => ({ default: m.CtxGetInline })));
+const CtxBatchInline = clientLazy(() => import("../renderers/ctx/CtxBatchInline.js").then((m) => ({ default: m.CtxBatchInline })));
+const CtxPatchInline = clientLazy(() => import("../renderers/ctx/CtxPatchInline.js").then((m) => ({ default: m.CtxPatchInline })));
+const ContextActionInline = clientLazy(() => import("../renderers/ctx/ContextActionInline.js").then((m) => ({ default: m.ContextActionInline })));
+const SqlInline = clientLazy(() => import("../renderers/sql/SqlInline.js").then((m) => ({ default: m.SqlInline })));
+const FsInline = clientLazy(() => import("../renderers/fs/FsInline.js").then((m) => ({ default: m.FsInline })));
+const ShellInline = clientLazy(() => import("../renderers/shell/ShellInline.js").then((m) => ({ default: m.ShellInline })));
+const SkillInline = clientLazy(() => import("../renderers/skill/SkillInline.js").then((m) => ({ default: m.SkillInline })));
+const AskInline = clientLazy(() => import("../renderers/ask/AskInline.js").then((m) => ({ default: m.AskInline })));
+const AskPersonInline = clientLazy(() => import("../renderers/ask-person/AskPersonInline.js").then((m) => ({ default: m.AskPersonInline })));
+const CloudBrowserInline = clientLazy(() => import("../renderers/cloud-browser/CloudBrowserRunCard.js").then((m) => ({ default: m.CloudBrowserInline })));
 import { cloudBrowserAction } from "../renderers/cloud-browser/cloudBrowserRun.js";
-import { DbSchemaInline } from "../renderers/sql/DbSchemaInline.js";
+const DbSchemaInline = clientLazy(() => import("../renderers/sql/DbSchemaInline.js").then((m) => ({ default: m.DbSchemaInline })));
 import { summarizeSql } from "../renderers/sql/summarizeSql.js";
-import { AgentCallInline } from "../renderers/agent-call/AgentCallInline.js";
+const AgentCallInline = clientLazy(() => import("../renderers/agent-call/AgentCallInline.js").then((m) => ({ default: m.AgentCallInline })));
 import { isImageGenerationAgentCall } from "../renderers/agent-call/agentCallKind.js";
 import { isCollaborationAgentCall } from "../renderers/agent-call/collab.js";
 import { collabHeaderSubtitle } from "../renderers/agent-call/collab-subtitle.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "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",
@@ -167,25 +167,25 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/agents": "latest",
-    "@ai-matrx/browser-audio": "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/alchemy": "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/kit": "latest",
     "@ai-matrx/media": "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/tap-target": "latest",
-    "@ai-matrx/print": "latest"
+    "@ai-matrx/icons": "latest",
+    "@ai-matrx/records-ui": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -218,7 +218,27 @@
   "engines": {
     "node": ">=20"
   },
-  "sideEffects": true,
+  "sideEffects": [
+    "**/*.css",
+    "./src/ui/markdown-stream/rich-content-defaults.ts",
+    "./dist/ui/markdown-stream/rich-content-defaults.js",
+    "./src/agents/components/messages-display/rich-document/chat-message-source.ts",
+    "./dist/agents/components/messages-display/rich-document/chat-message-source.js",
+    "./src/agents/redux/execution-system/client-capabilities/*",
+    "./dist/agents/redux/execution-system/client-capabilities/*",
+    "./src/agents/redux/execution-system/utils/page-leaving.ts",
+    "./dist/agents/redux/execution-system/utils/page-leaving.js",
+    "./src/host/diagnostics.ts",
+    "./dist/host/diagnostics.js",
+    "./src/tool-call-visualization/db-renderer/toolRendererCache.ts",
+    "./dist/tool-call-visualization/db-renderer/toolRendererCache.js",
+    "./src/voice-agent/relay/useVoiceRelaySession.ts",
+    "./dist/voice-agent/relay/useVoiceRelaySession.js",
+    "./src/surfaces/runtime/SurfaceRuntimeContext.tsx",
+    "./dist/surfaces/runtime/SurfaceRuntimeContext.js",
+    "./src/agents/components/context-items/registry.tsx",
+    "./dist/agents/components/context-items/registry.js"
+  ],
   "peerDependencies": {
     "@reduxjs/toolkit": ">=2.0.0",
     "next": ">=16.0.0-0",
@@ -263,7 +283,7 @@
   "scripts": {
     "build": "pnpm --filter @ai-matrx/rich-editor build && pnpm clean && tsup && node ./scripts/tsc-own.mjs -p tsconfig.build.json && node ./scripts/finish-build.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && publint && pnpm verify:tarball && pnpm verify:modules-tarball && pnpm check:front-door:self-test && pnpm check:front-door:canary && pnpm check:host-boundary && pnpm check:no-builder-tier && pnpm check:one-holder && pnpm check:host-doors && pnpm check:no-package-slots",
+    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && publint && pnpm verify:tarball && pnpm verify:modules-tarball && pnpm check:front-door:self-test && pnpm check:front-door:canary && pnpm check:host-boundary && pnpm check:no-builder-tier && pnpm check:one-holder && pnpm check:host-doors && pnpm check:no-package-slots && pnpm check:side-effects",
     "check:host-boundary": "node ./scripts/check-host-boundary.mjs && node ./scripts/check-host-boundary.mjs --self-test",
     "check:host-doors": "node ./scripts/check-host-source-doors.mjs && node ./scripts/check-host-source-doors.mjs --self-test",
     "check:no-package-slots": "node ./scripts/check-no-package-slots.mjs && node ./scripts/check-no-package-slots.mjs --self-test",
@@ -279,6 +299,7 @@
     "check:front-door:self-test": "node ./scripts/check-front-door.mjs --self-test",
     "check:front-door:canary": "node ./scripts/check-front-door.mjs --root ./canary/src",
     "deps:write": "node ./scripts/finish-build.mjs --write-deps",
-    "check:side-panel-bundle": "node ./scripts/check-side-panel-bundle.mjs"
+    "check:side-panel-bundle": "node ./scripts/check-side-panel-bundle.mjs",
+    "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test"
   }
 }