@njuptlzf/agent-chat-web 0.3.0 → 0.4.1

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.
@@ -1,130 +1,130 @@
1
- /**
2
- * 组合根的通用实现(接缝的最后一层,2026-11-03)。
3
- *
4
- * 以前这份接线长在 `apps/web/src/App.tsx` 里(113 行),产品事实与机械传参
5
- * 混在一处——第二个产品只能**把整份文件复制走再改 import**。这里把机械部分
6
- * 收进 core,产品只保留自己的事实(导航注册表、文案兜底、侧栏入口、宿主级组件)。
7
- *
8
- * 插槽契约(照抄时最容易踩的一条):
9
- * `footer` / `extras` 是**普通闭包**,不是组件——它们在 AgentApp 的 render
10
- * 期间被调用,所以里面**不要调用 hook**(要 state 就在产品自己的组件里
11
- * 用 useState,闭包里只捕获 setter)。
12
- *
13
- * 依赖方向恒为 产品 → agent-chat:本文件不 import 任何产品代码。
14
- */
15
- import type { ReactNode } from "react";
16
- import type { BrandingResponse } from "@njuptlzf/agent-chat-protocol";
17
- import AgentChatApp from "./AgentChatApp.tsx";
18
- import DockPanel from "./DockPanel.tsx";
19
- import { AppShell, themeVarsOf, useAppHost, type AppDef } from "./app.tsx";
20
- import type { Slots } from "./ui/slots.tsx";
21
-
22
- /** 宿主状态(`useAppHost` 的返回值):插槽从这里取品牌、身份、路由、人格。 */
23
- export type AppHost = ReturnType<typeof useAppHost>;
24
-
25
- /** 产品给的界面文案:全由 branding(manifest 声明)与当前人格决定。 */
26
- export interface AppTexts {
27
- /** 坞标题(换人格时要换,否则点了「声明人格」还写着「默认助手」)。 */
28
- title: string;
29
- /** 助手在界面上的叫法(「正在回答」这类提示语用)。 */
30
- assistantLabel: string;
31
- /** 提示条:这个助手是谁、不做什么。 */
32
- policyNote?: string;
33
- welcome?: string;
34
- suggestions?: string[];
35
- }
36
-
37
- export interface AgentAppProps {
38
- /** 导航注册表(产品事实)。 */
39
- def: AppDef;
40
- /** 文案兜底:core 不认得任何人格名,也不写死任何一句话。 */
41
- texts(branding: BrandingResponse, persona: string): AppTexts;
42
- /**
43
- * 视觉件槽位覆盖(可插拔):整体替换 Icon / FollowUpSuggestions 等。
44
- * 组件写结构兼容的形状即可(类型不导出,避免新增公开符号);不传 = 全默认。
45
- */
46
- slots?: Partial<Slots>;
47
- /** 侧栏底部的产品入口(声明人格、反馈问题…)。闭包,不能调 hook。 */
48
- footer?(host: AppHost): ReactNode;
49
- /** 宿主级组件(每日总结、反馈抽屉…)。闭包,不能调 hook。 */
50
- extras?(host: AppHost): ReactNode;
51
- /** 加载失败时给产品的启动提示(core 不知道启动命令长什么样)。 */
52
- loadErrorHint?: ReactNode;
53
- }
54
-
55
- /**
56
- * 产品组合根:branding/whoami → 宿主状态 → 侧栏 + 坞 + 页面。
57
- *
58
- * 与改造前 `App.tsx` 的行为逐项对齐(full/compact 的判据、key 重挂、插槽位置),
59
- * 差别只有一处:人格不再由 core 判断"谁是声明人格"——`host.persona` 原样传给
60
- * `AgentChatApp`("" 收敛成 undefined = 产品默认助手),文案由 `texts` 决定。
61
- */
62
- export function AgentApp({ def, texts, slots, footer, extras, loadErrorHint }: AgentAppProps) {
63
- const host = useAppHost(def);
64
- if (host.loadError) {
65
- return (
66
- <div className="center">
67
- <p>无法连接服务:{host.loadError}</p>
68
- {loadErrorHint}
69
- </div>
70
- );
71
- }
72
- if (!host.ready) return <div className="center">加载中…</div>;
73
-
74
- const { branding, who, qual, route, shown, onQuals, persona, go, ctx } = host;
75
- // 坞是否撑满内容区。同一个判据喂给 Dock.full 与 AgentChatApp.compact
76
- // (2026-11-03:以前 compact 单独判「路由不是聊天页」,漏了选项页这种
77
- // 「路由还是 chatRoute 但坞不是全屏」的状态,会话侧栏把输入框挤成 56px)。
78
- const dockFull = !onQuals && route === def.chatRoute;
79
- const t = texts(branding, persona);
80
-
81
- return (
82
- <div className="shell" style={themeVarsOf(branding)}>
83
- <AppShell
84
- branding={branding}
85
- qual={qual}
86
- route={shown}
87
- nav={def.navItems(ctx!)}
88
- who={who}
89
- // 侧栏导航回聊天路由 = 回**默认人格**(2026-11-04):从声明人格切「默认助手」时只改
90
- // 路由的话,人格还挂在声明人格上,标题/预备问题都不换。人格化入口(人格化按钮)
91
- // 走 host.go 自己先 setPersona,不经过这里,所以不会被这条冲掉。
92
- onRoute={(r) => {
93
- if (r === def.chatRoute && host.persona) host.setPersona("");
94
- go(r);
95
- }}
96
- onQuals={() => go("quals")}
97
- switchTitle={def.labels?.switchTitle}
98
- footer={footer?.(host)}
99
- >
100
- <DockPanel
101
- title={t.title}
102
- full={dockFull}
103
- onClose={host.closeChat}
104
- chat={
105
- <AgentChatApp
106
- // key 让切人格时重挂:会话绑死人格,同一个实例换 persona 只会撞 persona_mismatch。
107
- key={persona}
108
- branding={branding}
109
- scope={qual?.id}
110
- renderCard={def.cardRenderer}
111
- slots={slots}
112
- // core 只做形状收敛("" → undefined = 产品默认助手),不认识具体名字。
113
- persona={persona || undefined}
114
- title={t.title}
115
- assistantLabel={t.assistantLabel}
116
- policyNote={t.policyNote}
117
- welcome={t.welcome}
118
- suggestions={t.suggestions}
119
- compact={!dockFull}
120
- />
121
- }
122
- >
123
- {def.page(ctx!)}
124
- </DockPanel>
125
- {/* 宿主级、只在 boot 拉一次的东西(每日总结弹窗等):切路由不该让它重挂。 */}
126
- {extras?.(host)}
127
- </AppShell>
128
- </div>
129
- );
130
- }
1
+ /**
2
+ * 组合根的通用实现(接缝的最后一层,2026-11-03)。
3
+ *
4
+ * 以前这份接线长在 `apps/web/src/App.tsx` 里(113 行),产品事实与机械传参
5
+ * 混在一处——第二个产品只能**把整份文件复制走再改 import**。这里把机械部分
6
+ * 收进 core,产品只保留自己的事实(导航注册表、文案兜底、侧栏入口、宿主级组件)。
7
+ *
8
+ * 插槽契约(照抄时最容易踩的一条):
9
+ * `footer` / `extras` 是**普通闭包**,不是组件——它们在 AgentApp 的 render
10
+ * 期间被调用,所以里面**不要调用 hook**(要 state 就在产品自己的组件里
11
+ * 用 useState,闭包里只捕获 setter)。
12
+ *
13
+ * 依赖方向恒为 产品 → agent-chat:本文件不 import 任何产品代码。
14
+ */
15
+ import type { ReactNode } from "react";
16
+ import type { BrandingResponse } from "@njuptlzf/agent-chat-protocol";
17
+ import AgentChatApp from "./AgentChatApp.tsx";
18
+ import DockPanel from "./DockPanel.tsx";
19
+ import { AppShell, themeVarsOf, useAppHost, type AppDef } from "./app.tsx";
20
+ import type { Slots } from "./ui/slots.tsx";
21
+
22
+ /** 宿主状态(`useAppHost` 的返回值):插槽从这里取品牌、身份、路由、人格。 */
23
+ export type AppHost = ReturnType<typeof useAppHost>;
24
+
25
+ /** 产品给的界面文案:全由 branding(manifest 声明)与当前人格决定。 */
26
+ export interface AppTexts {
27
+ /** 坞标题(换人格时要换,否则点了「声明人格」还写着「默认助手」)。 */
28
+ title: string;
29
+ /** 助手在界面上的叫法(「正在回答」这类提示语用)。 */
30
+ assistantLabel: string;
31
+ /** 提示条:这个助手是谁、不做什么。 */
32
+ policyNote?: string;
33
+ welcome?: string;
34
+ suggestions?: string[];
35
+ }
36
+
37
+ export interface AgentAppProps {
38
+ /** 导航注册表(产品事实)。 */
39
+ def: AppDef;
40
+ /** 文案兜底:core 不认得任何人格名,也不写死任何一句话。 */
41
+ texts(branding: BrandingResponse, persona: string): AppTexts;
42
+ /**
43
+ * 视觉件槽位覆盖(可插拔):整体替换 Icon / FollowUpSuggestions 等。
44
+ * 组件写结构兼容的形状即可(类型不导出,避免新增公开符号);不传 = 全默认。
45
+ */
46
+ slots?: Partial<Slots>;
47
+ /** 侧栏底部的产品入口(声明人格、反馈问题…)。闭包,不能调 hook。 */
48
+ footer?(host: AppHost): ReactNode;
49
+ /** 宿主级组件(每日总结、反馈抽屉…)。闭包,不能调 hook。 */
50
+ extras?(host: AppHost): ReactNode;
51
+ /** 加载失败时给产品的启动提示(core 不知道启动命令长什么样)。 */
52
+ loadErrorHint?: ReactNode;
53
+ }
54
+
55
+ /**
56
+ * 产品组合根:branding/whoami → 宿主状态 → 侧栏 + 坞 + 页面。
57
+ *
58
+ * 与改造前 `App.tsx` 的行为逐项对齐(full/compact 的判据、key 重挂、插槽位置),
59
+ * 差别只有一处:人格不再由 core 判断"谁是声明人格"——`host.persona` 原样传给
60
+ * `AgentChatApp`("" 收敛成 undefined = 产品默认助手),文案由 `texts` 决定。
61
+ */
62
+ export function AgentApp({ def, texts, slots, footer, extras, loadErrorHint }: AgentAppProps) {
63
+ const host = useAppHost(def);
64
+ if (host.loadError) {
65
+ return (
66
+ <div className="center">
67
+ <p>无法连接服务:{host.loadError}</p>
68
+ {loadErrorHint}
69
+ </div>
70
+ );
71
+ }
72
+ if (!host.ready) return <div className="center">加载中…</div>;
73
+
74
+ const { branding, who, qual, route, shown, onQuals, persona, go, ctx } = host;
75
+ // 坞是否撑满内容区。同一个判据喂给 Dock.full 与 AgentChatApp.compact
76
+ // (2026-11-03:以前 compact 单独判「路由不是聊天页」,漏了选项页这种
77
+ // 「路由还是 chatRoute 但坞不是全屏」的状态,会话侧栏把输入框挤成 56px)。
78
+ const dockFull = !onQuals && route === def.chatRoute;
79
+ const t = texts(branding, persona);
80
+
81
+ return (
82
+ <div className="shell" style={themeVarsOf(branding)}>
83
+ <AppShell
84
+ branding={branding}
85
+ qual={qual}
86
+ route={shown}
87
+ nav={def.navItems(ctx!)}
88
+ who={who}
89
+ // 侧栏导航回聊天路由 = 回**默认人格**(2026-11-04):从声明人格切「默认助手」时只改
90
+ // 路由的话,人格还挂在声明人格上,标题/预备问题都不换。人格化入口(人格化按钮)
91
+ // 走 host.go 自己先 setPersona,不经过这里,所以不会被这条冲掉。
92
+ onRoute={(r) => {
93
+ if (r === def.chatRoute && host.persona) host.setPersona("");
94
+ go(r);
95
+ }}
96
+ onQuals={() => go("quals")}
97
+ switchTitle={def.labels?.switchTitle}
98
+ footer={footer?.(host)}
99
+ >
100
+ <DockPanel
101
+ title={t.title}
102
+ full={dockFull}
103
+ onClose={host.closeChat}
104
+ chat={
105
+ <AgentChatApp
106
+ // key 让切人格时重挂:会话绑死人格,同一个实例换 persona 只会撞 persona_mismatch。
107
+ key={persona}
108
+ branding={branding}
109
+ scope={qual?.id}
110
+ renderCard={def.cardRenderer}
111
+ slots={slots}
112
+ // core 只做形状收敛("" → undefined = 产品默认助手),不认识具体名字。
113
+ persona={persona || undefined}
114
+ title={t.title}
115
+ assistantLabel={t.assistantLabel}
116
+ policyNote={t.policyNote}
117
+ welcome={t.welcome}
118
+ suggestions={t.suggestions}
119
+ compact={!dockFull}
120
+ />
121
+ }
122
+ >
123
+ {def.page(ctx!)}
124
+ </DockPanel>
125
+ {/* 宿主级、只在 boot 拉一次的东西(每日总结弹窗等):切路由不该让它重挂。 */}
126
+ {extras?.(host)}
127
+ </AppShell>
128
+ </div>
129
+ );
130
+ }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 多 phase 成员卡片的默认渲染(W4 / R-010,S6)。
3
+ *
4
+ * 纯展示组件:只吃 `reduceMembers` 的快照,不写状态、不碰协议细节。
5
+ * 通过 Slots 的 `MemberCards` 槽可整体换皮——产品换外观不重写归集逻辑。
6
+ * 档 1(单 phase)没有 member_* 事件,`members` 为空 ⇒ 整个组件返回 null,
7
+ * 用户看到的气泡与 W4 之前逐字相同(I8 的前端半边)。
8
+ */
9
+ import type { MemberView } from "./members.ts";
10
+
11
+ const STATE_LABEL: Record<MemberView["state"], string> = {
12
+ running: "执行中…",
13
+ completed: "✓ 完成",
14
+ failed: "✗ 失败",
15
+ stopped: "已停止",
16
+ blocked: "⛔ 受限",
17
+ };
18
+
19
+ export interface MemberCardsProps {
20
+ readonly members: readonly MemberView[];
21
+ /** 成员 id → 展示名(来自 branding.personas 的 label);缺省回落到 id。 */
22
+ readonly labels?: Readonly<Record<string, string>>;
23
+ }
24
+
25
+ export function MemberCards({ members, labels }: MemberCardsProps) {
26
+ if (members.length === 0) return null;
27
+ return (
28
+ <div className="members" role="group" aria-label="协作成员">
29
+ {members.map((m) => (
30
+ <div className={`member ${m.state}`} key={`${m.phaseId}\u0000${m.memberId}`}>
31
+ <div className="member-head">
32
+ <span className="member-name">{labels?.[m.memberId] ?? m.memberId}</span>
33
+ <span className={`member-state ${m.state}`}>{STATE_LABEL[m.state]}</span>
34
+ </div>
35
+ {m.task && <div className="member-task">{m.task}</div>}
36
+ {m.text && <div className="member-text">{m.text}</div>}
37
+ {m.usage && (
38
+ <div className="member-usage">
39
+ {m.usage.total} tokens
40
+ </div>
41
+ )}
42
+ </div>
43
+ ))}
44
+ </div>
45
+ );
46
+ }
@@ -0,0 +1,106 @@
1
+ /**
2
+ * 多 phase 的成员卡片归集(W4 / R-010,S6):把 SSE 的 `member_*` / `run_done`
3
+ * 事件流折成「谁在跑、各自说了什么、各自花了多少」的状态。
4
+ *
5
+ * 为什么是纯 reducer 而不是塞进 React state:
6
+ * ① 归集逻辑(乱序 done、delta 拼接、runId 切换时重置)是本次最该被测的东西,
7
+ * 纯函数能在**原生 loader**下测(web 测试默认不走 tsx,见 test-stable.mjs);
8
+ * ② adapter.ts 只负责把协议事件分发到 bridge,不认识 UI 形状;
9
+ * ③ UI 组件只渲染快照,不写状态机——与 ConfirmCard / QueueBar 同构。
10
+ *
11
+ * 降级契约:任何不认识的事件类型进 `reduceMembers` 都被安全忽略(返回原状态),
12
+ * 绝不 throw、绝不往成员卡片里塞垃圾。这样平台将来加事件,旧前端不会崩。
13
+ */
14
+ import type { ChatEvent, TokenUsage } from "@njuptlzf/agent-chat-protocol";
15
+
16
+ /** 一个成员的视图状态。 */
17
+ export interface MemberView {
18
+ readonly memberId: string;
19
+ readonly phaseId: string;
20
+ /** running / completed / failed / stopped / blocked。 */
21
+ readonly state: "running" | "completed" | "failed" | "stopped" | "blocked";
22
+ /** 这个成员流式吐出的全部文本(delta 依次拼接)。 */
23
+ readonly text: string;
24
+ /** 交给它的任务文本(member_started 时带)。 */
25
+ readonly task: string;
26
+ /** 该成员自己的 usage;未收口时为空。 */
27
+ readonly usage: TokenUsage | undefined;
28
+ }
29
+
30
+ /** 一次 multi-phase Run 的视图快照。 */
31
+ export interface MembersState {
32
+ /** 当前 runId;切换 Run 时整组重置。 */
33
+ readonly runId: string | undefined;
34
+ readonly members: readonly MemberView[];
35
+ /** Run 收口(run_done)。 */
36
+ readonly done: boolean;
37
+ /** Run 级 usage(run_done 带)。 */
38
+ readonly usage: TokenUsage | undefined;
39
+ }
40
+
41
+ export const emptyMembersState: MembersState = { runId: undefined, members: [], done: false, usage: undefined };
42
+
43
+ const zeroUsage: TokenUsage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0, costUsd: 0 };
44
+
45
+ function isMemberState(s: string): s is MemberView["state"] {
46
+ return s === "running" || s === "completed" || s === "failed" || s === "stopped" || s === "blocked";
47
+ }
48
+
49
+ /**
50
+ * 折一个事件进状态。**纯函数**:不修改 prev,返回新对象(未命中时原样返回 prev)。
51
+ */
52
+ export function reduceMembers(prev: MembersState, ev: ChatEvent): MembersState {
53
+ // 只处理编排事件;其余一律安全忽略(降级契约)。
54
+ if (
55
+ ev.type !== "member_started" &&
56
+ ev.type !== "member_delta" &&
57
+ ev.type !== "member_done" &&
58
+ ev.type !== "run_done"
59
+ ) {
60
+ return prev;
61
+ }
62
+
63
+ // 换 Run 重置:一个 session 里可以连续跑多个 flow,每组成员互不串台。
64
+ const base: MembersState =
65
+ prev.runId === undefined || prev.runId === ev.runId ? prev : emptyMembersState;
66
+
67
+ if (ev.type === "run_done") {
68
+ return { ...base, runId: ev.runId, done: true, usage: ev.usage };
69
+ }
70
+
71
+ const key = (m: MemberView) => `${m.memberId}\u0000${m.phaseId}`;
72
+ const id = `${ev.memberId}\u0000${ev.phaseId}`;
73
+ const at = base.members.findIndex((m) => key(m) === id);
74
+
75
+ if (ev.type === "member_started") {
76
+ // started 可能晚于 delta(乱序)或重复到达:保留已有的 text/usage,只刷新
77
+ // task 与状态为 running。绝不用空串覆盖已经收到的字。
78
+ const next: MemberView = {
79
+ memberId: ev.memberId,
80
+ phaseId: ev.phaseId,
81
+ state: "running",
82
+ text: at === -1 ? "" : base.members[at]!.text,
83
+ task: ev.task,
84
+ usage: at === -1 ? undefined : base.members[at]!.usage,
85
+ };
86
+ const members = at === -1 ? [...base.members, next] : base.members.map((m, i) => (i === at ? next : m));
87
+ return { ...base, runId: ev.runId, members };
88
+ }
89
+
90
+ // delta / done 若在 started 之前到达(乱序),建一个占位成员再更新——
91
+ // 前端不该因为服务端事件顺序抖动就丢字。
92
+ const cur: MemberView =
93
+ at === -1
94
+ ? { memberId: ev.memberId, phaseId: ev.phaseId, state: "running", text: "", task: "", usage: undefined }
95
+ : base.members[at]!;
96
+ const updated: MemberView =
97
+ ev.type === "member_delta"
98
+ ? { ...cur, text: cur.text + ev.delta }
99
+ : {
100
+ ...cur,
101
+ state: isMemberState(ev.state) ? ev.state : "failed",
102
+ usage: ev.usage ?? zeroUsage,
103
+ };
104
+ const members = at === -1 ? [...base.members, updated] : base.members.map((m, i) => (i === at ? updated : m));
105
+ return { ...base, runId: ev.runId, members };
106
+ }
@@ -1,6 +1,7 @@
1
1
  import { createContext, useContext, type ComponentType, type ReactNode } from "react";
