@ai-matrx/chat 0.3.15 → 0.3.20

package/dist/surfaces/manifests/_conversation-document.manifest.js

@@ -80,7 +80,7 @@ const CONVERSATION_DOCUMENT_VALUES = [
   {
     name: "document_id",
     label: "Document ID",
-    description: "UUID of the durable `cx_working_documents` row backing this document. Empty while the document is ephemeral (Redux-only) or bound to a note instead. Required for any action that writes the durable row directly.",
+    description: "UUID of the durable `content.document` row backing this document. Empty while the document is ephemeral (Redux-only) or bound to a note instead. Required for any action that writes the durable row directly.",
     valueType: "string",
     alwaysAvailable: false,
     typicalCharCount: 36,

package/dist/tool-call-visualization/registry/registry.js

@@ -1296,6 +1296,11 @@ const FALLBACK_PHASE_LABELS_BY_TOOLNAME = {
     errorPrefix: "Failed to update tasks"
   }
 };
+const APPLY_SURFACE_WRITE_LABELS = {
+  running: "Applying change",
+  complete: "Applied",
+  errorPrefix: "Could not apply change"
+};
 const FALLBACK_PHASE_LABELS_BY_DISPLAYNAME = {
   "Update Plan": {
     running: "Updating plan",
@@ -1330,6 +1335,14 @@ function getToolPhaseLabel(toolName, displayName, phase, errorMessage, entry) {
     if (reg?.phaseLabels) {
       return formatPhaseLabel(reg.phaseLabels, phase, errorMessage);
     }
+    if (toolName === "apply_surface_write" && !reg) {
+      const out = entry?.result;
+      const status = out && typeof out === "object" && !Array.isArray(out) ? out.status : null;
+      if (phase === "complete" && status === "declined_by_person") {
+        return "Change declined";
+      }
+      return formatPhaseLabel(APPLY_SURFACE_WRITE_LABELS, phase, errorMessage);
+    }
     if (FALLBACK_PHASE_LABELS_BY_TOOLNAME[toolName]) {
       return formatPhaseLabel(
         FALLBACK_PHASE_LABELS_BY_TOOLNAME[toolName],

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

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

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

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

package/dist/ui/composer/useTouchOnlyDevice.js

@@ -1,6 +1,6 @@
 "use client";
 import { useMediaQueryState } from "@ai-matrx/kit/media-query";
-import { TOUCH_ONLY_DEVICE_QUERY } from "./composerSubmit.js";
+import { TOUCH_ONLY_DEVICE_QUERY } from "@ai-matrx/kit/composer-keys";
 function useTouchOnlyDevice() {
   return useMediaQueryState(TOUCH_ONLY_DEVICE_QUERY) === true;
 }

package/dist/ui/skills-types.d.ts

@@ -1,275 +1 @@
-/**
- * features/skills/types.ts
- *
- * Wire shapes and view models for the Agent Skills feature.
- *
- * The Python backend wire shape uses snake_case (per Pydantic) — see
- * `aidream/api/routers/skills.py` and `docs/AGENT_SKILLS_HANDOFF.md`. We
- * mirror it once here in camelCase and convert at the slice boundary
- * (`skillsConverters.ts`) so consumer components never touch snake_case.
- *
- * When the backend OpenAPI regenerates and `/api/skills/{id}/projects/...`
- * is in `@ai-matrx/agents/generated/api-types`, swap the hand-mirrored
- * `SkillRowWire` for the generated `components["schemas"]["SkillRow"]`
- * and drop the `as never` casts in the thunks.
- */
-export interface SkillRowWire {
-    id: string;
-    skill_id: string;
-    label: string;
-    description: string;
-    skill_type: string;
-    body: string | null;
-    icon_name: string | null;
-    model_preference: string | null;
-    allowed_tools: string[];
-    trigger_patterns: string[];
-    disable_auto_invocation: boolean;
-    platform_targets: string[];
-    version: string | null;
-    config: Record<string, unknown>;
-    category_id: string | null;
-    parent_skill_id: string | null;
-    is_active: boolean;
-    is_system: boolean;
-    is_public: boolean;
-    sort_order: number;
-    user_id: string | null;
-    organization_id: string | null;
-    project_id: string | null;
-    /** Many-to-many associations from skl_skill_projects (read-only on the list endpoint). */
-    project_ids: string[];
-}
-export interface CategoryRowWire {
-    id: string;
-    category_key: string;
-    label: string;
-    description: string | null;
-    icon_name: string | null;
-    color: string | null;
-    parent_category_id: string | null;
-    sort_order: number;
-    is_active: boolean;
-    /** `user_id IS NULL` → system category. Populated when reading direct
-     * from Supabase; the Python wire shape currently strips this on its
-     * CategoryRow response model (it's still on the row server-side). */
-    user_id?: string | null;
-}
-export interface SkillsListWire {
-    count: number;
-    skills: SkillRowWire[];
-}
-export interface CategoryListWire {
-    count: number;
-    categories: CategoryRowWire[];
-}
-/** `skill.resource` row as it comes off Supabase. The Python backend
- * doesn't yet expose a CRUD surface for resources; reads + writes go
- * direct via the Supabase client (RLS gates on parent-skill ownership). */
-export interface ResourceRowWire {
-    id: string;
-    skill_id: string;
-    resource_type: string;
-    filename: string;
-    content: string | null;
-    storage_path: string | null;
-    mime_type: string | null;
-    sort_order: number;
-    is_active: boolean;
-}
-export interface IngestRequestWire {
-    roots: string[];
-    dry_run: boolean;
-}
-export interface IngestReportWire {
-    parsed: number;
-    created: number;
-    updated: number;
-    unchanged: number;
-    errors: string[];
-    skills: Array<{
-        skill_id: string;
-        source_path: string;
-        /** Slug (`platform.categories.slug`, dimension="skill"); "" if none. */
-        category?: string;
-        /** "created" | "updated" | "unchanged" | "error" | "pending" (dry run). */
-        status?: string;
-        /** Resulting `skill.definition.id` (UUID); absent on dry run or error. */
-        id?: string;
-    }>;
-    roots: string[];
-}
-export interface SkillCreateWire {
-    skill_id: string;
-    label: string;
-    description: string;
-    skill_type: string;
-    body: string;
-    disable_auto_invocation: boolean;
-    is_public: boolean;
-    icon_name?: string | null;
-    model_preference?: string | null;
-    allowed_tools?: string[];
-    trigger_patterns?: string[];
-    platform_targets?: string[];
-    version?: string | null;
-    config?: Record<string, unknown>;
-    category_id?: string | null;
-    parent_skill_id?: string | null;
-}
-export interface SkillPatchWire {
-    label?: string;
-    description?: string;
-    skill_type?: string;
-    body?: string;
-    icon_name?: string | null;
-    model_preference?: string | null;
-    allowed_tools?: string[];
-    trigger_patterns?: string[];
-    disable_auto_invocation?: boolean;
-    platform_targets?: string[];
-    version?: string | null;
-    config?: Record<string, unknown>;
-    category_id?: string | null;
-    parent_skill_id?: string | null;
-    is_public?: boolean;
-    is_active?: boolean;
-}
-export interface ProjectAssociationWire {
-    skill_id: string;
-    project_id: string;
-}
-/** The full skill row as it flows through the FE. Matches `SkillRowWire`
- * field-for-field with snake_case → camelCase conversion. */
-export interface SkillRow {
-    id: string;
-    skillId: string;
-    label: string;
-    description: string;
-    skillType: SkillType;
-    body: string | null;
-    iconName: string | null;
-    modelPreference: string | null;
-    allowedTools: string[];
-    triggerPatterns: string[];
-    disableAutoInvocation: boolean;
-    platformTargets: string[];
-    version: string | null;
-    config: Record<string, unknown>;
-    categoryId: string | null;
-    parentSkillId: string | null;
-    isActive: boolean;
-    isSystem: boolean;
-    isPublic: boolean;
-    sortOrder: number;
-    userId: string | null;
-    organizationId: string | null;
-    projectId: string | null;
-    /** Multi-project membership via skl_skill_projects join. */
-    projectIds: string[];
-}
-/** Resource row tied to a skill — markdown / text attachment, or a
- * storage-path pointer (the storage-bucket integration is deferred;
- * inline `content` covers the cases we use today). */
-export interface ResourceRow {
-    id: string;
-    skillId: string;
-    resourceType: string;
-    filename: string;
-    content: string | null;
-    storagePath: string | null;
-    mimeType: string | null;
-    sortOrder: number;
-    isActive: boolean;
-}
-/** Local form draft for create / edit. */
-export interface ResourceDraft {
-    id?: string;
-    skillId: string;
-    resourceType: string;
-    filename: string;
-    content: string;
-    mimeType: string | null;
-    sortOrder: number;
-}
-export interface CategoryRow {
-    id: string;
-    categoryKey: string;
-    label: string;
-    description: string | null;
-    iconName: string | null;
-    color: string | null;
-    parentCategoryId: string | null;
-    sortOrder: number;
-    isActive: boolean;
-    /** `null` → system category (visible to every user). Populated when
-     * the row was fetched via Supabase direct; may be undefined when read
-     * via the Python `/api/skills/categories` GET (which strips it
-     * today). The editor uses this to gate write-paths. */
-    userId?: string | null;
-    /** Full `platform.categories.metadata` blob. Kept so `updateCategoryThunk`
-     * can merge-patch it without wiping unrelated fields (description, is_active,
-     * legacy_table, etc. all live here). Absent on wire-path rows (Python API). */
-    metadata?: Record<string, unknown> | null;
-}
-export type IngestSkillStatus = "created" | "updated" | "unchanged" | "error"
-/** Dry run — the write hasn't happened, so the real outcome is unknown. */
- | "pending";
-export interface IngestReport {
-    parsed: number;
-    created: number;
-    updated: number;
-    unchanged: number;
-    errors: string[];
-    skills: Array<{
-        skillId: string;
-        sourcePath: string;
-        /** Category slug from frontmatter; "" if none was set. */
-        category: string;
-        status: IngestSkillStatus;
-        /** Resulting `skill.definition.id`; null on dry run or error. */
-        id: string | null;
-    }>;
-    roots: string[];
-}
-/** Per-agent skill tiering (included / listed / forbidden). Stored on `agx_agent.skill_config` JSONB. */
-export interface SkillConfig {
-    included: string[];
-    listed: string[];
-    forbidden: string[];
-    disabled: boolean;
-}
-/** SkillConfig with an "undecided" tier — used in the picker UI to surface
- * skills that the agent neither includes nor lists nor forbids (the
- * implicit DEFAULT bucket). */
-export type SkillTier = "included" | "listed" | "forbidden" | "default";
-/** Free-string per the wire contract, but these are the recognized values
- * for filtering / labelling. */
-export type SkillType = "render_block" | "convention" | "workflow" | "task" | "reference" | "mode" | "agent_behavior" | string;
-/** Local form draft used while a skill is being edited / created. Mirrors
- * SkillRow but the immutable identity fields collapse to single optional
- * id / skill_id slots. */
-export interface SkillDraft {
-    id?: string;
-    skillId: string;
-    label: string;
-    description: string;
-    skillType: SkillType;
-    body: string;
-    iconName: string | null;
-    modelPreference: string | null;
-    allowedTools: string[];
-    triggerPatterns: string[];
-    disableAutoInvocation: boolean;
-    platformTargets: string[];
-    version: string | null;
-    config: Record<string, unknown>;
-    categoryId: string | null;
-    parentSkillId: string | null;
-    isPublic: boolean;
-    /** Admin-only: when the form is in admin mode, this toggle promotes
-     * the row to `is_system=true`. Plumbing for the FE; rejected by the
-     * backend if the caller isn't an admin. */
-    isSystem: boolean;
-}
-export type AsyncStatus = "idle" | "loading" | "ready" | "error";
+export * from "@ai-matrx/agents/skills";

package/dist/ui/skills-types.js

@@ -0,0 +1 @@
+export * from "@ai-matrx/agents/skills";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.15",
+  "version": "0.3.20",
   "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",
@@ -87,103 +87,128 @@
     "./tokens.css": "./dist/tokens.css",
     "./host": {
       "types": "./dist/host/index.d.ts",
-      "import": "./dist/host/index.js"
+      "import": "./dist/host/index.js",
+      "default": "./dist/host/index.js"
     },
     "./host/react": {
       "types": "./dist/host/react.d.ts",
-      "import": "./dist/host/react.js"
+      "import": "./dist/host/react.js",
+      "default": "./dist/host/react.js"
     },
     "./action-requests/*": {
       "types": "./dist/action-requests/*.d.ts",
-      "import": "./dist/action-requests/*.js"
+      "import": "./dist/action-requests/*.js",
+      "default": "./dist/action-requests/*.js"
     },
     "./agent-copy/*": {
       "types": "./dist/agent-copy/*.d.ts",
-      "import": "./dist/agent-copy/*.js"
+      "import": "./dist/agent-copy/*.js",
+      "default": "./dist/agent-copy/*.js"
     },
     "./agents/*": {
       "types": "./dist/agents/*.d.ts",
-      "import": "./dist/agents/*.js"
+      "import": "./dist/agents/*.js",
+      "default": "./dist/agents/*.js"
     },
     "./canvas/*": {
       "types": "./dist/canvas/*.d.ts",
-      "import": "./dist/canvas/*.js"
+      "import": "./dist/canvas/*.js",
+      "default": "./dist/canvas/*.js"
     },
     "./compute/*": {
       "types": "./dist/compute/*.d.ts",
-      "import": "./dist/compute/*.js"
+      "import": "./dist/compute/*.js",
+      "default": "./dist/compute/*.js"
     },
     "./context/*": {
       "types": "./dist/context/*.d.ts",
-      "import": "./dist/context/*.js"
+      "import": "./dist/context/*.js",
+      "default": "./dist/context/*.js"
     },
     "./context-menu/*": {
       "types": "./dist/context-menu/*.d.ts",
-      "import": "./dist/context-menu/*.js"
+      "import": "./dist/context-menu/*.js",
+      "default": "./dist/context-menu/*.js"
     },
     "./conversation/*": {
       "types": "./dist/conversation/*.d.ts",
-      "import": "./dist/conversation/*.js"
+      "import": "./dist/conversation/*.js",
+      "default": "./dist/conversation/*.js"
     },
     "./cx-chat/*": {
       "types": "./dist/cx-chat/*.d.ts",
-      "import": "./dist/cx-chat/*.js"
+      "import": "./dist/cx-chat/*.js",
+      "default": "./dist/cx-chat/*.js"
     },
     "./cx-conversation/*": {
       "types": "./dist/cx-conversation/*.d.ts",
-      "import": "./dist/cx-conversation/*.js"
+      "import": "./dist/cx-conversation/*.js",
+      "default": "./dist/cx-conversation/*.js"
     },
     "./host/*": {
       "types": "./dist/host/*.d.ts",
-      "import": "./dist/host/*.js"
+      "import": "./dist/host/*.js",
+      "default": "./dist/host/*.js"
     },
     "./mandates/*": {
       "types": "./dist/mandates/*.d.ts",
-      "import": "./dist/mandates/*.js"
+      "import": "./dist/mandates/*.js",
+      "default": "./dist/mandates/*.js"
     },
     "./next/*": {
       "types": "./dist/next/*.d.ts",
-      "import": "./dist/next/*.js"
+      "import": "./dist/next/*.js",
+      "default": "./dist/next/*.js"
     },
     "./public-chat/*": {
       "types": "./dist/public-chat/*.d.ts",
-      "import": "./dist/public-chat/*.js"
+      "import": "./dist/public-chat/*.js",
+      "default": "./dist/public-chat/*.js"
     },
     "./quick-actions/*": {
       "types": "./dist/quick-actions/*.d.ts",
-      "import": "./dist/quick-actions/*.js"
+      "import": "./dist/quick-actions/*.js",
+      "default": "./dist/quick-actions/*.js"
     },
     "./store/*": {
       "types": "./dist/store/*.d.ts",
-      "import": "./dist/store/*.js"
+      "import": "./dist/store/*.js",
+      "default": "./dist/store/*.js"
     },
     "./surfaces/*": {
       "types": "./dist/surfaces/*.d.ts",
-      "import": "./dist/surfaces/*.js"
+      "import": "./dist/surfaces/*.js",
+      "default": "./dist/surfaces/*.js"
     },
     "./testing/*": {
       "types": "./dist/testing/*.d.ts",
-      "import": "./dist/testing/*.js"
+      "import": "./dist/testing/*.js",
+      "default": "./dist/testing/*.js"
     },
     "./tool-call-visualization/*": {
       "types": "./dist/tool-call-visualization/*.d.ts",
-      "import": "./dist/tool-call-visualization/*.js"
+      "import": "./dist/tool-call-visualization/*.js",
+      "default": "./dist/tool-call-visualization/*.js"
     },
     "./ui/*": {
       "types": "./dist/ui/*.d.ts",
-      "import": "./dist/ui/*.js"
+      "import": "./dist/ui/*.js",
+      "default": "./dist/ui/*.js"
     },
     "./utils/*": {
       "types": "./dist/utils/*.d.ts",
-      "import": "./dist/utils/*.js"
+      "import": "./dist/utils/*.js",
+      "default": "./dist/utils/*.js"
     },
     "./voice-agent/*": {
       "types": "./dist/voice-agent/*.d.ts",
-      "import": "./dist/voice-agent/*.js"
+      "import": "./dist/voice-agent/*.js",
+      "default": "./dist/voice-agent/*.js"
     },
     "./window-panels/*": {
       "types": "./dist/window-panels/*.d.ts",
-      "import": "./dist/window-panels/*.js"
+      "import": "./dist/window-panels/*.js",
+      "default": "./dist/window-panels/*.js"
     },
     "./package.json": "./package.json"
   },
@@ -202,23 +227,23 @@
     "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/browser-audio": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
-    "@ai-matrx/records": "latest",
-    "@ai-matrx/records-ui": "latest",
+    "@ai-matrx/realtime": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/realtime": "latest"
+    "@ai-matrx/records": "latest",
+    "@ai-matrx/records-ui": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -279,8 +304,9 @@
   "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 && pnpm check:host-boundary",
+    "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 && pnpm check:no-builder-tier",
     "check:host-boundary": "node ./scripts/check-host-boundary.mjs && node ./scripts/check-host-boundary.mjs --self-test",
+    "check:no-builder-tier": "node ./scripts/check-chat-has-no-builder-tier.mjs && node ./scripts/check-chat-has-no-builder-tier.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 && pnpm test:modules",
     "test:modules": "jest -c jest.config.mjs",

package/dist/agents/components/run/run-sidebar/AgentRunsSidebar.d.ts

@@ -1,15 +0,0 @@
-interface AgentRunsSidebarProps {
-    agentId: string;
-    conversationId: string;
-    surfaceKey: string;
-    conversationIdFromUrl?: string;
-    currentRunId?: string;
-    onToggleSidebar: () => void;
-    /** Base path for the embedded header's back-link + agent switcher.
-     *  Defaults to `/agents`. Admin surfaces should pass
-     *  `/administration/agents/system-agents/agents`. */
-    basePath?: string;
-    backHref?: string;
-}
-export declare function AgentRunsSidebar({ agentId, conversationId, surfaceKey, conversationIdFromUrl, onToggleSidebar, basePath, backHref, }: AgentRunsSidebarProps): import("react").JSX.Element;
-export {};