@springbrand/message-panel 0.1.0 → 0.1.2

package/dist/src/parts/index.js

@@ -0,0 +1,332 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertCircleIcon, ArrowRightIcon, AtomIcon, BarChart3Icon, BellIcon, BlocksIcon, BotIcon, BrainCircuitIcon, CheckCircle2Icon, CheckIcon, ChevronDownIcon, ChevronRightIcon, CircleDotIcon, CircleIcon, Code2Icon, DownloadIcon, ExternalLinkIcon, EyeIcon, FileAudioIcon, FileCodeIcon, FileImageIcon, FileSpreadsheetIcon, FileTextIcon, GlobeIcon, ImageIcon, Loader2Icon, ListTodoIcon, Maximize2Icon, NewspaperIcon, OrbitIcon, RefreshCcwIcon, SparklesIcon, TerminalIcon, TriangleAlertIcon, WrenchIcon, XIcon, } from "lucide-react";
+import { useMemo, useState, } from "react";
+import { cn } from "../internal/cn";
+import { MessageResponse } from "../message";
+import { ThinkingIndicator } from "../status";
+import { resolvePartKind, toolNameOfPart } from "./kind";
+import { planStepsOfPart, } from "./plan";
+import { Confirmation, ConfirmationAccepted, ConfirmationAction, ConfirmationActions, ConfirmationRejected, ConfirmationRequest, ConfirmationTitle, Plan, PlanContent, PlanHeader, PlanTitle, Reasoning, ReasoningContent, ReasoningTrigger, } from "./primitives";
+export { resolvePartKind, toolNameOfPart } from "./kind";
+export { planStepsOfPart, projectLatestPlan, } from "./plan";
+export const OUT_OF_BAND_PREFIX = "[Delivered to the user out of band]";
+export function stripNoticePrefix(text) {
+    const trimmed = text.trimStart();
+    return trimmed.startsWith(OUT_OF_BAND_PREFIX)
+        ? trimmed.slice(OUT_OF_BAND_PREFIX.length).trim()
+        : text.trim();
+}
+export function TextPart({ text, streaming = false }) {
+    if (!text.trim())
+        return null;
+    if (text.trimStart().startsWith(OUT_OF_BAND_PREFIX)) {
+        return _jsx("div", { className: "sb-notice-line", children: stripNoticePrefix(text) });
+    }
+    return (_jsx("div", { "data-part-type": "text", children: _jsx(MessageResponse, { streaming: streaming, children: text }) }));
+}
+export function ReasoningPart({ text, label, streaming = false, duration, }) {
+    if (!text.trim())
+        return null;
+    return (_jsx("div", { "data-part-type": "reasoning", children: _jsxs(Reasoning, { isStreaming: streaming, defaultOpen: streaming, duration: duration, children: [_jsx(ReasoningTrigger, { children: label }), _jsx(ReasoningContent, { children: text })] }) }));
+}
+const toolIcons = {
+    web: GlobeIcon,
+    news: NewspaperIcon,
+    code: Code2Icon,
+    image: ImageIcon,
+    file: FileTextIcon,
+    terminal: TerminalIcon,
+};
+function humanizeToolName(name) {
+    return name
+        .replace(/^tool-/, "")
+        .replace(/[_-]+/g, " ")
+        .replace(/\b\w/g, (character) => character.toUpperCase());
+}
+export function ToolPart({ name, state, input, output, errorText, icon, label, meta, results, command, activityId, onNavigate, }) {
+    const Icon = icon ? toolIcons[icon] : WrenchIcon;
+    const [open, setOpen] = useState(false);
+    const title = label ?? humanizeToolName(name);
+    const running = state === "input-streaming" || state === "input-available";
+    const hasDetails = input != null ||
+        output != null ||
+        Boolean(errorText || command || results?.length);
+    if (state === "interrupted") {
+        return (_jsxs("div", { className: "sb-tool-failed", "data-part-type": "tool", children: [_jsx(TriangleAlertIcon, { size: 16 }), _jsx("span", { children: "Interrupted" }), _jsx("small", { children: title })] }));
+    }
+    if (state === "output-error") {
+        return (_jsxs("div", { className: "sb-tool-failed", "data-part-type": "tool", children: [_jsx(TriangleAlertIcon, { size: 16 }), _jsx("span", { children: "Failed" }), _jsx("small", { children: errorText || title })] }));
+    }
+    return (_jsxs("div", { className: "sb-tool-line", "data-part-type": "tool", children: [_jsxs("button", { type: "button", className: "sb-tool-line__trigger", "aria-expanded": open, onClick: () => {
+                    if (hasDetails)
+                        setOpen((current) => !current);
+                    if (activityId)
+                        onNavigate?.(activityId);
+                }, children: [_jsx(Icon, { size: 16 }), _jsx("span", { children: running ? `${title}…` : title }), meta && _jsx("small", { children: meta }), running ? (_jsx(Loader2Icon, { size: 14, className: "sb-spin" })) : (hasDetails && (_jsx(ChevronRightIcon, { size: 15, className: cn("sb-tool-line__chevron", open && "is-open") })))] }), open && (_jsxs("div", { className: "sb-tool-line__details", children: [results?.length ? (_jsx("ul", { className: "sb-tool-results", children: results.map((result, index) => (_jsxs("li", { children: [_jsx("i", { "data-index": index % 2 }), _jsx("span", { children: result.title }), _jsx("small", { children: result.domain })] }, `${result.domain}:${result.title}`))) })) : null, command && (_jsxs("div", { className: "sb-terminal", children: [_jsxs("code", { children: ["$ ", command] }), typeof output === "string" && _jsx("pre", { children: output })] })), !command && input != null && (_jsx("pre", { children: JSON.stringify(input, null, 2) })), !command && output != null && (_jsx("pre", { children: typeof output === "string"
+                            ? output
+                            : JSON.stringify(output, null, 2) }))] }))] }));
+}
+export function ErrorPart({ title = "Error", body, onRetry, }) {
+    return (_jsxs("div", { className: "sb-error-part", "data-part-type": "error", role: "alert", children: [_jsx(AlertCircleIcon, { size: 18 }), _jsxs("div", { children: [_jsx("strong", { children: title }), _jsx("p", { children: body }), onRetry && (_jsxs("button", { type: "button", className: "sb-link-button", onClick: onRetry, children: [_jsx(RefreshCcwIcon, { size: 14 }), "\u91CD\u8BD5"] }))] })] }));
+}
+export function ImagePart({ src, alt, onPreview, }) {
+    return (_jsxs("figure", { className: "sb-image-part", "data-part-type": "image", children: [_jsxs("button", { type: "button", onClick: onPreview, "aria-label": `预览图片：${alt}`, children: [_jsx("img", { src: src, alt: alt }), onPreview && _jsx(Maximize2Icon, { size: 17 })] }), _jsx("figcaption", { children: alt })] }));
+}
+export function ChartPart({ title, unit, bars, expandable, onPreview, }) {
+    const max = Math.max(...bars.map((bar) => bar.value), 1);
+    return (_jsxs("section", { className: "sb-chart", "data-part-type": "chart", "aria-label": title, children: [_jsxs("header", { children: [_jsxs("span", { children: [_jsx(BarChart3Icon, { size: 17 }), _jsx("strong", { children: title })] }), expandable && (_jsx("button", { type: "button", onClick: onPreview, "aria-label": "\u5C55\u5F00\u56FE\u8868", children: _jsx(Maximize2Icon, { size: 16 }) }))] }), _jsx("div", { className: "sb-chart__plot", children: bars.map((bar) => (_jsxs("div", { className: "sb-chart__bar-group", children: [_jsxs("span", { children: [bar.value, unit] }), _jsx("i", { style: { "--sb-bar-height": `${(bar.value / max) * 100}%` } }), _jsx("small", { children: bar.label })] }, bar.label))) })] }));
+}
+export function AgentCardPart({ title, agentName, agentDesc, onNavigate, }) {
+    return (_jsxs("section", { className: "sb-agent-card", "data-part-type": "agent_card", children: [_jsx("small", { children: title }), _jsxs("div", { children: [_jsx("span", { className: "sb-agent-card__icon", children: _jsx(BotIcon, { size: 20 }) }), _jsxs("div", { children: [_jsx("strong", { children: agentName }), _jsx("p", { children: agentDesc })] }), onNavigate && (_jsx("button", { type: "button", onClick: onNavigate, "aria-label": `打开 ${agentName}`, children: _jsx(ArrowRightIcon, { size: 17 }) }))] })] }));
+}
+export function StepStatusIcon({ status, animated = false, }) {
+    if (status === "done")
+        return _jsx(CheckCircle2Icon, { size: 16, "data-tone": "success" });
+    if (status === "in_progress") {
+        return animated ? (_jsx(Loader2Icon, { size: 16, className: "sb-spin", "data-tone": "active" })) : (_jsx(CircleDotIcon, { size: 16, "data-tone": "muted" }));
+    }
+    return _jsx(CircleIcon, { size: 16, "data-tone": "muted" });
+}
+export function PlanPart({ title, steps, streaming = false, }) {
+    const done = steps.filter((step) => step.status === "done").length;
+    const allDone = steps.length > 0 && done === steps.length;
+    const animated = streaming && !allDone;
+    return (_jsxs(Plan, { className: "sb-plan-card", "data-part-type": "plan", isStreaming: animated, children: [_jsxs(PlanHeader, { children: [_jsxs("div", { className: "sb-plan__heading", children: [_jsx(ListTodoIcon, { size: 18 }), _jsx(PlanTitle, { children: title })] }), steps.length > 0 && (_jsxs("span", { className: "sb-plan__badge", "data-state": allDone ? "done" : animated ? "running" : "paused", children: [allDone && _jsx(CheckCircle2Icon, { size: 13 }), allDone
+                                ? "Done"
+                                : `${animated ? "Running · " : ""}${done}/${steps.length}`] }))] }), _jsx(PlanContent, { children: steps.length > 0 ? (_jsx("ol", { className: "sb-plan__steps", children: steps.map((step, index) => {
+                        const status = step.status ??
+                            (animated && index === done ? "in_progress" : "pending");
+                        return (_jsxs("li", { "data-status": status, children: [_jsx(StepStatusIcon, { status: status, animated: animated && status === "in_progress" }), _jsx("span", { children: step.text })] }, `${index}:${step.text}`));
+                    }) })) : animated ? (_jsx("div", { className: "sb-plan__skeleton", role: "status", "aria-label": "\u6B63\u5728\u751F\u6210\u8BA1\u5212", children: [72, 56, 40].map((width) => (_jsxs("span", { children: [_jsx("i", {}), _jsx("b", { style: { width: `${width}%` } })] }, width))) })) : (_jsx("p", { className: "sb-plan__empty", children: "(\u7A7A\u8BA1\u5212)" })) })] }));
+}
+export function SchedulePart({ title, cadence, nextRun, scheduled = false, onSchedule, }) {
+    return (_jsxs("section", { className: "sb-schedule", "data-part-type": "schedule", children: [_jsx(BellIcon, { size: 18 }), _jsxs("div", { children: [_jsx("strong", { children: title }), _jsx("p", { children: cadence }), _jsx("small", { children: nextRun })] }), _jsx("button", { type: "button", className: "sb-button", onClick: onSchedule, disabled: scheduled, children: scheduled ? "已安排" : "安排" })] }));
+}
+export function RunningRow({ tool }) {
+    const Icon = tool.icon ? toolIcons[tool.icon] : WrenchIcon;
+    return (_jsxs("div", { className: "sb-running-row", children: [_jsx(Icon, { size: 15 }), _jsx("span", { children: tool.label }), _jsx(Loader2Icon, { size: 14, className: "sb-spin" })] }));
+}
+export function CollapsedRow({ tool }) {
+    const Icon = tool.icon ? toolIcons[tool.icon] : WrenchIcon;
+    return (_jsxs("div", { className: "sb-collapsed-row", children: [_jsx(Icon, { size: 15 }), _jsx("span", { children: tool.label }), _jsx("small", { children: tool.meta }), tool.status === "failed" ? _jsx(XIcon, { size: 14 }) : _jsx(CheckIcon, { size: 14 })] }));
+}
+export function ParallelPart({ label = "Parallel tasks", tools, isActive = true, }) {
+    const active = isActive && tools.some((tool) => tool.status === "running");
+    return (_jsxs("details", { className: "sb-parallel", "data-part-type": "parallel", open: active, children: [_jsxs("summary", { children: [_jsx("strong", { children: label }), _jsxs("span", { children: [tools.filter((tool) => tool.status === "done").length, "/", tools.length] }), _jsx(ChevronDownIcon, { size: 16 })] }), _jsx("div", { children: tools.map((tool, index) => tool.status === "running" && isActive ? (_jsx(RunningRow, { tool: tool }, `${index}:${tool.label}`)) : (_jsx(CollapsedRow, { tool: tool.status === "running"
+                        ? { ...tool, status: "failed" }
+                        : tool }, `${index}:${tool.label}`))) })] }));
+}
+const SUBAGENT_VISUALS = [
+    { icon: SparklesIcon, name: "sparkles", color: "#e59a45" },
+    { icon: AtomIcon, name: "atom", color: "#9b7bd1" },
+    { icon: BrainCircuitIcon, name: "brain", color: "#9b7bd1" },
+    { icon: OrbitIcon, name: "orbit", color: "#e59a45" },
+    { icon: BlocksIcon, name: "blocks", color: "#e59a45" },
+];
+function subAgentVisual(name) {
+    let hash = 0;
+    for (const character of name) {
+        hash = (hash * 31 + (character.codePointAt(0) ?? 0)) >>> 0;
+    }
+    return SUBAGENT_VISUALS[hash % SUBAGENT_VISUALS.length] ?? SUBAGENT_VISUALS[0];
+}
+export function SubAgentsPart({ agents, isActive = true, }) {
+    return (_jsx("div", { className: "sb-subagents", "data-part-type": "subagents", children: agents.map((agent, index) => {
+            const visual = subAgentVisual(agent.name);
+            const AgentIcon = visual.icon;
+            return (_jsxs("article", { "data-state": agent.status ?? "done", children: [_jsx("span", { "data-subagent-icon": visual.name, style: { color: agent.tint ?? visual.color }, "aria-hidden": "true", children: _jsx(AgentIcon, { size: 14, strokeWidth: 2.25 }) }), _jsxs("div", { children: [_jsx("strong", { children: agent.name }), agent.status === "running" && isActive ? (_jsxs("small", { children: [_jsx(Loader2Icon, { size: 12, className: "sb-spin" }), "Running\u2026"] })) : (_jsx("p", { children: agent.summary || (agent.status === "running" ? "Interrupted" : "") }))] })] }, `${index}:${agent.name}`));
+        }) }));
+}
+export function ConfirmationPart({ id = "confirmation", title, body, confirmLabel = "确认", cancelLabel = "取消", state, onConfirm, }) {
+    const [internalState, setInternalState] = useState(state ?? "pending");
+    const resolvedState = state ?? internalState;
+    const decide = async (confirmed) => {
+        await onConfirm?.(confirmed);
+        if (state === undefined)
+            setInternalState(confirmed ? "confirmed" : "cancelled");
+    };
+    return (_jsx("div", { "data-part-type": "confirmation", children: _jsxs(Confirmation, { state: resolvedState, approval: { id, approved: resolvedState === "pending" ? undefined : resolvedState === "confirmed" }, children: [_jsxs(ConfirmationTitle, { children: [_jsx(AlertCircleIcon, { size: 18 }), _jsxs("span", { children: [_jsx(ConfirmationRequest, { children: title }), _jsxs(ConfirmationAccepted, { children: ["\u5DF2\u786E\u8BA4\uFF1A", title] }), _jsxs(ConfirmationRejected, { children: ["\u5DF2\u53D6\u6D88\uFF1A", title] })] })] }), body && _jsx("p", { children: body }), _jsxs(ConfirmationActions, { children: [_jsx(ConfirmationAction, { className: "sb-button--secondary", onClick: () => void decide(false), children: cancelLabel }), _jsx(ConfirmationAction, { onClick: () => void decide(true), children: confirmLabel })] })] }) }));
+}
+function ToolApprovalPresentation({ children, toolName, state, context, }) {
+    const approval = context.approval;
+    if (!approval)
+        return _jsx(_Fragment, { children: children });
+    return (_jsxs("div", { className: "sb-tool-stack", children: [children, _jsxs(Confirmation, { approval: approval, state: state, children: [_jsxs(ConfirmationTitle, { children: [_jsxs(ConfirmationRequest, { children: [_jsx("strong", { children: humanizeToolName(toolName) }), " \u8BF7\u6C42\u6267\u884C\uFF0C\u9700\u8981\u4F60\u7684\u6279\u51C6\u3002"] }), _jsxs(ConfirmationAccepted, { children: ["\u5DF2\u6279\u51C6 ", humanizeToolName(toolName), "\uFF0C\u7EE7\u7EED\u6267\u884C\u3002"] }), _jsxs(ConfirmationRejected, { children: ["\u5DF2\u62D2\u7EDD ", humanizeToolName(toolName), "\u3002"] })] }), _jsxs(ConfirmationActions, { children: [_jsx(ConfirmationAction, { className: "sb-button--secondary", onClick: () => void context.actions.onApprove?.(approval.id, "deny"), children: "\u62D2\u7EDD" }), _jsx(ConfirmationAction, { className: "sb-button--secondary", onClick: () => void context.actions.onApprove?.(approval.id, "allow_once"), children: "\u4EC5\u672C\u6B21\u5141\u8BB8" }), _jsx(ConfirmationAction, { onClick: () => void context.actions.onApprove?.(approval.id, "allow_level"), children: "\u5141\u8BB8\u8BE5\u6863\u4F4D" })] })] })] }));
+}
+const fileIcons = {
+    doc: FileTextIcon,
+    image: FileImageIcon,
+    html: Code2Icon,
+    audio: FileAudioIcon,
+    csv: FileSpreadsheetIcon,
+    code: FileCodeIcon,
+};
+export function FilePart({ name, kind = "doc", note, url, artifact, onPreview, onDownload, }) {
+    const Icon = fileIcons[kind];
+    const payload = artifact ?? { name, kind, note, url };
+    return (_jsxs("div", { className: "sb-file-part", "data-part-type": "file", children: [_jsx("span", { children: _jsx(Icon, { size: 19 }) }), _jsxs("div", { children: [_jsx("strong", { children: name }), note && _jsx("small", { children: note })] }), _jsxs("div", { children: [onPreview && (_jsx("button", { type: "button", onClick: () => onPreview(payload), "aria-label": `预览 ${name}`, children: _jsx(EyeIcon, { size: 16 }) })), onDownload ? (_jsx("button", { type: "button", onClick: () => onDownload(payload), "aria-label": `下载 ${name}`, children: _jsx(DownloadIcon, { size: 16 }) })) : url ? (_jsx("a", { href: url, target: "_blank", rel: "noreferrer", download: name, "aria-label": `打开 ${name}`, children: _jsx(ExternalLinkIcon, { size: 16 }) })) : null] })] }));
+}
+export function DashboardPart(data) {
+    return (_jsxs("section", { className: "sb-dashboard", "data-part-type": "dashboard", children: [_jsx("h3", { children: data.title }), data.tiles?.length ? (_jsx("div", { className: "sb-dashboard__tiles", children: data.tiles.map((tile) => (_jsxs("article", { children: [_jsx("strong", { children: tile.value }), _jsx("small", { children: tile.label })] }, tile.label))) })) : null, data.cards?.length ? (_jsx("div", { className: "sb-dashboard__cards", children: data.cards.map((card) => (_jsxs("article", { children: [_jsx("span", { children: card.icon }), _jsx("strong", { children: card.title }), _jsx("p", { children: card.body })] }, card.title))) })) : null, data.badges?.length ? _jsx("div", { className: "sb-dashboard__badges", children: data.badges.map((badge) => _jsx("span", { children: badge }, badge)) }) : null, data.fileNote && _jsxs("aside", { children: [_jsx("strong", { children: data.fileNote.title }), _jsx("p", { children: data.fileNote.body })] }), data.table && (_jsx("div", { className: "sb-table-scroll", children: _jsxs("table", { children: [_jsx("thead", { children: _jsx("tr", { children: data.table.columns.map((column) => _jsx("th", { children: column }, column)) }) }), _jsx("tbody", { children: data.table.rows.map((row, index) => _jsx("tr", { children: row.map((cell, cellIndex) => _jsx("td", { children: cell }, cellIndex)) }, index)) })] }) }))] }));
+}
+export function AskUserPart({ questions, freeTextPlaceholder, submittedAnswer, onSubmit, }) {
+    const [selections, setSelections] = useState(() => questions.map(() => []));
+    const [text, setText] = useState("");
+    const [submitted, setSubmitted] = useState(false);
+    const externalAnswer = submittedAnswer?.trim() ?? "";
+    const externalSelections = useMemo(() => new Set(externalAnswer
+        ? externalAnswer.split("、").map((item) => item.trim()).filter(Boolean)
+        : []), [externalAnswer]);
+    const resolvedSubmitted = submitted || Boolean(externalAnswer);
+    const valid = questions.every((question, index) => question.kind !== "single" || selections[index].length === 1);
+    const toggle = (questionIndex, option) => {
+        if (resolvedSubmitted)
+            return;
+        setSelections((current) => current.map((selected, index) => {
+            if (index !== questionIndex)
+                return selected;
+            if (questions[index].kind === "single")
+                return [option];
+            return selected.includes(option)
+                ? selected.filter((item) => item !== option)
+                : [...selected, option];
+        }));
+    };
+    const submit = async () => {
+        if (!valid || resolvedSubmitted)
+            return;
+        await onSubmit?.({ selections, text: text.trim() });
+        setSubmitted(true);
+    };
+    const resolvedAnswer = externalAnswer ||
+        [...selections.flat(), text.trim()].filter(Boolean).join("、");
+    return (_jsxs("section", { className: "sb-ask-user", "data-part-type": "ask_user", "data-state": resolvedSubmitted ? "submitted" : "pending", children: [questions.map((question, questionIndex) => (_jsxs("fieldset", { disabled: resolvedSubmitted, children: [_jsx("legend", { children: question.prompt }), _jsx("div", { children: question.options.map((option) => {
+                            const selected = externalAnswer
+                                ? externalSelections.has(option)
+                                : selections[questionIndex].includes(option);
+                            return (_jsxs("button", { type: "button", "aria-pressed": selected, onClick: () => toggle(questionIndex, option), children: [question.kind === "multi" && _jsx("span", { children: selected && _jsx(CheckIcon, { size: 12 }) }), selected && question.kind === "single" && _jsx(CheckIcon, { size: 14 }), option] }, option));
+                        }) })] }, `${questionIndex}:${question.prompt}`))), freeTextPlaceholder && !resolvedSubmitted && (_jsx("textarea", { value: text, onChange: (event) => setText(event.currentTarget.value), placeholder: freeTextPlaceholder })), resolvedSubmitted ? (_jsxs("div", { className: "sb-ask-user__submitted", children: [_jsx(CheckIcon, { size: 15 }), _jsx("span", { children: "Submitted" }), resolvedAnswer && _jsx("small", { children: resolvedAnswer })] })) : (_jsxs("button", { type: "button", className: "sb-button", disabled: !valid, onClick: () => void submit(), children: ["\u63D0\u4EA4", _jsx(ArrowRightIcon, { size: 15 })] }))] }));
+}
+export function Suggestions({ items, onPick, }) {
+    return (_jsx("div", { className: "sb-suggestions", "data-part-type": "suggestions", children: items.map((item) => (_jsxs("button", { type: "button", onClick: () => void onPick?.(item), children: [_jsx(ArrowRightIcon, { size: 15 }), _jsx("span", { children: item })] }, item))) }));
+}
+export function InlineText({ children }) {
+    return _jsx("span", { className: "sb-inline-text", children: children });
+}
+export function PartLoading({ kind, label, }) {
+    if (kind === "reasoning")
+        return _jsx(ThinkingIndicator, {});
+    if (kind === "tool")
+        return _jsx(RunningRow, { tool: { label: label ?? "Running tool", status: "running" } });
+    return (_jsxs("div", { className: "sb-part-loading", "data-kind": kind, role: "status", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }));
+}
+export function UnknownPart({ part }) {
+    const type = part && typeof part === "object" && typeof part.type === "string"
+        ? part.type
+        : "unknown";
+    return (_jsxs("div", { className: "sb-unknown-part", "data-part-type": "unknown", "data-unknown-type": type, children: [_jsx(AlertCircleIcon, { size: 15 }), _jsxs("span", { children: ["\u6682\u4E0D\u652F\u6301\u7684\u6D88\u606F\u7EC4\u4EF6\uFF1A", type] })] }));
+}
+function objectOf(value) {
+    return value != null && typeof value === "object"
+        ? value
+        : {};
+}
+function strings(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string")
+        : [];
+}
+function dataOf(part) {
+    const record = objectOf(part);
+    return objectOf(record.data ?? record.input ?? record.arguments ?? record);
+}
+function fileKind(mediaType, filename) {
+    const value = `${String(mediaType ?? "")} ${String(filename ?? "")}`;
+    if (/image/i.test(value))
+        return "image";
+    if (/audio/i.test(value))
+        return "audio";
+    if (/csv|sheet|excel/i.test(value))
+        return "csv";
+    if (/html/i.test(value))
+        return "html";
+    if (/code|javascript|typescript|json|xml/i.test(value))
+        return "code";
+    return "doc";
+}
+export function DefaultPartRenderer({ part, context, }) {
+    const record = objectOf(part);
+    if (record.type === "step-start")
+        return null;
+    const data = dataOf(part);
+    const kind = resolvePartKind(part);
+    const toolName = toolNameOfPart(part);
+    const toolState = String(record.state ?? data.state ?? "output-available");
+    const withToolApproval = (children) => toolName ? (_jsx(ToolApprovalPresentation, { toolName: toolName, state: toolState, context: context, children: children })) : (children);
+    if (kind === "text") {
+        return _jsx(TextPart, { text: String(record.text ?? data.text ?? ""), streaming: context.isActive });
+    }
+    if (kind === "reasoning") {
+        return (_jsx(ReasoningPart, { text: String(record.thinking ?? record.text ?? data.detail ?? data.text ?? ""), label: typeof data.label === "string" ? data.label : undefined, streaming: context.isActive && record.state === "streaming" }));
+    }
+    if (kind === "tool") {
+        const name = toolName ?? String(data.name ?? "tool");
+        const state = toolState;
+        const pending = state === "input-available" || state === "input-streaming";
+        return withToolApproval(_jsx(ToolPart, { name: name, label: typeof data.label === "string" ? data.label : undefined, icon: typeof data.icon === "string" && data.icon in toolIcons ? data.icon : undefined, state: pending && !context.isActive ? "interrupted" : state, input: record.input ?? record.arguments, output: record.output ?? data.output, errorText: typeof record.errorText === "string" ? record.errorText : undefined, command: typeof data.command === "string" ? data.command : undefined, meta: typeof data.meta === "string" ? data.meta : undefined, results: Array.isArray(data.results) ? data.results : undefined, activityId: context.activityId, onNavigate: context.actions.onNavigate }));
+    }
+    if (kind === "error") {
+        return _jsx(ErrorPart, { title: String(data.title ?? "Error"), body: String(data.body ?? data.message ?? "请求失败") });
+    }
+    if (kind === "image") {
+        return _jsx(ImagePart, { src: String(record.src ?? record.url ?? data.src ?? data.url ?? ""), alt: String(record.alt ?? record.filename ?? data.alt ?? data.filename ?? "图片"), onPreview: () => context.actions.onPreview?.(part) });
+    }
+    if (kind === "chart") {
+        return _jsx(ChartPart, { title: String(data.title ?? "Chart"), unit: typeof data.unit === "string" ? data.unit : undefined, bars: Array.isArray(data.bars) ? data.bars : [], expandable: Boolean(data.expandable), onPreview: () => context.actions.onPreview?.(part) });
+    }
+    if (kind === "agent_card") {
+        return _jsx(AgentCardPart, { title: String(data.title ?? "Agent"), agentName: String(data.agentName ?? data.name ?? "Agent"), agentDesc: String(data.agentDesc ?? data.description ?? ""), onNavigate: () => context.actions.onNavigate?.(String(data.target ?? "agents")) });
+    }
+    if (kind === "plan") {
+        if (!context.isLatestOfKind)
+            return null;
+        const steps = planStepsOfPart(part);
+        return withToolApproval(_jsx(PlanPart, { title: String(data.title ?? "任务计划"), steps: steps, streaming: context.isActive && context.status === "streaming" }));
+    }
+    if (kind === "schedule") {
+        return withToolApproval(_jsx(SchedulePart, { title: String(data.title ?? "安排任务"), cadence: String(data.cadence ?? data.schedule ?? ""), nextRun: String(data.nextRun ?? data.next_run ?? ""), scheduled: Boolean(data.scheduled), onSchedule: () => context.actions.onAnswer?.({ type: "schedule", data }) }));
+    }
+    if (kind === "parallel") {
+        return withToolApproval(_jsx(ParallelPart, { label: typeof data.label === "string" ? data.label : undefined, tools: Array.isArray(data.tools) ? data.tools : [], isActive: context.isActive }));
+    }
+    if (kind === "subagents") {
+        const agents = Array.isArray(data.agents)
+            ? data.agents
+            : [{ name: String(data.name ?? "Sub-agent"), summary: String(data.summary ?? ""), status: context.isActive ? "running" : "done" }];
+        return withToolApproval(_jsx(SubAgentsPart, { agents: agents, isActive: context.isActive }));
+    }
+    if (kind === "confirmation") {
+        return _jsx(ConfirmationPart, { id: String(data.id ?? context.activityId), title: String(data.title ?? "确认操作？"), body: typeof data.body === "string" ? data.body : undefined, confirmLabel: String(data.confirmLabel ?? "确认"), cancelLabel: String(data.cancelLabel ?? "取消"), onConfirm: (confirmed) => context.actions.onApprove?.(String(data.id ?? context.activityId), confirmed ? "allow_once" : "deny") });
+    }
+    if (kind === "file") {
+        const filename = String(record.filename ?? data.name ?? data.filename ?? record.mediaType ?? "附件");
+        return _jsx(FilePart, { name: filename, kind: fileKind(record.mediaType ?? data.mediaType, filename), note: typeof data.note === "string" ? data.note : undefined, url: typeof record.url === "string" ? record.url : typeof data.url === "string" ? data.url : undefined, artifact: part, onPreview: context.actions.onPreview, onDownload: context.actions.onDownload });
+    }
+    if (kind === "dashboard") {
+        return _jsx(DashboardPart, { ...data, title: String(data.title ?? "Dashboard") });
+    }
+    if (kind === "ask_user") {
+        const questions = Array.isArray(data.questions)
+            ? data.questions
+            : [{
+                    prompt: String(data.question ?? "请选择"),
+                    kind: data.multiSelect === true ? "multi" : "single",
+                    options: strings(data.options),
+                }];
+        return withToolApproval(_jsx(AskUserPart, { questions: questions, freeTextPlaceholder: typeof data.freeTextPlaceholder === "string" ? data.freeTextPlaceholder : undefined, submittedAnswer: context.replyText, onSubmit: (payload) => context.actions.onAnswer?.(payload) }));
+    }
+    if (kind === "suggestions") {
+        return withToolApproval(_jsx(Suggestions, { items: strings(data.items), onPick: context.actions.onSuggestion }));
+    }
+    return _jsx(UnknownPart, { part: part });
+}

