@ycodium-ai/plugin-api 0.2.2968 → 0.2.2974

package/dist/conversation.d.ts

@@ -26,1256 +26,31 @@
  * @module @ycodium-ai/plugin-api/conversation
  */
 import type { ConversationComposerAccountUsage } from "./account-usage.ts";
-import type { ConversationPresetApi } from "./conversationPresets.ts";
-import type { ConversationAttachmentDocumentOpen, ConversationAttachmentsApi, ConversationMessageAttachment, ConversationPastedTextSource } from "./conversationAttachments.ts";
 export type * from "./conversationAttachments.ts";
-import type { ConversationAssistantQuoteApi, ConversationMessageLinkText, ConversationThreadReferenceApi } from "./conversationMessageLinks.ts";
+import type { ConversationAssistantQuoteApi, ConversationThreadReferenceApi } from "./conversationMessageLinks.ts";
 export type * from "./conversationMessageLinks.ts";
 export { CONVERSATION_ASSISTANT_QUOTE_OPEN_EVENT, CONVERSATION_THREAD_REFERENCE_OPEN_EVENT, } from "./conversationMessageLinks.ts";
-import type { ConversationShellCommand, ConversationWorktreeSetupProgress } from "./conversationComposerParts.ts";
+import type { ConversationShellCommand } from "./conversationComposerParts.ts";
 export type * from "./conversationComposerParts.ts";
-import type { ConversationServerProviderSkill, ConversationServerProviderSlashCommand, ConversationTimelineSkill } from "./conversationSkills.ts";
 export type * from "./conversationSkills.ts";
 import type { ConversationCommunicationRecord, ConversationTrajectoryRow } from "./conversationTrajectory.ts";
 export type * from "./conversationTrajectory.ts";
 import type { ConversationQueuedMessageEdit, ConversationQueueEntry, ConversationPendingQueueSubmission, ConversationQueueState } from "./conversation-queue.ts";
-import type { ConversationWorkEntry } from "./conversationWorkEntry.ts";
 export type * from "./conversationWorkEntry.ts";
 export type { AccountUsageCapability, AccountUsageCredentialIdentity, AccountUsageMetric, AccountUsageMetricKind, AccountUsageRefreshOutcome, AccountUsageRefreshResult, AccountUsageResetOutcome, AccountUsageScopeKind, AccountUsageSnapshot, AccountUsageUnit, ConversationComposerAccountUsage, } from "./account-usage.ts";
