@ai-matrx/chat 0.4.22 → 0.4.24

package/dist/host/defaults/setting-control-input.js

@@ -0,0 +1,91 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Input, Switch, Textarea } from "@ai-matrx/design-system";
+const FIELD = "h-8 w-full text-sm";
+function JsonField({ id, value, disabled, onChange }) {
+  const text = value === void 0 || value === null ? "" : JSON.stringify(value, null, 2);
+  const [draft, setDraft] = useState(text);
+  const [invalid, setInvalid] = useState(false);
+  useEffect(() => setDraft(text), [text]);
+  return /* @__PURE__ */ jsx(
+    Textarea,
+    {
+      id,
+      value: draft,
+      disabled,
+      rows: 3,
+      "aria-invalid": invalid || void 0,
+      className: "w-full font-mono text-xs",
+      onChange: (event) => setDraft(event.target.value),
+      onBlur: () => {
+        if (draft.trim() === "") return onChange(void 0);
+        try {
+          onChange(JSON.parse(draft));
+          setInvalid(false);
+        } catch {
+          setInvalid(true);
+        }
+      }
+    }
+  );
+}
+function DefaultSettingControlInput({ settingKey, control, value, onChange, disabled, id }) {
+  const fieldId = id ?? `setting-${settingKey}`;
+  switch (control.type) {
+    case "boolean":
+      return /* @__PURE__ */ jsx(Switch, { id: fieldId, checked: value === true, disabled, onCheckedChange: (checked) => onChange(checked) });
+    case "enum":
+      return /* @__PURE__ */ jsxs(
+        "select",
+        {
+          id: fieldId,
+          className: `${FIELD} rounded-md border border-input bg-background px-2`,
+          value: typeof value === "string" ? value : "",
+          disabled,
+          onChange: (event) => onChange(event.target.value === "" ? void 0 : event.target.value),
+          children: [
+            /* @__PURE__ */ jsx("option", { value: "", children: "Default" }),
+            (control.enum ?? []).map((option) => /* @__PURE__ */ jsx("option", { value: option, children: option }, option))
+          ]
+        }
+      );
+    case "number":
+    case "integer":
+      return /* @__PURE__ */ jsx(
+        Input,
+        {
+          id: fieldId,
+          type: "number",
+          className: FIELD,
+          value: typeof value === "number" ? String(value) : "",
+          min: control.min,
+          max: control.max,
+          step: control.type === "integer" ? 1 : "any",
+          disabled,
+          onChange: (event) => {
+            const raw = event.target.value;
+            if (raw === "") return onChange(void 0);
+            const parsed = control.type === "integer" ? Number.parseInt(raw, 10) : Number(raw);
+            if (Number.isFinite(parsed)) onChange(parsed);
+          }
+        }
+      );
+    case "string":
+      return /* @__PURE__ */ jsx(
+        Input,
+        {
+          id: fieldId,
+          className: FIELD,
+          value: typeof value === "string" ? value : value === void 0 || value === null ? "" : String(value),
+          disabled,
+          onChange: (event) => onChange(event.target.value === "" ? void 0 : event.target.value)
+        }
+      );
+    default:
+      return /* @__PURE__ */ jsx(JsonField, { id: fieldId, value, disabled, onChange });
+  }
+}
+export {
+  DefaultSettingControlInput
+};

package/dist/host/index.d.ts

