@springbrand/message-panel 0.1.3-alpha.0 → 0.1.3-alpha.2

package/demo/chat-scenarios.ts

@@ -0,0 +1,926 @@
+import type { UIMessage } from "ai";
+
+/**
+ * 演示场景的唯一事实源。camel 与 cloud-os 两套展示壳共用这一份 —— 需求是
+ * 「cloud-os demo 的状态和 camel-chat-showcase 一致」,所以状态表只能有一份,
+ * 不能各拷一份等着漂移。
+ */
+
+/** 和 MessagePanelStatus 同构。刻意不 import ../src —— cloud-os 展示壳要能
+ *  在完全不碰 src 的前提下用这份场景表。 */
+export type DemoStatus = "ready" | "submitted" | "streaming" | "error";
+
+export interface ComposerCommandLike {
+  name: string;
+  description: string;
+  prompt: string;
+  icon: string;
+}
+const demoCompletedAt = Date.now() - 1_000;
+const demoTurnStartedAt = demoCompletedAt - 18_000;
+export const defaultPrompt =
+  "请调研 2026 年 AI Agent 产品的交互趋势，并给出可落地的消息 UI 建议。";
+export const demoModels = [
+  { value: "claude-sonnet-4.6", label: "Claude Sonnet 4.6", hint: "默认 · 均衡" },
+  { value: "gpt-5.2", label: "GPT-5.2", hint: "OpenAI" },
+] as const;
+export const finalToolNames = ["create_agent", "publish_extension"] as const;
+
+export type DemoScenario =
+  | "empty"
+  | "hydrating"
+  | "submitted"
+  | "ask"
+  | "planning"
+  | "working"
+  | "orchestration"
+  | "temporary_agent"
+  | "agent_tools"
+  | "background_agent"
+  | "schedule"
+  | "schedule_cancel"
+  | "approval"
+  | "recovering"
+  | "interrupted"
+  | "collected"
+  | "complete"
+  | "followup"
+  | "final_artifacts"
+  | "commands"
+  | "compact"
+  | "error";
+
+export interface DemoScenarioMeta {
+  label: string;
+  description: string;
+  status: DemoStatus;
+  flowStep: number;
+}
+
+export const scenarios: Record<DemoScenario, DemoScenarioMeta> = {
+  empty: {
+    label: "空会话",
+    description: "没有历史消息时，只显示欢迎语和可用的输入框。",
+    status: "ready",
+    flowStep: -1,
+  },
+  hydrating: {
+    label: "加载历史会话",
+    description: "会话恢复期间覆盖消息区，避免旧消息或空会话短暂闪现。",
+    status: "ready",
+    flowStep: -1,
+  },
+  submitted: {
+    label: "已提交",
+    description: "用户消息已经进入会话，助手尚未产出内容，显示等待响应。",
+    status: "submitted",
+    flowStep: 0,
+  },
+  ask: {
+    label: "等待用户回答",
+    description: "Agent 在缺少关键决策时原位提问；选择并提交后继续同一任务。",
+    status: "ready",
+    flowStep: 1,
+  },
+  planning: {
+    label: "计划更新中",
+    description: "计划使用完整快照覆盖更新，只展示最新版本和当前执行步骤。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  working: {
+    label: "工具执行中",
+    description: "思考与工具按产生顺序展示；完成项沉淀结果，当前项保留运行态。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  orchestration: {
+    label: "并行与子 Agent",
+    description: "并行工具和子 Agent 在同一工作流里展示部分完成与当前运行状态。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  temporary_agent: {
+    label: "临时 Agent 调用",
+    description: "真实 run_temporary_agent 调用展示已完成与正在运行的临时 Agent。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  agent_tools: {
+    label: "Fanout / Extract",
+    description: "机制型子 Agent 以真实 fanout、extract 工具调用展示结构化执行进度。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  background_agent: {
+    label: "后台子 Agent 回注",
+    description: "后台子 Agent 先返回 runId，完成后再把结果作为通知注入当前会话。",
+    status: "ready",
+    flowStep: 3,
+  },
+  schedule: {
+    label: "定时任务已创建",
+    description: "schedule 执行成功后展示任务名称、触发规则、时区和已安排状态。",
+    status: "ready",
+    flowStep: 3,
+  },
+  schedule_cancel: {
+    label: "取消定时授权",
+    description: "不可逆的 cancel_schedule 原位等待授权，并展示允许或拒绝后的结果。",
+    status: "ready",
+    flowStep: 2,
+  },
+  approval: {
+    label: "等待工具授权",
+    description: "高风险工具停在调用位置等待允许或拒绝，不折叠也不丢上下文。",
+    status: "ready",
+    flowStep: 2,
+  },
+  recovering: {
+    label: "恢复执行",
+    description: "连接恢复时保留已有过程，并明确标记正在重新接续当前步骤。",
+    status: "streaming",
+    flowStep: 2,
+  },
+  interrupted: {
+    label: "已停止",
+    description: "用户停止后保留已经完成的工作，同时在原回合后显示停止状态。",
+    status: "ready",
+    flowStep: 2,
+  },
+  collected: {
+    label: "工具结果已收齐",
+    description: "所有工具已经返回，过程保持展开，助手开始流式组织最终回答。",
+    status: "streaming",
+    flowStep: 3,
+  },
+  complete: {
+    label: "完成并收起",
+    description:
+      "工具结果收齐并完成回答后，思考和工具统一收进 show work，最终答案独立保留。",
+    status: "ready",
+    flowStep: 5,
+  },
+  followup: {
+    label: "完成与 Follow-up",
+    description: "最终答案之后提供可忽略的后续方向；点击后直接进入下一轮用户请求。",
+    status: "ready",
+    flowStep: 6,
+  },
+  final_artifacts: {
+    label: "Agent 与扩展产物",
+    description: "create_agent 与 publish_extension 的完成结果保留在最终答案区域。",
+    status: "ready",
+    flowStep: 5,
+  },
+  commands: {
+    label: "命令消息",
+    description: "Slash command 与本地命令输出使用独立的轻量消息形态。",
+    status: "ready",
+    flowStep: 0,
+  },
+  compact: {
+    label: "上下文已压缩",
+    description: "较早的聊天内容收进 Compacted context，当前对话继续正常展示。",
+    status: "ready",
+    flowStep: 5,
+  },
+  error: {
+    label: "失败与重试",
+    description: "失败工具保留在工作过程里，错误说明与 Retry 留在消息末尾。",
+    status: "error",
+    flowStep: 2,
+  },
+};
+
+export const flowSteps = [
+  { label: "收到问题", scenario: "submitted" },
+  { label: "向人提问", scenario: "ask" },
+  { label: "计划与工具", scenario: "planning" },
+  { label: "结果收齐", scenario: "collected" },
+  { label: "收进 show work", scenario: "complete" },
+  { label: "最终答案", scenario: "complete" },
+  { label: "Follow-up", scenario: "followup" },
+] as const;
+
+function noticeMessage(scenario: DemoScenario): UIMessage {
+  return {
+    id: `camel-demo-notice-${scenario}`,
+    role: "assistant",
+    parts: [
+      {
+        type: "data-notice",
+        data: {
+          text: `验收说明：当前展示「${scenarios[scenario].label}」。${scenarios[scenario].description}`,
+        },
+      },
+    ],
+  } as unknown as UIMessage;
+}
+
+function userMessage(prompt: string): UIMessage {
+  return {
+    id: "camel-demo-user",
+    role: "user",
+    metadata: {
+      authorDisplayName: "You",
+      createdAt: demoTurnStartedAt,
+      messageSource: "Web",
+    },
+    parts: [
+      {
+        type: "file",
+        filename: "research-brief.pdf",
+        mediaType: "application/pdf",
+        url: "data:application/pdf;base64,",
+      },
+      { type: "text", text: prompt },
+    ],
+  } as UIMessage;
+}
+
+const askUserRequest = {
+  id: "camel-demo-ask-user",
+  role: "assistant",
+  parts: [
+    {
+      type: "tool-ask_user",
+      toolCallId: "camel-demo-ask-user-1",
+      state: "output-available",
+      input: {
+        question: "这份建议优先面向哪个读者？",
+        options: ["产品团队", "管理层", "设计团队"],
+        multiSelect: false,
+      },
+      output: { asked: true },
+    },
+  ],
+} as unknown as UIMessage;
+
+function humanReplyMessage(answer: string): UIMessage {
+  return {
+    id: "camel-demo-human-reply",
+    role: "user",
+    metadata: {
+      authorDisplayName: "You",
+      createdAt: demoTurnStartedAt + 2_000,
+      messageSource: "Web",
+    },
+    parts: [{ type: "text", text: answer }],
+  } as UIMessage;
+}
+
+const planningWork = {
+  id: "camel-demo-planning-work",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt + 3_000 },
+  parts: [
+    {
+      type: "tool-update_plan",
+      state: "output-available",
+      input: {
+        steps: [
+          { text: "确认读者与交付范围", status: "in_progress" },
+          { text: "检索并验证产品案例", status: "pending" },
+          { text: "整理可落地 UI 建议", status: "pending" },
+        ],
+      },
+      output: { ok: true, done: 0, total: 3 },
+    },
+    {
+      type: "tool-web_search",
+      state: "output-available",
+      input: { query: "AI Agent product interface patterns 2026", limit: 8 },
+      output: { results: 8, summary: "已完成第一轮产品案例检索" },
+    },
+    {
+      type: "tool-update_plan",
+      state: "input-available",
+      input: {
+        steps: [
+          { text: "确认读者与交付范围", status: "done" },
+          { text: "检索并验证产品案例", status: "in_progress" },
+          { text: "整理可落地 UI 建议", status: "pending" },
+        ],
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const orchestrationWork = {
+  id: "camel-demo-orchestration-work",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt + 4_000 },
+  parts: [
+    {
+      type: "data-parallel",
+      data: {
+        label: "并行验证产品案例",
+        tools: [
+          {
+            icon: "web",
+            label: "检索 Agent 产品",
+            status: "done",
+            meta: "8 sources",
+          },
+          {
+            icon: "code",
+            label: "归纳交互模式",
+            status: "running",
+          },
+          {
+            icon: "file",
+            label: "核对内部研究",
+            status: "done",
+            meta: "4 notes",
+          },
+        ],
+      },
+    },
+    {
+      type: "data-subagents",
+      data: {
+        agents: [
+          {
+            name: "Product Researcher",
+            tint: "#5577cc",
+            summary: "已交叉验证 8 个产品案例。",
+            status: "done",
+          },
+          {
+            name: "UX Analyst",
+            tint: "#8f61c7",
+            summary: "",
+            status: "running",
+          },
+        ],
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const temporaryAgentWork = {
+  id: "camel-demo-temporary-agents",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt + 4_000 },
+  parts: [
+    {
+      type: "tool-run_temporary_agent",
+      toolCallId: "camel-demo-temporary-agent-1",
+      state: "output-available",
+      input: {
+        subagentName: "Research Agent",
+        instructions: "交叉验证来源，只返回可引用的结论。",
+        task: "核对 8 个 Agent 产品案例。",
+      },
+      output: "完成 8 个来源的交叉验证。",
+    },
+    {
+      type: "tool-run_temporary_agent",
+      toolCallId: "camel-demo-temporary-agent-2",
+      state: "input-available",
+      input: {
+        subagentName: "UX Analyst",
+        instructions: "归纳可复用的交互模式。",
+        task: "分析已验证案例中的消息 UI 模式。",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const mechanismAgentWork = {
+  id: "camel-demo-mechanism-agents",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt + 4_000 },
+  parts: [
+    {
+      type: "tool-fanout",
+      toolCallId: "camel-demo-fanout-1",
+      state: "output-available",
+      input: {
+        items: ["claude.ai", "chatgpt.com", "perplexity.ai"],
+        instruction: "核对是否展示工具执行过程。",
+      },
+      output: {
+        results: [
+          { item: "claude.ai", finding: "展示折叠后的工具过程" },
+          { item: "chatgpt.com", finding: "展示工具状态与引用" },
+          { item: "perplexity.ai", finding: "展示来源检索过程" },
+        ],
+      },
+    },
+    {
+      type: "tool-extract",
+      toolCallId: "camel-demo-extract-1",
+      state: "input-available",
+      input: {
+        target: "/workspace/research/agent-ui-notes.md",
+        fields: ["pattern", "benefit", "risk"],
+        instruction: "抽取消息 UI 模式。",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const backgroundDispatch = {
+  id: "camel-demo-background-dispatch",
+  role: "assistant",
+  parts: [
+    {
+      type: "tool-dispatch_background",
+      toolCallId: "camel-demo-background-1",
+      state: "output-available",
+      input: {
+        agentType: "extract",
+        input: {
+          target: "/workspace/research/agent-ui-notes.md",
+          fields: ["pattern", "evidence"],
+        },
+      },
+      output: {
+        runId: "subagent-run-42",
+        status: "running",
+        agentType: "extract",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const backgroundResult = {
+  id: "camel-demo-background-result",
+  role: "assistant",
+  parts: [
+    {
+      type: "data-notice",
+      data: {
+        text: "后台 Extract Agent 已完成 · subagent-run-42 · 返回 6 条结构化记录。",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const scheduledTask = {
+  id: "camel-demo-schedule",
+  role: "assistant",
+  parts: [
+    {
+      type: "tool-schedule",
+      toolCallId: "camel-demo-schedule-1",
+      state: "output-available",
+      input: {
+        label: "每周发送竞品报告",
+        prompt: "生成并发送本周竞品报告。",
+        trigger: { kind: "cron", cron: "0 9 * * 1" },
+        timezone: "Asia/Shanghai",
+      },
+      output: { scheduled: true, id: "schedule-1" },
+    },
+  ],
+} as unknown as UIMessage;
+
+function scheduleCancellation(approved: boolean | undefined): UIMessage {
+  const settled = approved !== undefined;
+  return {
+    id: "camel-demo-schedule-cancel",
+    role: "assistant",
+    parts: [
+      {
+        type: "tool-cancel_schedule",
+        toolCallId: "camel-demo-schedule-cancel-1",
+        state: settled
+          ? approved
+            ? "output-available"
+            : "output-denied"
+          : "approval-requested",
+        input: { id: "schedule-1" },
+        ...(settled
+          ? {
+              output: approved
+                ? { cancelled: true, id: "schedule-1" }
+                : { cancelled: false, id: "schedule-1" },
+            }
+          : {}),
+      },
+      ...(settled
+        ? [
+            {
+              type: "text",
+              text: approved
+                ? "已取消「每周发送竞品报告」。"
+                : "已保留「每周发送竞品报告」。",
+            },
+          ]
+        : []),
+    ],
+  } as unknown as UIMessage;
+}
+
+const finalArtifacts = {
+  id: "camel-demo-final-artifacts",
+  role: "assistant",
+  metadata: { completedAt: demoCompletedAt },
+  parts: [
+    {
+      type: "tool-create_agent",
+      toolCallId: "camel-demo-create-agent-1",
+      state: "output-available",
+      input: {
+        name: "Competitive Researcher",
+        description: "每周生成竞品变化报告。",
+      },
+      output: { id: "competitive-researcher", ready: true },
+    },
+    {
+      type: "tool-publish_extension",
+      toolCallId: "camel-demo-publish-extension-1",
+      state: "output-available",
+      input: {
+        name: "competitor-diff",
+        version: "1.0.0",
+        description: "比较两期竞品数据。",
+      },
+      output: {
+        resourceId: "extension-competitor-diff",
+        name: "competitor-diff",
+        version: "1.0.0",
+        changed: true,
+        tools: ["competitor_diff"],
+        note: "下一条消息起可用。",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const commandMessages = [
+  {
+    id: "camel-demo-slash-command",
+    role: "user",
+    parts: [
+      {
+        type: "data-slash-command",
+        data: { command: "/compact" },
+      },
+    ],
+  },
+  {
+    id: "camel-demo-local-output",
+    role: "user",
+    parts: [
+      {
+        type: "data-local-command-output",
+        data: { output: "Compacted 24,318 tokens." },
+      },
+    ],
+  },
+] as unknown as UIMessage[];
+
+const runningWork = {
+  id: "camel-demo-running-work",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt },
+  parts: [
+    {
+      type: "reasoning",
+      state: "streaming",
+      text: "先确认调研范围，再检索产品案例并读取已有研究记录。",
+    },
+    {
+      type: "tool-web_search",
+      state: "output-available",
+      input: { query: "AI Agent product interface patterns 2026", limit: 8 },
+      output: { results: 8, summary: "已完成第一轮产品案例检索" },
+    },
+    {
+      type: "tool-read_file",
+      state: "input-available",
+      input: {
+        path: "/workspace/research/agent-ui-notes.md",
+        project: "agent-landscape",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const completedResearch = {
+  id: "camel-demo-completed-research",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt },
+  parts: [
+    {
+      type: "reasoning",
+      state: "done",
+      text: "先确认调研范围，再检索产品案例并读取已有研究记录。",
+    },
+    {
+      type: "tool-web_search",
+      state: "output-available",
+      input: { query: "AI Agent product interface patterns 2026", limit: 8 },
+      output: { results: 8, summary: "已完成产品案例检索与交叉验证" },
+    },
+    {
+      type: "tool-read_file",
+      state: "output-available",
+      input: {
+        path: "/workspace/research/agent-ui-notes.md",
+        project: "agent-landscape",
+      },
+      output: [
+        "# Agent UI notes",
+        "",
+        "1. Long-running work needs visible progress.",
+        "2. Tool details should stay close to their call site.",
+        "3. Completed work should collapse without hiding the answer.",
+        "4. Approvals need an explicit pause and decision.",
+      ].join("\n"),
+    },
+  ],
+} as unknown as UIMessage;
+
+const completedSynthesis = {
+  id: "camel-demo-completed-synthesis",
+  role: "assistant",
+  parts: [
+    {
+      type: "tool-update_plan",
+      state: "output-available",
+      input: {
+        steps: [
+          { text: "确认调研范围", status: "done" },
+          { text: "检索与验证来源", status: "done" },
+          { text: "整理 UI 建议", status: "done" },
+        ],
+      },
+      output: { ok: true, done: 3, total: 3 },
+    },
+    {
+      type: "tool-write_file",
+      state: "output-available",
+      input: {
+        path: "reports/agent-ui-recommendations.md",
+        overwrite: false,
+      },
+      output: {
+        path: "reports/agent-ui-recommendations.md",
+        bytes: 4_218,
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const approvalRequest = {
+  id: "camel-demo-approval-request",
+  role: "assistant",
+  parts: [
+    {
+      type: "tool-write_file",
+      state: "approval-requested",
+      input: {
+        path: "reports/agent-ui-recommendations.md",
+        overwrite: false,
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const collectedAnswer = {
+  id: "camel-demo-collected-answer",
+  role: "assistant",
+  parts: [
+    {
+      type: "text",
+      text: [
+        "## 正在整理结论",
+        "",
+        "3 组工具结果已经收齐，正在把产品案例、研究记录和执行计划合并为最终建议…",
+      ].join("\n"),
+    },
+  ],
+} as unknown as UIMessage;
+
+const finalAnswer = {
+  id: "camel-demo-final-answer",
+  role: "assistant",
+  metadata: {
+    createdAt: demoCompletedAt,
+    completedAt: demoCompletedAt,
+    turnDurationMs: 18_000,
+  },
+  parts: [
+    {
+      type: "text",
+      text: [
+        "## AI Agent 消息 UI 建议",
+        "",
+        "调研结论是：真实聊天需要同时照顾**当前进展**和**完成后的可读性**。",
+        "",
+        "- 执行中原位展示思考、工具状态和授权节点，让用户知道系统正在做什么。",
+        "- 工具结果收齐后继续保持展开，直到最终回答稳定。",
+        "- 回合完成后把过程统一收进 `show work`，不让工具日志打断答案。",
+        "- 错误与 Retry 留在失败位置，避免丢失已完成步骤。",
+        "",
+        "| 验收项 | 完成态展示 |",
+        "| --- | --- |",
+        "| 工具过程 | 收进 show work |",
+        "| 最终回答 | 始终可读 |",
+        "| 高风险操作 | 原位等待授权 |",
+      ].join("\n"),
+    },
+  ],
+} as unknown as UIMessage;
+
+const completeTurn = {
+  ...finalAnswer,
+  id: "camel-demo-complete-turn",
+  parts: [
+    { type: "step-start" },
+    completedResearch.parts[0],
+    completedResearch.parts[1],
+    { type: "step-start" },
+    completedResearch.parts[2],
+    { type: "step-start" },
+    ...completedSynthesis.parts,
+    { type: "step-start" },
+    ...finalAnswer.parts,
+  ],
+} as unknown as UIMessage;
+
+const followupAnswer = {
+  ...finalAnswer,
+  id: "camel-demo-followup-answer",
+  parts: [
+    ...finalAnswer.parts,
+    {
+      type: "tool-suggest_followups",
+      toolCallId: "camel-demo-followups-1",
+      state: "output-available",
+      input: {
+        items: [
+          "把建议整理成实施优先级",
+          "补充移动端消息交互",
+          "生成一份设计验收清单",
+        ],
+      },
+      output: { noted: true, count: 3 },
+    },
+  ],
+} as unknown as UIMessage;
+
+const interruptedByUser = {
+  id: "camel-demo-interrupted",
+  role: "assistant",
+  metadata: {
+    createdAt: demoCompletedAt,
+    completedAt: demoCompletedAt + 2_000,
+    turnDurationMs: 2_000,
+    turnStatus: "aborted",
+    interruptedByUser: true,
+  },
+  parts: [],
+} as unknown as UIMessage;
+
+const compactSummary = {
+  id: "camel-demo-compact-summary",
+  role: "user",
+  metadata: { createdAt: demoTurnStartedAt - 60_000 },
+  parts: [
+    {
+      type: "data-compact-summary",
+      data: {
+        text: [
+          "此前已确认：目标是梳理 AI Agent 消息交互，并以管理层可快速理解的方式交付。",
+          "已经收集了竞品案例、工具执行记录和风险授权要求。",
+        ].join("\n\n"),
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+const failedWork = {
+  id: "camel-demo-failed-work",
+  role: "assistant",
+  metadata: { turnStartedAt: demoTurnStartedAt },
+  parts: [
+    ...completedResearch.parts,
+    {
+      type: "tool-exec_command",
+      state: "output-error",
+      input: {
+        command: "pnpm analyze agent-products.csv",
+        description: "product comparison",
+      },
+      output: {
+        exit_code: 1,
+        stdout: "Loaded 24 product records",
+        stderr: "数据源连接中断",
+      },
+    },
+    {
+      type: "data-error",
+      data: {
+        title: "调研暂时中断",
+        body: "已完成的检索结果仍然保留；重试后将从产品对比步骤继续。",
+      },
+    },
+  ],
+} as unknown as UIMessage;
+
+export function messagesForScenario(
+  scenario: DemoScenario,
+  prompt: string,
+  humanAnswer: string,
+  approval: boolean | undefined,
+): UIMessage[] {
+  if (scenario === "empty") return [];
+  if (scenario === "commands") {
+    return [noticeMessage(scenario), ...commandMessages];
+  }
+  const conversation = [noticeMessage(scenario), userMessage(prompt)];
+  const answer = humanAnswer || "管理层";
+  const decidedConversation = [
+    ...conversation,
+    askUserRequest,
+    humanReplyMessage(answer),
+  ];
+  if (scenario === "hydrating") return conversation;
+  if (scenario === "submitted") return conversation;
+  if (scenario === "ask") return [...conversation, askUserRequest];
+  if (scenario === "planning") {
+    return [...decidedConversation, planningWork];
+  }
+  if (scenario === "working") return [...conversation, runningWork];
+  if (scenario === "orchestration") {
+    return [...decidedConversation, planningWork, orchestrationWork];
+  }
+  if (scenario === "temporary_agent") {
+    return [...conversation, temporaryAgentWork];
+  }
+  if (scenario === "agent_tools") {
+    return [...conversation, mechanismAgentWork];
+  }
+  if (scenario === "background_agent") {
+    return [...conversation, backgroundDispatch, backgroundResult];
+  }
+  if (scenario === "schedule") {
+    return [...conversation, scheduledTask];
+  }
+  if (scenario === "schedule_cancel") {
+    return [...conversation, scheduleCancellation(approval)];
+  }
+  if (scenario === "approval") {
+    return [...conversation, completedResearch, approvalRequest];
+  }
+  if (scenario === "recovering") {
+    return [...conversation, completedResearch, runningWork];
+  }
+  if (scenario === "interrupted") {
+    return [...conversation, completedResearch, interruptedByUser];
+  }
+  if (scenario === "collected") {
+    return [
+      ...conversation,
+      completedResearch,
+      completedSynthesis,
+      collectedAnswer,
+    ];
+  }
+  if (scenario === "compact") {
+    return [noticeMessage(scenario), compactSummary, userMessage(prompt), finalAnswer];
+  }
+  if (scenario === "error") return [...conversation, failedWork];
+  if (scenario === "followup") {
+    return [
+      ...conversation,
+      completedResearch,
+      completedSynthesis,
+      followupAnswer,
+    ];
+  }
+  if (scenario === "final_artifacts") {
+    return [...conversation, finalArtifacts];
+  }
+  return [
+    ...conversation,
+    completeTurn,
+  ];
+}
+
+export const commands = [
+  {
+    name: "plan",
+    description: "先制定执行计划",
+    prompt: "请先制定计划：\n",
+    icon: "plan",
+  },
+  {
+    name: "research",
+    description: "开始深入调研",
+    prompt: "请深入调研：\n",
+    icon: "research",
+  },
+  {
+    name: "summarize",
+    description: "总结当前结果",
+    prompt: "请总结当前结果：\n",
+    icon: "file",
+  },
+] satisfies ComposerCommandLike[];