@ai-matrx/chat 0.3.19 → 0.3.21

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @ai-matrx/chat
 
+## 0.3.21 — 2026-10-07
+### The editable definition leaves chat (AGENT-CORE-PLAN B2, builder tier)
+
+- Removed from `agents/redux/agent-definition/slice`: the 22 edit reducers (`setAgentField`, `setAgentMessages`, `setAgentSettings`, `setAgentVariableDefinitions`, `setAgentControlBinding`, `setAgentContextPolicies`, `setAgentTools`, `setAgentCustomTools`, `setAgentMcpServers`, `setAgentSkillConfig`, `setAgentModelTiers`, `setAgentOutputSchema`, `setAgentUiGates`, `setAgentMatrxDirectives`, `resetAgentField`, `resetAllAgentFields`, `markAgentSaved`, `markAgentFieldSaved`, `rollbackAgentOptimisticUpdate`, `undoAgentEdit`, `redoAgentEdit`, `clearAgentUndoHistory`) and the undo/redo machinery. Removed from `.../thunks`: `fetchFullAgent` (a run reads the run tier only).
+- Added: `markAgentRecordClean(record)` (slice) — the one "clean baseline" helper, shared by `upsertAgent` and the host's builder.
+- Guard G2 (`check:no-builder-tier`) is now a hard ban: 0 builder-tier references in chat source, no baseline.
+- Consumer action: a host with an agent builder owns the edits. matrx-frontend: `features/agents/redux/agent-builder.slice` (actions `agentBuilder/*`, composed onto the `agentDefinition` key with `withAgentBuilderEdits(chatReducers.agentDefinition)`) and `features/agents/redux/fetch-full-agent.thunk`. A host without a builder: none.
+
+## 0.3.20 — 2026-10-07
+### Working-document realtime channel renamed
+
+- The working-document row channel is `working-document-row` (was `cx-working-doc`). 0.3.19 changed that namespace's description in place, and a dev server that had loaded 0.3.15 refused the new declaration on every page ("cannot be re-declared"). A fresh process was never affected.
+- Consumer action: none.
+
 ## 0.3.19 — 2026-10-07
 ### Working documents fix-up
 

package/dist/agents/hooks/useWorkingDocument.js

@@ -82,7 +82,10 @@ import { selectUserId } from "../../host/identity.js";
 const AUTOSAVE_MS = 700;
 const wdChannels = /* @__PURE__ */ new Map();
 const workingDocChannel = defineChannelNamespace({
-  namespace: "cx-working-doc",
+  // Renamed from "cx-working-doc" when the row moved to content.document (C5c):
+  // a namespace whose spec changes must take a new name, or a long-lived dev
+  // server that still holds the old declaration refuses the new one.
+  namespace: "working-document-row",
   parts: ["documentId"],
   description: "content.document row for one chat working document"
 });

package/dist/agents/redux/agent-definition/slice.d.ts

@@ -1,5 +1,10 @@
 import { type PayloadAction } from "@reduxjs/toolkit";
