@yumiai/chat-widget 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { RefObject } from 'react';
-import { k as ProvenanceGraphSnapshot, a as ChatWidgetMessages, C as ChatWidgetLocale } from './GraphStatsLegend-D5bPeXB_.js';
-export { E as EdgeType, F as FetchGraphOptions, b as FilterBar, G as GraphBuilder, c as GraphEdge, d as GraphFilter, e as GraphSSEPayload, f as GraphStatsLegend, g as GraphToolbar, N as NodeDetailPanel, h as NodeType, P as ProvenanceGraph3D, i as ProvenanceGraphDrawerContent, j as ProvenanceGraphFetcher, l as ProvenanceNode, m as fetchProvenanceGraph, r as resolveMessages, u as useProvenanceGraph } from './GraphStatsLegend-D5bPeXB_.js';
+import { k as ProvenanceGraphSnapshot, a as ChatWidgetMessages, C as ChatWidgetLocale } from './GraphStatsLegend-CV0Y3-cP.js';
+export { E as EdgeType, F as FetchGraphOptions, b as FilterBar, G as GraphBuilder, c as GraphEdge, d as GraphFilter, e as GraphSSEPayload, f as GraphStatsLegend, g as GraphToolbar, N as NodeDetailPanel, h as NodeType, P as ProvenanceGraph3D, i as ProvenanceGraphDrawerContent, j as ProvenanceGraphFetcher, l as ProvenanceNode, m as fetchProvenanceGraph, r as resolveMessages, u as useProvenanceGraph } from './GraphStatsLegend-CV0Y3-cP.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 export { J as JsonRenderActionHandler, a as JsonRenderStandalone, b as JsonRenderStandaloneProps } from './JsonRenderStandalone-UsTcST4G.js';
 
@@ -12,7 +12,13 @@ type NotificationType = 'user_input' | 'node_notification' | 'start' | 'model_st
  | 'session_title'
 /** JETP-073：client（"办公室"）级 LLM 起名 notification。controller 派发为
  *  ``ClientTitleEvent``；上游消费方按 ``client_id`` 增量更新本地 cache。 */
- | 'client_title' | 'compression_started' | 'compression_completed' | 'node_summary';
+ | 'client_title' | 'compression_started' | 'compression_completed' | 'node_summary'
+/** JETP-084 T-4.1 / T-5.5b: paragraph-level RAG provenance. Emitted right
+ *  before MODEL_END for any LLM turn that consumed read-tool output. Content
+ *  is a `CitationContextEvent` (see `provenance/rag/types.ts`) carrying the
+ *  set of files cited in this message so the frontend can preload sidecars
+ *  and render Chips. */
+ | 'citation_context';
 interface UiConfig {
     display_type: 'content' | 'command' | 'browser' | 'query' | 'path' | 'trigger' | 'thinking' | 'params';
     icon?: string;
@@ -70,6 +76,27 @@ interface SSEMessage {
      * 旧后端不下发 → undefined → 不做 echo 抑制，回退到 Phase 1-5 行为 (AC-CONN-008)。
      */
     connection_id_from?: string;
+    /**
+     * @deprecated JETP-084 v3 (Phase 10) — embedded citation_context in
+     * NodeNotification.ext was deleted. v3 emits an independent
+     * ``CITATION_CONTEXT`` SSE notification from the read tool. The field
+     * is retained on the type for one release so call sites mid-migration
+     * compile; new code should ignore it.
+     *
+     * Historical (deleted) v2 path:
+     * Phase 9 embedded the citation_context payload into
+     * ``notification.ext.citation_context`` for non-streaming carriers
+     * so the controller could ingest keyed by the frontend's own
+     * ``messageKey`` (= ``msg.id``) — sidestepping the
+     * ID-alignment failure mode of the legacy standalone event.
+     *
+     * Shape: ``{ message_id: string (server-side debug hint), files: CitationContextFile[] }``.
+     * The frontend ignores ``message_id`` and uses the local messageKey instead.
+     *
+     * Absent on streaming notifications (covered by the legacy
+     * standalone CITATION_CONTEXT event + global Solution B fallback).
+     */
+    citation_context?: unknown;
 }
 interface PlanItem {
     text: string;
@@ -298,6 +325,13 @@ interface Round {
     endedAgentInstanceIds?: Set<number>;
     /** JETP-045 Layer 1：客户端连接子空间标识。 */
     clientId?: string;
+    /**
+     * 本轮是否由真实用户消息发起（存在 user_input）。用于置顶区/钉选时区分
+     * 「用户提问 round」与「无用户输入的续作 round」（如后端下发的 genui/a2ui round，
+     * 历史模式下其 userMessage 会被填成占位文案 "(历史消息)"，不能据此误判为有用户消息）。
+     * 缺省（undefined）按旧逻辑信任 userMessage。
+     */
+    hasUserMessage?: boolean;
 }
 type ExecutionStatus = 'idle' | 'running' | 'compressing' | 'completed' | 'error';
 interface ChatWidgetConfig {
@@ -469,6 +503,31 @@ interface ModelOverride {
     scope?: 'root' | 'all';
     settings?: Record<string, unknown>;
 }
+/**
+ * 单个 ``model_id`` 折叠后的能力位。字段名严格匹配 hip ``Capabilities`` DTO。
+ */
+interface ModelCapabilities {
+    /** 模型接受用户消息中的图像块（OpenAI ``image_url`` / Anthropic ``input_image``）。 */
+    imageInput: boolean;
+    /** 模型接受音频块（少数模型，如 Gemini multimodal、4o-audio）。 */
+    audioInput: boolean;
+    /** 模型接受视频块（Gemini family）。 */
+    videoInput: boolean;
+    /** 模型支持工具调用（OpenAI ``tools`` / Anthropic ``tool_use``）。 */
+    functionCall: boolean;
+    /** 模型支持流式响应。绝大多数 chat completion 模型都 true。 */
+    streaming: boolean;
+}
+/**
+ * ``GET /api/v1/models/capabilities`` 响应；``items`` key = ``channel/model_name``
+ * （与 ``ModelListItemRaw.id`` 完全一致）。
+ *
+ * 调用方约定：取不到的 model_id 应当默认按全 ``false`` 处理（保守门控）。
+ */
+interface ListModelCapabilitiesResponse {
+    items: Record<string, ModelCapabilities>;
+    total: number;
+}
 /**
  * 单条模型记录，等价于 hip ``Model`` DTO。每条 = 一个 (channel, model_name) 对。
  *
@@ -587,7 +646,20 @@ interface ListModelsParams {
     groupBy?: 'basename' | 'name' | 'none';
 }
 interface ChatWidgetAPI {
-    sendMessage: (message: string, agentId?: string, inlineRefs?: FileReference[], selectedSkills?: SelectedSkillRef[], overrideInstanceId?: number | null, clientId?: string, fileAttachments?: FileAttachment[], modelOverride?: ModelOverride | null) => void | Promise<void>;
+    /**
+     * 发送一条用户消息。
+     *
+     * 第 9 个参数 ``modelCapabilities`` 是 JETP-multimodal 引入的"目标模型能力位"
+     * 转发通道：DefaultComposer / 自定义 footer 在用户挑选模型后用
+     * ``useModelCapabilities`` 解出当前 model 的 caps，然后跟 ``modelOverride`` 一起
+     * 透到这里；controller 把它原样传给 ``adapter.buildStreamBody``，由 adapter
+     * 决定是否把 image 附件折成 ``image_url`` 协议块。
+     *
+     * 不传 / null → adapter 视为"未知能力，保守不发图"，与未升级前的行为完全一致。
+     * 调用方**不应**自行猜测 caps（"我看模型名带 vision 就传 imageInput=true"）：
+     * 数据源唯一是 hip-server，前端 useModelCapabilities 已经处理了缓存 / 失败兜底。
+     */
+    sendMessage: (message: string, agentId?: string, inlineRefs?: FileReference[], selectedSkills?: SelectedSkillRef[], overrideInstanceId?: number | null, clientId?: string, fileAttachments?: FileAttachment[], modelOverride?: ModelOverride | null, modelCapabilities?: ModelCapabilities | null) => void | Promise<void>;
     getCurrentRound: () => Round | null;
     getAllRounds: () => Round[];
     scrollToBottom: () => void;
@@ -638,6 +710,19 @@ interface ChatWidgetAPI {
         removeFile: (resourceId: string) => void;
         clear: () => void;
         enabled: boolean;
+        /**
+         * JETP-multimodal: 主动刷新一组（或全部 image）附件的预签名 URL。
+         *
+         * 何时调：
+         *   - send 前的"过期保护"：buildStreamBody 之前检查 ``imageUrlExpiresAt``，
+         *     如果距过期 < safety_margin（默认 5 分钟），先把这些 URL 刷一遍再上行；
+         *   - 用户长时间打字（>= 30min）后再发送的兜底；
+         *   - retry：上次 send 因 URL 401 失败的恢复路径。
+         *
+         * 不传 ``resourceIds`` → 刷新所有 ready 的 image MIME 附件。
+         * adapter 缺 ``getResourceUrls`` 时本方法 no-op（返回已 resolved 的 Promise）。
+         */
+        refreshUrls: (resourceIds?: string[]) => Promise<void>;
     };
 }
 interface ToolCallData {
@@ -997,6 +1082,16 @@ interface ChatWidgetAdapter {
          * 详见 ``ModelOverride``。
          */
         modelOverride?: ModelOverride | null;
+        /**
+         * JETP-multimodal: 目标模型的能力位，由 Composer 端 ``useModelCapabilities``
+         * 解析得到。adapter 仅在 ``imageInput=true`` 时才把 image 附件折成
+         * ``{type: 'image_url', ...}`` 协议块下发；其他情况只走文本 marker。
+         *
+         * 缺省 / null → adapter 视为"未知能力，保守不发"，与未升级前的行为完全一致。
+         * 这条门控**必须**由前端兜底：``ImagePart.to_serializable`` 在 IMAGE 类型
+         * 上强依赖 ``uri`` 非空，下游不能再做"宽容"。
+         */
+        modelCapabilities?: ModelCapabilities | null;
     }): object;
     listSkills?(params?: SkillListParams): Promise<SkillListResponse>;
     onAuthFailure?(): void;
@@ -1079,6 +1174,49 @@ interface ChatWidgetAdapter {
     listModels?<TGroup extends 'basename' | 'name' | 'none' = 'basename'>(params?: ListModelsParams & {
         groupBy?: TGroup;
     }): Promise<ListModelsResponse<TGroup extends 'basename' ? ModelListItemBasenameGrouped : TGroup extends 'name' ? ModelListItemGrouped : ModelListItemRaw>>;
+    /**
+     * 拉取"模型能力位"全表 / 子集。**唯一来源**是 hip-server
+     * ``GET /api/v1/models/capabilities``，**不走 fusion / model-lake 直连**。
+     *
+     * 行为约定：
+     *   - 不传 ``modelIds`` → 返回所有 active model 的能力位（开发态调试 / 后台批量）；
+     *   - 传 ``modelIds`` → 仅这几个；hip 端保证未命中的 id 实化为全 false 而不是省略；
+     *   - 网络 / 5xx → 抛 ``ChatWidgetNetworkError``，让 UI 决定降级
+     *     （**不要**在 adapter 层兜成 ``{}`` —— 错误"撒谎成 false"会误导多模态 UI）。
+     *
+     * 当 adapter 不实现该方法时，上层 ``useModelCapabilities`` 返回全 false 的
+     * ``EMPTY_CAPS``。这只影响 ``adapter.buildStreamBody`` **是否把附件折成**
+     * ``image_url`` / ``audio`` / ``video_url`` 协议块；并**不**影响附件是否能
+     * 上传 —— Composer 任何时候都不会因为 caps 缺失而拒收文件，未折成协议块的
+     * 附件仍以"文本 marker（resourceId）" 形态参与，由 KG / 工作空间工具 / agent
+     * 文字阅读兜底消费。
+     */
+    listModelCapabilities?(modelIds?: string[]): Promise<ListModelCapabilitiesResponse>;
+    /**
+     * JETP-multimodal: 批量获取一组 ``resource_id`` 的访问 URL + MIME + 过期时间。
+     *
+     * **唯一来源**是 jetagents KG ``GET /api/knowledge/workspace/files`` (带
+     * ``generate_urls=true``)；KG 已经按 ``access_mode=private`` 生成 MinIO 预签名
+     * URL（默认 1h TTL）。
+     *
+     * 设计取舍：
+     *   - 批量 vs. 逐个 ``getResourceUrl``：后者每次都列全表，N 张图片就 N 次 O(N)
+     *     扫表；批量一次拿全部，明显省网络。
+     *   - 返回 Map<rid, {url, mimeType, expiresAtMs}>：调用方一般要按 rid 反查，
+     *     用 Map 比 Array 直接；未命中的 rid 直接缺 key（让上层显式处理）。
+     *   - ``expiresAtMs`` 由 adapter 当场用 ``Date.now() + url_expires_in*1000``
+     *     算出来。把"相对秒数 → 绝对时刻"的归一化做在 adapter 层，hook 这一侧
+     *     只做"now > expiresAtMs - safety → 重拉"的判断，逻辑收敛。
+     *
+     * 当 adapter 不实现该方法时，``useFileUpload`` 不会去拉 URL，附件依旧能正常
+     * 上传 / 在文本 marker 形态出现，只是图片缩略图 + 多模态 image_url 协议块
+     * 都不会出现（fail-safe 到"老链路"）。
+     */
+    getResourceUrls?(sessionId: number, resourceIds: string[]): Promise<Map<string, {
+        url: string;
+        mimeType?: string;
+        expiresAtMs?: number;
+    }>>;
     /**
      * 按 ``agentId`` 查询该 agent 在后端注册的默认模型，**仅用于 picker 展示态**。
      *
@@ -1269,6 +1407,25 @@ interface UploadedFileInfo {
     status: 'uploading' | 'processing' | 'ready' | 'error';
     progress?: string;
     error?: string;
+    /**
+     * JETP-multimodal: 与 ``FileAttachment.mimeType`` 同义；upload 时由 localFile.type
+     * 兜底，ready 后被 ``getResourceUrls`` 返回的权威 mime 覆盖。
+     */
+    mimeType?: string;
+    /**
+     * JETP-multimodal: 与 ``FileAttachment.imageUrl`` 同义；只对 image MIME 文件填充。
+     * 状态 'uploading' / 'processing' 期间为 undefined；'ready' 后异步填充
+     * （拉 KG URL 期间维持 undefined → 上层不应假设 ready ⇒ imageUrl 已就绪，
+     * 而是看 ``imageUrlExpiresAt > now`` 判断"可用且未过期"）。
+     */
+    imageUrl?: string;
+    /** JETP-multimodal: 与 ``FileAttachment.imageUrlExpiresAt`` 同义。 */
+    imageUrlExpiresAt?: number;
+    /**
+     * JETP-multimodal: ``true`` 表示当前正在拉 / 刷新 URL；UI 可据此显示 loading
+     * 缩略图占位，避免"已 ready 但 url 还在路上"造成的闪烁。
+     */
+    imageUrlRefreshing?: boolean;
 }
 interface FileUploadResult {
     status?: 'accepted' | 'partial_success' | 'failed';
@@ -1315,6 +1472,32 @@ interface FileAttachment {
     resourceId: string;
     fileName: string;
     gitPath?: string;
+    /**
+     * JETP-multimodal: 已签名 / 公开可读的图片 URL（KG presigned 或 public），
+     * 仅对 ``mimeType`` 以 ``image/`` 开头的附件填充。``buildStreamBody`` 在判定
+     * 目标模型支持 ``image_input`` 时，会把这个 URL 拼到 ``contents`` 的
+     * ``{ type: 'image_url', ... }`` 协议块里。
+     *
+     * 取舍：附带 URL 不依赖目标模型是否支持图像 —— **能力门控发生在 send 时**，
+     * 不在 upload 时；这样用户切换模型不需要重新拉 URL，体验更流畅。
+     * 模型不支持时，附件仍会以 ``[附件: fn | resource_id: rid]`` 文本 marker
+     * 形态出现在 message 中（与历史行为一致），让 agent / 工具仍能从 workspace
+     * 通过 resource_id 拿文件。
+     */
+    imageUrl?: string;
+    /**
+     * JETP-multimodal: ``imageUrl`` 的预期过期时刻（unix ms）。KG presigned URL
+     * 默认 1h；前端在 send 前会对"距过期 < safety_margin"的 URL 触发刷新。
+     */
+    imageUrlExpiresAt?: number;
+    /**
+     * JETP-multimodal: 文件 MIME（KG 已识别）；用于：
+     *   1. Composer 判定 image 缩略图 vs. 普通附件 chip；
+     *   2. buildStreamBody 用 ``image/`` 前缀决定是否参与多模态组装。
+     *
+     * 缺省 → 走"非 image"路径，与历史行为一致。
+     */
+    mimeType?: string;
 }
 declare function mergeConsecutiveThinkMessages(messages: AggregatedMessage[]): AggregatedMessage[];
 interface TodoCardProps {
@@ -1568,7 +1751,7 @@ interface ChatWidgetControllerState {
     }>;
     /** JETP-083 WS3.7.5 — terminal lifecycle markers (cancelled/error) by spec_id. */
     specLifecycleMap: Map<string, SpecLifecycleEntry>;
-    sendMessage: (message: string, agentId?: string, inlineRefs?: FileReference[], selectedSkills?: SelectedSkillRef[], overrideInstanceId?: number | null, clientId?: string, fileAttachments?: FileAttachment[], modelOverride?: ModelOverride | null) => Promise<void>;
+    sendMessage: (message: string, agentId?: string, inlineRefs?: FileReference[], selectedSkills?: SelectedSkillRef[], overrideInstanceId?: number | null, clientId?: string, fileAttachments?: FileAttachment[], modelOverride?: ModelOverride | null, modelCapabilities?: ModelCapabilities | null) => Promise<void>;
     widgetAPI: ChatWidgetAPI;
     /** Agent instance states tracked via WS status stream. Empty map when SSE transport. */
     agentStates: Map<number, AgentInstanceState>;
@@ -1942,11 +2125,26 @@ interface UseFileUploadReturn {
     addFiles: (files: File[]) => void;
     removeFile: (resourceId: string) => void;
     clear: () => void;
+    /**
+     * JETP-multimodal: 主动刷新一组（或全部 image/audio/video）附件的预签名 URL。
+     *
+     * 行为：
+     *   - 不传 ``resourceIds`` → 默认刷新所有 ``status='ready'`` 且 ``mimeType``
+     *     属于多模态大类（image / audio / video）的附件；
+     *   - adapter 未实现 ``getResourceUrls`` → no-op（resolved Promise）。
+     *
+     * 与 ``addFiles`` 内部的 first-fetch 共用底层 ``_fetchAndApplyMediaUrls`` 助手，
+     * 保证两条路径走完全相同的拉取 + 写回逻辑。
+     */
+    refreshUrls: (resourceIds?: string[]) => Promise<void>;
 }
 /**
- * JETP-040: Shared hook managing the two-step file upload lifecycle.
+ * JETP-040 (multimodal extension): Shared hook managing the two-step file upload lifecycle.
  * 1. Upload files via adapter.uploadFiles() -> get resource IDs
  * 2. Poll adapter.getUploadStatus() until all files are 'ready' or 'error'
+ * 3. (multimodal) For image MIME attachments, fetch ``imageUrl`` via
+ *    ``adapter.getResourceUrls()`` so Composer can render thumbnails and
+ *    ``buildStreamBody`` can emit ``{type: 'image_url', ...}`` content blocks.
  */
 declare function useFileUpload(options: UseFileUploadOptions): UseFileUploadReturn;
 
@@ -2668,6 +2866,12 @@ interface RichInputHandle {
     insertSkillChip: (skill: SkillSummary) => void;
     focus: () => void;
     clear: () => void;
+    /**
+     * 用纯文本替换编辑器全部内容（chip 也会被清掉）。
+     * 适用于"外部 prefill"场景：scenario 卡片 → 灌词 → 让用户继续编辑。
+     * 调用后光标自动移到末尾。
+     */
+    setText: (text: string) => void;
     getText: () => string;
     getReferences: () => FileReference[];
     getSkills: () => SkillSummary[];
@@ -2709,6 +2913,83 @@ interface RichInputProps {
 }
 declare const RichInput: React__default.ForwardRefExoticComponent<RichInputProps & React__default.RefAttributes<RichInputHandle>>;
 
+/**
+ * Model 启发式分类：vendor（厂商家族）+ modality（模态/能力）。
+ *
+ * 为什么是"启发式"：
+ *   model-lake `/unified/v1/models` 当前只透出 ``(channel, model_name)`` 二元组，
+ *   没有 modality / family 元信息。给前端 picker 做"按家族分组 + 按模态过滤"两个
+ *   高 ROI 功能需要这两个轴，要么 (A) 后端先加 schema，要么 (B) 前端从 basename
+ *   推断。我们选 (B) —— 一来 basename 命名在我们这套 model-lake 里有很强规律
+ *   （openai-* / gemini-* / anthropic-claude-* / qwen-* / glm-* …），前端推断
+ *   覆盖率 > 95%；二来这一层完全本地，不阻塞 picker UX 改进。
+ *
+ * 后续如果要把这两个轴升级到"后端权威"：
+ *   - hip-server BasenameVariant / BasenameGrouped 加 ``vendor`` / ``modality`` 字段；
+ *   - 本文件 ``vendorOf`` / ``modalityOf`` 改成"优先读 BasenameGrouped 注入的字段，
+ *     回落到本地启发式"，调用方代码不动。
+ *
+ * 不在这里做：
+ *   - 不做"模型质量评分 / 推荐度"——那属于 product policy，不是 UI 分类；
+ *   - 不做 vendor → modality 反向硬绑（``anthropic`` 只能聊天）——上下文是开放的，
+ *     未来 anthropic 出图像模型时不应该被前端误归类。匹配独立、各自负责。
+ *
+ * 测试：``modelClassifier.test.ts`` 把我们 model-lake 里真实出现过的 basename
+ * 全部跑一遍，确保归类稳定。
+ */
+/** 已识别的 vendor 家族 id；``'other'`` 是 catch-all。 */
+type VendorId = 'openai' | 'anthropic' | 'google' | 'xai' | 'alibaba' | 'zhipu' | 'moonshot' | 'bytedance' | 'deepseek' | 'minimax' | 'openrouter' | 'xiaomi' | 'other';
+/**
+ * Vendor 显示顺序（picker 默认渲染顺序）。
+ * 排序原则：用户活跃度高的几家在前；尾巴留 openrouter / xiaomi / other。
+ * 修改顺序 = 修改 picker 默认视觉次序；不要轻易动，做 A/B 时改这里就行。
+ */
+declare const VENDOR_ORDER: readonly VendorId[];
+/**
+ * 把 basename 归到一个 ``VendorId``；无匹配 → ``'other'``。
+ *
+ * **不要**用这个返回值去做发送态的路由决策——它只是 UI 分组标签，可能误判
+ * （如某天 openrouter 命名调整把 anthropic 词缀挪到中间）。发送依然走
+ * variant.name 原值。
+ */
+declare function vendorOf(basename: string): VendorId;
+/**
+ * 模态/能力轴：
+ *   - chat:      普通对话（默认 catch-all，所有未匹配到具体模态的回落到这里）
+ *   - image:     图像生成 / 编辑
+ *   - video:     视频生成
+ *   - audio:     TTS / STT / 音乐
+ *   - embedding: 文本向量
+ *   - realtime:  双向流式语音（OpenAI Realtime / Gemini Live 等）
+ *
+ * 我们故意**不**把"reasoning"做成独立模态——它是 ``chat`` 的一种子能力，
+ * 用户在 picker 这一层不需要切到独立 tab；后续如果要做能力 chip（"reasoning"
+ * "thinking" "vision"），那是行内 badge，不是 tab。
+ */
+type ModalityId = 'chat' | 'image' | 'video' | 'audio' | 'embedding' | 'realtime';
+/** 模态显示顺序（tab 渲染顺序）。 */
+declare const MODALITY_ORDER: readonly ModalityId[];
+/**
+ * 把 basename 归到一个 ``ModalityId``；无匹配 → ``'chat'``（catch-all）。
+ *
+ * 把 chat 作为默认是有意的：99% 用户来 picker 是为了聊天，把不确定的归到 chat
+ * 让他们最容易看到。误归造成"应该在 image tab 里的模型出现在 chat tab"的代价
+ * 远小于"漏归造成模型被完全过滤掉"。
+ */
+declare function modalityOf(basename: string): ModalityId;
+/**
+ * 极轻量级模糊匹配：把 query 和 basename 都归一化后做 substring 检测，
+ * 同时保留"按空格拆词、每个词都要命中"的 AND 语义。
+ *
+ * 选择不引入 fuse.js / fzf：
+ *   - 引入第三方搜索库会带来 ~12-30 kB gzip 增量，picker 只过滤 173 项，性价比低；
+ *   - 真正影响用户体验的是"输入即筛"而不是"模糊容错"；我们的 basename 命名都很规整，
+ *     用户记住前几个字符的概率远高于"打错字"。
+ *
+ * 返回 ``true`` 表示 basename 命中 query。空 query 视为全命中。
+ */
+declare function basenameMatchesQuery(basename: string, query: string): boolean;
+
 /**
  * Model 注册表 / 持久化 helpers
  * --------------------------------------------------
@@ -2767,8 +3048,13 @@ declare function loadLastModelName(agentId: string): ModelChoice;
  * 写入该 agent 当前选择。``null`` / 空串 → 删除 key（恢复 AUTO）。
  * 静默失败（隐私模式 / 配额满都不应让 UI 崩）。
  *
- * **副作用**：第一次写入新 key 时顺便清掉旧的 v1 全局 key 与 yumiai 旧前缀 key，
+ * **副作用 1**：第一次写入新 key 时顺便清掉旧的 v1 全局 key 与 yumiai 旧前缀 key，
  * 避免不同浏览器下用户看到不同行为。幂等，重复执行无副作用。
+ *
+ * **副作用 2**：非 AUTO 写入同时把 ``name`` push 到 ``recentModels`` 的 FIFO，
+ * 让 picker 顶部"最近"区有数据。AUTO（null）不影响 recent —— recent 是"真实模型"
+ * 的快速回路。这两件事写在同一个函数里是有意为之：调用方（picker / loader 钩子）
+ * 只需关心"用户选了 X"，不必各自记得手动同步 recent。
  */
 declare function saveLastModelName(agentId: string, name: ModelChoice): void;
 
@@ -2781,23 +3067,32 @@ interface ModelPickerProps {
     compact?: boolean;
     /**
      * 当前 agent 在后端注册的默认模型 ``name`` —— **仅用于 picker 展示态**。
-     *
-     * 行为分两条线，必须分清：
-     *   · **展示态**：``value == null`` 且本字段命中清单时，trigger 文案 + AUTO 行 hint
-     *     都自动定位到该模型，让用户一眼看到"当前 agent 实际会用哪个 model"。
-     *   · **发送态**：``value == null`` 时**永远**不带 ``modelOverride``，由后端按 agent 默认走。
-     *
-     * null / undefined / 没命中清单 → picker 退化为"显示『默认模型』占位"。
+     * 见 v1 注释；语义不变。
      */
     agentDefaultModelName?: string | null;
     /**
-     * 是否允许触发 listModels 请求。默认 true。
-     * 游客态（未登录）使用：传 false → 内部 useModels enabled=false 不发请求，
-     * 同时 trigger 走 inert 分支，hover 提示"登录后可选模型"。
+     * 是否允许触发 listModels 请求。默认 true。游客态传 false → 走 inert 占位。
      */
     enabled?: boolean;
+    /**
+     * 当前 agent id，用于读取 per-agent "最近使用模型" FIFO。
+     * 不传 → recent 区不显示。
+     */
+    agentId?: string;
+    /**
+     * 允许展示的 vendor 子集；不传 → 全部。
+     * 留给上层（yumiai-web）做 agent-aware 裁剪：例如纯写代码的 agent 传
+     * ``['openai','anthropic','google']``。picker 自己不感知 agent 业务，
+     * 只做"清单 ∩ 白名单"。空数组 = 不裁剪（不要因为传了空数组而清空整个 picker）。
+     */
+    vendorWhitelist?: VendorId[];
+    /**
+     * 允许展示的 modality 子集；不传 → 全部。同 ``vendorWhitelist`` 设计。
+     * 例如"图像生成 agent"传 ``['image']`` 让 picker 只露图像模型。
+     */
+    modalityWhitelist?: ModalityId[];
 }
-declare function ModelPicker({ value, onChange, adapter, disabled, compact, agentDefaultModelName, enabled, }: ModelPickerProps): react_jsx_runtime.JSX.Element;
+declare function ModelPicker({ value, onChange, adapter, disabled, compact, agentDefaultModelName, enabled, agentId, vendorWhitelist, modalityWhitelist, }: ModelPickerProps): react_jsx_runtime.JSX.Element;
 
 interface UseModelsResult {
     items: ModelListItemBasenameGrouped[];
@@ -2828,6 +3123,13 @@ interface UseAgentDefaultModelResult {
     /** null = 没查到 / 还没拉 / adapter 不支持 / 拉失败（任何一种） */
     info: AgentDefaultModelInfo | null;
     loading: boolean;
+    /**
+     * 显式撬开缓存重拉。
+     *   - 不传参 → 刷当前 agentId；
+     *   - 传 ``aid`` → 定向刷指定 agent（用于"我刚通过别的渠道改了 agent-x 配置"）。
+     * 永不抛；失败被静默吞，配合 cache 不污染策略，对调用方就是"尽力而为"。
+     */
+    refresh: (aid?: string) => Promise<void>;
 }
 interface UseAgentDefaultModelOptions {
     /**
@@ -2842,6 +3144,57 @@ interface UseAgentDefaultModelOptions {
 }
 declare function useAgentDefaultModel(adapter: ChatWidgetAdapter, agentId: string | undefined, options?: UseAgentDefaultModelOptions): UseAgentDefaultModelResult;
 
+/**
+ * Per-agent 最近使用模型 FIFO 持久化。
+ *
+ * 与 ``modelRegistry.ts::loadLastModelName / saveLastModelName`` 的关系：
+ *   - ``loadLastModelName`` 维持 ``ModelChoice``（单值，AUTO=null）—— 那是 picker
+ *     "上一次选了什么"的语义，进 composer 时直接复用；
+ *   - 本模块维持的是 ``string[]``（最多 ``MAX_RECENT`` 条，最近使用在最前），
+ *     供 picker 把"频繁用的 N 个"置顶展示，让 173 个 basename 不必每次都扫一遍。
+ *
+ * 关键约束：
+ *   - **AUTO 不进 recent**：null / 空串不写入；recent 是给"真实模型"用的快速回路，
+ *     AUTO 永远在 picker 头部独占一行，没必要去 recent 占名额。
+ *   - **per-agent 分桶**：不同 agent 任务不同（写代码 / 看图 / 翻译），共享 recent
+ *     会污染。key = ``chat_widget_recent_models:${agentId}``。
+ *   - **静默失败**：localStorage 不可用（隐私模式、配额满）→ 全部 op 返回空数组，
+ *     不抛、不污染 UI 主链路。
+ *
+ * 不在这里做：
+ *   - 不做"按使用频次排序"（LRU 更复杂、收益边际）—— 严格 FIFO + dedup 已经覆盖
+ *     "用户最近几个高频选择"95% 的场景；
+ *   - 不做跨设备同步——那是 yumiai-web 自己的事（如果未来要做），SDK 这一层
+ *     只承诺浏览器本地。
+ */
+/** 默认最大保存条数；调用方可在 ``pushRecent`` / ``loadRecent`` 时覆盖。 */
+declare const MAX_RECENT = 5;
+/**
+ * 读取该 agent 的最近使用模型列表（最近在前）。
+ * 永远返回数组，失败 / 空 → ``[]``。
+ */
+declare function loadRecent(agentId: string, max?: number): string[];
+/**
+ * 把 ``name`` 推到 recent 列表头部。
+ *
+ * 语义：
+ *   - 空串 / null → no-op（不破坏现有列表）；AUTO 选择不进 recent；
+ *   - 已存在则提到头部（dedup）；
+ *   - 超出 cap 的尾部自动 drop。
+ *
+ * 失败静默。
+ */
+declare function pushRecent(agentId: string, name: string | null | undefined, max?: number): void;
+/** 清空该 agent 的 recent 列表。 */
+declare function clearRecent(agentId: string): void;
+
+declare const I18nContext: React$1.Context<ChatWidgetMessages>;
+declare function useChatWidgetI18n(): {
+    messages: ChatWidgetMessages;
+    t: (key: keyof ChatWidgetMessages, params?: Record<string, string | number>) => string;
+    locale: ChatWidgetLocale;
+};
+
 /**
  * DefaultComposer — SDK 默认的对话输入组件。
  *
@@ -2922,6 +3275,22 @@ interface DefaultComposerProps {
      * 默认 true；游客态宿主可置 false 完全跳过请求。
      */
     enableAgentDefaultModelLookup?: boolean;
+    /**
+     * ModelPicker agent-aware 裁剪 —— 仅展示这些 vendor 家族。
+     * 不传 / 空数组 → 不裁剪（picker 展示全部 vendor）。
+     *
+     * 例：纯写代码 agent 传 ``['openai','anthropic','google']``。
+     * 由宿主（yumiai-web）按当前 agent 元数据决定，SDK 这一层不做业务判断。
+     */
+    modelVendorWhitelist?: VendorId[];
+    /**
+     * ModelPicker 能力轴裁剪 —— 仅展示这些 modality（chat/image/video/audio/embedding/realtime）。
+     * 不传 / 空数组 → 不裁剪。
+     *
+     * 例："图像生成 agent" 传 ``['image']`` 让 picker 只露图像模型，
+     * 避免用户在 sora/veo/imagen 中误选了普通对话模型。
+     */
+    modelModalityWhitelist?: ModalityId[];
 }
 declare const DefaultComposer: React__default.FC<DefaultComposerProps>;
 
@@ -3137,6 +3506,20 @@ declare class DefaultJetAgentsAdapter implements ChatWidgetAdapter {
          * 后端按 agent 注册的默认 ``ModelMeta`` 走（与历史完全一致）。
          */
         modelOverride?: ModelOverride | null;
+        /**
+         * JETP-multimodal: 目标模型能力位（由 Composer 端的 ``useModelCapabilities``
+         * 解析得到）。仅决定**附件折成哪种协议块**，不参与 accept/reject。
+         *
+         *   - ``imageInput`` → image/* 折成 ``{type:'image_url', uri:<resource_id>, content:<URL>}``
+         *   - ``audioInput`` → audio/* 折成 ``{type:'audio',     uri:<resource_id>, content:<URL>}``
+         *   - ``imageInput || videoInput`` → video/* 折成 ``{type:'video_url', uri:<resource_id>, content:<URL>}``
+         *     （视频双轨：model-lake 端会按 vendor spec 决策原生 vs 抽帧，所以只要
+         *      模型支持图像即可走视频协议块。详见 RFC-020 T8）
+         *
+         * 缺省 / 缺失 → 不组装多模态块，附件仅以"文本 marker"形态参与文字 turn，
+         * KG / 工作空间工具 / agent 文字阅读仍可消费 resourceId，不会因此 422。
+         */
+        modelCapabilities?: ModelCapabilities | null;
     }): object;
     /**
      * Convert raw JetAgents Notification SSE to ChatWidget flat SSEMessage format.
@@ -3169,6 +3552,49 @@ declare class DefaultJetAgentsAdapter implements ChatWidgetAdapter {
     listModels<TGroup extends 'basename' | 'name' | 'none' = 'basename'>(params?: ListModelsParams & {
         groupBy?: TGroup;
     }): Promise<ListModelsResponse<TGroup extends 'basename' ? ModelListItemBasenameGrouped : TGroup extends 'name' ? ModelListItemGrouped : ModelListItemRaw>>;
+    /**
+     * 拉取模型"能力位"。**走 hip-server**，端点 ``GET /api/v1/models/capabilities``。
+     *
+     * 透传规则：
+     *   - 不传 ``modelIds`` → query 不带 ``model_ids``，hip 端返回全表；
+     *   - 传 ``modelIds`` → 拼成 ``?model_ids=a/x,b/y``（CSV 形态，与 hip 端约定一致）；
+     *   - hip 端保证未命中的 id 实化为全 false（保守门控），所以前端不用兜底。
+     *
+     * 错误语义：与 ``listModels`` 一样**抛错**而不是返回空 map：
+     *   "未知 → false" 是危险的撒谎；让上层 ``useModelCapabilities`` 自己决定
+     *   "拉不到能力位 → 整个多模态入口隐藏"的兜底，而不是把"all false"和
+     *   "真的 all false（极端罕见）"混为一谈。
+     *
+     * hipBaseUrl 缺省 → 走相对 URL，开发态由 vite proxy / 生产态由网关接管，
+     * 与本类内其他 hip 调用一致。
+     */
+    listModelCapabilities(modelIds?: string[]): Promise<ListModelCapabilitiesResponse>;
+    /**
+     * JETP-multimodal: 批量获取一组 resource_id 的访问 URL + MIME + 过期时刻。
+     *
+     * 通道：``GET /api/knowledge/workspace/files``（KG）。
+     *   - ``file_ids=<rid>`` 可重复，FastAPI 解析成 ``list[str]``；
+     *   - ``generate_urls=true`` 让 KG 在响应里填 ``download_url`` / ``preview_url`` /
+     *     ``url_expires_in``（秒），并填 ``mime_type``；
+     *   - ``access_mode=private`` 拿预签名 URL（默认 1h TTL）。
+     *
+     * 取舍：
+     *   - 不依赖 sessionId 也能查（``file_ids`` 是 KG 全局 id），但接口要求 KG 端
+     *     校验 principal 鉴权；保留 ``sessionId`` 参数让未来如果 KG 端引入
+     *     session 维度的 ACL 仍能用同一签名。
+     *   - 不区分 download vs. preview：图片优先 ``preview_url``（KG 会针对图片返回
+     *     适合 inline 展示的格式），缺失才 fallback 到 ``download_url``。
+     *   - 单次请求 file_ids 上限：默认 ``page_size=20`` 已经够用；
+     *     真有 >20 张图的场景再拆批。当前不做拆批以保持实现简单。
+     *
+     * 失败：上游 5xx / 404 抛 ``ChatWidgetNetworkError``；
+     * 未命中的 rid 不在返回 Map 里（让 hook 自行决定降级 / 重试）。
+     */
+    getResourceUrls(sessionId: number, resourceIds: string[]): Promise<Map<string, {
+        url: string;
+        mimeType?: string;
+        expiresAtMs?: number;
+    }>>;
     /**
      * 拉取 agent 在后端注册的默认模型，仅供 picker 展示态使用。
      *
@@ -3265,13 +3691,6 @@ declare class InvalidClientIdError extends Error {
     constructor(message: string, reason: 'missing' | 'session_not_ready' | 'allocation_failed' | 'legacy_main' | 'legacy_format' | 'session_forbidden', sessionId?: string | number | null | undefined);
 }
 
-declare const I18nContext: React$1.Context<ChatWidgetMessages>;
-declare function useChatWidgetI18n(): {
-    messages: ChatWidgetMessages;
-    t: (key: keyof ChatWidgetMessages, params?: Record<string, string | number>) => string;
-    locale: ChatWidgetLocale;
-};
-
 declare function organizeMessagesByLevel(messages: Round['messages']): {
     rootMessages: Round['messages'];
     childrenMap: Map<string, Round['messages']>;
@@ -3661,4 +4080,538 @@ declare function prepareJsonRenderSpec<T = Record<string, unknown>>(raw: unknown
  */
 declare function extractKicadSexprByUuid(content: string, uuid: string): string | null;
 
-export { type AgentControlFrame, type AgentDefaultModelInfo, AgentGroupPanel, type AgentGroupPanelProps, type AgentInstanceState, type AggregatedMessage, type AnnotationAnchor, type AnnotationAnchorRect, AnnotationFAB, type AnnotationFABProps, type AnnotationInteraction, type AnnotationKind, type AnnotationMessage, AnnotationPanel, type AnnotationPanelMessage, type AnnotationPanelProps, type Artifact, type ArtifactRef, type AttentionToast, AttentionToastList, type AttentionToastListProps, ChatOverlay, type ChatOverlayProps, ChatWidget, type ChatWidgetAPI, type ChatWidgetAdapter, ChatWidgetAuthError, type ChatWidgetConfig, type ChatWidgetControllerOptions, type ChatWidgetControllerState, type ChatWidgetInteractionEvent, ChatWidgetLocale, ChatWidgetMessages, ChatWidgetNetworkError, type ChatWidgetProps, ChildAgentCard, HttpError as ClientAllocatorHttpError, type ClientTitleEvent, type ConnectionStatus, ContextChip, type ContextChipProps, type ContextPreload, type CreateClientOptions, type CreateClientResponse, type CreateDiscussionRequest, type CreateDiscussionResponse, DEFAULT_CONFIG, DefaultComposer, type DefaultComposerProps, DefaultJetAgentsAdapter, type DefaultJetAgentsAdapterOptions, type DirectoryFileEntry, DiscussionComposer, type DiscussionComposerProps, type DiscussionFile, type DiscussionMessage, type DiscussionMeta, DiscussionPanel, type DiscussionPanelProps, DiscussionViewer, type DiscussionViewerProps, ESC_PRIORITY, type EscHandler, type ExecutionStatus, type FileAttachment, type FileCategory$1 as FileCategory, type FileReference, type FileUploadResult, type FileUploadStatusResult, FileViewer, FileViewerModal, type FileViewerModalProps, FileViewerPanel, type FileViewerPanelProps, type FileViewerProps, FloatingInput, type FloatingInputProps, FloatingToolbar, type FloatingToolbarProps, type HITLRequest, type HITLResponse, HoverPreview, type HoverPreviewProps, I18nContext, Icon, type IconName, type IconProps, type IconWeight, ImmersiveShell, type ImmersiveShellProps, InlineAnnotationInput, type InlineAnnotationInputProps, type InteractionEventType, InvalidClientIdError, type KicadCanvasSelectionPayload, LinkCard, type ListDirectoryFilesOptions, type ListModelsParams, type ListModelsResponse, type ListSessionsParams, type ListSessionsResponse, MODEL_AUTO, MentionAutocomplete, type MentionAutocompleteProps, type MentionTarget, MessageContent, type MessageContentType, type ModelChoice, type ModelListItemBasenameGrouped, type ModelListItemGrouped, type ModelListItemRaw, type ModelListVariant, type ModelOverride, ModelPicker, type ModelPickerProps, type NotificationConfig, type NotificationTurn, type NotificationType, type PendingHIL, PinnedArea, PlanCard, type PlanItem, type PoolAgent, type PoolAgentAction, type PoolStatusResponse, type PostDiscussionMessageRequest, type PostDiscussionMessageResponse, type ProjectFile, ProvenanceGraphSnapshot, type RailAction, type ReadReceipt, ResourceChip, type ResourceContent, ResourceContext, type ResourceContextValue, type ResourceInput, ResourceProvider, type ResourceState, RichInput, type RichInputHandle, type RichInputProps, type Round, RoundHeader, RoundMessageList, RoundsView, type RoundsViewProps, type SSEMessage, SchemaFormRenderer, type SelectedSkillRef, type SelectionBridgeOptions, type SelectionData, type SelectionState, type SessionChannelMessage, type ClientItem as SessionClientItem, BusinessError as SessionClientsBusinessError, type SessionDetail, type SessionLifecycleEvent, type SessionListItem, SessionListPanel, type SessionListPanelProps, ShareResourceProvider, type ShortcutDef, type SkillListParams, type SkillListResponse, SkillSelector, type SkillSelectorProps, type SkillSummary, type SmartPasteOptions, type SnapshotData, type SpecLifecycleEntry, SplitPanel, type SplitPanelProps, TabBar, type TabBarProps, type TaskPlan, TodoCard, type TodoData, type TodoGroup, type TodoPhase, type TodoStats, type TodoTask, type ToolCallData, ToolCardBuffering, type TransportMode, type TreePersistState, type UiConfig, type UploadedFileInfo, type UseAgentControlOptions, type UseAgentDefaultModelOptions, type UseAgentDefaultModelResult, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAttentionManagerOptions, type UseAutoTabOptions, type UseClientIdAllocatorReturn, type UseDiscussionsOptions, type UseDiscussionsReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UseHoverPreviewOptions, type UseModelsOptions, type UseModelsResult, type UseProjectFilesOptions, type UseProjectFilesResult, type UseSessionChannelOptions, type UseSessionChannelReturn, type UseSessionClientsReturn, type UseSessionListOptions, type UseSessionListReturn, type UseShortcutsOptions, type UseSkillDataOptions, type UseSkillDataReturn, type UseSkillOrchestrationOptions, type UseSkillOrchestrationReturn, type UseSkillSelectorStateReturn, type UseViewerTabsReturn, type UseWorkspaceFilesOptions, type UseWorkspaceFilesReturn, VIEWER_CAPABILITIES, type ViewerInteractionAdapter, type ViewerTab, type WorkspaceFile, WorkspacePanel, type WorkspacePanelProps, type WorkspaceTreeNode, type WorkspaceUploadResult, type XrefMeta, type XrefRecord, type XrefRef, contentToSrc, extractKicadSexprByUuid, fileTypeCategory, fileTypeColor, fileTypeIcon, formatFileSize, getExtension, getFileCategory, getStatusDisplay, getViewerCapabilities, inferLanguage, isShowModelChannels, isTodoNotificationContent, loadLastModelName, mergeConsecutiveThinkMessages, modelBasename, organizeMessagesByLevel, parseDiscussionMessages, parseXrefs, prepareJsonRenderSpec, saveLastModelName, useAgentControl, useAgentDefaultModel, useAnnotations, useAttentionManager, useAutoTab, useChatWidgetController, useChatWidgetI18n, useClientIdAllocator, useDiscussions, useEscStack, useFileUpload, useHoverPreview, useMessageAggregator, useModels, useNarrowMode, useProjectFiles, useResource, useResourceContext, useSSE, useSelectionBridge, useSessionChannel, useSessionClients, useSessionList, useShortcuts, useSkillData, useSkillOrchestration, useSkillSelectorState, useSmartPaste, useTreePersist, useViewerTabs, useWorkspaceFiles };
+/**
+ * JETP-084 — RAG paragraph-level provenance protocol types (frontend).
+ *
+ * These types mirror the backend Pydantic models in
+ * `jetagents/runtime/provenance/types.py`. They are the *single source of
+ * truth* for the cross-system marker / sidecar / citation_context contract on
+ * the chat-widget side.
+ *
+ * Cross-protocol fields use strict, narrow types so that violations surface
+ * at type-check time. Backwards-compatible / cosmetic fields are widened where
+ * spec allows.
+ */
+/** File kinds the protocol distinguishes. Backend mirror: `Chunk.file_type`. */
+type RagFileType = 'markdown' | 'text' | 'code' | 'pdf' | 'word';
+/** Coarse block classification used by the chunker. */
+type RagBlockType = 'text' | 'image' | 'table' | 'equation';
+/**
+ * `[@§N:rid_short](kw1 kw2)` — the marker the LLM emits in stream tokens.
+ *
+ * After the FSM extracts and validates a marker it produces a `MarkerEnvelope`
+ * which is the canonical in-memory representation handed to UI components.
+ */
+interface MarkerEnvelope {
+    /** chunk_id `§N` — 1-indexed, ≤ file.total_chunks. */
+    n: number;
+    /** Short resource id (fixed 5 [a-z0-9] chars, v4 sha1 hash). */
+    rid_short: string;
+    /** Keywords used for downstream fuzzy search; LLM-supplied, may be empty. */
+    keywords: string[];
+    /** Raw marker text as parsed, useful for fallback rendering & debug. */
+    raw: string;
+}
+/** Per-file entry inside a `citation_context` event. */
+interface CitationContextFile {
+    /** Stable, globally unique resource id (long form). */
+    rid: string;
+    /** Short alias assigned by the session-scoped pool (JETP-084 v3). */
+    rid_short: string;
+    /** Commit the chunks were computed against. */
+    git_commit_hash: string;
+    /** Human-friendly file name (e.g. `datasheet.pdf`). */
+    file_name: string;
+    /**
+     * Git path of the original (user-facing) file inside the workspace
+     * repo. Added in JETP-084 v3 so the UI can render path information
+     * without an extra lookup. May be `''` when emitted by a transitional
+     * backend mid-rollout.
+     */
+    file_path?: string;
+    file_type: RagFileType;
+    /** Number of chunks in the sidecar; FSM uses this to validate `§N`. */
+    total_chunks: number;
+}
+/**
+ * JETP-084 v3 — citation_context SSE notification payload.
+ *
+ * v3 dropped the `message_id` field: the event is now emitted by the
+ * read tool independent of any LLM message and carries the **full
+ * session-known files list** every time. Frontends maintain a single
+ * session-scoped index keyed by `rid_short`.
+ */
+interface CitationContextEvent {
+    files: CitationContextFile[];
+}
+/** A single paragraph-level chunk inside `chunks.json`. */
+interface ChunksSidecarChunk {
+    /** 1-indexed chunk number; matches the §N in markers. */
+    n: number;
+    /** Heading breadcrumb, root first. */
+    heading_path: string[];
+    block_type: RagBlockType;
+    /**
+     * 1-indexed inclusive line range inside `.extracted.md`. `null` when the
+     * file type / block type cannot express it (e.g. PDF body images).
+     */
+    line_range: [number, number] | null;
+    /** 0-indexed half-open character range inside `.extracted.md`. */
+    char_range: [number, number];
+    /** Verbatim paragraph text rendered in the Popover. */
+    paragraph_text: string;
+    /** Approximate token count (rough heuristic). */
+    token_count: number;
+    /** 0-indexed PDF page, `null` for non-PDF files. */
+    page_idx: number | null;
+}
+/** The `chunks.json` sidecar payload. */
+interface ChunksSidecar {
+    resource_id: string;
+    file_type: RagFileType;
+    git_commit_hash: string;
+    /** SHA-256 of the source extracted markdown; guards stale chunk drift. */
+    source_hash: string;
+    total_chunks: number;
+    chunks: ChunksSidecarChunk[];
+}
+/** Status of a sidecar entry across the cache + UI lifecycle. */
+type SidecarStatus = 'idle' | 'loading' | 'ready' | 'missing' | 'stale';
+/**
+ * Compile-time regex for the marker grammar. Mirrors backend `MarkerEnvelope`
+ * field validators. Exposed so other modules (FSM tests, debug tooling) can
+ * reuse without reinventing the pattern.
+ */
+declare const MARKER_REGEX: RegExp;
+
+/**
+ * JETP-084 — Streaming Marker FSM.
+ *
+ * Consumes raw stream tokens (any chunking) character-by-character and emits
+ * `text` / `placeholder` / `flush` / `chip` events. Designed to be cheap (O(N)
+ * single pass), allocation-light, and to never throw on bad input — every
+ * failure mode degrades to plain text.
+ *
+ * State machine (see `chat-widget/02_streaming_fsm.md`):
+ *
+ *   NORMAL ─ "[@§" ─► BUFFERING ─ ")" ─► PARSE ─ ok ─► EMIT_CHIP ─► NORMAL
+ *                          │                  │
+ *                          └─ timeout/overflow/nested ──► flush as text ─► NORMAL
+ *                                             │
+ *                                             └─ regex / validation fail ──► flush ─► NORMAL
+ *
+ * The FSM keeps no React state and is safe to instantiate per-message.
+ */
+
+/** State labels are exported for tests / debug overlays. */
+type FsmState = 'NORMAL' | 'BUFFERING' | 'PARSE' | 'EMIT_CHIP';
+/** Discriminated emit event. */
+type FsmEmit = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'placeholder';
+} | {
+    type: 'flush';
+} | {
+    type: 'chip';
+    marker: MarkerEnvelope;
+};
+interface FsmConfig {
+    /** Citation context for the current message; usually from SSE or persisted msg field. */
+    citationContext: CitationContextFile[];
+    /** Buffer timeout in ms. Default 3000. Set to 0 to disable the timer. */
+    bufferTimeoutMs?: number;
+    /** Max buffer length before forced flush. Default 500. */
+    bufferMaxChars?: number;
+    emit: (event: FsmEmit) => void;
+}
+declare class StreamingMarkerFSM {
+    private state;
+    private buffer;
+    private timeoutHandle;
+    private readonly bufferTimeoutMs;
+    private readonly bufferMaxChars;
+    private readonly emit;
+    private citationContext;
+    constructor(config: FsmConfig);
+    /** Refresh the citation context mid-stream (e.g. event arrives after stream began). */
+    setCitationContext(files: CitationContextFile[]): void;
+    /** Internal state, exposed for tests + debugging. Treat as read-only. */
+    getState(): FsmState;
+    /** Receive a chunk of arbitrary length; processed byte-by-byte. */
+    feed(chunk: string): void;
+    /** Call when the stream ends so any partial buffer is flushed as plain text. */
+    end(): void;
+    /** Force-flush + tear down timers. Safe to call multiple times. */
+    dispose(): void;
+    private feedChar;
+    private handleNormal;
+    private enterBuffering;
+    private handleBuffering;
+    private tryParse;
+    private flushBufferAsText;
+    private armTimer;
+    private clearTimer;
+}
+
+/**
+ * JETP-084 — Sidecar LRU cache + batch preloader + React hook.
+ *
+ * Memory model:
+ *   - Single browser-tab in-memory `Map<key, CacheEntry>`; insertion order is
+ *     LRU order (oldest first).
+ *   - On `get` we re-insert to bump recency.
+ *   - On `set` we evict from the front until size ≤ MAX_ENTRIES.
+ *
+ * Network model:
+ *   - `preloadSidecars` groups requested (rid, commit) tuples by commit and
+ *     fires one batched fetch per commit. Failures mark each affected entry as
+ *     `missing` so the UI never spins forever.
+ *   - `useSidecar` is a thin reactive layer on top via `useSyncExternalStore`.
+ */
+
+interface CacheEntry {
+    status: SidecarStatus;
+    data?: ChunksSidecar;
+    /** Tracks an in-flight request; used to dedupe parallel hover requests. */
+    promise?: Promise<void>;
+}
+interface BatchFetcherResponse {
+    /** Keyed by `rid`. */
+    items: Record<string, ChunksSidecar>;
+    /** Resource ids that have no sidecar at all (404 equivalent). */
+    missing: string[];
+    /** Resource ids whose sidecar commit ≠ requested commit. */
+    stale: string[];
+}
+interface BatchFetcher {
+    (params: {
+        ids: string;
+        commit: string;
+    }): Promise<BatchFetcherResponse>;
+}
+interface SidecarSnapshot {
+    status: SidecarStatus;
+    sidecar: ChunksSidecar | undefined;
+}
+/** Public — return entry and bump LRU recency. Returns `undefined` if miss. */
+declare function getCachedSidecar(rid: string, commit: string): CacheEntry | undefined;
+/** Public — write/replace an entry. Triggers notify + LRU eviction. */
+declare function setCachedSidecar(rid: string, commit: string, entry: CacheEntry): void;
+/**
+ * Preload sidecars for the given `(rid, commit)` tuples. Skips already-ready
+ * and in-flight entries. Groups by commit so a single message with N citations
+ * from a single commit ⇒ exactly 1 network request.
+ */
+declare function preloadSidecars(files: Array<{
+    rid: string;
+    commit: string;
+}>, fetcher: BatchFetcher): Promise<void>;
+/** Default fetcher hitting `/api/sidecar`. Override in tests / non-browser contexts. */
+declare const defaultFetcher: BatchFetcher;
+declare function setSidecarFetcher(fetcher: BatchFetcher | null): void;
+/**
+ * Reactive accessor for a single (rid, commit) entry. Triggers a lazy fetch on
+ * `idle` (e.g. first hover). Returns a stable snapshot identity for the same
+ * underlying entry so React can skip re-renders.
+ */
+declare function useSidecar(rid: string, commit: string): SidecarSnapshot;
+
+/**
+ * JETP-084 v3 (Phase 10, 2026-05-27) — Session-scoped citation context.
+ *
+ * v3 ditches the v1/v2 per-message store entirely. The backend emits
+ * a single `citation_context` SSE notification from the *read* tool
+ * carrying the full session-known files list (no `message_id`); the
+ * frontend maintains one global `rid_short → file` index for the
+ * lifetime of the open session and resolves chips against it.
+ *
+ * Lifecycle:
+ *   - SSE callback → `ingestCitationContext(files)` → merges into the
+ *     index and notifies subscribers.
+ *   - Session switch / sign-out → `__resetForSessionSwitch()` wipes
+ *     the index so cross-session bleed-through is impossible.
+ *   - UI chips: `useFileByRidShort(ridShort)` returns the matching
+ *     file or null; no messageId argument.
+ *
+ * Why this is the correct shape (vs v1/v2 per-message):
+ *   - The backend pool is session-scoped (see
+ *     `jetagents/runtime/turn/citation_pool.py`), so each emit already
+ *     carries every file the session has surfaced. Maintaining a parallel
+ *     per-message index on the frontend just multiplies the failure modes
+ *     (ID alignment between LLM message IDs and SSE deliveries was the
+ *     entire v2 chip-render bug).
+ *   - The rid_short identifier is deterministic per (session, rid) on
+ *     the backend, so any frontend resolution that finds a match is
+ *     guaranteed to be correct as long as the session matches.
+ *
+ * Spec: `doc/proposals/JETP-084-rag-paragraph-provenance/chat-widget/05_sidecar_cache.md` §5–§6.
+ */
+
+/**
+ * Ingest a v3 citation_context payload. The full session-known
+ * `files` list is merged into the global index; entries are upserted
+ * by `rid_short` (the deterministic identifier). Stale rid_shorts not
+ * present in the new payload are intentionally kept around — the LLM
+ * may still cite them from memory and the chip should resolve. The
+ * backend's session-level pool TTL / LRU enforces the upper bound.
+ */
+declare function ingestCitationContext(files: CitationContextFile[]): void;
+/** @deprecated v1/v2 per-message store removed. v3 ignores `messageId`. */
+declare function persistFromMessage(_messageId: string, files: CitationContextFile[], options?: {
+    preload?: boolean;
+}): void;
+/** @deprecated v1/v2 hook — use {@link useFileByRidShort} (no messageId arg). */
+declare function useCitationContext(_messageId: string): {
+    files: CitationContextFile[];
+};
+
+/**
+ * JETP-084 — Popover content rendered on Chip hover/focus.
+ *
+ * Pure presentational; routing into the FileViewer happens via the
+ * `onOpenInViewer` callback supplied by the parent.
+ *
+ * State map:
+ *   loading  → <PopoverSkeleton/>
+ *   ready    → header / breadcrumb / paragraph + (stale chip if stale)
+ *   stale    → same as ready but with the "⚠ file updated" banner
+ *   missing  → <PopoverMissing/>
+ */
+
+interface PopoverProps {
+    status: SidecarStatus;
+    /** Chunk identified by the marker; undefined when the sidecar lacks the §N. */
+    chunk: ChunksSidecarChunk | undefined;
+    file: CitationContextFile;
+    marker: MarkerEnvelope;
+    onOpenInViewer: () => void;
+    /** UI strings — defaulted to Chinese to match existing chat-widget copy. */
+    i18n?: PopoverI18n;
+}
+interface PopoverI18n {
+    openInViewer: string;
+    staleWarning: string;
+    missingTitle: string;
+    missingHint: string;
+    loadingHint: string;
+}
+declare const Popover: React$1.FC<PopoverProps>;
+/**
+ * Highlight every keyword occurrence in `text`. Matching rules:
+ *   - case-insensitive
+ *   - longest first (so "工作温度" wins over "工作")
+ *   - simple substring; no word-boundary, no overlap
+ *   - safe against regex meta-chars (keyword is escaped)
+ *   - empty / zero-hit keywords ⇒ rendered text unchanged
+ */
+declare const HighlightedText: React$1.FC<{
+    text: string;
+    keywords: string[];
+}>;
+
+/**
+ * JETP-084 — Inline Chip rendered for a parsed `[@§N:rid_short](kw...)` marker.
+ *
+ * Visual: `📎 file_name › leaf_heading`. Click ⇒ open in FileViewer.
+ * Hover/focus ⇒ show `<Popover/>` (lazy-fetched sidecar).
+ *
+ * The Chip intentionally avoids exposing `§N` in the label (UX decision).
+ */
+
+interface ChipProps {
+    marker: MarkerEnvelope;
+    file: CitationContextFile;
+    onOpenInViewer?: (file: CitationContextFile, marker: MarkerEnvelope) => void;
+    /** Delay (ms) before Popover opens on hover; default 200. */
+    openDelay?: number;
+    className?: string;
+    popoverI18n?: PopoverI18n;
+}
+declare const Chip: React$1.FC<ChipProps>;
+
+/**
+ * JETP-084 — React hook wrapping `StreamingMarkerFSM` for use inside message
+ * components. The hook converts FSM emit events into an ordered list of
+ * `Segment` records which can be mapped 1:1 to JSX (`<span>` for text,
+ * `<Chip>` for chip, placeholder skeleton for in-flight marker).
+ *
+ * Design notes:
+ *   - The FSM is owned by a `useRef` so it survives re-renders without
+ *     re-instantiation.
+ *   - Segments are accumulated in a ref-backed list; we surface them via a
+ *     React state bumped on each event to trigger re-render exactly once per
+ *     micro-batch.
+ *   - Citation context updates are forwarded via `fsm.setCitationContext` so
+ *     late-arriving SSE events can retroactively validate buffered markers.
+ *   - The hook returns idempotent `feed` / `end` / `reset` functions for
+ *     callers to wire into their SSE stream.
+ */
+
+type Segment = {
+    kind: 'text';
+    key: string;
+    text: string;
+} | {
+    kind: 'chip';
+    key: string;
+    marker: MarkerEnvelope;
+} | {
+    kind: 'placeholder';
+    key: string;
+};
+interface UseStreamingMarkersOptions {
+    citationContext: CitationContextFile[];
+    bufferTimeoutMs?: FsmConfig['bufferTimeoutMs'];
+    bufferMaxChars?: FsmConfig['bufferMaxChars'];
+}
+interface UseStreamingMarkersApi {
+    segments: Segment[];
+    feed: (chunk: string) => void;
+    end: () => void;
+    reset: () => void;
+}
+declare function useStreamingMarkers(opts: UseStreamingMarkersOptions): UseStreamingMarkersApi;
+
+/**
+ * JETP-084 — Provenance routing decision tree.
+ *
+ * Pure synchronous function. Decides:
+ *   1. Whether the snapshot is precise / fuzzy / stale.
+ *   2. What action FileViewer should take (line jump / keyword search / open).
+ *
+ * The function has no side effects so it can be tested exhaustively.
+ */
+
+type Precision = 'precise' | 'fuzzy' | 'stale';
+type ProvenanceAction = {
+    type: 'lineRange';
+    lines: [number, number];
+    keywords: string[];
+} | {
+    type: 'keywordSearch';
+    keywords: string[];
+    pageHint?: number;
+} | {
+    type: 'fileOpen';
+};
+interface ProvenanceRouteParams {
+    file: CitationContextFile;
+    marker: MarkerEnvelope;
+    chunk: ChunksSidecarChunk;
+}
+interface ProvenanceRouteResult {
+    precision: Precision;
+    action: ProvenanceAction;
+}
+/**
+ * @param params  marker + chunk + file metadata
+ * @param currentHeadCommit  the current commit of the file as known by the
+ *                           workspace; if omitted, commit checking is skipped.
+ */
+declare function routeProvenance(params: ProvenanceRouteParams, currentHeadCommit?: string): ProvenanceRouteResult;
+
+/**
+ * JETP-084 — Text / code / markdown route applier.
+ *
+ * Decoupled from any concrete editor implementation; consumers pass in an
+ * `EditorAdapter` so the chat-widget can wire this to Monaco, CodeMirror, or
+ * its own `MarkdownViewer` without taking a hard dependency here.
+ */
+/**
+ * Minimal editor surface area required for line-range navigation + range
+ * highlight. Models the Monaco IStandaloneCodeEditor subset we need.
+ */
+interface EditorAdapter {
+    /** Scroll so `line` is in (or near) the vertical center of the viewport. */
+    revealLineInCenter(line: number): void;
+    /** Select an inclusive line range. */
+    selectLines(start: number, end: number): void;
+    /**
+     * Apply a "RAG paragraph highlight" decoration spanning [start, end].
+     * Returns a token the caller can pass back to `clearDecorations` later.
+     */
+    addRangeDecoration(start: number, end: number, className: string): string;
+    /** Clear previously applied decorations. */
+    clearDecorations(ids: string[]): void;
+    /**
+     * Highlight every occurrence of each keyword inside the [start, end] range.
+     * Returns decoration ids for later cleanup.
+     */
+    highlightKeywords(range: [number, number], keywords: string[], className: string): string[];
+}
+interface TextRouteResult {
+    /** Decoration tokens callers should clear when navigating away. */
+    decorationIds: string[];
+    /** Number of keyword matches highlighted. */
+    keywordMatches: number;
+}
+interface TextRouteOptions {
+    editor: EditorAdapter;
+    lines: [number, number];
+    keywords: string[];
+    rangeClassName?: string;
+    keywordClassName?: string;
+}
+declare function applyTextRoute(opts: TextRouteOptions): TextRouteResult;
+
+/**
+ * JETP-084 — PDF route applier.
+ *
+ * Uses a thin `PdfViewerAdapter` interface so the chat-widget can keep this
+ * module decoupled from the actual PDF.js wrapper. The adapter signature is
+ * intentionally narrow.
+ *
+ * Degradation chain (matches `04_file_viewer_routing.md` §5):
+ *   1. Multi-keyword highlight all.
+ *   2. If 0 matches and >1 keyword ⇒ fall back to the longest single keyword.
+ *   3. If still 0 ⇒ caller is notified via `outcome === 'no-match'`.
+ */
+interface PdfViewerAdapter {
+    /** Navigate to a 1-indexed page (no-op out of range). */
+    gotoPage(page: number): Promise<void> | void;
+    /**
+     * Search the document for `term`; returns the number of matches highlighted.
+     * The viewer is expected to keep prior highlights when called repeatedly
+     * with `appendHighlights: true`.
+     */
+    search(term: string, opts: {
+        caseSensitive?: boolean;
+        highlightAll?: boolean;
+        appendHighlights?: boolean;
+    }): Promise<number> | number;
+    /** Remove all highlights from a previous search. */
+    clearHighlights(): Promise<void> | void;
+}
+interface PdfRouteOptions {
+    viewer: PdfViewerAdapter;
+    keywords: string[];
+    /** 0-indexed page hint (matches sidecar.page_idx). */
+    pageHint?: number;
+}
+type PdfRouteOutcome = 'matched' | 'degraded-longest' | 'no-match';
+interface PdfRouteResult {
+    outcome: PdfRouteOutcome;
+    matched: number;
+    /** The keywords actually used in the (possibly degraded) search. */
+    searchedKeywords: string[];
+}
+declare function applyPdfRoute(opts: PdfRouteOptions): Promise<PdfRouteResult>;
+
+/**
+ * JETP-084 — Precision signal badge (✅ / ≈ / ⚠️).
+ *
+ * Pure presentational: maps a {precision} value to label + className. Caller
+ * controls placement.
+ */
+
+interface PrecisionBadgeProps {
+    precision: Precision;
+    /** Optional label override; otherwise uses the default Chinese copy. */
+    label?: string;
+    className?: string;
+}
+declare const PrecisionBadge: React$1.FC<PrecisionBadgeProps>;
+
+export { type AgentControlFrame, type AgentDefaultModelInfo, AgentGroupPanel, type AgentGroupPanelProps, type AgentInstanceState, type AggregatedMessage, type AnnotationAnchor, type AnnotationAnchorRect, AnnotationFAB, type AnnotationFABProps, type AnnotationInteraction, type AnnotationKind, type AnnotationMessage, AnnotationPanel, type AnnotationPanelMessage, type AnnotationPanelProps, type Artifact, type ArtifactRef, type AttentionToast, AttentionToastList, type AttentionToastListProps, ChatOverlay, type ChatOverlayProps, ChatWidget, type ChatWidgetAPI, type ChatWidgetAdapter, ChatWidgetAuthError, type ChatWidgetConfig, type ChatWidgetControllerOptions, type ChatWidgetControllerState, type ChatWidgetInteractionEvent, ChatWidgetLocale, ChatWidgetMessages, ChatWidgetNetworkError, type ChatWidgetProps, ChildAgentCard, HttpError as ClientAllocatorHttpError, type ClientTitleEvent, type ConnectionStatus, ContextChip, type ContextChipProps, type ContextPreload, type CreateClientOptions, type CreateClientResponse, type CreateDiscussionRequest, type CreateDiscussionResponse, DEFAULT_CONFIG, DefaultComposer, type DefaultComposerProps, DefaultJetAgentsAdapter, type DefaultJetAgentsAdapterOptions, type DirectoryFileEntry, DiscussionComposer, type DiscussionComposerProps, type DiscussionFile, type DiscussionMessage, type DiscussionMeta, DiscussionPanel, type DiscussionPanelProps, DiscussionViewer, type DiscussionViewerProps, ESC_PRIORITY, type EscHandler, type ExecutionStatus, type FileAttachment, type FileCategory$1 as FileCategory, type FileReference, type FileUploadResult, type FileUploadStatusResult, FileViewer, FileViewerModal, type FileViewerModalProps, FileViewerPanel, type FileViewerPanelProps, type FileViewerProps, FloatingInput, type FloatingInputProps, FloatingToolbar, type FloatingToolbarProps, type HITLRequest, type HITLResponse, HoverPreview, type HoverPreviewProps, I18nContext, Icon, type IconName, type IconProps, type IconWeight, ImmersiveShell, type ImmersiveShellProps, InlineAnnotationInput, type InlineAnnotationInputProps, type InteractionEventType, InvalidClientIdError, type KicadCanvasSelectionPayload, LinkCard, type ListDirectoryFilesOptions, type ListModelsParams, type ListModelsResponse, type ListSessionsParams, type ListSessionsResponse, MAX_RECENT, MODALITY_ORDER, MODEL_AUTO, MentionAutocomplete, type MentionAutocompleteProps, type MentionTarget, MessageContent, type MessageContentType, type ModalityId, type ModelChoice, type ModelListItemBasenameGrouped, type ModelListItemGrouped, type ModelListItemRaw, type ModelListVariant, type ModelOverride, ModelPicker, type ModelPickerProps, type NotificationConfig, type NotificationTurn, type NotificationType, type PendingHIL, PinnedArea, PlanCard, type PlanItem, type PoolAgent, type PoolAgentAction, type PoolStatusResponse, type PostDiscussionMessageRequest, type PostDiscussionMessageResponse, PrecisionBadge, type ProjectFile, ProvenanceGraphSnapshot, MARKER_REGEX as RAG_MARKER_REGEX, type BatchFetcher as RagBatchFetcher, type BatchFetcherResponse as RagBatchFetcherResponse, type RagBlockType, type CacheEntry as RagCacheEntry, Chip as RagChip, type ChipProps as RagChipProps, type ChunksSidecar as RagChunksSidecar, type ChunksSidecarChunk as RagChunksSidecarChunk, type CitationContextEvent as RagCitationContextEvent, type CitationContextFile as RagCitationContextFile, type EditorAdapter as RagEditorAdapter, type RagFileType, type FsmConfig as RagFsmConfig, type FsmEmit as RagFsmEmit, type FsmState as RagFsmState, HighlightedText as RagHighlightedText, type MarkerEnvelope as RagMarkerEnvelope, type PdfRouteOptions as RagPdfRouteOptions, type PdfRouteOutcome as RagPdfRouteOutcome, type PdfRouteResult as RagPdfRouteResult, type PdfViewerAdapter as RagPdfViewerAdapter, Popover as RagPopover, type PopoverI18n as RagPopoverI18n, type PopoverProps as RagPopoverProps, type Precision as RagPrecision, type PrecisionBadgeProps as RagPrecisionBadgeProps, type ProvenanceAction as RagProvenanceAction, type ProvenanceRouteParams as RagRouteParams, type ProvenanceRouteResult as RagRouteResult, type SidecarSnapshot as RagSidecarSnapshot, type SidecarStatus as RagSidecarStatus, type Segment as RagStreamingSegment, type TextRouteOptions as RagTextRouteOptions, type TextRouteResult as RagTextRouteResult, type RailAction, type ReadReceipt, ResourceChip, type ResourceContent, ResourceContext, type ResourceContextValue, type ResourceInput, ResourceProvider, type ResourceState, RichInput, type RichInputHandle, type RichInputProps, type Round, RoundHeader, RoundMessageList, RoundsView, type RoundsViewProps, type SSEMessage, SchemaFormRenderer, type SelectedSkillRef, type SelectionBridgeOptions, type SelectionData, type SelectionState, type SessionChannelMessage, type ClientItem as SessionClientItem, BusinessError as SessionClientsBusinessError, type SessionDetail, type SessionLifecycleEvent, type SessionListItem, SessionListPanel, type SessionListPanelProps, ShareResourceProvider, type ShortcutDef, type SkillListParams, type SkillListResponse, SkillSelector, type SkillSelectorProps, type SkillSummary, type SmartPasteOptions, type SnapshotData, type SpecLifecycleEntry, SplitPanel, type SplitPanelProps, StreamingMarkerFSM, TabBar, type TabBarProps, type TaskPlan, TodoCard, type TodoData, type TodoGroup, type TodoPhase, type TodoStats, type TodoTask, type ToolCallData, ToolCardBuffering, type TransportMode, type TreePersistState, type UiConfig, type UploadedFileInfo, type UseAgentControlOptions, type UseAgentDefaultModelOptions, type UseAgentDefaultModelResult, type UseAnnotationsOptions, type UseAnnotationsReturn, type UseAttentionManagerOptions, type UseAutoTabOptions, type UseClientIdAllocatorReturn, type UseDiscussionsOptions, type UseDiscussionsReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UseHoverPreviewOptions, type UseModelsOptions, type UseModelsResult, type UseProjectFilesOptions, type UseProjectFilesResult, type UseStreamingMarkersApi as UseRagStreamingMarkersApi, type UseStreamingMarkersOptions as UseRagStreamingMarkersOptions, type UseSessionChannelOptions, type UseSessionChannelReturn, type UseSessionClientsReturn, type UseSessionListOptions, type UseSessionListReturn, type UseShortcutsOptions, type UseSkillDataOptions, type UseSkillDataReturn, type UseSkillOrchestrationOptions, type UseSkillOrchestrationReturn, type UseSkillSelectorStateReturn, type UseViewerTabsReturn, type UseWorkspaceFilesOptions, type UseWorkspaceFilesReturn, VENDOR_ORDER, VIEWER_CAPABILITIES, type VendorId, type ViewerInteractionAdapter, type ViewerTab, type WorkspaceFile, WorkspacePanel, type WorkspacePanelProps, type WorkspaceTreeNode, type WorkspaceUploadResult, type XrefMeta, type XrefRecord, type XrefRef, applyPdfRoute, applyTextRoute, basenameMatchesQuery, clearRecent, contentToSrc, defaultFetcher as defaultRagSidecarFetcher, extractKicadSexprByUuid, fileTypeCategory, fileTypeColor, fileTypeIcon, formatFileSize, getCachedSidecar as getCachedRagSidecar, getExtension, getFileCategory, getStatusDisplay, getViewerCapabilities, inferLanguage, ingestCitationContext as ingestRagCitationContext, isShowModelChannels, isTodoNotificationContent, loadLastModelName, loadRecent, mergeConsecutiveThinkMessages, modalityOf, modelBasename, organizeMessagesByLevel, parseDiscussionMessages, parseXrefs, persistFromMessage as persistRagCitationContext, preloadSidecars as preloadRagSidecars, prepareJsonRenderSpec, pushRecent, routeProvenance, saveLastModelName, setCachedSidecar as setCachedRagSidecar, setSidecarFetcher as setRagSidecarFetcher, useAgentControl, useAgentDefaultModel, useAnnotations, useAttentionManager, useAutoTab, useChatWidgetController, useChatWidgetI18n, useClientIdAllocator, useDiscussions, useEscStack, useFileUpload, useHoverPreview, useMessageAggregator, useModels, useNarrowMode, useProjectFiles, useCitationContext as useRagCitationContext, useSidecar as useRagSidecar, useResource, useResourceContext, useSSE, useSelectionBridge, useSessionChannel, useSessionClients, useSessionList, useShortcuts, useSkillData, useSkillOrchestration, useSkillSelectorState, useSmartPaste, useStreamingMarkers, useTreePersist, useViewerTabs, useWorkspaceFiles, vendorOf };