@openviking/react 0.1.1 → 0.1.2

package/dist/components/viking-bot/interaction/style.css

@@ -0,0 +1,189 @@
+.ov-viking-bot__interaction {
+  box-sizing: border-box;
+  border-top: 1px solid var(--ov-viking-bot-border);
+  flex-direction: column;
+  flex: none;
+  gap: 8px;
+  padding: 12px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-header {
+  color: var(--ov-viking-bot-text-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-title {
+  color: var(--ov-viking-bot-text);
+  font-weight: 500;
+}
+
+.ov-viking-bot__interaction-progress {
+  font-variant-numeric: tabular-nums;
+}
+
+.ov-viking-bot__interaction-question {
+  margin: 0;
+  font-size: 13px;
+  line-height: 1.6;
+}
+
+.ov-viking-bot__interaction-error {
+  color: var(--ov-viking-bot-danger);
+  margin: 0;
+  font-size: 12px;
+}
+
+.ov-viking-bot__interaction-options {
+  flex-direction: column;
+  gap: 4px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-option {
+  border-radius: var(--ov-viking-bot-radius);
+  cursor: pointer;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 6px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-option:hover {
+  background: var(--ov-viking-bot-surface-hover);
+}
+
+.ov-viking-bot__interaction-option:focus-within {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: 1px;
+}
+
+.ov-viking-bot__interaction {
+  --ov-viking-bot-radius: 6px;
+  --ov-viking-bot-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  --ov-viking-bot-text-muted: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default, #6e718c));
+  --ov-viking-bot-accent: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+  --ov-viking-bot-accent-hover: var(--ov-ui-color-primary-hover, var(--ov-ui-primary-hover-default, #7075ff));
+  --ov-viking-bot-on-accent: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-viking-bot-border: var(--ov-ui-color-border-2, var(--ov-ui-border-2-default, #e1e4f2));
+  --ov-viking-bot-border-strong: var(--ov-ui-color-border-3, var(--ov-ui-border-3-default, #d7daea));
+  --ov-viking-bot-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-viking-bot-primary-light: var(--ov-ui-color-primary-light, var(--ov-ui-primary-light-default, #f5f7ff));
+  --ov-viking-bot-surface: var(--ov-ui-color-bg-4, var(--ov-ui-bg-4-default, #f6f7fa));
+  --ov-viking-bot-surface-hover: var(--ov-ui-color-bg-5, var(--ov-ui-bg-5-default, #f1f2f9));
+  --ov-viking-bot-focus: var(--ov-ui-color-focus, var(--ov-ui-focus-default, #5252ff));
+  --ov-viking-bot-danger: var(--ov-ui-color-status-error, var(--ov-ui-status-error-default, #c43838));
+}
+
+.ov-viking-bot__interaction-option input[type="radio"] {
+  box-sizing: border-box;
+  appearance: none;
+  border: 1px solid var(--ov-viking-bot-border-strong);
+  cursor: pointer;
+  background: none;
+  border-radius: 50%;
+  flex: none;
+  width: 14px;
+  height: 14px;
+  margin: 0;
+}
+
+.ov-viking-bot__interaction-option input[type="radio"]:checked {
+  border: 4px solid var(--ov-viking-bot-accent);
+  background: var(--ov-viking-bot-on-accent);
+}
+
+.ov-viking-bot__interaction-option input[type="radio"]:disabled {
+  cursor: not-allowed;
+  opacity: .5;
+}
+
+.ov-viking-bot__interaction-option small {
+  color: var(--ov-viking-bot-text-muted);
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-option code {
+  background: var(--ov-viking-bot-surface);
+  border-radius: 4px;
+  padding: 0 4px;
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-input {
+  box-sizing: border-box;
+  border: 1px solid var(--ov-viking-bot-border);
+  border-radius: var(--ov-viking-bot-radius);
+  width: 100%;
+  min-width: 0;
+  color: inherit;
+  font: inherit;
+  background: none;
+  padding: 6px 8px;
+}
+
+.ov-viking-bot__interaction-input:focus-visible {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: -1px;
+}
+
+.ov-viking-bot__interaction-input:disabled {
+  background: var(--ov-viking-bot-surface);
+  color: var(--ov-viking-bot-text-muted);
+  cursor: not-allowed;
+}
+
+textarea.ov-viking-bot__interaction-input {
+  resize: vertical;
+  min-height: 72px;
+}
+
+.ov-viking-bot__interaction-hint {
+  color: var(--ov-viking-bot-text-muted);
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-submit, .ov-viking-bot__interaction-cancel {
+  border: 1px solid var(--ov-viking-bot-border);
+  border-radius: var(--ov-viking-bot-radius);
+  color: var(--ov-viking-bot-text);
+  font: inherit;
+  cursor: pointer;
+  background: none;
+  align-self: flex-start;
+  padding: 4px 14px;
+  font-size: 12px;
+}
+
+.ov-viking-bot__interaction-submit {
+  border-color: var(--ov-viking-bot-accent);
+  background: var(--ov-viking-bot-accent);
+  color: var(--ov-viking-bot-on-accent);
+}
+
+.ov-viking-bot__interaction-submit:hover:not(:disabled) {
+  border-color: var(--ov-viking-bot-accent-hover);
+  background: var(--ov-viking-bot-accent-hover);
+}
+
+.ov-viking-bot__interaction-cancel:hover:not(:disabled) {
+  background: var(--ov-viking-bot-surface-hover);
+}
+
+.ov-viking-bot__interaction-submit:focus-visible, .ov-viking-bot__interaction-cancel:focus-visible {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: 2px;
+}
+
+.ov-viking-bot__interaction-submit:disabled, .ov-viking-bot__interaction-cancel:disabled {
+  opacity: .5;
+  cursor: not-allowed;
+}
+

package/dist/components/viking-bot/interaction/types.d.ts

@@ -0,0 +1,188 @@
+import type { ReactNode } from 'react';
+/** 可选项。An option offered by a question. */
+export interface VikingBotInteractionOption {
+    /** 选项值。Option value. */
+    value: string;
+    /** 选项主文案。Primary label. */
+    label: ReactNode;
+    /** 选项下方的说明。Description shown under the label. */
+    description?: ReactNode;
+    /** 选项后附加的等宽片段，例如命令。Monospace snippet after the label. */
+    code?: string;
+}
+/** 定时值。A schedule value. */
+export type VikingBotScheduleValue = {
+    /** 不启用。Disabled. */
+    mode: 'none';
+} | {
+    /** 每天。Daily. */
+    mode: 'daily';
+    /** 时间，`HH:mm`。Time as `HH:mm`. */
+    time: string;
+} | {
+    /** 每周。Weekly. */
+    mode: 'weekly';
+    /** 时间，`HH:mm`。Time as `HH:mm`. */
+    time: string;
+    /** 星期，1 为周一。Weekday, 1 is Monday. */
+    weekday: 1 | 2 | 3 | 4 | 5 | 6 | 7;
+};
+/** 修复候选。A repair candidate. */
+export interface VikingBotRepairOption {
+    /** 候选标识。Candidate key. */
+    id: string;
+    /** 候选文案。Candidate label. */
+    label: string;
+    /** 来源说明。Source description. */
+    description?: string;
+}
+/** 自定义问题的渲染上下文。Render context for a custom question. */
+export interface VikingBotInteractionRenderContext {
+    /** 是否禁用提交。Whether submission is disabled. */
+    disabled?: boolean;
+    /** 是否正在提交。Whether a submission is in flight. */
+    submitting?: boolean;
+    /** 上报答案；由宿主转成它自己的协议。Reports an answer; the host adapts it. */
+    submit: (value: unknown) => void | Promise<void>;
+    /** 放弃本次交互。Abandons this interaction. */
+    cancel: () => void;
+}
+/**
+ * 一次待确认的交互。组件内置 `choice`、`text`、`schedule`、`repair` 四种表单；
+ * 需要树选择器、上传等宿主能力时用 `custom` 自行渲染。
+ * One pending interaction. The component ships `choice`, `text`, `schedule` and
+ * `repair`; use `custom` when the form needs host capabilities such as a tree
+ * picker or an upload.
+ */
+export type VikingBotInteractionRequest = {
+    /** 单选。Single choice. */
+    kind: 'choice';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 选项。Options. */
+    options: readonly VikingBotInteractionOption[];
+    /** 是否提供「其他」输入项。Whether an inline "other" input is offered. */
+    allowCustomInput?: boolean | {
+        placeholder?: string;
+    };
+} | {
+    /** 文本输入。Free text. */
+    kind: 'text';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 初始值。Initial value. */
+    initialValue?: string;
+    /** 补充说明。Extra description. */
+    description?: ReactNode;
+    /** 是否多行。Whether the input is multiline. */
+    multiline?: boolean;
+} | {
+    /** 定时。Schedule. */
+    kind: 'schedule';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 时区。Time zone. */
+    timezone?: string;
+    /** 初始值。Initial value. */
+    initialValue: VikingBotScheduleValue;
+} | {
+    /** 从候选修复项中选择。Pick one repair candidate. */
+    kind: 'repair';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 候选。Candidates. */
+    options: readonly VikingBotRepairOption[];
+    /** 初始选中的候选标识。Initially selected candidate key. */
+    initialValue?: string;
+} | {
+    /** 由宿主渲染。Rendered by the host. */
+    kind: 'custom';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 渲染函数。Renderer. */
+    render: (context: VikingBotInteractionRenderContext) => ReactNode;
+};
+/** 交互答案。An interaction answer. */
+export type VikingBotInteractionAnswer = {
+    kind: 'choice';
+    value: string;
+} | {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'schedule';
+    value: VikingBotScheduleValue;
+} | {
+    kind: 'repair';
+    value: string;
+} | {
+    kind: 'custom';
+    value: unknown;
+};
+/**
+ * 交互区文案。组件内置英文默认值，宿主可按需覆盖。
+ * Copy of the interaction area. The component ships English defaults; a host
+ * overrides any field it needs.
+ */
+export interface VikingBotInteractionLabels {
+    /** 区域标题，缺省为「待确认」。Area title, "Needs your input" by default. */
+    title?: string;
+    /** 提交按钮。Submit button. */
+    submit?: string;
+    /** 取消按钮。Cancel button. */
+    cancel?: string;
+    /** 「其他」输入项文案。Label of the "other" input. */
+    other?: string;
+    /** 提交成功提示。Shown after a successful submission. */
+    submitted?: string;
+    /** 取消提示。Shown after cancelling. */
+    cancelled?: string;
+    /** 步骤进度，接收当前序号与总数。Step progress, given index and total. */
+    progress?: (index: number, total: number) => string;
+    /** 不启用定时的选项文案。Label of the "no schedule" option. */
+    scheduleNone?: string;
+    /** 每天的选项文案。Label of the daily option. */
+    scheduleDaily?: string;
+    /** 每周的选项文案。Label of the weekly option. */
+    scheduleWeekly?: string;
+    /** 时间输入的无障碍名称。Accessible name of the time input. */
+    scheduleTime?: string;
+    /** 星期选择的无障碍名称。Accessible name of the weekday select. */
+    scheduleWeekday?: string;
+    /** 星期名称，按周一至周日排列。Weekday names, Monday first. */
+    weekdays?: readonly string[];
+}
+/**
+ * 待确认交互区。宿主从自己的流里算出问题，这里只负责表单与状态；
+ * 答案通过 `onSubmit` 上报，宿主决定怎么发回去。
+ * The pending-interaction area. The host derives the question from its own
+ * stream; this renders the form and its state, and reports the answer.
+ */
+export interface VikingBotInteractionProps {
+    /** 当前问题。The current question. */
+    request: VikingBotInteractionRequest;
+    /**
+     * 问题的稳定身份；变化时重置表单状态。省略时按 `request.kind` 与序号判定。
+     * Stable identity of the question; changes reset the form state. Defaults to
+     * the request kind plus the step index.
+     */
+    requestKey?: string;
+    /** 附加到根元素的类名。Class name applied to the root element. */
+    className?: string;
+    /** 当前步骤序号，从 0 开始。Current step index, starting at 0. */
+    index?: number;
+    /** 步骤总数。Total number of steps. */
+    total?: number;
+    /** 是否禁用。Whether the form is disabled. */
+    disabled?: boolean;
+    /** 是否正在提交。Whether a submission is in flight. */
+    submitting?: boolean;
+    /** 提交失败的原因。Why the last submission failed. */
+    error?: ReactNode;
+    /** 上报答案。Reports an answer. */
+    onSubmit?: (answer: VikingBotInteractionAnswer) => void | Promise<void>;
+    /** 放弃本次交互。Abandons this interaction. */
+    onCancel?: () => void;
+    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    labels?: VikingBotInteractionLabels;
+}

package/dist/components/viking-bot/interaction/viking-bot-interaction.d.ts

@@ -0,0 +1,9 @@
+import type { VikingBotInteractionProps } from './types.js';
+/**
+ * 待确认交互区。表单由 Ark 的 AskHuman 渲染；需要树选择器、上传器等宿主
+ * 能力时，`custom` 直接交给宿主渲染。
+ *
+ * The pending-interaction area. Ark's AskHuman renders the form; when a question
+ * needs a tree picker or an uploader, `custom` hands rendering to the host.
+ */
+export declare function VikingBotInteractionView({ request, className, requestKey, index, total, disabled, submitting, error, onSubmit, onCancel, labels: overrides, }: VikingBotInteractionProps): import("react").JSX.Element;

package/dist/components/viking-bot/interaction.js

@@ -0,0 +1,2 @@
+export { DEFAULT_INTERACTION_LABELS } from "../../c7~0.js";
+export { VikingBotInteraction } from "../../w~0.js";

package/dist/components/viking-bot/labels.d.ts

@@ -0,0 +1,2 @@
+import type { VikingBotLabels } from './model.js';
+export declare const DEFAULT_LABELS: Required<VikingBotLabels>;

package/dist/components/viking-bot/lazy-composer.d.ts

@@ -0,0 +1,3 @@
+import type { VikingBotComposerProps, VikingBotComposerRef } from './types.js';
+/** 输入区。The composer. */
+export declare const VikingBotComposer: import("react").ForwardRefExoticComponent<VikingBotComposerProps & import("react").RefAttributes<VikingBotComposerRef>>;

package/dist/components/viking-bot/message-groups.d.ts

@@ -0,0 +1,12 @@
+import type { VikingBotMessage, VikingBotMessagePart } from './model.js';
+/** 把 `viking://` 地址从片段里抽出来，用于渲染可点击引用。 */
+export declare function collectUris(parts: readonly VikingBotMessagePart[]): string[];
+/** 把连续消息按轮次合并，便于渲染同一轮的助手步骤。 */
+export declare function groupMessages(messages: readonly VikingBotMessage[]): VikingBotMessage[];
+/** 取消息的纯文本，用于复制。Plain text of a message, used for copying. */
+export declare function messageText(message: VikingBotMessage): string;
+/** 同一执行块的片段归到一组，供折叠块使用。Groups parts of one activity block. */
+export declare function groupByActivity(parts: readonly VikingBotMessagePart[]): {
+    groupId?: string;
+    parts: VikingBotMessagePart[];
+}[];

package/dist/components/viking-bot/model.d.ts

@@ -0,0 +1,252 @@
+import type { ReactNode } from 'react';
+/**
+ * 片段类型判别值。两种宿主风格共用这一层：宿主在接入层把各自的流事件
+ * 归一化成这些片段，组件不依赖任一方协议。
+ * Part discriminators shared by both host styles. Each host normalizes its own
+ * stream events into these parts; the component depends on neither protocol.
+ */
+/** 纯文本片段。A plain text part. */
+export interface VikingBotTextPart {
+    /** 片段类型。Part type. */
+    type: 'text';
+    /** 文本内容。Text content. */
+    text: string;
+    /**
+     * 文本格式，缺省为 `plain`。开源版的回答是 Markdown，火山版的工具输出是纯文本。
+     * Text format, `plain` by default. Open-source answers are Markdown while
+     * managed-agent tool output is plain text.
+     */
+    format?: 'plain' | 'markdown';
+}
+/** 推理过程片段。A reasoning part. */
+export interface VikingBotReasoningPart {
+    /** 片段类型。Part type. */
+    type: 'reasoning';
+    /** 推理文本。Reasoning text. */
+    text: string;
+    /** 是否仍在生成。Whether the reasoning is still being generated. */
+    running?: boolean;
+    /** 所属执行块标识，同组片段合并展示。Owning activity block; same group collapses together. */
+    groupId?: string;
+    /** 开始时间，毫秒或 ISO 字符串。Start time in milliseconds or ISO text. */
+    startedAt?: number | string;
+    /** 结束时间。End time. */
+    completedAt?: number | string;
+    /** 耗时，单位毫秒。Duration in milliseconds. */
+    durationMs?: number;
+}
+/** Agent 循环的迭代标记。An agent-loop iteration marker. */
+export interface VikingBotIterationPart {
+    /** 片段类型。Part type. */
+    type: 'iteration';
+    /** 迭代轮次。Iteration number. */
+    iteration: number;
+}
+/** 上下文引用片段。A context reference part. */
+export interface VikingBotContextPart {
+    /** 片段类型。Part type. */
+    type: 'context';
+    /** 被引用的资源 URI。URI of the referenced resource. */
+    uri: string;
+    /** 引用类别。Reference category. */
+    contextType: 'memory' | 'resource' | 'skill';
+    /** 引用显示名称，缺省时由 URI 推导。Display label, derived from the URI when omitted. */
+    label?: string;
+    /** 引用摘要。Reference abstract. */
+    abstract?: string;
+}
+/** 工具调用片段。A tool call part. */
+export interface VikingBotToolPart {
+    /** 片段类型。Part type. */
+    type: 'tool';
+    /** 工具调用唯一标识。Unique tool call key. */
+    id: string;
+    /** 工具名称。Tool name. */
+    name: string;
+    /** 调用状态。Call status. */
+    status: 'pending' | 'running' | 'completed' | 'error';
+    /** 调用入参。Call input. */
+    input?: Record<string, unknown>;
+    /** 调用输出文本。Call output text. */
+    output?: string;
+    /** 调用耗时，单位毫秒。Call duration in milliseconds. */
+    durationMs?: number;
+    /** 所属执行块标识。Owning activity block. */
+    groupId?: string;
+    /** MCP 服务名，火山版按服务分组展示。MCP server name; the managed agent groups by it. */
+    server?: string;
+    /** 该调用对应的后端接口，用于展示可点击的接口标签。Backend endpoint, shown as a tag. */
+    endpoint?: {
+        method: string;
+        path: string;
+    };
+}
+/** 工具结果片段，与调用分开以保留到达顺序。A tool result part, kept apart to preserve arrival order. */
+export interface VikingBotToolResultPart {
+    /** 片段类型。Part type. */
+    type: 'tool_result';
+    /** 对应的工具调用标识。Id of the tool call this result belongs to. */
+    id: string;
+    /** 工具名称。Tool name. */
+    name: string;
+    /** 工具输出文本。Tool output text. */
+    output: string;
+    /** 该结果是否为错误。Whether the result is an error. */
+    isError?: boolean;
+    /** 所属执行块标识。Owning activity block. */
+    groupId?: string;
+}
+/** 图片片段。An image part. */
+export interface VikingBotImagePart {
+    /** 片段类型。Part type. */
+    type: 'image';
+    /** 图片地址。Image source. */
+    src: string;
+    /** 图片说明，用作无障碍替代文本。Accessible alt text. */
+    alt?: string;
+    /** 图片细节等级。Image detail level. */
+    detail?: string;
+}
+/** 附件片段。An attachment part. */
+export interface VikingBotAttachmentPart {
+    /** 片段类型。Part type. */
+    type: 'attachment';
+    /** 文件名。File name. */
+    name: string;
+    /** 附件对应的资源 URI。URI of the attachment resource. */
+    uri?: string;
+    /** 附件预览地址。Attachment preview URL. */
+    previewUrl?: string;
+    /** MIME 类型。MIME type. */
+    mimeType?: string;
+}
+/** 消息中的一个内容片段。One content part of a message. */
+export type VikingBotMessagePart = VikingBotTextPart | VikingBotReasoningPart | VikingBotIterationPart | VikingBotContextPart | VikingBotToolPart | VikingBotToolResultPart | VikingBotImagePart | VikingBotAttachmentPart;
+/** 一条消息。A single message. */
+export interface VikingBotMessage {
+    /** 消息唯一标识。Unique message key. */
+    id: string;
+    /**
+     * 消息角色。开源版只有 user 和 assistant；火山版额外有 system 提示与
+     * tool 独立块，因此这里保留四类。
+     * Message role. The open-source host has user and assistant only; the managed
+     * agent also emits system notices and standalone tool blocks.
+     */
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    /** 消息的内容片段。Content parts of the message. */
+    parts: readonly VikingBotMessagePart[];
+    /** 把连续消息归入同一轮次。Groups consecutive messages into one turn. */
+    turnId?: string;
+    /** 消息创建时间。Message creation time. */
+    createdAt?: string;
+    /** 该助手消息是否仍在生成中。Whether the assistant message is still being written. */
+    streaming?: boolean;
+    /**
+     * system 消息的语气，缺省为 `info`；`error` 用于连接中断等提示。
+     * Tone of a system message, `info` by default; `error` for failures.
+     */
+    tone?: 'info' | 'error';
+    /**
+     * 合并后的消息携带的原始动作清单；合并时保留每条消息自己的 messageId，
+     * 渲染时按原始消息回传，避免把动作挂到错误的消息上。
+     * Actions carried by the messages this one merged, each keeping its original
+     * message id so the host receives the right one.
+     */
+    actions?: readonly {
+        /** 原始消息标识。Original message key. */
+        messageId: string;
+        /** 该消息声明的动作。Action declared by that message. */
+        action: NonNullable<VikingBotMessage['action']>;
+    }[];
+    /**
+     * 消息级动作，由宿主声明。火山版用它在助手消息下挂「提交会话」。
+     * Message-level action declared by the host. The managed agent uses it for
+     * the memory-commit control under an assistant message.
+     */
+    action?: {
+        /** 动作标识。Action key. */
+        key: string;
+        /** 动作文案。Action label. */
+        label?: ReactNode;
+        /** 动作状态。Action status. */
+        status?: 'idle' | 'pending' | 'submitted' | 'success' | 'error';
+        /** 不可用时的说明。Reason shown when unavailable. */
+        disabledReason?: string;
+    };
+}
+/** 助手仍在生成时的增量片段。Parts appended while the assistant is still streaming. */
+export interface VikingBotStreamingState {
+    /** 已生成的片段。Parts generated so far. */
+    parts: readonly VikingBotMessagePart[];
+    /** 在 `messages` 中的哪个位置之后追加。Index the parts are appended after. */
+    insertIndex?: number;
+    /** 当前迭代轮次。Current iteration number. */
+    iteration: number;
+}
+/** 一个附件。One attachment. */
+export interface VikingBotAttachment {
+    /** 附件唯一标识。Unique attachment key. */
+    key: string;
+    /** 文件名。File name. */
+    name: string;
+    /** 本地对象 URL 或宿主解析出的预览地址。Local object URL or a host-resolved preview link. */
+    previewUrl?: string;
+    /** MIME 类型。MIME type. */
+    mimeType?: string;
+    /** 字节大小，未知时为 `null`。Size in bytes, or `null` when unknown. */
+    sizeBytes?: number | null;
+    /** 上传状态。Upload status. */
+    status?: 'pending' | 'uploading' | 'ready' | 'error';
+    /** 上传失败时的提示。Message shown when the upload failed. */
+    errorMessage?: string;
+}
+/** 宿主组装好、等待发送的内容。A message composed by the host, waiting to be sent. */
+export interface VikingBotDraft {
+    /** 文本内容。Text content. */
+    text: string;
+    /** 附带的附件。Attached files. */
+    attachments: readonly VikingBotAttachment[];
+}
+/** 可替换文案，组件内置英文默认值。Replaceable copy; the component ships English defaults. */
+export interface VikingBotLabels {
+    /** 输入框占位文本。Input placeholder. */
+    placeholder?: string;
+    /** 发送按钮文案。Send button label. */
+    send?: string;
+    /** 停止按钮文案。Stop button label. */
+    stop?: string;
+    /** 添加附件按钮文案。Attach button label. */
+    attach?: string;
+    /** 移除附件按钮文案。Remove-attachment button label. */
+    removeAttachment?: string;
+    /** 复制按钮文案。Copy button label. */
+    copy?: string;
+    /** 复制成功提示。Message shown after a successful copy. */
+    copied?: string;
+    /** 推理块标题。Heading of the reasoning block. */
+    reasoning?: string;
+    /** 生成中的提示。Message shown while generating. */
+    thinking?: string;
+    /** 工具调用标题。Heading of a tool call. */
+    tool?: string;
+    /** 工具待执行状态。Text for a pending tool call. */
+    toolPending?: string;
+    /** 工具执行中状态。Text for a running tool call. */
+    toolRunning?: string;
+    /** 工具执行成功状态。Text for a completed tool call. */
+    toolCompleted?: string;
+    /** 工具执行失败状态。Text for a failed tool call. */
+    toolError?: string;
+    /** 上下文引用标题。Heading of a context reference. */
+    context?: string;
+    /** 无消息时的提示。Message shown when there are no messages. */
+    empty?: string;
+    /** 新建会话按钮文案。New-session button label. */
+    newSession?: string;
+    /** 重试按钮文案。Retry button label. */
+    retry?: string;
+    /** 回到最新消息按钮文案。Scroll-to-latest button label. */
+    scrollToLatest?: string;
+    /** 不可用时的提示。Message shown while the bot is unavailable. */
+    unavailable?: string;
+}

package/dist/components/viking-bot/render-part.d.ts

@@ -0,0 +1,12 @@
+import type { VikingBotLabels, VikingBotMessagePart } from './model.js';
+/** 片段渲染所需的最小上下文。Context a part renderer needs. */
+export interface PartContext {
+    /** 内置文案。Built-in copy. */
+    labels: VikingBotLabels;
+    /** 打开资源引用。Opens a resource reference. */
+    onOpenUri?: (uri: string) => void;
+    /** 复制文本。Copies text. */
+    onCopy?: (text: string) => void;
+}
+/** 渲染一个片段。Renders one part. */
+export declare function renderPart(part: VikingBotMessagePart, context: PartContext): import("react").JSX.Element;