@roaming-ai/dsh-group-chat 0.2.0

package/lib/types/client/Bubble.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 聊天消息气泡（user / system / 角色发言）。
+ * @module dsh-group-chat/client/Bubble
+ */
+import type { ReactNode } from 'react';
+import { type ClientSnapshot } from './model.ts';
+export declare function Bubble(props: {
+    snap: ClientSnapshot;
+    m: ClientSnapshot['messages'][number];
+}): ReactNode;

package/lib/types/client/Glyph.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 侧边栏入口图标。
+ *
+ * 整行命中层携带 “newSession” 类名：任务看板等 DOM 注入式面板用
+ * [class*="newSession"] 识别“侧边栏导航点击”并自动收起自己，与点击
+ * “新建会话”行为一致——类名不可哈希化。
+ * @module dsh-group-chat/client/glyph
+ */
+import type { ReactNode } from 'react';
+export declare function Glyph(props: {
+    size?: number;
+}): ReactNode;

package/lib/types/client/GroupChatPanel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 主面板：三区工作台——左导航栏（搜索 + 群组→会话目录树）、中央会话流
+ * （@成员 点名 + markdown 渲染 + 思考折叠）、右上下文栏（群成员角色卡 +
+ * 工作区目录），右栏可收起，角色编辑走右侧滑出抽屉。
+ *
+ * 面板数据走 /api/group-chat/*（fetch + SSE），Host 半持有全部状态。
+ * @module dsh-group-chat/client/panel
+ */
+import { type ReactNode } from 'react';
+export declare function GroupChatPanel(): ReactNode;

package/lib/types/client/GroupChatPanel.old.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 主面板：三区工作台——左导航栏（搜索 + 群组→会话目录树）、中央会话流
+ * （@成员 点名 + markdown 渲染 + 思考折叠）、右上下文栏（群成员角色卡 +
+ * 工作区目录），右栏可收起，角色编辑走右侧滑出抽屉。
+ *
+ * 面板数据走 /api/group-chat/*（fetch + SSE），Host 半持有全部状态。
+ * @module dsh-group-chat/client/panel
+ */
+import { type ReactNode } from 'react';
+export declare function GroupChatPanel(): ReactNode;

package/lib/types/client/GroupChatSettingsSection.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 设置页：启停开关（settings.section 插槽）。写 host 的 group-chat 设置
+ * 命名空间（settings.yaml 持久化）。
+ * @module dsh-group-chat/client/settings
+ */
+import { type ReactNode } from 'react';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+/** Host 侧注册的设置命名空间 shape。 */
+interface GroupChatSettings {
+    enabled?: boolean;
+}
+export declare function GroupChatSettingsSection(props: {
+    settingsScope: SettingsScope<GroupChatSettings>;
+}): ReactNode;
+export {};

package/lib/types/client/PermissionSelect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 群组权限档位选择器（对齐主会话 composer 左下角的 /permission 选择器）：
+ * 触发芯片（盾形图标 + 档位名 + chevron）+ Menu 上弹三档 + 完全权限风险
+ * 确认弹窗（与主会话同款 RiskConfirmation 原语与文案）。
+ * @module dsh-group-chat/client/permission-select
+ */
+import { type ReactNode } from 'react';
+import type { PermissionTier } from '../core/types.ts';
+export interface PermissionSelectProps {
+    tier: PermissionTier;
+    onSelect: (tier: PermissionTier) => void;
+}
+export declare function PermissionSelect(props: PermissionSelectProps): ReactNode;

package/lib/types/client/RoleDrawer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 角色编辑抽屉（右侧滑出，不遮挡会话流阅读）。
+ * @module dsh-group-chat/client/drawer
+ */
+import { type ReactNode } from 'react';
+import { type ModelsResponse, type RoleDraft } from './model.ts';
+export interface RoleDrawerProps {
+    draft: RoleDraft;
+    set: (draft: RoleDraft) => void;
+    models: ModelsResponse | null;
+    modelsError: string | null;
+    onRetryModels: () => void;
+    onSave: () => void;
+    onCancel: () => void;
+    formError: string;
+}
+export declare function RoleDrawer(props: RoleDrawerProps): ReactNode;

