@ai-matrx/chat 0.1.77 → 0.2.1

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

@@ -0,0 +1,838 @@
+/**
+ * host/ui-slots — host registrations for app UI the package draws but does not own
+ * (PACKAGE-INDEPENDENCE.md: "a host registration", not an import of app code).
+ *
+ * The host registers once at startup with `registerChatUi({...})`; package code
+ * imports the named wrappers below. A component the host did not register renders
+ * nothing (or its plain stand-in, marked `data-chat-slot-fallback`) and reports itself
+ * ONCE through the host diagnostics port (never silent: Law 4); a function or hook it
+ * did not register throws, naming the slot (or runs its declared stand-in, reported once). A test registers a stand-in the same way (`registerChatUi`).
+ *
+ * Slot shapes are the host component's own props — package call sites keep passing
+ * exactly what they passed when they imported the component directly.
+ */
+import { 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 };
+import type { SkillRow } from "../ui/skills-types.js";
+import type { AgentUsagesState, UsageScope } from "../ui/usages/usages.slice.js";
+import type { AgentDriftReportAdminRow, AgentDriftReportRow, AgentUsageAggregate, AgentUsageRow, DriftAlertRow, DriftSeverity, ReportSortKey } from "../ui/usages/usages.types.js";
+import type { AgentCatalog } from "@ai-matrx/agents/catalog";
+import type { DecodedDirective } from "@ai-matrx/content-ir";
+import type { AudioSessionControls, AudioSessionSource, PlaybackSessionHandle } from "../ui/audio-session-types.js";
+import type { ItemRowProps } from "../ui/item-types.js";
+import type { ResourcePickerViewId } from "../agents/resources/picker-view-id.js";
+import type { CxContentBlock } from "../public-chat/types/cx-tables.js";
+/** The fields of a canvas item row chat reads (the host's canvas store owns the row). */
+interface CanvasItemRow {
+    id: string;
+    title: string | null;
+    content: unknown;
+    version: number;
+}
+/** One selectable row of a bound picklist (the host's list door answers these). */
+interface PicklistItem {
+    id: string;
+    label: string;
+    help_text: string | null;
+    group_name: string | null;
+    icon_name: string | null;
+}
+/**
+ * Prop shapes for the slots whose call sites pass callbacks. A slot typed `ComponentType<any>`
+ * gives its callbacks no contextual type (every `(e) =>` is an implicit any), so these declare
+ * the callbacks the package passes. The index signature keeps every other prop the host
+ * component accepts passable without the package restating the host's whole prop surface.
+ */
+interface OpenChangeProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    [extra: string]: any;
+}
+interface TextareaSlotProps {
+    onChange?: (event: ChangeEvent<HTMLTextAreaElement>) => void;
+    onTranscriptionComplete?: (text: string) => void;
+    onTranscriptionError?: (error: string) => void;
+    [extra: string]: any;
+}
+interface InputSlotProps {
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    [extra: string]: any;
+}
+interface TextInputDialogProps extends OpenChangeProps {
+    onConfirm?: (value: string) => void | Promise<void>;
+}
+interface ModelListDropdownProps {
+    onValueChange?: (modelId: string) => void;
+    onOfferingPinChange?: (offeringId: string | undefined) => void;
+    [extra: string]: any;
+}
+interface ItemMenuProps {
+    onCloseAutoFocus?: (event: Event) => void;
+    [extra: string]: any;
+}
+interface TemplatePickerProps {
+    onSelect?: (templateText: string) => void;
+    [extra: string]: any;
+}
+interface FilesPickerProps {
+    onSelect?: (selection: {
+        fileId?: string | null;
+        [extra: string]: any;
+    }) => void;
+    [extra: string]: any;
+}
+interface ResourcePickerMenuProps {
+    onReopenAt?: (pickerView: ResourcePickerViewId) => void;
+    [extra: string]: any;
+}
+interface NotePickerProps {
+    onSelectNote?: (noteId: string) => void;
+    [extra: string]: any;
+}
+interface AgentsListProps {
+    onRunAgent?: (agentId: string) => void;
+    [extra: string]: any;
+}
+interface ValueChangeProps<T> {
+    onChange?: (value: T) => void;
+    [extra: string]: any;
+}
+/** A selector the host's usages store answers; `state` is the host's root state. */
+type UsageSelector<R> = (state: any) => R;
+export interface RedFlagSummary {
+    bySeverity: Record<DriftSeverity, number>;
+    stalePins: number;
+    totalUsages: number;
+    updatableKeys: Array<{
+        usageType: string;
+        usageId: string;
+    }>;
+    hasRedFlags: boolean;
+}
+type AnyComponent = ComponentType<any>;
+/**
+ * A component slot typed by the props the PACKAGE passes. Bivariant on purpose: the host
+ * component has its own (usually richer) prop type, and a slot must accept it as long as the
+ * two agree where they overlap, without the package restating the host's whole prop surface.
+ */
+type SlotComponent<P> = ComponentType<P> | {
+    bivarianceHack(props: P): ReactNode;
+}["bivarianceHack"];
+type AnyFn = (...args: any[]) => any;
+export interface ChatUiSlots {
+    RichContent: AnyComponent;
+    CopyButtons: AnyComponent;
+    InfoHint: AnyComponent;
+    AnswerValueView: AnyComponent;
+    ErrorAlchemyMenu: AnyComponent;
+    EntityRef: AnyComponent;
+    AdvancedMenu: AnyComponent;
+    AuthGateDialog: AnyComponent;
+    EmailInputDialog: AnyComponent;
+    DockedSidePanel: AnyComponent;
+    EditableContextMenu: ComponentType<EditableContextMenuProps>;
+    NonEditableContextMenu: ComponentType<NonEditableContextMenuProps>;
+    TableChooser: AnyComponent;
+    FileResourceChip: AnyComponent;
+    ConnectorMark: AnyComponent;
+    InPlaceEditor: AnyComponent;
+    EditInPlace: AnyComponent;
+    MessageFilesStrip: AnyComponent;
+    RulebookNudge: AnyComponent;
+    NegativeVerdictFollowUp: AnyComponent;
+    SpeakerButton: AnyComponent;
+    GmailReviewCard: AnyComponent;
+    ShareButton: AnyComponent;
+    ShareModal: AnyComponent;
+    ReviewAnswersLink: AnyComponent;
+    RecordChangeApprovalCard: AnyComponent;
+    /** The exact webpage text selected for a message (the scraper's pretty view). */
+    WebpageSnapshotView: AnyComponent;
+    AttachedResourcesSection: AnyComponent;
+    ConnectorPromptHost: AnyComponent;
+    /** The inline error card (title, sentence, actions); the host's carries the Alchemy menu. */
+    ErrorNotice: AnyComponent;
+    NoteBody: AnyComponent;
+    NoteFooter: AnyComponent;
+    NoteTitleActions: AnyComponent;
+    TaskBody: AnyComponent;
+    RichDocument: AnyComponent;
+    SystemInstructionEditor: AnyComponent;
+    SystemInstructionModal: AnyComponent;
+    confirm: AnyFn;
+    copyRichContent: AnyFn;
+    copyToClipboard: AnyFn;
+    useTablesEverywhere: AnyFn;
+    useTextareaFormatting: AnyFn;
+    useClipboardPaste: AnyFn;
+    useCenterControlFit: AnyFn;
+    useInPlaceTrigger: AnyFn;
+    connectorDefinitionFromMcp: AnyFn;
+    notesCreate: AnyFn;
+    useKnowledgeAttachSearch: AnyFn;
+    useConversationAttachments: AnyFn;
+    /** One connect / re-authorize action for an MCP server: `{ connect(slug), connectingSlug }`. */
+    useConnectMcpServer: AnyFn;
+    /** The attachments doors (the host owns the transport and the sign-in): what is attached to a chat, attach, detach. */
+    fetchConversationAttachments: AnyFn;
+    attachConversationResource: AnyFn;
+    detachConversationResource: AnyFn;
+    /** A surface's declaration by name (the host's manifest registry); a host with none declares nothing. */
+    getSurfaceManifest: AnyFn;
+    /** Registers this page's capture for the "copy this page" control (the host's page-capture registry). */
+    usePageCapture: AnyFn;
+    /** A descendant's sections for the page capture. */
+    usePageCaptureContribution: AnyFn;
+    /** The NAME of the table a held write is about (`string | null`); a host that cannot name it leaves the table out. */
+    useHeldWriteTableName: AnyFn;
+    /** The platform-owned organization's id (`iam.system_orgs`); only a global-scope write needs it. */
+    resolveSystemOrgId: AnyFn;
+    /** The organization a project or task belongs to, as `{ data, error }` (the projects schema is the host's). */
+    readProjectScopeOrganizationId: AnyFn;
+    summarizeContextCell: AnyFn;
+    useEntityTitles: AnyFn;
+    /** The skills the host has loaded: `{ status, skills }` (a host with none answers nothing loaded). */
+    loadedSkills: AnyFn;
+    /** Dev-only render-path tracing for the war-room tile; a host without it traces nothing. */
+    traceWarRoomRenderPath: AnyFn;
+    isWarRoomThreadAgentSurface: AnyFn;
+    /** Opens a cloud-browser run in the host's canvas; a host without one gets a no-op opener. */
+    useOpenCloudBrowserCanvas: AnyFn;
+    cloudBrowserCanvasSourceId: AnyFn;
+    WindowPanel: AnyComponent;
+    FullScreenOverlay: AnyComponent;
+    ResourcePickerWindow: AnyComponent;
+    ResourcePickerMenu: SlotComponent<ResourcePickerMenuProps>;
+    FilesResourcePicker: SlotComponent<FilesPickerProps>;
+    NotePickerPopover: SlotComponent<NotePickerProps>;
+    SmartInputMessageTemplatePicker: SlotComponent<TemplatePickerProps>;
+    flattenResourcePickerItems: () => Array<{
+        id: string;
+        label: string;
+        icon: any;
+        [field: string]: any;
+    }>;
+    useRunControlCounts: AnyFn;
+    useAttachResourcePicker: AnyFn;
+    usePopoutContainer: AnyFn;
+    useUrlSync: AnyFn;
+    useOverlaySurfaceRenderAck: AnyFn;
+    disposeFullScreenEditorCallbackGroup: AnyFn;
+    emitFullScreenEditorSave: AnyFn;
+    FileRagBadge: AnyComponent;
+    MediaAttachmentThumbnail: AnyComponent;
+    UnifiedImageBlockRenderer: AnyComponent;
+    MicrophoneIconButton: AnyComponent;
+    TranscriptionLoader: AnyComponent;
+    MicDeviceMenu: AnyComponent;
+    PdfNamedSurfaceSwitcher: AnyComponent;
+    ChangeDiff: AnyComponent;
+    SearchGroup: AnyComponent;
+    SearchGroupTrigger: AnyComponent;
+    /** The host's upload hook: `{ upload, uploadMany, uploading, progress, result, error, reset }`. */
+    useFileUpload: AnyFn;
+    /** One file from the host's file store by source: `{ file }`. */
+    useFile: AnyFn;
+    useFileDocument: AnyFn;
+    useFileResourceFamily: AnyFn;
+    useFileActions: AnyFn;
+    /** The host's record-then-transcribe hook (`isRecording`, `startRecording`, ...). */
+    useRecordAndTranscribe: AnyFn;
+    /** Resolves a file source to its stored file (the host's file handler). */
+    resolveFile: AnyFn;
+    /** The host's rename-file thunk creator (`dispatch(renameFile({ fileId, newName })).unwrap()`). */
+    renameFile: AnyFn;
+    requestScribeAudioSeek: AnyFn;
+    resolvePdfSurfaceIds: AnyFn;
+    /** The host's list RPC reader (`{ data, error }`). */
+    readListRpc: AnyFn;
+    toastDoor: AnyFn;
+    currentPointsRate: AnyFn;
+    useCostDisplay: AnyFn;
+    ReadFailure: AnyComponent;
+    HtmlPreviewFullScreenEditor: AnyComponent;
+    AgentEditAccessBadge: AnyComponent;
+    DataRefPreviewContent: AnyComponent;
+    BlockHoverPreview: AnyComponent;
+    ConversationHoverPreview: AnyComponent;
+    NoteEditorCore: AnyComponent;
+    ToolResultCanvasOpener: AnyComponent;
+    CloudBrowserHandoffCanvasOpener: AnyComponent;
+    SimpleTerminal: AnyComponent;
+    useHtmlPreviewState: AnyFn;
+    fetchArtifactsForMessageThunk: AnyFn;
+    updateArtifactThunk: AnyFn;
+    registerArtifactThunk: AnyFn;
+    selectHtmlPageArtifactForMessage: AnyFn;
+    compileStoredComponent: AnyFn;
+    reportCanvasOpenDrop: AnyFn;
+    refreshNoteContent: AnyFn;
+    fetchNotesList: AnyFn;
+    saveNoteField: AnyFn;
+    loadProjectsWithTasks: AnyFn;
+    humanLines: AnyFn;
+    useCanvasOpenGuard: AnyFn;
+    useRegisterChatAttachTarget: AnyFn;
+    useSkills: () => {
+        skills: SkillRow[];
+        grouped: Record<string, SkillRow[]>;
+        count: number;
+        loading: boolean;
+        error: string | null;
+        reload: () => Promise<void>;
+    };
+    useAutoLabel: AnyFn;
+    generateLabelFromContent: AnyFn;
+    useStructuredListForSelection: (listId: string | null | undefined, groupName?: string) => {
+        items: PicklistItem[];
+        groups: unknown[];
+        loading: boolean;
+        unavailable: boolean;
+        error: unknown;
+        retry: () => void;
+    };
+    useGitHubConnection: AnyFn;
+    useOutputFeedback: AnyFn;
+    saveOutputFeedback: AnyFn;
+    precedingQuestion: AnyFn;
+    invalidateCanvasItemCache: AnyFn;
+    studioDocumentContentChanged: AnyFn;
+    selectEditorState: AnyFn;
+    selectActiveSandboxId: AnyFn;
+    selectActiveSandboxProxyUrl: AnyFn;
+    selectEditorMode: AnyFn;
+    receivedFsChange: AnyFn;
+    loadCodeEditHistoryThunk: AnyFn;
+    applySkillStreamEvent: AnyFn;
+    isSkillStreamEvent: AnyFn;
+    materializeMessageArtifacts: (args: {
+        messageId: string;
+        conversationId: string;
+        content: CxContentBlock[];
+        getState: () => any;
+    }) => Promise<{
+        materializedCount: number;
+        rewrittenContent: CxContentBlock[] | null;
+        unpersistedRewrite?: CxContentBlock[];
+        errors: string[];
+    }>;
+    reconcileMessagesArtifacts: AnyFn;
+    noteBrowserActivity: AnyFn;
+    selectCloudBrowserRunLive: AnyFn;
+    adoptCloudBrowserRunFromStream: AnyFn;
+    dispatchWarRoomTool: AnyFn;
+    dispatchWarRoomMasterTool: AnyFn;
+    resolveGmailSendConnection: AnyFn;
+    voiceDisplayName: AnyFn;
+    recognizeOurFileUrl: AnyFn;
+    canvasGetVersionHistory: (canvasId: string) => Promise<CanvasItemRow[]>;
+    canvasGetById: (canvasId: string) => Promise<CanvasItemRow | null>;
+    createSandboxFilesystemAdapter: AnyFn;
+    notesGetById: AnyFn;
+    isLiveConversationVoice: AnyFn;
+    ourFileUrlMarkers: AnyFn;
+    createHtmlPage: AnyFn;
+    convertMarkdownToHtml: AnyFn;
+    sklActions: Record<string, AnyFn>;
+    selectAllContentBlocksArray: AnyFn;
+    selectContentBlocksByScope: AnyFn;
+    selectContentBlocksByScopeRef: AnyFn;
+    selectActiveContentBlocks: AnyFn;
+    LibraryPreviewPage: AnyComponent;
+    NoteVersionHistoryPanel: AnyComponent;
+    ItemRow: ComponentType<ItemRowProps>;
+    UntrustedCount: AnyComponent;
+    StaleDataNotice: AnyComponent;
+    WorkspaceGate: AnyComponent;
+    OrganizationContextNotice: AnyComponent;
+    JsonInspector: AnyComponent;
+    InlineCopyButton: AnyComponent;
+    ConfirmDialog: SlotComponent<OpenChangeProps>;
+    ModelListDropdown: SlotComponent<ModelListDropdownProps>;
+    TextWithDoors: AnyComponent;
+    EntityDoorControls: AnyComponent;
+    StructuredValueView: AnyComponent;
+    KindValueFrontDoor: AnyComponent;
+    KindDataGate: AnyComponent;
+    ServerNotes: AnyComponent;
+    OptionCombobox: AnyComponent;
+    NumberStepper: SlotComponent<ValueChangeProps<number>>;
+    MatrxFloatingFrame: AnyComponent;
+    ItemMenu: SlotComponent<ItemMenuProps>;
+    ClampedNumberInput: SlotComponent<ValueChangeProps<number>>;
+    AspectRatioSelect: AnyComponent;
+    AnswerTextPreview: AnyComponent;
+    AccessGate: AnyComponent;
+    ReferenceCopyMenuItem: AnyComponent;
+    ReferenceCopyButton: AnyComponent;
+    MandateNotesPanel: AnyComponent;
+    SurfaceBoundAgentsList: SlotComponent<AgentsListProps>;
+    ProposedDirectivesZone: AnyComponent;
+    EntityCommentPopover: AnyComponent;
+    ProTextarea: SlotComponent<TextareaSlotProps>;
+    VoiceTextarea: SlotComponent<TextareaSlotProps>;
+    FloatingSheet: AnyComponent;
+    AppLink: AnyComponent;
+    IconButton: AnyComponent;
+    LightSwitchToggle: SlotComponent<ValueChangeProps<boolean>>;
+    CitationChip: AnyComponent;
+    MatrxEnvelopeBlock: AnyComponent;
+    ErrorBoundaryWithCapture: AnyComponent;
+    ConfigurationTable: AnyComponent;
+    ConfigurationTableRow: AnyComponent;
+    FieldHelp: AnyComponent;
+    useModelFull: AnyFn;
+    useModelOptions: AnyFn;
+    useOrganizationRequired: AnyFn;
+    useAuthGuardedAction: AnyFn;
+    readOf: AnyFn;
+    pushAppHref: AnyFn;
+    replaceAppHref: AnyFn;
+    announceComingSoon: AnyFn;
+    normalize: AnyFn;
+    toMediaRef: AnyFn;
+    peekSystemOrgId: AnyFn;
+    toGlobalOwnershipRecord: AnyFn;
+    fromGlobalOwnershipRecord: AnyFn;
+    peekMandateCatalogueEntry: AnyFn;
+    invalidateMandateCatalogueCache: AnyFn;
+    useLoginHref: AnyFn;
+    useAgentChangeReach: AnyFn;
+    useAccess: AnyFn;
+    selectShouldPromptForOrganization: AnyFn;
+    resolveEntityToken: AnyFn;
+    entityTitleFallback: AnyFn;
+    fetchEntityTitles: (token: string, ids: string[]) => Promise<Map<string, string>>;
+    getCachedEntityTitle: AnyFn;
+    bookmarksToReferenceDirectives: (bookmarks: unknown) => DecodedDirective[];
+    ensureOrgAvailability: AnyFn;
+    requireAuthenticatedSupabaseSession: AnyFn;
+    notifyPrintOutcome: AnyFn;
+    awaitEffectiveOrganizationId: () => Promise<{
+        status: "ready";
+        organizationId: string;
+    } | {
+        status: "unavailable";
+        reason: string;
+        cause: "no-selection" | "unreadable";
+    }>;
+    getAgentCatalog: () => AgentCatalog;
+    resolvePreferredChatModel: AnyFn;
+    publishedToWebPatch: AnyFn;
+    isUuidValue: AnyFn;
+    dismissDriftAlert: AnyFn;
+    fetchDriftAlerts: AnyFn;
+    markDriftAlertViewed: AnyFn;
+    fetchAgentUsages: AnyFn;
+    fetchAgentUsageReport: AnyFn;
+    selectActiveBannerAlerts: UsageSelector<DriftAlertRow[]>;
+    selectDriftAlertsStatus: UsageSelector<AgentUsagesState["alerts"]["status"]>;
+    makeSelectUsageCache: (scope: UsageScope, agentId: string) => UsageSelector<AgentUsagesState["usageCaches"][string] | null>;
+    makeSelectUsageGroups: (scope: UsageScope, agentId: string) => UsageSelector<Array<{
+        usageType: string;
+        items: AgentUsageRow[];
+    }>>;
+    makeSelectUsageAggregates: (scope: UsageScope, agentId: string) => UsageSelector<AgentUsageAggregate[]>;
+    makeSelectRedFlagSummary: (scope: UsageScope, agentId: string) => UsageSelector<RedFlagSummary>;
+    makeSelectReport: (scope: UsageScope) => UsageSelector<AgentUsagesState["report"][UsageScope]>;
+    makeSelectReportSorted: (scope: UsageScope, sortKey: ReportSortKey, desc: boolean) => UsageSelector<{
+        rows: AgentDriftReportRow[];
+        adminRows: AgentDriftReportAdminRow[];
+    }>;
+    makeSelectReportTotals: (scope: UsageScope) => UsageSelector<{
+        totals: Record<DriftSeverity, number>;
+        agents: number;
+        order: DriftSeverity[];
+    }>;
+    AgentSettingsModal: AnyComponent;
+    AgentSettingsCore: AnyComponent;
+    SettingControlInput: AnyComponent;
+    InputCapabilitiesEditor: AnyComponent;
+    CustomDataBindingSummary: AnyComponent;
+    CustomDataBindingPreview: AnyComponent;
+    AiModelRef: AnyComponent;
+    AiToolRef: AnyComponent;
+    TextInputDialog: SlotComponent<TextInputDialogProps>;
+    ProInput: SlotComponent<InputSlotProps>;
+    MatrxDynamicPanelHost: AnyComponent;
+    useClippedContentGuard: AnyFn;
+    answerPreviewText: AnyFn;
+    beginPlaybackSession: (input: {
+        source: AudioSessionSource;
+        label: string;
+        text?: string;
+        controls: AudioSessionControls & {
+            stop: () => void;
+        };
+    }) => PlaybackSessionHandle;
+    currentCostUnit: AnyFn;
+    Cost: AnyComponent;
+}
+/** The host's registration (idempotent; later calls override named slots). */
+export declare function registerChatUi(next: Partial<ChatUiSlots>): void;
+/** Test seam: forget every registration. */
+export declare function resetChatUiForTests(): void;
+/**
+ * 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:
+ * unregistered -> the stand-in, reported once.
+ */
+export declare function hostSlot<K extends keyof ChatUiSlots>(name: K, Fallback?: AnyComponent): ChatUiSlots[K];
+/** A host with no rich renderer shows the text as it is. */
+export declare const RichContent: AnyComponent;
+export declare const CopyButtons: AnyComponent;
+export declare const InfoHint: AnyComponent;
+export declare const AnswerValueView: AnyComponent;
+/** A host with no error menu draws one labelled line; the error sentence itself is already on screen. */
+export declare const ErrorAlchemyMenu: AnyComponent;
+/** A host with no error card draws the plain sentence, its actions and children, marked as the stand-in. */
+export declare const ErrorNotice: AnyComponent;
+export declare const EntityRef: AnyComponent;
+export declare const AdvancedMenu: AnyComponent;
+export declare const AuthGateDialog: AnyComponent;
+export declare const EmailInputDialog: AnyComponent;
+export declare const DockedSidePanel: AnyComponent;
+export declare const EditableContextMenu: ComponentType<EditableContextMenuProps>;
+export declare const NonEditableContextMenu: ComponentType<import("../context-menu/types.js").ContextMenuV3CoreProps>;
+export declare const TableChooser: AnyComponent;
+export declare const FileResourceChip: AnyComponent;
+export declare const ConnectorMark: AnyComponent;
+export declare const InPlaceEditor: AnyComponent;
+/** A host with no in-place editor shows the text and offers no edit. */
+export declare const EditInPlace: AnyComponent;
+export declare const MessageFilesStrip: AnyComponent;
+export declare const RulebookNudge: AnyComponent;
+export declare const NegativeVerdictFollowUp: AnyComponent;
+export declare const SpeakerButton: AnyComponent;
+export declare const GmailReviewCard: AnyComponent;
+export declare const ShareButton: AnyComponent;
+export declare const ShareModal: AnyComponent;
+export declare const ReviewAnswersLink: AnyComponent;
+export declare const RecordChangeApprovalCard: AnyComponent;
+export declare const AttachedResourcesSection: AnyComponent;
+/** A host with no connector prompt shows none (reported once). */
+export declare const ConnectorPromptHost: AnyComponent;
+export declare const WebpageSnapshotView: AnyComponent;
+/**
+ * A named function or hook slot declared outside this file (by `ChatUiSlots` augmentation, e.g.
+ * host/markdown-slots), with its stand-in. Same contract as the slots below.
+ */
+export declare function hostFn<K extends keyof ChatUiSlots>(name: K, fallback?: AnyFn): ChatUiSlots[K];
+export declare const confirm: AnyFn;
+export declare const copyRichContent: AnyFn;
+export declare const copyToClipboard: AnyFn;
+export declare const useTablesEverywhere: AnyFn;
+export declare const useTextareaFormatting: AnyFn;
+export declare const useClipboardPaste: AnyFn;
+export declare const useCenterControlFit: AnyFn;
+export declare const useInPlaceTrigger: AnyFn;
+export declare const connectorDefinitionFromMcp: AnyFn;
+export declare const notesCreate: AnyFn;
+export declare const useKnowledgeAttachSearch: AnyFn;
+export declare const useConversationAttachments: AnyFn;
+export declare const useHeldWriteTableName: AnyFn;
+/** A host with no manifest registry has declared no surface: the bridge's handle reports it by name when asked for scope. */
+export declare const getSurfaceManifest: AnyFn;
+/** A host with no page-capture control captures nothing; the hooks are reported no-ops. */
+export declare const usePageCapture: AnyFn;
+export declare const usePageCaptureContribution: AnyFn;
+export declare const fetchConversationAttachments: AnyFn;
+export declare const attachConversationResource: AnyFn;
+export declare const detachConversationResource: AnyFn;
+export declare const useConnectMcpServer: AnyFn;
+export declare const resolveSystemOrgId: AnyFn;
+export declare const readProjectScopeOrganizationId: AnyFn;
+export declare const summarizeContextCell: AnyFn;
+/** A host with no entity directory titles nothing; callers fall back to the raw reference. */
+export declare const useEntityTitles: AnyFn;
+export declare const loadedSkills: AnyFn;
+/** A host with no war-room tile has nothing to trace; the call is a reported no-op. */
+export declare const traceWarRoomRenderPath: AnyFn;
+export declare const isWarRoomThreadAgentSurface: AnyFn;
+/** A host with no cloud browser opens nothing; the opener is a reported no-op. */
+export declare const useOpenCloudBrowserCanvas: AnyFn;
+/** A host with no rich document viewer shows the text as it is, marked as the stand-in. */
+export declare const RichDocument: AnyComponent;
+/** The canvas identity of one chat's cloud browser (the host's own scheme; a bare host just keys by chat). */
+export declare const cloudBrowserCanvasSourceId: AnyFn;
+/** Builder doors: a host without the agent builder shows one labelled line where the editor would be. */
+export declare const SystemInstructionEditor: AnyComponent;
+export declare const SystemInstructionModal: AnyComponent;
+/** A bare host draws the package's own floating window; the app registers its window manager's. */
+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;
+export declare const ResourcePickerMenu: SlotComponent<ResourcePickerMenuProps>;
+export declare const FilesResourcePicker: SlotComponent<FilesPickerProps>;
+export declare const NotePickerPopover: SlotComponent<NotePickerProps>;
+export declare const SmartInputMessageTemplatePicker: SlotComponent<TemplatePickerProps>;
+/** A host with no resource picker offers no items. */
+export declare const flattenResourcePickerItems: () => Array<{
+    id: string;
+    label: string;
+    icon: any;
+    [field: string]: any;
+}>;
+export declare const useRunControlCounts: AnyFn;
+/** Same shape as the host door (`features/connectors/useAttachResourcePicker`): the hook returns the open function. A host with no picker opens nothing. */
+export declare const useAttachResourcePicker: AnyFn;
+/** A host with no popout windows portals into the page body (Radix default). */
+export declare const usePopoutContainer: AnyFn;
+/** A host with no window address (`panels=`) publishes nothing. */
+export declare const useUrlSync: AnyFn;
+export declare const useOverlaySurfaceRenderAck: AnyFn;
+export declare const disposeFullScreenEditorCallbackGroup: AnyFn;
+export declare const emitFullScreenEditorSave: AnyFn;
+/** A host with no RAG status shows no badge (reported once). */
+export declare const FileRagBadge: AnyComponent;
+export declare const MediaAttachmentThumbnail: AnyComponent;
+export declare const UnifiedImageBlockRenderer: AnyComponent;
+/** A host with no recorder offers no microphone (reported once). */
+export declare const MicrophoneIconButton: AnyComponent;
+export declare const TranscriptionLoader: AnyComponent;
+export declare const MicDeviceMenu: AnyComponent;
+/** A host with no PDF surfaces offers no surface switcher (reported once). */
+export declare const PdfNamedSurfaceSwitcher: AnyComponent;
+/** A host with no diff card lists each change as plain `label: before -> after` text, marked as the stand-in. */
+export declare const ChangeDiff: AnyComponent;
+/** A host with no search toolbar lays the group's buttons out in a plain row. */
+export declare const SearchGroup: AnyComponent;
+export declare const SearchGroupTrigger: AnyComponent;
+export declare const useFileUpload: AnyFn;
+export declare const useFile: AnyFn;
+export declare const useFileDocument: AnyFn;
+export declare const useFileResourceFamily: AnyFn;
+export declare const useFileActions: AnyFn;
+export declare const useRecordAndTranscribe: AnyFn;
+export declare const resolveFile: AnyFn;
+export declare const renameFile: AnyFn;
+/** A host with no transcript studio has no audio to seek; the request is a reported no-op. */
+export declare const requestScribeAudioSeek: AnyFn;
+export declare const resolvePdfSurfaceIds: AnyFn;
+export declare const readListRpc: AnyFn;
+export declare const ReadFailure: AnyComponent;
+export declare const ItemRow: ComponentType<ItemRowProps>;
+export declare const UntrustedCount: AnyComponent;
+export declare const StaleDataNotice: AnyComponent;
+export declare const WorkspaceGate: AnyComponent;
+export declare const OrganizationContextNotice: AnyComponent;
+export declare const JsonInspector: AnyComponent;
+export declare const InlineCopyButton: AnyComponent;
+export declare const ConfirmDialog: SlotComponent<OpenChangeProps>;
+export declare const ModelListDropdown: SlotComponent<ModelListDropdownProps>;
+export declare const TextWithDoors: AnyComponent;
+export declare const EntityDoorControls: AnyComponent;
+export declare const StructuredValueView: AnyComponent;
+export declare const KindValueFrontDoor: AnyComponent;
+export declare const KindDataGate: AnyComponent;
+export declare const ServerNotes: AnyComponent;
+export declare const OptionCombobox: AnyComponent;
+export declare const NumberStepper: SlotComponent<ValueChangeProps<number>>;
+export declare const MatrxFloatingFrame: AnyComponent;
+export declare const ItemMenu: SlotComponent<ItemMenuProps>;
+export declare const ClampedNumberInput: SlotComponent<ValueChangeProps<number>>;
+export declare const AspectRatioSelect: AnyComponent;
+export declare const AnswerTextPreview: AnyComponent;
+export declare const AccessGate: AnyComponent;
+export declare const ReferenceCopyMenuItem: AnyComponent;
+export declare const ReferenceCopyButton: AnyComponent;
+export declare const MandateNotesPanel: AnyComponent;
+export declare const SurfaceBoundAgentsList: SlotComponent<AgentsListProps>;
+export declare const ProposedDirectivesZone: AnyComponent;
+export declare const EntityCommentPopover: AnyComponent;
+export declare const ProTextarea: SlotComponent<TextareaSlotProps>;
+export declare const VoiceTextarea: SlotComponent<TextareaSlotProps>;
+export declare const FloatingSheet: AnyComponent;
+export declare const AppLink: AnyComponent;
+export declare const IconButton: AnyComponent;
+export declare const LightSwitchToggle: SlotComponent<ValueChangeProps<boolean>>;
+export declare const CitationChip: AnyComponent;
+export declare const MatrxEnvelopeBlock: AnyComponent;
+export declare const ErrorBoundaryWithCapture: AnyComponent;
+export declare const ConfigurationTable: AnyComponent;
+export declare const ConfigurationTableRow: AnyComponent;
+export declare const FieldHelp: AnyComponent;
+export declare const HtmlPreviewFullScreenEditor: AnyComponent;
+export declare const AgentEditAccessBadge: AnyComponent;
+export declare const DataRefPreviewContent: AnyComponent;
+export declare const BlockHoverPreview: AnyComponent;
+export declare const ConversationHoverPreview: AnyComponent;
+export declare const NoteEditorCore: AnyComponent;
+export declare const ToolResultCanvasOpener: AnyComponent;
+export declare const CloudBrowserHandoffCanvasOpener: AnyComponent;
+export declare const SimpleTerminal: AnyComponent;
+export declare const useHtmlPreviewState: AnyFn;
+export declare const fetchArtifactsForMessageThunk: AnyFn;
+export declare const updateArtifactThunk: AnyFn;
+export declare const registerArtifactThunk: AnyFn;
+export declare const selectHtmlPageArtifactForMessage: AnyFn;
+export declare const compileStoredComponent: AnyFn;
+export declare const reportCanvasOpenDrop: AnyFn;
+export declare const refreshNoteContent: AnyFn;
+export declare const fetchNotesList: AnyFn;
+export declare const saveNoteField: AnyFn;
+export declare const loadProjectsWithTasks: AnyFn;
+export declare const humanLines: AnyFn;
+export declare const useCanvasOpenGuard: AnyFn;
+export declare const useRegisterChatAttachTarget: AnyFn;
+export declare const useSkills: () => {
+    skills: SkillRow[];
+    grouped: Record<string, SkillRow[]>;
+    count: number;
+    loading: boolean;
+    error: string | null;
+    reload: () => Promise<void>;
+};
+export declare const useAutoLabel: AnyFn;
+export declare const generateLabelFromContent: AnyFn;
+export declare const useStructuredListForSelection: (listId: string | null | undefined, groupName?: string) => {
+    items: PicklistItem[];
+    groups: unknown[];
+    loading: boolean;
+    unavailable: boolean;
+    error: unknown;
+    retry: () => void;
+};
+export declare const useGitHubConnection: AnyFn;
+export declare const useOutputFeedback: AnyFn;
+export declare const saveOutputFeedback: AnyFn;
+export declare const precedingQuestion: AnyFn;
+export declare const invalidateCanvasItemCache: AnyFn;
+export declare const studioDocumentContentChanged: AnyFn;
+export declare const selectEditorState: AnyFn;
+export declare const selectActiveSandboxId: AnyFn;
+export declare const selectActiveSandboxProxyUrl: AnyFn;
+export declare const selectEditorMode: AnyFn;
+export declare const receivedFsChange: AnyFn;
+export declare const loadCodeEditHistoryThunk: AnyFn;
+export declare const applySkillStreamEvent: AnyFn;
+export declare const isSkillStreamEvent: AnyFn;
+export declare const materializeMessageArtifacts: (args: {
+    messageId: string;
+    conversationId: string;
+    content: CxContentBlock[];
+    getState: () => any;
+}) => Promise<{
+    materializedCount: number;
+    rewrittenContent: CxContentBlock[] | null;
+    unpersistedRewrite?: CxContentBlock[];
+    errors: string[];
+}>;
+export declare const reconcileMessagesArtifacts: AnyFn;
+export declare const noteBrowserActivity: AnyFn;
+export declare const selectCloudBrowserRunLive: AnyFn;
+export declare const adoptCloudBrowserRunFromStream: AnyFn;
+export declare const dispatchWarRoomTool: AnyFn;
+export declare const dispatchWarRoomMasterTool: AnyFn;
+export declare const resolveGmailSendConnection: AnyFn;
+export declare const voiceDisplayName: AnyFn;
+export declare const recognizeOurFileUrl: AnyFn;
+export declare const canvasGetVersionHistory: (canvasId: string) => Promise<CanvasItemRow[]>;
+export declare const canvasGetById: (canvasId: string) => Promise<CanvasItemRow | null>;
+export declare const createSandboxFilesystemAdapter: AnyFn;
+export declare const notesGetById: AnyFn;
+export declare const isLiveConversationVoice: AnyFn;
+export declare const ourFileUrlMarkers: AnyFn;
+export declare const createHtmlPage: AnyFn;
+export declare const convertMarkdownToHtml: AnyFn;
+/** The host's skill-library action creators (`sklActions.x(...)`); resolved at call time, a bare host throws naming the slot. */
+export declare const sklActions: Record<string, AnyFn>;
+export declare const selectAllContentBlocksArray: AnyFn;
+export declare const selectContentBlocksByScope: AnyFn;
+export declare const selectContentBlocksByScopeRef: AnyFn;
+export declare const selectActiveContentBlocks: AnyFn;
+export declare const LibraryPreviewPage: AnyComponent;
+export declare const NoteVersionHistoryPanel: AnyComponent;
+export declare const useModelFull: AnyFn;
+export declare const useModelOptions: AnyFn;
+export declare const useOrganizationRequired: AnyFn;
+export declare const useAuthGuardedAction: AnyFn;
+export declare const readOf: AnyFn;
+export declare const pushAppHref: AnyFn;
+export declare const replaceAppHref: AnyFn;
+export declare const announceComingSoon: AnyFn;
+export declare const normalize: AnyFn;
+export declare const toMediaRef: AnyFn;
+export declare const peekSystemOrgId: AnyFn;
+export declare const toGlobalOwnershipRecord: AnyFn;
+export declare const fromGlobalOwnershipRecord: AnyFn;
+export declare const peekMandateCatalogueEntry: AnyFn;
+export declare const invalidateMandateCatalogueCache: AnyFn;
+export declare const useLoginHref: AnyFn;
+export declare const useAgentChangeReach: AnyFn;
+export declare const useAccess: AnyFn;
+export declare const selectShouldPromptForOrganization: AnyFn;
+export declare const resolveEntityToken: AnyFn;
+export declare const entityTitleFallback: AnyFn;
+export declare const fetchEntityTitles: (token: string, ids: string[]) => Promise<Map<string, string>>;
+export declare const getCachedEntityTitle: AnyFn;
+export declare const bookmarksToReferenceDirectives: (bookmarks: unknown) => DecodedDirective[];
+export declare const ensureOrgAvailability: AnyFn;
+export declare const requireAuthenticatedSupabaseSession: AnyFn;
+export declare const notifyPrintOutcome: AnyFn;
+export declare const awaitEffectiveOrganizationId: () => Promise<{
+    status: "ready";
+    organizationId: string;
+} | {
+    status: "unavailable";
+    reason: string;
+    cause: "no-selection" | "unreadable";
+}>;
+export declare const getAgentCatalog: () => AgentCatalog;
+export declare const resolvePreferredChatModel: AnyFn;
+export declare const publishedToWebPatch: AnyFn;
+export declare const isUuidValue: AnyFn;
+export declare const dismissDriftAlert: AnyFn;
+export declare const fetchDriftAlerts: AnyFn;
+export declare const markDriftAlertViewed: AnyFn;
+export declare const fetchAgentUsages: AnyFn;
+export declare const fetchAgentUsageReport: AnyFn;
+export declare const selectActiveBannerAlerts: UsageSelector<DriftAlertRow[]>;
+export declare const selectDriftAlertsStatus: UsageSelector<import("../ui/usages/usages.types.js").UsagesLoadStatus>;
+export declare const makeSelectUsageCache: (scope: UsageScope, agentId: string) => UsageSelector<AgentUsagesState["usageCaches"][string] | null>;
+export declare const makeSelectUsageGroups: (scope: UsageScope, agentId: string) => UsageSelector<Array<{
+    usageType: string;
+    items: AgentUsageRow[];
+}>>;
+export declare const makeSelectUsageAggregates: (scope: UsageScope, agentId: string) => UsageSelector<AgentUsageAggregate[]>;
+export declare const makeSelectRedFlagSummary: (scope: UsageScope, agentId: string) => UsageSelector<RedFlagSummary>;
+export declare const makeSelectReport: (scope: UsageScope) => UsageSelector<AgentUsagesState["report"][UsageScope]>;
+export declare const makeSelectReportSorted: (scope: UsageScope, sortKey: ReportSortKey, desc: boolean) => UsageSelector<{
+    rows: AgentDriftReportRow[];
+    adminRows: AgentDriftReportAdminRow[];
+}>;
+export declare const makeSelectReportTotals: (scope: UsageScope) => UsageSelector<{
+    totals: Record<DriftSeverity, number>;
+    agents: number;
+    order: DriftSeverity[];
+}>;
+export declare const AgentSettingsModal: AnyComponent;
+export declare const AgentSettingsCore: AnyComponent;
+export declare const SettingControlInput: AnyComponent;
+export declare const InputCapabilitiesEditor: AnyComponent;
+export declare const CustomDataBindingSummary: AnyComponent;
+export declare const CustomDataBindingPreview: AnyComponent;
+export declare const AiModelRef: AnyComponent;
+export declare const AiToolRef: AnyComponent;
+export declare const TextInputDialog: SlotComponent<TextInputDialogProps>;
+export declare const ProInput: SlotComponent<InputSlotProps>;
+export declare const MatrxDynamicPanelHost: AnyComponent;
+export declare const useClippedContentGuard: AnyFn;
+export declare const answerPreviewText: AnyFn;
+export declare const beginPlaybackSession: (input: {
+    source: AudioSessionSource;
+    label: string;
+    text?: string;
+    controls: AudioSessionControls & {
+        stop: () => void;
+    };
+}) => PlaybackSessionHandle;
+export declare const currentCostUnit: AnyFn;
+export declare const Cost: AnyComponent;
+export declare const currentPointsRate: AnyFn;
+export declare const useCostDisplay: AnyFn;
+/** A host with no entity doors puts no action on the notice (reported once). */
+export declare const toastDoor: AnyFn;