agent-stream-ui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +220 -2
  3. package/dist/adapters/openai.d.ts +42 -0
  4. package/dist/adapters/openai.d.ts.map +1 -0
  5. package/dist/agent-stream-ui.css +2 -0
  6. package/dist/agent-stream-ui.js +1418 -0
  7. package/dist/agent-stream-ui.js.map +1 -0
  8. package/dist/core/reducer.d.ts +33 -0
  9. package/dist/core/reducer.d.ts.map +1 -0
  10. package/dist/core/scheduler.d.ts +15 -0
  11. package/dist/core/scheduler.d.ts.map +1 -0
  12. package/dist/core/store.d.ts +29 -0
  13. package/dist/core/store.d.ts.map +1 -0
  14. package/dist/core/transport.d.ts +57 -0
  15. package/dist/core/transport.d.ts.map +1 -0
  16. package/dist/index.d.ts +38 -0
  17. package/dist/index.d.ts.map +1 -0
  18. package/dist/markdown/blocks.d.ts +31 -0
  19. package/dist/markdown/blocks.d.ts.map +1 -0
  20. package/dist/markdown/inline.d.ts +13 -0
  21. package/dist/markdown/inline.d.ts.map +1 -0
  22. package/dist/markdown/render.d.ts +18 -0
  23. package/dist/markdown/render.d.ts.map +1 -0
  24. package/dist/react/agent-chat.d.ts +14 -0
  25. package/dist/react/agent-chat.d.ts.map +1 -0
  26. package/dist/react/composer.d.ts +11 -0
  27. package/dist/react/composer.d.ts.map +1 -0
  28. package/dist/react/icons.d.ts +12 -0
  29. package/dist/react/icons.d.ts.map +1 -0
  30. package/dist/react/markdown-stream.d.ts +14 -0
  31. package/dist/react/markdown-stream.d.ts.map +1 -0
  32. package/dist/react/message-body.d.ts +14 -0
  33. package/dist/react/message-body.d.ts.map +1 -0
  34. package/dist/react/message-list.d.ts +8 -0
  35. package/dist/react/message-list.d.ts.map +1 -0
  36. package/dist/react/tool-call-card.d.ts +13 -0
  37. package/dist/react/tool-call-card.d.ts.map +1 -0
  38. package/dist/react/use-agent-stream.d.ts +11 -0
  39. package/dist/react/use-agent-stream.d.ts.map +1 -0
  40. package/dist/react/use-stick-to-bottom.d.ts +14 -0
  41. package/dist/react/use-stick-to-bottom.d.ts.map +1 -0
  42. package/dist/sse/client.d.ts +60 -0
  43. package/dist/sse/client.d.ts.map +1 -0
  44. package/dist/sse/frame.d.ts +42 -0
  45. package/dist/sse/frame.d.ts.map +1 -0
  46. package/dist/types.d.ts +119 -0
  47. package/dist/types.d.ts.map +1 -0
  48. package/docs/design-notes.md +145 -0
  49. package/package.json +84 -4
  50. package/src/lib/adapters/openai.ts +112 -0
  51. package/src/lib/core/reducer.ts +417 -0
  52. package/src/lib/core/scheduler.ts +40 -0
  53. package/src/lib/core/store.ts +214 -0
  54. package/src/lib/core/transport.ts +197 -0
  55. package/src/lib/index.ts +102 -0
  56. package/src/lib/markdown/blocks.ts +201 -0
  57. package/src/lib/markdown/inline.tsx +87 -0
  58. package/src/lib/markdown/render.tsx +149 -0
  59. package/src/lib/react/agent-chat.tsx +121 -0
  60. package/src/lib/react/composer.tsx +105 -0
  61. package/src/lib/react/icons.tsx +83 -0
  62. package/src/lib/react/markdown-stream.tsx +37 -0
  63. package/src/lib/react/message-body.tsx +66 -0
  64. package/src/lib/react/message-list.tsx +109 -0
  65. package/src/lib/react/tool-call-card.tsx +117 -0
  66. package/src/lib/react/use-agent-stream.ts +14 -0
  67. package/src/lib/react/use-stick-to-bottom.ts +60 -0
  68. package/src/lib/sse/client.ts +263 -0
  69. package/src/lib/sse/frame.ts +116 -0
  70. package/src/lib/styles.css +790 -0
  71. package/src/lib/types.ts +130 -0