package/lib/types/client/ThinkRow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 思考折叠行（对标宿主 ReasoningRow：折叠摘要 / 展开全文）。
+ * @module dsh-group-chat/client/ThinkRow
+ */
+import { type ReactNode } from 'react';
+export declare function ThinkRow(props: {
+    text: string;
+    running?: boolean;
+}): ReactNode;

package/lib/types/client/ToolRow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 工具调用折叠行（对标思考折叠：摘要行 / 展开输出）。
+ * @module dsh-group-chat/client/ToolRow
+ */
+import { type ReactNode } from 'react';
+import type { ToolCallView } from './model.ts';
+export declare function ToolRow(props: {
+    c: ToolCallView;
+}): ReactNode;

package/lib/types/client/api.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 浏览器半 transport：/api/group-chat/* 同源 JSON 端点。
+ * @module dsh-group-chat/client/api
+ */
+export declare const api: {
+    state: () => Promise<unknown>;
+    action: (payload: Record<string, unknown>) => Promise<unknown>;
+};

package/lib/types/client/components/AsidePanel.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 右侧成员与工作区栏组件
+ * @module dsh-group-chat/client/components
+ */
+import type { ReactNode } from 'react';
+import { type ClientSnapshot, type SnapshotRole } from '../lib/model.ts';
+interface AsidePanelProps {
+    snap: ClientSnapshot;
+    group: ClientSnapshot['groups'][number];
+    asideOpen: boolean;
+    wsDraft: string | null;
+    setWsDraft: (val: string | null) => void;
+    fileBrowser: {
+        open: boolean;
+        loading: boolean;
+        list: import('../../core/types.ts').BrowseResult | null;
+        error: string;
+    } | null;
+    setFileBrowser: (val: {
+        open: boolean;
+        loading: boolean;
+        list: import('../../core/types.ts').BrowseResult | null;
+        error: string;
+    } | null) => void;
+    mutate: (args: Record<string, unknown>) => Promise<unknown>;
+    openRoleEditor: (role: SnapshotRole | null) => Promise<void>;
+    openBrowser: (path: string | undefined) => Promise<void>;
+    selectCurrentDir: () => void;
+}
+export declare function AsidePanel(props: AsidePanelProps): ReactNode;
+export {};

package/lib/types/client/components/Bubble.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 聊天消息气泡（user / system / 角色发言）。
+ *
+ * 帧稳定 memo：SSE 全量快照（~65KB × 7fps）每帧重建全部消息对象 identity，
+ * 但已完成消息在 host 侧 append 后不可变——按渲染相关字段做值比较，流式
+ * 期间跳过已完成消息的重渲（每帧仅 live 行与派生列表变化），避免全量
+ * MarkdownText 重新解析打满主线程导致「卡死后一次性蹦出」。
+ * @module dsh-group-chat/client/Bubble
+ */
+import { type ReactNode } from 'react';
+import { type ClientSnapshot, type SnapshotRole } from '../lib/model.ts';
+export interface BubbleProps {
+    m: ClientSnapshot['messages'][number];
+    /** 父级解析好的发言角色（user/system 消息为 null）——避免 Bubble 依赖 snap identity。 */
+    role: SnapshotRole | null;
+}
+declare function BubbleInner({ m, role }: BubbleProps): ReactNode;
+export declare const Bubble: import("react").MemoExoticComponent<typeof BubbleInner>;
+export {};