-import type { AgentDefinition, AgentDefinitionSliceState, AgentFetchStatus, FieldSnapshot, LoadedFields } from "../../types/agent-definition.types.js";
+import type { AgentDefinition, AgentDefinitionRecord, AgentDefinitionSliceState, AgentFetchStatus, LoadedFields } from "../../types/agent-definition.types.js";
+/**
+ * Marks a record as clean. Clears dirty state, field history, and undo stacks.
+ * _loadedFields is NOT cleared — fetched state is cumulative.
+ */
+export declare function markAgentRecordClean(record: AgentDefinitionRecord): void;
 export declare const agentDefinitionSlice: import("@reduxjs/toolkit").Slice<AgentDefinitionSliceState, {
     /**
      * Upserts a fully-fetched agent (live or version) and marks it clean.
@@ -28,134 +33,6 @@ export declare const agentDefinitionSlice: import("@reduxjs/toolkit").Slice<Agen
     mergePartialAgent(state: AgentDefinitionSliceState, action: PayloadAction<Partial<AgentDefinition> & {
         id: string;
     }>): void;
-    /** Edit any single field by name. For scalars and simple values. */
-    setAgentField(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        field: keyof AgentDefinition;
-        value: AgentDefinition[keyof AgentDefinition];
-    }>): void;
-    setAgentMessages(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        messages: AgentDefinition["messages"];
-    }>): void;
-    setAgentSettings(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        settings: AgentDefinition["settings"];
-    }>): void;
-    setAgentVariableDefinitions(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        variableDefinitions: AgentDefinition["variableDefinitions"];
-    }>): void;
-    /**
-     * Bind or unbind a model control to a variable in ONE edit (one undo step):
-     * the settings literal and the variable definitions move together.
-     * See features/agents/utils/control-variables.ts.
-     */
-    setAgentControlBinding(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        settings: AgentDefinition["settings"];
-        variableDefinitions: AgentDefinition["variableDefinitions"];
-    }>): void;
-    setAgentContextPolicies(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        contextPolicies: AgentDefinition["contextPolicies"];
-    }>): void;
-    setAgentTools(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        tools: AgentDefinition["tools"];
-    }>): void;
-    setAgentCustomTools(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        customTools: AgentDefinition["customTools"];
-    }>): void;
-    setAgentMcpServers(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        mcpServers: AgentDefinition["mcpServers"];
-    }>): void;
-    /**
-     * Per-agent skill exposure config. The full SkillConfig object is
-     * replaced atomically; the picker UI computes the next value and
-     * dispatches once. Marked dirty so the next save flushes it through
-     * to `agent.definition.skill_config`.
-     */
-    setAgentSkillConfig(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        skillConfig: AgentDefinition["skillConfig"];
-    }>): void;
-    setAgentModelTiers(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        modelTiers: AgentDefinition["modelTiers"];
-    }>): void;
-    setAgentOutputSchema(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        outputSchema: AgentDefinition["outputSchema"];
-    }>): void;
-    /**
-     * Model-gated UI flags (FE-only). The full UiGates object is replaced
-     * atomically; the gate editor computes the next value and dispatches once.
-     * Persisted to `agent.definition.ui_gates` — never sent to the server.
-     */
-    setAgentUiGates(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        uiGates: AgentDefinition["uiGates"];
-    }>): void;
-    /**
-     * Matrx Directives apply config. Replaced atomically by the Matrx Directives tab;
-     * persisted to `agent.definition.matrx_actions`. Read by aidream's output-directive
-     * dispatcher (full rebrand of the retired settings["output_apply"]).
-     */
-    setAgentMatrxDirectives(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        matrxDirectives: AgentDefinition["matrxDirectives"];
-    }>): void;
-    /** Reset one field to its original value from _fieldHistory. */
-    resetAgentField(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        field: keyof AgentDefinition;
-    }>): void;
-    /** Reset ALL dirty fields to their original values. No refetch needed. */
-    resetAllAgentFields(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-    }>): void;
-    /** Called after a successful save. Current values become the new clean baseline. */
-    markAgentSaved(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-    }>): void;
-    /**
-     * A SINGLE field was written to the database (inline edits such as the
-     * Agent Info Editor's name). Only that field becomes the clean baseline —
-     * every other staged edit (e.g. an Output Schema kind binding applied in
-     * Model Settings) must stay dirty so the main Save still persists it.
-     * `markAgentSaved` here used to wipe every dirty flag, silently dropping
-     * unrelated staged edits (feedback 222a2925).
-     */
-    markAgentFieldSaved(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        field: keyof AgentDefinition;
-    }>): void;
-    /** Save failed — restore from the snapshot taken before the optimistic write. */
-    rollbackAgentOptimisticUpdate(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-        snapshot: FieldSnapshot;
-    }>): void;
-    /**
-     * Pops the most recent entry from _undoPast, pushes current value to
-     * _undoFuture, and restores the previous value. Also maintains dirty tracking.
-     */
-    undoAgentEdit(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-    }>): void;
-    /**
-     * Pops the most recent entry from _undoFuture, pushes current value to
-     * _undoPast, and applies the redo value. Also maintains dirty tracking.
-     */
-    redoAgentEdit(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-    }>): void;
-    /** Clears the undo/redo stacks without affecting the current state. */
-    clearAgentUndoHistory(state: AgentDefinitionSliceState, action: PayloadAction<{
-        id: string;
-    }>): void;
     markAgentFieldsLoaded(state: AgentDefinitionSliceState, action: PayloadAction<{
         id: string;
         fields: (keyof AgentDefinition)[];
@@ -188,70 +65,7 @@ export declare const upsertAgent: import("@reduxjs/toolkit").ActionCreatorWithPa
     id: string;
 }, "agentDefinition/seedAgentFromTemplate">, mergePartialAgent: import("@reduxjs/toolkit").ActionCreatorWithPayload<Partial<AgentDefinition> & {
     id: string;
-}, "agentDefinition/mergePartialAgent">, setAgentField: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    field: keyof AgentDefinition;
-    value: AgentDefinition[keyof AgentDefinition];
-}, "agentDefinition/setAgentField">, setAgentMessages: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    messages: AgentDefinition["messages"];
-}, "agentDefinition/setAgentMessages">, setAgentSettings: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    settings: AgentDefinition["settings"];
-}, "agentDefinition/setAgentSettings">, setAgentVariableDefinitions: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    variableDefinitions: AgentDefinition["variableDefinitions"];
-}, "agentDefinition/setAgentVariableDefinitions">, setAgentControlBinding: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    settings: AgentDefinition["settings"];
-    variableDefinitions: AgentDefinition["variableDefinitions"];
-}, "agentDefinition/setAgentControlBinding">, setAgentContextPolicies: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    contextPolicies: AgentDefinition["contextPolicies"];
-}, "agentDefinition/setAgentContextPolicies">, setAgentTools: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    tools: AgentDefinition["tools"];
-}, "agentDefinition/setAgentTools">, setAgentCustomTools: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    customTools: AgentDefinition["customTools"];
-}, "agentDefinition/setAgentCustomTools">, setAgentMcpServers: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    mcpServers: AgentDefinition["mcpServers"];
-}, "agentDefinition/setAgentMcpServers">, setAgentSkillConfig: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    skillConfig: AgentDefinition["skillConfig"];
-}, "agentDefinition/setAgentSkillConfig">, setAgentModelTiers: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    modelTiers: AgentDefinition["modelTiers"];
-}, "agentDefinition/setAgentModelTiers">, setAgentOutputSchema: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    outputSchema: AgentDefinition["outputSchema"];
-}, "agentDefinition/setAgentOutputSchema">, setAgentUiGates: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    uiGates: AgentDefinition["uiGates"];
-}, "agentDefinition/setAgentUiGates">, setAgentMatrxDirectives: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    matrxDirectives: AgentDefinition["matrxDirectives"];
-}, "agentDefinition/setAgentMatrxDirectives">, resetAgentField: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    field: keyof AgentDefinition;
-}, "agentDefinition/resetAgentField">, resetAllAgentFields: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-}, "agentDefinition/resetAllAgentFields">, markAgentSaved: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-}, "agentDefinition/markAgentSaved">, markAgentFieldSaved: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    field: keyof AgentDefinition;
-}, "agentDefinition/markAgentFieldSaved">, rollbackAgentOptimisticUpdate: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-    snapshot: FieldSnapshot;
-}, "agentDefinition/rollbackAgentOptimisticUpdate">, undoAgentEdit: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-}, "agentDefinition/undoAgentEdit">, redoAgentEdit: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-}, "agentDefinition/redoAgentEdit">, clearAgentUndoHistory: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    id: string;
-}, "agentDefinition/clearAgentUndoHistory">, markAgentFieldsLoaded: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+}, "agentDefinition/mergePartialAgent">, markAgentFieldsLoaded: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     id: string;
     fields: (keyof AgentDefinition)[];
 }, "agentDefinition/markAgentFieldsLoaded">, setAgentFetchStatus: import("@reduxjs/toolkit").ActionCreatorWithPayload<{

package/dist/agents/redux/agent-definition/slice.js

@@ -1,19 +1,12 @@
 import { createSlice } from "@reduxjs/toolkit";
-import isEqual from "lodash/isEqual";
 import { isJsonObject } from "../../../utils/json.js";
 import {
-  shouldUpgradeFetchStatus,
-  UNDO_MAX_ENTRIES,
-  UNDO_MAX_BYTES,
-  UNDO_COALESCE_MS
+  shouldUpgradeFetchStatus
 } from "../../types/agent-definition.types.js";
 import {
   addField,
   assignField,
-  createFieldFlags,
-  fieldFlagsSize,
-  hasField,
-  removeField
+  createFieldFlags
 } from "@ai-matrx/agents/field-flags";
 function makeEmptyRecord(id) {
   return {
@@ -115,89 +108,7 @@ function mergeAndTrack(record, partial) {
     }
   });
 }
