@roaming-ai/dsh-group-chat 0.3.0 → 0.3.1

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

@@ -1,10 +0,0 @@
-/**
- * 主面板：三区工作台——左导航栏（搜索 + 群组→会话目录树）、中央会话流
- * （@成员 点名 + 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

@@ -1,15 +0,0 @@
-/**
- * 设置页：启停开关（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

@@ -1,13 +0,0 @@
-/**
- * 群组权限档位选择器（对齐主会话 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

@@ -1,17 +0,0 @@
-/**
- * 角色编辑抽屉（右侧滑出，不遮挡会话流阅读）。
- * @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

@@ -1,9 +0,0 @@
-/**
- * 思考折叠行（对标宿主 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

@@ -1,9 +0,0 @@
-/**
- * 工具调用折叠行（对标思考折叠：摘要行 / 展开输出）。
- * @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

@@ -1,8 +0,0 @@
-/**
- * 浏览器半 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.d.ts

@@ -1,22 +0,0 @@
-/**
- * 会话流内容组件：思考折叠行、工具调用折叠行、聊天气泡。
- * 对标宿主同源渲染（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

@@ -1,17 +0,0 @@
-/**
- * 角色编辑抽屉（右侧滑出，不遮挡会话流阅读）。
- * @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

@@ -1,12 +0,0 @@
-/**
- * 侧边栏入口图标。
- *
- * 整行命中层携带 “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/model.d.ts

@@ -1,78 +0,0 @@
-/**
- * 浏览器半共享常量与小工具（纯函数，无 React 依赖）。
- * @module dsh-group-chat/client/model
- */
-import type { RoleRecord, Snapshot, ToolCallRecord } from '../core/types.ts';
-/** 角色标识色调色板（与宿主半一致）。 */
-export declare const PALETTE: string[];
-/** Host HTTP API 前缀。 */
-export declare const API_PREFIX = "/api/group-chat";
-/** MarkdownText 渲染文案。 */
-export declare const MD_LABELS: Readonly<{
-    code: {
-        copyLabel: string;
-        copiedLabel: string;
-    };
-    footnotes: "脚注";
-}>;
-/** 快照的 wire 形态（响应里带 ok 标记）。 */
-export type ClientSnapshot = Snapshot & {
-    ok: boolean;
-};
-/** models action 的响应形态。 */
-export interface ModelsResponse {
-    ok: boolean;
-    providers?: {
-        id: string;
-        name?: string;
-    }[];
-    modelsByProvider?: Record<string, {
-        id: string;
-        name?: string;
-    }[]>;
-    error?: string;
-}
-/** efforts action 的响应形态。 */
-export interface EffortsResponse {
-    ok: boolean;
-    efforts?: {
-        id: string;
-        name: string;
-        description?: string;
-    }[];
-    defaultEffort?: string;
-    error?: string;
-}
-/** 快照内的角色/会话/群组视图行。 */
-export type SnapshotRole = Snapshot['roles'][number];
-export type SnapshotSession = Snapshot['sessions'][number];
-export type SnapshotGroup = Snapshot['groups'][number];
-export type SnapshotMessage = Snapshot['messages'][number];
-export declare function roleById(s: ClientSnapshot, id: string | null): SnapshotRole | null;
-export declare function sessById(s: ClientSnapshot, id: string): SnapshotSession | null;
-export declare function groupById(s: ClientSnapshot, id: string): SnapshotGroup | null;
-export declare function escapeRegExp(v: string): string;
-export declare function firstLine(text: string): string;
-export declare function latestLine(text: string): string;
-export declare function fmtTime(ts: number): string;
-/** 角色编辑抽屉的草稿形态（编辑与新建共用）。 */
-export interface RoleDraft {
-    id?: string;
-    name: string;
-    color: string | null;
-    persona: string;
-    provider: string;
-    model: string;
-    temperature?: number;
-    reasoningEffort: string;
-    enabled?: boolean;
-    thinking: boolean;
-}
-export declare function draftFromRole(role: SnapshotRole): RoleDraft;
-export declare function blankDraft(): RoleDraft;
-/** 工具调用行的展示参数。 */
-export type ToolCallView = ToolCallRecord;
-/** 草稿是否可作为角色落库（宿主侧再校验一次）。 */
-export declare function draftMissing(draft: RoleDraft): string;
-/** RoleRecord 兼容视图（快照角色行即其展示子集）。 */
-export type RoleView = RoleRecord;

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

