@njuptlzf/agent-chat-web 0.1.0 → 0.3.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 (85) hide show
  1. package/dist/AgentChat.d.ts +34 -0
  2. package/dist/AgentChat.js +373 -0
  3. package/dist/AgentChatApp.d.ts +34 -0
  4. package/dist/AgentChatApp.js +90 -0
  5. package/dist/DockPanel.d.ts +22 -0
  6. package/dist/DockPanel.js +22 -0
  7. package/dist/PersonasPage.d.ts +1 -0
  8. package/dist/PersonasPage.js +326 -0
  9. package/dist/adapter.d.ts +52 -0
  10. package/dist/adapter.js +242 -0
  11. package/dist/app-def-check.d.ts +50 -0
  12. package/dist/app-def-check.js +184 -0
  13. package/dist/app.d.ts +112 -0
  14. package/dist/app.js +174 -0
  15. package/dist/assets/_commonjs-dynamic-modules-TDtrdbi3.js +1 -0
  16. package/dist/assets/exceljs.min-jlEt4kSc.js +29 -0
  17. package/dist/assets/index-B7uSE8SM.css +1 -0
  18. package/dist/assets/index-D57mU5H5.js +50 -0
  19. package/dist/assets/index-Dviy7gnB.js +44 -0
  20. package/dist/assets/pdf-CfhDiWmk.js +55 -0
  21. package/dist/assets/pdf.worker.min-CdXBBzB4.js +1 -0
  22. package/dist/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  23. package/dist/auth.d.ts +41 -0
  24. package/dist/auth.js +86 -0
  25. package/dist/dock.d.ts +52 -0
  26. package/dist/dock.js +132 -0
  27. package/dist/docs.d.ts +48 -0
  28. package/dist/docs.js +178 -0
  29. package/dist/index.d.ts +17 -0
  30. package/dist/index.html +13 -0
  31. package/dist/index.js +8 -0
  32. package/dist/mount.d.ts +56 -0
  33. package/dist/mount.js +38 -0
  34. package/dist/qual.d.ts +21 -0
  35. package/dist/qual.js +53 -0
  36. package/dist/sse.d.ts +14 -0
  37. package/dist/sse.js +99 -0
  38. package/dist/styles.css +1492 -0
  39. package/dist/suggestions.d.ts +41 -0
  40. package/dist/suggestions.js +98 -0
  41. package/dist/theme.d.ts +10 -0
  42. package/dist/theme.js +14 -0
  43. package/dist/ui/CodeCopyHeader.d.ts +7 -0
  44. package/dist/ui/CodeCopyHeader.js +22 -0
  45. package/dist/ui/ConfirmCard.d.ts +15 -0
  46. package/dist/ui/ConfirmCard.js +9 -0
  47. package/dist/ui/FollowUpSuggestions.d.ts +9 -0
  48. package/dist/ui/FollowUpSuggestions.js +13 -0
  49. package/dist/ui/Icon.d.ts +8 -0
  50. package/dist/ui/Icon.js +26 -0
  51. package/dist/ui/Lightbox.d.ts +6 -0
  52. package/dist/ui/Lightbox.js +31 -0
  53. package/dist/ui/QueueBar.d.ts +44 -0
  54. package/dist/ui/QueueBar.js +17 -0
  55. package/dist/ui/Splitter.d.ts +27 -0
  56. package/dist/ui/Splitter.js +61 -0
  57. package/dist/ui/ThemeToggle.d.ts +2 -0
  58. package/dist/ui/ThemeToggle.js +16 -0
  59. package/dist/ui/TierPicker.d.ts +14 -0
  60. package/dist/ui/TierPicker.js +54 -0
  61. package/dist/ui/UIPromptCard.d.ts +17 -0
  62. package/dist/ui/UIPromptCard.js +18 -0
  63. package/dist/ui/icons.d.ts +19 -0
  64. package/dist/ui/icons.js +25 -0
  65. package/dist/ui/slots.d.ts +23 -0
  66. package/dist/ui/slots.js +13 -0
  67. package/dist/ui/timefmt.d.ts +35 -0
  68. package/dist/ui/timefmt.js +110 -0
  69. package/dist/ui/useNarrow.d.ts +7 -0
  70. package/dist/ui/useNarrow.js +15 -0
  71. package/package.json +14 -11
  72. package/src/App.tsx +13 -0
  73. package/src/agent-chat/AgentChat.tsx +39 -2
  74. package/src/agent-chat/AgentChatApp.tsx +5 -0
  75. package/src/agent-chat/{Dock.tsx → DockPanel.tsx} +73 -73
  76. package/src/agent-chat/PersonasPage.tsx +28 -1
  77. package/src/agent-chat/mount.tsx +130 -123
  78. package/src/agent-chat/suggestions.ts +127 -0
  79. package/src/agent-chat/ui/FollowUpSuggestions.tsx +28 -0
  80. package/src/agent-chat/ui/Icon.tsx +53 -0
  81. package/src/agent-chat/ui/icons.ts +31 -0
  82. package/src/agent-chat/ui/slots.tsx +35 -0
  83. package/src/fake-product/entry.tsx +63 -0
  84. package/src/main.tsx +8 -0
  85. package/src/styles.css +15 -1