-/** 时间线派生输入。插件只透传，不解读。 */
-export type ConversationTimelineEntry = unknown;
-/** 会话活动流。插件只透传给宿主派生函数，不解读。 */
-export type ConversationThreadActivity = unknown;
-export type ConversationMessageRole = "user" | "assistant" | "system";
-export interface ConversationMessageAuthor {
-    readonly userId: string;
-    readonly displayName: string;
-}
-/** 消息行的可渲染子集（宿主 `ChatMessage` 的结构子集）。 */
-export interface ConversationChatMessage {
-    readonly id: string;
-    readonly role: ConversationMessageRole;
-    readonly text: string;
-    readonly turnId: string | null;
-    readonly streaming: boolean;
-    readonly createdAt: string;
-    /** 助手元信息行的时间取它（流式结束后才画）。 */
-    readonly updatedAt: string;
-    readonly attachments?: ReadonlyArray<ConversationMessageAttachment> | undefined;
-    readonly author?: ConversationMessageAuthor | null | undefined;
-    readonly modelSelection?: ConversationModelSelection | undefined;
-}
-/** 助手消息上的模型徽章（宿主 `AssistantModelBadge` 的结构子集）。 */
-export interface ConversationModelBadge {
-    readonly instanceId: string;
-    /** 实例已被删掉又猜不出 driver 时为 null。 */
-    readonly driverKind: string | null;
-    readonly providerDisplayName: string;
-    readonly accentColor: string | undefined;
-    readonly modelLabel: string;
-    readonly effortLabel: string | null;
-    readonly effortLevel?: string | null;
-    readonly identity: string;
-}
-/** 轮次页脚（宿主 `TurnFooterPresentation` 的结构子集）。 */
-export interface ConversationTurnFooter {
-    readonly turnId: string;
-    readonly state: string;
-    readonly completedAt?: string | undefined;
-    readonly workingElapsedMs?: number | undefined;
-    readonly outputTokens?: number | undefined;
-}
-/** 逐轮用量（宿主 `TurnUsagePresentation` 的结构子集）。 */
-export interface ConversationTurnUsage {
-    readonly turnId: string;
-    readonly outputTokens?: number | undefined;
-    readonly inputTokens?: number | undefined;
-    readonly cachedInputTokens?: number | undefined;
-    readonly reasoningOutputTokens?: number | undefined;
-    /**
-     * `inputTokens` 与 `cachedInputTokens` 互斥，相加得总输入，可以据此算命中率。
-     * 缺席或为假时 `inputTokens` 含缓存，两者不能相加——那一轮别显示比率。
-     */
-    readonly cacheDisjoint?: boolean | undefined;
-}
-/** 建议计划卡片（宿主 `ProposedPlan` 的结构子集）。 */
-export interface ConversationProposedPlan {
-    readonly id: string;
-    readonly turnId: string | null;
-    readonly planMarkdown: string;
-    readonly implementedAt: string | null;
-    readonly implementationThreadId: string | null;
-    readonly createdAt: string;
-}
-/** 一轮的计划步骤条（宿主 `TurnPlanEntry` 的结构子集）。 */
-export interface ConversationTurnPlan {
-    readonly id: string;
-    readonly createdAt: string;
-    readonly turnId: string | null;
-    readonly plan: {
-        readonly createdAt: string;
-        readonly explanation?: string | null | undefined;
-        readonly steps: ReadonlyArray<{
-            readonly durationMs?: number | undefined;
-            readonly step: string;
-            readonly status: string;
-        }>;
-    };
-}
-export type ConversationDraftId = string;
-export type ConversationThreadId = string;
-export type ConversationEnvironmentId = string;
-export interface ConversationScopedThreadRef {
-    /** 宿主给的引用对象；别当字符串解析。只需线程 id 的接口应直接收 {@link ConversationThreadId}。 */
-    readonly environmentId: ConversationEnvironmentId;
-    readonly threadId: ConversationThreadId;
-}
-export type ConversationTurnId = string;
-export type ConversationProjectId = string;
-export type ConversationApprovalRequestId = string;
-export type ConversationProviderInstanceId = string;
-export type ConversationProviderDriverKind = string;
-export type ConversationProviderRequestKind = "command" | "file-read" | "file-change" | "web-fetch" | "web-search" | "skill" | "mcp-tool" | "mcp-elicitation" | "tool";
-export type ConversationRuntimeMode = string;
-export type ConversationRuntimeModeSwitch = "in-session" | "next-turn";
-export type ConversationProviderInteractionMode = "default" | "plan";
-export type ConversationProviderDeclineReasonRelay = "none" | "native" | "queued";
-/** composer 目标：已存在的会话或尚未落库的草稿。 */
-export type ConversationComposerThreadTarget = ConversationScopedThreadRef | ConversationDraftId;
-export interface ConversationModelSelection {
-    instanceId: ConversationProviderInstanceId;
-    model: string;
-    options?: ReadonlyArray<ConversationProviderOptionSelection> | undefined;
-}
-export interface ConversationProviderOptionSelection {
-    id: string;
-    value: string | boolean;
-}
-export type ConversationProviderOptionDescriptor = {
-    type: "select";
-    id: string;
-    label: string;
-    description?: string | undefined;
-    currentValue?: string | undefined;
-    options: ReadonlyArray<{
-        id: string;
-        label: string;
-        description?: string | undefined;
-        isDefault?: boolean | undefined;
-    }>;
-    /** 旧目录可带的 prompt 注入型取值标记；保留形状供解码，宿主不据此改写正文。 */
-    promptInjectedValues?: ReadonlyArray<string> | undefined;
-} | {
-    type: "boolean";
-    id: string;
-    label: string;
-    description?: string | undefined;
-    currentValue?: boolean | undefined;
-};
-export interface ConversationModelCapabilities {
-    optionDescriptors?: ReadonlyArray<ConversationProviderOptionDescriptor> | undefined;
-}
-export interface ConversationServerProviderModel {
-    slug: string;
-    name: string;
-    shortName?: string | undefined;
-    subProvider?: string | undefined;
-    isDefault?: boolean | undefined;
-    isCustom?: boolean | undefined;
-    aliases?: ReadonlyArray<string> | undefined;
-    capabilities?: ConversationModelCapabilities | undefined;
-}
-export interface ConversationServerProviderNativeMode {
-    id: string;
-    name: string;
-    description?: string | undefined;
-}
-/** 宿主 `ServerProvider` 的结构子集（composer 子树读到的字段）。 */
-export interface ConversationServerProvider {
-    instanceId: ConversationProviderInstanceId;
-    driver: ConversationProviderDriverKind;
-    displayName?: string | undefined;
-    enabled: boolean;
-    installed: boolean;
-    accentColor?: string | undefined;
-    continuation?: {
-        groupKey?: string | undefined;
-    } | undefined;
-    readiness: {
-        state: string;
-        detail?: string | undefined;
-    };
-    supportsNativeModeSwitch?: boolean | undefined;
-    supportsContextCompaction?: boolean | undefined;
-    /**
-     * 改权限模式什么时候生效，宿主按执行器名片算好交过来。缺席按 `"next-turn"`：
-     * 多标一句「下一轮生效」只是保守，反过来会骗用户说已经切了。
-     *
-     * 插件**不得**按 driver 名字自己推这一位——名片会在手搬进插件时改，抄一份名单
-     * 就会照旧行为提示。
-     */
-    runtimeModeSwitch?: ConversationRuntimeModeSwitch | undefined;
-    showInteractionModeToggle?: boolean | undefined;
-    /** 名片的旧型号 slug 别名（旧 → 现行），宿主经快照带来；缺席 = 不改写。经 `model.buildSlugAliases` 读。 */
-    modelSlugAliases?: {
-        readonly [slug: string]: string;
-    } | undefined;
-    currentNativeModeId?: string | undefined;
-    nativeModes?: ReadonlyArray<ConversationServerProviderNativeMode> | undefined;
-    /** 没选过档的线程四档各落哪一档。只经 `model.resolveNativeMode` 读，插件不自己查。 */
-    nativeModeByRuntimeMode?: {
-        readonly [runtimeMode: string]: string;
-    } | undefined;
-    versionAdvisory?: {
-        latestVersion?: string | null | undefined;
-    } | undefined;
-    models: ReadonlyArray<ConversationServerProviderModel>;
-    skills?: ReadonlyArray<ConversationServerProviderSkill> | undefined;
-    slashCommands?: ReadonlyArray<ConversationServerProviderSlashCommand> | undefined;
-    auth: {
-        status: string;
-        email?: string | undefined;
-    };
-    /** 快照还有 version / checkedAt 等字段；子集不列举，收窄断言时原样穿过。 */
-    [key: string]: unknown;
-}
-/** 宿主 `ProviderInstanceEntry`（web providerInstances.ts）的结构子集。 */
-export interface ConversationProviderInstanceEntry {
-    instanceId: ConversationProviderInstanceId;
-    driverKind: ConversationProviderDriverKind;
-    displayName: string;
-    /** 这一格坐的是哪双手（品牌名）。昵称在 `displayName`，两者可能不同。 */
-    agentName?: string | undefined;
-    accentColor?: string | undefined;
-    accountEmail?: string | undefined;
-    continuationGroupKey?: string | undefined;
-    enabled: boolean;
-    installed: boolean;
-    readiness: string;
-    snapshot: ConversationServerProvider;
-    models: ReadonlyArray<ConversationServerProviderModel>;
-}
-export interface ConversationAppModelOption {
-    slug: string;
-    name: string;
-    shortName?: string | undefined;
-    subProvider?: string | undefined;
-    description?: string | undefined;
-    isDefault?: boolean | undefined;
-    aliases?: ReadonlyArray<string> | undefined;
-    /** 这个实例的目录里暂时没有它，只因为本线程存着才列出来（OpenCode）。 */
-    isUnavailable?: boolean | undefined;
-}
-export interface ConversationModelFavorite {
-    environmentId: ConversationEnvironmentId;
-    instanceId: ConversationProviderInstanceId;
-    model: string;
-}
-/** 宿主 `UnifiedSettings` 的结构子集（composer 子树读到的字段）。 */
-export interface ConversationUnifiedSettings {
-    planModeEnabled: boolean;
-    showSkillsInSlashMenu: boolean;
-    providerInstances?: Readonly<Record<string, unknown>> | undefined;
-    [key: string]: unknown;
-}
-export type ConversationResolvedKeybindingsConfig = ReadonlyArray<{
-    command: string;
-    shortcut: string;
-    whenAst?: unknown;
-}>;
-export type ConversationKeybindingCommand = string;
-export type ConversationProviderApprovalDecision = "accept" | "acceptForSession" | "acceptAlways" | "decline" | "cancel";
-export interface ConversationProviderApprovalOption {
-    decision: ConversationProviderApprovalDecision;
-    label: string;
-    id?: string | undefined;
-    description?: string | undefined;
-}
-export interface ConversationProviderRequestArg {
-    name: string;
-    value: string;
-}
-export interface ConversationProviderRequestFileChange {
-    path: string;
-    /** 服务端摊平过的变更内容：unified diff 或待替换的旧/新文本。 */
-    content?: {
-        kind: "unified";
-        diff: string;
-    } | {
-        kind: "replace";
-        oldText?: string | undefined;
-        newText: string;
-    } | undefined;
-    omitted?: string | undefined;
-    additions?: number | undefined;
-    deletions?: number | undefined;
-}
-/** 宿主 `session-logic.PendingApproval` 的结构子集。 */
-export interface ConversationPendingApproval {
-    requestId: ConversationApprovalRequestId;
-    requestKind: ConversationProviderRequestKind;
-    createdAt: string;
-    detail?: string | undefined;
-    appName?: string | undefined;
-    options?: ReadonlyArray<ConversationProviderApprovalOption> | undefined;
-    declineReasonRelay?: ConversationProviderDeclineReasonRelay | undefined;
-    args?: ReadonlyArray<ConversationProviderRequestArg> | undefined;
-    fileChanges?: ReadonlyArray<ConversationProviderRequestFileChange> | undefined;
-    turnId?: ConversationTurnId | undefined;
-}
-export interface ConversationUserInputQuestionOption {
-    id?: string | undefined;
-    label: string;
-    description?: string | undefined;
-    /** 计划审批选项的语义；`kind: "plan"` 的题上带了它，就用界面自己的文案代替 label / description。 */
-    planAction?: "approve" | "revise" | "stop" | undefined;
-}
-export interface ConversationUserInputQuestion {
-    id: string;
-    header?: string | undefined;
-    question: string;
-    multiSelect?: boolean | undefined;
-    allowFreeform?: boolean | undefined;
-    kind?: string | undefined;
-    options: ReadonlyArray<ConversationUserInputQuestionOption>;
-}
-/** 宿主 `session-logic.PendingUserInput` 的结构子集。 */
-export interface ConversationPendingUserInput {
-    requestId: ConversationApprovalRequestId;
-    createdAt: string;
-    questions: ReadonlyArray<ConversationUserInputQuestion>;
-}
-/** 还没回答也没忽略的异步提问：agent 没停下等，回答作为下一条消息发出，也可以不答。 */
-export interface ConversationPendingQuestion {
-    readonly requestId: ConversationApprovalRequestId;
-    readonly createdAt: string;
-    readonly turnId: ConversationTurnId | null;
-    readonly questions: ReadonlyArray<ConversationUserInputQuestion>;
-}
-/**
- * 一条会话里没关的异步提问与回答、忽略它们的动作。快照在提问没变时保持同一引用。
- * 动作失败时返回可以直接给用户看的话，成功（或被更新的请求取代）时为 null。
- */
-export interface ConversationQuestions {
-    readonly pending: readonly ConversationPendingQuestion[];
-    /** 每题一个答案，多选给字符串数组；有题没答服务器会拒绝。 */
-    answer(requestId: string, answers: Readonly<Record<string, string | readonly string[]>>): Promise<string | null>;
-    dismiss(requestId: string): Promise<string | null>;
-}
-export interface ConversationPendingUserInputDraftAnswer {
-    selectedOptionLabels?: string[];
-    customAnswer?: string;
-    /** 这道题随答案带的附件数；只有允许自由作答的题才有。 */
-    attachmentCount?: number;
-    /** 附件还在上传或上传失败：这道题暂时不能提交。 */
-    attachmentsBlocked?: boolean;
-}
-/**
- * 决定卡：插件或宿主功能问用户一个问题（宿主 `ThreadDecisionCard` 的结构子集）。
- *
- * 跟审批不是一回事：审批是 agent 要做一件事求许可，决定卡是**插件**在问
- * （`askedBy.kind === "plugin"` 时卡上显示是谁问的）。
- *
- * `text` 是英文原文，`key` 有值时按 catalog 解——这个模块只搬 key，不解析。
- */
-export interface ConversationThreadDecisionText {
-    readonly text: string;
-    readonly key?: string | undefined;
-    readonly params?: Readonly<Record<string, string | number>> | undefined;
-}
-export interface ConversationThreadDecisionOption {
-    readonly id: string;
-    readonly label: ConversationThreadDecisionText;
-    /** 只影响按钮档位；`danger` 用于「这一下会拆掉东西」。 */
-    readonly tone?: "default" | "primary" | "danger" | undefined;
-}
-export interface ConversationThreadDecisionCard {
-    /** 已作废的历史卡为 null；回答时必须有它。 */
-    readonly requestId: string | null;
-    readonly askedBy: {
-        readonly kind: "plugin";
-        readonly pluginId: string;
-    } | {
-        readonly kind: "host";
-        readonly feature: string;
-    };
-    readonly title: ConversationThreadDecisionText;
-    readonly body: ReadonlyArray<ConversationThreadDecisionText>;
-    readonly detail: {
-        readonly text: string;
-        readonly language?: string | undefined;
-    } | null;
-    readonly options: ReadonlyArray<ConversationThreadDecisionOption>;
-    /** null 表示还等人答。 */
-    readonly outcome: string | null;
-}
-/**
- * 输入区被谁占着——`@ycodium/client-runtime` 选举结果（`ComposerOccupant`）的结构
- * 镜像，四种都在。决定卡两处都画：输入区上方钉一张（要人回答），消息流里留一行
- * （`WorkRows.tsx` 的 `DecisionCardRow`，回头能翻到当时问的是什么）——审批与
- * agent 提问本来就是这个待遇，决定卡在 2026-09-17 之前只有后一半。
- *
- * 宿主构造时**不要 `as` 强转**：那会把两边的编译期互锁掐断。宿主形状与这份镜像的
- * 可赋值关系由 `apps/web` 的 `composerOccupantContract.test.ts` 守着。
- */
-export type ConversationComposerOccupant = {
-    readonly kind: "approval";
-    readonly approval: ConversationPendingApproval;
-    readonly pendingCount: number;
-} | {
-    readonly kind: "decision";
-    /** 宿主 `ThreadDecisionState` 的结构子集：卡在 `card` 里，外层那几个字段插件用不到。 */
-    readonly decision: {
-        readonly card: ConversationThreadDecisionCard;
-    };
-    readonly pendingCount: number;
-} | {
-    readonly kind: "user-input";
-    readonly userInput: ConversationPendingUserInput;
-    readonly pendingCount: number;
-} | {
-    readonly kind: "plan-follow-up";
-};
-/** 宿主 `PreviewAnnotationPayload` 的结构子集（composer 只读展示）。 */
-export interface ConversationPreviewAnnotationElement {
-    id: string;
-    element: unknown;
-}
-export interface ConversationPreviewAnnotationPayload {
-    id: string;
-    kind: string;
-    comment: string;
-    elements: ReadonlyArray<ConversationPreviewAnnotationElement>;
-    regions: ReadonlyArray<unknown>;
-    strokes: ReadonlyArray<unknown>;
-    styleChanges: ReadonlyArray<unknown>;
-    [key: string]: unknown;
-}
-/** 宿主 `EnvironmentConnectionPresentation` 的结构子集。 */
-export interface ConversationEnvironmentConnectionPresentation {
-    label: string;
-    [key: string]: unknown;
-}
-/** 宿主 `ContextWindowSnapshot` 的结构子集。 */
-export interface ConversationContextWindowSnapshot {
-    usedTokens: number;
-    maxTokens: number | null;
-    usedPercentage: number | null;
-    totalProcessedTokens?: number | null | undefined;
-    compactsAutomatically?: boolean | undefined;
-    autoCompactThreshold?: number | null | undefined;
-}
-export type ConversationSessionPhase = "idle" | "connecting" | "running" | "disconnected" | string;
-/** 宿主 `Thread` 的结构子集（composer 只读这些 meta 字段）。 */
-export interface ConversationThreadMeta {
-    id: ConversationThreadId;
-    presetId?: string | null | undefined;
-    nativeModeId?: string | null | undefined;
-    session?: {
-        providerInstanceId?: ConversationProviderInstanceId | undefined;
-        nativeModeId?: string | null | undefined;
-        status?: string | undefined;
-        activeTurnId?: ConversationTurnId | null | undefined;
-    } | undefined;
-    latestTurn?: {
-        turnId: ConversationTurnId;
-    } | null | undefined;
-    proposedPlans: ReadonlyArray<{
-        id: string;
-        planMarkdown: string;
-    }>;
-}
-export interface ConversationThreadPreset {
-    presetId: string;
-    displayName: string;
-    description?: string | undefined;
-    promptPrefix?: string | undefined;
-}
-export interface ConversationComposerImageAttachment {
-    id: string;
-    name: string;
-    mimeType: string;
-    sizeBytes: number;
-    /** 附件类型判定（可内联图片 or 上传文件）；与宿主 ChatAttachment 同构。 */
-    type: "image" | "file";
-    previewUrl: string;
-    file: File;
-    source?: ConversationPastedTextSource | undefined;
-    [key: string]: unknown;
-}
-export interface ConversationPersistedComposerImageAttachment {
-    id: string;
-    name: string;
-    mimeType: string;
-    sizeBytes: number;
-    dataUrl: string;
-    storageId?: string | undefined;
-    remote?: {
-        environmentId: string;
-        attachmentId: string;
-    } | undefined;
-    source?: ConversationPastedTextSource | undefined;
-}
-export interface ConversationTerminalContextSelection {
-    terminalId: string;
-    terminalLabel: string;
-    lineStart: number;
-    lineEnd: number;
-    text: string;
-}
-export interface ConversationTerminalContextDraft extends ConversationTerminalContextSelection {
-    id: string;
-    threadId: ConversationThreadId;
-    createdAt: string;
-}
-export interface ConversationElementContextStackFrame {
-    functionName: string | null;
-    fileName: string | null;
-    lineNumber: number | null;
-    columnNumber: number | null;
-}
-export interface ConversationElementContextSelection {
-    pageUrl: string;
-    pageTitle: string | null;
-    tagName: string;
-    selector: string | null;
-    htmlPreview: string;
-    componentName: string | null;
-    source: ConversationElementContextStackFrame | null;
-    styles: string;
-}
-export interface ConversationElementContextDraft extends ConversationElementContextSelection {
-    id: string;
-    threadId: ConversationThreadId;
-    pickedAt: string;
-}
-export interface ConversationReviewCommentContext {
-    readonly id: string;
-    readonly sectionId: string;
-    readonly sectionTitle: string;
-    readonly filePath: string;
-    readonly startIndex: number;
-    readonly endIndex: number;
-    readonly rangeLabel: string;
-    readonly text: string;
-    readonly diff: string;
-}
-export interface ConversationPromptStashEntry {
-    id: string;
-    createdAt: string;
-    prompt: string;
-    attachments: ReadonlyArray<ConversationPersistedComposerImageAttachment>;
-    droppedImageNames: ReadonlyArray<string>;
-    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;
-    attachmentId: string;
-} | {
-    status: "uploading";
-    environmentId: string;
-    progress: number;
-    previous?: unknown;
-} | {
-    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;
-}
-/**
- * 草稿字段 + store 的 action 面（zustand 的 state 与 action 同住一个对象；hook 经
- * api.draft.useStore 穿界，插件只用它取 action）。
- */
-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?: {
-        instanceId?: ConversationProviderInstanceId | null | undefined;
-        model?: string | null | undefined;
-        persistSticky?: boolean;
-    }): void;
-    setNativeMode(target: ConversationComposerThreadTarget, instanceId: ConversationProviderInstanceId, nativeModeId: string | null): void;
-    addImage(target: ConversationComposerThreadTarget, image: ConversationComposerImageAttachment): void;
-    addImages(target: ConversationComposerThreadTarget, images: ConversationComposerImageAttachment[]): void;
-    removeImage(target: ConversationComposerThreadTarget, imageId: string): void;
-    insertTerminalContext(target: ConversationComposerThreadTarget, prompt: string, context: ConversationTerminalContextDraft, index: number): boolean;
-    removeTerminalContext(target: ConversationComposerThreadTarget, contextId: string): void;
-    removeElementContext(target: ConversationComposerThreadTarget, contextId: string): void;
-    removePreviewAnnotation(target: ConversationComposerThreadTarget, annotationId: string): void;
-    removeReviewComment(target: ConversationComposerThreadTarget, commentId: string): void;
-    clearComposerPromptAndImages(target: ConversationComposerThreadTarget): void;
-}
-/** 宿主 `useComposerDraftStore` 同形：zustand store hook 原样穿界。 */
-export interface ConversationComposerDraftStoreHook {
-    <T>(selector: (state: ConversationComposerDraftState) => T): T;
-    getState(): ConversationComposerDraftState;
-}
-/**
- * 输入区这只手现在拿不拿得出型号。宿主只在一处判（`resolveInstanceModelState`），
- * 座位标签与发送闸都读这个结论，不要各自再判一次「有没有型号」。
- */
-export type ConversationComposerModelStatus = 
-/** 有型号：`selectedModel` 就是它。 */
-"known"
-/** 首探还在跑：清单不算数，等它落地，不要替这只手选一个。 */
- | "probing"
-/** 探测跑完了，这只手一个型号都没报。 */
- | "missing";
-export interface ConversationEffectiveComposerModelState {
-    /** `selectedModelStatus` 不是 `known` 时为空串——不会回落到别的手或全局默认型号。 */
-    selectedModel: string;
-    selectedModelStatus: ConversationComposerModelStatus;
-    modelOptions: Readonly<Record<string, ReadonlyArray<ConversationProviderOptionSelection> | undefined>> | null;
-}
-export interface ConversationPromptStashStoreState {
-    entries: ReadonlyArray<ConversationPromptStashEntry>;
-    stashEntry(entry: ConversationPromptStashEntry): {
-        evicted: ConversationPromptStashEntry | null;
-        written: boolean;
-        durable: boolean;
-    };
-    takeEntry(id: string): {
-        entry: ConversationPromptStashEntry | null;
-        durable: boolean;
-    };
-    finalizeEntryImages(id: string, images: {
-        attachments: ReadonlyArray<ConversationPersistedComposerImageAttachment>;
-        droppedImageNames: ReadonlyArray<string>;
-        unreadableImageNames: ReadonlyArray<string>;
-    }): {
-        attached: boolean;
-        durable: boolean;
-    };
-}
-export interface ConversationPromptStashStoreHook {
-    <T>(selector: (state: ConversationPromptStashStoreState) => T): T;
-    getState(): ConversationPromptStashStoreState;
-}
-export interface ConversationAttachmentUploadStoreState {
-    uploadsByImageId: Readonly<Record<string, ConversationAttachmentUploadState>>;
-}
-export interface ConversationAttachmentUploadStoreHook {
-    <T>(selector: (state: ConversationAttachmentUploadStoreState) => T): T;
-}
-export interface ConversationCompressedStashImage {
-    mimeType: string;
-    sizeBytes: number;
-    dataUrl: string;
-}
-export type ConversationCompressStashImageResult = {
-    ok: true;
-    image: ConversationCompressedStashImage;
-} | {
-    ok: false;
-    reason: "too-large" | "unreadable";
-};
-export type ConversationCompressImageFileResult = {
-    ok: true;
-    file: File;
-} | {
-    ok: false;
-    reason: "too-large" | "unreadable";
-};
-export interface ConversationComposerSendState {
-    trimmedPrompt: string;
-    sendableTerminalContexts: ConversationTerminalContextDraft[];
-    expiredTerminalContextCount: number;
-    hasSendableContent: boolean;
-}
-export interface ConversationComposerPathSearchEntry {
-    path: string;
-    kind: "file" | "directory";
-}
-/** 某个实例在某个项目目录里的斜杠命令与技能（宿主 `ProviderWorkspaceInventoryResult` 的子集）。 */
-export interface ConversationWorkspaceInventory {
-    readonly slashCommands: ReadonlyArray<ConversationServerProviderSlashCommand>;
-    readonly skills: ReadonlyArray<ConversationServerProviderSkill>;
-}
-export interface ConversationComposerPathSearchState {
-    entries: ReadonlyArray<ConversationComposerPathSearchEntry>;
-    error: string | null;
-    isPending: boolean;
-}
-export interface ConversationPluginComposerOption {
-    readonly id: string;
-    readonly pluginId: string;
-    readonly actionId: string;
-    readonly choiceId: string;
-    readonly prepareCommand: string;
-    readonly title: string;
-    readonly description?: string | undefined;
-}
-export interface ConversationPluginComposerChoices {
-    readonly options: readonly ConversationPluginComposerOption[];
-    readonly isKnown: boolean;
-}
-export interface ConversationPierreIconResolution {
-    readonly symbolId: string;
-    readonly specific: boolean;
-}
-/** `keybindings.ts` 的快捷键解析选项（结构子集）。 */
-export interface ConversationShortcutMatchOptions {
-    platform?: string;
-    context?: {
-        terminalFocus?: boolean;
-        terminalOpen?: boolean;
-        modelPickerOpen?: boolean;
-    };
-}
-export interface ConversationShortcutEventLike {
-    type?: string;
-    code?: string;
-    key: string;
-    metaKey: boolean;
-    ctrlKey: boolean;
-    altKey: boolean;
-    shiftKey: boolean;
-    repeat?: boolean;
-    defaultPrevented?: boolean;
-    isComposing?: boolean;
-    keyCode?: number;
-    target?: unknown;
-    preventDefault(): void;
-    stopPropagation(): void;
-}
-export interface ConversationComposerApi {
-    /** react-dom 不可 import：菜单浮层 portal 由宿主注入。 */
-    createPortal(children: unknown, container: Element | DocumentFragment, key?: string): unknown;
-    /** 宿主 toast（web `notifications/notify`）。 */
-    readonly notify: {
-        info(title: string, description?: string): void;
-        warning(title: string, description?: string): void;
-        error(title: string, description?: string): void;
-    };
-    /** 宿主 `composerDraftStore`。store hook 原样穿界，hook 规则照常适用。 */
-    readonly draft: {
-        useStore: ConversationComposerDraftStoreHook;
-        /**
-         * 按选择器订一条会话草稿的部分字段。结果按浅比较，没变就不重渲染：正文每改一个字
-         * 草稿就换新对象，只读附件或手的组件不该跟着醒。草稿不存在时选择器拿到空草稿。
-         */
-        useThreadDraftSelector<T>(target: ConversationComposerThreadTarget, selector: (draft: ConversationComposerThreadDraft) => T): T;
-        useEffectiveModelState(input: {
-            threadRef?: ConversationComposerThreadTarget;
-            draftId?: ConversationDraftId;
-            providers: ReadonlyArray<ConversationServerProvider>;
-            selectedProvider: ConversationProviderDriverKind;
-            selectedInstanceId?: ConversationProviderInstanceId | null;
-            threadModelSelection: ConversationModelSelection | null | undefined;
-            projectModelSelection: ConversationModelSelection | null | undefined;
-            settings: ConversationUnifiedSettings;
-        }): ConversationEffectiveComposerModelState;
-        hydrateImagesFromPersisted(attachments: ReadonlyArray<ConversationPersistedComposerImageAttachment>): ConversationComposerImageAttachment[];
-        restoreAttachments(): void;
-    };
-    /** 宿主 `promptStashStore`。 */
-    readonly stash: {
-        useStore: ConversationPromptStashStoreHook;
-        readonly maxEntries: number;
-        partitionAttachments(attachments: ReadonlyArray<ConversationPersistedComposerImageAttachment>): {
-            kept: ConversationPersistedComposerImageAttachment[];
-            droppedNames: string[];
-        };
-    };
-    /** 宿主 `lib/attachmentUploadQueue`。 */
-    readonly uploads: {
-        useStore: ConversationAttachmentUploadStoreHook;
-        start(input: {
-            environmentId: ConversationEnvironmentId;
-            image: ConversationComposerImageAttachment;
-        }): void;
-        retry(input: {
-            environmentId: ConversationEnvironmentId;
-            image: ConversationComposerImageAttachment;
-        }): void;
-        release(imageId: string): void;
-    };
-    /** 宿主 `lib/imageCompression`。 */
-    readonly imageCompression: {
-        isHeicFile(file: Pick<File, "name" | "type">): boolean;
-        prepareForAttachment(file: File, maxBytes: number): Promise<ConversationCompressImageFileResult>;
-        compressForStash(file: File): Promise<ConversationCompressStashImageResult>;
-    };
-    /**
-     * 与 provider 目录耦合的派生（实例快照、名片给的旧 slug 别名表不可镜像，全部走宿主函数）。
-     * 别名表只在还原存下来的选择时用：选择器里的 slug 来自选项列表，直接对得上。
-     */
-    readonly model: {
-        createSelection(instanceId: ConversationProviderInstanceId, model: string, options?: ReadonlyArray<ConversationProviderOptionSelection> | null): ConversationModelSelection;
-        /** 两份选择的值是否相同（实例 + 型号 + 选项）。服务器回声会重建对象，别按引用判。 */
-        selectionsEqual(left: ConversationModelSelection, right: ConversationModelSelection): boolean;
-        /** 把快照的 `modelSlugAliases` 折成 `normalizeSlug` 要的简写表；同一份快照对象得到同一张表。 */
-        buildSlugAliases(cardAliases: {
-            readonly [slug: string]: string;
-        } | null | undefined): ReadonlyMap<string, string>;
-        normalizeSlug(model: string | null | undefined, aliases?: ReadonlyMap<string, string>): string | null;
-        resolveSelectableModel(value: string | null | undefined, options: ReadonlyArray<{
-            slug: string;
-            name: string;
-        }>, aliases?: ReadonlyMap<string, string>): string | null;
-        getModelCapabilities(models: ReadonlyArray<ConversationServerProviderModel>, model: string | null | undefined, planModeEnabled?: boolean, aliases?: ReadonlyMap<string, string>): ConversationModelCapabilities;
-        deriveInstanceEntries(providers: ReadonlyArray<ConversationServerProvider>): ReadonlyArray<ConversationProviderInstanceEntry>;
-        applyInstanceSettings(entries: ReadonlyArray<ConversationProviderInstanceEntry>, settings: ConversationUnifiedSettings): ReadonlyArray<ConversationProviderInstanceEntry>;
-        readonly noProviderSelection: ConversationModelSelection;
-        makeDriverKind(value: string): ConversationProviderDriverKind;
-        getInteractionModeToggle(providers: ReadonlyArray<ConversationServerProvider>, provider: ConversationProviderDriverKind): boolean;
-        /**
-         * 这一轮按这只手的哪一档跑——座位只画它。宿主开会话时用同一个函数解出同一档交给手，
-         * 插件不得自己由 `runtimeMode` 或 `currentNativeModeId` 另推（那就是两个答案）。
-         * 返回 null = 这只手不报档，座位画四档。
-         */
-        resolveNativeMode(provider: ConversationServerProvider | null | undefined, selection: {
-            readonly runtimeMode: ConversationRuntimeMode;
-            readonly nativeModeId?: string | null | undefined;
-        }): {
-            readonly modes: ReadonlyArray<ConversationServerProviderNativeMode>;
-            readonly current: ConversationServerProviderNativeMode;
-        } | null;
-        /**
-         * `selectedModel` 只传本线程在这个实例上存着的型号：OpenCode 的目录暂时没有它时，
-         * 结果里多一行 `isUnavailable` 的选项，不要换成默认型号。别的实例的型号不要传。
-         */
-        getAppModelOptionsForInstance(settings: ConversationUnifiedSettings, entry: ConversationProviderInstanceEntry, selectedModel?: string | null): ReadonlyArray<ConversationAppModelOption>;
-        sortProviderModelItems<T extends {
-            slug: string;
-            instanceId: string;
-        }>(items: ReadonlyArray<T>, options?: {
-            favoriteModelKeys?: ReadonlySet<string> | ReadonlyArray<string>;
-            groupFavorites?: boolean;
-            instanceOrder?: ReadonlyArray<string>;
-        }): T[];
-        /** provider 更新中（rail 角标用）。 */
-        isProviderUpdateInFlight(snapshot: ConversationServerProvider): boolean;
-        /** 模型选择器一行的动作判定（select / continue / blocked）。 */
-        resolvePickerRowAction(input: {
-            readonly disabledReason: string | null;
-            readonly continuationLabel: string | null;
-        }): {
-            readonly kind: "select";
-        } | {
-            readonly kind: "continue";
-            readonly label: string;
-        } | {
-            readonly kind: "blocked";
-            readonly reason: string;
-        };
-    };
-    /** 宿主 `plugins/pluginComposer` 的选项查询。 */
-    readonly pluginComposer: {
-        useOptions(environmentId: ConversationEnvironmentId | null, projectId: ConversationProjectId | null): ConversationPluginComposerChoices;
-    };
-    /** 宿主客户端设置（模型收藏、环境标识模式）。 */
-    readonly settings: {
-        useClientSettings<T = unknown>(selector?: (settings: {
-            favorites?: ConversationModelFavorite[] | undefined;
-        }) => T): T;
-        useUpdateClientSettings(): (patch: {
-            favorites?: ConversationModelFavorite[];
-        }) => void;
-        useEnvironmentIdentificationMode(): string;
-    };
-    readonly environment: {
-        useActiveEnvironmentId(): ConversationEnvironmentId | null;
-    };
-    /** thread preset 列表（宿主 serverEnvironment 查询封装）。 */
-    readonly presets: ConversationPresetApi;
-    /** 同屏会话仲裁（宿主 useChatPaneKeydown / chatPaneVisibility）。 */
-    readonly pane: {
-        useKeydown(onKeydown: (event: KeyboardEvent) => void, options?: {
-            capture?: boolean;
-            target?: "window" | "document";
-        }): void;
-        useActive(): boolean;
-        useVisible(): boolean;
-    };
-    /** 宿主 `keybindings.ts` 的快捷键解析。 */
-    readonly keybindings: {
-        resolveShortcutCommand(event: ConversationShortcutEventLike, keybindings: ConversationResolvedKeybindingsConfig, options?: ConversationShortcutMatchOptions): ConversationKeybindingCommand | null;
-        approvalDecisionFromCommand(command: string | null): ConversationProviderApprovalDecision | null;
-        modelPickerJumpCommandForIndex(index: number): string | null;
-        modelPickerJumpIndexFromCommand(command: string): number | null;
-        shortcutLabelForCommand(keybindings: ConversationResolvedKeybindingsConfig, command: ConversationKeybindingCommand, options?: ConversationShortcutMatchOptions | string): string | null;
-    };
-    readonly terminalFocus: {
-        getOwner(): unknown;
-    };
-    readonly commandPalette: {
-        isOpen(): boolean;
-    };
-    /** 宿主 `lib/composerPathSearchState`（RPC 查询封装）。 */
-    readonly pathSearch: {
-        useComposerPathSearch(target: {
-            environmentId: ConversationEnvironmentId;
-            cwd: string | null;
-            query: string | null;
-        }): ConversationComposerPathSearchState;
-    };
-    /**
-     * 宿主按项目目录查斜杠命令与技能（`provider.readWorkspaceInventory`，宿主自己缓存与失效）。
-     * 输入区的 `/` 与 `$` 菜单读它，而不是 provider 快照里整台机器的那份：项目自带的命令与技能
-     * 只有在那个目录里才查得到。
-     */
-    readonly providerInventory: {
-        /**
-         * 返回 `target` 这个（实例、目录）的列表；还没回来、老服务器不认、环境/实例/目录未知、
-         * 或结果不是这个目标的，都返回 `null`，调用方沿用快照里的列表。
-         */
-        useWorkspaceInventory(target: {
-            environmentId: ConversationEnvironmentId;
-            instanceId: ConversationProviderInstanceId | null;
-            cwd: string | null;
-            /** 已存在的服务端会话的线程 id；带上就叠加 agent 在该会话里自报的命令。草稿给 null。 */
-            threadId: ConversationThreadId | null;
-        }): ConversationWorkspaceInventory | null;
-    };
-    /** 宿主 `lib/terminalContext` 的纯函数（占位符增删）。 */
-    readonly terminalContext: {
-        insertInlinePlaceholder(prompt: string, cursor: number): {
-            prompt: string;
-            cursor: number;
-            contextIndex: number;
-        };
-        removeInlinePlaceholder(prompt: string, contextIndex: number): {
-            prompt: string;
-            cursor: number;
-        };
-    };
-    /** 宿主 `lib/elementContext` 的标签格式化。 */
-    readonly elementContext: {
-        formatLabel(context: ConversationElementContextSelection): string;
-        formatSourceLabel(context: ConversationElementContextSelection): string | null;
-        normalizeSelection(value: unknown): ConversationElementContextDraft | null;
-    };
-    /** 宿主 `ChatView.logic` 的发送态派生。 */
-    readonly chat: {
-        deriveComposerSendState(options: {
-            prompt: string;
-            imageCount: number;
-            terminalContexts: ReadonlyArray<ConversationTerminalContextDraft>;
-            elementContextCount?: number;
-        }): ConversationComposerSendState;
-    };
-    readonly theme: {
-        useResolvedTheme(): "light" | "dark";
-    };
-    /** 当前 i18n 语言（DiffStatLabel 的 aria 文案用 Intl.ListFormat）。 */
-    readonly i18n: {
-        useLanguage(): string;
-    };
-    /** dev backdrop（环境标识为 artwork 时的启动按钮背景）。 */
-    readonly devBackdrop: {
-        useVisible(enabled: boolean): boolean;
-    };
-    /** 文件图标 sprite（宿主 vendored Symbols 图标集 + 注入器）。 */
-    readonly pierreIcons: {
-        useSpriteReady(): boolean;
-        ensureSprite(): void;
-        resolveForEntry(path: string, kind: "file" | "directory"): ConversationPierreIconResolution;
-    };
-}
-export interface ConversationComposerHandle {
-    focusAtEnd(): void;
-    focusAt(cursor: number): void;
-    addDroppedFiles(files: File[]): void;
-    /** 拖入的文件夹：能解析出本机路径就插成路径引用，否则提示。宿主没接线时可以不调用。 */
-    addDroppedFolders?(folders: File[]): void;
-    insertTextAtEnd(text: string, options?: {
-        ensureLeadingBoundary?: boolean;
-    }): boolean;
-    toggleModelPicker(): void;
-    /** 快捷键换权限档：座位画什么就轮什么（这只手自己的档，或宿主四档）。 */
-    cyclePermissionMode(direction: 1 | -1): void;
-    /**
-     * 这次发送的身份：插件动作 + 正文。
-     *
-     * **只给「等一个异步操作回来后，确认用户没改主意」用。** 发送时要先问插件把正文
-     * 准备好，那是一次往返；回来时用户可能已经换了插件动作或改了字，这两样任一变了
-     * 就得丢弃这次发送。
-     *
-     * 它是命令式的（读此刻真值），不能换成订阅——订阅拿到的是最后推送过的值，在
-     * React 还没重渲染时会是旧的，这个防护就废了。
-     *
-     * 要防的东西变多（比如模型也不许换）就往这里加字段，别回头去读整个发送上下文：
-     * 那样谁都能在 await 之后读任意状态，没人说得清哪些是真需要的。
-     */
-    readSendIdentity(): {
-        pluginActionId: string | null;
-        prompt: string;
-    };
-    readSnapshot(): {
-        value: string;
-        cursor: number;
-        expandedCursor: number;
-        terminalContextIds: string[];
-    };
-    /** 外部改写 prompt（如 onSend 后）之后重置光标 / 触发 / 高亮。 */
-    resetCursorState(options?: {
-        cursor?: number;
-        prompt?: string;
-        detectTrigger?: boolean;
-    }): void;
-    /** 从终端抽屉插入一段终端上下文。 */
-    addTerminalContext(selection: ConversationTerminalContextSelection): void;
-    /** 发送前读取 composer 的完整选择状态。 */
-    getSendContext(): {
-        prompt: string;
-        images: ConversationComposerImageAttachment[];
-        terminalContexts: ConversationTerminalContextDraft[];
-        elementContexts: ConversationElementContextDraft[];
-        previewAnnotations: ConversationPreviewAnnotationPayload[];
-        reviewComments: ConversationReviewCommentContext[];
-        selectedModelOptionsForDispatch: unknown;
-        selectedModelSelection: ConversationModelSelection;
-        selectedNativeModeId?: string;
-        providerAvailable: boolean;
-        selectedProvider: ConversationProviderDriverKind;
-        selectedModel: string;
-        /** 与输入区座位、发送闸同一处结论。不是 `known` 时 `selectedModel` 是空串，别发。 */
-        selectedModelStatus: ConversationComposerModelStatus;
-        selectedProviderModels: ReadonlyArray<ConversationServerProviderModel>;
-        selectedPluginAction: ConversationPluginComposerOption | null;
-    };
-    /** provider turn 开始前校验合成输入。 */
-    validateProviderInput(providerInput: string): boolean;
-}
-/**
- * 同步发送读的那份上下文。子组件把读函数推到宿主的 ref 上，宿主不要经
- * imperative handle 反问。await 之后核对用户有没有改主意，仍用 `readSendIdentity`。
- */
-export type ConversationComposerSendContextReader = ConversationComposerHandle["getSendContext"];
-export type ConversationTimelineRow = {
-    readonly kind: "turn-identity";
-    readonly id: string;
-    readonly turnId: string;
-    readonly createdAt: string;
-    readonly badge: ConversationModelBadge;
-} | {
-    readonly kind: "turn-summary";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly footer: ConversationTurnFooter;
-    readonly copyText?: string | undefined;
-    readonly cardAnchor?: true | undefined;
-    /** 同一轮的身份行（谁答的、何时开始）：回答上方不画标题行，在轮次末尾那排给。 */
-    readonly identity?: Extract<ConversationTimelineRow, {
-        kind: "turn-identity";
-    }>;
-} | {
-    readonly kind: "tool-group";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly groupId: string;
-    readonly entries: readonly ConversationWorkEntry[];
-} | {
-    readonly kind: "work";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly groupedEntries: ConversationWorkEntry[];
-    readonly isExpandedToolGroupEntry: boolean;
-    readonly isLastExpandedToolGroupEntry: boolean;
-} | {
-    readonly kind: "message";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly message: ConversationChatMessage;
-    readonly presentation?: "full" | "compact" | undefined;
-    readonly textTone?: "primary" | "process" | undefined;
-    readonly durationStart: string;
-    readonly showAssistantMeta: boolean;
-    readonly showAssistantCopyButton: boolean;
-    readonly copyInFooter?: boolean | undefined;
-    readonly assistantCopyStreaming: boolean;
-    readonly modelBadge: ConversationModelBadge | null;
-} | {
-    readonly kind: "model-switch";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly badge: ConversationModelBadge;
-    readonly pending: boolean;
-} | {
-    readonly kind: "proposed-plan";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly proposedPlan: ConversationProposedPlan;
-} | {
-    readonly kind: "turn-plan";
-    readonly id: string;
-    readonly createdAt: string;
-    readonly turnPlan: ConversationTurnPlan;
-} | {
-    readonly kind: "working";
-    readonly id: string;
-    readonly turnId?: string | null | undefined;
-    readonly createdAt: string | null;
-    readonly modelBadge?: ConversationModelBadge | undefined;
-    readonly compacting: boolean;
-};
-/** 一轮一组的区间表（宿主 `TimelineTurnGroup` 的结构子集；rows 下标区间）。 */
-export interface ConversationTurnGroup {
-    readonly key: string;
-    readonly start: number;
-    readonly end: number;
-}
-/** 一轮一节的分节模型：插件用随迁的纯函数从 rows + groups 构建。 */
-export interface ConversationTurnSection {
-    readonly key: string;
-    readonly turnId: string | null;
-    readonly rows: readonly ConversationTimelineRow[];
-}
-/** 轮次导航面板里一节的可读摘要。 */
-export interface ConversationTurnSectionSummary {
-    readonly sectionKey: string;
-    readonly anchorRowId: string;
-    readonly userText: string | null;
-    readonly assistantText: string | null;
-    readonly headerText: string | null;
-}
-export interface ConversationRowsDeriveInput {
-    readonly activities: readonly ConversationThreadActivity[];
-    readonly timelineEntries: readonly ConversationTimelineEntry[];
-    readonly latestTurn: ConversationLatestTurn | null;
-    readonly runningTurnId: string | null;
-    /** 插件本地展开态：用户显式展开 + 本会话自动展开（含中断保留）。 */
-    readonly expandedTurnIds: ReadonlySet<string>;
-    readonly isWorking: boolean;
-    readonly activeTurnStartedAt: string | null;
-    readonly resolveModelBadge: ((selection: ConversationModelSelection | undefined) => ConversationModelBadge | null) | undefined;
-    readonly pendingModelSelection: ConversationModelSelection | null | undefined;
-}
-/** 宿主已知轮次的行缓存键（插件持有缓存，键值对插件不透明）。 */
-export type ConversationKnownTurns = ReadonlyMap<string, ConversationLatestTurn>;
-export interface ConversationDerivedRows {
-    readonly rows: ConversationTimelineRow[];
-    readonly turnGroups: readonly ConversationTurnGroup[];
-}
-/** 最新一轮的派生输入（宿主 `TimelineLatestTurn` 的结构子集）。 */
-export interface ConversationLatestTurn {
-    readonly turnId: string;
-    readonly state: string;
-    readonly requestedAt?: string | undefined;
-    readonly startedAt: string | null;
-    readonly completedAt: string | null;
-    readonly userMessageId: string | null;
-    readonly assistantMessageId: string | null;
-    readonly modelSelection?: ConversationModelSelection | undefined;
-    readonly waitSpans?: unknown;
-}
-/** 行派生缓存。`deriveGroups` 是纯函数；缓存身份归插件，跨派生复用行对象。 */
-export interface ConversationRowsCache {
-    deriveGroups(input: ConversationRowsDeriveInput): ConversationDerivedRows;
-}
-/** `parseSystemNotificationText` 的结果（宿主 `ParsedSystemNotification` 的子集）。 */
-export interface ConversationParsedSystemNotification {
-    readonly childThreadId: string;
-    readonly title: string;
-    readonly kind: "child.settled" | "child.failed" | "child.approval" | "child.stopped" | "plugin.notice" | "selfdev.resolved";
-    readonly requestId: string | null;
-    readonly summary: string;
-}
-/** `parseThreadHandoverText` 的结果（宿主 `ParsedThreadHandover` 的子集）。 */
-export interface ConversationParsedThreadHandover {
-    readonly sourceThreadId: string;
-    readonly includedTurns: number;
-    readonly body: string;
-}
-/** `parsePresetPrefixText` 的结果（宿主 `ParsedPresetPrefix` 的子集）。 */
-export interface ConversationParsedPresetPrefix {
-    readonly presetId: string;
-    readonly prefix: string;
-    /** 前缀块后面用户自己写的那半，可能为空。 */
-    readonly body: string;
-}
-/** 卡住提示的可读子集（宿主 `TurnStallState` 的结构子集）。 */
-export interface ConversationTurnStall {
-    readonly reason: "childThread" | "tool" | "approval" | "userInput" | "model";
-    /** 最后一次有动静的时刻，插件按它自己走秒。 */
-    readonly since: string;
-}
-/** 滚动落点：视口顶对应行的 id 与相对行顶的偏移；负值保留行前留白。 */
-export interface ConversationScrollAnchor {
-    readonly rowId: string;
-    readonly offsetPx: number;
-}
-/** 工具行的状态点取值；非工具行为 null。 */
-export type ConversationWorkEntryStatus = "success" | "failed" | "running" | null;
-/** 折叠工具组按动作分类的口径（宿主 `ToolGroupAction`）。 */
-export type ConversationToolGroupAction = "read" | "edit" | "command" | "code-search" | "search" | "other";
-export interface ConversationDeriveApi extends ConversationMessageLinkText {
-    /** 每个时间线实例建一份（插件侧 useRef 持有）。 */
-    createRowsCache(): ConversationRowsCache;
-    /** 滚动是否已到末尾的判定（保持与宿主一致的容差）。 */
-    resolveIsAtEnd(state: {
-        isAtEnd?: boolean | undefined;
-        contentLength?: number | undefined;
-        scroll?: number | undefined;
-        scrollLength?: number | undefined;
-    } | undefined, endInset: number): boolean | undefined;
-    /** 合组锚翻译：tool-group 自锚 id → 组行 id。 */
-    resolveToolGroupRevealRowId(rows: readonly ConversationTimelineRow[], rowId: string): string;
-    /** 时间线上真正摊开的轮次：用户显式展开 + 本会话自动展开（含中断保留）。 */
-    resolveExpandedTurnIds(persistedTurnIds: readonly string[], autoExpandedTurnIds: ReadonlySet<string>): ReadonlySet<string>;
-    /** 系统通知 / 会话移交 / preset 前缀文案的解析（消息行按内容切换呈现）。 */
-    parseSystemNotificationText(text: string): ConversationParsedSystemNotification | null;
-    parseThreadHandoverText(text: string): ConversationParsedThreadHandover | null;
-    parsePresetPrefixText(text: string): ConversationParsedPresetPrefix | null;
-    /** provider 重试提示文案。文案 key 归插件词表（providerRetry.*），宿主函数
-     *  只组模板参数。 */
-    providerRetryMessage(state: unknown, t: (key: string, options?: Record<string, unknown>) => string): string;
-    /** 助手消息复制按钮的可见性（流式中/空回复不画）。 */
-    resolveAssistantMessageCopyState(input: {
-        readonly text: string | null;
-        readonly showCopyButton: boolean;
-        readonly streaming: boolean;
-    }): {
-        readonly text: string | null;
-        readonly visible: boolean;
-    };
-    /** 助手正文是否保留原始换行（特定标记的正文按原样显示）。 */
-    shouldPreserveAssistantLineBreaks(text: string): boolean;
-    /** 思考/折叠回复的一行预览（与宿主同一条末行有效规则）。 */
-    reasoningPreviewText(text: string): string;
-    /** 工具行状态点（失败优先于进行中）；非工具行为 null。 */
-    resolveWorkEntryStatus(entry: ConversationWorkEntry): ConversationWorkEntryStatus;
-    /** 这条工具记录按展示口径算不算失败（红字/红点/失败计数）。 */
-    workEntryIndicatesFailure(entry: ConversationWorkEntry): boolean;
-    /** 一组工具调用按动作分类（图标与计数）。 */
-    toolGroupAction(entry: ConversationWorkEntry): ConversationToolGroupAction;
-    /** 工具记录里的命令文本（结构化输入优先于回显）。 */
-    resolveToolCommand(entry: ConversationWorkEntry): string | undefined;
-    /** 参数 JSON 里的命令与 description 摘要。 */
-    parseToolCommandInput(input: unknown): {
-        readonly command?: string | undefined;
-        readonly description?: string | undefined;
-    } | null;
-    /** 末条助手消息是否已完整落地（shell 与明细独立到达，流式半段不算）。 */
-    hasSettledAssistantMessage(entries: readonly ConversationTimelineEntry[], messageId: string | null): boolean;
-}
+import type { ConversationThreadActivity, ConversationTimelineEntry, ConversationTurnUsage } from "./conversationBase.ts";
+export type * from "./conversationBase.ts";
+import type { ConversationApprovalRequestId, ConversationComposerOccupant, ConversationContextWindowSnapshot, ConversationEnvironmentId, ConversationModelSelection, ConversationPendingApproval, ConversationPendingUserInput, ConversationPendingUserInputDraftAnswer, ConversationProjectId, ConversationProviderApprovalDecision, ConversationProviderDriverKind, ConversationProviderInteractionMode, ConversationQuestions, ConversationRuntimeMode, ConversationServerProvider, ConversationThreadId } from "./conversationHostModels.ts";
+export type * from "./conversationHostModels.ts";
+export type * from "./conversationDrafts.ts";
+export type * from "./conversationComposerEnvironment.ts";
+export type * from "./conversationComposerApi.ts";
+export type * from "./conversationComposerHandle.ts";
+export type * from "./conversationRows.ts";
+import type { ConversationLatestTurn, ConversationTurnStall } from "./conversationDerive.ts";
+export type * from "./conversationDerive.ts";
+import type { ConversationComposerBanners, ConversationComposerStatus, ConversationTrajectoryToolCallDetailData, ConversationVisibleTurnRange } from "./conversationViewProps.ts";
+export type * from "./conversationViewProps.ts";
 export type { ConversationQueuedMessageEdit, ConversationQueuedAttachment, ConversationQueueEntry, ConversationPendingQueueSubmission, ConversationQueueState, ConversationQueueActions, } from "./conversation-queue.ts";
 /**
  * 宿主数据接口的契约版本。宿主与插件各自编译进自己构建时的这个数字；两边不一致时
@@ -1621,353 +396,6 @@ export interface ConversationComposerPlan {
         readonly status: "pending" | "inProgress" | "completed";
     }[] | null;
 }
-export type ConversationViewMode = "chat" | "trajectory" | "map";
-/** 会话身份与多 pane 仲裁。`active` 为 false 的实例不得绑定全局监听。 */
-export interface ConversationScopeProps {
-    readonly environmentId: string;
-    readonly threadId: string;
-    /** 会话路由键（宿主 scoped thread key），草稿会话也有稳定值。 */
-    readonly threadKey: string;
-    /** 这是同屏会话里接收全局操作的那一个。 */
-    readonly active: boolean;
-    /** 面板可见（保活隐藏时为 false：停观察器、停测量、停跟随）。 */
-    readonly visible: boolean;
-    /** 处于同屏分组中。 */
-    readonly grouped: boolean;
-}
-export interface ConversationModeProps {
-    readonly mode: ConversationViewMode;
-    /** 持久化归宿主；插件只上报用户选择。 */
-    onModeChange(mode: ConversationViewMode): void;
-}
-/** 聊天/轨迹切换的快捷键展示文案（宿主解析键位绑定，插件不读键位配置）。 */
-export interface ConversationShortcutLabels {
-    readonly toggleTrajectory: string | null;
-    readonly interrupt: string | null;
-}
-/**
- * 宿主驱动聊天时间线的入口。跟随末尾、「回到底部」与手势停跟都归插件，宿主只在
- * 自己发出消息后请求回到末尾。
- */
-export interface ConversationTimelineControl {
-    /**
-     * 解除展开阅读锁、恢复跟随并滚到末尾。聊天停在历史窗口时先经数据窗口的
-     * `onReturnToLatest` 换回最新页；时间线不可见时等重新可见再滚。
-     */
-    followEnd(options?: {
-        readonly animated?: boolean;
-    }): void;
-}
-/** 可见和受交互保护的轮次；历史页保留归宿主，插件只报告当前呈现范围。 */
-export interface ConversationVisibleTurnRange {
-    readonly selectionTurnRange?: {
-        readonly firstTurnId: ConversationTurnId;
-        readonly lastTurnId: ConversationTurnId;
-    } | null;
-    readonly firstTurnId: ConversationTurnId | null;
-    readonly lastTurnId: ConversationTurnId | null;
-    readonly protectedTurnIds: ReadonlyArray<ConversationTurnId>;
-}
-export interface ConversationTimelineProps {
-    /** 行派生（= ConversationViewProps.derive；时间线经 ctx 下发给行组件）。 */
-    readonly derive: ConversationDeriveApi;
-    /** 会话路由键：开合态、滚动落点、已读上报都按它隔离（= scope.threadKey）。 */
-    readonly threadKey: string;
-    /** 宿主 ScopedThreadRef（对插件不透明）：markdown/计划卡按它取机器上下文。 */
-    readonly threadRef: unknown;
-    /** 会话所属机器（= scope.environmentId）：计划卡保存走它。 */
-    readonly environmentId: string;
-    readonly threadTitle: string;
-    readonly resolveModelBadge: ((selection: ConversationModelSelection | undefined) => ConversationModelBadge | null) | undefined;
-    readonly markdownCwd: string | undefined;
-    readonly resolvedTheme: "light" | "dark";
-    readonly timestampFormat: string;
-    readonly workspaceRoot: string | undefined;
-    readonly skills: ReadonlyArray<ConversationTimelineSkill>;
-    readonly contentInsetEndAdjustment: number;
-    readonly awaitingUserDecision: boolean;
-    readonly hideEmptyPlaceholder: boolean;
-    readonly topFadeEnabled: boolean;
-    /** 宿主拿到的时间线控制入口；插件在挂载、换会话与卸载时同步它。 */
-    readonly controlRef: {
-        current: ConversationTimelineControl | null;
-    } | ((control: ConversationTimelineControl | null) => void);
-    readonly agentPanelModel: unknown;
-    /** 草稿/断开会话传 null：决定卡只显示状态、无按钮。 */
-    readonly onRespondToDecision: ((requestId: string, optionId: string) => void) | null;
-    readonly onInterrupt: (() => void) | null;
-    /** 结果是服务器是否受理：true 时「取消」保持停用，等订阅推回新状态；false 时恢复可点。 */
-    readonly onCancelScheduledWake: ((wakeId: string) => Promise<boolean>) | null;
-    readonly onOpenFileDiff: (filePath: string) => void;
-    readonly onForkFromUserMessage: ((messageId: string) => void) | null;
-    /** 当前登录者；用户消息作者是它或没有作者时画成「你说的」，否则在气泡上方署名。 */
-    readonly selfUserId?: string | null | undefined;
-    /** 插件交 `ConversationExpandedImagePreview`；宿主的 Markdown 也经它交宿主自己的形状，所以参数是 unknown。 */
-    readonly onImageExpand: (preview: unknown) => void;
-    /** 附件区的文档卡（PDF、Office）在宿主的文档查看器里打开。可选：宿主没给时卡片照旧是新标签页链接。 */
-    readonly onAttachmentDocumentOpen?: ConversationAttachmentDocumentOpen | undefined;
-    readonly onOpenAgents: (() => void) | null;
-    /**
-     * 工具呈现接缝：一组工具/过程行的展开体。宿主先用现有实现渲染，接
-     * tool-display 插件后改指其视图；缺省时插件画极简回退（标题+摘要）。
-     */
-    readonly renderWorkGroup?: ((input: {
-        readonly row: ConversationTimelineRow;
-        readonly threadRef: unknown;
-        readonly visible: boolean;
-    }) => unknown) | undefined;
-    /** 折叠工具组的展开详情接缝（懒加载的工具调用输入/输出）。 */
-    readonly renderToolCallDetail?: ((input: {
-        readonly entry: ConversationWorkEntry;
-        readonly threadRef: unknown;
-        readonly threadKey: string;
-        readonly workspaceRoot: string | undefined;
-        readonly revision: string;
-        readonly onOpenFileDiff: (filePath: string) => void;
-        readonly onDisclosureChange?: (() => void) | undefined;
-    }) => unknown) | undefined;
-    /** 滚动落点持久化（卸载前保存、重挂恢复）。 */
-    loadScrollAnchor(threadKey: string): ConversationScrollAnchor | null;
-    saveScrollAnchor(threadKey: string, anchor: ConversationScrollAnchor | null): void;
-    /** 开合态持久化：用户显式展开的轮次跨会话保留。 */
-    readonly disclosure: {
-        usePersistedExpandedTurnIds(threadKey: string): readonly string[];
-        setTurnExpanded(threadKey: string, turnId: string, expanded: boolean): void;
-    };
-    /** 已读上报：可见帧内最后一条完成消息变化时由宿主标记。 */
-    useVisibleThreadCompletion(input: unknown): void;
-    /**
-     * 计划卡「保存到工作区」的宿主 RPC（写文件走宿主命令管线）。null 时不画
-     * 该菜单项（草稿会话、环境断开）。
-     */
-    readonly onSavePlanToWorkspace: ((input: {
-        readonly environmentId: string;
-        readonly workspaceRoot: string;
-        readonly relativePath: string;
-        readonly contents: string;
-    }) => Promise<{
-        readonly ok: true;
-        readonly relativePath: string;
-    } | {
-        readonly ok: false;
-    }>) | null;
-}
-/** 轨迹行工具详情的懒加载请求（行级版本 = 状态 + 末次活动 id）。 */
-export interface ConversationTrajectoryToolCallDetailRequest {
-    readonly threadRef: unknown;
-    readonly toolCallId: string;
-    readonly turnId: string | null;
-    readonly revision: string;
-}
-/** 已回取的工具详情；输入/输出可能只到一半——已知事实不许从界面消失。 */
-export interface ConversationTrajectoryToolCallDetailData {
-    readonly input?: string | undefined;
-    readonly output?: string | undefined;
-}
-/**
- * 轨迹面板里宿主仍要给的部分。行、翻页与工具详情由插件经 {@link ConversationHostData}
- * 自己读；在轨迹中选中一行后切回聊天定位由插件自己协调。
- */
-export interface ConversationTrajectoryProps {
-    readonly timestampFormat: string;
-}
-/** 输入卡上方的横幅堆条目（宿主算好顺序；icon/title 等是宿主创建的节点，插件原样渲染）。 */
-export interface ConversationComposerBannerItem {
-    readonly id: string;
-    readonly variant: "default" | "error" | "info" | "success" | "warning";
-    /** 平静、低频的提示可缩成单行，不占用完整告警卡片。 */
-    readonly presentation?: "banner" | "compact" | undefined;
-    /** 排序提示：平静变体也要前置（如实时更新进度）。栈本身忽略它。 */
-    readonly urgent?: boolean | undefined;
-    readonly icon: unknown;
-    readonly title: unknown;
-    readonly description?: unknown;
-    readonly actions?: unknown;
-    readonly className?: string | undefined;
-    readonly actionClassName?: string | undefined;
-    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;
-    /**
-     * 用户之前选的 agent（实例 id）已删或被停用时的那个 id，否则 null。宿主不替用户换别的，
-     * 输入卡据此把原来的选择连同「不可用」画出来，发送由 `sendDisabledReason` 挡住。
-     */
-    readonly unavailableAgentInstanceId?: string | null;
-    /**
-     * 这条会话从没选过 agent（草稿、会话、线程、项目默认都没存过实例 id）。宿主不替用户挑，
-     * 输入卡画「选择 agent」占位、不显示任何 agent，发送由 `sendDisabledReason` 挡住。
-     */
-    readonly noAgentChosen?: boolean;
-    /** 刚发出的消息在等新 worktree 建好。 */
-    readonly isPreparingWorktree: boolean;
-    /** 准备的五步进度与取消；旧服务器或进度未到时为 null，输入卡只显示「正在准备」。 */
-    readonly worktreeSetup?: ConversationWorktreeSetupProgress | null;
-    /** 会话所在机器没连上时，它的名字与连接状态。 */
-    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;
-    composerDraftTarget: ConversationComposerThreadTarget;
-    environmentId: ConversationEnvironmentId;
-    attachmentUploadsCapabilityKnown: boolean;
-    supportsAttachmentUploads: boolean;
-    routeKind: "server" | "draft";
-    routeThreadRef: ConversationScopedThreadRef;
-    draftId: ConversationDraftId | null;
-    forceExpandedOnMobile: boolean;
-    /**
-     * 输入区座位。骨架调用 `renderSlot`；整条输入区被占住时走 `renderSlotChain`。
-     * 缺席（测试）时骨架画内置默认控件。`fallback` 是骨架的内置控件：座位无人占用、
-     * 或占用者渲染时抛错，宿主都画它，一个插件的控件坏掉不会连带整块会话区。
-     */
-    slots?: {
-        readonly renderSlot: (name: string, owner?: unknown, fallback?: unknown) => unknown;
-        readonly renderSlotChain: (name: string, owner: unknown, fallback: unknown) => unknown;
-    };
-    resolvedTheme: "light" | "dark";
-    settings: ConversationUnifiedSettings;
-    keybindings: ConversationResolvedKeybindingsConfig;
-    terminalOpen: boolean;
-    gitCwd: string | null;
-    promptRef: {
-        readonly current: string;
-    };
-    composerImagesRef: {
-        readonly current: ConversationComposerImageAttachment[];
-    };
-    composerTerminalContextsRef: {
-        readonly current: ConversationTerminalContextDraft[];
-    };
-    composerElementContextsRef: {
-        readonly current: ConversationElementContextDraft[];
-    };
-    /**
-     * 同步发送读这里。子组件每轮把读函数推上来；正文等活在 ref 里的字段，
-     * 调用时读此刻真值，不是上一次渲染的快照。
-     */
-    sendContextRef: {
-        current: ConversationComposerSendContextReader | null;
-    };
-    /**
-     * 宿主 imperative handle。callback ref 或 object ref；插件经
-     * `useImperativeHandle` 写入。宿主发送路径用带品牌的适配别名读它。
-     */
-    composerRef: {
-        current: ConversationComposerHandle | null;
-    } | ((handle: ConversationComposerHandle | null) => void);
-    /** `steer`：agent 在干活时照常排队，再请当前这一轮接住它；宿主当场拒发时同步回 `false`（原因宿主说）。 */
-    onSend: (e?: {
-        preventDefault: () => void;
-    }, intent?: "foreground" | "background" | "steer") => false | void | Promise<void>;
-    onInterrupt: () => void;
-    /** Esc 两段式停止已武装：停止按钮显示「再按一次」态。缺席按 false。 */
-    interruptArmed?: boolean;
-    /** slash 菜单「最近使用」：item id 列表，新在前。宿主本机持久化。 */
-    recentSlashCommandIds?: ReadonlyArray<string>;
-    /** slash 菜单选中一条时回宿主记一次使用。 */
-    onSlashCommandUsed?: (itemId: string) => void;
-    /** slash 菜单分组小标题：宿主解析好的文案（内置插件命名空间运行期不注册，见 0026 后续记录）。 */
-    slashMenuSectionTitles?: Readonly<Record<string, string>>;
-    /** 停止按钮武装态文案（宿主解析）。 */
-    interruptArmedLabel?: string;
-    /** 派发原生压缩命令。服务端按 adapter 能力位执行，不再伪造一条 `/compact` 消息。 */
-    onCompactContext: () => void;
-    onImplementPlanInNewThread: () => void;
-    /** 点了某个实例下的一行模型：`model` 归 `instanceId`。 */
-    onProviderModelSelect: (instanceId: ConversationProviderInstanceId, model: string) => void;
-    /** 选手格换手：`carried` 是换手前的选择，型号归不归新手由宿主判，选手格不猜。 */
-    onProviderInstanceSelect: (instanceId: ConversationProviderInstanceId, carried: ConversationModelSelection) => void;
-    /** 选择器(模型或档位)一改就把合成后的选择交出去，由宿主立刻落库。 */
-    onModelSelectionChosen?: ((selection: ConversationModelSelection) => void) | undefined;
-    /** 选中 / 清空团队。传 null 表示回到单模型；选模型时由宿主用它清掉团队。 */
-    onSelectPluginAction: (teamId: string | null) => void;
-    /** 跳到设置里的 Teams 位置。 */
-    onManagePlugins: () => void;
-    getModelDisabledReason: (instanceId: ConversationProviderInstanceId, model: string) => string | null;
-    /** 被挡下的模型还能不能靠开新 thread 接着干；返回那一行的动作文案，或 null。 */
-    getModelContinuationLabel: (instanceId: ConversationProviderInstanceId, model: string) => string | null;
-    onContinueInModel: (instanceId: ConversationProviderInstanceId, model: string) => void;
-    toggleInteractionMode: () => void;
-    handleRuntimeModeChange: (mode: ConversationRuntimeMode) => void;
-    handleInteractionModeChange: (mode: ConversationProviderInteractionMode) => void;
-    handleNativeModeChange: (nativeModeId: string) => void;
-    focusComposer: () => void;
-    scheduleComposerFocus: () => void;
-    setThreadError: (threadId: ConversationThreadId | null, error: string | null) => void;
-    onExpandImage: (preview: unknown) => void;
-    /**
-     * 输入卡第一行左侧：新建会话 / 历史 / 导入。宿主 React 节点，插件原样摆。
-     * 缺席（测试、着陆页没有输入卡）就不画。
-     */
-    readonly sessionActions?: unknown;
-    /**
-     * 输入卡第一行右段、轮次导航左边：会话的 agents 控制（按钮 + 舰队弹窗）。
-     * 宿主 React 节点，插件原样摆；本会话没 spawn 过 agent 时宿主给 null。
-     */
-    readonly agentsControl?: unknown;
-    /**
-     * 输入卡第一行右段、agents 控制左边：终端开关。宿主 React 节点，插件原样摆；
-     * 0026 Q1 拍板从顶栏搬进玻璃壳（右面板与最大化开关仍留顶栏）。
-     */
-    readonly terminalControl?: unknown;
-    /** 输入卡下缘内容（分支工具条等宿主工作区控件），原样渲染。 */
-    readonly belowSlot: unknown;
-    /** 草稿首条消息的居中大标题态。 */
-    readonly draftHero: {
-        readonly active: boolean;
-        readonly headline: unknown;
-        readonly forceExpandedOnMobile: boolean;
-        readonly transitionGroupRef?: ((element: HTMLDivElement | null) => void) | undefined;
-        readonly composerAnchorRef?: ((element: HTMLDivElement | null) => void) | undefined;
-        readonly composerTransitionName?: string | undefined;
-        readonly headlineTransitionName?: string | undefined;
-    };
-    readonly contextStrip: boolean;
-    /**
-     * 浮层根元素上报：宿主量它的高度给时间线让位（contentInsetEndAdjustment），
-     * 并在其中找 `[data-chat-composer-stack="true"]` 量输入卡占的列（浮动预览可停在两侧留白）。
-     * 卸载时以 null 收尾。元素对契约不透明（本文件不引 DOM 类型）。
-     */
-    readonly onOverlayElementChange?: ((element: unknown) => void) | undefined;
-}
-/** `views.conversation` 的完整 props。 */
-export interface ConversationViewProps {
-    readonly scope: ConversationScopeProps;
-    readonly mode: ConversationModeProps;
-    readonly shortcuts: ConversationShortcutLabels;
-    readonly derive: ConversationDeriveApi;
-    /** 宿主数据接口。老版本宿主不给；插件发现缺席或版本不同时显示版本不一致的说明。 */
-    readonly data?: ConversationHostData | undefined;
-    readonly timeline: ConversationTimelineProps;
-    readonly trajectory: ConversationTrajectoryProps;
-    readonly composer: ConversationComposerProps;
-    readonly attachments: ConversationAttachmentsApi;
-}
 export { CONVERSATION_PLUGIN_ID, CONVERSATION_PROMPT_PREVIEW_VIEW_ID, CONVERSATION_VIEW_BRIDGE_PROP, CONVERSATION_VIEW_ID, CONVERSATION_VIEW_REBINDABLE_BRIDGE_CAPABILITY, type ConversationPromptPreviewViewProps, } from "./conversation-view.ts";
 /**
  * Prompt 里占位终端上下文的 wire 字符（U+FFFC）。宿主与插件必须用同一份，