@@ -1,10 +0,0 @@
-/**
- * 主面板：三区工作台——左导航栏（搜索 + 群组→会话目录树）、中央会话流
- * （@成员 点名 + 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/settings.d.ts

@@ -1,15 +0,0 @@
-/**
- * 设置页：启停开关（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/styles.d.ts

@@ -1,10 +0,0 @@
-/**
- * 浏览器半样式：CSS 以内联字符串承载（刻意不迁移 CSS Modules 管线——
- * 类名需保持原样，侧栏入口的 “newSession” 类名是任务看板等 DOM 注入式
- * 面板识别“侧边栏导航点击”的跨插件标记，哈希化会破坏该约定）。
- * 工厂执行时幂等注入 <style>，loader 卸载时按 data-plugin 摘除标签。
- * @module dsh-group-chat/client/styles
- */
-export declare const CSS: string;
-/** 工厂执行时幂等注入样式标签（loader 卸载时按 data-plugin 摘除）。 */
-export declare function injectStyles(): void;

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

@@ -1,17 +0,0 @@
-/**
- * 浏览器半 UI 基座：DSW 原语（shell 静态种子模块，loader 模块表 external）
- * 与动态图标 / 命令式 createElement 辅助。组件主体已 JSX 化（.tsx）；此处
- * 仅保留 slot 注册回调与动态图标表需要的少量命令式辅助。
- * @module dsh-group-chat/client/ui
- */
-import { type ReactNode } from 'react';
-import * as P from '@deepseek-ai/dsh-client-ui-primitives';
-export { P };
-/** 命令式 createElement（仅 slot 注册回调用）。 */
-export declare const h: (type: unknown, props?: Record<string, unknown> | null, ...children: unknown[]) => ReactNode;
-/** 图标组件的调用形态。 */
-export type IconComponent = (props: Record<string, unknown>) => ReactNode;
-/** 按名取 DSW 原语（图标表驱动）。 */
-export declare function pickPrimitive(name: string): IconComponent;
-/** 以统一 size 包装图标组件调用（放在 JSX 子元素位）。 */
-export declare function Icon(comp: unknown, size: number, extra?: Record<string, unknown>): ReactNode;

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

@@ -1,22 +0,0 @@
-/**
- * 通用工具函数
- * @module dsh-group-chat/client/utils
- */
-/** HTML 转义（芯片以 execCommand('insertHTML') 注入，角色名需转义）。 */
-export declare function escapeHtml(v: string): string;
-export declare function execCommand(commandId: 'delete' | 'insertHTML' | 'insertText' | 'insertLineBreak', value?: string): boolean;
-/**
- * contenteditable 输入区 → 纯文本序列化（发送/参与判定的唯一事实源）：
- * 文本节点原样；<br> → 换行；@提及芯片（.dsgc-chipin）展开回「@名字␠」；
- * DIV/P 块前补换行（防粘贴残留的块级包裹）。手打纯文本 @名字 与芯片展开
- * 结果同形——语义统一由 mentionedRoles 正则承载（芯片=糖，正则=真）。
- */
-export declare function serializeInput(root: HTMLElement): string;
-/** @提及芯片的 HTML（原子元素：contenteditable=false + draggable，退格整删）。 */
-export declare function chipHtml(role: {
-    id: string;
-    name: string;
-    color?: string;
-}): string;
-/** 光标前未闭合的 @词（弹层触发判定）；无返回 null */
-export declare function queryAtCaret(): string | null;

package/lib/types/host/actions.d.ts