package/dist/src/parts/kind.d.ts

@@ -0,0 +1,3 @@
+import type { RichPartKind } from "../contracts";
+export declare function toolNameOfPart(part: unknown): string | null;
+export declare function resolvePartKind(part: unknown): RichPartKind | null;

package/dist/src/parts/kind.js

@@ -0,0 +1,69 @@
+function objectOf(value) {
+    return value != null && typeof value === "object"
+        ? value
+        : {};
+}
+export function toolNameOfPart(part) {
+    const record = objectOf(part);
+    const type = typeof record.type === "string" ? record.type : "";
+    if (type === "toolCall") {
+        return typeof record.name === "string" ? record.name : "tool";
+    }
+    if (type === "dynamic-tool") {
+        return typeof record.toolName === "string" ? record.toolName : "dynamic";
+    }
+    return type.startsWith("tool-") ? type.slice(5) : null;
+}
+export function resolvePartKind(part) {
+    const record = objectOf(part);
+    const type = typeof record.type === "string" ? record.type : "";
+    const toolName = toolNameOfPart(part);
+    if (type === "thinking")
+        return "reasoning";
+    if (type === "tool")
+        return "tool";
+    if (toolName === "update_plan")
+        return "plan";
+    if (toolName === "ask_user")
+        return "ask_user";
+    if (toolName === "suggest_followups")
+        return "suggestions";
+    if (toolName === "schedule")
+        return "schedule";
+    if (toolName === "parallel")
+        return "parallel";
+    if (toolName === "subagents" ||
+        toolName === "run_agent" ||
+        toolName === "run_temporary_agent" ||
+        toolName === "fanout" ||
+        toolName === "extract" ||
+        toolName === "dispatch_background") {
+        return "subagents";
+    }
+    if (toolName)
+        return "tool";
+    const normalized = type.startsWith("data-")
+        ? type.slice(5).replaceAll("-", "_")
+        : type;
+    return [
+        "text",
+        "reasoning",
+        "error",
+        "image",
+        "chart",
+        "agent_card",
+        "plan",
+        "schedule",
+        "parallel",
+        "subagents",
+        "confirmation",
+        "file",
+        "dashboard",
+        "ask_user",
+        "suggestions",
+    ].includes(normalized)
+        ? normalized
+        : type === "reasoning-file"
+            ? "file"
+            : null;
+}

