@ai-matrx/chat 0.2.0 → 0.2.2

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;
 /**