package/lib/types/client/components/ChatPanel.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 中央会话面板组件
+ * @module dsh-group-chat/client/components
+ */
+import type { ReactNode } from 'react';
+import type { ClientSnapshot, SnapshotRole } from '../lib/model.ts';
+import type { AtToken } from '../../shared/file-mention-grammar.ts';
+interface ChatPanelProps {
+    snap: ClientSnapshot;
+    sess: ClientSnapshot['sessions'][number] | null;
+    group: ClientSnapshot['groups'][number];
+    enabledRoles: SnapshotRole[];
+    participants: string[];
+    mentionedRoles: SnapshotRole[];
+    busyNow: boolean;
+    input: string;
+    mention: AtToken | null;
+    mentionCandidates: SnapshotRole[];
+    mentionIdxC: number;
+    fileCandidates: Array<{
+        path: string;
+        isDir: boolean;
+    }>;
+    fileSearchError: string | null;
+    fileSearchLoading: boolean;
+    rounds: number;
+    err: string;
+    atBottom: boolean;
+    topicDraft: string | null;
+    msgById: Record<string, ClientSnapshot['messages'][number]>;
+    navOpen: boolean;
+    asideOpen: boolean;
+    inputRef: React.RefObject<HTMLDivElement>;
+    scrollRef: React.RefObject<HTMLDivElement>;
+    setTopicDraft: (val: string | null) => void;
+    setConfirmClear: (val: boolean) => void;
+    setMentionIdx: (val: number) => void;
+    setRounds: (val: number) => void;
+    setNavOpen: (val: boolean) => void;
+    setAsideOpen: (val: boolean) => void;
+    togglePart: (rid: string) => void;
+    onMsgsScroll: () => void;
+    onInputCE: () => void;
+    onInputKeyDown: (e: React.KeyboardEvent<HTMLDivElement>) => void;
+    onPasteCE: (e: React.ClipboardEvent<HTMLDivElement>) => void;
+    onDropCE: (e: React.DragEvent<HTMLDivElement>) => void;
+    onDragOverCE: (e: React.DragEvent<HTMLDivElement>) => void;
+    insertChip: (role: SnapshotRole) => void;
+    insertFileChip: (path: string, kind: 'file' | 'directory') => void;
+    sendMsg: () => Promise<void>;
+    stopRun: () => Promise<void>;
+    action: (payload: Record<string, unknown>) => Promise<unknown>;
+    mutate: (args: Record<string, unknown>) => Promise<unknown>;
+    setMention: (val: AtToken | null) => void;
+}
+export declare function ChatPanel(props: ChatPanelProps): ReactNode;
+export {};

package/lib/types/client/components/Composer.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 消息输入编辑器组件
+ * @module dsh-group-chat/client/components
+ */
+import type { ReactNode, KeyboardEvent as ReactKeyboardEvent, ClipboardEvent as ReactClipboardEvent, DragEvent as ReactDragEvent } from 'react';
+import { type ClientSnapshot, type SnapshotRole } from '../lib/model.ts';
+import type { AtToken } from '../../shared/file-mention-grammar.ts';
+interface ComposerProps {
+    snap: ClientSnapshot;
+    sess: ClientSnapshot['sessions'][number] | null;
+    group: ClientSnapshot['groups'][number];
+    enabledRoles: SnapshotRole[];
+    participants: string[];
+    mentionedRoles: SnapshotRole[];
+    busyNow: boolean;
+    input: string;
+    mention: AtToken | null;
+    mentionCandidates: SnapshotRole[];
+    mentionIdxC: number;
+    fileCandidates: Array<{
+        path: string;
+        isDir: boolean;
+    }>;
+    fileSearchError: string | null;
+    fileSearchLoading: boolean;
+    rounds: number;
+    err: string;
+    atBottom: boolean;
+    bubblesLength: number;
+    inputRef: React.RefObject<HTMLDivElement>;
+    scrollRef: React.RefObject<HTMLDivElement>;
+    setMentionIdx: (val: number) => void;
+    setRounds: (val: number) => void;
+    togglePart: (rid: string) => void;
+    onInputCE: () => void;
+    onInputKeyDown: (e: ReactKeyboardEvent<HTMLDivElement>) => void;
+    onPasteCE: (e: ReactClipboardEvent<HTMLDivElement>) => void;
+    onDropCE: (e: ReactDragEvent<HTMLDivElement>) => void;
+    onDragOverCE: (e: ReactDragEvent<HTMLDivElement>) => void;
+    insertChip: (role: SnapshotRole) => void;
+    insertFileChip: (path: string, kind: 'file' | 'directory') => void;
+    sendMsg: () => Promise<void>;
+    stopRun: () => Promise<void>;
+    mutate: (args: Record<string, unknown>) => Promise<unknown>;
+    setMention: (val: AtToken | null) => void;
+}
+export declare function Composer(props: ComposerProps): ReactNode;
+export {};

