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,130 @@
1
+ /**
2
+ * 领域类型:事件协议 + 会话状态。
3
+ *
4
+ * 设计约束:事件是**线上协议**,状态是**渲染输入**。两者刻意分开——
5
+ * 服务端换实现只要仍发这套事件,前端不用改;前端换渲染只要仍读这套状态,
6
+ * 传输层也不用改。
7
+ */
8
+
9
+ /* ------------------------------------------------------------------ *
10
+ * 1. 事件协议(服务端 → 客户端,SSE `data:` 里的 JSON)
11
+ * ------------------------------------------------------------------ */
12
+
13
+ export type ErrorStage = 'retrieve' | 'analyze' | 'generate' | 'unknown'
14
+
15
+ export interface AgentEventPayloads {
16
+ 'turn.start': { turnId: string }
17
+ 'message.delta': { text: string }
18
+ 'message.done': { messageId?: string }
19
+ 'tool.call': { callId: string; name: string; arguments?: string }
20
+ /** 工具参数增量:OpenAI/Anthropic 都是边生成边下发,界面可以边显示边解析。 */
21
+ 'tool.args': { callId: string; arguments: string; complete?: boolean }
22
+ 'tool.result': {
23
+ callId: string
24
+ ok: boolean
25
+ preview?: string
26
+ durationMs?: number
27
+ }
28
+ 'turn.end': { reason: 'complete' | 'stopped' | 'error' }
29
+ error: { message: string; stage?: ErrorStage; retriable?: boolean }
30
+ ping: { at?: number }
31
+ }
32
+
33
+ export type AgentEventType = keyof AgentEventPayloads
34
+
35
+ /** 判别联合:`switch (event.type)` 之后 payload 自动收窄。 */
36
+ export type AgentEvent = {
37
+ [K in AgentEventType]: { type: K } & AgentEventPayloads[K]
38
+ }[AgentEventType]
39
+
40
+ export const AGENT_EVENT_TYPES: readonly AgentEventType[] = [
41
+ 'turn.start',
42
+ 'message.delta',
43
+ 'message.done',
44
+ 'tool.call',
45
+ 'tool.args',
46
+ 'tool.result',
47
+ 'turn.end',
48
+ 'error',
49
+ 'ping',
50
+ ]
51
+
52
+ /* ------------------------------------------------------------------ *
53
+ * 2. 渲染状态
54
+ * ------------------------------------------------------------------ */
55
+
56
+ export type ToolStatus = 'running' | 'ok' | 'error'
57
+
58
+ export interface ToolCallState {
59
+ callId: string
60
+ name: string
61
+ /** 原始入参文本。流式到达时可能是不完整的 JSON,UI 必须容忍。 */
62
+ args: string
63
+ /** 入参是否已完整(收到 tool.result,或被后续事件判定结束)。 */
64
+ argsComplete: boolean
65
+ status: ToolStatus
66
+ preview?: string
67
+ durationMs?: number
68
+ startedAt: number
69
+ }
70
+
71
+ /**
72
+ * 消息内容按到达顺序切片:文本和工具卡交错,而不是"先正文后工具"。
73
+ * 这一点在真实 Agent 里很关键——模型可能"说一句 → 调工具 → 接着说"。
74
+ */
75
+ export type MessagePart =
76
+ | { kind: 'text'; text: string }
77
+ | { kind: 'tool'; callId: string }
78
+
79
+ export type TurnStatus = 'running' | 'done' | 'error' | 'stopped'
80
+
81
+ export interface AgentError {
82
+ message: string
83
+ stage: ErrorStage
84
+ retriable: boolean
85
+ }
86
+
87
+ export interface LiveTurn {
88
+ turnId: string | null
89
+ status: TurnStatus
90
+ parts: MessagePart[]
91
+ toolCalls: ToolCallState[]
92
+ error: AgentError | null
93
+ /** 传输层掉线、正在重连时为 true(区别于模型报错)。 */
94
+ interrupted: boolean
95
+ startedAt: number
96
+ endedAt: number | null
97
+ }
98
+
99
+ export interface Message {
100
+ id: string
101
+ role: 'user' | 'assistant'
102
+ parts: MessagePart[]
103
+ toolCalls: ToolCallState[]
104
+ status: Exclude<TurnStatus, 'running'>
105
+ createdAt: number
106
+ /** 失败回合的落库错误,供已提交消息继续展示重试入口。 */
107
+ error?: AgentError
108
+ }
109
+
110
+ export type SseStatus =
111
+ | 'idle'
112
+ | 'connecting'
113
+ | 'open'
114
+ | 'reconnecting'
115
+ | 'closed'
116
+ | 'stopped'
117
+ | 'error'
118
+
119
+ export interface SseStatusInfo {
120
+ attempt: number
121
+ delayMs: number
122
+ reason?: string
123
+ }
124
+
125
+ export interface ConversationSnapshot {
126
+ messages: Message[]
127
+ live: LiveTurn | null
128
+ status: SseStatus
129
+ reconnect: SseStatusInfo | null
130
+ }