@jini-ai/chat 0.6.6 → 0.6.10

package/dist/react/components/AttachmentPreviewModal.js

@@ -15,6 +15,30 @@ import { looksLikeImageAttachment, useAttachmentPreviewModal } from './Attachmen
 export function AttachmentPreviewModal({ attachment, onClose, navigation }) {
     const t = useT();
     const c = useAttachmentPreviewModal({ attachment: attachment, onClose: onClose, navigation });
-    return (_jsxs("dialog", { ref: c.dialogRef, className: `jini-attachment-preview-dialog${navigation ? ' has-nav' : ''}`, role: "dialog", "aria-modal": "true", "aria-label": t('{name} preview', { name: attachment.name }), onCancel: c.handleNativeCancel, onClick: c.handleBackdropClick, onKeyDown: c.handleKeyDown, children: [_jsxs("div", { className: "jini-attachment-preview-header", children: [_jsx("span", { className: "jini-attachment-preview-name", title: attachment.name, children: attachment.name }), _jsx("button", { type: "button", className: "jini-attachment-preview-close", onClick: onClose, title: t('Close'), "aria-label": t('Close'), children: _jsx(Icon, { name: "close", size: 16 }) })] }), _jsx("div", { className: "jini-attachment-preview-body", children: c.status === 'image' && c.imageUrl ? (_jsx("img", { src: c.imageUrl, alt: attachment.name, className: "jini-attachment-preview-image", onError: c.onImageError })) : c.status === 'text' ? (c.textLoading ? (_jsx("div", { className: "jini-attachment-preview-loading", children: t('Loading…') })) : (_jsxs(_Fragment, { children: [_jsx("pre", { className: "jini-attachment-preview-text", children: c.text?.content ?? '' }), c.text?.truncated ? (_jsx("div", { className: "jini-attachment-preview-truncated", children: t('Preview truncated — this file is larger than the preview limit.') })) : null] }))) : (_jsxs("div", { className: "jini-attachment-preview-meta", children: [_jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Name') }), _jsx("span", { children: attachment.name })] }), _jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Type') }), _jsx("span", { children: looksLikeImageAttachment({ attachment: attachment }) ? t('Image') : t('File') })] }), c.sizeLabel ? (_jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Size') }), _jsx("span", { children: c.sizeLabel })] })) : null, _jsx("div", { className: "jini-attachment-preview-meta-note", children: t('A preview is not available for this file.') })] })) }), navigation ? (_jsxs("div", { className: "jini-attachment-preview-nav", children: [_jsx("span", { className: "jini-attachment-preview-count", "aria-live": "polite", children: t('{index} / {count}', { index: navigation.index + 1, count: navigation.count }) }), _jsx("button", { type: "button", className: "jini-attachment-preview-step", onClick: navigation.onPrevious, title: t('Previous image'), "aria-label": t('Previous image'), children: _jsx(Icon, { name: "chevron-left", size: 18 }) }), _jsx("button", { type: "button", className: "jini-attachment-preview-step", onClick: navigation.onNext, title: t('Next image'), "aria-label": t('Next image'), children: _jsx(Icon, { name: "chevron-right", size: 18 }) })] })) : null] }));
+    return (_jsxs("dialog", { ref: c.dialogRef, className: `jini-attachment-preview-dialog${navigation ? ' has-nav' : ''}`, role: "dialog", "aria-modal": "true", "aria-label": t('{name} preview', { name: attachment.name }), onCancel: c.handleNativeCancel, onClick: c.handleBackdropClick, onKeyDown: c.handleKeyDown, children: [_jsxs("div", { className: "jini-attachment-preview-header", children: [_jsx("span", { className: "jini-attachment-preview-name", title: attachment.name, children: attachment.name }), _jsx("button", { type: "button", className: "jini-attachment-preview-close", onClick: onClose, title: t('Close'), "aria-label": t('Close'), children: _jsx(Icon, { name: "close", size: 16 }) })] }), _jsx("div", { className: "jini-attachment-preview-body", children: _jsx(AttachmentPreviewBody, { attachment: attachment, preview: c }) }), navigation ? _jsx(AttachmentPreviewNav, { navigation: navigation }) : null] }));
+}
+/** The image, the text pane, or - for anything else - the filename/type/size card. */
+function AttachmentPreviewBody({ attachment, preview }) {
+    if (preview.status === 'image' && preview.imageUrl) {
+        return (_jsx("img", { src: preview.imageUrl, alt: attachment.name, className: "jini-attachment-preview-image", onError: preview.onImageError }));
+    }
+    if (preview.status === 'text')
+        return _jsx(AttachmentTextPane, { preview: preview });
+    return _jsx(AttachmentMetaCard, { attachment: attachment, sizeLabel: preview.sizeLabel });
+}
+function AttachmentTextPane({ preview }) {
+    const t = useT();
+    if (preview.textLoading)
+        return _jsx("div", { className: "jini-attachment-preview-loading", children: t('Loading…') });
+    return (_jsxs(_Fragment, { children: [_jsx("pre", { className: "jini-attachment-preview-text", children: preview.text?.content ?? '' }), preview.text?.truncated ? (_jsx("div", { className: "jini-attachment-preview-truncated", children: t('Preview truncated — this file is larger than the preview limit.') })) : null] }));
+}
+function AttachmentMetaCard({ attachment, sizeLabel }) {
+    const t = useT();
+    return (_jsxs("div", { className: "jini-attachment-preview-meta", children: [_jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Name') }), _jsx("span", { children: attachment.name })] }), _jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Type') }), _jsx("span", { children: looksLikeImageAttachment({ attachment: attachment }) ? t('Image') : t('File') })] }), sizeLabel ? (_jsxs("div", { className: "jini-attachment-preview-meta-row", children: [_jsx("span", { className: "jini-attachment-preview-meta-label", children: t('Size') }), _jsx("span", { children: sizeLabel })] })) : null, _jsx("div", { className: "jini-attachment-preview-meta-note", children: t('A preview is not available for this file.') })] }));
+}
+/** Previous/next side by side in the bottom-right corner, with the "2 / 5" position before them. */
+function AttachmentPreviewNav({ navigation }) {
+    const t = useT();
+    return (_jsxs("div", { className: "jini-attachment-preview-nav", children: [_jsx("span", { className: "jini-attachment-preview-count", "aria-live": "polite", children: t('{index} / {count}', { index: navigation.index + 1, count: navigation.count }) }), _jsx("button", { type: "button", className: "jini-attachment-preview-step", onClick: navigation.onPrevious, title: t('Previous image'), "aria-label": t('Previous image'), children: _jsx(Icon, { name: "chevron-left", size: 18 }) }), _jsx("button", { type: "button", className: "jini-attachment-preview-step", onClick: navigation.onNext, title: t('Next image'), "aria-label": t('Next image'), children: _jsx(Icon, { name: "chevron-right", size: 18 }) })] }));
 }
 //# sourceMappingURL=AttachmentPreviewModal.js.map

