shadowzzh

PartialMessageTimeline.tsx

PartialMessageTimeline.tsx
// src/components/islands/PartialMessageTimeline.tsx
// S3 — partial message replacement visualizer.
// Shows how streaming deltas (text_delta, toolcall_delta) progressively
// mutate context.messages[-1] in place until message_stop finalizes it.
import { useState, useEffect } from 'react';
import EventTimeline, { type TimelineEvent } from './shared/EventTimeline';
import PlayControls from './shared/PlayControls';
import MessageCard from './shared/MessageCard';

export interface Tick {
  event: TimelineEvent;
  partialMessage: object;
}

const TICKS: Tick[] = [
  {
    event: { id: 'start', label: 'message_start', type: 'message' },
    partialMessage: { role: 'assistant', content: '', partial: true },
  },
  {
    event: { id: 'text-1', label: 'text_delta ×3', type: 'tool' },
    partialMessage: { role: 'assistant', content: '好的,我先', partial: true },
  },
  {
    event: { id: 'tool-delta', label: 'toolcall_delta', type: 'tool' },
    partialMessage: {
      role: 'assistant',
      content: '好的,我先读文件',
      toolCalls: [{ name: 'read_file', args: { path: 'agent-loop.ts' }, partial: true }],
      partial: true,
    },
  },
  {
    event: { id: 'done', label: 'message_stop', type: 'milestone' },
    partialMessage: {
      role: 'assistant',
      content: '好的,我先读文件',
      toolCalls: [{ name: 'read_file', args: { path: 'agent-loop.ts' } }],
      stopReason: 'tool_use',
    },
  },
];

export default function PartialMessageTimeline() {
  const [idx, setIdx] = useState(0);
  const [playing, setPlaying] = useState(false);

  useEffect(() => {
    if (!playing) return;
    const t = setTimeout(() => {
      setIdx((i) => {
        if (i >= TICKS.length - 1) {
          setPlaying(false);
          return i;
        }
        return i + 1;
      });
    }, 1500);
    return () => clearTimeout(t);
  }, [playing, idx]);

  return (
    <div className="loop-simulator" role="region" aria-label="partial message 替换演示">
      <h3 className="sim-title">🎬 partial message 原地替换</h3>
      <p className="sim-description">
        拖动游标或点击播放,观察 <code>context.messages[-1]</code> 如何被流式事件逐步填充。
      </p>
      <EventTimeline
        events={TICKS.map((t) => t.event)}
        currentIdx={idx}
        onSelect={setIdx}
      />
      <PlayControls
        isPlaying={playing}
        onPlay={() => setPlaying((p) => !p)}
        onStep={() => setIdx((i) => Math.min(TICKS.length - 1, i + 1))}
        onReset={() => {
          setPlaying(false);
          setIdx(0);
        }}
      />
      <div className="sim-messages" style={{ marginTop: 'var(--space-4)' }}>
        <MessageCard title="context.messages[-1]" data={TICKS[idx].partialMessage} />
      </div>
    </div>
  );
}