@ai-matrx/chat 0.3.15 → 0.3.19

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @ai-matrx/chat
 
+## 0.3.19 — 2026-10-07
+### Working documents fix-up
+
+- `host/db-types.ts` regenerated: it now carries the `content` schema the working-document service reads (0.3.18 failed its own type-check without it); `workbench` dropped (no longer read).
+
+## 0.3.18 — 2026-10-07 (not published: type-check failed)
+### Working documents and scratchpads live in the content store (cleanup C5c)
+
+- `cx-working-document.service` reads and writes `content.document` (types `working_document` / `scratch`; text in `body`) instead of the retired `workbench.working_documents`; links are `document` → `conversation` associations; version history reads `content.version_list` / `version_get` / `version_restore`. Exported `WORKING_DOCUMENT_ENTITY` (`"document"`) and `workingDocumentTypeIds()`; `WORKING_DOCUMENT_TOKEN` is removed.
+- Share buttons, row entities and the view-vs-edit gate name the `document` entity; the live editor subscribes to `content.document`.
+- Consumer action: none for UI imports; a host that passed `"working_document"` as an entity or resource type for these documents passes `"document"`.
+
+### The composer key rule lives in kit
+
+- `@ai-matrx/chat/ui/composer/composerSubmit` is gone; the rule moved unchanged to `@ai-matrx/kit/composer-keys`
+  (Applets' reply box needs it and cannot depend on chat).
+- Consumer action: repoint `@ai-matrx/chat/ui/composer/composerSubmit` imports to `@ai-matrx/kit/composer-keys`.
+
+## 0.3.17 — 2026-10-07
+### The agent builder leaves chat (AGENT-CORE-PLAN B1)
+
+- Removed (now in matrx-frontend `features/agents`): `agents/hooks/{useAgentAutoSave, useAgentBuilderWriteHandlers, useAgentUndoRedo, useAgentDuplicateFlow, useAgentUsages, useDriftAlerts, useDriftReport}`, `agents/lifecycle/useAgentLifecycleActions`, `agents/components/shared/{useAgentSaveAction, AgentOptionsMenu, AgentSaveTapButton, AgentSaveStatus, AgentPeekDuplicateButton}`, `agents/components/undo-history/AgentEditHistory`, `agents/components/shell/AgentsListHeader`, `agents/components/widgets/*`, the creator/tester panels in `agents/components/run-controls/` (`CreatorRunPanel`, `CreatorRunTabContent`, `TesterSettingsPanel`, `AgentExecutionTestModal`, `AgentLauncherSidebarTester`, `AgentWidgetInvokerTester`, `PayloadTab`), `agents/services/agent-definition-snapshot.service`, `agents/message-flags/useMessageFlags`, `agents/surface-catalog-profile`, `next/lazy/CreatorRunPanel`, and `host/builder-door` (retired: chat no longer calls a builder write). Dead files deleted: `cx-chat/hooks/useAgentBootstrap`, `agents/components/run/run-sidebar/AgentRunsSidebar`, `agents/components/unused/AgentSharedHeader`.
+- New contribution slots in `host/ui-slots` (absent when unregistered): `AgentOptionsMenu`, `AgentSaveStatus`, `AgentSaveTapButton`, `AgentPeekDuplicateButton`, `CreatorRunPanel`. Removed slots: the 14 usages/drift thunks and selectors, `useAgentChangeReach`, `AgentSettingsModal`, `SystemInstructionEditor`.
+- The platform helpers (`getPlatform`, `isMacLike`, `isTouchDevice`, undo/redo hints) live at `agents/utils/platform-keys`.
+- The composer's agent peek reads the run tier (`fetchAgentRunTier`), never the full definition.
+- `agents/model-registry/parse`, `agents/model-registry/model-classes` and `ui/skills-types` re-export `@ai-matrx/agents/models` / `/skills`.
+- Guard G2 `check:no-builder-tier` (in `check:package`): builder-tier symbols in chat are shrink-only; only the agent-definition slice/thunks remain (B2).
+
+**Consumer action:** register the five new slots with the builder's components (`registerChatUi`), drop `registerBuilderDoor` and the removed slot registrations, and import the moved modules from the app.
+
+### Message actions copy through the kit door (AP-2 A2)
+
+- `ChatMessageActions` "Copy" / "Copy as markdown" write through kit `copyText` (async write + textarea fallback, never throws) instead of a raw `navigator.clipboard.writeText`; "Copied" shows only when the words landed, and a refusal is told once through the host notifier with its remedy.
+
+**Consumer action:** none.
+
+## 0.3.16 — 2026-10-07
+### Every subpath resolves for `require` too (P27)
+
+- Each `exports` entry gains a `default` condition naming the same ESM file, so a CommonJS caller
+  (matrx-frontend's tsx-run scripts such as `check-surface-drift`, Node >= 22 `require(esm)`) resolves
+  `@ai-matrx/chat/<domain>/<module>` instead of throwing `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+  `verify-modules-tarball` now proves every public subpath resolves through `require` as well.
+- `host/db-types.ts` regenerated from matrx-frontend's current schema (the scope/context tables SCOPES-W3
+  retired are gone from `context`).
+- Consumer action: none.
+
 ## 0.3.15 — 2026-10-07
 ### The Export menu's .csv download is formula-guarded (AP-2)
 

package/dist/agents/components/agent-widgets/chat-assistant/CompactAssistantInput.js

@@ -36,7 +36,7 @@ import { useTouchOnlyDevice } from "../../../../ui/composer/useTouchOnlyDevice.j
 import {
   composerKeyIntent,
   intentTakesTheKey
-} from "../../../../ui/composer/composerSubmit.js";
+} from "@ai-matrx/kit/composer-keys";
 function CompactAssistantInput({
   conversationId
 }) {

package/dist/agents/components/inputs/AgentVariablesInline.js

@@ -38,7 +38,7 @@ import {
 } from "../../utils/table-variable.js";
 import { RowChoicesButton } from "./RowChoicesButton.js";
 import { isControlVariable } from "@ai-matrx/agents";
-import { enterSendsHere } from "../../../ui/composer/composerSubmit.js";
+import { enterSendsHere } from "@ai-matrx/kit/composer-keys";
 import { Button } from "@ai-matrx/design-system/controls";
 function AgentVariablesInline({
   conversationId,

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

@@ -27,7 +27,7 @@ import { focusUnlessTypingElsewhere } from "../../../../utils/dom/focus-guard.js
 import {
   composerKeyIntent,
   intentTakesTheKey
-} from "../../../../ui/composer/composerSubmit.js";
+} from "@ai-matrx/kit/composer-keys";
 import { readVerticalChrome, snapToLineGrid } from "./textarea-line-grid.js";
 import { useInstanceInputUndoRedo } from "../../../hooks/useInstanceInputUndoRedo.js";
 import { ComposerDraftNotice } from "./ComposerDraftNotice.js";

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

@@ -36,7 +36,7 @@ import {
   smartExecute,
   cancelExecution
 } from "../../../redux/execution-system/thunks/smart-execute.thunk.js";
-import { isMacLike } from "../../../hooks/useAgentUndoRedo.js";
+import { isMacLike } from "../../../utils/platform-keys.js";
 import { MicDeviceMenu } from "../../../../host/ui-slots.js";
 import { Button, SplitButton } from "@ai-matrx/design-system/controls";
 import { cn } from "@ai-matrx/design-system";

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

@@ -3,17 +3,17 @@ import { jsx } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { AgentDetailCard, useAgentCatalogState } from "@ai-matrx/agents/catalog/react";
 import { useAppDispatch, useAppSelector } from "../../../../../store/hooks.js";
-import { selectAgentById, selectAgentReadyForBuilder } from "../../../../redux/agent-definition/selectors.js";
-import { fetchFullAgent } from "../../../../redux/agent-definition/thunks.js";
-import { AgentPeekDuplicateButton } from "../../../shared/AgentPeekDuplicateButton.js";
+import { selectAgentById, selectAgentReadyForExecution } from "../../../../redux/agent-definition/selectors.js";
+import { fetchAgentRunTier } from "../../../../redux/agent-definition/thunks.js";
+import { AgentPeekDuplicateButton } from "../../../../../host/ui-slots.js";
 function ComposerAgentPeek({ agentId, onDone }) {
   const dispatch = useAppDispatch();
   const row = useAgentCatalogState((state) => state.byId[agentId]);
   const record = useAppSelector((state) => selectAgentById(state, agentId));
-  const isReady = useAppSelector((state) => selectAgentReadyForBuilder(state, agentId));
+  const isReady = useAppSelector((state) => selectAgentReadyForExecution(state, agentId));
   useEffect(() => {
-    if (!isReady) void dispatch(fetchFullAgent(agentId)).unwrap().catch(() => void 0);
-  }, [dispatch, agentId, isReady]);
+    if (!row && !isReady) void dispatch(fetchAgentRunTier(agentId)).unwrap().catch(() => void 0);
+  }, [dispatch, agentId, isReady, row]);
   const agent = row ?? (record ? {
     id: record.id,
     name: record.name,

package/dist/agents/components/run/AgentRunHeader.js

@@ -1,7 +1,6 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { AgentModeController } from "../shared/AgentModeController.js";
-import { AgentSaveStatus } from "../shared/AgentSaveStatus.js";
-import { AgentOptionsMenu } from "../shared/AgentOptionsMenu.js";
+import { AgentSaveStatus, AgentOptionsMenu } from "../../../host/ui-slots.js";
 import { ReviewAnswersLink } from "../../../host/ui-slots.js";
 import { AgentSelectorIsland } from "../shared/AgentSelectorIsland.js";
 import { ChevronLeftTapButton } from "@ai-matrx/tap-target/buttons";

package/dist/agents/components/shared/AgentConversationColumn.js

@@ -7,7 +7,7 @@ import {
   useEffect,
   useLayoutEffect
 } from "react";
-import { CreatorRunPanel } from "../../../next/lazy/CreatorRunPanel.js";
+import { CreatorRunPanel } from "../../../host/ui-slots.js";
 import { ArrowDown } from "lucide-react";
 import { motion } from "motion/react";
 import { AgentConversationDisplay } from "../messages-display/AgentConversationDisplay.js";

package/dist/agents/components/shared/AgentHeader.js

@@ -1,8 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { AgentSelectorIsland } from "./AgentSelectorIsland.js";
 import { AgentModeController } from "./AgentModeController.js";
-import { AgentSaveStatus } from "./AgentSaveStatus.js";
-import { AgentOptionsMenu } from "./AgentOptionsMenu.js";
+import { AgentSaveStatus, AgentOptionsMenu } from "../../../host/ui-slots.js";
 import { AgentReferenceCopyButton } from "./AgentReferenceCopyButton.js";
 import { AgentHeaderMobile } from "./AgentHeaderMobile.js";
 import { ReviewAnswersLink } from "../../../host/ui-slots.js";

package/dist/agents/components/shared/AgentHeaderMobile.js

@@ -28,8 +28,7 @@ import {
 import { cn } from "@ai-matrx/design-system";
 import { useIsMobile } from "@ai-matrx/kit/media-query";
 import { HeaderActionsSlot, usePhonePageActions } from "../../../host/chrome.js";
-import { AgentOptionsMenu } from "./AgentOptionsMenu.js";
-import { AgentSaveTapButton } from "./AgentSaveTapButton.js";
+import { AgentOptionsMenu, AgentSaveTapButton } from "../../../host/ui-slots.js";
 import {
   MODES,
   deriveAgentMode,

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

@@ -1,7 +1,7 @@
 /**
  * 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 `cx_working_documents` row, so
+ * 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).

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

@@ -284,7 +284,7 @@ function WorkingDocumentPanel({
         materialized && binding.kind === "cx_working_document" && !!binding.id && /* @__PURE__ */ jsx(
           ShareButton,
           {
-            resourceType: "working_document",
+            resourceType: "document",
             resourceId: binding.id,
             resourceName: title || docTitleFallback,
             variant: "ghost",

package/dist/agents/components/working-document/documents-workspace/DocumentsListRail.js

@@ -126,10 +126,10 @@ function DocumentsListRail({
               {
                 sourceFeature: "working-document",
                 entity: {
-                  type: "working_document",
+                  type: "document",
                   id: d.id,
                   title: label,
-                  resourceType: "working_document"
+                  resourceType: "document"
                 },
                 size: "sm",
                 active: isActive,

package/dist/agents/components/working-document/documents-workspace/DocumentsWorkspace.js

@@ -392,10 +392,10 @@ function DocumentsWorkspace({
                     // has not materialized yet has no id, so it resolves to null and
                     // the entity actions hide rather than target the wrong record.
                     [CONTEXT_MENU_ENTITY_KEY]: tab.documentId ? {
-                      type: "working_document",
+                      type: "document",
                       id: tab.documentId,
                       title,
-                      resourceType: "working_document"
+                      resourceType: "document"
                     } : null
                   };
                 },

package/dist/agents/hooks/useInstanceInputUndoRedo.d.ts

@@ -1,4 +1,4 @@
-import { type Platform } from "./useAgentUndoRedo.js";
+import { type Platform } from "../utils/platform-keys.js";
 interface UseInstanceInputUndoRedoOptions {
     conversationId: string | null;
     /**

package/dist/agents/hooks/useInstanceInputUndoRedo.js

@@ -12,7 +12,7 @@ import {
   getUndoShortcutHint,
   getRedoShortcutHint,
   getPlatform
-} from "./useAgentUndoRedo.js";
+} from "../utils/platform-keys.js";
 function useInstanceInputUndoRedo({
   conversationId,
   scope,

package/dist/agents/hooks/useWorkingDocument.js

@@ -84,7 +84,7 @@ const wdChannels = /* @__PURE__ */ new Map();
 const workingDocChannel = defineChannelNamespace({
   namespace: "cx-working-doc",
   parts: ["documentId"],
-  description: "workbench.working_documents row for one working document"
+  description: "content.document row for one chat working document"
 });
 function subscribeWorkingDocRow(documentId, listenerKey, onRow) {
   let entry = wdChannels.get(documentId);
@@ -98,15 +98,16 @@ function subscribeWorkingDocRow(documentId, listenerKey, onRow) {
       postgresChanges: [
         {
           event: "*",
-          schema: "workbench",
-          table: "working_documents",
+          schema: "content",
+          table: "document",
           filter: `id=eq.${documentId}`,
           rowId: (row) => typeof row.id === "string" ? row.id : void 0,
-          fingerprint: (row) => JSON.stringify([row.content ?? null, row.title ?? null, row.version ?? null]),
+          fingerprint: (row) => JSON.stringify([row.body ?? null, row.title ?? null, row.version ?? null]),
           onChange: ({ payload, row }) => {
             if (payload.eventType === "DELETE") return;
             if (!row) return;
-            fanOut(row);
+            const r = row;
+            fanOut({ ...r, content: r.body ?? r.content });
           }
         }
       ],
@@ -374,7 +375,7 @@ function useWorkingDocument(conversationId, kind = DEFAULT_DOC_KIND) {
   const conflictRef = useRef(conflict);
   conflictRef.current = conflict;
   const docAccess = useAccess(
-    kind === "working" && binding.kind === "cx_working_document" && binding.id && materialized ? "working_document" : void 0,
+    kind === "working" && binding.kind === "cx_working_document" && binding.id && materialized ? "document" : void 0,
     kind === "working" && binding.kind === "cx_working_document" && binding.id && materialized ? binding.id : void 0
   );
   const viewOnly = !docAccess.loading && docAccess.exists && docAccess.level === "view" && !docAccess.isOwner;

package/dist/agents/model-registry/model-classes.d.ts

@@ -1,43 +1 @@
-/**
- * A model's CLASSES — the serving endpoints it is offered through ("Matrx Fast",
- * "Matrx Lightning", ...). Two classes of one model are different products, so
- * wherever a surface names the model an agent or run USES, a model with several
- * classes is named with its class: "Qwen3.8 27B · Matrx Lightning".
- *
- * Same grouping as the picker (`collapseTiersByClass` in useModelCatalog): one
- * class per endpoint (or brand when the endpoint is unknown), preferred
- * (lowest-priority) first. Every offering — including ones collapsed into a
- * class — maps to its class, so any stored `offering_id` resolves.
- */
-export type ModelOfferingRow = {
-    model_id: string | null;
-    offering_id: string | null;
-    served_via: string | null;
-    served_via_endpoint_id: string | null;
-    priority: number | null;
-};
-export type ModelClassEntry = {
-    /** Public Matrx brand of the serving endpoint — never a vendor name. */
-    servedVia: string;
-    endpointId: string | null;
-    /** The class's preferred offering (what the picker pins). */
-    offeringId: string;
-};
-export type ModelClassIndex = {
-    /** modelId → its classes, preferred first. */
-    classesByModelId: Record<string, ModelClassEntry[]>;
-    /** offeringId → { modelId, index into classesByModelId[modelId] }. */
-    classOfOffering: Record<string, {
-        modelId: string;
-        classIndex: number;
-    }>;
-};
-export declare function buildModelClassIndex(rows: ModelOfferingRow[]): ModelClassIndex;
-/**
- * The class name to show beside a model, or undefined when the model has a
- * single class (nothing to tell apart). A pin names its class; no pin (or a
- * pin of another model) means the server runs the preferred class.
- */
-export declare function modelClassName(index: ModelClassIndex | null | undefined, modelId: string | null | undefined, offeringId: string | null | undefined): string | undefined;
-/** "Model · Class" when the model has several classes, else the model name. */
-export declare function withModelClass(modelLabel: string, className: string | undefined): string;
+export * from "@ai-matrx/agents/models";

package/dist/agents/model-registry/model-classes.js

@@ -1,40 +1 @@
-function buildModelClassIndex(rows) {
-  const classesByModelId = {};
-  const classOfOffering = {};
-  const sorted = [...rows].sort(
-    (a, b) => (a.priority ?? 100) - (b.priority ?? 100)
-  );
-  for (const r of sorted) {
-    if (!r.model_id || !r.offering_id) continue;
-    const list = classesByModelId[r.model_id] ??= [];
-    let classIndex = list.findIndex(
-      (c) => c.endpointId && r.served_via_endpoint_id ? c.endpointId === r.served_via_endpoint_id : c.servedVia === (r.served_via ?? "")
-    );
-    if (classIndex === -1) {
-      list.push({
-        servedVia: r.served_via ?? "",
-        endpointId: r.served_via_endpoint_id,
-        offeringId: r.offering_id
-      });
-      classIndex = list.length - 1;
-    }
-    classOfOffering[r.offering_id] = { modelId: r.model_id, classIndex };
-  }
-  return { classesByModelId, classOfOffering };
-}
-function modelClassName(index, modelId, offeringId) {
-  if (!index || !modelId) return void 0;
-  const classes = index.classesByModelId[modelId];
-  if (!classes || classes.length < 2) return void 0;
-  const pinned = offeringId ? index.classOfOffering[offeringId] : void 0;
-  const entry = pinned && pinned.modelId === modelId ? classes[pinned.classIndex] : classes[0];
-  return entry?.servedVia || void 0;
-}
-function withModelClass(modelLabel, className) {
-  return className ? `${modelLabel} \xB7 ${className}` : modelLabel;
-}
-export {
-  buildModelClassIndex,
-  modelClassName,
-  withModelClass
-};
+export * from "@ai-matrx/agents/models";

package/dist/agents/model-registry/parse.d.ts

@@ -1,88 +1 @@
-import { type ModelCapabilities } from "@ai-matrx/agents/models";
-/** Identifies the model whose capabilities are being parsed, for loud reporting. */
-export interface CapabilitiesParseContext {
-    modelId?: string;
-    modelName?: string;
-}
-/**
- * Validate the canonical `{input, output, features, interaction,
- * multilingual}` object. Anything that is not that object — including `null`
- * for an unsaved row — yields the text-only turn-based default.
- *
- * Pass `context` (model id/name) wherever available — it's what makes the
- * unknown-value scream actionable.
- */
-export declare function parseCapabilities(raw: unknown, context?: CapabilitiesParseContext): ModelCapabilities;
-/**
- * The persistence/API boundary for `ai.model_definition.capabilities`.
- *
- * Unlike `parseCapabilities`, which is intentionally a resilient display
- * reader, this refuses a corrupt or provider-shaped value. A Supabase JSONB
- * column has no application vocabulary enforcement: accepting aliases here
- * would make them durable and leak them back out through another reader.
- */
-export declare function requireCanonicalCapabilities(raw: unknown, context?: CapabilitiesParseContext): ModelCapabilities;
-/**
- * Flat audit-shaped record. Re-exported here for callers that want the
- * derived projection without importing from the audit module.
- */
-export type AuditCapabilitiesRecord = Partial<{
-    text_input: boolean;
-    text_output: boolean;
-    image_input: boolean;
-    image_output: boolean;
-    audio_input: boolean;
-    audio_output: boolean;
-    video_input: boolean;
-    document_input: boolean;
-    code_execution: boolean;
-    function_calling: boolean;
-    streaming: boolean;
-    vision: boolean;
-    web_search: boolean;
-    json_mode: boolean;
-    structured_output: boolean;
-    system_prompt: boolean;
-    multi_turn: boolean;
-    embeddings: boolean;
-    fine_tuning: boolean;
-    batch_api: boolean;
-}>;
-/**
- * Project the canonical shape onto the flat audit record so existing
- * audit consumers see the same view they always have.
- */
-export declare function toAuditRecord(caps: ModelCapabilities): AuditCapabilitiesRecord;
-/**
- * Merge an edited flat audit record back INTO the canonical capabilities
- * object — the write-side inverse of `toAuditRecord`. This exists because
- * writing the flat 20-boolean projection over the column destroys
- * `interaction` / `multilingual` / non-text output / the extended feature
- * vocabulary (the exact silent-drop class TASK-003 killed on the read side).
- *
- * Rules:
- * - Starts from the RAW stored object (arrays cloned) — every key and every
- *   array member the editor doesn't model is preserved VERBATIM, including
- *   values outside the FE vocabulary.
- * - Only flags whose edited value DIFFERS from the current projection are
- *   applied (as an add/remove on the owning array), so an untouched Save is
- *   a byte-for-byte no-op: `merge(raw, toAuditRecord(parse(raw))) === raw`.
- * - A flag with no canonical mapping is never written.
- */
-export declare function mergeAuditRecordIntoCapabilities(raw: unknown, edited: AuditCapabilitiesRecord, context?: CapabilitiesParseContext): Record<string, unknown>;
-export { CONTENT_TYPES, FEATURE_KEYS, INTERACTION_MODES, DEFAULT_CAPABILITIES, } from "@ai-matrx/agents/models";
-export type { ContentType, FeatureKey, InteractionMode, ModelCapabilities, } from "@ai-matrx/agents/models";
-/**
- * Every value in `raw` that is outside the canonical vocabulary, as
- * human-readable lines. Empty array = the object is canonical.
- *
- * The admin detail panel writes `capabilities` straight to Supabase, so it
- * does NOT pass the server's write guard
- * (`matrx_ai/providers/capability_vocabulary.py`, which the agent `sql`/`db_*`
- * tools and `scripts/set_model_capabilities.py` go through). This is that
- * door's lock. It REFUSES rather than normalizes on purpose: the alias table
- * lives server-side and forking it into the browser is how the vocabulary
- * came apart in the first place. A hand-edit that means a real new capability
- * belongs in BOTH vocabulary lists first.
- */
-export declare function findNonCanonicalCapabilityValues(raw: unknown): string[];
+export * from "@ai-matrx/agents/models";