package/dist/react/components/ChatSettingsDialog.d.ts

@@ -0,0 +1,13 @@
+import { type ChatPermissionsPort, type ChatSettingsSection } from './ChatSettingsDialog.hooks.js';
+/** Advanced chat settings; the host supplies display actions, capabilities and persistence.
+ * Native dialog semantics own modal focus containment; closing restores the opener.
+ * Header and tabs stay fixed while only the active panel scrolls.
+ */
+export declare function ChatSettingsDialog(required: {
+    open: boolean;
+    onClose: () => void;
+    displaySections: readonly ChatSettingsSection[];
+    permissions: ChatPermissionsPort;
+    t?: (key: string) => string;
+}, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=ChatSettingsDialog.d.ts.map

package/dist/react/components/ChatSettingsDialog.hooks.d.ts

@@ -0,0 +1,115 @@
+/** Structural display port: hosts pass the very same actions used by their quick settings menu. */
+export interface ChatSettingsSection {
+    /** One-line explanation for a whole radio group; falls back to its first item's hint. */
+    key: string;
+    label?: string;
+    description?: string;
+    /** One help tip beside a radio group's legend, e.g. a bulleted line per option, in place of one per option. */
+    tooltip?: string;
+    items: readonly {
+        key: string;
+        label: string;
+        role?: string;
+        checked?: boolean;
+        hint?: string;
+        /** Interactive help for a switch row. Radio options share their section's `tooltip` instead. */
+        tooltip?: string;
+        disabled?: boolean;
+        onSelect?: () => void;
+    }[];
+}
+export interface ChatPermissionsPort {
+    enabled: boolean;
+    canEdit: boolean;
+    busy?: boolean;
+    error?: string | null;
+    unavailableReason?: string;
+    capabilities: readonly {
+        key: string;
+        label: string;
+        description: string;
+        enabled: boolean;
+    }[];
+    onChange(input: {
+        key?: string;
+        enabled: boolean;
+    }): void;
+}
+export type ChatSettingsTab = 'display' | 'permissions';
+/** Modal visibility only; display and permission state remain owned by the injected ports. */
+export declare function useChatSettingsDialog(_required: Record<string, never>, _optional?: Record<string, never>): {
+    open: boolean;
+    show: (_input?: Record<string, never>) => void;
+    close: (_input?: Record<string, never>) => void;
+};
+/** Bind existing menu actions and a host permission port without local preference copies.
+ * The active tab is the only local state: it is view navigation, not a setting.
+ * @complexity O(d + c) for the bounded display rows and host capabilities; no I/O here.
+ */
+export declare function useChatSettingsView(required: {
+    displaySections: readonly ChatSettingsSection[];
+    permissions: ChatPermissionsPort;
+    t?: (key: string) => string;
+}, _optional?: Record<string, never>): {
+    t: (key: string) => string;
+    permissions: ChatPermissionsPort;
+    tab: ChatSettingsTab;
+    setTab: (next: string) => void;
+    tabs: {
+        id: string;
+        label: string;
+    }[];
+    display: {
+        radio: boolean;
+        name: string;
+        hint: string | undefined;
+        hintId: string;
+        labelId: string;
+        tooltipId: string;
+        items: {
+            hintId: string;
+            change: () => void;
+            key: string;
+            label: string;
+            role?: string;
+            checked?: boolean;
+            hint?: string;
+            /** Interactive help for a switch row. Radio options share their section's `tooltip` instead. */
+            tooltip?: string;
+            disabled?: boolean;
+            onSelect?: () => void;
+        }[];
+        /** One-line explanation for a whole radio group; falls back to its first item's hint. */
+        key: string;
+        label?: string;
+        description?: string;
+        /** One help tip beside a radio group's legend, e.g. a bulleted line per option, in place of one per option. */
+        tooltip?: string;
+    }[];
+    master: {
+        label: string;
+        checked: boolean;
+        disabled: boolean;
+        descriptionId: string;
+        description: string;
+        onCheckedChange: ({ checked }: {
+            checked: boolean;
+        }) => void;
+    };
+    capabilities: {
+        descriptionId: string;
+        control: {
+            label: string;
+            checked: boolean;
+            disabled: boolean;
+            onCheckedChange: ({ checked }: {
+                checked: boolean;
+            }) => void;
+        };
+        key: string;
+        label: string;
+        description: string;
+        enabled: boolean;
+    }[];
+};
+//# sourceMappingURL=ChatSettingsDialog.hooks.d.ts.map

package/dist/react/components/ChatSettingsDialog.hooks.js

@@ -0,0 +1,40 @@
+import { useId, useState } from 'react';
+/** Modal visibility only; display and permission state remain owned by the injected ports. */
+export function useChatSettingsDialog(_required, _optional = {}) {
+    const [open, setOpen] = useState(false);
+    return { open, show: (_input = {}) => setOpen(true), close: (_input = {}) => setOpen(false) };
+}
+/** Bind existing menu actions and a host permission port without local preference copies.
+ * The active tab is the only local state: it is view navigation, not a setting.
+ * @complexity O(d + c) for the bounded display rows and host capabilities; no I/O here.
+ */
+export function useChatSettingsView(required, _optional = {}) {
+    const t = required.t ?? ((key) => key), permissions = required.permissions;
+    const id = useId();
+    const [tab, setTab] = useState('display');
+    const disabled = !permissions.canEdit || !!permissions.busy;
+    return { t, permissions,
+        tab, setTab: (next) => setTab(next === 'permissions' ? 'permissions' : 'display'),
+        tabs: [{ id: 'display', label: t('Display') }, { id: 'permissions', label: t('Agent permissions') }],
+        display: required.displaySections.map(section => ({ ...section,
+            radio: section.items[0]?.role === 'menuitemradio',
+            name: `${id}-${section.key}`,
+            // Radio rows share one line explaining the whole choice, so it sits under the group label.
+            hint: section.items[0]?.role === 'menuitemradio' ? section.description ?? section.items[0]?.hint : undefined,
+            hintId: `${id}-${section.key}`, labelId: `${id}-${section.key}-label`, tooltipId: `${id}-${section.key}-tooltip`,
+            items: section.items.map(item => ({ ...item, hintId: `${id}-${section.key}-${item.key}`,
+                change: () => { if (!item.disabled)
+                    item.onSelect?.(); } })),
+        })),
+        master: { label: t('Full CLI access'), checked: permissions.enabled, disabled, descriptionId: `${id}-master`,
+            description: t('Turn every capability below on or off at once.'),
+            onCheckedChange: ({ checked }) => { if (!disabled)
+                permissions.onChange({ enabled: checked }); } },
+        capabilities: permissions.capabilities.map(item => ({ ...item, descriptionId: `${id}-${item.key}`,
+            control: { label: item.label, checked: item.enabled, disabled,
+                onCheckedChange: ({ checked }) => { if (!disabled)
+                    permissions.onChange({ key: item.key, enabled: checked }); } },
+        })),
+    };
+}
+//# sourceMappingURL=ChatSettingsDialog.hooks.js.map

package/dist/react/components/ChatSettingsDialog.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useId, useLayoutEffect, useRef } from 'react';
+import { TabBar } from '@jini-ai/ui/tab-strip';
+import { InfoTip } from '@jini-ai/ui/admin-widgets';
+import { useChatSettingsView } from './ChatSettingsDialog.hooks.js';
+import { ChatSettingsSegmented } from './ChatSettingsSegmented.js';
+/** One switch row, with optional inline description and help beside the control and label.
+ * The help trigger stays outside the label so tapping it never toggles the switch.
+ * Earlier (owner) ⓘ tips floated away from their icon, so this row showed visible text only; on 2026-10-18 the owner approved per-option ⓘ help, which InfoTip now anchors to the icon.
+ * Later that day radio groups moved to one ⓘ beside their legend; a switch keeps its own, which now
+ * sits right after its label like the legend's (owner, 2026-10-21) instead of at the row's far edge. */
+function SettingSwitch(required, _optional = {}) {
+    const inputId = useId();
+    return _jsxs("div", { className: ['jini-chat-settings-row', required.className].filter(Boolean).join(' '), children: [_jsx("input", { id: inputId, type: "checkbox", role: "switch", className: "jini-checkbox jini-chat-settings-switch", checked: required.checked, disabled: required.disabled, "aria-describedby": [required.description ? required.descriptionId : '', required.tooltip ? `${required.descriptionId}-tooltip` : ''].filter(Boolean).join(' ') || undefined, onChange: event => required.onChange(event.currentTarget.checked) }), _jsxs("div", { className: "jini-chat-settings-text", children: [_jsxs("span", { className: "jini-chat-settings-label-row", children: [_jsx("label", { htmlFor: inputId, className: "jini-chat-settings-label", children: required.label }), required.tooltip && _jsx(InfoTip, { label: required.tooltip, descriptionId: `${required.descriptionId}-tooltip` })] }), required.description && _jsx("p", { id: required.descriptionId, className: "jini-chat-settings-description", children: required.description })] })] });
+}
+/** Advanced chat settings; the host supplies display actions, capabilities and persistence.
+ * Native dialog semantics own modal focus containment; closing restores the opener.
+ * Header and tabs stay fixed while only the active panel scrolls.
+ */
+export function ChatSettingsDialog(required, _optional = {}) {
+    const vm = useChatSettingsView(required);
+    const dialogRef = useRef(null), closeRef = useRef(null), titleId = useId();
+    const openerRef = useRef(null);
+    useLayoutEffect(() => {
+        const dialog = dialogRef.current;
+        if (!dialog || !required.open)
+            return;
+        openerRef.current = document.activeElement;
+        if (typeof dialog.showModal === 'function') {
+            if (!dialog.open)
+                dialog.showModal();
+        }
+        else
+            dialog.setAttribute('open', '');
+        closeRef.current?.focus({ preventScroll: true });
+        dialog.scrollTop = 0;
+        return () => {
+            if (typeof dialog.close === 'function') {
+                if (dialog.open)
+                    dialog.close();
+            }
+            else
+                dialog.removeAttribute('open');
+        };
+    }, [required.open]);
+    // Return focus to the opener from a passive cleanup: React's commit-time focus restore runs after
+    // layout cleanups and would pull focus straight back to the closing dialog's × button.
+    useEffect(() => {
+        if (!required.open)
+            return;
+        return () => {
+            const opener = openerRef.current;
+            if (opener instanceof HTMLElement && opener.isConnected)
+                opener.focus({ preventScroll: true });
+        };
+    }, [required.open]);
+    // Its own tip bounds: hosts mount this inside a narrow dock marked `data-jini-tip-bounds`, which
+    // pushed the ⓘ bubbles of options outside the dock across the dialog, away from their icon.
+    return _jsxs("dialog", { ref: dialogRef, "aria-labelledby": titleId, "aria-modal": "true", tabIndex: -1, "data-jini-tip-bounds": "", className: "jini-dialog jini-chat-settings-dialog", onCancel: event => { event.preventDefault(); required.onClose(); }, onClick: event => {
+            if (event.target !== event.currentTarget)
+                return;
+            const { clientX: x, clientY: y } = event, box = event.currentTarget.getBoundingClientRect();
+            if ((x === 0 && y === 0) || x < box.left || x > box.right || y < box.top || y > box.bottom)
+                required.onClose();
+        }, children: [_jsxs("header", { className: "jini-chat-settings-header", children: [_jsx("h2", { id: titleId, className: "jini-dialog-title", children: vm.t('Chat settings') }), _jsx("button", { ref: closeRef, type: "button", className: "jini-dialog-close jini-chat-settings-close", "aria-label": vm.t('Close'), onClick: required.onClose, children: _jsx("span", { "aria-hidden": "true", children: "\u00D7" }) })] }), _jsx(TabBar, { tabs: vm.tabs, activeId: vm.tab, onChange: vm.setTab, ariaLabel: vm.t('Chat settings') }), _jsx("div", { className: "jini-chat-settings-body", role: "tabpanel", "aria-label": vm.tab === 'display' ? vm.t('Display') : vm.t('Agent permissions'), children: vm.tab === 'display' ? vm.display.map(section => section.radio
+                    // One ⓘ for the whole choice, beside the legend (owner, 2026-10-18), not one per option. The
+                    // fieldset is named by the label span alone, so the tip's text never joins the group's name.
+                    ? _jsxs("fieldset", { className: "jini-chat-settings-group", "aria-labelledby": section.label ? section.labelId : undefined, "aria-describedby": [section.hint ? section.hintId : '', section.tooltip ? section.tooltipId : ''].filter(Boolean).join(' ') || undefined, children: [section.label && _jsxs("legend", { className: "jini-chat-settings-legend", children: [_jsx("span", { id: section.labelId, children: section.label }), section.tooltip && _jsx(InfoTip, { label: section.tooltip, descriptionId: section.tooltipId })] }), section.hint && _jsx("p", { id: section.hintId, className: "jini-chat-settings-description jini-chat-settings-description--group", children: section.hint }), _jsx(ChatSettingsSegmented, { name: section.name, items: section.items })] }, section.key)
+                    : _jsxs("fieldset", { className: "jini-chat-settings-group", children: [section.label && _jsx("legend", { className: "jini-chat-settings-legend", children: section.label }), section.items.map(item => _jsx(SettingSwitch, { label: item.label, checked: !!item.checked, disabled: item.disabled, onChange: item.change, description: item.hint, descriptionId: item.hintId, tooltip: item.tooltip }, item.key))] }, section.key))
+                    : _jsxs(_Fragment, { children: [_jsx("p", { className: "jini-chat-settings-note", children: vm.t('Permission changes apply to the next run.') }), vm.permissions.unavailableReason && _jsx("p", { className: "jini-chat-settings-note", children: vm.t(vm.permissions.unavailableReason) }), _jsx(SettingSwitch, { className: "jini-chat-settings-row--master", label: vm.master.label, checked: vm.master.checked, disabled: vm.master.disabled, onChange: checked => vm.master.onCheckedChange({ checked }), description: vm.master.description, descriptionId: vm.master.descriptionId }), _jsx("div", { className: "jini-chat-settings-capabilities", children: vm.capabilities.map(item => _jsx(SettingSwitch, { label: item.control.label, checked: item.control.checked, disabled: item.control.disabled, onChange: checked => item.control.onCheckedChange({ checked }), description: item.description, descriptionId: item.descriptionId }, item.key)) }), vm.permissions.busy && _jsx("p", { role: "status", className: "jini-chat-settings-note", children: vm.t('Saving…') }), vm.permissions.error && _jsx("p", { role: "alert", className: "jini-chat-settings-error", children: vm.permissions.error })] }) })] });
+}
+//# sourceMappingURL=ChatSettingsDialog.js.map

