@ai-matrx/chat 0.2.0 → 0.2.2

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.2",
   "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",
@@ -203,39 +203,43 @@
     "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/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/diff": "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/kit": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@reduxjs/toolkit": "^2.12.0",
     "@testing-library/react": "^16.3.3",
+    "@types/jest": "^30.0.0",
     "@types/lodash": "^4.17.25",
     "@types/node": "^26.6.2",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "immer": "^11.1.18",
+    "jest": "^30.5.2",
+    "jest-environment-jsdom": "^30.5.2",
     "jsdom": "^30.1.1",
     "next": "16.4.0-canary.39",
     "publint": "^0.3.24",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "react-redux": "^9.3.0",
+    "ts-jest": "^29.4.14",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vitest": "^5.0.1"
@@ -275,9 +279,11 @@
   "scripts": {
     "build": "pnpm clean && tsup && node ./scripts/copy-css.mjs && node ./scripts/tsc-own.mjs -p tsconfig.build.json && node ./scripts/finish-build.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && pnpm check:canonical-pickers && publint && pnpm verify:tarball && pnpm verify:modules-tarball && pnpm check:front-door:self-test",
+    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && pnpm check:canonical-pickers && publint && pnpm verify:tarball && pnpm verify:modules-tarball && pnpm check:front-door:self-test && pnpm check:host-boundary",
+    "check:host-boundary": "node ./scripts/check-host-boundary.mjs && node ./scripts/check-host-boundary.mjs --self-test",
     "typecheck": "node ./node_modules/typescript/bin/tsc -p tsconfig.json --noEmit && node ./scripts/tsc-own.mjs -p tsconfig.modules.json",
-    "test": "vitest run",
+    "test": "vitest run && pnpm test:modules",
+    "test:modules": "jest -c jest.config.mjs",
     "test:watch": "vitest",
     "test:falsifiable": "node ./scripts/prove-falsifiable.mjs",
     "verify:tarball": "node ./scripts/verify-tarball.mjs",