package/dist/src/parts/plan.d.ts

@@ -0,0 +1,10 @@
+export type PlanStepStatus = "pending" | "in_progress" | "done";
+export interface PlanStep {
+    text: string;
+    status?: PlanStepStatus;
+}
+export declare function planStepsOfPart(part: unknown): PlanStep[];
+export declare function projectLatestPlan(messages: readonly {
+    role: string;
+    parts: readonly unknown[];
+}[]): PlanStep[] | null;

package/dist/src/parts/plan.js

@@ -0,0 +1,40 @@
+import { resolvePartKind } from "./kind";
+function recordOf(value) {
+    return value != null && typeof value === "object"
+        ? value
+        : {};
+}
+export function planStepsOfPart(part) {
+    const record = recordOf(part);
+    const data = recordOf(record.data ?? record.input ?? record.arguments ?? record);
+    if (!Array.isArray(data.steps))
+        return [];
+    return data.steps.flatMap((step) => {
+        const value = recordOf(step);
+        const text = typeof value.text === "string" ? value.text.trim() : "";
+        if (!text)
+            return [];
+        const status = value.status === "in_progress" || value.status === "done"
+            ? value.status
+            : "pending";
+        return [{ text, status }];
+    });
+}
+export function projectLatestPlan(messages) {
+    for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex -= 1) {
+        const message = messages[messageIndex];
+        if (message.role !== "assistant")
+            continue;
+        for (let partIndex = message.parts.length - 1; partIndex >= 0; partIndex -= 1) {
+            const part = message.parts[partIndex];
+            if (resolvePartKind(part) !== "plan")
+                continue;
+            const steps = planStepsOfPart(part);
+            if (steps.length > 0)
+                return steps;
+            if (recordOf(part).state !== "input-streaming")
+                return null;
+        }
+    }
+    return null;
+}

