@ai-matrx/chat 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-matrx/chat
 
+## 0.2.1
+### Re-sync with matrx-frontend's packages/chat (P27)
+
+- Carries every frontend-side change made to `packages/chat` after the 0.2.0 copy: a pasted image
+  attaches once (react-dropzone owns paste; the hand-rolled paste handler is gone; the host's
+  no-paste setting reaches the drop target), the Chat/Work/Advanced switch is the design system's
+  `SegmentedControl`, the send tooltip uses `isMacLike` and the Connect chip the one GitHub glyph,
+  surfaces import `@ai-matrx/alchemy/operate` (ALC-16/17: platform write targets, Save to
+  document/workbook through the one door, `receipt.result` carries what the page's handler made).
+- Fixes the copy's stale host suites (they import `testing/fake-db`, as the frontend moved them).
+- Consumer action: none.
+
 ## 0.2.0
 ### The full chat system moves in (P27, PACKAGE-INDEPENDENCE)
 

package/dist/agent-copy/AlchemySurfaceBridge.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { type SurfaceHandle } from "@ai-matrx/kit/content-transfer";
+import { type SurfaceHandle } from "@ai-matrx/alchemy/operate";
 import type { SurfaceScopePayload } from "../surfaces/types.js";
 /**
  * Creates a handle for this exact React mount. Hook-only runtime registrations

package/dist/agent-copy/AlchemySurfaceBridge.js

@@ -3,7 +3,7 @@ import { jsx } from "react/jsx-runtime";
 import { useEffect, useId, useRef } from "react";
 import {
   createSurfaceTransferHandle
-} from "@ai-matrx/kit/content-transfer";
+} from "@ai-matrx/alchemy/operate";
 import { ContentTransferSurfaceProvider } from "@ai-matrx/design-system/content-transfer";
 import { getSurfaceManifest } from "../host/ui-slots.js";
 function useAlchemySurfaceHandle(surfaceName, getScope) {

package/dist/agent-copy/buildAgentPayload.d.ts

@@ -1,2 +1,2 @@
 /** Compatibility import path; agent envelope serialization is package-owned. */
-export { buildAgentPayload, fenceJsonBlock, type AgentPayloadInput, } from "@ai-matrx/kit/content-transfer";
+export { buildAgentPayload, fenceJsonBlock, type AgentPayloadInput, } from "@ai-matrx/alchemy/operate";

package/dist/agent-copy/buildAgentPayload.js

@@ -1,7 +1,7 @@
 import {
   buildAgentPayload,
   fenceJsonBlock
-} from "@ai-matrx/kit/content-transfer";
+} from "@ai-matrx/alchemy/operate";
 export {
   buildAgentPayload,
   fenceJsonBlock

package/dist/agent-copy/page-capture/pageCapture.d.ts

@@ -14,7 +14,7 @@
  * sections, and the recent requests with their timings. Pure: no React, no
  * network — the suite drives it directly.
  */
-import type { AgentPayloadInput } from "@ai-matrx/kit/content-transfer";
+import type { AgentPayloadInput } from "@ai-matrx/alchemy/operate";
 import type { AlchemyGroomerConfig } from "@ai-matrx/design-system/content-transfer";
 export type PageCaptureKind = "table-page" | "record" | "dialog" | "admin-page";
 /** A chosen thing, by name and id. Either may be null (not chosen / not loaded). */

package/dist/agents/components/inputs/smart-input/AgentTextarea.d.ts

@@ -21,7 +21,6 @@ interface AgentTextareaProps {
     singleRow?: boolean;
     uploadRoot?: string;
     uploadPath?: string;
-    enablePasteImages?: boolean;
     surfaceKey?: string;
     /**
      * The key an unsent draft is also kept under, so it survives a reload of a
@@ -62,5 +61,5 @@ interface AgentTextareaProps {
     /** With `composerType`: each text line is one 32px composer row (splash · page). */
     composerRows?: boolean;
 }
-export declare function AgentTextarea({ conversationId, compact, singleRow, uploadRoot, uploadPath, enablePasteImages, surfaceKey, draftAlias, disableSend, initiallyExpanded, autoFocus, showExpandToggle, placeholder, minHeightPx, flush, composerType, composerRows, maxHeightPx, textMenu, }: AgentTextareaProps): React.JSX.Element;
+export declare function AgentTextarea({ conversationId, compact, singleRow, uploadRoot, uploadPath, surfaceKey, draftAlias, disableSend, initiallyExpanded, autoFocus, showExpandToggle, placeholder, minHeightPx, flush, composerType, composerRows, maxHeightPx, textMenu, }: AgentTextareaProps): React.JSX.Element;
 export {};

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

@@ -23,14 +23,12 @@ import {
   selectComposerHasSomethingToSend,
   selectIsExecuting
 } from "../../../redux/execution-system/selectors/aggregate.selectors.js";
-import { useClipboardPaste } from "../../../../host/ui-slots.js";
 import { focusUnlessTypingElsewhere } from "../../../../utils/dom/focus-guard.js";
 import {
   composerKeyIntent,
   intentTakesTheKey
 } from "../../../../ui/composer/composerSubmit.js";
 import { readVerticalChrome, snapToLineGrid } from "./textarea-line-grid.js";
-import { usePasteImageResource } from "../resources/usePasteImageResource.js";
 import { useInstanceInputUndoRedo } from "../../../hooks/useInstanceInputUndoRedo.js";
 import { ComposerDraftNotice } from "./ComposerDraftNotice.js";
 import { ComposerToolsNotice } from "./ComposerToolsNotice.js";
@@ -48,7 +46,6 @@ function AgentTextarea({
   singleRow = false,
   uploadRoot = "userContent",
   uploadPath = "agent-attachments",
-  enablePasteImages = true,
   surfaceKey,
   draftAlias,
   disableSend = false,
@@ -128,15 +125,6 @@ function AgentTextarea({
     if (disableSend) return;
     dispatch(interruptAndSend({ conversationId, surfaceKey }));
   }, [disableSend, conversationId, surfaceKey, dispatch]);
-  const handlePasteImage = usePasteImageResource(conversationId, {
-    uploadRoot,
-    uploadPath
-  });
-  useClipboardPaste({
-    textareaRef,
-    onPasteImage: handlePasteImage,
-    disabled: !enablePasteImages
-  });
   const handleTextChange = useCallback(
     (value) => {
       dispatch(

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

@@ -36,6 +36,7 @@ import {
   smartExecute,
   cancelExecution
 } from "../../../redux/execution-system/thunks/smart-execute.thunk.js";
+import { isMacLike } from "../../../hooks/useAgentUndoRedo.js";
 import { MicDeviceMenu } from "../../../../host/ui-slots.js";
 import { Button, SplitButton } from "@ai-matrx/design-system/controls";
 import { cn } from "@ai-matrx/design-system";
@@ -212,7 +213,6 @@ function ComposerSendSlot({
   );
   return /* @__PURE__ */ jsx(Fragment, { children: children(hasSomethingToSend) });
 }
-const IS_MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent);
 function Keys({ keys }) {
   return /* @__PURE__ */ jsx("span", { className: "flex shrink-0 items-center gap-0.5", children: keys.map((key) => /* @__PURE__ */ jsx(
     "kbd",
@@ -230,7 +230,7 @@ function ComposerSendButton({
   disabled,
   onSend
 }) {
-  const mod = IS_MAC ? "\u2318" : "Ctrl";
+  const mod = isMacLike() ? "\u2318" : "Ctrl";
   const rows = isExecuting ? [
     { label: "Queue for when it finishes", keys: submitOnEnter ? ["\u21B5"] : [mod, "\u21B5"] },
     ...submitOnEnter ? [{ label: "Steer in now", keys: [mod, "\u21B5"] }] : [],

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

@@ -77,6 +77,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cn(
               "relative flex w-full min-h-0 flex-col gap-1.5 border border-border bg-card transition-colors focus-within:border-foreground/25",
               "[&_[data-variable-row]]:px-1.5 [&_[data-variable-heading]]:px-1.5 [&>input[type=file]]:!hidden",
@@ -152,7 +153,6 @@ function SmartAgentInputStacked({
       compact: isCompact,
       uploadRoot,
       uploadPath,
-      enablePasteImages,
       surfaceKey,
       disableSend: sendBlocked,
       initiallyExpanded: expandRequestKey > 0,
@@ -192,6 +192,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cn(
               "relative flex w-full min-h-0 flex-col gap-1 rounded-[18px] border p-1.5",
               "border-glass-edge bg-glass shadow-glass backdrop-blur-glass backdrop-saturate-glass transition-[border-color,background-color,box-shadow]",
@@ -230,7 +231,6 @@ function SmartAgentInputStacked({
                     compact: true,
                     uploadRoot,
                     uploadPath,
-                    enablePasteImages,
                     surfaceKey,
                     disableSend: sendBlocked,
                     autoFocus: false,
@@ -280,6 +280,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cardClassName,
             children: [
               /* @__PURE__ */ jsx(

package/dist/agents/components/inputs/smart-input/SmartInputFileDropTarget.d.ts

@@ -2,7 +2,14 @@ interface SmartInputFileDropTargetProps extends Omit<React.ComponentPropsWithout
     conversationId: string;
     uploadRoot?: string;
     uploadPath?: string;
+    /**
+     * Pasted files (a screenshot, Cmd/Ctrl+V of a copied file) attach through
+     * the same upload as a drop. react-dropzone OWNS paste-to-upload (v20+,
+     * on by default); nothing else in the input may also catch the paste, or
+     * every pasted image attaches twice (2026-10-06). False = paste stays text.
+     */
+    pasteFiles?: boolean;
     children: React.ReactNode;
 }
-export declare function SmartInputFileDropTarget({ conversationId, uploadRoot, uploadPath, className, children, ...rootProps }: SmartInputFileDropTargetProps): import("react").JSX.Element;
+export declare function SmartInputFileDropTarget({ conversationId, uploadRoot, uploadPath, pasteFiles, className, children, ...rootProps }: SmartInputFileDropTargetProps): import("react").JSX.Element;
 export {};

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

@@ -8,6 +8,7 @@ function SmartInputFileDropTarget({
   conversationId,
   uploadRoot,
   uploadPath,
+  pasteFiles = true,
   className,
   children,
   ...rootProps
@@ -19,7 +20,8 @@ function SmartInputFileDropTarget({
   const { getRootProps, getInputProps, isDragActive } = useDropzone({
     onDrop: (files) => void uploadResources(files),
     noClick: true,
-    noKeyboard: true
+    noKeyboard: true,
+    noPaste: !pasteFiles
   });
   return /* @__PURE__ */ jsxs(
     "div",

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

@@ -16,7 +16,7 @@ import {
   COMPOSER_MODE_LABELS
 } from "./composer-types.js";
 import { useComposerMode } from "./useComposerMode.js";
-import { Button } from "@ai-matrx/design-system/controls";
+import { SegmentedControl } from "@ai-matrx/design-system/controls";
 function ComposerModeSwitch({
   initialMode,
   size = "bar",
@@ -30,20 +30,15 @@ function ComposerModeSwitch({
   const fit = useCenterControlFit(cellRef, [fullRef, triggerRef], mode);
   const measured = useSyncExternalStore(noopSubscribe, () => true, () => false);
   const renderSegments = (interactive) => /* @__PURE__ */ jsx(
-    "div",
+    SegmentedControl,
     {
-      role: interactive ? "tablist" : void 0,
-      "aria-label": interactive ? "Composer mode" : void 0,
-      className: cn(
-        "shrink-0 items-center gap-0.5 rounded-lg bg-muted p-0.5",
-        panel || !interactive ? "inline-flex rounded-lg" : measured ? "inline-flex rounded-[10px]" : "hidden rounded-[10px] sm:inline-flex",
-        !interactive && "w-max max-w-none",
-        className
-      ),
-      children: COMPOSER_MODES.map((value) => {
-        const on = value === mode;
-        return /* @__PURE__ */ jsx(Button, { variant: "quiet", pressed: !!on, role: interactive ? "tab" : void 0, "aria-selected": interactive ? on : void 0, "aria-pressed": interactive ? void 0 : on, tabIndex: interactive ? void 0 : -1, onClick: interactive ? () => setMode(value) : void 0, children: COMPOSER_MODE_LABELS[value] }, value);
-      })
+      "aria-label": "Composer mode",
+      value: mode,
+      onValueChange: (value) => {
+        if (interactive) setMode(value);
+      },
+      data: COMPOSER_MODES.map((value) => ({ value, label: COMPOSER_MODE_LABELS[value] })),
+      className: cn("shrink-0", !interactive && "w-max max-w-none", className)
     }
   );
   if (panel) return renderSegments(true);
@@ -61,7 +56,7 @@ function ComposerModeSwitch({
       className: "relative flex w-full min-w-0 justify-center",
       "data-route-nav-inflow": fit.inflow ? "" : void 0,
       children: [
-        /* @__PURE__ */ jsxs("div", { "aria-hidden": true, className: "pointer-events-none invisible absolute left-0 top-0", children: [
+        /* @__PURE__ */ jsxs("div", { "aria-hidden": true, inert: true, className: "pointer-events-none invisible absolute left-0 top-0", children: [
           /* @__PURE__ */ jsx("div", { ref: fullRef, className: "w-max max-w-none", children: renderSegments(false) }),
           /* @__PURE__ */ jsx("span", { ref: triggerRef, "data-route-nav-min": true, className: cn(triggerClass, "w-max max-w-none"), children: triggerFace })
         ] }),

package/dist/surfaces/manifests/_baseline.manifest.d.ts

@@ -150,6 +150,65 @@ export declare const PLATFORM_CONTEXT_VALUES: {
         readonly sortOrder: 9997;
     };
 };
+/**
+ * THE BASELINE SURFACE — where the platform's own write targets are declared
+ * (Matrx Alchemy ALC-17). Every surface inherits it: the one write door reads
+ * it as the root ancestor of every surface (`surfaceWriteDeclarations` in
+ * `runtime/surface-writeback.ts`), so a write to a platform target from ANY
+ * surface resolves here, and the platform's headless handlers are registered
+ * on this name. It is not a page and is never mounted.
+ */
+export declare const BASELINE_SURFACE_NAME = "matrx-platform/baseline";
+/** `surface_feedback` value bounds — the description and the check read the same numbers. */
+export declare const SURFACE_FEEDBACK_KINDS: readonly ["missing_capability", "wrong_or_unclear_description", "bug", "missing_data", "suggestion"];
+export declare const SURFACE_FEEDBACK_MESSAGE_MIN = 10;
+export declare const SURFACE_FEEDBACK_MESSAGE_MAX = 4000;
+/** At most this many custom fields per `custom_fields_add` write. */
+export declare const CUSTOM_FIELDS_MAX_PER_WRITE = 10;
+/**
+ * THE PLATFORM WRITE TARGETS, declared once on the baseline surface. Each has
+ * the apply policy it always had: window fields and custom fields are `ask`
+ * (an agent's write waits for the person's card; a person's own write is the
+ * approval); feedback is `auto` (it changes nothing on the page). The runtime
+ * files word the live offer from these (`customFieldsTarget()` adds the
+ * mounted sections), and register the handlers that apply them.
+ */
+export declare const PLATFORM_WRITE_TARGETS: {
+    readonly window_form_fields: {
+        readonly name: "window_form_fields";
+        readonly label: "Fields in an open window";
+        readonly description: 'Change fields in an open window that has no registered surface (listed in your context as window::<title>). Value: { "window": "<title exactly as listed>", "changes": [{ "field": "<field key>", "value": <new value> }] }. A text or number field takes a string or number, a checkbox or switch takes true/false, a list takes the text of one of its choices (a wrong choice is refused with the real ones). Every change is checked against the field\'s rules before anything lands; the person approves first, and the window\'s own Save still decides.';
+        readonly valueType: "object";
+        readonly mode: "draft";
+        readonly applyPolicy: "ask";
+    };
+    readonly surface_feedback: {
+        readonly name: "surface_feedback";
+        readonly label: "Feedback about this page";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "auto";
+    };
+    readonly custom_fields_add: {
+        readonly name: "custom_fields_add";
+        readonly label: "Add custom fields";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "ask";
+    };
+    readonly custom_fields_set: {
+        readonly name: "custom_fields_set";
+        readonly label: "Fill in custom fields";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "ask";
+    };
+};
+export type PlatformWriteTargetName = keyof typeof PLATFORM_WRITE_TARGETS;
+export declare function isPlatformWriteTarget(name: string): name is PlatformWriteTargetName;
 /** Names only the platform writes — a manifest declaring one is refused. */
 export declare const PLATFORM_RESERVED_NAMES: {
     values: ReadonlyArray<string>;

package/dist/surfaces/manifests/_baseline.manifest.js

@@ -101,9 +101,57 @@ const PLATFORM_CONTEXT_VALUES = {
     sortOrder: 9997
   }
 };
+const BASELINE_SURFACE_NAME = "matrx-platform/baseline";
+const SURFACE_FEEDBACK_KINDS = [
+  "missing_capability",
+  "wrong_or_unclear_description",
+  "bug",
+  "missing_data",
+  "suggestion"
+];
+const SURFACE_FEEDBACK_MESSAGE_MIN = 10;
+const SURFACE_FEEDBACK_MESSAGE_MAX = 4e3;
+const CUSTOM_FIELDS_MAX_PER_WRITE = 10;
+const PLATFORM_WRITE_TARGETS = {
+  window_form_fields: {
+    name: "window_form_fields",
+    label: "Fields in an open window",
+    description: `Change fields in an open window that has no registered surface (listed in your context as window::<title>). Value: { "window": "<title exactly as listed>", "changes": [{ "field": "<field key>", "value": <new value> }] }. A text or number field takes a string or number, a checkbox or switch takes true/false, a list takes the text of one of its choices (a wrong choice is refused with the real ones). Every change is checked against the field's rules before anything lands; the person approves first, and the window's own Save still decides.`,
+    valueType: "object",
+    mode: "draft",
+    applyPolicy: "ask"
+  },
+  surface_feedback: {
+    name: "surface_feedback",
+    label: "Feedback about this page",
+    description: `Save feedback about this page (surface) for the team that builds it \u2014 it changes NOTHING on the page and nobody is asked. Use it when something about the page got in your way: a write you needed does not exist, a description was wrong or unclear, data you needed was missing or arrived in an awkward form, or something broke. Also use it when the person asks you to give feedback on this page. Value: { "kind": "${SURFACE_FEEDBACK_KINDS.join(" | ")}", "message": "<what happened and what would have helped, ${SURFACE_FEEDBACK_MESSAGE_MIN}-${SURFACE_FEEDBACK_MESSAGE_MAX} characters>", "target_or_value": "<optional: the write target or value name it concerns>" }. It is filed for the surface named on this line; pass \`surface\` to file it for another open surface instead.`,
+    valueType: "object",
+    mode: "entity",
+    applyPolicy: "auto"
+  },
+  custom_fields_add: {
+    name: "custom_fields_add",
+    label: "Add custom fields",
+    description: `Add custom fields (new columns) to the kind of record shown on this page \u2014 SAVED immediately after the person approves, and every record of that kind gets the field (empty until filled in). Value: { "entity": "<entity token, required only when more than one section is listed>", "fields": [{ "label": "<the field's name as a person reads it>", "type": "<one of the types below; default text>" }] } \u2014 1 to ${CUSTOM_FIELDS_MAX_PER_WRITE} fields. Refused before the person is asked: a name already used, a name asked for twice, an unknown type, or a person who may not add fields (the store's reason is returned). This adds the FIELD only; it does not fill in a value.`,
+    valueType: "object",
+    mode: "entity",
+    applyPolicy: "ask"
+  },
+  custom_fields_set: {
+    name: "custom_fields_set",
+    label: "Fill in custom fields",
+    description: `Set this record's custom-field values \u2014 SAVED immediately after the person approves; a field left out is left alone. Value: { "entity": "<entity token, only when more than one section is listed>", "values": { "<field name or key>": <value> } }. A number field takes a number, a date field an ISO date (YYYY-MM-DD), text fields a string; null clears a value. Refused before the person is asked: a field that does not exist (the existing ones are named), or a person who may not fill them in. To add a NEW field use custom_fields_add.`,
+    valueType: "object",
+    mode: "entity",
+    applyPolicy: "ask"
+  }
+};
+function isPlatformWriteTarget(name) {
+  return Object.prototype.hasOwnProperty.call(PLATFORM_WRITE_TARGETS, name);
+}
 const PLATFORM_RESERVED_NAMES = {
   values: Object.keys(PLATFORM_CONTEXT_VALUES),
-  writeTargets: ["window_form_fields", "surface_feedback", "custom_fields_add", "custom_fields_set"]
+  writeTargets: Object.keys(PLATFORM_WRITE_TARGETS)
 };
 const PAGE_OFF_WITHHELD = [
   "route_brief",
@@ -140,16 +188,23 @@ function withAllBaselines(surfaceSpecific) {
 }
 export {
   AMBIENT_VALUES,
+  BASELINE_SURFACE_NAME,
   BASELINE_VALUES,
   BASELINE_VALUE_NAMES,
+  CUSTOM_FIELDS_MAX_PER_WRITE,
   OWN_CONVERSATION_WITHHELD,
   PAGELESS_CONTENT_INLINE_CEILING,
   PAGE_OFF_WITHHELD,
   PERSON_CONTEXT_VALUES,
   PLATFORM_CONTEXT_VALUES,
   PLATFORM_RESERVED_NAMES,
+  PLATFORM_WRITE_TARGETS,
   POINTER_INLINE_CEILINGS,
+  SURFACE_FEEDBACK_KINDS,
+  SURFACE_FEEDBACK_MESSAGE_MAX,
+  SURFACE_FEEDBACK_MESSAGE_MIN,
   allBaseline,
+  isPlatformWriteTarget,
   mergeBaselineValues,
   pickBaseline,
   withAllBaselines

package/dist/surfaces/runtime/SurfaceRuntimeContext.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from "react";
 import type { SurfaceScopePayload } from "../types.js";
 import type { InstanceContextEntry } from "../../agents/types/instance.types.js";
-import type { SurfaceHandle } from "@ai-matrx/kit/content-transfer";
+import type { SurfaceHandle } from "@ai-matrx/alchemy/operate";
 import type { ApplySurfaceWriteOptions } from "./surface-writeback.js";
 /**
  * What a write handler may RETURN so the caller (and, for an agent write, the

package/dist/surfaces/runtime/custom-field-targets.d.ts

@@ -8,9 +8,10 @@
  * that page could add a custom field; an agent on the same page could not —
  * nothing offered it. Declaring a target on every manifest would be 643 copies
  * of one sentence, so this is a PLATFORM target like `surface_feedback` and
- * `window_form_fields`: declared here once, belonging to no manifest, offered
- * whenever at least one custom-fields section is mounted, and routed by the
- * writeback seam (`surface-writeback.ts`) to the section's own door.
+ * `window_form_fields`: declared once on the baseline surface every surface
+ * inherits (`_baseline.manifest.ts`), offered whenever at least one
+ * custom-fields section is mounted, and written through the one write door
+ * (`surface-writeback.ts` `applyPlatformWrite`) to the section's own door.
  *
  * The section owns the write: it hands its host a door (records-ui
  * `agentDoor` prop → `CustomFieldsAgentDoor`), which checks the whole request
@@ -23,11 +24,10 @@
  */
 import type { SurfaceWriteTarget } from "../types.js";
 import type { SurfaceWriteOutcome } from "./SurfaceRuntimeContext.js";
-export declare const CUSTOM_FIELDS_TARGET_NAME = "custom_fields_add";
-export declare const CUSTOM_FIELDS_SET_TARGET_NAME = "custom_fields_set";
+export declare const CUSTOM_FIELDS_TARGET_NAME: "custom_fields_add";
+export declare const CUSTOM_FIELDS_SET_TARGET_NAME: "custom_fields_set";
 /** The surface value a section contributes when its surface declares it (baseline `custom_fields`). */
 export declare const CUSTOM_FIELDS_VALUE_NAME = "custom_fields";
-export declare const CUSTOM_FIELDS_MAX_PER_WRITE = 10;
 export declare function providerOwnsCustomFields(surfaceName: string): boolean;
 export interface CustomFieldAddRequest {
     label: string;

package/dist/surfaces/runtime/custom-field-targets.js

@@ -1,7 +1,7 @@
-const CUSTOM_FIELDS_TARGET_NAME = "custom_fields_add";
-const CUSTOM_FIELDS_SET_TARGET_NAME = "custom_fields_set";
+import { CUSTOM_FIELDS_MAX_PER_WRITE, PLATFORM_WRITE_TARGETS } from "../manifests/_baseline.manifest.js";
+const CUSTOM_FIELDS_TARGET_NAME = PLATFORM_WRITE_TARGETS.custom_fields_add.name;
+const CUSTOM_FIELDS_SET_TARGET_NAME = PLATFORM_WRITE_TARGETS.custom_fields_set.name;
 const CUSTOM_FIELDS_VALUE_NAME = "custom_fields";
-const CUSTOM_FIELDS_MAX_PER_WRITE = 10;
 const PROVIDER_OWNED_CUSTOM_FIELDS = /* @__PURE__ */ new Set(["matrx-user/notes"]);
 function providerOwnsCustomFields(surfaceName) {
   return PROVIDER_OWNED_CUSTOM_FIELDS.has(surfaceName);
@@ -31,20 +31,13 @@ function describeDoor(door) {
   const may = s.mayAdd === true ? "you may add" : s.mayAdd === null ? "still checking who may add" : `adding is refused: ${s.refusal ?? "this person may not add a field here"}`;
   return `entity "${s.entityToken}" (${what}, record ${s.recordId}) \u2014 fields: ${held}; ${may}`;
 }
-const BASE_DESCRIPTION = `Add custom fields (new columns) to the kind of record shown on this page \u2014 SAVED immediately after the person approves, and every record of that kind gets the field (empty until filled in). Value: { "entity": "<entity token, required only when more than one section is listed>", "fields": [{ "label": "<the field's name as a person reads it>", "type": "<one of the types below; default text>" }] } \u2014 1 to ${CUSTOM_FIELDS_MAX_PER_WRITE} fields. Refused before the person is asked: a name already used, a name asked for twice, an unknown type, or a person who may not add fields (the store's reason is returned). This adds the FIELD only; it does not fill in a value.`;
 function customFieldsTarget() {
   const mounted = listCustomFieldsDoors();
   const types = mounted[0]?.state().types ?? [];
   const typeLine = types.length > 0 ? ` Types: ${types.map((t) => `${t.value} (${t.label})`).join(", ")}.` : "";
   const sections = mounted.length > 0 ? ` Sections on this page: ${mounted.map(describeDoor).join(" | ")}.` : "";
-  return {
-    name: CUSTOM_FIELDS_TARGET_NAME,
-    label: "Add custom fields",
-    description: `${BASE_DESCRIPTION}${typeLine}${sections}`,
-    valueType: "object",
-    mode: "entity",
-    applyPolicy: "ask"
-  };
+  const declared = PLATFORM_WRITE_TARGETS.custom_fields_add;
+  return { ...declared, description: `${declared.description}${typeLine}${sections}` };
 }
 function customFieldsProblems(value, mounted = listCustomFieldsDoors()) {
   const none = { door: null, fields: [] };
@@ -151,14 +144,8 @@ function hasCustomFieldsSetDoors() {
 function customFieldsSetTarget() {
   const mounted = listCustomFieldsDoors().filter((d) => typeof d.setValues === "function");
   const sections = mounted.length > 0 ? ` Sections on this page: ${mounted.map(describeDoor).join(" | ")}.` : "";
-  return {
-    name: CUSTOM_FIELDS_SET_TARGET_NAME,
-    label: "Fill in custom fields",
-    description: `Set this record's custom-field values \u2014 SAVED immediately after the person approves; a field left out is left alone. Value: { "entity": "<entity token, only when more than one section is listed>", "values": { "<field name or key>": <value> } }. A number field takes a number, a date field an ISO date (YYYY-MM-DD), text fields a string; null clears a value. Refused before the person is asked: a field that does not exist (the existing ones are named), or a person who may not fill them in. To add a NEW field use ${CUSTOM_FIELDS_TARGET_NAME}.${sections}`,
-    valueType: "object",
-    mode: "entity",
-    applyPolicy: "ask"
-  };
+  const declared = PLATFORM_WRITE_TARGETS.custom_fields_set;
+  return { ...declared, description: `${declared.description}${sections}` };
 }
 function customFieldsSetProblems(value, mounted = listCustomFieldsDoors().filter((d) => typeof d.setValues === "function")) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -197,7 +184,6 @@ async function applyCustomFieldsSetWrite(value) {
   };
 }
 export {
-  CUSTOM_FIELDS_MAX_PER_WRITE,
   CUSTOM_FIELDS_SET_TARGET_NAME,
   CUSTOM_FIELDS_TARGET_NAME,
   CUSTOM_FIELDS_VALUE_NAME,

package/dist/surfaces/runtime/surface-feedback.d.ts

@@ -7,10 +7,10 @@
  * exam dates", "create_classes never said X"). The team reads it the next time
  * it updates that surface (`pnpm surface:feedback --surface <name>`).
  *
- * Like `window_form_fields` (`window-forms.ts`) it is declared here once and
- * belongs to no manifest: `listLiveWriteTargets` offers it whenever at least
- * one registered surface is mounted, and `applySurfaceWrite` routes it to
- * `applySurfaceFeedbackWrite` in the seam. It changes NOTHING on the page, so
+ * Like `window_form_fields` (`window-forms.ts`) it is declared once on the
+ * baseline surface (`_baseline.manifest.ts`): `listLiveWriteTargets` offers it
+ * whenever at least one registered surface is mounted, and it is written
+ * through the one write door (`surface-writeback.ts` `applyPlatformWrite`). It changes NOTHING on the page, so
  * it is `auto` — the person is never interrupted by a card for it.
  *
  * Storage is the central triage table `users.user_feedback`, written through
@@ -20,18 +20,16 @@
  */
 import type { ChatFeedbackInput, ChatFeedbackType } from "../../host/contract.js";
 import type { SurfaceWriteTarget } from "../types.js";
+import { SURFACE_FEEDBACK_KINDS } from "../manifests/_baseline.manifest.js";
 import type { SurfaceWriteOutcome } from "./SurfaceRuntimeContext.js";
-export declare const SURFACE_FEEDBACK_TARGET_NAME = "surface_feedback";
-export declare const SURFACE_FEEDBACK_KINDS: readonly ["missing_capability", "wrong_or_unclear_description", "bug", "missing_data", "suggestion"];
+export declare const SURFACE_FEEDBACK_TARGET_NAME: "surface_feedback";
 export type SurfaceFeedbackKind = (typeof SURFACE_FEEDBACK_KINDS)[number];
-export declare const SURFACE_FEEDBACK_MESSAGE_MIN = 10;
-export declare const SURFACE_FEEDBACK_MESSAGE_MAX = 4000;
 export interface SurfaceFeedbackValue {
     kind: SurfaceFeedbackKind;
     message: string;
     target_or_value?: string;
 }
-/** The platform target — declared once; offered whenever a surface is mounted. */
+/** The platform target — declared once on the baseline surface (`_baseline.manifest.ts`); offered whenever a surface is mounted. */
 export declare const SURFACE_FEEDBACK_TARGET: SurfaceWriteTarget;
 /**
  * Pre-write check. Throws a sentence the agent can act on; nothing is written

package/dist/surfaces/runtime/surface-feedback.js

@@ -1,24 +1,14 @@
 import { getChatHost } from "../../host/configure.js";
 import { getStoreSingleton } from "../../store/store-singleton.js";
-const SURFACE_FEEDBACK_TARGET_NAME = "surface_feedback";
-const SURFACE_FEEDBACK_KINDS = [
-  "missing_capability",
-  "wrong_or_unclear_description",
-  "bug",
-  "missing_data",
-  "suggestion"
-];
-const SURFACE_FEEDBACK_MESSAGE_MIN = 10;
-const SURFACE_FEEDBACK_MESSAGE_MAX = 4e3;
+import {
+  PLATFORM_WRITE_TARGETS,
+  SURFACE_FEEDBACK_KINDS,
+  SURFACE_FEEDBACK_MESSAGE_MAX,
+  SURFACE_FEEDBACK_MESSAGE_MIN
+} from "../manifests/_baseline.manifest.js";
+const SURFACE_FEEDBACK_TARGET_NAME = PLATFORM_WRITE_TARGETS.surface_feedback.name;
 const KIND_LIST = SURFACE_FEEDBACK_KINDS.join(" | ");
-const SURFACE_FEEDBACK_TARGET = {
-  name: SURFACE_FEEDBACK_TARGET_NAME,
-  label: "Feedback about this page",
-  description: `Save feedback about this page (surface) for the team that builds it \u2014 it changes NOTHING on the page and nobody is asked. Use it when something about the page got in your way: a write you needed does not exist, a description was wrong or unclear, data you needed was missing or arrived in an awkward form, or something broke. Also use it when the person asks you to give feedback on this page. Value: { "kind": "${KIND_LIST}", "message": "<what happened and what would have helped, ${SURFACE_FEEDBACK_MESSAGE_MIN}-${SURFACE_FEEDBACK_MESSAGE_MAX} characters>", "target_or_value": "<optional: the write target or value name it concerns>" }. It is filed for the surface named on this line; pass \`surface\` to file it for another open surface instead.`,
-  valueType: "object",
-  mode: "entity",
-  applyPolicy: "auto"
-};
+const SURFACE_FEEDBACK_TARGET = PLATFORM_WRITE_TARGETS.surface_feedback;
 const ALLOWED_KEYS = /* @__PURE__ */ new Set(["kind", "message", "target_or_value"]);
 function validateSurfaceFeedback(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -101,9 +91,6 @@ async function saveSurfaceFeedback(value, ctx) {
   };
 }
 export {
-  SURFACE_FEEDBACK_KINDS,
-  SURFACE_FEEDBACK_MESSAGE_MAX,
-  SURFACE_FEEDBACK_MESSAGE_MIN,
   SURFACE_FEEDBACK_TARGET,
   SURFACE_FEEDBACK_TARGET_NAME,
   buildSurfaceFeedbackInput,

package/dist/surfaces/runtime/surface-writeback.d.ts

@@ -233,8 +233,11 @@ export declare function registerSurfaceWritePolicies(policies: WritePolicyMap, k
 export declare const surfaceWriteApprovals: ApprovalPort;
 /**
  * The declarations the door reads: every manifest, with each target's
- * EFFECTIVE policy. No `ancestry`: a resolved manifest already carries what it
- * inherits, so a target resolves on the surface that is writing.
+ * EFFECTIVE policy, plus the BASELINE surface (`BASELINE_SURFACE_NAME`), which
+ * declares the platform's own targets (`PLATFORM_WRITE_TARGETS`). The only
+ * ancestry is the baseline: a resolved manifest already carries what it
+ * inherits from its parents, so a surface's own target resolves on the surface
+ * that is writing, and a platform target on the baseline every surface sits on.
  */
 export declare const surfaceWriteDeclarations: WriteDoorDeclarations;
 /**

package/dist/surfaces/runtime/surface-writeback.js

@@ -1,6 +1,11 @@
 "use client";
 import { contentIrKindValidator } from "../../host/content-ir-slots.js";
 import { getManifest } from "./registry.js";
+import {
+  BASELINE_SURFACE_NAME,
+  isPlatformWriteTarget,
+  PLATFORM_WRITE_TARGETS
+} from "../manifests/_baseline.manifest.js";
 import {
   isSurfaceWritePatch,
   resolveSurfaceWritePatch
@@ -350,6 +355,9 @@ const surfaceWriteKinds = {
 };
 const surfaceWriteDeclarations = {
   get(surfaceName) {
+    if (surfaceName === BASELINE_SURFACE_NAME) {
+      return { writeTargets: Object.values(PLATFORM_WRITE_TARGETS) };
+    }
     const manifest = getManifest(surfaceName);
     if (!manifest) return void 0;
     return {
@@ -359,6 +367,9 @@ const surfaceWriteDeclarations = {
       })),
       ...manifest.itemTypes ? { itemTypes: manifest.itemTypes } : {}
     };
+  },
+  ancestry(surfaceName) {
+    return surfaceName === BASELINE_SURFACE_NAME ? [] : [BASELINE_SURFACE_NAME];
   }
 };
 let surfaceDoor = null;
@@ -375,6 +386,7 @@ function loadSurfaceWriteDoor() {
       })
     ).then((door) => {
       routeMountedPages(door);
+      registerPlatformHandlers(door);
       return door;
     });
     surfaceDoor = loading;
@@ -444,6 +456,7 @@ function routeMountedPages(door) {
 const routePageWrite = (request) => {
   const seam = request.runId ? seamWrites.get(request.runId) : void 0;
   if (seam) return seam.apply();
+  if (isPlatformWriteTarget(request.target.name)) return applyPlatformHeadless(request);
   return applyMountedPageWrite(request);
 };
 async function applyMountedPageWrite(request) {
@@ -462,7 +475,12 @@ async function applyMountedPageWrite(request) {
   }
   if (handler.validate) await handler.validate(request.value);
   const outcome = toWriteOutcome(await handler.apply(request.value));
-  return { status: "applied", ...outcome?.summary ? { sentence: outcome.summary } : {} };
+  return {
+    status: "applied",
+    ...outcome?.summary ? { sentence: outcome.summary } : {},
+    // What the page's handler produced (ids of created records) rides the receipt (alchemy 0.12.3).
+    ...outcome?.data !== void 0 ? { result: outcome.data } : {}
+  };
 }
 async function writeThroughDoor(request, conversationId, apply, approve) {
   const door = await loadSurfaceWriteDoor();
@@ -743,17 +761,8 @@ async function applySurfaceWrite(targetName, rawValue, opts) {
 async function applySurfaceWriteNow(targetName, rawValue, opts) {
   const registry = opts?.source ?? getGlobalSurfaceRegistry();
   const onScreen = registry.kind === "global";
-  if (onScreen && targetName === WINDOW_FORM_TARGET_NAME) {
-    return applyWindowFormWrite(rawValue, opts);
-  }
-  if (onScreen && targetName === SURFACE_FEEDBACK_TARGET_NAME) {
-    return applySurfaceFeedbackWrite(rawValue, opts);
-  }
-  if (onScreen && targetName === CUSTOM_FIELDS_TARGET_NAME) {
-    return applyCustomFieldsTargetWrite(rawValue, opts, "add");
-  }
-  if (onScreen && targetName === CUSTOM_FIELDS_SET_TARGET_NAME) {
-    return applyCustomFieldsTargetWrite(rawValue, opts, "set");
+  if (onScreen && isPlatformWriteTarget(targetName)) {
+    return applyPlatformWrite(targetName, rawValue, opts);
   }
   const stack = registry.stack().filter(
     (entry) => !opts?.surfaceName || entry.surfaceName === opts.surfaceName
@@ -984,157 +993,184 @@ async function applySurfaceWriteNow(targetName, rawValue, opts) {
     }
   );
 }
-async function applyWindowFormWrite(rawValue, opts) {
-  const target = WINDOW_FORM_TARGET;
-  const primary = getSurfaceRuntimeStack()[0];
-  rawValue = labelWindowFormWrite(rawValue);
-  const surfaceName = primary?.surfaceName ?? "";
-  if ((opts?.origin ?? "user") === "agent") {
-    const verdict = await agentWriteAllowed(
-      target,
-      surfaceName,
-      opts?.actorLabel,
-      rawValue,
-      opts?.requestApproval,
-      primary ?? { surfaceName, getScope: () => ({}) }
-    );
-    if (verdict !== true) return verdict;
-  }
-  try {
-    await applyWindowFormChanges(rawValue);
-    if (!opts?.quiet) toast.success(`${target.label} \u2014 filled in. Review and save.`);
-    return { ok: true, surfaceName, target, change: writeReceipt(target, rawValue, NOT_READ) };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : `Applying "${target.label}" failed.`;
-    if (error instanceof SurfaceWriteRefusalError) {
-      return { ok: false, refused: true, error: message };
+async function applyPlatformTarget(name, value, context) {
+  switch (name) {
+    case "window_form_fields":
+      await applyWindowFormChanges(value);
+      return void 0;
+    case "surface_feedback": {
+      validateSurfaceFeedback(value);
+      return saveSurfaceFeedback(value, {
+        surfaceName: context.surfaceName,
+        route: typeof window === "undefined" ? "" : window.location.pathname,
+        organizationId: await feedbackOrganizationId(),
+        ...context.conversationId ? { conversationId: context.conversationId } : {},
+        ...context.agentId ? { agentId: context.agentId } : {},
+        ...context.actorLabel ? { agentName: context.actorLabel } : {}
+      });
     }
-    return fail(message, { targetName: target.name, surfaceName, error });
+    case "custom_fields_add":
+      if (!hasCustomFieldsDoors()) refuseSurfaceWrite("No custom-fields section is open on this page.");
+      validateCustomFieldsWrite(value);
+      return asRefusal(() => applyCustomFieldsWrite(value));
+    case "custom_fields_set":
+      if (!hasCustomFieldsSetDoors()) refuseSurfaceWrite("No custom-fields section is open on this page.");
+      validateCustomFieldsSetWrite(value);
+      return asRefusal(() => applyCustomFieldsSetWrite(value));
   }
 }
-async function applySurfaceFeedbackWrite(rawValue, opts) {
-  const target = SURFACE_FEEDBACK_TARGET;
-  const stack = getSurfaceRuntimeStack();
-  const mounted = stack.map((entry) => entry.surfaceName);
-  if (stack.length === 0) {
-    return failUnapplicable(
-      unapplicableMessage(target.name, "This screen mounts no registered surface to give feedback on."),
-      { targetName: target.name }
-    );
-  }
-  const runtime = opts?.surfaceName ? stack.find((entry) => entry.surfaceName === opts.surfaceName) : stack[0];
-  if (!runtime) {
-    return refuseBeforeApproval(
-      `Surface "${opts?.surfaceName}" is not open here, so feedback cannot be filed for it. Open surfaces: ${mounted.join(", ")}. Nothing was saved.`,
-      { targetName: target.name, surfaceName: opts?.surfaceName, mounted }
-    );
-  }
-  const surfaceName = runtime.surfaceName;
-  const typed = coerceDeclaredValueType(target, rawValue);
-  if (!typed.ok) {
-    return refuseBeforeApproval(typed.error, { targetName: target.name, surfaceName });
-  }
-  const value = typed.value;
+async function asRefusal(run) {
   try {
-    validateSurfaceFeedback(value);
+    return await run();
   } catch (error) {
-    return refuseBeforeApproval(
-      error instanceof Error ? error.message : `"${target.label}" refused this value.`,
-      { targetName: target.name, surfaceName }
-    );
-  }
-  if ((opts?.origin ?? "user") === "agent") {
-    const verdict = await agentWriteAllowed(
-      target,
-      surfaceName,
-      opts?.actorLabel,
-      value,
-      opts?.requestApproval,
-      runtime
-    );
-    if (verdict !== true) return verdict;
-  }
-  let organizationId = readActiveOrganizationId();
-  if (!organizationId) {
-    const resolved = await awaitEffectiveOrganizationId();
-    if (resolved.status === "ready") organizationId = resolved.organizationId;
-    else
-      return {
-        ok: false,
-        refused: true,
-        phase: "apply",
-        error: resolved.cause === "unreadable" ? "The person's organization could not be read just now, so nothing was saved. Tell them their feedback was not filed and to send it again in a moment." : "No organization is selected, and every feedback row is filed under one, so nothing was saved. Tell the person their feedback could not be filed until they pick their organization from the avatar menu, then send it again."
-      };
+    if (error instanceof SurfaceWriteRefusalError) throw error;
+    throw new SurfaceWriteRefusalError(error instanceof Error && error.message ? error.message : "The write did not complete.");
   }
+}
+async function feedbackOrganizationId() {
+  const active = readActiveOrganizationId();
+  if (active) return active;
+  const resolved = await awaitEffectiveOrganizationId();
+  if (resolved.status === "ready") return resolved.organizationId;
+  refuseSurfaceWrite(
+    resolved.cause === "unreadable" ? "The person's organization could not be read just now, so nothing was saved. Tell them their feedback was not filed and to send it again in a moment." : "No organization is selected, and every feedback row is filed under one, so nothing was saved. Tell the person their feedback could not be filed until they pick their organization from the avatar menu, then send it again."
+  );
+}
+async function applyPlatformHeadless(request) {
+  const name = request.target.name;
+  if (!isPlatformWriteTarget(name)) throw new Error(`"${name}" is not a platform write target.`);
+  if (request.ops) throw new Error(`"${request.target.label}" takes a whole value; send it instead of edits.`);
   try {
-    const outcome = await saveSurfaceFeedback(value, {
-      surfaceName,
-      route: typeof window === "undefined" ? "" : window.location.pathname,
-      organizationId,
-      ...opts?.conversationId ? { conversationId: opts.conversationId } : {},
-      ...opts?.agentId ? { agentId: opts.agentId } : {},
-      ...opts?.actorLabel ? { agentName: opts.actorLabel } : {}
+    const outcome = await applyPlatformTarget(name, request.value, {
+      surfaceName: request.surfaceName === BASELINE_SURFACE_NAME ? "" : request.surfaceName
     });
-    if (!opts?.quiet) {
-      toast.success("Feedback saved for the team.", { description: surfaceName });
-    }
-    return { ok: true, surfaceName, target, outcome, change: writeReceipt(target, value, NOT_READ) };
+    return {
+      status: "applied",
+      ...outcome?.summary ? { sentence: outcome.summary } : {},
+      ...outcome?.data !== void 0 ? { result: outcome.data } : {}
+    };
   } catch (error) {
-    const failure = fail(
-      error instanceof Error && error.message ? error.message : `Saving "${target.label}" failed.`,
-      { targetName: target.name, surfaceName, error }
-    );
-    return failure.ok ? failure : { ...failure, phase: "apply" };
+    if (error instanceof SurfaceWriteRefusalError) throw reportedError(error.message);
+    throw error;
+  }
+}
+let platformHandlersOn = null;
+function registerPlatformHandlers(door) {
+  if (platformHandlersOn === door) return;
+  platformHandlersOn = door;
+  for (const name of Object.keys(PLATFORM_WRITE_TARGETS)) {
+    door.registerHeadless(BASELINE_SURFACE_NAME, name, (request) => applyPlatformHeadless(request));
   }
 }
-async function applyCustomFieldsTargetWrite(rawValue, opts, mode) {
-  const name = mode === "add" ? CUSTOM_FIELDS_TARGET_NAME : CUSTOM_FIELDS_SET_TARGET_NAME;
-  if (mode === "add" ? !hasCustomFieldsDoors() : !hasCustomFieldsSetDoors()) {
+function platformTarget(name) {
+  if (name === CUSTOM_FIELDS_TARGET_NAME) return customFieldsTarget();
+  if (name === CUSTOM_FIELDS_SET_TARGET_NAME) return customFieldsSetTarget();
+  return PLATFORM_WRITE_TARGETS[name];
+}
+async function applyPlatformWrite(name, rawValue, opts) {
+  const stack = getSurfaceRuntimeStack();
+  let runtime = stack[0];
+  if (name === SURFACE_FEEDBACK_TARGET_NAME) {
+    const mounted = stack.map((entry) => entry.surfaceName);
+    if (stack.length === 0) {
+      return failUnapplicable(
+        unapplicableMessage(name, "This screen mounts no registered surface to give feedback on."),
+        { targetName: name }
+      );
+    }
+    runtime = opts?.surfaceName ? stack.find((entry) => entry.surfaceName === opts.surfaceName) : stack[0];
+    if (!runtime) {
+      return refuseBeforeApproval(
+        `Surface "${opts?.surfaceName}" is not open here, so feedback cannot be filed for it. Open surfaces: ${mounted.join(", ")}. Nothing was saved.`,
+        { targetName: name, surfaceName: opts?.surfaceName, mounted }
+      );
+    }
+  }
+  if (name === CUSTOM_FIELDS_TARGET_NAME ? !hasCustomFieldsDoors() : name === CUSTOM_FIELDS_SET_TARGET_NAME && !hasCustomFieldsSetDoors()) {
     return failUnapplicable(
       unapplicableMessage(name, "No custom-fields section is open on this page."),
       { targetName: name }
     );
   }
-  const target = mode === "add" ? customFieldsTarget() : customFieldsSetTarget();
-  const primary = getSurfaceRuntimeStack()[0];
-  const surfaceName = primary?.surfaceName ?? "";
+  const target = platformTarget(name);
+  const surfaceName = runtime?.surfaceName ?? "";
+  const approvalRuntime = runtime ?? { surfaceName, getScope: () => ({}) };
   const typed = coerceDeclaredValueType(target, rawValue);
   if (!typed.ok) {
-    return refuseBeforeApproval(typed.error, { targetName: target.name, surfaceName });
+    return refuseBeforeApproval(typed.error, { targetName: name, surfaceName });
   }
-  const value = typed.value;
+  const value = name === WINDOW_FORM_TARGET_NAME ? labelWindowFormWrite(typed.value) : typed.value;
   try {
-    if (mode === "add") validateCustomFieldsWrite(value);
-    else validateCustomFieldsSetWrite(value);
+    if (name === SURFACE_FEEDBACK_TARGET_NAME) validateSurfaceFeedback(value);
+    if (name === CUSTOM_FIELDS_TARGET_NAME) validateCustomFieldsWrite(value);
+    if (name === CUSTOM_FIELDS_SET_TARGET_NAME) validateCustomFieldsSetWrite(value);
   } catch (error) {
     return refuseBeforeApproval(
       error instanceof Error ? error.message : `"${target.label}" refused this value.`,
-      { targetName: target.name, surfaceName }
+      { targetName: name, surfaceName }
     );
   }
-  if ((opts?.origin ?? "user") === "agent") {
-    const verdict = await agentWriteAllowed(
-      target,
-      surfaceName,
-      opts?.actorLabel,
-      value,
-      opts?.requestApproval,
-      primary ?? { surfaceName, getScope: () => ({}) }
-    );
+  const origin = opts?.origin ?? "user";
+  const askAgent = () => agentWriteAllowed(target, surfaceName, opts?.actorLabel, value, opts?.requestApproval, approvalRuntime);
+  if (origin === "agent" && target.applyPolicy === "auto") {
+    const verdict = await askAgent();
     if (verdict !== true) return verdict;
   }
-  try {
-    const outcome = mode === "add" ? await applyCustomFieldsWrite(value) : await applyCustomFieldsSetWrite(value);
-    if (!opts?.quiet && outcome.summary) toast.success(outcome.summary);
-    return { ok: true, surfaceName, target, outcome, change: writeReceipt(target, value, NOT_READ) };
-  } catch (error) {
-    return {
-      ok: false,
-      refused: true,
-      phase: "apply",
-      error: error instanceof Error ? error.message : `"${target.label}" did not complete.`
-    };
+  let settled;
+  const approve = origin === "agent" ? async () => {
+    const verdict = await askAgent();
+    if (verdict === true) return true;
+    settled = verdict;
+    if (!verdict.ok && verdict.declined) return false;
+    throw reportedError(verdict.ok ? `"${target.label}" was not applied.` : verdict.error);
+  } : void 0;
+  const apply = async () => {
+    try {
+      const outcome = await applyPlatformTarget(name, value, {
+        surfaceName,
+        ...opts?.conversationId ? { conversationId: opts.conversationId } : {},
+        ...opts?.agentId ? { agentId: opts.agentId } : {},
+        ...opts?.actorLabel ? { actorLabel: opts.actorLabel } : {}
+      });
+      if (!opts?.quiet) {
+        if (name === WINDOW_FORM_TARGET_NAME) toast.success(`${target.label} \u2014 filled in. Review and save.`);
+        else if (name === SURFACE_FEEDBACK_TARGET_NAME) toast.success("Feedback saved for the team.", { description: surfaceName });
+        else if (outcome?.summary) toast.success(outcome.summary);
+      }
+      settled = {
+        ok: true,
+        surfaceName,
+        target,
+        ...outcome ? { outcome } : {},
+        change: writeReceipt(target, value, NOT_READ)
+      };
+      return { status: "applied", ...outcome?.summary ? { sentence: outcome.summary } : {} };
+    } catch (error) {
+      const message = error instanceof Error && error.message ? error.message : `Applying "${target.label}" failed.`;
+      if (error instanceof SurfaceWriteRefusalError) {
+        settled = name === WINDOW_FORM_TARGET_NAME ? { ok: false, refused: true, error: message } : { ok: false, refused: true, phase: "apply", error: message };
+      } else {
+        const failure = fail(message, { targetName: name, surfaceName, error });
+        settled = failure.ok ? failure : { ...failure, phase: "apply" };
+      }
+      throw reportedError(message);
+    }
+  };
+  const receipt = await writeThroughDoor(
+    { surfaceName: surfaceName || BASELINE_SURFACE_NAME, target: name, value, by: origin === "agent" ? "agent" : "person" },
+    opts?.conversationId ?? null,
+    apply,
+    approve
+  );
+  if (receipt.status === "applied" && receipt.warning && !opts?.quiet) {
+    toast.warning(receipt.warning, receipt.fix ? { description: receipt.fix } : void 0);
   }
+  const result = settled ?? fail(receipt.status === "refused" ? receipt.sentence : `"${target.label}" was not applied: ${receipt.sentence}`, {
+    targetName: name,
+    surfaceName,
+    receipt
+  });
+  return { ...result, receipt };
 }
 const SURFACE_WRITE_TOOL_NAME = "apply_surface_write";
 function listAgentWritableTargets(source) {

package/dist/surfaces/runtime/window-forms.d.ts

@@ -30,7 +30,7 @@
  * never read or written.
  */
 import type { SurfaceWriteTarget } from "../types.js";
-export declare const WINDOW_FORM_TARGET_NAME = "window_form_fields";
+export declare const WINDOW_FORM_TARGET_NAME: "window_form_fields";
 /** The marker a REGISTERED layer puts on its root element. */
 export declare const SURFACE_LAYER_ATTRIBUTE = "data-surface-layer";
 export type WindowFormKind = "dialog" | "window" | "sheet" | "drawer";
@@ -48,7 +48,7 @@ export interface WindowForm {
     kind: WindowFormKind;
     fields: WindowFormField[];
 }
-/** The platform target — declared here once, offered only while a window form is open. */
+/** The platform target — declared once on the baseline surface (`_baseline.manifest.ts`), offered only while a window form is open. */
 export declare const WINDOW_FORM_TARGET: SurfaceWriteTarget;
 /** Every open unregistered window that holds at least one field. */
 export declare function readWindowForms(): WindowForm[];

package/dist/surfaces/runtime/window-forms.js

@@ -1,14 +1,8 @@
 import { refuseSurfaceWrite } from "./surface-writeback.js";
-const WINDOW_FORM_TARGET_NAME = "window_form_fields";
+import { PLATFORM_WRITE_TARGETS } from "../manifests/_baseline.manifest.js";
+const WINDOW_FORM_TARGET_NAME = PLATFORM_WRITE_TARGETS.window_form_fields.name;
 const SURFACE_LAYER_ATTRIBUTE = "data-surface-layer";
-const WINDOW_FORM_TARGET = {
-  name: WINDOW_FORM_TARGET_NAME,
-  label: "Fields in an open window",
-  description: `Change fields in an open window that has no registered surface (listed in your context as window::<title>). Value: { "window": "<title exactly as listed>", "changes": [{ "field": "<field key>", "value": <new value> }] }. A text or number field takes a string or number, a checkbox or switch takes true/false, a list takes the text of one of its choices (a wrong choice is refused with the real ones). Every change is checked against the field's rules before anything lands; the person approves first, and the window's own Save still decides.`,
-  valueType: "object",
-  mode: "draft",
-  applyPolicy: "ask"
-};
+const WINDOW_FORM_TARGET = PLATFORM_WRITE_TARGETS.window_form_fields;
 const WINDOW_SELECTOR = '[role="dialog"], [role="alertdialog"], [data-window-panel]';
 const FIELD_SELECTOR = 'input, textarea, select, [contenteditable="true"], [role="switch"], [role="checkbox"], [role="combobox"]';
 const SKIPPED_INPUT_TYPES = /* @__PURE__ */ new Set([

package/dist/utils/connectors/marks.d.ts

@@ -29,7 +29,7 @@ export declare function YouTubeMark({ colored, className }: ConnectorLogoProps):
 export declare function GoogleDocsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
 /** Google Sheets — the green page with a grid. */
 export declare function GoogleSheetsMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;
-/** GitHub — the octocat. Brand color is black, so it always rides `currentColor`. */
-export declare function GitHubMark({ className }: ConnectorLogoProps): import("react").JSX.Element;
+/** GitHub — the ONE GitHub glyph (`@ai-matrx/icons/brand`), as a connector mark. */
+export declare const GitHubMark: ConnectorLogo;
 /** Microsoft — the four squares. */
 export declare function MicrosoftMark({ colored, className }: ConnectorLogoProps): import("react").JSX.Element;

package/dist/utils/connectors/marks.js

@@ -1,4 +1,5 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { Github } from "@ai-matrx/icons/brand";
 import { cn } from "@ai-matrx/design-system";
 function MarkSvg({
   className,
@@ -195,15 +196,7 @@ function GoogleSheetsMark({ colored = false, className }) {
     )
   ] });
 }
-function GitHubMark({ className }) {
-  return /* @__PURE__ */ jsx(MarkSvg, { className, children: /* @__PURE__ */ jsx(
-    "path",
-    {
-      fill: "currentColor",
-      d: "M12 .3a12 12 0 0 0-3.8 23.38c.6.12.83-.26.83-.57L9 21.07c-3.34.72-4.04-1.61-4.04-1.61-.55-1.39-1.34-1.76-1.34-1.76-1.08-.74.09-.73.09-.73 1.2.09 1.83 1.24 1.83 1.24 1.07 1.83 2.81 1.3 3.5 1 .1-.78.42-1.31.76-1.61-2.67-.3-5.47-1.33-5.47-5.93 0-1.31.47-2.38 1.24-3.22-.14-.3-.54-1.52.1-3.18 0 0 1-.32 3.3 1.23a11.5 11.5 0 0 1 6 0c2.28-1.55 3.29-1.23 3.29-1.23.64 1.66.24 2.88.12 3.18a4.65 4.65 0 0 1 1.23 3.22c0 4.61-2.8 5.63-5.48 5.92.42.36.81 1.1.81 2.22l-.01 3.29c0 .31.2.69.82.57A12 12 0 0 0 12 .3Z"
-    }
-  ) });
-}
+const GitHubMark = lucideMark(Github);
 function MicrosoftMark({ colored = false, className }) {
   const c = (hex) => colored ? hex : "currentColor";
   return /* @__PURE__ */ jsxs(MarkSvg, { className, children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",
@@ -201,21 +201,21 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/associations": "latest",
+    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/associations": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/diff": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest"