@ycodium-ai/plugin-api 0.2.2169 → 0.2.2488

package/dist/conversation.d.ts

@@ -8,13 +8,17 @@
  * ## 视图与生命周期
  *
  * 会话插件在 manifest 里只声明 `ui.entry`（无 pages/panels），bundle 的
- * `register(bridge)` 返回 `views: { conversation }`。宿主经 `PluginViewHost`
- * 挂载：每台机器、每个插件版本各一份；插件停用/卸载后注册条目整个消失，宿主
- * 显示「视图不可用」。多个保活会话 pane 各挂各的实例，全局资源（快捷键、壳
+ * `register(bridge)` 返回 `views: { conversation }`，并在 `viewCapabilities` 里声明
+ * {@link CONVERSATION_VIEW_HOST_DATA_CAPABILITY}。宿主经 `PluginViewHost` 挂载：每台
+ * 机器、每个插件版本各一份；插件停用/卸载、或与宿主的数据接口版本不一致时，宿主
+ * 说明原因。多个保活会话 pane 各挂各的实例，全局资源（快捷键、壳
  * 内容发布、已读标记）由宿主按 `scope.active` 仲裁，插件不得自行注册全局监听。
  *
  * ## 数据边界
  *
+ * - 插件按 `(机器, 会话)` 经 {@link ConversationHostData} 自己订阅要用的数据、自己发
+ *   命令；只有那块数据变了，用到它的组件才重新渲染。数据来自宿主已有的连接与缓存，
+ *   插件不另建连接或缓存。尚未迁进数据接口的部分仍由宿主经 props 给出。
  * - `ConversationTimelineEntry` / `ConversationThreadActivity` 对插件**不透明**：
  *   插件只把它们原样传回宿主派生函数，不解读。派生（行模型、用量、页脚）留在
  *   宿主，因为它们依赖宿主共享状态；插件拿到的行模型是可渲染的窄形状。
@@ -26,8 +30,8 @@
  *
  * @module @ycodium-ai/plugin-api/conversation
  */
-import type { ConversationComposerSourceMetrics } from "./source-metrics.ts";
-export type { ConversationComposerSourceMetrics, QuotaPoolScopeKind, SourceMetric, SourceMetricKind, SourceMetricUnit, SourceMetricsCapability, SourceMetricsCredentialIdentity, SourceMetricsRefreshOutcome, SourceMetricsRefreshResult, SourceMetricsSelectionRef, SourceMetricsSnapshot, } from "./source-metrics.ts";
+import type { ConversationComposerAccountUsage } from "./account-usage.ts";
+export type { AccountUsageCapability, AccountUsageCredentialIdentity, AccountUsageMetric, AccountUsageMetricKind, AccountUsageRefreshOutcome, AccountUsageRefreshResult, AccountUsageScopeKind, AccountUsageSnapshot, AccountUsageUnit, ConversationComposerAccountUsage, } from "./account-usage.ts";
 /** 时间线派生输入。插件只透传，不解读。 */
 export type ConversationTimelineEntry = unknown;
 /** 会话活动流。插件只透传给宿主派生函数，不解读。 */
@@ -72,14 +76,10 @@ export interface ConversationModelBadge {
     readonly instanceId: string;
     /** 实例已被删掉又猜不出 driver 时为 null。 */
     readonly driverKind: string | null;
-    readonly providerId: string | null;
     readonly providerDisplayName: string;
     readonly accentColor: string | undefined;
     readonly modelLabel: string;
     readonly effortLabel: string | null;
-    /** 来源显示名。同模型不同来源必须能分开。 */
-    readonly sourceLabel?: string | null | undefined;
-    readonly sourceId?: string | null | undefined;
     /** 徽章身份键：同身份跨渲染保持行对象稳定。 */
     readonly identity: string;
 }
@@ -191,46 +191,7 @@ export interface ConversationModelSelection {
     instanceId: ConversationProviderInstanceId;
     model: string;
     options?: ReadonlyArray<ConversationProviderOptionSelection> | undefined;
-    /** 仅展示/身份用，不代替 ExecutionSelection，也不拼进 instanceId。 */
-    sourceId?: string | undefined;
-    sourceLabel?: string | undefined;
 }