@@ -0,0 +1,11 @@
1
+ export interface ComposerProps {
2
+ running: boolean;
3
+ canRetry: boolean;
4
+ placeholder?: string;
5
+ disabled?: boolean;
6
+ onSend: (text: string) => void;
7
+ onStop: () => void;
8
+ onRetry: () => void;
9
+ }
10
+ export declare function Composer({ running, canRetry, placeholder, disabled, onSend, onStop, onRetry, }: ComposerProps): import("react").JSX.Element;
11
+ //# sourceMappingURL=composer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/lib/react/composer.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAID,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,QAAQ,EACR,WAAoB,EACpB,QAAgB,EAChB,MAAM,EACN,MAAM,EACN,OAAO,GACR,EAAE,aAAa,+BAiFf"}
@@ -0,0 +1,12 @@
1
+ import type { SVGProps } from 'react';
2
+ type IconProps = SVGProps<SVGSVGElement>;
3
+ export declare function SendIcon(props: IconProps): import("react").JSX.Element;
4
+ export declare function StopIcon(props: IconProps): import("react").JSX.Element;
5
+ export declare function RetryIcon(props: IconProps): import("react").JSX.Element;
6
+ export declare function ToolIcon(props: IconProps): import("react").JSX.Element;
7
+ export declare function CheckIcon(props: IconProps): import("react").JSX.Element;
8
+ export declare function AlertIcon(props: IconProps): import("react").JSX.Element;
9
+ export declare function ArrowDownIcon(props: IconProps): import("react").JSX.Element;
10
+ export declare function SparkIcon(props: IconProps): import("react").JSX.Element;
11
+ export {};
12
+ //# sourceMappingURL=icons.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/lib/react/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,KAAK,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;AAcxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,+BAMxC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,+BAMxC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,+BAOzC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,+BAMxC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,+BAMzC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,+BAQzC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,+BAO7C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,+BAMzC"}
@@ -0,0 +1,14 @@
1
+ export interface MarkdownStreamProps {
2
+ text: string;
3
+ /** 是否还在流式追加:只有尾块会重新解析,并显示光标。 */
4
+ streaming?: boolean;
5
+ className?: string;
6
+ }
7
+ /**
8
+ * 流式 Markdown。
9
+ *
10
+ * 成本模型:每次文本变化 O(n) 切块(纯字符串扫描,无正则回溯),
11
+ * 解析成本只落在未闭合的尾块上;已闭合块命中缓存后只做一次元素复用。
12
+ */
13
+ export declare const MarkdownStream: import("react").MemoExoticComponent<({ text, streaming, className, }: MarkdownStreamProps) => import("react").JSX.Element>;
14
+ //# sourceMappingURL=markdown-stream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdown-stream.d.ts","sourceRoot":"","sources":["../../src/lib/react/markdown-stream.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,wEAIxB,mBAAmB,iCAepB,CAAA"}
@@ -0,0 +1,14 @@
1
+ import type { Message, MessagePart, ToolCallState } from '../types';
2
+ export interface MessageBodyProps {
3
+ parts: MessagePart[];
4
+ toolCalls: ToolCallState[];
5
+ streaming: boolean;
6
+ role: Message['role'];
7
+ }
8
+ /** 按到达顺序渲染「文本 / 工具卡」,而不是把工具卡统一堆到末尾。 */
9
+ export declare function MessageBody({ parts, toolCalls, streaming, role }: MessageBodyProps): import("react").JSX.Element;
10
+ export declare function ErrorNote({ message, stage }: {
11
+ message: string;
12
+ stage: string;
13
+ }): import("react").JSX.Element;
14
+ //# sourceMappingURL=message-body.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"message-body.d.ts","sourceRoot":"","sources":["../../src/lib/react/message-body.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAKnE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CACtB;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,gBAAgB,+BAyBlF;AAcD,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,+BAa/E"}
@@ -0,0 +1,8 @@
1
+ import type { ConversationSnapshot } from '../types';
2
+ export interface MessageListProps {
3
+ snapshot: ConversationSnapshot;
4
+ onRetry?: () => void;
5
+ emptyState?: React.ReactNode;
6
+ }
7
+ export declare function MessageList({ snapshot, onRetry, emptyState }: MessageListProps): import("react").JSX.Element;
8
+ //# sourceMappingURL=message-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"message-list.d.ts","sourceRoot":"","sources":["../../src/lib/react/message-list.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAKpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,gBAAgB,+BAgG9E"}
@@ -0,0 +1,13 @@
1
+ import type { ToolCallState } from '../types';
2
+ export interface ToolCallCardProps {
3
+ tool: ToolCallState;
4
+ }
5
+ /**
6
+ * 工具调用卡。
7
+ *
8
+ * 三态:入参还在流式生成(可能是不完整 JSON)、成功、失败。
9
+ * 入参不完整时**不做激进补全**——把原文摆出来,比给用户看一个猜出来的
10
+ * 半截参数诚实得多。
11
+ */
12
+ export declare function ToolCallCard({ tool }: ToolCallCardProps): import("react").JSX.Element;
13
+ //# sourceMappingURL=tool-call-card.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-call-card.d.ts","sourceRoot":"","sources":["../../src/lib/react/tool-call-card.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAI7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAA;CACpB;AA+BD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB,+BAuEvD"}
@@ -0,0 +1,11 @@
1
+ import type { AgentStreamStore } from '../core/store';
2
+ import type { ConversationSnapshot } from '../types';
3
+ /**
4
+ * 订阅会话快照。
5
+ *
6
+ * `useSyncExternalStore` 在这里不是炫技:它保证并发渲染下不会读到撕裂的状态
7
+ * (tearing)——流式更新是典型的高频外部源,用 useState + useEffect 很容易
8
+ * 读到半新半旧的快照。
9
+ */
10
+ export declare function useAgentStream(store: AgentStreamStore): ConversationSnapshot;
11
+ //# sourceMappingURL=use-agent-stream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-agent-stream.d.ts","sourceRoot":"","sources":["../../src/lib/react/use-agent-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAEpD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,oBAAoB,CAE5E"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 贴底滚动。
3
+ *
4
+ * 规则:只有用户本来就在底部时才自动滚;一旦上滑就"锁住",新内容只提示不打扰。
5
+ * 这是 AI 对话界面里最容易做错、也最影响体感的一个细节。
6
+ *
7
+ * @param signal 内容变化信号(一般是消息长度),变化后若处于贴底状态则滚到底。
8
+ */
9
+ export declare function useStickToBottom<T extends HTMLElement>(signal: unknown): {
10
+ ref: import("react").RefObject<T | null>;
11
+ pinned: boolean;
12
+ scrollToBottom: () => void;
13
+ };
14
+ //# sourceMappingURL=use-stick-to-bottom.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-stick-to-bottom.d.ts","sourceRoot":"","sources":["../../src/lib/react/use-stick-to-bottom.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,OAAO;;;;EA+CtE"}
@@ -0,0 +1,60 @@
1
+ /**
2
+ * SSE 客户端:`POST + text/event-stream`,带退避重连、`Last-Event-ID` 续传与游标去重。
3
+ *
4
+ * 三条不写在明面上的约定,都是踩过坑才有的:
5
+ * 1. **只对"可能自愈"的失败重连**:5xx / 408 / 429 / 网络中断。4xx(会话不存在、
6
+ * 未登录、已裁决)重连只会空转,直接停在 error。
7
+ * 2. **重连必须带游标**:服务端按 `Last-Event-ID` 从之后重放,客户端再按 id 去重,
8
+ * 这样"断在半个 token 中间"也能接到正确位置。
9
+ * 3. **停止是本地语义**:abort 之后不再重连,也不抛错——用户主动停的不是失败。
10
+ */
11
+ import type { SseStatus, SseStatusInfo } from '../types';
12
+ import type { SseFrame } from './frame';
13
+ export declare const DEFAULT_BACKOFF_BASE_MS = 500;
14
+ export declare const DEFAULT_BACKOFF_FACTOR = 2;
15
+ export declare const DEFAULT_BACKOFF_MAX_MS = 7000;
16
+ export declare const DEFAULT_MAX_ATTEMPTS = 8;
17
+ export interface SseClientOptions {
18
+ url: string;
19
+ method?: 'POST' | 'GET';
20
+ headers?: Record<string, string>;
21
+ body?: unknown;
22
+ /** 断点续传游标;null 表示从头开始。 */
23
+ lastEventId?: string | null;
24
+ backoffBaseMs?: number;
25
+ backoffFactor?: number;
26
+ backoffMaxMs?: number;
27
+ /** 连续失败上限,超过就停在 error,避免无限重连。 */
28
+ maxAttempts?: number;
29
+ /**
30
+ * 空闲超时:超过这么久没收到任何帧就主动断开重连。
31
+ *
32
+ * 半开连接(NAT 超时、LB 静默丢包、代理挂住上游)在 TCP 层看起来是"还活着",
33
+ * 读操作永远不会返回。没有这个看门狗,界面会永远停在"生成中"。
34
+ * 默认关闭(0):不同业务的首帧延迟差异太大,交给使用方决定。
35
+ */
36
+ idleTimeoutMs?: number;
37
+ /** 覆盖默认的可重试判定。 */
38
+ isRetriable?: (ctx: RetryContext) => boolean;
39
+ /** 注入 fetch(测试/非浏览器环境用)。 */
40
+ fetch?: typeof fetch;
41
+ onStatus?: (status: SseStatus, info?: SseStatusInfo) => void;
42
+ onEvent: (frame: SseFrame) => void;
43
+ /** 上一次处理过的游标,用于跨重连去重。 */
44
+ getCursor?: () => string | null;
45
+ }
46
+ export interface RetryContext {
47
+ /** HTTP 状态码;网络错误时为 0。 */
48
+ status: number;
49
+ attempt: number;
50
+ }
51
+ export interface SseClient {
52
+ /** 主动停止:abort 在途请求并禁止后续重连。 */
53
+ close: () => void;
54
+ /** 当前状态快照(同步读,不触发回调)。 */
55
+ readonly status: SseStatus;
56
+ }
57
+ export declare function shouldRetryStatus(status: number): boolean;
58
+ export declare function computeBackoff(attempt: number, base?: number, factor?: number, max?: number): number;
59
+ export declare function createSseClient(options: SseClientOptions): SseClient;
60
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/sse/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,eAAO,MAAM,sBAAsB,IAAI,CAAA;AACvC,eAAO,MAAM,sBAAsB,OAAQ,CAAA;AAC3C,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kBAAkB;IAClB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAA;IAC5C,4BAA4B;IAC5B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;IAC5D,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAClC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAC3B;AA0CD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,SAA0B,EAC9B,MAAM,SAAyB,EAC/B,GAAG,SAAyB,GAC3B,MAAM,CAER;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAgJpE"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * SSE 分帧:纯函数,不碰 fetch、不碰 DOM。
3
+ *
4
+ * 为什么自己写:EventSource 不支持 POST、不能带自定义 header、断线重连策略
5
+ * 由浏览器决定(你没法控制退避、也没法只对 5xx 重试)。真正的 Agent 流式
6
+ * 接口几乎都是 `POST + text/event-stream`。
7
+ */
8
+ export interface SseFrame {
9
+ /** 事件游标(服务端 outbox 自增 id),用于断点续传与去重。 */
10
+ id: string | null;
11
+ event: string;
12
+ data: string;
13
+ /** 服务端建议的重连间隔;本实现不采纳,退避策略由客户端掌握。 */
14
+ retry: number | null;
15
+ }
16
+ /**
17
+ * 解析单帧(不含结尾空行)。
18
+ *
19
+ * 规范细节:一行可以是 `field`(无冒号)、`field:`(空值)、`field:value`,
20
+ * 值前的一个空格必须去掉;`:` 开头是注释(心跳),整帧没有 data 时不产生事件。
21
+ */
22
+ export declare function parseSseFrame(raw: string): SseFrame | null;
23
+ /**
24
+ * 从缓冲区里切出所有完整帧,返回剩余未闭合文本。
25
+ * 调用方负责把 `rest` 与下一次读到的 chunk 拼起来再解析。
26
+ */
27
+ export declare function parseSseChunk(buffer: string): {
28
+ frames: SseFrame[];
29
+ rest: string;
30
+ };
31
+ /** 序列化一帧(mock server 与测试用,保证和服务端输出同形)。 */
32
+ export declare function formatSseFrame(frame: {
33
+ id?: string | number | null;
34
+ event?: string;
35
+ data: string;
36
+ }): string;
37
+ /**
38
+ * 游标比较。服务端 id 是单调递增的整数游标,但协议本身不保证——
39
+ * 非数字 id 退化为"只要不相等就认为新"。
40
+ */
41
+ export declare function isNewerEventId(next: string, current: string | null): boolean;
42
+ //# sourceMappingURL=frame.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/lib/sse/frame.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAyC1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBlF;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,MAAM,CAMT;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAQ5E"}
@@ -0,0 +1,119 @@
1
+ /**
2
+ * 领域类型:事件协议 + 会话状态。
3
+ *
4
+ * 设计约束:事件是**线上协议**,状态是**渲染输入**。两者刻意分开——
5
+ * 服务端换实现只要仍发这套事件,前端不用改;前端换渲染只要仍读这套状态,
6
+ * 传输层也不用改。
7
+ */
8
+ export type ErrorStage = 'retrieve' | 'analyze' | 'generate' | 'unknown';
9
+ export interface AgentEventPayloads {
10
+ 'turn.start': {
11
+ turnId: string;
12
+ };
13
+ 'message.delta': {
14
+ text: string;
15
+ };
16
+ 'message.done': {
17
+ messageId?: string;
18
+ };
19
+ 'tool.call': {
20
+ callId: string;
21
+ name: string;
22
+ arguments?: string;
23
+ };
24
+ /** 工具参数增量:OpenAI/Anthropic 都是边生成边下发,界面可以边显示边解析。 */
25
+ 'tool.args': {
26
+ callId: string;
27
+ arguments: string;
28
+ complete?: boolean;
29
+ };
30
+ 'tool.result': {
31
+ callId: string;
32
+ ok: boolean;
33
+ preview?: string;
34
+ durationMs?: number;
35
+ };
36
+ 'turn.end': {
37
+ reason: 'complete' | 'stopped' | 'error';
38
+ };
39
+ error: {
40
+ message: string;
41
+ stage?: ErrorStage;
42
+ retriable?: boolean;
43
+ };
44
+ ping: {
45
+ at?: number;
46
+ };
47
+ }
48
+ export type AgentEventType = keyof AgentEventPayloads;
49
+ /** 判别联合:`switch (event.type)` 之后 payload 自动收窄。 */
50
+ export type AgentEvent = {
51
+ [K in AgentEventType]: {
52
+ type: K;
53
+ } & AgentEventPayloads[K];
54
+ }[AgentEventType];
55
+ export declare const AGENT_EVENT_TYPES: readonly AgentEventType[];
56
+ export type ToolStatus = 'running' | 'ok' | 'error';
57
+ export interface ToolCallState {
58
+ callId: string;
59
+ name: string;
60
+ /** 原始入参文本。流式到达时可能是不完整的 JSON,UI 必须容忍。 */
61
+ args: string;
62
+ /** 入参是否已完整(收到 tool.result,或被后续事件判定结束)。 */
63
+ argsComplete: boolean;
64
+ status: ToolStatus;
65
+ preview?: string;
66
+ durationMs?: number;
67
+ startedAt: number;
68
+ }
69
+ /**
70
+ * 消息内容按到达顺序切片:文本和工具卡交错,而不是"先正文后工具"。
71
+ * 这一点在真实 Agent 里很关键——模型可能"说一句 → 调工具 → 接着说"。
72
+ */
73
+ export type MessagePart = {
74
+ kind: 'text';
75
+ text: string;
76
+ } | {
77
+ kind: 'tool';
78
+ callId: string;
79
+ };
80
+ export type TurnStatus = 'running' | 'done' | 'error' | 'stopped';
81
+ export interface AgentError {
82
+ message: string;
83
+ stage: ErrorStage;
84
+ retriable: boolean;
85
+ }
86
+ export interface LiveTurn {
87
+ turnId: string | null;
88
+ status: TurnStatus;
89
+ parts: MessagePart[];
90
+ toolCalls: ToolCallState[];
91
+ error: AgentError | null;
92
+ /** 传输层掉线、正在重连时为 true(区别于模型报错)。 */
93
+ interrupted: boolean;
94
+ startedAt: number;
95
+ endedAt: number | null;
96
+ }
97
+ export interface Message {
98
+ id: string;
99
+ role: 'user' | 'assistant';
100
+ parts: MessagePart[];
101
+ toolCalls: ToolCallState[];
102
+ status: Exclude<TurnStatus, 'running'>;
103
+ createdAt: number;
104
+ /** 失败回合的落库错误,供已提交消息继续展示重试入口。 */
105
+ error?: AgentError;
106
+ }
107
+ export type SseStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed' | 'stopped' | 'error';
108
+ export interface SseStatusInfo {
109
+ attempt: number;
110
+ delayMs: number;
111
+ reason?: string;
112
+ }
113
+ export interface ConversationSnapshot {
114
+ messages: Message[];
115
+ live: LiveTurn | null;
116
+ status: SseStatus;
117
+ reconnect: SseStatusInfo | null;
118
+ }
119
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,145 @@
1
+ # 设计笔记
2
+
3
+ 这份文档记录**为什么这么写**,而不是写了什么。代码会过期,判断不会。
4
+
5
+ ---
6
+
7
+ ## 1. 为什么自己写 SSE 客户端
8
+
9
+ `EventSource` 看起来刚好够用,但有三个硬伤:
10
+
11
+ 1. **只能 GET**。Agent 的输入是一段结构化上下文(历史、工具结果、模型选择),放 query string 既超长又会被日志记下来;
12
+ 2. **不能带自定义 header**。鉴权、租户、追踪 ID 都要塞进 cookie 或 URL;
13
+ 3. **重连策略是黑盒**。浏览器自己决定退避和重试次数,你既不能只对 5xx 重试,也不能在 401 时立刻停下。
14
+
15
+ 所以传输层就是 `fetch` + `ReadableStream` + 一个纯函数分帧器。代价是两百行代码和一堆边界(CRLF、多行 `data:`、注释心跳、半个帧跨 chunk),收益是**所有策略都在自己手里**。
16
+
17
+ ---
18
+
19
+ ## 2. 为什么 POST 里要带 `clientTurnId`
20
+
21
+ 断点续传需要服务端知道"这次请求是哪一轮的续传"。
22
+
23
+ `Last-Event-ID` 只能表达"从哪个游标之后继续",表达不了"继续哪条流"。真实网关在断连后重放请求时,如果没有业务侧的 turn 标识,服务端会当成一次全新的对话。
24
+
25
+ 做法:传输层每次 `open()` 生成一个 `clientTurnId`,**同一次 open 内的所有重试复用同一个值**(因为 `SseClient` 的 body 在创建时就固定了)。服务端用它做会话键,`Last-Event-ID` 做游标,两者正交。
26
+
27
+ 副作用:服务端要有会话回收(示例里在流结束后 `sessions.delete`),否则内存会涨。
28
+
29
+ ---
30
+
31
+ ## 3. 重试策略:只重试"可能自愈"的错误
32
+
33
+ ```ts
34
+ export function shouldRetryStatus(status: number): boolean {
35
+ if (status === 0) return true // 网络层
36
+ if (status === 408 || status === 429) return true
37
+ return status >= 500
38
+ }
39
+ ```
40
+
41
+ 4xx 里除了 408/429 都不重试:会话不存在、未登录、已被裁决——重连一万次也还是这个结果,只会把"快速失败"拖成"转圈 30 秒"。
42
+
43
+ 退避是 500ms 起步、2 倍增长、上限 7s、最多 8 次。**不采纳服务端下发的 `retry:`**:那个字段描述的是"这个服务端希望的节奏",而客户端才知道用户当前在不在等、有没有别的请求在竞争。
44
+
45
+ 失败上限是必须的。没有上限的重连在服务端持续 500 时会变成前台静默的 DDoS。
46
+
47
+ ---
48
+
49
+ ## 4. EOF 不是"结束","turn.end" 才是
50
+
51
+ 最初的实现把"流正常关闭"当成回合结束,结果踩了一个坑:**代理在转发 SSE 时可能把上游的异常终止变成一次干净的 EOF**。前端收到 `done`,以为模型说完了,直接把半截回答落库。
52
+
53
+ 现在的语义:
54
+
55
+ - `turn.end` → 业务意义上的结束,store 主动 `close()` 掉连接;
56
+ - 任何 EOF(无论干净与否)→ 都当成"没等到 `turn.end` 的断流",进入重连。
57
+
58
+ 这意味着**服务端必须显式发 `turn.end`**,不能靠关连接表达结束。这条写进了协议约定。
59
+
60
+ ---
61
+
62
+ ## 5. 空闲看门狗:为半开连接准备
63
+
64
+ TCP 半开连接在应用层看起来是"完全正常"的:socket 还在,`read()` 只是永远不返回。三个常见来源:
65
+
66
+ - NAT/防火墙把空闲连接表项清掉;
67
+ - 负载均衡到 idle timeout 直接丢包,不回 RST;
68
+ - 反向代理挂住了已经死掉的上游(本项目在演示里就复现了这个:Vite 代理在上游被 `destroy()` 后仍保持浏览器侧连接)。
69
+
70
+ 所以有 `idleTimeoutMs`:超过 N 毫秒没有任何帧(包括心跳),`reader.cancel()` 并走重连。默认关闭,因为不同业务的首帧延迟差异太大——一个需要 40s 冷启动的检索型 Agent,默认 20s 会把它误杀。
71
+
72
+ **心跳的意义**:如果服务端在长时间思考时会发 `ping`,看门狗就能区分"确实在算"和"连接死了"。
73
+
74
+ ---
75
+
76
+ ## 6. 增量 Markdown:分块 + 缓存,不碰 innerHTML
77
+
78
+ 三个方案对比:
79
+
80
+ | 方案 | 每 token 成本 | 安全性 | 结论 |
81
+ | --- | --- | --- | --- |
82
+ | 全量 `markdown-it` + `innerHTML` | O(全文) parse + 整树 diff | 需要 DOMPurify,且模型输出的是不可信文本 | 长回答掉帧,风险高 |
83
+ | 全量 parse 成 React 树 | O(全文) parse | 安全 | 仍然掉帧 |
84
+ | **按块切分,只重解析尾块** | O(全文) 扫描 + O(尾块) 解析 | 安全(构造节点,不用 innerHTML) | 采用 |
85
+
86
+ 切块规则:空行结束段落;标题/分割线/围栏代码自成一块;列表按有序/无序分组;**未闭合的块标记 `closed: false`,不进缓存**。
87
+
88
+ 为什么不用 `innerHTML`:模型输出是外部输入。走 HTML 就等于把 XSS 防线交给模型的"心情",还要额外背一个 sanitizer 的维护成本。构造 React 节点天然转义,链接再做一次协议白名单(`javascript:` / `data:` 直接降级为纯文本)。
89
+
90
+ **缓存的边界**:缓存键是"块类型 + 语言 + 内容",命中后直接复用元素树。React 元素是不可变的,复用不会跳过子组件状态。
91
+
92
+ 不支持的语法(表格、内联 HTML、嵌套列表)是**刻意的**:每多一种语法,就多一类"流式中间态"的边界情况(比如表格在列数还没齐的时候怎么渲染)。对话场景里这些结构出现频率低,收益不抵成本。
93
+
94
+ ---
95
+
96
+ ## 7. 一帧一次渲染
97
+
98
+ 模型每秒能吐 20–60 个 delta。每次 `setState` 都触发一次 React 渲染,等于把时间全花在重复计算上——浏览器一帧最多画一次,多出来的渲染全是浪费。
99
+
100
+ 做法是**状态立即更新、通知按帧合并**:
101
+
102
+ ```ts
103
+ const scheduleFlush = () => {
104
+ if (scheduled) return
105
+ scheduled = true
106
+ pending = scheduler.schedule(notify) // 默认 requestAnimationFrame
107
+ }
108
+ ```
109
+
110
+ `getSnapshot()` 永远返回最新状态,所以不会读到旧值;订阅者每帧最多被叫醒一次。测试里换成同步调度器,断言就是确定的。
111
+
112
+ 配合 `useSyncExternalStore`,还顺带解决了并发渲染下的**撕裂**问题:流式更新是典型的外部高频源,`useState + useEffect` 很容易读到半新半旧的快照。
113
+
114
+ ---
115
+
116
+ ## 8. 工具参数:宁可显示原文,也不要猜
117
+
118
+ 模型生成工具参数是逐字符的,`{"query": "杭州` 这种中间态会持续几百毫秒。
119
+
120
+ `repairPartialJson` 只做**语法层**的收尾:补未闭合的括号、去掉悬空逗号、给悬空冒号补 `null`。一旦截断在字符串中间就放弃,UI 显示原文 + "参数生成中"。
121
+
122
+ 为什么不做更聪明的修复(比如猜一个完整字符串)?因为**用户会当真**。界面上出现一个看起来完整的参数,用户会以为模型就是这么调的;一旦和实际请求不一致,排障成本远高于"多看一眼原文"。
123
+
124
+ 同理,工具卡默认折叠,出错时默认展开——错误信息不应该藏在一次点击后面。
125
+
126
+ ---
127
+
128
+ ## 9. 为什么是 React
129
+
130
+ 这个库的判断大多与框架无关(分帧、续传、折叠、缓存)。选 React 是因为:
131
+
132
+ - `useSyncExternalStore` 是当前唯一"官方支持外部可变源 + 并发渲染"的原语;
133
+ - 工具卡、消息列表这类组合 UI 需要强类型 + 组件边界;
134
+ - 目标读者(Agent 产品的前端团队)大概率在 React 生态里。
135
+
136
+ 如果换 Vue,映射关系是:`useSyncExternalStore` → `shallowRef` + `markRaw` + `triggerRef`;`useMemo` 缓存块 → `computed`;组件 `memo` → `defineComponent` + `shouldUpdate`。**状态机本身一行都不用改**——这也是把 reducer 抽成纯函数的原因。
137
+
138
+ ---
139
+
140
+ ## 10. 还没做的事
141
+
142
+ - **消息虚拟化**:现在整段渲染,几万字以上需要套虚拟列表(难点是单条消息内部不能虚拟,否则选中和复制会坏)。
143
+ - **章节级重试**:目前重试是整轮重发。生产上更合理的是"从失败的阶段继续",这需要服务端支持 `resumeFrom`。
144
+ - **多端适配**:窄屏只是退化为单栏,没有做信息架构级别的降级。
145
+ - **鉴权刷新**:token 过期发生在流中间时,现在只能整轮重连;更好的做法是带一个 `authorize()` 回调,在 401 时刷新后重放。
package/package.json CHANGED
@@ -1,6 +1,86 @@
1
1
  {
2
2
  "name": "agent-stream-ui",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Agent 流式事件 → React 界面的最小运行时:SSE 分帧、断点续传、增量 Markdown、Tool Call 卡片",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "keywords": [
8
+ "agent",
9
+ "llm",
10
+ "streaming",
11
+ "sse",
12
+ "react",
13
+ "typescript",
14
+ "ai-ui",
15
+ "generative-ui",
16
+ "tool-calling",
17
+ "mcp"
18
+ ],
19
+ "files": [
20
+ "dist",
21
+ "src/lib",
22
+ "docs/design-notes.md"
23
+ ],
24
+ "main": "./dist/agent-stream-ui.js",
25
+ "module": "./dist/agent-stream-ui.js",
26
+ "types": "./dist/index.d.ts",
27
+ "exports": {
28
+ ".": {
29
+ "types": "./dist/index.d.ts",
30
+ "import": "./dist/agent-stream-ui.js"
31
+ },
32
+ "./styles.css": "./dist/agent-stream-ui.css"
33
+ },
34
+ "sideEffects": [
35
+ "**/*.css"
36
+ ],
37
+ "peerDependencies": {
38
+ "react": ">=18.0.0",
39
+ "react-dom": ">=18.0.0"
40
+ },
41
+ "scripts": {
42
+ "bench": "npm run build:lib && node scripts/bench.mjs",
43
+ "build": "tsc --noEmit -p tsconfig.json && vite build",
44
+ "build:lib": "vite build --config vite.lib.config.ts && tsc -p tsconfig.lib.json",
45
+ "dev": "node scripts/dev.mjs",
46
+ "dev:server": "node server/mock-agent.mjs",
47
+ "dev:web": "vite",
48
+ "example": "npm run build:lib && node examples/openai-compatible/server.mjs",
49
+ "measure:fcp": "node scripts/measure-fcp.mjs",
50
+ "prepublishOnly": "npm run build:lib",
51
+ "preview": "vite preview --port 4173",
52
+ "test": "vitest run",
53
+ "test:watch": "vitest",
54
+ "typecheck": "tsc --noEmit -p tsconfig.json"
55
+ },
56
+ "devDependencies": {
57
+ "@testing-library/jest-dom": "^6.9.1",
58
+ "@testing-library/react": "^16.3.3",
59
+ "@testing-library/user-event": "^14.6.1",
60
+ "@types/markdown-it": "^14.2.0",
61
+ "@types/node": "^24.19.2",
62
+ "@types/react": "^19.3.0",
63
+ "@types/react-dom": "^19.3.0",
64
+ "@vitejs/plugin-react": "^6.3.0",
65
+ "jsdom": "^31.0.1",
66
+ "markdown-it": "^15.0.3",
67
+ "react": "^19.3.1",
68
+ "react-dom": "^19.3.1",
69
+ "typescript": "^7.0.2",
70
+ "vite": "^8.3.8",
71
+ "vitest": "^5.1.1"
72
+ },
73
+ "author": "zhoulei",
74
+ "homepage": "https://caileiz.github.io/agent-stream-ui/",
75
+ "repository": {
76
+ "type": "git",
77
+ "url": "git+https://github.com/CAILeiz/agent-stream-ui.git"
78
+ },
79
+ "bugs": {
80
+ "url": "https://github.com/CAILeiz/agent-stream-ui/issues"
81
+ },
82
+ "publishConfig": {
83
+ "registry": "https://registry.npmjs.org",
84
+ "access": "public"
85
+ }
86
+ }