package/lib/types/client/components/Glyph.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 侧边栏入口图标。
+ *
+ * 整行命中层携带 “newSession” 类名：任务看板等 DOM 注入式面板用
+ * [class*="newSession"] 识别“侧边栏导航点击”并自动收起自己，与点击
+ * “新建会话”行为一致——类名不可哈希化。
+ * @module dsh-group-chat/client/glyph
+ */
+import type { ReactNode } from 'react';
+export declare function Glyph(props: {
+    size?: number;
+}): ReactNode;

package/lib/types/client/components/GroupChatSettingsSection.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 设置页：启停开关（settings.section 插槽）。写 host 的 group-chat 设置
+ * 命名空间（settings.yaml 持久化）。
+ * @module dsh-group-chat/client/settings
+ */
+import { type ReactNode } from 'react';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+/** Host 侧注册的设置命名空间 shape。 */
+interface GroupChatSettings {
+    enabled?: boolean;
+}
+export declare function GroupChatSettingsSection(props: {
+    settingsScope: SettingsScope<GroupChatSettings>;
+}): ReactNode;
+export {};

package/lib/types/client/components/MessageFlow.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 消息流显示组件
+ * @module dsh-group-chat/client/components
+ */
+import type { ReactNode } from 'react';
+import { type ClientSnapshot } from '../lib/model.ts';
+interface MessageFlowProps {
+    snap: ClientSnapshot;
+    sess: ClientSnapshot['sessions'][number] | null;
+    busyNow: boolean;
+    msgById: Record<string, ClientSnapshot['messages'][number]>;
+    action: (payload: Record<string, unknown>) => Promise<unknown>;
+}
+export declare function MessageFlow(props: MessageFlowProps): ReactNode;
+export {};

package/lib/types/client/components/NavPanel.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 左侧导航栏组件
+ * @module dsh-group-chat/client/components
+ */
+import type { ReactNode } from 'react';
+import { type ClientSnapshot } from '../lib/model.ts';
+interface NavPanelProps {
+    snap: ClientSnapshot;
+    search: string;
+    setSearch: (val: string) => void;
+    collapsedGroups: Set<string>;
+    setCollapsedGroups: (fn: (prev: Set<string>) => Set<string>) => void;
+    gid: string | null;
+    sid: string | null;
+    setGid: (val: string) => void;
+    setSid: (val: string) => void;
+    setPartsSel: (val: string[] | null) => void;
+    renameDraft: {
+        kind: 'group' | 'session';
+        id: string;
+        value: string;
+    } | null;
+    setRenameDraft: (val: {
+        kind: 'group' | 'session';
+        id: string;
+        value: string;
+    } | null) => void;
+    confirmDel: {
+        kind: 'group' | 'session';
+        id: string;
+    } | null;
+    setConfirmDel: (val: {
+        kind: 'group' | 'session';
+        id: string;
+    } | null) => void;
+    mutate: (args: Record<string, unknown>) => Promise<unknown>;
+    navOpen: boolean;
+}
+export declare function NavPanel(props: NavPanelProps): ReactNode;
+export {};