package/dist/src/parts/primitives.d.ts

@@ -0,0 +1,70 @@
+import { type ButtonHTMLAttributes, type DetailsHTMLAttributes, type HTMLAttributes, type ReactNode } from "react";
+import type { AIToolPart } from "../contracts";
+export interface ReasoningProps extends HTMLAttributes<HTMLDivElement> {
+    isStreaming?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    duration?: number;
+}
+export declare function Reasoning({ isStreaming, open, defaultOpen, onOpenChange, duration, className, children, ...props }: ReasoningProps): import("react").JSX.Element;
+export declare function ReasoningTrigger({ children, className, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
+export declare function ReasoningContent({ children, className, ...props }: Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    children: string;
+}): import("react").JSX.Element | null;
+type ToolPart = AIToolPart;
+export type ToolState = ToolPart["state"];
+export declare function getStatusBadge(status: ToolState): import("react").JSX.Element;
+export declare const Tool: import("react").ForwardRefExoticComponent<DetailsHTMLAttributes<HTMLDetailsElement> & import("react").RefAttributes<HTMLDetailsElement>>;
+type ToolHeaderProps = HTMLAttributes<HTMLElement> & {
+    title?: string;
+    type: ToolPart["type"];
+    state: ToolState;
+    toolName?: string;
+};
+export declare function ToolHeader({ className, title, type, state, toolName, ...props }: ToolHeaderProps): import("react").JSX.Element;
+export declare const ToolContent: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import("react").RefAttributes<HTMLDivElement>>;
+export declare function ToolInput({ input, className, ...props }: HTMLAttributes<HTMLPreElement> & {
+    input: unknown;
+}): import("react").JSX.Element;
+export declare function ToolOutput({ output, errorText, className, ...props }: HTMLAttributes<HTMLPreElement> & {
+    output: unknown;
+    errorText?: string;
+}): import("react").JSX.Element | null;
+export interface ConfirmationProps extends HTMLAttributes<HTMLDivElement> {
+    state: ToolState | "pending" | "confirmed" | "cancelled";
+    approval?: {
+        id: string;
+        approved?: boolean;
+    };
+}
+export declare function Confirmation({ state, approval, className, ...props }: ConfirmationProps): import("react").JSX.Element;
+export declare const ConfirmationTitle: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;
+export declare function ConfirmationRequest({ children }: {
+    children?: ReactNode;
+}): ReactNode;
+export declare function ConfirmationAccepted({ children }: {
+    children?: ReactNode;
+}): ReactNode;
+export declare function ConfirmationRejected({ children }: {
+    children?: ReactNode;
+}): ReactNode;
+export declare function ConfirmationActions({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element | null;
+export declare const ConfirmationAction: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & import("react").RefAttributes<HTMLButtonElement>>;
+export declare const Plan: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    isStreaming?: boolean;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export declare const PlanHeader: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;
+export declare const PlanTitle: ({ className, ...props }: HTMLAttributes<HTMLHeadingElement>) => import("react").JSX.Element;
+export declare const PlanDescription: ({ className, ...props }: HTMLAttributes<HTMLParagraphElement>) => import("react").JSX.Element;
+export declare const PlanContent: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;
+export declare const PlanFooter: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;
+export declare const Sources: import("react").ForwardRefExoticComponent<DetailsHTMLAttributes<HTMLDetailsElement> & import("react").RefAttributes<HTMLDetailsElement>>;
+export declare function SourcesTrigger({ count, children, className, ...props }: HTMLAttributes<HTMLElement> & {
+    count: number;
+}): import("react").JSX.Element;
+export declare const SourcesContent: ({ className, ...props }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;
+export declare function Source({ title, children, ...props }: React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    title?: string;
+}): import("react").JSX.Element;
+export {};