@@ -1,6 +1,7 @@
1
1
  import { useCallback, useEffect, useState } from "react";
2
2
  import { apiHeaders, auth } from "./auth.ts";
3
3
  import { fetchJson } from "./sse.ts";
4
+ import type { FollowUpMode } from "./suggestions.ts";
4
5
  import { fmtTime } from "./ui/timefmt.ts";
5
6
 
6
7
  /**
@@ -32,6 +33,8 @@ interface ListResponse {
32
33
  problems: string[];
33
34
  /** 默认助手的人格 id:页面用它区分"哪些展示字段真的画得出来"。 */
34
35
  defaultPersona: string;
36
+ /** 下一步建议的全局模式(只读):全局 off 是硬地板,页面据此禁用人格级下拉。 */
37
+ globalFollowUpMode?: FollowUpMode;
35
38
  personas: PersonaRow[];
36
39
  }
37
40
 
@@ -97,7 +100,9 @@ interface TrialResponse {
97
100
  ms: number;
98
101
  }
99
102
 
100
- const UI_FIELDS: Array<{ key: string; label: string; multiline?: boolean; list?: boolean }> = [
103
+ const FOLLOW_UP_OPTIONS: readonly string[] = ["off", "static", "llm"];
104
+
105
+ const UI_FIELDS: Array<{ key: string; label: string; multiline?: boolean; list?: boolean; options?: readonly string[] }> = [
101
106
  { key: "label", label: "入口名" },
102
107
  { key: "icon", label: "图标" },
103
108
  { key: "tag", label: "标签" },
@@ -108,6 +113,8 @@ const UI_FIELDS: Array<{ key: string; label: string; multiline?: boolean; list?:
108
113
  { key: "policyNote", label: "常驻提示条", multiline: true },
109
114
  // 快捷问法是一组(表里叫 suggestions):一行一条,空行忽略。
110
115
  { key: "suggestions", label: "快捷问法(一行一条)", multiline: true, list: true },
116
+ // 轮次结束后的下一步建议:闭合三态,用下拉而不是文本框——打错值会被服务端 400。
117
+ { key: "followUpMode", label: "下一步建议", options: FOLLOW_UP_OPTIONS },
111
118
  ];
112
119
 
113
120
  const SOURCE_TEXT: Record<string, string> = { manifest: "manifest", file: "已改", draft: "草稿" };
@@ -466,6 +473,26 @@ export default function PersonasPage() {
466
473
  }
467
474
  setUi(next);
468
475
  };
476
+ // 闭合枚举用下拉:空项 = 清掉覆盖回落出厂值(manifest 值就是默认值)。
477
+ if (f.options) {
478
+ const globalOff = list?.globalFollowUpMode === "off";
479
+ return (
480
+ <>
481
+ <select
482
+ data-field={f.key}
483
+ value={value}
484
+ disabled={globalOff}
485
+ onChange={(e) => onChange(e.target.value)}
486
+ >
487
+ <option value="">{placeholder ? `用出厂值(${placeholder})` : "用出厂值 / 跟随全局"}</option>
488
+ {f.options.map((o) => (
489
+ <option key={o} value={o}>{o}</option>
490
+ ))}
491
+ </select>
492
+ {globalOff && <span>全局已关闭,此项暂不生效</span>}
493
+ </>
494
+ );
495
+ }
469
496
  return f.multiline ? (
470
497
  <textarea
471
498
  data-field={f.key}
@@ -1,123 +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 Dock from "./Dock.tsx";
19
- import { AppShell, themeVarsOf, useAppHost, type AppDef } from "./app.tsx";
20
-
21
- /** 宿主状态(`useAppHost` 的返回值):插槽从这里取品牌、身份、路由、人格。 */
22
- export type AppHost = ReturnType<typeof useAppHost>;
23
-
24
- /** 产品给的界面文案:全由 branding(manifest 声明)与当前人格决定。 */
25
- export interface AppTexts {
26
- /** 坞标题(换人格时要换,否则点了「声明人格」还写着「默认助手」)。 */
27
- title: string;
28
- /** 助手在界面上的叫法(「正在回答」这类提示语用)。 */
29
- assistantLabel: string;
30
- /** 提示条:这个助手是谁、不做什么。 */
31
- policyNote?: string;
32
- welcome?: string;
33
- suggestions?: string[];
34
- }
35
-
36
- export interface AgentAppProps {
37
- /** 导航注册表(产品事实)。 */
38
- def: AppDef;
39
- /** 文案兜底:core 不认得任何人格名,也不写死任何一句话。 */
40
- texts(branding: BrandingResponse, persona: string): AppTexts;
41
- /** 侧栏底部的产品入口(声明人格、反馈问题…)。闭包,不能调 hook。 */
42
- footer?(host: AppHost): ReactNode;
43
- /** 宿主级组件(每日总结、反馈抽屉…)。闭包,不能调 hook。 */
44
- extras?(host: AppHost): ReactNode;
45
- /** 加载失败时给产品的启动提示(core 不知道启动命令长什么样)。 */
46
- loadErrorHint?: ReactNode;
47
- }
48
-
49
- /**
50
- * 产品组合根:branding/whoami → 宿主状态 → 侧栏 + 坞 + 页面。
51
- *
52
- * 与改造前 `App.tsx` 的行为逐项对齐(full/compact 的判据、key 重挂、插槽位置),
53
- * 差别只有一处:人格不再由 core 判断"谁是声明人格"——`host.persona` 原样传给
54
- * `AgentChatApp`("" 收敛成 undefined = 产品默认助手),文案由 `texts` 决定。
55
- */
56
- export function AgentApp({ def, texts, footer, extras, loadErrorHint }: AgentAppProps) {
57
- const host = useAppHost(def);
58
- if (host.loadError) {
59
- return (
60
- <div className="center">
61
- <p>无法连接服务:{host.loadError}</p>
62
- {loadErrorHint}
63
- </div>
64
- );
65
- }
66
- if (!host.ready) return <div className="center">加载中…</div>;
67
-
68
- const { branding, who, qual, route, shown, onQuals, persona, go, ctx } = host;
69
- // 坞是否撑满内容区。同一个判据喂给 Dock.full 与 AgentChatApp.compact
70
- // (2026-11-03:以前 compact 单独判「路由不是聊天页」,漏了选项页这种
71
- // 「路由还是 chatRoute 但坞不是全屏」的状态,会话侧栏把输入框挤成 56px)。
72
- const dockFull = !onQuals && route === def.chatRoute;
73
- const t = texts(branding, persona);
74
-
75
- return (
76
- <div className="shell" style={themeVarsOf(branding)}>
77
- <AppShell
78
- branding={branding}
79
- qual={qual}
80
- route={shown}
81
- nav={def.navItems(ctx!)}
82
- who={who}
83
- // 侧栏导航回聊天路由 = 回**默认人格**(2026-11-04):从声明人格切「默认助手」时只改
84
- // 路由的话,人格还挂在声明人格上,标题/预备问题都不换。人格化入口(人格化按钮)
85
- // 走 host.go 自己先 setPersona,不经过这里,所以不会被这条冲掉。
86
- onRoute={(r) => {
87
- if (r === def.chatRoute && host.persona) host.setPersona("");
88
- go(r);
89
- }}
90
- onQuals={() => go("quals")}
91
- switchTitle={def.labels?.switchTitle}
92
- footer={footer?.(host)}
93
- >
94
- <Dock
95
- title={t.title}
96
- full={dockFull}
97
- onClose={host.closeChat}
98
- chat={
99
- <AgentChatApp
100
- // key 让切人格时重挂:会话绑死人格,同一个实例换 persona 只会撞 persona_mismatch。
101
- key={persona}
102
- branding={branding}
103
- scope={qual?.id}
104
- renderCard={def.cardRenderer}
105
- // core 只做形状收敛("" → undefined = 产品默认助手),不认识具体名字。
106
- persona={persona || undefined}
107
- title={t.title}
108
- assistantLabel={t.assistantLabel}
109
- policyNote={t.policyNote}
110
- welcome={t.welcome}
111
- suggestions={t.suggestions}
112
- compact={!dockFull}
113
- />
114
- }
115
- >
116
- {def.page(ctx!)}
117
- </Dock>
118
- {/* 宿主级、只在 boot 拉一次的东西(每日总结弹窗等):切路由不该让它重挂。 */}
119
- {extras?.(host)}
120
- </AppShell>
121
- </div>
122
- );
123
- }
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,127 @@
1
+ /**
2
+ * 「下一步建议」的前端层:生效模式解析 + 自定义 `SuggestionAdapter`。
3
+ *
4
+ * 挂载走 `@assistant-ui` 原生 `adapters.suggestion`(run 结束自动生成、run 开始
5
+ * 自动清空),不自造状态机。数据来源由服务端决定:`llm` 调 `/api/suggestions`,
6
+ * `static` 直接用 `branding.ui.followUp.static`;任何失败静默返回空——建议区
7
+ * 消失而不是报错。
8
+ */
9
+ import type { BrandingResponse } from "@njuptlzf/agent-chat-protocol";
10
+ import type { SuggestionAdapter, ThreadSuggestion } from "@assistant-ui/react";
11
+ import { apiHeaders, auth } from "./auth.ts";
12
+
13
+ export type FollowUpMode = "off" | "static" | "llm";
14
+ const MODES: readonly FollowUpMode[] = ["off", "static", "llm"];
15
+ const isMode = (v: unknown): v is FollowUpMode =>
16
+ typeof v === "string" && (MODES as readonly string[]).includes(v);
17
+
18
+ /**
19
+ * 与服务端 `SUGGESTIONS_DEFAULTS` 各持一份的缺省值(两个包不共享模块,
20
+ * 单测钉住两边一致)——改这里要同步那边。
21
+ */
22
+ export const FOLLOW_UP_DEFAULTS = {
23
+ count: 3,
24
+ maxMessages: 10,
25
+ messageChars: 500,
26
+ totalChars: 4000,
27
+ } as const;
28
+
29
+ /** 解析后的下一步建议配置(服务端已校验,这里再兜一道)。 */
30
+ export interface FollowUpConfig {
31
+ count: number;
32
+ maxMessages: number;
33
+ staticFallback: string[];
34
+ }
35
+
36
+ /** `branding.ui.followUp` 的声明形状(BrandingUi 未导出,用索引访问拿类型)。 */
37
+ type FollowUpDecl = NonNullable<BrandingResponse["ui"]>["followUp"];
38
+
39
+ /** `branding.ui.followUp` → 前端配置;缺字段走缺省,非法值回落。 */
40
+ export function followUpConfigOf(decl?: FollowUpDecl): FollowUpConfig {
41
+ const count =
42
+ typeof decl?.count === "number" && Number.isInteger(decl.count) && decl.count >= 1 && decl.count <= 5
43
+ ? decl.count
44
+ : FOLLOW_UP_DEFAULTS.count;
45
+ const maxMessages =
46
+ typeof decl?.maxMessages === "number" && Number.isInteger(decl.maxMessages) && decl.maxMessages >= 1 && decl.maxMessages <= 20
47
+ ? decl.maxMessages
48
+ : FOLLOW_UP_DEFAULTS.maxMessages;
49
+ const staticFallback = Array.isArray(decl?.static)
50
+ ? decl.static.filter((s): s is string => typeof s === "string" && s.trim() !== "").map((s) => s.trim())
51
+ : [];
52
+ return { count, maxMessages, staticFallback };
53
+ }
54
+
55
+ /**
56
+ * 生效模式:**全局 `off` 是硬地板**——全局关掉后任何人格都不能重新打开;
57
+ * 否则人格 `followUpMode` > 全局 `mode` > 缺省 `llm`。默认助手(persona 为
58
+ * undefined)用 `branding.defaultPersona` 兜底;该人格不在 personas 表里时回落全局。
59
+ * 服务端 `/api/suggestions` 用同一套优先级复核,两边必须一致。
60
+ */
61
+ export function resolveFollowUpMode(branding: BrandingResponse, persona?: string): FollowUpMode {
62
+ const globalMode: FollowUpMode = isMode(branding.ui?.followUp?.mode) ? branding.ui.followUp.mode : "llm";
63
+ if (globalMode === "off") return "off";
64
+ const id = persona ?? branding.defaultPersona;
65
+ const perPersona = id ? branding.personas?.[id]?.followUpMode : undefined;
66
+ return isMode(perPersona) ? perPersona : globalMode;
67
+ }
68
+
69
+ /** 只留文本 part(图片/附件/工具细节不出前端),再套单条与总量上限。 */
70
+ function clipForRequest(
71
+ messages: readonly { role: string; content: readonly { type?: string; text?: unknown }[] }[],
72
+ maxMessages: number,
73
+ ): { role: string; text: string }[] {
74
+ const kept: { role: string; text: string }[] = [];
75
+ for (const message of messages) {
76
+ if (message.role !== "user" && message.role !== "assistant") continue;
77
+ for (const part of message.content ?? []) {
78
+ if (part?.type !== "text" || typeof part.text !== "string") continue;
79
+ const text = part.text.trim();
80
+ if (!text) continue;
81
+ kept.push({ role: message.role, text: text.slice(0, FOLLOW_UP_DEFAULTS.messageChars) });
82
+ }
83
+ }
84
+ const window = kept.slice(-Math.max(1, maxMessages));
85
+ let total = 0;
86
+ const out: { role: string; text: string }[] = [];
87
+ for (let i = window.length - 1; i >= 0; i--) {
88
+ total += window[i]!.text.length;
89
+ if (total > FOLLOW_UP_DEFAULTS.totalChars) break;
90
+ out.unshift(window[i]!);
91
+ }
92
+ return out;
93
+ }
94
+
95
+ /** `off` 不产生 adapter(库不生成建议);`static` 本地返回、`llm` 请求服务端。 */
96
+ export function createFollowUpAdapter(
97
+ cfg: FollowUpConfig,
98
+ mode: Exclude<FollowUpMode, "off">,
99
+ personaId?: string,
100
+ ): SuggestionAdapter {
101
+ if (mode === "static") {
102
+ const suggestions: readonly ThreadSuggestion[] = cfg.staticFallback.slice(0, cfg.count).map((prompt) => ({ prompt }));
103
+ return { generate: () => Promise.resolve(suggestions) };
104
+ }
105
+ return {
106
+ async generate({ messages, signal }) {
107
+ try {
108
+ // 不用 postJson(不带 signal):这里的 abort 由库的 suggestion controller 驱动。
109
+ const res = await fetch("/api/suggestions", {
110
+ method: "POST",
111
+ headers: { "content-type": "application/json", ...apiHeaders(auth.token) },
112
+ body: JSON.stringify({ messages: clipForRequest(messages, cfg.maxMessages), persona: personaId }),
113
+ signal,
114
+ });
115
+ if (!res.ok) return [];
116
+ const data = (await res.json()) as { suggestions?: unknown };
117
+ if (!Array.isArray(data.suggestions)) return [];
118
+ return data.suggestions
119
+ .filter((s): s is string => typeof s === "string" && s.trim() !== "")
120
+ .slice(0, cfg.count)
121
+ .map((prompt) => ({ prompt }));
122
+ } catch {
123
+ return [];
124
+ }
125
+ },
126
+ };
127
+ }
@@ -0,0 +1,28 @@
1
+ import { ThreadPrimitive } from "@assistant-ui/react";
2
+
3
+ /**
4
+ * 轮次结束后的「下一步建议」条。数据由库的 suggestion adapter 生成(run 结束自动
5
+ * 触发、run 开始自动清空),这里只负责渲染。必须渲染在 `ThreadPrimitive.Root` 内。
6
+ *
7
+ * `ThreadPrimitive.Suggestions` 本身不渲染包裹元素(空建议时返回 null),所以这里
8
+ * 提供一层 `.ac-followup` 容器;容器空时由 CSS `:empty` 收起,不留空白条。
9
+ * 点击即发送(`send`),与空态快捷问法 chips 的行为一致。
10
+ */
11
+ export function FollowUpSuggestions() {
12
+ return (
13
+ <div className="ac-followup">
14
+ <ThreadPrimitive.Suggestions>
15
+ {({ suggestion }) => (
16
+ <ThreadPrimitive.Suggestion
17
+ className="ac-followup-chip"
18
+ prompt={suggestion.prompt}
19
+ send
20
+ title={suggestion.prompt}
21
+ >
22
+ {suggestion.title}
23
+ </ThreadPrimitive.Suggestion>
24
+ )}
25
+ </ThreadPrimitive.Suggestions>
26
+ </div>
27
+ );
28
+ }
@@ -0,0 +1,53 @@
1
+ import type { ReactNode } from "react";
2
+ import { parseIconSpec, type BuiltinSvgName } from "./icons.ts";
3
+
4
+ /**
5
+ * 内置 SVG(24×24 线框,stroke 走 currentColor 跟随主题,不引任何图标库)。
6
+ * 用惰性函数而不是模块级 JSX 常量:node 侧测试经 tsx 加载本模块时用的是
7
+ * classic JSX 运行时,模块级 JSX 会在 import 期执行 `React.createElement`
8
+ * 直接炸掉;渲染期执行就没有这个问题(浏览器走 react-jsx 自动运行时)。
9
+ */
10
+ const PATHS: Record<BuiltinSvgName, () => ReactNode> = {
11
+ paperclip: () => (
12
+ <path d="M21.44 11.05l-9.19 9.19a6 6 0 0 1-8.49-8.49l9.19-9.19a4 4 0 0 1 5.66 5.66l-9.2 9.19a2 2 0 0 1-2.83-2.83l8.49-8.48" />
13
+ ),
14
+ plus: () => <path d="M12 5v14M5 12h14" />,
15
+ image: () => (
16
+ <>
17
+ <rect x="3" y="3" width="18" height="18" rx="2" ry="2" />
18
+ <circle cx="8.5" cy="8.5" r="1.5" />
19
+ <polyline points="21 15 16 10 5 21" />
20
+ </>
21
+ ),
22
+ upload: () => (
23
+ <>
24
+ <path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4" />
25
+ <polyline points="17 8 12 3 7 8" />
26
+ <line x1="12" y1="3" x2="12" y2="15" />
27
+ </>
28
+ ),
29
+ };
30
+
31
+ /**
32
+ * 槽位用的图标渲染器。svg 走白名单 JSX(绝不用 dangerouslySetInnerHTML)、
33
+ * 文本走 React 文本节点、url 走 `<img>`(协议已在 parseIconSpec 校验)。
34
+ */
35
+ export function Icon({ spec, className = "ac-icon" }: { spec?: string; className?: string }) {
36
+ const icon = parseIconSpec(spec);
37
+ if (icon.kind === "url") return <img className={className} src={icon.href} alt="" />;
38
+ if (icon.kind === "text") return <span className={className} aria-hidden="true">{icon.text}</span>;
39
+ return (
40
+ <svg
41
+ className={className}
42
+ viewBox="0 0 24 24"
43
+ fill="none"
44
+ stroke="currentColor"
45
+ strokeWidth={2}
46
+ strokeLinecap="round"
47
+ strokeLinejoin="round"
48
+ aria-hidden="true"
49
+ >
50
+ {PATHS[icon.name]()}
51
+ </svg>
52
+ );
53
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ * 图标值解析:`branding.ui.icons.<槽名>` 的一个字符串怎么画。
3
+ * 三种形态:`svg:<内置名>` / `url:https?://…`(图片地址)/ 其它非空字符串(emoji 或短文本)。
4
+ * 任何非法值都回落默认矢量——图标坏了不该让界面报错,也不该引入任何 HTML 注入面。
5
+ */
6
+ const BUILTIN_SVGS = ["paperclip", "plus", "image", "upload"] as const;
7
+ export type BuiltinSvgName = (typeof BUILTIN_SVGS)[number];
8
+
9
+ export type IconDescriptor =
10
+ | { kind: "svg"; name: BuiltinSvgName }
11
+ | { kind: "url"; href: string }
12
+ | { kind: "text"; text: string };
13
+
14
+ const DEFAULT_ICON: IconDescriptor = { kind: "svg", name: "paperclip" };
15
+ const MAX_TEXT = 8;
16
+
17
+ export function parseIconSpec(spec: string | undefined | null): IconDescriptor {
18
+ if (spec === undefined || spec === null) return DEFAULT_ICON;
19
+ const value = spec.trim();
20
+ if (!value) return DEFAULT_ICON;
21
+ if (value.startsWith("svg:")) {
22
+ const name = value.slice(4).trim() as BuiltinSvgName;
23
+ return (BUILTIN_SVGS as readonly string[]).includes(name) ? { kind: "svg", name } : DEFAULT_ICON;
24
+ }
25
+ if (value.startsWith("url:")) {
26
+ const href = value.slice(4).trim();
27
+ // 只放行 http(s);相对路径与其它协议一律回落默认(纵深防御,前端兜一道)。
28
+ return /^https?:\/\/\S+$/i.test(href) ? { kind: "url", href } : DEFAULT_ICON;
29
+ }
30
+ return { kind: "text", text: value.length > MAX_TEXT ? value.slice(0, MAX_TEXT) : value };
31
+ }
@@ -0,0 +1,35 @@
1
+ import { createContext, useContext, type ComponentType, type ReactNode } from "react";
2
+ import { Icon } from "./Icon.tsx";
3
+ import { FollowUpSuggestions } from "./FollowUpSuggestions.tsx";
4
+
5
+ export interface IconProps {
6
+ /** 图标值(`branding.ui.icons` 里该槽的字符串);缺省回落内置矢量。 */
7
+ spec?: string;
8
+ }
9
+
10
+ /**
11
+ * 聊天壳的视觉件槽位注册表:所有视觉件要么是 assistant-ui 原生原语,要么是
12
+ * 这里登记的可替换自定义组件——壳体 JSX 不写死字形、不自造建议状态机。
13
+ *
14
+ * `Slots` / `IconProps` **故意不进公共 barrel**(不新增公开导出符号):产品要
15
+ * 整体换皮时,在 `AgentApp` 的 `slots` 里传结构兼容的组件即可,TS 自动对上。
16
+ * 槽组件渲染在 `AssistantRuntimeProvider`(`FollowUpSuggestions` 还在
17
+ * `ThreadPrimitive.Root`)之内,可直接使用库原语;不得反向 import 平台内部路径。
18
+ */
19
+ export interface Slots {
20
+ Icon: ComponentType<IconProps>;
21
+ FollowUpSuggestions: ComponentType;
22
+ }
23
+
24
+ export const defaultSlots: Slots = { Icon, FollowUpSuggestions };
25
+
26
+ const SlotsContext = createContext<Slots>(defaultSlots);
27
+ export const SlotsProvider = SlotsContext.Provider;
28
+ export function useSlots(): Slots {
29
+ return useContext(SlotsContext);
30
+ }
31
+
32
+ /** 纯函数:默认槽位 + 局部覆盖(未覆盖的槽保持默认),不渲染 DOM 即可单测。 */
33
+ export function resolveSlots(overrides?: Partial<Slots>): Slots {
34
+ return { ...defaultSlots, ...overrides };
35
+ }