-/** 用户意图：runtime + source + profile，不是 instanceId 字符串。 */
-export interface ConversationExecutionSelection {
-    environmentId: ConversationEnvironmentId;
-    runtimeId: string;
-    sourceId: string;
-    profileId: string;
-    endpointId?: string | undefined;
-    optionOverrides: ReadonlyArray<ConversationProviderOptionSelection>;
-    expectedRevisions: {
-        runtime: number;
-        source: number;
-        profile: number;
-        endpoint?: number | undefined;
-    };
-}
-export type ConversationCompatibilityMatch = "native" | "via-adapter" | "unsupported" | "unknown";
-/** picker 一行：同模型两个来源是两行；ready 只在 native/via-adapter。 */
-export interface ConversationComposerChoice {
-    readonly runtimeId: string;
-    readonly runtimeLabel: string;
-    readonly sourceId: string;
-    readonly sourceLabel: string;
-    readonly sourceKind: "api" | "native-subscription" | "runtime-managed";
-    readonly profileId: string;
-    readonly modelId: string;
-    readonly modelLabel: string;
-    readonly endpointId?: string | undefined;
-    readonly endpointLabel: string | null;
-    readonly match: ConversationCompatibilityMatch | null;
-    readonly reasonCode: string | null;
-    readonly dispatch?: "execution-selection" | "legacy-instance" | "none" | null;
-    readonly ready: boolean;
-    readonly legacyInstanceId: ConversationProviderInstanceId | null;
-    readonly selection: ConversationExecutionSelection;
-}
-export type ConversationExecutionAppliesTo = "composer" | "running" | "next-message";
 export interface ConversationProviderOptionSelection {
     id: string;
     value: string | boolean;
@@ -266,7 +227,6 @@ export interface ConversationServerProviderModel {
     subProvider?: string | undefined;
     isDefault?: boolean | undefined;
     isCustom?: boolean | undefined;
-    isLegacy?: boolean | undefined;
     aliases?: ReadonlyArray<string> | undefined;
     capabilities?: ConversationModelCapabilities | undefined;
 }
@@ -299,8 +259,6 @@ export interface ConversationServerProvider {
     enabled: boolean;
     installed: boolean;
     accentColor?: string | undefined;
-    /** provider 目录里的那一行 id（ACP 厂商各不相同）。 */
-    providerId?: string | undefined;
     continuation?: {
         groupKey?: string | undefined;
     } | undefined;
@@ -342,7 +300,6 @@ export interface ConversationServerProvider {
 export interface ConversationProviderInstanceEntry {
     instanceId: ConversationProviderInstanceId;
     driverKind: ConversationProviderDriverKind;
-    providerId: string;
     displayName: string;
     /** 这一格坐的是哪双手（品牌名）。昵称在 `displayName`，两者可能不同。 */
     agentName?: string | undefined;
@@ -360,7 +317,6 @@ export interface ConversationAppModelOption {
     name: string;
     shortName?: string | undefined;
     subProvider?: string | undefined;
-    isLegacy?: boolean | undefined;
     description?: string | undefined;
     isDefault?: boolean | undefined;
     aliases?: ReadonlyArray<string> | undefined;
@@ -369,10 +325,6 @@ export interface ConversationModelFavorite {
     environmentId: ConversationEnvironmentId;
     instanceId: ConversationProviderInstanceId;
     model: string;
-    runtimeId?: string | undefined;
-    /** 有来源时按 source+profile 收藏；缺席时仍按 instance+model。 */
-    sourceId?: string | undefined;
-    profileId?: string | undefined;
 }
 /** 宿主 `UnifiedSettings` 的结构子集（composer 子树读到的字段）。 */
 export interface ConversationUnifiedSettings {
@@ -647,6 +599,11 @@ export interface ConversationPromptStashEntry {
     unreadableImageNames?: ReadonlyArray<string> | undefined;
     pendingImageCount?: number | undefined;
 }
+/**
+ * 上传失败的原因码，插件按码取自己的译文。`rejected` 时 `httpStatus` 带服务器回的状态码；
+ * 宿主以后可能加新码，不认识的码与没给码的旧宿主一样退回 `reason`（宿主的英文诊断串）。
+ */
+export type ConversationAttachmentUploadFailureCode = "start-failed" | "not-connected" | "rejected" | "timed-out" | "cancelled" | "failed";
 export type ConversationAttachmentUploadState = {
     status: "ready";
     environmentId: string;
@@ -660,14 +617,32 @@ export type ConversationAttachmentUploadState = {
     status: "failed";
     environmentId: string;
     reason: string;
+    code?: ConversationAttachmentUploadFailureCode;
+    httpStatus?: number;
     attachmentId?: string;
 };
+/** 宿主 `ComposerThreadDraftState` 的结构子集：一条会话输入框里的草稿。 */
+export interface ConversationComposerThreadDraft {
+    prompt: string;
+    images: ConversationComposerImageAttachment[];
+    nonPersistedImageIds: string[];
+    persistedAttachments: ConversationPersistedComposerImageAttachment[];
+    terminalContexts: ConversationTerminalContextDraft[];
+    elementContexts: ConversationElementContextDraft[];
+    previewAnnotations: ConversationPreviewAnnotationPayload[];
+    reviewComments: ConversationReviewCommentContext[];
+    modelSelectionByProvider: Readonly<Record<string, ConversationModelSelection | undefined>>;
+    nativeModeByProvider?: Readonly<Record<string, string | null | undefined>> | undefined;
+    activeProvider: ConversationProviderInstanceId | null;
+    runtimeMode: ConversationRuntimeMode | null;
+    interactionMode: ConversationProviderInteractionMode | null;
+    selectedPluginActionKey: string | null;
+}
 /**
- * 宿主 `ComposerThreadDraftState` 的结构子集 + store 的 action 面（zustand 的
- * state 与 action 同住一个对象；hook 经 api.draft.useStore 穿界，选择器读到
- * 的就是这份形状）。
+ * 草稿字段 + store 的 action 面（zustand 的 state 与 action 同住一个对象；hook 经
+ * api.draft.useStore 穿界，插件只用它取 action）。
  */
-export interface ConversationComposerDraftState {
+export interface ConversationComposerDraftState extends ConversationComposerThreadDraft {
     setPrompt(target: ConversationComposerThreadTarget, prompt: string): void;
     setTerminalContexts(target: ConversationComposerThreadTarget, contexts: ConversationTerminalContextDraft[]): void;
     setProviderModelOptions(target: ConversationComposerThreadTarget, provider: ConversationProviderDriverKind, nextProviderOptions: ReadonlyArray<ConversationProviderOptionSelection> | null | undefined, options?: {
@@ -685,22 +660,6 @@ export interface ConversationComposerDraftState {
     removePreviewAnnotation(target: ConversationComposerThreadTarget, annotationId: string): void;
     removeReviewComment(target: ConversationComposerThreadTarget, commentId: string): void;
     clearComposerPromptAndImages(target: ConversationComposerThreadTarget): void;
-    prompt: string;
-    images: ConversationComposerImageAttachment[];
-    nonPersistedImageIds: string[];
-    persistedAttachments: ConversationPersistedComposerImageAttachment[];
-    terminalContexts: ConversationTerminalContextDraft[];
-    elementContexts: ConversationElementContextDraft[];
-    previewAnnotations: ConversationPreviewAnnotationPayload[];
-    reviewComments: ConversationReviewCommentContext[];
-    modelSelectionByProvider: Readonly<Record<string, ConversationModelSelection | undefined>>;
-    /** 未发送的执行选择。缺席=仍走遗留 instanceId+model。 */
-    executionSelection?: ConversationExecutionSelection | null | undefined;
-    nativeModeByProvider?: Readonly<Record<string, string | null | undefined>> | undefined;
-    activeProvider: ConversationProviderInstanceId | null;
-    runtimeMode: ConversationRuntimeMode | null;
-    interactionMode: ConversationProviderInteractionMode | null;
-    selectedPluginActionKey: string | null;
 }
 /** 宿主 `useComposerDraftStore` 同形：zustand store hook 原样穿界。 */
 export interface ConversationComposerDraftStoreHook {
@@ -723,7 +682,6 @@ export interface ConversationEffectiveComposerModelState {
     selectedModel: string;
     selectedModelStatus: ConversationComposerModelStatus;
     modelOptions: Readonly<Record<string, ReadonlyArray<ConversationProviderOptionSelection> | undefined>> | null;
-    executionSelection?: ConversationExecutionSelection | null | undefined;
 }
 export interface ConversationPromptStashStoreState {
     entries: ReadonlyArray<ConversationPromptStashEntry>;
@@ -843,7 +801,11 @@ export interface ConversationComposerApi {
     /** 宿主 `composerDraftStore`。store hook 原样穿界，hook 规则照常适用。 */
     readonly draft: {
         useStore: ConversationComposerDraftStoreHook;
-        useThreadDraft(target: ConversationComposerThreadTarget): ConversationComposerDraftState;
+        /**
+         * 按选择器订一条会话草稿的部分字段。结果按浅比较，没变就不重渲染：正文每改一个字
+         * 草稿就换新对象，只读附件或手的组件不该跟着醒。草稿不存在时选择器拿到空草稿。
+         */
+        useThreadDraftSelector<T>(target: ConversationComposerThreadTarget, selector: (draft: ConversationComposerThreadDraft) => T): T;
         useEffectiveModelState(input: {
             threadRef?: ConversationComposerThreadTarget;
             draftId?: ConversationDraftId;
@@ -1090,8 +1052,6 @@ export interface ConversationComposerHandle {
         selectedPromptEffort: string | null;
         selectedModelOptionsForDispatch: unknown;
         selectedModelSelection: ConversationModelSelection;
-        executionSelection?: ConversationExecutionSelection | null;
-        executionReady?: boolean;
         selectedNativeModeId?: string;
         providerAvailable: boolean;
         selectedProvider: ConversationProviderDriverKind;
@@ -1334,8 +1294,6 @@ export interface ConversationQueueEntry {
     readonly attachmentNames: ReadonlyArray<string>;
     /** 在队列里等待发送（拖拽排序只作用于这些行）。 */
     readonly waiting: boolean;
-    readonly executionSelection?: ConversationExecutionSelection | undefined;
-    readonly sourceLabel?: string | undefined;
     readonly management?: {
         readonly revision: string | number;
         readonly expectedTurnId: string | null;
@@ -1381,6 +1339,325 @@ export interface ConversationQueueActions {
         readonly onInvalid: () => void;
     }): () => void;
 }
+/**
+ * 宿主数据接口的契约版本。宿主与插件各自编译进自己构建时的这个数字；两边不一致时
+ * 会话区显示版本不一致的说明，而不是拿对方读不懂的数据硬画。改动或删除已有成员、
+ * 删除 viewProps 字段、或把更多数据从 props 挪进这里时加一。
+ */
+export declare const CONVERSATION_HOST_DATA_VERSION = 14;
+/**
+ * 会话视图在 `viewCapabilities` 里声明自己读的是哪一版宿主数据接口。宿主只把会话区
+ * 交给声明了同一版的视图。
+ */
+export declare const CONVERSATION_VIEW_HOST_DATA_CAPABILITY: "ycodium.conversation.host-data.v14";
+/** 宿主数据接口读写的那条会话。`threadId` 在草稿路由上是预分配给它的会话 id。 */
+export interface ConversationThreadTarget {
+    readonly environmentId: ConversationEnvironmentId;
+    readonly threadId: ConversationThreadId;
+}
+/** 一条会话的排队读模型。服务器推新数据或连接状态变化时重新渲染调用它的组件。 */
+export interface ConversationQueueSnapshot {
+    readonly entries: readonly ConversationQueueEntry[];
+    readonly state: ConversationQueueState;
+    /** 这台机器没有连上：排队的编辑、调序、立即发送都不可用。 */
+    readonly unavailable: boolean;
+    /** 本机刚放进排队区、服务器还没登记成排队意图的提交，排队区先画占位。 */
+    readonly pendingSubmissions: readonly ConversationPendingQueueSubmission[];
+}
+/** 排队管理命令。失败时 reject，错误信息可直接给用户看。 */
+export interface ConversationQueueCommands {
+    edit(target: ConversationThreadTarget, entry: ConversationQueueEntry, message: ConversationQueuedMessageEdit): Promise<void>;
+    reorder(target: ConversationThreadTarget, entry: ConversationQueueEntry, beforeIntentId: string | null): Promise<void>;
+    run(target: ConversationThreadTarget, entry: ConversationQueueEntry, mode: "steer" | "interrupt"): Promise<void>;
+    cancel(target: ConversationThreadTarget, entry: ConversationQueueEntry): Promise<void>;
+    resume(target: ConversationThreadTarget): Promise<void>;
+    /** 同 {@link ConversationQueueActions.watchEditorAuthority}。 */
+    watchEditorAuthority(input: {
+        readonly threadKey: string;
+        readonly intentId: string;
+        readonly revision: string | number | null;
+        readonly onInvalid: () => void;
+    }): () => void;
+}
+/**
+ * 一条会话的轨迹读模型与翻页。面板不可见时保留上一份行，不因后台流式活动反复重算；
+ * 翻页与可见轮次上报是轨迹面板自己的一份，与聊天面板互不占用。
+ */
+export interface ConversationTrajectorySnapshot {
+    readonly rows: readonly ConversationTrajectoryRow[];
+    /** 行 → 聊天锚消息 id；无可锚的行返回 null。 */
+    resolveChatAnchorMessageId(row: ConversationTrajectoryRow): string | null;
+    readonly loadEarlier: {
+        readonly loading: boolean;
+        onLoadEarlier(): void;
+    } | null;
+    readonly loadLater: {
+        readonly loading: boolean;
+        onLoadLater(): void;
+    } | null;
+    /** 原生选区或编辑中的行仍占有历史正文时，不能加载会驱逐它们的新页。 */
+    readonly pagingBlockedByInteraction: boolean;
+    /** 只有最新页已可用时调用 onReady；没有更新的页时为 null。 */
+    readonly onReturnToLatest: ((onReady?: () => void) => void) | null;
+    onVisibleTurnRangeChange(range: ConversationVisibleTurnRange | null): void;
+}
+/**
+ * 聊天面板的数据窗口：翻页、回到最新页与可见轮次上报。与轨迹面板各持一份，互不占用；
+ * 面板不可见时不上报可见轮次。
+ */
+export interface ConversationChatWindow {
+    readonly loadEarlier: {
+        readonly loading: boolean;
+        onLoadEarlier(): void;
+    } | null;
+    readonly loadLater: {
+        readonly loading: boolean;
+        onLoadLater(): void;
+    } | null;
+    /** 原生选区或编辑中的行仍占有历史正文时，不能加载会驱逐它们的新页。 */
+    readonly pagingBlockedByInteraction: boolean;
+    /**
+     * 停在历史窗口或窗口正在重载时非空：把数据窗口换回最新页，到位后调用 onReady。
+     * 为 null 时最新页已经在。
+     */
+    readonly onReturnToLatest: ((onReady: () => void) => void) | null;
+    onVisibleTurnRangeChange(range: ConversationVisibleTurnRange | null): void;
+}
+/** 导出整段会话（轮次导航菜单里的复制与下载）。 */
+export interface ConversationThreadExport {
+    markdown(): string;
+    download(format: "md" | "json"): void;
+}
+/**
+ * 聊天正文的数据：服务器正文并上本机刚发出还没确认的消息、工具与计划行、每轮用量、
+ * 导出。停在历史窗口时不并本机消息。面板不可见时保留上一份，不因后台流式输出重算。
+ */
+export interface ConversationChatTimeline {
+    readonly activities: readonly ConversationThreadActivity[];
+    readonly timelineEntries: readonly ConversationTimelineEntry[];
+    readonly usageByTurnId: ReadonlyMap<string, ConversationTurnUsage>;
+    readonly export: ConversationThreadExport;
+}
+/**
+ * 输入卡只读的模式与模型上下文。字段没变时是同一个对象。
+ * `projectId` 在这条会话还没有项目、或项目还没加载时为 null。
+ */
+export interface ConversationComposerModelContext {
+    readonly runtimeMode: ConversationRuntimeMode;
+    readonly interactionMode: ConversationProviderInteractionMode;
+    readonly lockedProvider: ConversationProviderDriverKind | null;
+    readonly providerStatuses: ReadonlyArray<ConversationServerProvider>;
+    readonly projectId: ConversationProjectId | null;
+    readonly activeProjectDefaultModelSelection: ConversationModelSelection | null;
+    readonly activeThreadModelSelection: ConversationModelSelection | null;
+}
+/** 输入卡上的上下文用量：小圈的读数与点开后的三段构成。 */
+export interface ConversationContextUsage {
+    readonly window: ConversationContextWindowSnapshot | null;
+    readonly breakdown: {
+        readonly systemTokens: number;
+        readonly toolsTokens: number;
+        readonly messageTokens: number;
+    };
+}
+/** 会话正文的同步状态：loading 还没有可显示的正文，syncing 正在对齐已缓存的正文。 */
+export type ConversationThreadSyncPhase = "loading" | "syncing";
+/**
+ * 输入卡正在回答的那道 agent 提问走到哪了。没有待回答的提问时整份快照为 null。
+ */
+export interface ConversationPendingUserInputProgress {
+    readonly questionIndex: number;
+    readonly isLastQuestion: boolean;
+    readonly canAdvance: boolean;
+    readonly customAnswer: string;
+    readonly activeQuestion: {
+        readonly id: string;
+        readonly multiSelect?: boolean | undefined;
+        readonly allowFreeform?: boolean | undefined;
+    } | null;
+}
+/**
+ * 输入卡的待处理项与回答它们的命令。快照在输入没变时保持同一引用。
+ * 命令失败时 reject，错误信息可直接给用户看；中断（请求被更新的请求取代）不报错。
+ */
+export interface ConversationComposerPending {
+    readonly activePendingApproval: ConversationPendingApproval | null;
+    readonly pendingUserInputs: readonly ConversationPendingUserInput[];
+    readonly activePendingProgress: ConversationPendingUserInputProgress | null;
+    readonly activePendingResolvedAnswers: Record<string, unknown> | null;
+    readonly activePendingIsResponding: boolean;
+    readonly activePendingDraftAnswers: Record<string, ConversationPendingUserInputDraftAnswer>;
+    readonly activePendingQuestionIndex: number;
+    readonly respondingRequestIds: readonly ConversationApprovalRequestId[];
+    /** 谁占着输入区顶部，已按优先级排好；输入区一次只画第一个。 */
+    readonly occupants: readonly ConversationComposerOccupant[];
+    respondToApproval(requestId: ConversationApprovalRequestId, decision: ConversationProviderApprovalDecision, reason?: string): Promise<void>;
+    /**
+     * 回答决定卡。时间线那份是同一个回答——两处画的是同一张卡。
+     * 失败时返回错误信息，调用方写进线程错误条；成功或被更新的请求取代时为 null。
+     */
+    respondToDecision(requestId: string, optionId: string): Promise<string | null>;
+    selectUserInputOption(questionId: string, optionLabel: string): void;
+    /**
+     * 写入当前提问的自由作答。`nextCursor` 是收窄后的光标，`expandedCursor` 含被折叠的
+     * 提及；`cursorAdjacentToMention` 为真时不重新探测触发器。
+     */
+    changeUserInputCustomAnswer(questionId: string, value: string, nextCursor: number, expandedCursor: number, cursorAdjacentToMention: boolean): void;
+    /**
+     * 下一题；最后一题且答案齐了就提交。提交失败时返回错误信息，调用方写进线程错误条；
+     * 推进、答案不齐、成功或被更新的请求取代时为 null。
+     */
+    advanceUserInput(): Promise<string | null>;
+    previousUserInputQuestion(): void;
+}
+/** 轨迹工具行展开详情的回取参数。 */
+export interface ConversationToolCallDetailRequest {
+    readonly toolCallId: string;
+    readonly turnId: string | null;
+    readonly revision: string;
+}
+/**
+ * 宿主借给会话插件的数据接口。整个对象身份恒定，不随会话或渲染变化；插件在组件
+ * 顶层调用 `use*` 成员订阅自己要的那一块数据，只有这块数据变了才重新渲染。
+ * 数据来自宿主已有的连接与缓存，插件不另建连接或缓存。
+ */
+export interface ConversationHostData {
+    readonly version: typeof CONVERSATION_HOST_DATA_VERSION;
+    /** 排队区的读模型。`threadKey` 是 scope.threadKey，用来读发送流程写下的本机排队占位。 */
+    useQueue(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+    }): ConversationQueueSnapshot;
+    readonly queue: ConversationQueueCommands;
+    /**
+     * 轨迹面板的数据。`threadKey` 是 scope.threadKey，用来隔离每个 presenter 的翻页
+     * 状态；`visible` 为 false 时不重算行、不上报可见轮次。
+     */
+    useTrajectory(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+        readonly visible: boolean;
+    }): ConversationTrajectorySnapshot;
+    /** 聊天正文；参数含义同 useTrajectory。只在聊天面板挂载时调用。 */
+    useChatTimeline(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+        readonly visible: boolean;
+    }): ConversationChatTimeline;
+    /**
+     * 输入卡的上下文用量。草稿会话（服务器上还没有这条会话）为 null。只在输入卡里调用，
+     * 用量随每条回复变化，读它的组件会跟着重渲染。
+     */
+    useContextUsage(target: ConversationThreadTarget): ConversationContextUsage | null;
+    /**
+     * 输入卡只读的模式与模型上下文：四档、计划/构建、已锁的 driver、这台机器的实例表、
+     * 项目默认与这条会话落库的模型选择。`projectId` 在这条会话还没有项目时为 null。
+     * 只在输入卡里调用；字段没变时返回同一个对象。
+     */
+    useComposerModelContext(target: ConversationThreadTarget): ConversationComposerModelContext;
+    /**
+     * 这只手自己账号的额度观测。`active` 为 false（同屏里没聚焦的那一格）时不轮询，
+     * 返回 undefined；宿主还没接线（机器或实例未知）时同样是 undefined。只在额度区里调用，
+     * 轮询到的新快照只重渲染额度区。
+     */
+    useAccountUsage(input: {
+        readonly target: ConversationThreadTarget;
+        readonly active: boolean;
+    }): ConversationComposerAccountUsage | undefined;
+    /** 聊天面板的数据窗口；参数含义同 useTrajectory。 */
+    useChatWindow(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+        readonly visible: boolean;
+    }): ConversationChatWindow;
+    /** 工具行展开时回取输入/输出；宿主负责去重、代际与实时输出尾部。 */
+    useToolCallDetail(target: ConversationThreadTarget, request: ConversationToolCallDetailRequest): ConversationTrajectoryToolCallDetailData | null;
+    /**
+     * 会话正文的同步状态，未经延时。已是实时数据、草稿会话或机器未连上时为 null；
+     * 机器未连上另有机器状态提示。
+     */
+    useThreadSyncPhase(target: ConversationThreadTarget): ConversationThreadSyncPhase | null;
+    /**
+     * 输入卡的待处理项：审批、agent 提问、决定卡与谁占着输入区。`threadKey` 是
+     * scope.threadKey，草稿答案、问题序号与正在回答的请求按它在各 presenter 间共享。
+     * 审批与提问随活动流变化，读它的组件会跟着重渲染。
+     */
+    useComposerPending(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+    }): ConversationComposerPending;
+    /**
+     * 输入卡上方的横幅：机器重连与版本、项目文件夹、会话生命周期、分支不一致。宿主按会话自己取
+     * 横幅要的数据，读它的组件只随横幅相关的数据重渲染。`threadKey` 是 scope.threadKey。会话页
+     * 外没有横幅（横幅上的动作要回到宿主的输入卡与错误表）。
+     */
+    useComposerBanners(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+    }): ConversationComposerBanners;
+    /**
+     * 输入卡的会话与发送状态：阶段、发送中、为什么发不了、机器是否可用、能否压缩。宿主按会话
+     * 自己推导，字段都没变时返回同一个对象，读它的组件只随这些状态重渲染。`threadKey` 是
+     * scope.threadKey，用来读发送流程写下的本机发送进度。
+     */
+    useComposerStatus(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+    }): ConversationComposerStatus;
+    /**
+     * 这一轮现在的状态：是否在干活、卡在哪、从何时起。`threadKey` 是 scope.threadKey，
+     * 用来读发送流程写下的本机发送进度；`visible` 为 false 时保留上一份、卡住的计时也不走。
+     * 只在聊天面板挂载时调用。
+     */
+    useTurnStatus(input: {
+        readonly target: ConversationThreadTarget;
+        readonly threadKey: string;
+        readonly visible: boolean;
+    }): ConversationTurnStatus;
+    /**
+     * 输入卡的计划：已提出的计划、进行中的任务进度与步骤。草稿会话（服务器上还没有这条
+     * 会话）计划为 null、进度与步骤为 null。只在输入卡里调用。
+     */
+    useComposerPlan(target: ConversationThreadTarget): ConversationComposerPlan;
+}
+/** 这一轮现在的状态（宿主原先经时间线 props 传的那几样）。 */
+export interface ConversationTurnStatus {
+    readonly latestTurn: ConversationLatestTurn | null;
+    readonly latestAssistantMessageId: string | null;
+    /** 正在跑的那一轮；没有为 null。 */
+    readonly runningTurnId: string | null;
+    /** 本轮在干活：会话在跑，或消息刚发出、服务器还没确认。 */
+    readonly isWorking: boolean;
+    /** 工作行上那句当前步骤；不是本轮自己的计划时为 null。 */
+    readonly workingStepLabel: string | null;
+    /** 非空表示这一轮超过门槛没动静；插件只读呈现。 */
+    readonly stall: ConversationTurnStall | null;
+    readonly retry: unknown;
+    readonly activeTurnStartedAt: string | null;
+    readonly totalTurnCount: number | null;
+    readonly pendingModelSelection: ConversationModelSelection | null | undefined;
+    readonly scheduledWakes: ReadonlyArray<unknown>;
+}
+/** 输入卡的计划（宿主原先经输入卡 props 传的那几样）。 */
+export interface ConversationComposerPlan {
+    /** 最新一轮已落定后，最新一份还能实施的计划；进行中、已实施或没有为 null。 */
+    readonly proposedPlan: {
+        readonly id: string;
+        readonly planMarkdown: string;
+    } | null;
+    /** 本轮未落定时的任务进度；落定或没有为 null。 */
+    readonly tasksProgress: {
+        readonly step: string;
+        readonly completedSteps: number;
+        readonly totalSteps: number;
+    } | null;
+    /** 与进度同一轮的步骤；对不上或没有进度为 null。 */
+    readonly taskSteps: readonly {
+        readonly durationMs?: number;
+        readonly step: string;
+        readonly status: "pending" | "inProgress" | "completed";
+    }[] | null;
+}
 export interface ConversationTrajectoryRow {
     readonly id: string;
     readonly kind: string;
@@ -1465,32 +1742,18 @@ export interface ConversationShortcutLabels {
     readonly toggleTrajectory: string | null;
     readonly interrupt: string | null;
 }
-/** 时间线当前的可滚动几何；宿主用它维持跟底、发送锚点与阅读位置。 */
-export interface ConversationTimelineScrollMeasurement {
-    readonly scroll: number;
-    readonly scrollLength: number;
-    readonly contentLength: number;
-    readonly topOf: (rowId: string) => number | null;
-    readonly heightOf: (rowId: string) => number | null;
-    readonly rowAtScroll: () => {
-        readonly rowId: string;
-        readonly offsetPx: number;
-    } | null;
-}
 /**
- * 时间线插件公开给宿主的 imperative handle。滚动节点保持不透明，避免插件 API
- * 引入 DOM 类型；宿主只在自己的客户端边界把它收窄成真实元素。
+ * 宿主驱动聊天时间线的入口。跟随末尾、「回到底部」与手势停跟都归插件，宿主只在
+ * 自己发出消息后请求回到末尾。
  */
-export interface ConversationTimelineHandle {
-    readonly node: unknown;
-    readonly measure: () => ConversationTimelineScrollMeasurement | null;
-    readonly scrollToEnd: (options?: {
+export interface ConversationTimelineControl {
+    /**
+     * 解除展开阅读锁、恢复跟随并滚到末尾。聊天停在历史窗口时先经数据窗口的
+     * `onReturnToLatest` 换回最新页；时间线不可见时等重新可见再滚。
+     */
+    followEnd(options?: {
         readonly animated?: boolean;
-    }) => void;
-    readonly scrollToRow: (rowId: string, options?: {
-        readonly viewOffset?: number;
-    }) => boolean;
-    readonly scrollToOffset: (offset: number) => void;
+    }): void;
 }
 /** 可见和受交互保护的轮次；历史页保留归宿主，插件只报告当前呈现范围。 */
 export interface ConversationVisibleTurnRange {
@@ -1503,8 +1766,6 @@ export interface ConversationVisibleTurnRange {
     readonly protectedTurnIds: ReadonlyArray<ConversationTurnId>;
 }
 export interface ConversationTimelineProps {
-    readonly activities: readonly ConversationThreadActivity[];
-    readonly timelineEntries: readonly ConversationTimelineEntry[];
     /** 行派生（= ConversationViewProps.derive；时间线经 ctx 下发给行组件）。 */
     readonly derive: ConversationDeriveApi;
     /** 会话路由键：开合态、滚动落点、已读上报都按它隔离（= scope.threadKey）。 */
@@ -1513,19 +1774,8 @@ export interface ConversationTimelineProps {
     readonly threadRef: unknown;
     /** 会话所属机器（= scope.environmentId）：计划卡保存走它。 */
     readonly environmentId: string;
-    readonly latestTurn: ConversationLatestTurn | null;
-    readonly latestAssistantMessageId: string | null;
-    readonly runningTurnId: string | null;
-    readonly isWorking: boolean;
-    readonly workingStepLabel: string | null;
-    /** 非空表示这一轮超过门槛没动静；插件只读呈现。 */
-    readonly stall: ConversationTurnStall | null;
-    readonly retry: unknown;
-    readonly activeTurnStartedAt: string | null;
-    readonly totalTurnCount: number | null;
     readonly threadTitle: string;
     readonly resolveModelBadge: ((selection: ConversationModelSelection | undefined) => ConversationModelBadge | null) | undefined;
-    readonly pendingModelSelection: ConversationModelSelection | null | undefined;
     readonly markdownCwd: string | undefined;
     readonly resolvedTheme: "light" | "dark";
     readonly timestampFormat: string;
@@ -1534,35 +1784,15 @@ export interface ConversationTimelineProps {
         readonly name: string;
         readonly displayName: string;
     }>;
-    readonly anchorMessageId: string | null;
     readonly contentInsetEndAdjustment: number;
-    readonly liveFollowEnabled: boolean;
     readonly awaitingUserDecision: boolean;
     readonly hideEmptyPlaceholder: boolean;
     readonly topFadeEnabled: boolean;
-    /** 宿主滚动状态机使用的句柄；插件挂载、换节点与卸载时都必须同步。 */
-    readonly scrollerRef: {
-        current: ConversationTimelineHandle | null;
-    } | ((handle: ConversationTimelineHandle | null) => void);
-    readonly loadEarlier: {
-        readonly loading: boolean;
-        onLoadEarlier(): void;
-    } | null;
-    readonly loadLater?: {
-        readonly loading: boolean;
-        onLoadLater(): void;
-    } | null;
-    /** 原生选区或编辑中的行仍占有历史正文时，不能加载会驱逐它们的新页。 */
-    readonly pagingBlockedByInteraction?: boolean;
-    readonly onReturnToLatest?: (() => void) | null;
-    readonly onVisibleTurnRangeChange?: ((range: ConversationVisibleTurnRange | null) => void) | null;
-    readonly revealMessageRequest: {
-        readonly rowId: string;
-        readonly nonce: number;
-    } | null;
-    readonly usageByTurnId: ReadonlyMap<string, ConversationTurnUsage>;
+    /** 宿主拿到的时间线控制入口；插件在挂载、换会话与卸载时同步它。 */
+    readonly controlRef: {
+        current: ConversationTimelineControl | null;
+    } | ((control: ConversationTimelineControl | null) => void);
     readonly agentPanelModel: unknown;
-    readonly scheduledWakes: ReadonlyArray<unknown>;
     /** 草稿/断开会话传 null：决定卡只显示状态、无按钮。 */
     readonly onRespondToDecision: ((requestId: string, optionId: string) => void) | null;
     readonly onInterrupt: (() => void) | null;
@@ -1571,15 +1801,6 @@ export interface ConversationTimelineProps {
     readonly onForkFromUserMessage: ((messageId: string) => void) | null;
     readonly onImageExpand: (preview: unknown) => void;
     readonly onOpenAgents: (() => void) | null;
-    onAnchorReady(messageId: string, anchor: {
-        readonly rowId: string;
-        readonly lastRowId: string | null;
-    }): void;
-    onRowsChange(lastRowId: string | null): void;
-    onIsAtEndChange(isAtEnd: boolean): void;
-    onManualNavigation(): void;
-    onDisclosureNavigation(): void;
-    onRevealMessageHandled(): void;
     /**
      * 工具呈现接缝：一组工具/过程行的展开体。宿主先用现有实现渲染，接
      * tool-display 插件后改指其视图；缺省时插件画极简回退（标题+摘要）。
@@ -1609,11 +1830,6 @@ export interface ConversationTimelineProps {
     };
     /** 已读上报：可见帧内最后一条完成消息变化时由宿主标记。 */
     useVisibleThreadCompletion(input: unknown): void;
-    /** 导出（md/json）由宿主构建：读的是完整视图模型，插件只触发。 */
-    readonly export: {
-        markdown(): string;
-        download(format: "md" | "json"): void;
-    };
     /**
      * 计划卡「保存到工作区」的宿主 RPC（写文件走宿主命令管线）。null 时不画
      * 该菜单项（草稿会话、环境断开）。
@@ -1642,46 +1858,12 @@ export interface ConversationTrajectoryToolCallDetailData {
     readonly input?: string | undefined;
     readonly output?: string | undefined;
 }
+/**
+ * 轨迹面板里宿主仍要给的部分。行、翻页与工具详情由插件经 {@link ConversationHostData}
+ * 自己读；在轨迹中选中一行后切回聊天定位由插件自己协调。
+ */
 export interface ConversationTrajectoryProps {
-    readonly rows: readonly ConversationTrajectoryRow[];
-    readonly loadEarlier: {
-        readonly loading: boolean;
-        onLoadEarlier(): void;
-    } | null;
-    readonly loadLater?: {
-        readonly loading: boolean;
-        onLoadLater(): void;
-    } | null;
-    /** 原生选区或编辑中的行仍占有历史正文时，不能加载会驱逐它们的新页。 */
-    readonly pagingBlockedByInteraction?: boolean;
-    /** 只有最新页已可用时调用 onReady；被交互保护拒绝的导航不能切换跟随。 */
-    readonly onReturnToLatest?: ((onReady?: () => void) => void) | null;
-    readonly onVisibleTurnRangeChange?: ((range: ConversationVisibleTurnRange | null) => void) | null;
     readonly timestampFormat: string;
-    /** 保活隐藏时为 false：不量几何、不碰布局、不跟随。 */
-    readonly paneVisible: boolean;
-    /** 宿主 ScopedThreadRef（对插件不透明）：工具详情懒加载按它寻址。 */
-    readonly threadRef: unknown;
-    /** 行 → 聊天锚消息 id；无可锚的行返回 null（不画出不去的按钮）。 */
-    resolveChatAnchorMessageId(row: ConversationTrajectoryRow): string | null;
-    onOpenInChat(rowId: string): void;
-    /**
-     * 工具行展开详情的懒加载 hook 接缝：宿主绑定现有 useToolCallDetailState
-     * （scoped ref / turnId / revision / enabled），只读结果供行组件使用。RPC、
-     * 代际、去重、实时输出尾部都归宿主机制；插件在组件顶层调用（hook 规则）。
-     */
-    readonly useToolCallDetail?: ((input: ConversationTrajectoryToolCallDetailRequest) => ConversationTrajectoryToolCallDetailData | null) | undefined;
-}
-export interface ConversationQueueProps {
-    readonly entries: readonly ConversationQueueEntry[];
-    /** 可选以兼容尚未提供乐观队列占位的宿主。 */
-    readonly pendingSubmissions?: readonly ConversationPendingQueueSubmission[] | undefined;
-    readonly state: ConversationQueueState;
-    readonly environmentId: string;
-    readonly unavailable: boolean;
-    readonly actions: ConversationQueueActions;
-    onCancel(entry: ConversationQueueEntry): Promise<void>;
-    onResume(): Promise<void>;
 }
 /** 输入卡上方的横幅堆条目（宿主算好顺序；icon/title 等是宿主创建的节点，插件原样渲染）。 */
 export interface ConversationComposerBannerItem {
@@ -1700,6 +1882,35 @@ export interface ConversationComposerBannerItem {
     readonly dismissLabel?: string | undefined;
     readonly onDismiss?: (() => void) | undefined;
 }
+/** 输入卡上方的横幅堆（宿主排好了顺序）与横幅带出的宿主浮层。 */
+export interface ConversationComposerBanners {
+    readonly items: ReadonlyArray<ConversationComposerBannerItem>;
+    /** 宿主 React 节点（例如切回分支前的确认框），插件原样挂在输入卡旁；没有时为 null。 */
+    readonly overlay: unknown;
+}
+/** 输入卡读的会话与发送状态（`ConversationHostData.useComposerStatus`）。 */
+export interface ConversationComposerStatus {
+    readonly activeThreadId: ConversationThreadId | null;
+    /** 只读这些 meta 字段；宿主给低频 meta 视图而不是完整 detail。 */
+    readonly activeThread: Pick<ConversationThreadMeta, "id" | "session" | "latestTurn" | "presetId" | "nativeModeId"> | undefined;
+    readonly isLocalDraftThread: boolean;
+    /** 草稿会话还没有项目，发不出去。 */
+    readonly projectSelectionRequired: boolean;
+    readonly phase: ConversationSessionPhase;
+    /** 消息刚发出、服务器还没确认。 */
+    readonly isSendBusy: boolean;
+    /** 发送被挡下的原因（宿主解析好的文案）；能发时为 null。 */
+    readonly sendDisabledReason: string | null;
+    /** 刚发出的消息在等新 worktree 建好。 */
+    readonly isPreparingWorktree: boolean;
+    /** 会话所在机器没连上时，它的名字与连接状态。 */
+    readonly environmentUnavailable: {
+        readonly label: string;
+        readonly connection: ConversationEnvironmentConnectionPresentation;
+    } | null;
+    readonly compactDisabled: boolean;
+    readonly compactDisabledReason: string | null;
+}
 export interface ConversationComposerProps {
     /** 宿主注入的 composer API（store/hook/纯函数面）。 */
     api: ConversationComposerApi;
@@ -1710,87 +1921,16 @@ export interface ConversationComposerProps {
     routeKind: "server" | "draft";
     routeThreadRef: ConversationScopedThreadRef;
     draftId: ConversationDraftId | null;
-    activeThreadId: ConversationThreadId | null;
-    activeThreadEnvironmentId: ConversationEnvironmentId | undefined;
-    /** 只读这些 meta 字段；宿主传低频 meta 视图而不是完整 detail。 */
-    activeThread: Pick<ConversationThreadMeta, "id" | "session" | "latestTurn" | "presetId" | "nativeModeId"> | undefined;
-    isServerThread: boolean;
-    isLocalDraftThread: boolean;
     forceExpandedOnMobile: boolean;
-    projectSelectionRequired: boolean;
-    phase: ConversationSessionPhase;
-    isConnecting: boolean;
-    isSendBusy: boolean;
-    sendDisabledReason: string | null;
-    isPreparingWorktree: boolean;
-    externalDrawerAttached: boolean;
-    environmentUnavailable: {
-        readonly label: string;
-        readonly connection: ConversationEnvironmentConnectionPresentation;
-    } | null;
-    activePendingApproval: ConversationPendingApproval | null;
-    /** 回答决定卡。时间线那份是同一个回调——两处画的是同一张卡。 */
-    onRespondToComposerDecision: (requestId: string, optionId: string) => void;
-    pendingUserInputs: ConversationPendingUserInput[];
-    activePendingProgress: {
-        questionIndex: number;
-        isLastQuestion: boolean;
-        canAdvance: boolean;
-        customAnswer: string;
-        activeQuestion: {
-            id: string;
-            multiSelect?: boolean | undefined;
-            allowFreeform?: boolean | undefined;
-        } | null;
-    } | null;
-    activePendingResolvedAnswers: Record<string, unknown> | null;
-    activePendingIsResponding: boolean;
-    activePendingDraftAnswers: Record<string, ConversationPendingUserInputDraftAnswer>;
-    activePendingQuestionIndex: number;
-    respondingRequestIds: ConversationApprovalRequestId[];
-    /** 谁占着输入区顶部，已按优先级排好；输入区一次只画第一个。 */
-    occupants: ReadonlyArray<ConversationComposerOccupant>;
-    showPlanFollowUpPrompt: boolean;
-    activeProposedPlan: ConversationThreadMeta["proposedPlans"][number] | null;
-    activeTasksProgress: unknown;
-    activeTaskSteps: readonly unknown[] | null;
-    runtimeMode: ConversationRuntimeMode;
-    interactionMode: ConversationProviderInteractionMode;
-    lockedProvider: ConversationProviderDriverKind | null;
-    providerStatuses: ConversationServerProvider[];
-    activeProjectDefaultModelSelection: ConversationModelSelection | null | undefined;
-    projectId?: ConversationProjectId | null;
-    activeThreadModelSelection: ConversationModelSelection | null | undefined;
-    selectedExecutionSelection?: ConversationExecutionSelection | null | undefined;
-    composerChoices?: ReadonlyArray<ConversationComposerChoice> | undefined;
-    selectedExecutionReady?: boolean | undefined;
-    selectedModelOptionDescriptors?: ReadonlyArray<ConversationProviderOptionDescriptor> | undefined;
-    onModelPickerOpenChange?: ((open: boolean) => void) | undefined;
-    onClearExecutionSelection?: (() => void) | undefined;
-    runningExecutionSelection?: ConversationExecutionSelection | null | undefined;
-    executionAppliesTo?: ConversationExecutionAppliesTo | undefined;
-    /**
-     * 所选来源的额度观测。宿主注入共享查询结果；缺席表示宿主尚未接线。
-     * 插件只渲染这份 props，不自行取数。
-     */
-    sourceMetrics?: ConversationComposerSourceMetrics | undefined;
-    activeContextWindow: ConversationContextWindowSnapshot | null;
-    /** 点开小圈的三段构成；缺席时只画已用/窗口。 */
-    activeContextBreakdown?: {
-        readonly systemTokens: number;
-        readonly toolsTokens: number;
-        readonly messageTokens: number;
-    } | null;
     /**
      * 输入区座位。骨架调用 `renderSlot`；整条输入区被占住时走 `renderSlotChain`。
-     * 缺席（测试）时骨架画内置默认控件。
+     * 缺席（测试）时骨架画内置默认控件。`fallback` 是骨架的内置控件：座位无人占用、
+     * 或占用者渲染时抛错，宿主都画它，一个插件的控件坏掉不会连带整块会话区。
      */
     slots?: {
-        readonly renderSlot: (name: string, owner?: unknown) => unknown;
+        readonly renderSlot: (name: string, owner?: unknown, fallback?: unknown) => unknown;
         readonly renderSlotChain: (name: string, owner: unknown, fallback: unknown) => unknown;
     };
-    compactDisabled: boolean;
-    compactDisabledReason: string | null;
     resolvedTheme: "light" | "dark";
     settings: ConversationUnifiedSettings;
     keybindings: ConversationResolvedKeybindingsConfig;
@@ -1822,9 +1962,10 @@ export interface ConversationComposerProps {
     composerRef: {
         current: ConversationComposerHandle | null;
     } | ((handle: ConversationComposerHandle | null) => void);
+    /** `steer`：agent 在干活时照常排队，再请当前这一轮接住它；没在干活时与普通发送相同。 */
     onSend: (e?: {
         preventDefault: () => void;
-    }, intent?: "foreground" | "background") => void;
+    }, intent?: "foreground" | "background" | "steer") => void;
     onInterrupt: () => void;
     /** Esc 两段式停止已武装：停止按钮显示「再按一次」态。缺席按 false。 */
     interruptArmed?: boolean;
@@ -1839,18 +1980,12 @@ export interface ConversationComposerProps {
     /** 派发原生压缩命令。服务端按 adapter 能力位执行，不再伪造一条 `/compact` 消息。 */
     onCompactContext: () => void;
     onImplementPlanInNewThread: () => void;
-    onRespondToApproval: (requestId: ConversationApprovalRequestId, decision: ConversationProviderApprovalDecision, reason?: string) => Promise<unknown>;
-    onSelectActivePendingUserInputOption: (questionId: string, optionLabel: string) => void;
-    onAdvanceActivePendingUserInput: () => void;
-    onPreviousActivePendingUserInputQuestion: () => void;
-    onChangeActivePendingUserInputCustomAnswer: (questionId: string, value: string, nextCursor: number, expandedCursor: number, cursorAdjacentToMention: boolean) => void;
     /** 点了某个实例下的一行模型：`model` 归 `instanceId`。 */
     onProviderModelSelect: (instanceId: ConversationProviderInstanceId, model: string) => void;
     /** 选手格换手：`carried` 是换手前的选择，型号归不归新手由宿主判，选手格不猜。 */
     onProviderInstanceSelect: (instanceId: ConversationProviderInstanceId, carried: ConversationModelSelection) => void;
     /** 选择器(模型或档位)一改就把合成后的选择交出去，由宿主立刻落库。 */
     onModelSelectionChosen?: ((selection: ConversationModelSelection) => void) | undefined;
-    onExecutionSelectionChosen?: ((selection: ConversationExecutionSelection, choice: ConversationComposerChoice) => void) | undefined;
     /** 选中 / 清空团队。传 null 表示回到单模型；选模型时由宿主用它清掉团队。 */
     onSelectPluginAction: (teamId: string | null) => void;
     /** 跳到设置里的 Teams 位置。 */
@@ -1884,8 +2019,6 @@ export interface ConversationComposerProps {
     readonly terminalControl?: unknown;
     /** 输入卡下缘内容（分支工具条等宿主工作区控件），原样渲染。 */
     readonly belowSlot: unknown;
-    /** 排队列表上方的横幅堆（同步提示等）：条目数据，插件用自己的栈渲染。 */
-    readonly bannerItems: ReadonlyArray<ConversationComposerBannerItem>;
     /** 草稿首条消息的居中大标题态。 */
     readonly draftHero: {
         readonly active: boolean;
@@ -1896,10 +2029,10 @@ export interface ConversationComposerProps {
         readonly composerTransitionName?: string | undefined;
         readonly headlineTransitionName?: string | undefined;
     };
-    readonly attached: boolean;
     readonly contextStrip: boolean;
     /**
-     * 浮层根元素上报：宿主量它的高度给时间线让位（contentInsetEndAdjustment）。
+     * 浮层根元素上报：宿主量它的高度给时间线让位（contentInsetEndAdjustment），
+     * 并在其中找 `[data-chat-composer-stack="true"]` 量输入卡占的列（浮动预览可停在两侧留白）。
      * 卸载时以 null 收尾。元素对契约不透明（本文件不引 DOM 类型）。
      */
     readonly onOverlayElementChange?: ((element: unknown) => void) | undefined;
@@ -1910,9 +2043,12 @@ export interface ConversationViewProps {
     readonly mode: ConversationModeProps;
     readonly shortcuts: ConversationShortcutLabels;
     readonly derive: ConversationDeriveApi;
+    /**
+     * 宿主数据接口。老版本宿主不给；插件发现缺席或版本不同时显示版本不一致的说明。
+     */
+    readonly data?: ConversationHostData | undefined;
     readonly timeline: ConversationTimelineProps;
     readonly trajectory: ConversationTrajectoryProps;
-    readonly queue: ConversationQueueProps;
     readonly composer: ConversationComposerProps;
     readonly attachments: ConversationAttachmentsApi;
 }