package/lib/types/client/components/PermissionSelect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 群组权限档位选择器（对齐主会话 composer 左下角的 /permission 选择器）：
+ * 触发芯片（盾形图标 + 档位名 + chevron）+ Menu 上弹三档 + 完全权限风险
+ * 确认弹窗（与主会话同款 RiskConfirmation 原语与文案）。
+ * @module dsh-group-chat/client/permission-select
+ */
+import { type ReactNode } from 'react';
+import type { PermissionTier } from '../../core/types.ts';
+export interface PermissionSelectProps {
+    tier: PermissionTier;
+    onSelect: (tier: PermissionTier) => void;
+}
+export declare function PermissionSelect(props: PermissionSelectProps): ReactNode;

package/lib/types/client/components/RoleDrawer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 角色编辑抽屉（右侧滑出，不遮挡会话流阅读）。
+ * @module dsh-group-chat/client/drawer
+ */
+import { type ReactNode } from 'react';
+import { type ModelsResponse, type RoleDraft } from '../lib/model.ts';
+export interface RoleDrawerProps {
+    draft: RoleDraft;
+    set: (draft: RoleDraft) => void;
+    models: ModelsResponse | null;
+    modelsError: string | null;
+    onRetryModels: () => void;
+    onSave: () => void;
+    onCancel: () => void;
+    formError: string;
+}
+export declare function RoleDrawer(props: RoleDrawerProps): ReactNode;

package/lib/types/client/components/ThinkRow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 思考折叠行（对标宿主 ReasoningRow：折叠摘要 / 展开全文）。
+ * @module dsh-group-chat/client/ThinkRow
+ */
+import { type ReactNode } from 'react';
+export declare function ThinkRow(props: {
+    text: string;
+    running?: boolean;
+}): ReactNode;

package/lib/types/client/components/ToolRow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 工具调用折叠行（对标思考折叠：摘要行 / 展开输出）。
+ * @module dsh-group-chat/client/ToolRow
+ */
+import { type ReactNode } from 'react';
+import type { ToolCallView } from '../lib/model.ts';
+export declare function ToolRow(props: {
+    c: ToolCallView;
+}): ReactNode;

package/lib/types/client/components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 组件统一导出
+ * @module dsh-group-chat/client/components
+ */
+export * from './NavPanel.tsx';
+export * from './AsidePanel.tsx';
+export * from './ChatPanel.tsx';
+export * from './Composer.tsx';
+export * from './MessageFlow.tsx';

package/lib/types/client/components.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 会话流内容组件：思考折叠行、工具调用折叠行、聊天气泡。
+ * 对标宿主同源渲染（MarkdownText 正文 + 思考折叠行 + CodeBlock 代码块）。
+ * @module dsh-group-chat/client/components
+ */
+import { type ReactNode } from 'react';
+import { Icon } from './ui.ts';
+import { type ClientSnapshot, type ToolCallView } from './model.ts';
+/** 思考折叠行（对标宿主 ReasoningRow：折叠摘要 / 展开全文）。 */
+export declare function ThinkRow(props: {
+    text: string;
+    running?: boolean;
+}): ReactNode;
+export declare function ToolRow(props: {
+    c: ToolCallView;
+}): ReactNode;
+/** 聊天消息（user / system / 角色发言）。 */
+export declare function Bubble(props: {
+    snap: ClientSnapshot;
+    m: ClientSnapshot['messages'][number];
+}): ReactNode;
+export { Icon };

package/lib/types/client/drawer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 角色编辑抽屉（右侧滑出，不遮挡会话流阅读）。
+ * @module dsh-group-chat/client/drawer
+ */
+import { type ReactNode } from 'react';
+import { type ModelsResponse, type RoleDraft } from './model.ts';
+export interface RoleDrawerProps {
+    draft: RoleDraft;
+    set: (draft: RoleDraft) => void;
+    models: ModelsResponse | null;
+    modelsError: string | null;
+    onRetryModels: () => void;
+    onSave: () => void;
+    onCancel: () => void;
+    formError: string;
+}
+export declare function RoleDrawer(props: RoleDrawerProps): ReactNode;