@@ -1,34 +0,0 @@
-/**
- * 动作分发（handleAction，POST /api/group-chat/action 的载荷）：
- * mutate（12 种 CRUD/配置操作）| send | stop | confirmCommand | models | efforts。
- * @module dsh-group-chat/host/actions
- */
-import type { BrowseResult, Snapshot } from '../core/types.ts';
-import type { HostState } from './state.ts';
-/** 动作面。 */
-export interface Actions {
-    handleAction: (body: Record<string, unknown>) => Promise<unknown>;
-}
-/** 创建动作分发面。 */
-export declare function createActions(core: HostState, deps: {
-    touch: () => void;
-    snapshot: () => Snapshot;
-    schedulePersist: (targets?: {
-        ledger?: boolean;
-        session?: string | null;
-        roles?: string | null;
-        workspace?: string | null;
-    }) => void;
-    dropDirty: (targets: {
-        session?: string | null;
-        roles?: string | null;
-        workspace?: string | null;
-    }) => void;
-    appendMessage: import('./conversation.ts').Conversation['appendMessage'];
-    runLoop: import('./conversation.ts').Conversation['runLoop'];
-    wakeConfirm: () => void;
-    killChild: () => void;
-    browse: (args: {
-        path?: string;
-    } | undefined) => Promise<BrowseResult>;
-}): Actions;

package/lib/types/host/conversation.d.ts

@@ -1,25 +0,0 @@
-/**
- * 对话引擎：消息追加、群聊记录转写、角色发言（speak：prompt 构建 + 流式
- * 轮次 + 工具回注循环）、多轮 runLoop，以及会话标题/主题自动整理（retitle）。
- * @module dsh-group-chat/host/conversation
- */
-import type { MessageRecord, SessionRecord } from '../core/types.ts';
-import type { HostState } from './state.ts';
-import type { Materials } from './materials.ts';
-import type { Tools } from './tools.ts';
-/** 对话引擎面。 */
-export interface Conversation {
-    /** 追加一条消息到会话（touch + 落盘调度）。 */
-    appendMessage: (sess: SessionRecord, speaker: string, text: string, extra?: Partial<MessageRecord>) => MessageRecord;
-    /** 多轮 round-robin 主循环（send 触发；finally 复位 run）。 */
-    runLoop: (sess: SessionRecord) => Promise<void>;
-}
-/** 创建对话引擎。 */
-export declare function createConversation(core: HostState, deps: {
-    touch: () => void;
-    schedulePersist: (targets?: {
-        session?: string | null;
-    }) => void;
-    materials: Materials;
-    tools: Tools;
-}): Conversation;

package/lib/types/host/http.d.ts

@@ -1,16 +0,0 @@
-/**
- * Host HTTP 工具：回环信任栏（对齐 dsh-web shared/host/loopback.ts 语义 +
- * 浏览器同源标记栏）、有界 JSON 请求体读取、JSON 响应写出。
- * @module dsh-group-chat/host/http
- */
-import type { IncomingMessage, ServerResponse } from 'node:http';
-/**
- * 请求级信任栏：浏览器同源标记（sec-fetch-site / Origin）必须存在且回环
- * socket + 回环 Host 全过；X-Forwarded-For 一律不信任。无任何同源标记的
- * 非浏览器请求（如裸 curl）一律拒绝。
- */
-export declare function isTrustedRequest(req: IncomingMessage): boolean;
-/** 读有界 JSON 请求体；超限抛 'body-too-large'（路由映射 413）。 */
-export declare function readBody(req: IncomingMessage): Promise<unknown>;
-/** 写 JSON 响应；调用方可追加/覆盖默认头。 */
-export declare function writeJson(res: ServerResponse, status: number, body: unknown, headers?: Record<string, string | number>): void;

package/lib/types/host/materials.d.ts