-function estimateBytes(value) {
-  if (value == null) return 8;
-  if (typeof value === "string") return value.length * 2;
-  if (typeof value === "number" || typeof value === "boolean") return 8;
-  try {
-    return JSON.stringify(value).length * 2;
-  } catch {
-    return 1024;
-  }
-}
-function totalStackBytes(stack) {
-  let total = 0;
-  for (const entry of stack) total += entry.byteEstimate;
-  return total;
-}
-function compressStack(stack) {
-  if (stack.length <= UNDO_MAX_ENTRIES && totalStackBytes(stack) <= UNDO_MAX_BYTES) {
-    return stack;
-  }
-  const protectedHead = 1;
-  const protectedTail = Math.min(20, Math.floor(stack.length * 0.4));
-  if (stack.length <= protectedHead + protectedTail) return stack;
-  const head = stack.slice(0, protectedHead);
-  const tail = stack.slice(-protectedTail);
-  let middle = stack.slice(protectedHead, stack.length - protectedTail);
-  const merged = [];
-  for (const entry of middle) {
-    const prev = merged[merged.length - 1];
-    if (prev && prev.field === entry.field) {
-      continue;
-    }
-    merged.push(entry);
-  }
-  middle = merged;
-  let result = [...head, ...middle, ...tail];
-  if (result.length > UNDO_MAX_ENTRIES) {
-    const thinned = [];
-    for (let i = 0; i < middle.length; i++) {
-      if (i % 2 === 0) thinned.push(middle[i]);
-    }
-    result = [...head, ...thinned, ...tail];
-  }
-  while (result.length > protectedHead + protectedTail + 1 && totalStackBytes(result) > UNDO_MAX_BYTES) {
-    result.splice(protectedHead, 1);
-  }
-  return result;
-}
-function pushUndoEntry(record, field, previousValue) {
-  const now = Date.now();
-  const bytes = estimateBytes(previousValue);
-  const top = record._undoPast[record._undoPast.length - 1];
-  if (top && top.field === field && now - top.timestamp < UNDO_COALESCE_MS) {
-    top.timestamp = now;
-  } else {
-    record._undoPast.push({
-      field,
-      value: previousValue,
-      timestamp: now,
-      byteEstimate: bytes
-    });
-  }
-  record._undoFuture = [];
-  record._undoPast = compressStack(record._undoPast);
-}
-function applyFieldEdit(record, field, value) {
-  const previousValue = record[field];
-  const wasDirty = hasField(record._dirtyFields, field);
-  if (!wasDirty && isEqual(value, previousValue)) return;
-  if (!wasDirty) {
-    record._fieldHistory[field] = previousValue;
-  }
-  pushUndoEntry(record, field, previousValue);
-  assignField(record, field, value);
-  const baseline = record._fieldHistory[field];
-  if (wasDirty && isEqual(value, baseline)) {
-    removeField(record._dirtyFields, field);
-    delete record._fieldHistory[field];
-  } else {
-    addField(record._dirtyFields, field);
-  }
-  record._dirty = fieldFlagsSize(record._dirtyFields) > 0;
-}
-function markRecordClean(record) {
+function markAgentRecordClean(record) {
   record._dirty = false;
   record._dirtyFields = createFieldFlags();
   record._fieldHistory = {};
@@ -241,7 +152,7 @@ const agentDefinitionSlice = createSlice({
       const normalizedData = messagesWereNormalized ? { ...withStar, messages: normalizedMessages } : withStar;
       if (existing) {
         mergeAndTrack(existing, normalizedData);
-        markRecordClean(existing);
+        markAgentRecordClean(existing);
         if (messagesWereNormalized) {
           addField(existing._dirtyFields, "messages");
           existing._dirty = true;
@@ -250,7 +161,7 @@ const agentDefinitionSlice = createSlice({
       } else {
         const record = makeEmptyRecord(data.id);
         mergeAndTrack(record, normalizedData);
-        markRecordClean(record);
+        markAgentRecordClean(record);
         if (messagesWereNormalized) {
           addField(record._dirtyFields, "messages");
           record._dirty = true;
@@ -325,7 +236,7 @@ const agentDefinitionSlice = createSlice({
       if (!state.agents[full.id]) {
         const record = makeEmptyRecord(full.id);
         mergeAndTrack(record, full);
-        markRecordClean(record);
+        markAgentRecordClean(record);
         if (seedMessagesNormalized) {
           addField(record._dirtyFields, "messages");
           record._dirty = true;
@@ -355,229 +266,6 @@ const agentDefinitionSlice = createSlice({
         state.agents[data.id] = record;
       }
     },
-    // ── User field edits (trigger dirty) ─────────────────────────────────────
-    /** Edit any single field by name. For scalars and simple values. */
-    setAgentField(state, action) {
-      const { id, field, value } = action.payload;
-      const record = state.agents[id];
-      if (!record) return;
-      applyFieldEdit(record, field, value);
-    },
-    // ── Dedicated actions for complex fields ──────────────────────────────────
-    setAgentMessages(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "messages", action.payload.messages);
-    },
-    setAgentSettings(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "settings", action.payload.settings);
-    },
-    setAgentVariableDefinitions(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(
-        record,
-        "variableDefinitions",
-        action.payload.variableDefinitions
-      );
-    },
-    /**
-     * Bind or unbind a model control to a variable in ONE edit (one undo step):
-     * the settings literal and the variable definitions move together.
-     * See features/agents/utils/control-variables.ts.
-     */
-    setAgentControlBinding(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "settings", action.payload.settings);
-      applyFieldEdit(
-        record,
-        "variableDefinitions",
-        action.payload.variableDefinitions
-      );
-    },
-    setAgentContextPolicies(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "contextPolicies", action.payload.contextPolicies);
-    },
-    setAgentTools(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "tools", action.payload.tools);
-    },
-    setAgentCustomTools(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "customTools", action.payload.customTools);
-    },
-    setAgentMcpServers(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "mcpServers", action.payload.mcpServers);
-    },
-    /**
-     * Per-agent skill exposure config. The full SkillConfig object is
-     * replaced atomically; the picker UI computes the next value and
-     * dispatches once. Marked dirty so the next save flushes it through
-     * to `agent.definition.skill_config`.
-     */
-    setAgentSkillConfig(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "skillConfig", action.payload.skillConfig);
-    },
-    setAgentModelTiers(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "modelTiers", action.payload.modelTiers);
-    },
-    setAgentOutputSchema(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "outputSchema", action.payload.outputSchema);
-    },
-    /**
-     * Model-gated UI flags (FE-only). The full UiGates object is replaced
-     * atomically; the gate editor computes the next value and dispatches once.
-     * Persisted to `agent.definition.ui_gates` — never sent to the server.
-     */
-    setAgentUiGates(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "uiGates", action.payload.uiGates);
-    },
-    /**
-     * Matrx Directives apply config. Replaced atomically by the Matrx Directives tab;
-     * persisted to `agent.definition.matrx_actions`. Read by aidream's output-directive
-     * dispatcher (full rebrand of the retired settings["output_apply"]).
-     */
-    setAgentMatrxDirectives(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      applyFieldEdit(record, "matrxDirectives", action.payload.matrxDirectives);
-    },
-    // ── Dirty / history management ────────────────────────────────────────────
-    /** Reset one field to its original value from _fieldHistory. */
-    resetAgentField(state, action) {
-      const { id, field } = action.payload;
-      const record = state.agents[id];
-      if (!record || !hasField(record._dirtyFields, field)) return;
-      const original = record._fieldHistory[field];
-      if (original !== void 0) {
-        assignField(record, field, original);
-      }
-      removeField(record._dirtyFields, field);
-      delete record._fieldHistory[field];
-      record._dirty = fieldFlagsSize(record._dirtyFields) > 0;
-    },
-    /** Reset ALL dirty fields to their original values. No refetch needed. */
-    resetAllAgentFields(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      Object.keys(record._fieldHistory).forEach(
-        (field) => {
-          const original = record._fieldHistory[field];
-          if (original !== void 0) {
-            assignField(record, field, original);
-          }
-        }
-      );
-      markRecordClean(record);
-    },
-    /** Called after a successful save. Current values become the new clean baseline. */
-    markAgentSaved(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      markRecordClean(record);
-    },
-    /**
-     * A SINGLE field was written to the database (inline edits such as the
-     * Agent Info Editor's name). Only that field becomes the clean baseline —
-     * every other staged edit (e.g. an Output Schema kind binding applied in
-     * Model Settings) must stay dirty so the main Save still persists it.
-     * `markAgentSaved` here used to wipe every dirty flag, silently dropping
-     * unrelated staged edits (feedback 222a2925).
-     */
-    markAgentFieldSaved(state, action) {
-      const { id, field } = action.payload;
-      const record = state.agents[id];
-      if (!record) return;
-      removeField(record._dirtyFields, field);
-      delete record._fieldHistory[field];
-      record._undoPast = record._undoPast.filter((e) => e.field !== field);
-      record._undoFuture = record._undoFuture.filter((e) => e.field !== field);
-      record._dirty = fieldFlagsSize(record._dirtyFields) > 0;
-    },
-    /** Save failed — restore from the snapshot taken before the optimistic write. */
-    rollbackAgentOptimisticUpdate(state, action) {
-      const { id, snapshot } = action.payload;
-      const record = state.agents[id];
-      if (!record) return;
-      Object.keys(snapshot).forEach((field) => {
-        const value = snapshot[field];
-        if (value !== void 0) {
-          assignField(record, field, value);
-        }
-      });
-      record._dirty = fieldFlagsSize(record._dirtyFields) > 0;
-    },
-    // ── Undo / Redo ──────────────────────────────────────────────────────────
-    /**
-     * Pops the most recent entry from _undoPast, pushes current value to
-     * _undoFuture, and restores the previous value. Also maintains dirty tracking.
-     */
-    undoAgentEdit(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record || record._undoPast.length === 0) return;
-      const entry = record._undoPast.pop();
-      if (!entry) return;
-      const currentValue = record[entry.field];
-      record._undoFuture.push({
-        field: entry.field,
-        value: currentValue,
-        timestamp: Date.now(),
-        byteEstimate: estimateBytes(currentValue)
-      });
-      assignField(record, entry.field, entry.value);
-      const originalValue = record._fieldHistory[entry.field];
-      if (originalValue !== void 0 && isEqual(entry.value, originalValue)) {
-        removeField(record._dirtyFields, entry.field);
-        delete record._fieldHistory[entry.field];
-      } else if (!hasField(record._dirtyFields, entry.field)) {
-        addField(record._dirtyFields, entry.field);
-      }
-      record._dirty = fieldFlagsSize(record._dirtyFields) > 0;
-    },
-    /**
-     * Pops the most recent entry from _undoFuture, pushes current value to
-     * _undoPast, and applies the redo value. Also maintains dirty tracking.
-     */
-    redoAgentEdit(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record || record._undoFuture.length === 0) return;
-      const entry = record._undoFuture.pop();
-      if (!entry) return;
-      const currentValue = record[entry.field];
-      record._undoPast.push({
-        field: entry.field,
-        value: currentValue,
-        timestamp: Date.now(),
-        byteEstimate: estimateBytes(currentValue)
-      });
-      assignField(record, entry.field, entry.value);
-      addField(record._dirtyFields, entry.field);
-      record._dirty = true;
-    },
-    /** Clears the undo/redo stacks without affecting the current state. */
-    clearAgentUndoHistory(state, action) {
-      const record = state.agents[action.payload.id];
-      if (!record) return;
-      record._undoPast = [];
-      record._undoFuture = [];
-    },
     // ── Explicitly mark fields as loaded (without writing data) ──────────────
     markAgentFieldsLoaded(state, action) {
       const record = state.agents[action.payload.id];
@@ -637,28 +325,6 @@ const {
   upsertAgent,
   seedAgentFromTemplate,
   mergePartialAgent,
-  setAgentField,
-  setAgentMessages,
-  setAgentSettings,
-  setAgentVariableDefinitions,
-  setAgentControlBinding,
-  setAgentContextPolicies,
-  setAgentTools,
-  setAgentCustomTools,
-  setAgentMcpServers,
-  setAgentSkillConfig,
-  setAgentModelTiers,
-  setAgentOutputSchema,
-  setAgentUiGates,
-  setAgentMatrxDirectives,
-  resetAgentField,
-  resetAllAgentFields,
-  markAgentSaved,
-  markAgentFieldSaved,
-  rollbackAgentOptimisticUpdate,
-  undoAgentEdit,
-  redoAgentEdit,
-  clearAgentUndoHistory,
   markAgentFieldsLoaded,
   setAgentFetchStatus,
   setAgentLoading,
@@ -672,39 +338,18 @@ const {
 var slice_default = agentDefinitionSlice.reducer;
 export {
   agentDefinitionSlice,
-  clearAgentUndoHistory,
   slice_default as default,
-  markAgentFieldSaved,
   markAgentFieldsLoaded,
-  markAgentSaved,
+  markAgentRecordClean,
   mergePartialAgent,
-  redoAgentEdit,
   removeAgent,
   removeVersionsByParentId,
-  resetAgentField,
-  resetAllAgentFields,
-  rollbackAgentOptimisticUpdate,
   seedAgentFromTemplate,
   setActiveAgentId,
-  setAgentContextPolicies,
-  setAgentControlBinding,
-  setAgentCustomTools,
   setAgentError,
   setAgentFetchStatus,
-  setAgentField,
   setAgentLoading,
-  setAgentMatrxDirectives,
-  setAgentMcpServers,
-  setAgentMessages,
-  setAgentModelTiers,
-  setAgentOutputSchema,
-  setAgentSettings,
-  setAgentSkillConfig,
-  setAgentTools,
-  setAgentUiGates,
-  setAgentVariableDefinitions,
   setAgentsError,
   setAgentsStatus,
-  undoAgentEdit,
   upsertAgent
 };

package/dist/agents/redux/agent-definition/thunks.d.ts

@@ -227,21 +227,6 @@ export declare const fetchAgentRunControls: import("@reduxjs/toolkit").AsyncThun
     dispatch: ChatDispatch;
     state: ChatRootState;
 }>;
-/**
- * Fetches the complete agent row via PostgREST and upserts it into state.
- * Marks the record fully clean — all fields tracked as loaded.
- * Use this when opening the agent builder or after creating/duplicating an agent.
- */
-export declare const fetchFullAgent: import("@reduxjs/toolkit").AsyncThunk<void, string, {
-    extra?: unknown;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-    dispatch: ChatDispatch;
-    state: ChatRootState;
-}>;
 export interface SharedAgentItem {
     id: string;
     name: string;

package/dist/agents/redux/agent-definition/thunks.js

@@ -30,7 +30,6 @@ import {
   readFavoriteIds
 } from "../../../context/sources/scopes.js";
 import {
-  upsertAgent,
   mergePartialAgent,
   setAgentFetchStatus,
   setAgentLoading,
@@ -43,7 +42,6 @@ import {
   selectAgentRunControlsReady
 } from "./selectors.js";
 import {
-  dbRowToAgentDefinition,
   parseSkillConfigJson
 } from "./converters.js";
 import {
@@ -362,20 +360,6 @@ const fetchAgentRunControls = createAsyncThunk(
     );
   }
 );
-const fetchFullAgent = createAsyncThunk(
-  "agentDefinition/fetchFull",
-  async (agentId, { dispatch }) => {
-    dispatch(setAgentLoading({ id: agentId, loading: true }));
-    const { data, error } = await supabase.schema("agent").from("definition").select("*").eq("id", agentId).single();
-    dispatch(setAgentLoading({ id: agentId, loading: false }));
-    if (error) {
-      dispatch(setAgentError({ id: agentId, error: error.message }));
-      throw agentNameTakenError(error) ?? pgErrorToError(error);
-    }
-    dispatch(upsertAgent(dbRowToAgentDefinition(data)));
-    await overlayAgentFavorites(dispatch, [agentId]);
-  }
-);
 const fetchSharedAgents = createAsyncThunk("agentDefinition/fetchShared", async (_, { dispatch }) => {
   const { data, error } = await supabase.rpc("agx_get_shared_with_me");
   if (error) throw pgErrorToError(error);
@@ -455,7 +439,6 @@ export {
   fetchAgentRunTier,
   fetchAgentsList,
   fetchAgentsListFull,
-  fetchFullAgent,
   fetchSharedAgents,
   fetchSharedAgentsForChat,
   initializeChatAgents,

package/dist/host/db-types.d.ts

@@ -10184,6 +10184,113 @@ export type ChatDatabase = {
                     }
                 ];
             };
+            udt_dataset_template_fields: {
+                Row: {
+                    created_at: string;
+                    custom_fields: Json;
+                    data_type: Database["public"]["Enums"]["field_data_type"];
+                    default_value: Json | null;
+                    display_name: string;
+                    field_name: string;
+                    field_order: number;
+                    id: string;
+                    is_required: boolean;
+                    metadata: Json;
+                    organization_id: string;
+                    template_id: string;
+                    updated_at: string;
+                    validation_rules: Json | null;
+                };
+                Insert: {
+                    created_at?: string;
+                    custom_fields?: Json;
+                    data_type?: Database["public"]["Enums"]["field_data_type"];
+                    default_value?: Json | null;
+                    display_name: string;
+                    field_name: string;
+                    field_order?: number;
+                    id?: string;
+                    is_required?: boolean;
+                    metadata?: Json;
+                    organization_id: string;
+                    template_id: string;
+                    updated_at?: string;
+                    validation_rules?: Json | null;
+                };
+                Update: {
+                    created_at?: string;
+                    custom_fields?: Json;
+                    data_type?: Database["public"]["Enums"]["field_data_type"];
+                    default_value?: Json | null;
+                    display_name?: string;
+                    field_name?: string;
+                    field_order?: number;
+                    id?: string;
+                    is_required?: boolean;
+                    metadata?: Json;
+                    organization_id?: string;
+                    template_id?: string;
+                    updated_at?: string;
+                    validation_rules?: Json | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "udt_dataset_template_fields_template_id_fkey";
+                        columns: ["template_id"];
+                        isOneToOne: false;
+                        referencedRelation: "udt_dataset_templates";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            udt_dataset_templates: {
+                Row: {
+                    created_at: string;
+                    created_by: string | null;
+                    custom_fields: Json;
+                    deleted_at: string | null;
+                    description: string;
+                    id: string;
+                    is_active: boolean;
+                    metadata: Json;
+                    name: string;
+                    organization_id: string;
+                    updated_at: string;
+                    updated_by: string | null;
+                    version: number;
+                };
+                Insert: {
+                    created_at?: string;
+                    created_by?: string | null;
+                    custom_fields?: Json;
+                    deleted_at?: string | null;
+                    description?: string;
+                    id?: string;
+                    is_active?: boolean;
+                    metadata?: Json;
+                    name: string;
+                    organization_id: string;
+                    updated_at?: string;
+                    updated_by?: string | null;
+                    version?: number;
+                };
+                Update: {
+                    created_at?: string;
+                    created_by?: string | null;
+                    custom_fields?: Json;
+                    deleted_at?: string | null;
+                    description?: string;
+                    id?: string;
+                    is_active?: boolean;
+                    metadata?: Json;
+                    name?: string;
+                    organization_id?: string;
+                    updated_at?: string;
+                    updated_by?: string | null;
+                    version?: number;
+                };
+                Relationships: [];
+            };
             udt_datasets: {
                 Row: {
                     created_at: string;

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

@@ -61,6 +61,12 @@ export declare function formatMetaNumber(n: number): string;
  * line still says it is there.
  */
 export declare function isNotApplicableValue(val: unknown): boolean;
+/**
+ * The collapsed omission line NAMES what did not apply (review 8041caec,
+ * 2026-10-07: "1 field did not apply" left the reader guessing which). Up to
+ * three names are listed; past that the rest is counted.
+ */
+export declare function notApplicableSummary(names: readonly string[]): string;
 /**
  * An object carrying its own `__kind` is a kind, not a field list: it renders
  * through the value door (`KindValueNode` → `AnswerValueView`) and the caller

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

@@ -118,6 +118,13 @@ const IdentifierListRow = ({
     open && /* @__PURE__ */ jsx("div", { className: "mt-1 flex flex-wrap items-center gap-1.5", children: ids.map((id, i) => /* @__PURE__ */ jsx(ShortId, { value: id }, `${id}-${i}`)) })
   ] });
 };
+function notApplicableSummary(names) {
+  if (names.length === 0) return "";
+  const head = `${names.length} ${names.length === 1 ? "field" : "fields"} did not apply`;
+  const shown = names.slice(0, 3).join(", ");
+  const more = names.length - 3;
+  return `${head}: ${shown}${more > 0 ? ` and ${more} more` : ""}`;
+}
 const NotApplicableRow = ({ entries, labels, density, depth, embedMedia }) => {
   const [open, setOpen] = React.useState(false);
   return /* @__PURE__ */ jsxs("div", { className: "text-xs text-muted-foreground", children: [
@@ -125,7 +132,7 @@ const NotApplicableRow = ({ entries, labels, density, depth, embedMedia }) => {
       e.stopPropagation();
       setOpen((v) => !v);
     }, children: [
-      `${entries.length} ${entries.length === 1 ? "field" : "fields"} did not apply`,
+      notApplicableSummary(entries.map(([key]) => fieldLabel(key, labels).label)),
       open ? " \u2014 hide" : " \u2014 show"
     ] }),
     open && /* @__PURE__ */ jsx("dl", { className: "mt-1 grid grid-cols-[fit-content(40%)_minmax(0,1fr)] items-baseline gap-x-4 gap-y-1", children: entries.map(([key, val]) => /* @__PURE__ */ jsxs(React.Fragment, { children: [
@@ -287,5 +294,6 @@ export {
   humanNameSiblingKey,
   isIdentifierKey,
   isIdentifierListKey,
-  isNotApplicableValue
+  isNotApplicableValue,
+  notApplicableSummary
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "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,12 +226,12 @@
     "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/content-ir-react": "latest",
-    "@ai-matrx/canvas": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/canvas": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
@@ -239,11 +239,11 @@
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
+    "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/agents": "latest"
+    "@ai-matrx/records": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",