package/dist/react/components/ChatSettingsSegmented.d.ts

@@ -0,0 +1,18 @@
+/** One choice drawn as a segmented pill (the admin's segmented-control look), built on real radios
+ * for keyboard and AT. The Chat settings dialog and a host's quick settings menu share it (owner,
+ * 2026-10-21: the gear's Tool calls and Agent plugins match the dialog's control), so both look alike.
+ * Inside a `role="menu"` host, `inputRole="menuitemradio"` keeps each option a valid menu child, and
+ * `checkedRef` gets the checked option (else the first) so the host's roving focus can land on it. */
+export declare function ChatSettingsSegmented(required: {
+    name: string;
+    items: readonly {
+        key: string;
+        label: string;
+        checked?: boolean | undefined;
+        disabled?: boolean | undefined;
+        change: () => void;
+    }[];
+    inputRole?: 'menuitemradio' | undefined;
+    checkedRef?: ((input: HTMLInputElement | null) => void) | undefined;
+}, _optional?: Record<string, never>): import("react").JSX.Element;
+//# sourceMappingURL=ChatSettingsSegmented.d.ts.map

package/dist/react/components/ChatSettingsSegmented.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** One choice drawn as a segmented pill (the admin's segmented-control look), built on real radios
+ * for keyboard and AT. The Chat settings dialog and a host's quick settings menu share it (owner,
+ * 2026-10-21: the gear's Tool calls and Agent plugins match the dialog's control), so both look alike.
+ * Inside a `role="menu"` host, `inputRole="menuitemradio"` keeps each option a valid menu child, and
+ * `checkedRef` gets the checked option (else the first) so the host's roving focus can land on it. */
+export function ChatSettingsSegmented(required, _optional = {}) {
+    const focusKey = (required.items.find(item => item.checked) ?? required.items[0])?.key;
+    return _jsx("div", { className: "jini-chat-settings-segmented", children: required.items.map(item => _jsxs("label", { className: "jini-chat-settings-segment", children: [_jsx("input", { type: "radio", name: required.name, checked: !!item.checked, disabled: item.disabled, onChange: item.change, role: required.inputRole, "aria-checked": required.inputRole ? !!item.checked : undefined, ref: item.key === focusKey ? required.checkedRef : undefined }), _jsx("span", { children: item.label })] }, item.key)) });
+}
+//# sourceMappingURL=ChatSettingsSegmented.js.map