@@ -24,4 +24,5 @@ export { createClient, getClaimsUser, schedulerDb, supabase, type ChatClaimsUser
 export type { ChatDatabase } from "./db-types.js";
 export { ChatNoDatabaseError, NO_DATABASE_CODE_PREFIX, createNoDatabaseStandIn, isChatNoDatabaseError, isNoDatabase, } from "./no-database.js";
 export * from "./source.js";
+export * from "./conversation-hooks.js";
 export * from "../agents/routing/confidential-routing.js";

package/dist/host/index.js

@@ -55,6 +55,7 @@ import {
   isNoDatabase
 } from "./no-database.js";
 export * from "./source.js";
+export * from "./conversation-hooks.js";
 export * from "../agents/routing/confidential-routing.js";
 export {
   CHAT_ACTIVE_ORG_STORAGE_KEY,

package/dist/host/react.d.ts

@@ -31,3 +31,4 @@ export declare function useMaybeChatHost(): ResolvedChatHost | null;
 /** The host from the nearest <ChatProvider>. Throws the named, remedied error outside one. */
 export declare function useChatHost(): ResolvedChatHost;
 export { Link, usePathname, useRouter, useSearchParams } from "./navigation.js";
+export { useConversationHeld } from "./conversation-hooks-react.js";

package/dist/host/react.js

@@ -65,10 +65,12 @@ function useChatHost() {
   return host;
 }
 import { Link, usePathname, useRouter, useSearchParams } from "./navigation.js";
+import { useConversationHeld } from "./conversation-hooks-react.js";
 export {
   ChatProvider,
   Link,
   useChatHost,
+  useConversationHeld,
   useMaybeChatHost,
   usePathname,
   useRouter,

package/dist/host/ui-slots.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentType, type ChangeEvent, type ReactNode } from "react";
+import { Component, type ComponentType, type ChangeEvent, type ReactNode } from "react";
 import type { EditableContextMenuProps, NonEditableContextMenuProps } from "../context-menu/types.js";
 /** The host context menu's props (its registration is typed against them). */
 export type { EditableContextMenuProps, NonEditableContextMenuProps };
@@ -419,6 +419,28 @@ export interface ChatUiSlots {
 export declare function registerChatUi(next: Partial<ChatUiSlots>): void;
 /** Test seam: forget every registration. */
 export declare function resetChatUiForTests(): void;
+/** True when the host registered `name` (a door that only a host implementation can open shows only then). */
+export declare function isHostSlotRegistered(name: keyof ChatUiSlots): boolean;
+/**
+ * EVERY SLOT DEGRADES, NEVER CRASHES (P29a finding 1). A host panel that throws while rendering
+ * (a hook slot it needs is missing, its own bug) draws nothing in its place; the failure is
+ * reported once through the diagnostics port. The page around it keeps working.
+ */
+export declare class SlotBoundary extends Component<{
+    name: string;
+    children?: ReactNode;
+}, {
+    failed: boolean;
+}> {
+    state: {
+        failed: boolean;
+    };
+    static getDerivedStateFromError(): {
+        failed: boolean;
+    };
+    componentDidCatch(error: unknown): void;
+    render(): ReactNode;
+}
 /**
  * A named slot with the caller's own stand-in (for a package default richer than one line,
  * e.g. a context-item body falling back to `GenericBody`). Same contract as the wrappers above:
@@ -498,6 +520,7 @@ export declare const WindowPanel: AnyComponent;
 /** A bare host draws a plain full-screen tabbed sheet. */
 export declare const FullScreenOverlay: AnyComponent;
 export declare const ResourcePickerWindow: AnyComponent;
+/** A bare host gets the package's own Files + Link picker (`defaults/resource-picker-menu`); the app registers its full one. */
 export declare const ResourcePickerMenu: SlotComponent<ResourcePickerMenuProps>;
 export declare const FilesResourcePicker: SlotComponent<FilesPickerProps>;
 export declare const NotePickerPopover: SlotComponent<NotePickerProps>;
@@ -736,6 +759,7 @@ export declare const CreatorRunPanel: SlotComponent<{
     tabs?: string[];
 }>;
 export declare const AgentSettingsCore: AnyComponent;
+/** A bare host gets the package's own per-type setting control (`defaults/setting-control-input`). */
 export declare const SettingControlInput: AnyComponent;
 export declare const InputCapabilitiesEditor: AnyComponent;
 export declare const CustomDataBindingSummary: AnyComponent;

package/dist/host/ui-slots.js

@@ -1,12 +1,22 @@
 "use client";
 import { defaultResourcePickerItems } from "../agents/resources/default-picker-items.js";
 import { isRfc9562Uuid } from "@ai-matrx/kit/uuid";
-import { createElement, Fragment, useRef } from "react";
+import { Component, createElement, Fragment, useRef } from "react";
 import { formatCost, usdToPoints } from "@ai-matrx/kit/format";
+import { announceOnce } from "./errors.js";
 import { reportUnregisteredHostSlot as reportUnregistered } from "./diagnostics.js";
 import { DefaultWebpageSnapshotView } from "./defaults/webpage-snapshot-view.js";
 import { DefaultWorkspaceGate } from "./defaults/workspace-gate.js";
 import { DefaultFullScreenOverlay, DefaultWindowPanel } from "./defaults/window-panel.js";
+import { DefaultSettingControlInput } from "./defaults/setting-control-input.js";
+import { DefaultResourcePickerMenu } from "./defaults/resource-picker-menu.js";
+import { captureReactRenderError } from "./diagnostics.js";
+import { ConfirmDialog as PackageConfirmDialog } from "@ai-matrx/design-system";
+import {
+  ClampedNumberInput as PackageClampedNumberInput,
+  LightSwitchToggle as PackageLightSwitchToggle,
+  NumberStepper as PackageNumberStepper
+} from "@ai-matrx/design-system/controls";
 const slots = {};
 function registerChatUi(next) {
   Object.assign(slots, next);
@@ -14,26 +24,45 @@ function registerChatUi(next) {
 function resetChatUiForTests() {
   for (const key of Object.keys(slots)) delete slots[key];
 }
+function isHostSlotRegistered(name) {
+  return slots[name] !== void 0;
+}
+class SlotBoundary extends Component {
+  state = { failed: false };
+  static getDerivedStateFromError() {
+    return { failed: true };
+  }
+  componentDidCatch(error) {
+    if (announceOnce(`chat-host-slot-failed:${this.props.name}`, `The chat slot "${this.props.name}" failed to render, so it is left out.`)) {
+      captureReactRenderError(error, { boundary: `ChatUi(${this.props.name})` });
+    }
+  }
+  render() {
+    return this.state.failed ? null : this.props.children ?? null;
+  }
+}
 function slotComponent(name, Fallback) {
   const Wrapper = (props) => {
     const Impl = slots[name];
     if (!Impl) {
       const absent = !Fallback || Fallback.optionalAbsent;
       reportUnregistered(name, absent ? "it renders nothing here" : "a plain stand-in is drawn");
-      return Fallback ? createElement(Fallback, props) : null;
+      return Fallback ? createElement(SlotBoundary, { name }, createElement(Fallback, props)) : null;
     }
-    return createElement(Impl, props);
+    return createElement(SlotBoundary, { name }, createElement(Impl, props));
   };
   Wrapper.displayName = `ChatUi(${name})`;
   return Wrapper;
 }
+function withPackageDefault(Component2) {
+  const PackageDefault = (props) => createElement(Component2, props);
+  PackageDefault.displayName = `PackageDefault(${Component2.displayName ?? Component2.name ?? "component"})`;
+  return PackageDefault;
+}
 function unregisteredWidget(name) {
-  const UnregisteredWidget = () => createElement(
-    "span",
-    { className: "text-[11px] text-muted-foreground", "data-chat-slot-fallback": name },
-    `${name} is not set up here`
-  );
+  const UnregisteredWidget = ({ children }) => createElement(Fragment, null, children ?? null);
   UnregisteredWidget.displayName = `UnregisteredWidget(${name})`;
+  UnregisteredWidget.optionalAbsent = true;
   return UnregisteredWidget;
 }
 function optionalWidget(name) {
@@ -241,7 +270,7 @@ const SystemInstructionModal = slotComponent("SystemInstructionModal", optionalW
 const WindowPanel = slotComponent("WindowPanel", DefaultWindowPanel);
 const FullScreenOverlay = slotComponent("FullScreenOverlay", DefaultFullScreenOverlay);
 const ResourcePickerWindow = slotComponent("ResourcePickerWindow", optionalWidget("ResourcePickerWindow"));
-const ResourcePickerMenu = slotComponent("ResourcePickerMenu", optionalWidget("ResourcePickerMenu"));
+const ResourcePickerMenu = slotComponent("ResourcePickerMenu", (props) => createElement(DefaultResourcePickerMenu, props));
 const FilesResourcePicker = slotComponent("FilesResourcePicker", optionalWidget("FilesResourcePicker"));
 const NotePickerPopover = slotComponent("NotePickerPopover", optionalWidget("NotePickerPopover"));
 const SmartInputMessageTemplatePicker = slotComponent(
@@ -310,7 +339,7 @@ const StaleDataNotice = slotComponent("StaleDataNotice", PlainStaleDataNotice);
 const WorkspaceGate = slotComponent("WorkspaceGate", DefaultWorkspaceGate);
 const OrganizationContextNotice = slotComponent("OrganizationContextNotice", unregisteredWidget("OrganizationContextNotice"));
 const JsonInspector = slotComponent("JsonInspector", unregisteredWidget("JsonInspector"));
-const ConfirmDialog = slotComponent("ConfirmDialog", unregisteredWidget("ConfirmDialog"));
+const ConfirmDialog = slotComponent("ConfirmDialog", withPackageDefault(PackageConfirmDialog));
 import { ModelListDropdown } from "@ai-matrx/agents/models/react";
 const TextWithDoors = slotComponent("TextWithDoors", unregisteredWidget("TextWithDoors"));
 const EntityDoorControls = slotComponent("EntityDoorControls", unregisteredWidget("EntityDoorControls"));
@@ -319,10 +348,10 @@ const KindValueFrontDoor = slotComponent("KindValueFrontDoor", unregisteredWidge
 const KindDataGate = slotComponent("KindDataGate", unregisteredWidget("KindDataGate"));
 const ServerNotes = slotComponent("ServerNotes", unregisteredWidget("ServerNotes"));
 const OptionCombobox = slotComponent("OptionCombobox", unregisteredWidget("OptionCombobox"));
-const NumberStepper = slotComponent("NumberStepper", unregisteredWidget("NumberStepper"));
+const NumberStepper = slotComponent("NumberStepper", withPackageDefault(PackageNumberStepper));
 const MatrxFloatingFrame = slotComponent("MatrxFloatingFrame", unregisteredWidget("MatrxFloatingFrame"));
 const ItemMenu = slotComponent("ItemMenu", unregisteredWidget("ItemMenu"));
-const ClampedNumberInput = slotComponent("ClampedNumberInput", unregisteredWidget("ClampedNumberInput"));
+const ClampedNumberInput = slotComponent("ClampedNumberInput", withPackageDefault(PackageClampedNumberInput));
 const AspectRatioSelect = slotComponent("AspectRatioSelect", unregisteredWidget("AspectRatioSelect"));
 const AnswerTextPreview = slotComponent("AnswerTextPreview", unregisteredWidget("AnswerTextPreview"));
 const AccessGate = slotComponent("AccessGate", unregisteredWidget("AccessGate"));
@@ -343,7 +372,7 @@ const VoiceTextarea = slotComponent("VoiceTextarea", (props) => {
 const FloatingSheet = slotComponent("FloatingSheet", unregisteredWidget("FloatingSheet"));
 const AppLink = slotComponent("AppLink", ({ href, children, className, ...rest }) => createElement("a", { href, className, ...rest }, children));
 const IconButton = slotComponent("IconButton", unregisteredWidget("IconButton"));
-const LightSwitchToggle = slotComponent("LightSwitchToggle", unregisteredWidget("LightSwitchToggle"));
+const LightSwitchToggle = slotComponent("LightSwitchToggle", withPackageDefault(PackageLightSwitchToggle));
 const CitationChip = slotComponent("CitationChip", unregisteredWidget("CitationChip"));
 const MatrxEnvelopeBlock = slotComponent("MatrxEnvelopeBlock", unregisteredWidget("MatrxEnvelopeBlock"));
 const ErrorBoundaryWithCapture = slotComponent("ErrorBoundaryWithCapture", ({ children }) => children ?? null);
@@ -377,7 +406,20 @@ const useSkills = slotFn("useSkills");
 const useAutoLabel = slotFn("useAutoLabel", () => void 0);
 const generateLabelFromContent = slotFn("generateLabelFromContent");
 const usePickListForSelection = slotFn("usePickListForSelection");
-const useGitHubConnection = slotFn("useGitHubConnection");
+const NO_GITHUB = { connection: null, repositories: NONE, account: null, installations: NONE, syncedRepositoryCount: 0, lastSyncedAt: null };
+const noGitHubAction = async () => void 0;
+const useGitHubConnection = slotFn("useGitHubConnection", () => ({
+  inventory: NO_GITHUB,
+  loading: false,
+  busy: false,
+  error: null,
+  readError: null,
+  reload: noGitHubAction,
+  connect: noGitHubAction,
+  install: noGitHubAction,
+  sync: noGitHubAction,
+  disconnect: noGitHubAction
+}));
 const useOutputFeedback = slotFn("useOutputFeedback");
 const saveOutputFeedback = slotFn("saveOutputFeedback");
 const precedingQuestion = slotFn("precedingQuestion");
@@ -451,7 +493,7 @@ const AgentSaveTapButton = slotComponent("AgentSaveTapButton");
 const AgentPeekDuplicateButton = slotComponent("AgentPeekDuplicateButton");
 const CreatorRunPanel = slotComponent("CreatorRunPanel");
 const AgentSettingsCore = slotComponent("AgentSettingsCore", unregisteredWidget("AgentSettingsCore"));
-const SettingControlInput = slotComponent("SettingControlInput", unregisteredWidget("SettingControlInput"));
+const SettingControlInput = slotComponent("SettingControlInput", (props) => createElement(DefaultSettingControlInput, props));
 const InputCapabilitiesEditor = slotComponent("InputCapabilitiesEditor", unregisteredWidget("InputCapabilitiesEditor"));
 const CustomDataBindingSummary = slotComponent("CustomDataBindingSummary", unregisteredWidget("CustomDataBindingSummary"));
 const CustomDataBindingPreview = slotComponent("CustomDataBindingPreview", unregisteredWidget("CustomDataBindingPreview"));
@@ -571,6 +613,7 @@ export {
   ShareButton,
   ShareModal,
   SimpleTerminal,
+  SlotBoundary,
   SmartInputMessageTemplatePicker,
   SpeakerButton,
   StaleDataNotice,
@@ -629,6 +672,7 @@ export {
   humanLines,
   invalidateCanvasItemCache,
   invalidateMandateCatalogueCache,
+  isHostSlotRegistered,
   isSkillStreamEvent,
   isUuidValue,
   isWarRoomThreadAgentSurface,

package/dist/host/window-openers.d.ts

@@ -326,6 +326,8 @@ export interface ChatWindowOpeners {
 export type ChatWindowOpenerName = keyof ChatWindowOpeners;
 /** What a host that registers no openers gets — every one announces itself. */
 export declare const UNHOSTED_WINDOW_OPENERS: ChatWindowOpeners;
+/** True when the host can actually open this window (a bare host has no window host: draw the surface inline instead). */
+export declare function useHasChatWindowOpener(name: ChatWindowOpenerName): boolean;
 export declare function useOpenAgentAdminFindUsagesWindow(): (opts?: OpenAgentAdminFindUsagesWindowOptions) => ChatWindowHandle;
 export declare function useOpenAgentShortcutQuickCreateWindow(): (opts?: OpenAgentShortcutQuickCreateWindowOptions) => ChatWindowHandle;
 export declare function useOpenAgentContentWindow(): (opts?: OpenAgentContentWindowOptions) => ChatWindowHandle;

package/dist/host/window-openers.js

@@ -61,6 +61,9 @@ const UNHOSTED_WINDOW_OPENERS = {
   openWorkingDocumentPanel: unhosted("openWorkingDocumentPanel"),
   openWorkingDocumentWindow: unhosted("openWorkingDocumentWindow")
 };
+function useHasChatWindowOpener(name) {
+  return Boolean(useChatWindows().openers?.[name]);
+}
 function useOpener(name) {
   return useChatWindows().openers?.[name] ?? UNHOSTED_WINDOW_OPENERS[name];
 }
@@ -236,6 +239,7 @@ function useOpenWorkingDocumentWindow() {
 export {
   UNHOSTED_WINDOW_OPENERS,
   useFloatingLiveRun,
+  useHasChatWindowOpener,
   useOpenAgentAdminFindUsagesWindow,
   useOpenAgentContentWindow,
   useOpenAgentConvertSystemWindow,

package/dist/react.cjs

@@ -3975,7 +3975,7 @@ function joinHeaderClass(...parts) {
   return parts.filter((part) => part !== void 0 && part !== "").join(" ");
 }
 
-// src/compat/react/shells/drag.ts
+// src/ui/chat-panel/drag.ts
 var import_react18 = require("react");
 var KEYBOARD_STEP_PX = 24;
 function useResizableWidth(options) {