package/lib/types/client/glyph.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 侧边栏入口图标。
+ *
+ * 整行命中层携带 “newSession” 类名：任务看板等 DOM 注入式面板用
+ * [class*="newSession"] 识别“侧边栏导航点击”并自动收起自己，与点击
+ * “新建会话”行为一致——类名不可哈希化。
+ * @module dsh-group-chat/client/glyph
+ */
+import type { ReactNode } from 'react';
+export declare function Glyph(props: {
+    size?: number;
+}): ReactNode;

package/lib/types/client/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hooks 统一导出
+ * @module dsh-group-chat/client/hooks
+ */
+export * from './useGroupChatState.ts';
+export * from './useComposer.ts';

package/lib/types/client/hooks/useComposer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 消息输入相关 hooks
+ * @module dsh-group-chat/client/hooks
+ */
+import { type ClipboardEvent as ReactClipboardEvent, type DragEvent as ReactDragEvent, type KeyboardEvent as ReactKeyboardEvent } from 'react';
+import type { AtToken } from '../../shared/file-mention-grammar.ts';
+import type { SnapshotRole } from '../lib/model.ts';
+export declare function useComposerEffects(inputRef: React.RefObject<HTMLDivElement>, scrollRef: React.RefObject<HTMLDivElement>, input: string, atBottom: boolean, snap: unknown): {
+    onMsgsScroll: () => boolean | undefined;
+};
+export declare function useComposerInput(inputRef: React.RefObject<HTMLDivElement>, setInput: (val: string) => void, setMention: (val: AtToken | null) => void, setMentionIdx: (val: number) => void): {
+    syncFromDOM: () => void;
+    onInputCE: () => void;
+    onPasteCE: (e: ReactClipboardEvent<HTMLDivElement>) => void;
+    onDragOverCE: (e: ReactDragEvent<HTMLDivElement>) => void;
+    onDropCE: (e: ReactDragEvent<HTMLDivElement>) => void;
+};
+export declare function useMentionChip(inputRef: React.RefObject<HTMLDivElement>, setMention: (val: AtToken | null) => void, setMentionIdx: (val: number) => void, syncFromDOM: () => void): {
+    insertChip: (role: SnapshotRole) => void;
+    insertFileChip: (path: string, kind: "file" | "directory") => void;
+};
+export declare function useInputKeyboard(mention: AtToken | null, mentionCandidates: SnapshotRole[], mentionIdxC: number, setMentionIdx: (val: number | ((prev: number) => number)) => void, insertChip: (role: SnapshotRole) => void, insertFileChip: (path: string, kind: 'file' | 'directory') => void, fileCandidates: Array<{
+    path: string;
+    isDir: boolean;
+}>, setMention: (val: AtToken | null) => void, sendMsg: () => Promise<void>): {
+    onInputKeyDown: (e: ReactKeyboardEvent<HTMLDivElement>) => void;
+};

package/lib/types/client/hooks/useFileSearch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 文件搜索 hook：防抖 + 取消过期请求 + 短缓存。
+ * @module dsh-group-chat/client/hooks
+ */
+import type { AtToken } from '../../shared/file-mention-grammar.ts';
+export interface FileCandidate {
+    path: string;
+    isDir: boolean;
+}
+export interface FileSearchResult {
+    fileCandidates: FileCandidate[];
+    fileSearchError: string | null;
+    fileSearchLoading: boolean;
+}
+/**
+ * 文件搜索：query 变化 180ms 内合并；过期 fetch 真正 abort；
+ * 命中短缓存立刻出结果。离开文件模式才清空列表，避免每个按键闪「检索中」。
+ */
+export declare function useFileSearch(mention: AtToken | null, groupId: string | undefined): FileSearchResult;

