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
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OpenAI Chat Completions 流式 chunk → 本库事件协议的适配器。
|
|
3
|
+
*
|
|
4
|
+
* 为什么放进库里而不是示例里:协议差异是所有人接 Agent 时都要写的第一段代码,
|
|
5
|
+
* 而它恰好最容易写错——工具参数是**分片**到达的,`id` 只在第一片出现,
|
|
6
|
+
* `index` 才是稳定的关联键。这些细节写一次、测一次,比每个项目各踩一遍好。
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import type { AgentEvent } from '../types'
|
|
10
|
+
|
|
11
|
+
export interface OpenAIToolCallDelta {
|
|
12
|
+
index?: number
|
|
13
|
+
id?: string
|
|
14
|
+
type?: string
|
|
15
|
+
function?: {
|
|
16
|
+
name?: string
|
|
17
|
+
arguments?: string
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export interface OpenAIStreamChunk {
|
|
22
|
+
choices?: Array<{
|
|
23
|
+
delta?: {
|
|
24
|
+
content?: string | null
|
|
25
|
+
reasoning_content?: string | null
|
|
26
|
+
tool_calls?: OpenAIToolCallDelta[]
|
|
27
|
+
}
|
|
28
|
+
finish_reason?: string | null
|
|
29
|
+
}>
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export interface OpenAIToolCallRef {
|
|
33
|
+
callId: string
|
|
34
|
+
name: string
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export interface OpenAIStreamTranslator {
|
|
38
|
+
/** 翻译一个上游 chunk;不认识的 chunk 返回空数组而不是抛错。 */
|
|
39
|
+
translate: (chunk: OpenAIStreamChunk) => AgentEvent[]
|
|
40
|
+
/** 上游给的结束原因(`stop` / `tool_calls` / `length` / ...)。 */
|
|
41
|
+
readonly finishReason: string | null
|
|
42
|
+
/** index → 工具调用,供上层执行工具时取用。 */
|
|
43
|
+
readonly toolCalls: ReadonlyMap<number, OpenAIToolCallRef>
|
|
44
|
+
reset: () => void
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function createOpenAIStreamTranslator(): OpenAIStreamTranslator {
|
|
48
|
+
let finishReason: string | null = null
|
|
49
|
+
const calls = new Map<number, OpenAIToolCallRef>()
|
|
50
|
+
/** 已经发过 tool.args 的调用,避免空串也发一帧。 */
|
|
51
|
+
const started = new Set<number>()
|
|
52
|
+
|
|
53
|
+
const translate = (chunk: OpenAIStreamChunk): AgentEvent[] => {
|
|
54
|
+
const choice = chunk.choices?.[0]
|
|
55
|
+
if (!choice) return []
|
|
56
|
+
|
|
57
|
+
const events: AgentEvent[] = []
|
|
58
|
+
const delta = choice.delta ?? {}
|
|
59
|
+
|
|
60
|
+
if (typeof delta.content === 'string' && delta.content !== '') {
|
|
61
|
+
events.push({ type: 'message.delta', text: delta.content })
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
for (const piece of delta.tool_calls ?? []) {
|
|
65
|
+
const index = piece.index ?? 0
|
|
66
|
+
|
|
67
|
+
if (!calls.has(index)) {
|
|
68
|
+
const callId = piece.id ?? `call_${index}`
|
|
69
|
+
const name = piece.function?.name ?? 'unknown_tool'
|
|
70
|
+
calls.set(index, { callId, name })
|
|
71
|
+
// 新调用:先卡片、再参数增量。卡片的 arguments 留空,由 tool.args 填。
|
|
72
|
+
events.push({ type: 'tool.call', callId, name, arguments: '' })
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const call = calls.get(index)!
|
|
76
|
+
const args = piece.function?.arguments
|
|
77
|
+
if (typeof args === 'string' && args !== '') {
|
|
78
|
+
started.add(index)
|
|
79
|
+
events.push({ type: 'tool.args', callId: call.callId, arguments: args })
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
if (choice.finish_reason) {
|
|
84
|
+
finishReason = choice.finish_reason
|
|
85
|
+
|
|
86
|
+
if (finishReason === 'tool_calls') {
|
|
87
|
+
// 参数流结束:显式收口,UI 才能把"生成中"换成解析后的参数
|
|
88
|
+
for (const [index, call] of calls) {
|
|
89
|
+
if (!started.has(index)) events.push({ type: 'tool.args', callId: call.callId, arguments: '' })
|
|
90
|
+
events.push({ type: 'tool.args', callId: call.callId, arguments: '', complete: true })
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
return events
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
return {
|
|
99
|
+
translate,
|
|
100
|
+
get finishReason() {
|
|
101
|
+
return finishReason
|
|
102
|
+
},
|
|
103
|
+
get toolCalls() {
|
|
104
|
+
return calls
|
|
105
|
+
},
|
|
106
|
+
reset() {
|
|
107
|
+
finishReason = null
|
|
108
|
+
calls.clear()
|
|
109
|
+
started.clear()
|
|
110
|
+
},
|
|
111
|
+
}
|
|
112
|
+
}
|
|
@@ -0,0 +1,417 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 事件 → 状态的折叠(reducer)。
|
|
3
|
+
*
|
|
4
|
+
* 这是整个库的核心:一个纯函数把"半可靠、可能重放、可能乱序"的事件流,
|
|
5
|
+
* 折叠成 UI 可以直接渲染的状态。所有边界规则都在这里,组件只管画。
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type {
|
|
9
|
+
AgentError,
|
|
10
|
+
AgentEvent,
|
|
11
|
+
AgentEventType,
|
|
12
|
+
ConversationSnapshot,
|
|
13
|
+
LiveTurn,
|
|
14
|
+
Message,
|
|
15
|
+
MessagePart,
|
|
16
|
+
SseStatus,
|
|
17
|
+
SseStatusInfo,
|
|
18
|
+
ToolCallState,
|
|
19
|
+
TurnStatus,
|
|
20
|
+
} from '../types'
|
|
21
|
+
|
|
22
|
+
const KNOWN_TYPES = new Set<string>([
|
|
23
|
+
'turn.start',
|
|
24
|
+
'message.delta',
|
|
25
|
+
'message.done',
|
|
26
|
+
'tool.call',
|
|
27
|
+
'tool.args',
|
|
28
|
+
'tool.result',
|
|
29
|
+
'turn.end',
|
|
30
|
+
'error',
|
|
31
|
+
'ping',
|
|
32
|
+
])
|
|
33
|
+
|
|
34
|
+
export function isAgentEventType(type: string): type is AgentEventType {
|
|
35
|
+
return KNOWN_TYPES.has(type)
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** 把服务端帧解析成事件;未知事件 / 坏 JSON 返回 null 而不是抛错。 */
|
|
39
|
+
export function decodeAgentEvent(event: string, data: string): AgentEvent | null {
|
|
40
|
+
if (!isAgentEventType(event)) return null
|
|
41
|
+
|
|
42
|
+
let payload: unknown
|
|
43
|
+
try {
|
|
44
|
+
payload = data === '' ? {} : JSON.parse(data)
|
|
45
|
+
} catch {
|
|
46
|
+
return null
|
|
47
|
+
}
|
|
48
|
+
if (payload === null || typeof payload !== 'object') return null
|
|
49
|
+
|
|
50
|
+
return { type: event, ...(payload as object) } as AgentEvent
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/* ------------------------------------------------------------------ *
|
|
54
|
+
* 工具调用入参:流式到达的可能是残缺 JSON
|
|
55
|
+
* ------------------------------------------------------------------ */
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* 把模型边生成边吐出的参数补成可解析的 JSON。
|
|
59
|
+
* 只做"未闭合字符串/括号/悬空分隔符"的收尾,不做语义修复——
|
|
60
|
+
* 过度的猜测会让用户看到假参数,比"解析中"更糟。
|
|
61
|
+
*/
|
|
62
|
+
export function repairPartialJson(raw: string): { value: unknown; complete: boolean } | null {
|
|
63
|
+
const trimmed = raw.trim()
|
|
64
|
+
if (trimmed === '') return null
|
|
65
|
+
|
|
66
|
+
try {
|
|
67
|
+
return { value: JSON.parse(trimmed), complete: true }
|
|
68
|
+
} catch {
|
|
69
|
+
// 继续走修复
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const repaired = closeOpenJson(trimmed)
|
|
73
|
+
if (repaired === null) return null
|
|
74
|
+
|
|
75
|
+
try {
|
|
76
|
+
return { value: JSON.parse(repaired), complete: false }
|
|
77
|
+
} catch {
|
|
78
|
+
return null
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
function closeOpenJson(input: string): string | null {
|
|
83
|
+
const stack: string[] = []
|
|
84
|
+
let inString = false
|
|
85
|
+
let escaped = false
|
|
86
|
+
let cutAt = -1
|
|
87
|
+
|
|
88
|
+
for (let index = 0; index < input.length; index += 1) {
|
|
89
|
+
const char = input[index]
|
|
90
|
+
|
|
91
|
+
if (inString) {
|
|
92
|
+
if (escaped) escaped = false
|
|
93
|
+
else if (char === '\\') escaped = true
|
|
94
|
+
else if (char === '"') inString = false
|
|
95
|
+
continue
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
if (char === '"') inString = true
|
|
99
|
+
else if (char === '{' || char === '[') stack.push(char)
|
|
100
|
+
else if (char === '}' || char === ']') {
|
|
101
|
+
if (stack.length === 0) return null
|
|
102
|
+
stack.pop()
|
|
103
|
+
if (stack.length === 0) cutAt = index
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
if (inString) {
|
|
108
|
+
// 截断在字符串中间:去掉未完成的键或值,修复成本太高,交给 UI 显示原文
|
|
109
|
+
return null
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
if (cutAt !== -1) {
|
|
113
|
+
// 外层对象已闭合,后面跟了多余内容(比如多个 JSON 拼接)—— 取第一段
|
|
114
|
+
return input.slice(0, cutAt + 1)
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
if (stack.length === 0) return null
|
|
118
|
+
|
|
119
|
+
// 悬空的分隔符:`{"a": 1,` → 去掉尾逗号再补括号
|
|
120
|
+
let body = input.replace(/,\s*$/, '')
|
|
121
|
+
if (body.endsWith(':')) body = `${body} null`
|
|
122
|
+
const closers = stack
|
|
123
|
+
.slice()
|
|
124
|
+
.reverse()
|
|
125
|
+
.map((open) => (open === '{' ? '}' : ']'))
|
|
126
|
+
.join('')
|
|
127
|
+
return body + closers
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/* ------------------------------------------------------------------ *
|
|
131
|
+
* 初始值
|
|
132
|
+
* ------------------------------------------------------------------ */
|
|
133
|
+
|
|
134
|
+
export const initialLiveTurn = (now = Date.now()): LiveTurn => ({
|
|
135
|
+
turnId: null,
|
|
136
|
+
status: 'running',
|
|
137
|
+
parts: [],
|
|
138
|
+
toolCalls: [],
|
|
139
|
+
error: null,
|
|
140
|
+
interrupted: false,
|
|
141
|
+
startedAt: now,
|
|
142
|
+
endedAt: null,
|
|
143
|
+
})
|
|
144
|
+
|
|
145
|
+
export const initialSnapshot = (): ConversationSnapshot => ({
|
|
146
|
+
messages: [],
|
|
147
|
+
live: null,
|
|
148
|
+
status: 'idle',
|
|
149
|
+
reconnect: null,
|
|
150
|
+
})
|
|
151
|
+
|
|
152
|
+
/* ------------------------------------------------------------------ *
|
|
153
|
+
* 内部工具
|
|
154
|
+
* ------------------------------------------------------------------ */
|
|
155
|
+
|
|
156
|
+
function appendText(parts: MessagePart[], text: string): MessagePart[] {
|
|
157
|
+
if (text === '') return parts
|
|
158
|
+
const last = parts[parts.length - 1]
|
|
159
|
+
if (last && last.kind === 'text') {
|
|
160
|
+
// 合并相邻文本,避免每次 delta 新增一个数组元素
|
|
161
|
+
const next = parts.slice(0, -1)
|
|
162
|
+
next.push({ kind: 'text', text: last.text + text })
|
|
163
|
+
return next
|
|
164
|
+
}
|
|
165
|
+
return [...parts, { kind: 'text', text }]
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
function upsertTool(toolCalls: ToolCallState[], call: ToolCallState): ToolCallState[] {
|
|
169
|
+
const index = toolCalls.findIndex((item) => item.callId === call.callId)
|
|
170
|
+
if (index === -1) return [...toolCalls, call]
|
|
171
|
+
const next = toolCalls.slice()
|
|
172
|
+
next[index] = call
|
|
173
|
+
return next
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
let fallbackId = 0
|
|
177
|
+
function nextId(prefix: string): string {
|
|
178
|
+
fallbackId += 1
|
|
179
|
+
return `${prefix}-${Date.now().toString(36)}-${fallbackId}`
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
function finalizeLive(
|
|
183
|
+
live: LiveTurn,
|
|
184
|
+
status: Exclude<TurnStatus, 'running'>,
|
|
185
|
+
now: number,
|
|
186
|
+
error?: AgentError,
|
|
187
|
+
): Message | null {
|
|
188
|
+
const hasContent = live.parts.some(
|
|
189
|
+
(part) => part.kind === 'tool' || (part.kind === 'text' && part.text.trim() !== ''),
|
|
190
|
+
)
|
|
191
|
+
if (!hasContent) return null
|
|
192
|
+
|
|
193
|
+
return {
|
|
194
|
+
id: live.turnId ?? nextId('assistant'),
|
|
195
|
+
role: 'assistant',
|
|
196
|
+
parts: live.parts,
|
|
197
|
+
toolCalls: live.toolCalls.map((tool) =>
|
|
198
|
+
tool.status === 'running'
|
|
199
|
+
? { ...tool, status: 'error' as const, preview: tool.preview ?? '未返回结果' }
|
|
200
|
+
: tool,
|
|
201
|
+
),
|
|
202
|
+
status,
|
|
203
|
+
createdAt: live.startedAt || now,
|
|
204
|
+
...(error === undefined ? {} : { error }),
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/* ------------------------------------------------------------------ *
|
|
209
|
+
* 对外 reducer
|
|
210
|
+
* ------------------------------------------------------------------ */
|
|
211
|
+
|
|
212
|
+
export function reduceAgentEvent(
|
|
213
|
+
snapshot: ConversationSnapshot,
|
|
214
|
+
event: AgentEvent,
|
|
215
|
+
now = Date.now(),
|
|
216
|
+
): ConversationSnapshot {
|
|
217
|
+
switch (event.type) {
|
|
218
|
+
case 'ping':
|
|
219
|
+
return snapshot
|
|
220
|
+
|
|
221
|
+
case 'turn.start':
|
|
222
|
+
return {
|
|
223
|
+
...snapshot,
|
|
224
|
+
live: { ...initialLiveTurn(now), turnId: event.turnId, startedAt: now },
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
case 'message.delta': {
|
|
228
|
+
const live = snapshot.live ?? initialLiveTurn(now)
|
|
229
|
+
return {
|
|
230
|
+
...snapshot,
|
|
231
|
+
live: { ...live, parts: appendText(live.parts, event.text) },
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
case 'tool.call': {
|
|
236
|
+
const live = snapshot.live ?? initialLiveTurn(now)
|
|
237
|
+
const tool: ToolCallState = {
|
|
238
|
+
callId: event.callId,
|
|
239
|
+
name: event.name,
|
|
240
|
+
args: event.arguments ?? '',
|
|
241
|
+
argsComplete: false,
|
|
242
|
+
status: 'running',
|
|
243
|
+
startedAt: now,
|
|
244
|
+
}
|
|
245
|
+
return {
|
|
246
|
+
...snapshot,
|
|
247
|
+
live: {
|
|
248
|
+
...live,
|
|
249
|
+
toolCalls: upsertTool(live.toolCalls, tool),
|
|
250
|
+
// 同一个 callId 可能因重连被重放,parts 必须幂等
|
|
251
|
+
parts: partExistsFor(live.parts, event.callId)
|
|
252
|
+
? live.parts
|
|
253
|
+
: [...live.parts, { kind: 'tool', callId: event.callId }],
|
|
254
|
+
},
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
case 'tool.args': {
|
|
259
|
+
const live = snapshot.live
|
|
260
|
+
if (!live) return snapshot
|
|
261
|
+
const existing = live.toolCalls.find((item) => item.callId === event.callId)
|
|
262
|
+
if (!existing) return snapshot
|
|
263
|
+
|
|
264
|
+
const updated: ToolCallState = {
|
|
265
|
+
...existing,
|
|
266
|
+
args: existing.args + event.arguments,
|
|
267
|
+
argsComplete: event.complete ?? existing.argsComplete,
|
|
268
|
+
}
|
|
269
|
+
return {
|
|
270
|
+
...snapshot,
|
|
271
|
+
live: { ...live, toolCalls: upsertTool(live.toolCalls, updated) },
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
case 'tool.result': {
|
|
276
|
+
const live = snapshot.live
|
|
277
|
+
if (!live) return snapshot
|
|
278
|
+
const existing = live.toolCalls.find((item) => item.callId === event.callId)
|
|
279
|
+
if (!existing) return snapshot
|
|
280
|
+
|
|
281
|
+
const updated: ToolCallState = {
|
|
282
|
+
...existing,
|
|
283
|
+
argsComplete: true,
|
|
284
|
+
status: event.ok ? 'ok' : 'error',
|
|
285
|
+
preview: event.preview ?? existing.preview,
|
|
286
|
+
durationMs: event.durationMs ?? now - existing.startedAt,
|
|
287
|
+
}
|
|
288
|
+
return {
|
|
289
|
+
...snapshot,
|
|
290
|
+
live: { ...live, toolCalls: upsertTool(live.toolCalls, updated) },
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
case 'message.done': {
|
|
295
|
+
const live = snapshot.live
|
|
296
|
+
if (!live) return snapshot
|
|
297
|
+
return { ...snapshot, live: { ...live, parts: live.parts } }
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
case 'error': {
|
|
301
|
+
const live = snapshot.live ?? initialLiveTurn(now)
|
|
302
|
+
const error: AgentError = {
|
|
303
|
+
message: event.message,
|
|
304
|
+
stage: event.stage ?? 'unknown',
|
|
305
|
+
retriable: event.retriable ?? true,
|
|
306
|
+
}
|
|
307
|
+
const finalized = finalizeLive(live, 'error', now, error)
|
|
308
|
+
return {
|
|
309
|
+
...snapshot,
|
|
310
|
+
messages: finalized ? [...snapshot.messages, finalized] : snapshot.messages,
|
|
311
|
+
live: finalized ? null : { ...live, status: 'error', error, endedAt: now },
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
case 'turn.end': {
|
|
316
|
+
const live = snapshot.live
|
|
317
|
+
if (!live) return snapshot
|
|
318
|
+
const status: Exclude<TurnStatus, 'running'> =
|
|
319
|
+
event.reason === 'stopped' ? 'stopped' : 'done'
|
|
320
|
+
const finalized = finalizeLive(live, status, now)
|
|
321
|
+
return {
|
|
322
|
+
...snapshot,
|
|
323
|
+
messages: finalized ? [...snapshot.messages, finalized] : snapshot.messages,
|
|
324
|
+
live: null,
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
default:
|
|
329
|
+
return snapshot
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
function partExistsFor(parts: MessagePart[], callId: string): boolean {
|
|
334
|
+
return parts.some((part) => part.kind === 'tool' && part.callId === callId)
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/* ------------------------------------------------------------------ *
|
|
338
|
+
* 本地动作
|
|
339
|
+
* ------------------------------------------------------------------ */
|
|
340
|
+
|
|
341
|
+
export function appendUserMessage(
|
|
342
|
+
snapshot: ConversationSnapshot,
|
|
343
|
+
text: string,
|
|
344
|
+
now = Date.now(),
|
|
345
|
+
): ConversationSnapshot {
|
|
346
|
+
const trimmed = text.trim()
|
|
347
|
+
if (trimmed === '') return snapshot
|
|
348
|
+
return {
|
|
349
|
+
...snapshot,
|
|
350
|
+
messages: [
|
|
351
|
+
...snapshot.messages,
|
|
352
|
+
{
|
|
353
|
+
id: nextId('user'),
|
|
354
|
+
role: 'user',
|
|
355
|
+
parts: [{ kind: 'text', text: trimmed }],
|
|
356
|
+
toolCalls: [],
|
|
357
|
+
status: 'done',
|
|
358
|
+
createdAt: now,
|
|
359
|
+
},
|
|
360
|
+
],
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
/** 用户点"停止":本地立即收尾,不等服务端确认。 */
|
|
365
|
+
export function stopLiveTurn(
|
|
366
|
+
snapshot: ConversationSnapshot,
|
|
367
|
+
now = Date.now(),
|
|
368
|
+
): ConversationSnapshot {
|
|
369
|
+
const live = snapshot.live
|
|
370
|
+
if (!live) return snapshot
|
|
371
|
+
const finalized = finalizeLive(live, 'stopped', now)
|
|
372
|
+
return {
|
|
373
|
+
...snapshot,
|
|
374
|
+
messages: finalized ? [...snapshot.messages, finalized] : snapshot.messages,
|
|
375
|
+
live: null,
|
|
376
|
+
status: 'stopped',
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
/** 传输层状态变化:只影响"是否在重连",不改消息内容。 */
|
|
381
|
+
export function applySseStatus(
|
|
382
|
+
snapshot: ConversationSnapshot,
|
|
383
|
+
status: SseStatus,
|
|
384
|
+
info?: SseStatusInfo,
|
|
385
|
+
): ConversationSnapshot {
|
|
386
|
+
const interrupted = status === 'reconnecting'
|
|
387
|
+
const reconnect = interrupted ? (info ?? null) : null
|
|
388
|
+
const live = snapshot.live
|
|
389
|
+
return {
|
|
390
|
+
...snapshot,
|
|
391
|
+
status,
|
|
392
|
+
reconnect,
|
|
393
|
+
live: live && live.interrupted !== interrupted ? { ...live, interrupted } : live,
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
/**
|
|
398
|
+
* 流意外结束(服务端关闭但没发 turn.end):把还在跑的回合收成错误态,
|
|
399
|
+
* 而不是让它永远转圈。这是"UI 不能撒谎"的最小要求。
|
|
400
|
+
*/
|
|
401
|
+
export function settleOrphanLiveTurn(
|
|
402
|
+
snapshot: ConversationSnapshot,
|
|
403
|
+
now = Date.now(),
|
|
404
|
+
): ConversationSnapshot {
|
|
405
|
+
const live = snapshot.live
|
|
406
|
+
if (!live) return snapshot
|
|
407
|
+
return reduceAgentEvent(
|
|
408
|
+
snapshot,
|
|
409
|
+
{
|
|
410
|
+
type: 'error',
|
|
411
|
+
message: '连接已断开,本轮未完成',
|
|
412
|
+
stage: 'unknown',
|
|
413
|
+
retriable: true,
|
|
414
|
+
},
|
|
415
|
+
now,
|
|
416
|
+
)
|
|
417
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 一次渲染的调度器。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要这个:模型每秒可能吐出 20–60 个 delta,每个都通知 React 重新渲染
|
|
5
|
+
* 是纯浪费——浏览器一帧最多画一次。默认用 rAF 把「状态已变」和「通知订阅者」
|
|
6
|
+
* 解耦,一帧只 flush 一次;测试里换成同步调度器,断言才是确定的。
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
export interface FlushScheduler {
|
|
10
|
+
schedule: (flush: () => void) => unknown
|
|
11
|
+
cancel: (handle: unknown) => void
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export const immediateScheduler: FlushScheduler = {
|
|
15
|
+
schedule(flush) {
|
|
16
|
+
flush()
|
|
17
|
+
return null
|
|
18
|
+
},
|
|
19
|
+
cancel() {
|
|
20
|
+
/* 同步调度没有可取消的句柄 */
|
|
21
|
+
},
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export const rafScheduler: FlushScheduler = {
|
|
25
|
+
schedule(flush) {
|
|
26
|
+
if (typeof requestAnimationFrame !== 'function') {
|
|
27
|
+
return setTimeout(flush, 16)
|
|
28
|
+
}
|
|
29
|
+
return requestAnimationFrame(() => flush())
|
|
30
|
+
},
|
|
31
|
+
cancel(handle) {
|
|
32
|
+
if (typeof cancelAnimationFrame === 'function') {
|
|
33
|
+
cancelAnimationFrame(handle as number)
|
|
34
|
+
}
|
|
35
|
+
},
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function defaultScheduler(): FlushScheduler {
|
|
39
|
+
return typeof requestAnimationFrame === 'function' ? rafScheduler : immediateScheduler
|
|
40
|
+
}
|