@@ -1,32 +0,0 @@
-/**
- * 资料读取与路径解析：群组工作区目录 → 注入文件清单 + 目录浏览器。
- * 路径解析顺序：~ 展开到 home；绝对路径直用；相对路径先试各工作区根，
- * 再试 dsh web 进程 cwd。目录浏览器与资料读取共用同一套解析。
- * @module dsh-group-chat/host/materials
- */
-import type { BrowseResult, GroupRecord } from '../core/types.ts';
-import type { HostState } from './state.ts';
-/** 资料面。 */
-export interface Materials {
-    /** 群组工作区目录 → 注入文件清单（dir 为解析后的展示路径）。 */
-    loadWorkspaceFiles: (g: GroupRecord) => Promise<{
-        dir: string;
-        parts: {
-            name: string;
-            content: string;
-            error?: string;
-        }[];
-    }>;
-    /** 文件清单 → system 提示词内的「共享资料」块（单文件 16k / 总量 48k 截断）。 */
-    materialBlock: (parts: {
-        name: string;
-        content: string;
-        error?: string;
-    }[], dir: string) => string;
-    /** 目录浏览：返回文件+目录条目（绝对路径由 Host 解析，客户端不拼路径）。 */
-    browse: (args: {
-        path?: string;
-    } | undefined) => Promise<BrowseResult>;
-}
-/** 创建资料面。 */
-export declare function createMaterials(core: HostState): Materials;

package/lib/types/host/persistence.d.ts

@@ -1,31 +0,0 @@
-/**
- * 持久化（PERSISTENCE.md v2.1）：事件驱动脏标记合并落盘 + 启动恢复。
- * 锁失败/写失败时降级为内存态运行（console 告警）。
- * @module dsh-group-chat/host/persistence
- */
-import type { HostState } from './state.ts';
-/** 持久化面。 */
-export interface Persistence {
-    /** 事件驱动落盘；同一 tick 内多次变更合并为一次写。 */
-    schedulePersist: (targets?: {
-        ledger?: boolean;
-        session?: string | null;
-        roles?: string | null;
-        workspace?: string | null;
-    }) => void;
-    /** 同步 flush：写全部脏文件（dispose 最终落盘用）。 */
-    flushNow: () => void;
-    /** 删除群组/会话后摘除脏标记（对应文件已删/将删，flush 跳过）。 */
-    dropDirty: (targets: {
-        session?: string | null;
-        roles?: string | null;
-        workspace?: string | null;
-    }) => void;
-    /** dispose：同步最终 flush → 释放锁 → 摘除句柄。 */
-    release: () => void;
-}
-/**
- * 创建持久化面：构造即完成 store 初始化 + hydrate（v1 迁移 → 残留清理 →
- * 清单 → 群组数据 → 会话文件；缺文件空重建；补建默认会话/群组立即落盘）。
- */
-export declare function createPersistence(core: HostState): Persistence;

package/lib/types/host/routes.d.ts

@@ -1,11 +0,0 @@
-/**
- * HTTP 路由（经 webServer 暴露）：
- *   GET  /api/group-chat/state   全量快照
- *   POST /api/group-chat/action   { kind: mutate|send|stop|models|preview, ... }
- *   GET  /api/group-chat/events   SSE，状态变化时推送节流后的全量快照
- * @module dsh-group-chat/host/routes
- */
-import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
-import type { GroupChatService } from './service.ts';
-/** 构建群聊的三条 HTTP 路由。 */
-export declare function makeGroupChatRoutes(service: GroupChatService): WebRoute[];

package/lib/types/host/store.d.ts

