@ai-matrx/chat 0.3.20 → 0.3.23

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 0.3.23 — 2026-10-07
+### The working document reaches the agent again
+
+- The page rule (2026-10-01) withheld every value the chat page declares from the chat's own conversation. The chat manifest declares a lean ref named `working_document`, so the conversation's real, agent-editable working document was sent as `context_withheld: ["working_document"]` on every main-chat turn — the agent answered "I don't see a document". `working_document`, `user_scratchpad` and `user_scratchpad_<id8>` are now never the page's (`request-context.ts` `neverThePage`), matching aidream `page_withholds` and `@ai-matrx/agents` `pageContextWithholds` (parity corpus cases added).
+- Consumer action: none.
+
+## 0.3.22 — 2026-10-07
+
+- `useDomCapturePrint`'s PDF goes through Alchemy's `/operate/capture` `documentToPdf` + kit `downloadFile` (needs alchemy 0.20.0), not `@ai-matrx/print/pdf` directly (AP-2 fifth check). Same options, same file name.
+
+**Consumer action:** none.
+
+## 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
 

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/agents/redux/execution-system/context-rules/request-context.js

@@ -41,6 +41,10 @@ import { selectSavedContextRuleRows } from "./context-rules.thunks.js";
 import { deliveredFieldsFor, toContextReceipt } from "./receipt-check.js";
 import { resolveClientSurface } from "../utils/build-tool-injection.js";
 import { surfaceWritesNoteSource } from "../utils/surface-writes-note.js";
+import { docKindForContextKey } from "../../../utils/workingDocumentContext.js";
+function neverThePage(key) {
+  return PERSON_CONTEXT_VALUES.has(key) || docKindForContextKey(key) !== null;
+}
 function pageContextFor(state, conversationId) {
   const owner = pageOwningConversation(conversationId);
   if (owner) {
@@ -49,7 +53,7 @@ function pageContextFor(state, conversationId) {
     return {
       mode: "own",
       withheld: listed.filter(
-        (key) => !PERSON_CONTEXT_VALUES.has(key) && !(companionOpen && key === SURFACE_CHAIN_KEY)
+        (key) => !neverThePage(key) && !(companionOpen && key === SURFACE_CHAIN_KEY)
       )
     };
   }
@@ -59,7 +63,7 @@ function pageContextFor(state, conversationId) {
   return null;
 }
 function pageWithholds(page, key, surfaceKey) {
-  if (!page || PERSON_CONTEXT_VALUES.has(key)) return false;
+  if (!page || neverThePage(key)) return false;
   if (page.withheld.includes(key)) return true;
   return Boolean(surfaceKey && surfaceKey !== DEFAULT_SURFACE_KEY);
 }

package/dist/conversation/hooks/useDomCapturePrint.js

@@ -18,16 +18,20 @@ function useDomCapturePrint() {
     try {
       const { renderAllDiagrams } = await import("../../host/markdown-slots.js");
       releaseRenderAll = (await renderAllDiagrams()).release;
-      const { captureToPDF } = await import("@ai-matrx/print/pdf");
-      await captureToPDF(el, {
-        filename: "ai-response",
+      const [{ documentToPdf }, { downloadFile }] = await Promise.all([
+        import("@ai-matrx/alchemy/operate/capture"),
+        import("@ai-matrx/kit/download")
+      ]);
+      const { filename = "ai-response", ...captureOptions } = options;
+      const pdf = await documentToPdf(el, {
         scale: 2,
-        ...options,
+        ...captureOptions,
         onProgress: (page, total) => {
           setProgress(Math.round(page / Math.max(total, 1) * 100));
           options.onProgress?.(page, total);
         }
       });
+      downloadFile(`${filename}.pdf`, pdf, "application/pdf");
     } catch (err) {
       const msg = err instanceof Error ? err.message : "PDF export failed";
       setError(msg);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.20",
+  "version": "0.3.23",
   "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,24 +226,24 @@
     "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/agents": "latest",
     "@ai-matrx/canvas": "latest",
-    "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/tap-target": "latest",
     "@ai-matrx/records": "latest",
-    "@ai-matrx/records-ui": "latest"
+    "@ai-matrx/records-ui": "latest",
+    "@ai-matrx/tap-target": "latest",
+    "@ai-matrx/content-ir-react": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",