2
2
  import { Icon } from "./Icon.tsx";
3
3
  import { FollowUpSuggestions } from "./FollowUpSuggestions.tsx";
4
+ import { MemberCards, type MemberCardsProps } from "./MemberCards.tsx";
4
5
 
5
6
  export interface IconProps {
6
7
  /** 图标值(`branding.ui.icons` 里该槽的字符串);缺省回落内置矢量。 */
@@ -19,9 +20,14 @@ export interface IconProps {
19
20
  export interface Slots {
20
21
  Icon: ComponentType<IconProps>;
21
22
  FollowUpSuggestions: ComponentType;
23
+ /**
24
+ * 多 phase 成员卡片视图(W4)。产品可整体换皮;默认实现消费 `reduceMembers`
25
+ * 的快照。档 1 传空数组 ⇒ 默认实现返回 null,零 DOM、零视觉变化。
26
+ */
27
+ MemberCards: ComponentType<MemberCardsProps>;
22
28
  }
23
29
 
24
- export const defaultSlots: Slots = { Icon, FollowUpSuggestions };
30
+ export const defaultSlots: Slots = { Icon, FollowUpSuggestions, MemberCards };
25
31
 
26
32
  const SlotsContext = createContext<Slots>(defaultSlots);
27
33
  export const SlotsProvider = SlotsContext.Provider;
package/src/styles.css CHANGED
@@ -275,6 +275,19 @@ body {
275
275
  .notice.warning { background: color-mix(in srgb, var(--ac-warn) 20%, var(--ac-card)); }
276
276
  .notice.error { background: color-mix(in srgb, var(--ac-danger) 16%, var(--ac-card)); }
277
277
 
278
+ /* 多 phase 成员卡片(W4):一张卡一个成员,各自流式文本与 usage。 */
279
+ .members { display: flex; flex-direction: column; gap: 8px; padding: 6px 14px 0; }
280
+ .member { border: 1px solid var(--ac-line); border-radius: var(--ac-radius); padding: 8px var(--ac-pad); background: var(--ac-card); }
281
+ .member-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; }
282
+ .member-name { font-weight: 600; font-size: var(--ac-text-sm); }
283
+ .member-state { font-size: var(--ac-text-xs); color: var(--ac-muted); }
284
+ .member-state.completed { color: var(--ac-ok); }
285
+ .member-state.failed { color: var(--ac-danger); }
286
+ .member-state.running { color: var(--ac-primary); }
287
+ .member-task { font-size: var(--ac-text-xs); color: var(--ac-muted); margin-top: 4px; }
288
+ .member-text { white-space: pre-wrap; font-size: var(--ac-text-sm); margin-top: 6px; }
289
+ .member-usage { font-size: var(--ac-text-xs); color: var(--ac-muted); text-align: right; margin-top: 4px; }
290
+
278
291
  .statusbar { padding: 4px 14px; font-size: var(--ac-text-xs); color: var(--ac-muted); text-align: right; }
279
292
 
280
293
  .composer {
@@ -1 +0,0 @@
1
- function r(o){throw new Error('Could not dynamically require "'+o+'". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.')}export{r as c};