@@ -1,65 +0,0 @@
-/**
- * 持久化（PERSISTENCE.md v2.1：会话级文件隔离）。
- *
- * 目录布局（每群组一目录，一会话一文件）：
- *   <dir>/ledger.json                              群组/会话清单（schema 3，纯清单，pretty；群组含 permissionTier）
- *   <dir>/<group-id>/workspaceDir                  工作区目录设置（纯文本一行）
- *   <dir>/<group-id>/roles.json                    群组角色（schema 1，紧凑）
- *   <dir>/<group-id>/sessions/session-<uuid>.json   会话（schema 1，自包含，紧凑）
- *
- * 原子写 tmp+fsync+rename（每目录一次 fsync）；单实例 .lock；损坏隔离重建；
- * 写失败保留脏标记；v1 自动迁移。
- * @module dsh-group-chat/host/store
- */
-import type { GroupRecord } from '../core/types.ts';
-/** DSH 主目录；DSH_GROUP_CHAT_STORE 供测试覆盖存储位置。 */
-export declare const DSH_HOME: string;
-/** 存储根目录。 */
-export declare const STORE_DIR: string;
-/** 会话文件名 → 会话 id。 */
-export declare function sessionFileMatch(name: string): string | null;
-export declare class Store {
-    readonly dir: string;
-    readonly ledgerFile: string;
-    private readonly lockFile;
-    private lockFd;
-    constructor(dir: string);
-    groupDir(groupId: string): string;
-    sessionsDir(groupId: string): string;
-    sessionFile(groupId: string, sessionId: string): string;
-    rolesFile(groupId: string): string;
-    workspaceFile(groupId: string): string;
-    private acquireLock;
-    release(): void;
-    fsyncDir(dir: string): void;
-    /** 原子写：tmp+fsync+rename；目录 fsync 由调用方按 flush 批量执行（每目录一次）。 */
-    atomicWrite(file: string, text: string): void;
-    quarantine(file: string): void;
-    /** 读 JSON；缺失返回 null；损坏则隔离后返回 null。 */
-    loadJson(file: string): unknown;
-    readWorkspace(groupId: string): string;
-    /** hydrate 残留清理：.tmp-* 删除；同前缀 .corrupt-* 只保留最近 1 份。 */
-    cleanup(): void;
-    /** v1（ledger+messages 双文件）→ v2 一次性迁移；幂等，messages.json 只归档从不删除。 */
-    migrateV1(): void;
-}
-/** ledger 清单的读取形态（hydrate 用；allowCommands 为 v2 遗留字段，读取时经 migrateTier 迁移）。 */
-export interface LedgerDocument {
-    schema?: number;
-    groups?: {
-        id: string;
-        name?: string;
-        permissionTier?: string;
-        allowCommands?: boolean;
-    }[];
-    sessions?: {
-        id: string;
-        groupId: string;
-    }[];
-}
-/** 从磁盘目录回收群组 id 列表（ledger 缺失/损坏时的兜底路径）。 */
-export declare function scanGroupIds(dir: string): string[];
-/** 扫描群组目录下的会话文件（ledger 缺失/损坏时的兜底路径）。 */
-export declare function scanSessionIds(store: Store, groupId: string): string[];
-/** 空群组记录构造（hydrate 兜底路径用）。 */
-export declare function emptyGroup(id: string, name: string): GroupRecord;

package/lib/types/host/tools.d.ts

@@ -1,28 +0,0 @@
-/**
- * 工具执行（TOOLS.md §2：沙箱 / §3：确认闸门）：read_file / list_dir /
- * run_command 三件套；realpath 硬边界 + 分隔符比较；run_command 按群组
- * 权限档位走逐条确认或直接执行。
- * @module dsh-group-chat/host/tools
- */
-import { TOOL_SCHEMAS } from '../core/tools.ts';
-import type { GroupRecord, ToolExecution } from '../core/types.ts';
-import type { HostState } from './state.ts';
-/** 工具面。 */
-export interface Tools {
-    /** 执行一次工具调用（args 解析 + 分发 + 计时；确认闸门在 run_command 内）。 */
-    executeTool: (g: GroupRecord, root: string, tc: {
-        id: string;
-        name: string;
-        args: string;
-    }) => Promise<ToolExecution>;
-    /** 工具 schema（view_only 档剔除 run_command）。 */
-    buildToolSchemas: (g: GroupRecord) => (typeof TOOL_SCHEMAS)[number][];
-    /** 置 pendingConfirm 后无限等待，confirmCommand/stop/dispose 唤醒。 */
-    requestConfirmation: (toolCallId: string, args: Record<string, unknown>) => Promise<boolean>;
-    /** 唤醒确认等待（以拒绝放行；置空 pendingConfirm）。 */
-    wakeConfirm: () => void;
-    /** kill 正在执行的命令子进程。 */
-    killChild: () => void;
-}
-/** 创建工具面。 */
-export declare function createTools(core: HostState, touch: () => void): Tools;