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.
- package/LICENSE +21 -0
- package/README.md +220 -2
- package/dist/adapters/openai.d.ts +42 -0
- package/dist/adapters/openai.d.ts.map +1 -0
- package/dist/agent-stream-ui.css +2 -0
- package/dist/agent-stream-ui.js +1418 -0
- package/dist/agent-stream-ui.js.map +1 -0
- package/dist/core/reducer.d.ts +33 -0
- package/dist/core/reducer.d.ts.map +1 -0
- package/dist/core/scheduler.d.ts +15 -0
- package/dist/core/scheduler.d.ts.map +1 -0
- package/dist/core/store.d.ts +29 -0
- package/dist/core/store.d.ts.map +1 -0
- package/dist/core/transport.d.ts +57 -0
- package/dist/core/transport.d.ts.map +1 -0
- package/dist/index.d.ts +38 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/markdown/blocks.d.ts +31 -0
- package/dist/markdown/blocks.d.ts.map +1 -0
- package/dist/markdown/inline.d.ts +13 -0
- package/dist/markdown/inline.d.ts.map +1 -0
- package/dist/markdown/render.d.ts +18 -0
- package/dist/markdown/render.d.ts.map +1 -0
- package/dist/react/agent-chat.d.ts +14 -0
- package/dist/react/agent-chat.d.ts.map +1 -0
- package/dist/react/composer.d.ts +11 -0
- package/dist/react/composer.d.ts.map +1 -0
- package/dist/react/icons.d.ts +12 -0
- package/dist/react/icons.d.ts.map +1 -0
- package/dist/react/markdown-stream.d.ts +14 -0
- package/dist/react/markdown-stream.d.ts.map +1 -0
- package/dist/react/message-body.d.ts +14 -0
- package/dist/react/message-body.d.ts.map +1 -0
- package/dist/react/message-list.d.ts +8 -0
- package/dist/react/message-list.d.ts.map +1 -0
- package/dist/react/tool-call-card.d.ts +13 -0
- package/dist/react/tool-call-card.d.ts.map +1 -0
- package/dist/react/use-agent-stream.d.ts +11 -0
- package/dist/react/use-agent-stream.d.ts.map +1 -0
- package/dist/react/use-stick-to-bottom.d.ts +14 -0
- package/dist/react/use-stick-to-bottom.d.ts.map +1 -0
- package/dist/sse/client.d.ts +60 -0
- package/dist/sse/client.d.ts.map +1 -0
- package/dist/sse/frame.d.ts +42 -0
- package/dist/sse/frame.d.ts.map +1 -0
- package/dist/types.d.ts +119 -0
- package/dist/types.d.ts.map +1 -0
- package/docs/design-notes.md +145 -0
- package/package.json +84 -4
- package/src/lib/adapters/openai.ts +112 -0
- package/src/lib/core/reducer.ts +417 -0
- package/src/lib/core/scheduler.ts +40 -0
- package/src/lib/core/store.ts +214 -0
- package/src/lib/core/transport.ts +197 -0
- package/src/lib/index.ts +102 -0
- package/src/lib/markdown/blocks.ts +201 -0
- package/src/lib/markdown/inline.tsx +87 -0
- package/src/lib/markdown/render.tsx +149 -0
- package/src/lib/react/agent-chat.tsx +121 -0
- package/src/lib/react/composer.tsx +105 -0
- package/src/lib/react/icons.tsx +83 -0
- package/src/lib/react/markdown-stream.tsx +37 -0
- package/src/lib/react/message-body.tsx +66 -0
- package/src/lib/react/message-list.tsx +109 -0
- package/src/lib/react/tool-call-card.tsx +117 -0
- package/src/lib/react/use-agent-stream.ts +14 -0
- package/src/lib/react/use-stick-to-bottom.ts +60 -0
- package/src/lib/sse/client.ts +263 -0
- package/src/lib/sse/frame.ts +116 -0
- package/src/lib/styles.css +790 -0
- package/src/lib/types.ts +130 -0
package/src/lib/types.ts
ADDED
|
@@ -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
|
+
}
|