package/lib/types/client/hooks/useGroupChatState.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 群聊面板核心状态管理 hook
+ * @module dsh-group-chat/client/hooks
+ */
+import type { ClientSnapshot, ModelsResponse, RoleDraft } from '../lib/model.ts';
+import type { AtToken } from '../../shared/file-mention-grammar.ts';
+export interface MutateResponse {
+    ok: boolean;
+    snapshot?: ClientSnapshot;
+    lastCreated?: ClientSnapshot['lastCreated'];
+    error?: string;
+}
+export interface ActionOk {
+    ok: boolean;
+    error?: string;
+}
+export declare function useGroupChatState(): {
+    snap: ClientSnapshot | null;
+    setSnap: (s: ClientSnapshot) => void;
+    gid: string | null;
+    setGid: (v: string) => void;
+    sid: string | null;
+    setSid: (v: string) => void;
+    search: string;
+    setSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
+    collapsedGroups: Set<string>;
+    setCollapsedGroups: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    renameDraft: {
+        kind: "group" | "session";
+        id: string;
+        value: string;
+    } | null;
+    setRenameDraft: import("react").Dispatch<import("react").SetStateAction<{
+        kind: "group" | "session";
+        id: string;
+        value: string;
+    } | null>>;
+    confirmDel: {
+        kind: "group" | "session";
+        id: string;
+    } | null;
+    setConfirmDel: import("react").Dispatch<import("react").SetStateAction<{
+        kind: "group" | "session";
+        id: string;
+    } | null>>;
+    confirmClear: boolean;
+    setConfirmClear: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    roleDraft: RoleDraft | null;
+    setRoleDraft: import("react").Dispatch<import("react").SetStateAction<RoleDraft | null>>;
+    roleFormError: string;
+    setRoleFormError: import("react").Dispatch<import("react").SetStateAction<string>>;
+    models: ModelsResponse | null;
+    setModels: import("react").Dispatch<import("react").SetStateAction<ModelsResponse | null>>;
+    modelsError: string | null;
+    setModelsError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    fileBrowser: {
+        open: boolean;
+        loading: boolean;
+        list: import("../../core/types.ts").BrowseResult | null;
+        error: string;
+    } | null;
+    setFileBrowser: import("react").Dispatch<import("react").SetStateAction<{
+        open: boolean;
+        loading: boolean;
+        list: import("../../core/types.ts").BrowseResult | null;
+        error: string;
+    } | null>>;
+    wsDraft: string | null;
+    setWsDraft: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    partsSel: string[] | null;
+    setPartsSel: import("react").Dispatch<import("react").SetStateAction<string[] | null>>;
+    rounds: number;
+    setRounds: import("react").Dispatch<import("react").SetStateAction<number>>;
+    input: string;
+    setInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    err: string;
+    setErr: import("react").Dispatch<import("react").SetStateAction<string>>;
+    topicDraft: string | null;
+    setTopicDraft: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    mention: AtToken | null;
+    setMention: import("react").Dispatch<import("react").SetStateAction<AtToken | null>>;
+    mentionIdx: number;
+    setMentionIdx: import("react").Dispatch<import("react").SetStateAction<number>>;
+    asideOpen: boolean;
+    setAsideOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    navOpen: boolean;
+    setNavOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    atBottom: boolean;
+    setAtBottom: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    inputRef: import("react").MutableRefObject<HTMLDivElement | null>;
+    sendingRef: import("react").MutableRefObject<boolean>;
+    scrollRef: import("react").MutableRefObject<HTMLDivElement | null>;
+    action: (payload: Record<string, unknown>) => Promise<unknown>;
+    mutate: (args: Record<string, unknown>) => Promise<MutateResponse | null>;
+};