package/dist/react/components/Composer.d.ts

@@ -6,6 +6,10 @@ export interface ComposerProps {
     disabled?: boolean;
     /** Disables submission without disabling draft editing or attachment controls. */
     sendDisabled?: boolean;
+    /** Human-readable submission blocker, exposed on the Send button. */
+    sendDisabledReason?: string;
+    /** ID of the rendered blocker hint used as the Send button's description. */
+    sendDisabledReasonId?: string;
     placeholder?: string;
     slots?: ComposerSlots;
     attachmentPicker?: {
@@ -67,5 +71,5 @@ export interface ComposerProps {
  * @complexity Time/space: O(n) in rendered attachments and supplied menu items.
  * @overallScore 100/100
  */
-export declare function Composer({ composer, onSend, disabled, sendDisabled, placeholder, slots, attachmentPicker, running, onCancel, onInterrupt, workingDirectory, onChangeWorkingDirectory, onPickWorkingDirectory, }: ComposerProps): import("react").JSX.Element;
+export declare function Composer({ composer, onSend, disabled, sendDisabled, sendDisabledReason, sendDisabledReasonId, placeholder, slots, attachmentPicker, running, onCancel, onInterrupt, workingDirectory, onChangeWorkingDirectory, onPickWorkingDirectory, }: ComposerProps): import("react").JSX.Element;
 //# sourceMappingURL=Composer.d.ts.map