@webority/chat-react 0.128.0 → 0.134.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 (90) hide show
  1. package/dist/chat-react.js +14 -11
  2. package/dist/types/ChatAgentTyping.d.ts +4 -0
  3. package/dist/types/ChatAuthorBadge.d.ts +4 -0
  4. package/dist/types/ChatComposer.d.ts +10 -0
  5. package/dist/types/ChatConversationActions.d.ts +7 -0
  6. package/dist/types/ChatEmbed.d.ts +5 -0
  7. package/dist/types/ChatExplain.d.ts +16 -0
  8. package/dist/types/ChatFooter.d.ts +8 -0
  9. package/dist/types/ChatFrame.d.ts +26 -0
  10. package/dist/types/ChatHistory.d.ts +9 -0
  11. package/dist/types/ChatLauncher.d.ts +5 -0
  12. package/dist/types/ChatLiveStatus.d.ts +4 -0
  13. package/dist/types/ChatMessageActions.d.ts +10 -0
  14. package/dist/types/ChatNudge.d.ts +10 -0
  15. package/dist/types/ChatOpenTickets.d.ts +9 -0
  16. package/dist/types/ChatPage.d.ts +49 -0
  17. package/dist/types/ChatPanel.d.ts +9 -0
  18. package/dist/types/ChatPastChats.d.ts +9 -0
  19. package/dist/types/ChatReadAloudButton.d.ts +8 -0
  20. package/dist/types/ChatShell.d.ts +32 -0
  21. package/dist/types/ChatStarters.d.ts +8 -0
  22. package/dist/types/ChatThread.d.ts +15 -0
  23. package/dist/types/chatLive.d.ts +5 -0
  24. package/dist/types/chatPrint.d.ts +6 -0
  25. package/dist/types/chatShared.d.ts +10 -0
  26. package/dist/types/dictationText.d.ts +31 -0
  27. package/dist/types/index.d.ts +20 -14
  28. package/dist/types/loaders/ChatLoader.d.ts +21 -0
  29. package/dist/types/loaders/OrbLoader.d.ts +11 -0
  30. package/dist/types/loaders/PhrasesLoader.d.ts +14 -0
  31. package/dist/types/loaders/SkeletonLoader.d.ts +11 -0
  32. package/dist/types/loaders/StepsLoader.d.ts +12 -0
  33. package/dist/types/loaders/TypingPill.d.ts +12 -0
  34. package/dist/types/recaptcha.d.ts +2 -0
  35. package/dist/types/renderers/ActionPart.d.ts +4 -0
  36. package/dist/types/renderers/ChartPart.d.ts +4 -0
  37. package/dist/types/renderers/ChatLinkContext.d.ts +8 -0
  38. package/dist/types/renderers/FigureText.d.ts +5 -0
  39. package/dist/types/renderers/FiguresPart.d.ts +4 -0
  40. package/dist/types/renderers/FilePart.d.ts +4 -0
  41. package/dist/types/renderers/HandoffPart.d.ts +4 -0
  42. package/dist/types/renderers/ImagePart.d.ts +4 -0
  43. package/dist/types/renderers/InputRequestPart.d.ts +5 -0
  44. package/dist/types/renderers/NoticePart.d.ts +3 -0
  45. package/dist/types/renderers/QuickRepliesPart.d.ts +4 -0
  46. package/dist/types/renderers/RecordCardPart.d.ts +4 -0
  47. package/dist/types/renderers/SourcesPart.d.ts +4 -0
  48. package/dist/types/renderers/TablePart.d.ts +4 -0
  49. package/dist/types/renderers/TextPart.d.ts +5 -0
  50. package/dist/types/renderers/TicketPart.d.ts +4 -0
  51. package/dist/types/renderers/VoiceClipPart.d.ts +7 -0
  52. package/dist/types/renderers/index.d.ts +32 -0
  53. package/dist/types/useAutoOpen.d.ts +11 -0
  54. package/dist/types/useChat.d.ts +34 -76
  55. package/dist/types/useChatDictation.d.ts +24 -0
  56. package/dist/types/useChatExplain.d.ts +57 -0
  57. package/dist/types/useChatHandoff.d.ts +19 -0
  58. package/dist/types/useChatReadAloud.d.ts +16 -0
  59. package/dist/types/useChatSound.d.ts +7 -0
  60. package/dist/types/useChatSpeech.d.ts +7 -0
  61. package/dist/types/useLauncherAvoid.d.ts +1 -0
  62. package/dist/types/useReducedMotion.d.ts +1 -0
  63. package/dist/types/useTranscriptActions.d.ts +12 -0
  64. package/package.json +18 -20
  65. package/README.md +0 -320
  66. package/dist/guidance.json +0 -216
  67. package/dist/types/ChatMarkdown.meta.d.ts +0 -31
  68. package/dist/types/components/ActionCard.d.ts +0 -27
  69. package/dist/types/components/ActionCard.meta.d.ts +0 -89
  70. package/dist/types/components/ChatComposer.d.ts +0 -38
  71. package/dist/types/components/ChatComposer.meta.d.ts +0 -56
  72. package/dist/types/components/ChatConversationList.d.ts +0 -20
  73. package/dist/types/components/ChatConversationList.meta.d.ts +0 -37
  74. package/dist/types/components/ChatLauncher.d.ts +0 -31
  75. package/dist/types/components/ChatLauncher.meta.d.ts +0 -50
  76. package/dist/types/components/ChatMessage.d.ts +0 -61
  77. package/dist/types/components/ChatMessage.meta.d.ts +0 -173
  78. package/dist/types/components/ChatPanel.d.ts +0 -74
  79. package/dist/types/components/ChatPanel.meta.d.ts +0 -228
  80. package/dist/types/components/ChatThread.d.ts +0 -54
  81. package/dist/types/components/ChatThread.meta.d.ts +0 -151
  82. package/dist/types/components/CitationChip.d.ts +0 -15
  83. package/dist/types/components/CitationChip.meta.d.ts +0 -48
  84. package/dist/types/components/ComposerAttachments.d.ts +0 -14
  85. package/dist/types/components/ConfirmCard.d.ts +0 -24
  86. package/dist/types/components/ConfirmCard.meta.d.ts +0 -43
  87. package/dist/types/components/ReplyRating.d.ts +0 -16
  88. package/dist/types/components/ReplyRating.meta.d.ts +0 -34
  89. package/dist/types/markdown.d.ts +0 -22
  90. /package/{LICENSE → LICENSE.txt} +0 -0
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Applies a hand-over from the page that opened the chat: a conversation to open and a draft to fill.
3
+ * It is read once, when the chat mounts; a later handoff is not applied. The ref guard keeps a
4
+ * StrictMode replay from applying it twice.
5
+ *
6
+ * @param {import("@webority/chat-core").ChatSessionState & { openConversation: (id: string) => Promise<void>, session: { open: (options: { draft?: string }) => void } }} chat
7
+ * @param {{ conversationId?: string | null, draft?: string | null } | null | undefined} handoff
8
+ */
9
+ export default function useChatHandoff(chat: import("@webority/chat-core").ChatSessionState & {
10
+ openConversation: (id: string) => Promise<void>;
11
+ session: {
12
+ open: (options: {
13
+ draft?: string;
14
+ }) => void;
15
+ };
16
+ }, handoff: {
17
+ conversationId?: string | null;
18
+ draft?: string | null;
19
+ } | null | undefined): void;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Read-aloud for one message: speaks its text through the speech adapter and reports whether it is speaking or failed.
3
+ *
4
+ * @param {object} options
5
+ * @param {import('@webority/chat-core').ChatSpeechAdapter | null} options.speech
6
+ * @param {boolean} options.enabled
7
+ */
8
+ export default function useChatReadAloud({ speech, enabled }: {
9
+ speech: import('@webority/chat-core').ChatSpeechAdapter | null;
10
+ enabled: boolean;
11
+ }): {
12
+ available: boolean;
13
+ speaking: boolean;
14
+ failed: boolean;
15
+ toggle: (text: any) => void;
16
+ };
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Plays the open cue when the panel opens, and the sent and reply cues for each new message, as the web element does:
3
+ * a send, an edit and a retry each add a new visitor message, so each plays the sent cue once; an assistant, script or
4
+ * agent message plays the reply cue and vibrates. Restored messages, notices and a history load stay silent. The
5
+ * visitor message that the server's copy replaces after a turn is stored, so it does not play the sent cue again.
6
+ */
7
+ export default function useChatSound(chat: any): void;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * The speech adapter for this chat, or null when the profile has no speech package or neither dictation nor read-aloud is on.
3
+ *
4
+ * @param {object} chat The chat state from useChat.
5
+ * @returns {import('@webority/chat-core').ChatSpeechAdapter | null}
6
+ */
7
+ export default function useChatSpeech(chat: object): import('@webority/chat-core').ChatSpeechAdapter | null;
@@ -0,0 +1 @@
1
+ export default function useLauncherAvoid(ref: any, avoid: any, launcher: any, enabled: any): void;
@@ -0,0 +1 @@
1
+ export default function useReducedMotion(look: any, experience: any): boolean;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Share and print for one reply or the whole conversation, built from the same transcript model.
3
+ */
4
+ export default function useTranscriptActions(chat: any, labels: any): {
5
+ canShare: any;
6
+ canPrint: any;
7
+ notice: null;
8
+ shareReply: (message: any) => Promise<void>;
9
+ printReply: (message: any) => void;
10
+ shareConversation: () => Promise<void>;
11
+ printConversation: () => void;
12
+ };
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@webority/chat-react",
3
- "version": "0.128.0",
4
- "description": "Webority AI assistant for React portals: a streaming chat client, a store-agnostic chat hook, and the launcher, panel, thread, rating and support action card, built on @webority/ui-react.",
5
- "license": "SEE LICENSE IN LICENSE",
3
+ "version": "0.134.0",
4
+ "description": "The Webority Chat React screens: launcher, docked, full-page and embedded shells, thread, composer, one renderer per message part kind and the useChat hook, built on @webority/chat-core and @webority/ui-react.",
5
+ "license": "SEE LICENSE IN LICENSE.txt",
6
6
  "type": "module",
7
7
  "publishConfig": {
8
8
  "access": "public",
@@ -22,19 +22,15 @@
22
22
  "types": "./dist/types/index.d.ts",
23
23
  "default": "./dist/chat-react.js"
24
24
  },
25
- "./package.json": "./package.json",
26
- "./guidance.json": "./dist/guidance.json"
25
+ "./package.json": "./package.json"
27
26
  },
28
27
  "sideEffects": false,
29
- "dependencies": {
30
- "@webority/markdown-core": "0.128.0"
31
- },
32
28
  "peerDependencies": {
33
- "@webority/ui-elements": "0.128.0",
34
- "@webority/ui-react": "0.128.0",
35
- "bootstrap": "5.3.3",
29
+ "@webority/chat-core": "0.134.0",
30
+ "@webority/chat-elements": "0.134.0",
31
+ "@webority/markdown-core": "^0.130.3",
32
+ "@webority/ui-react": "^0.130.3",
36
33
  "react": "^19.0.0",
37
- "react-bootstrap": "^2.10.0",
38
34
  "react-dom": "^19.0.0"
39
35
  },
40
36
  "devDependencies": {
@@ -45,22 +41,24 @@
45
41
  "@types/react": "^19.2.17",
46
42
  "@vitejs/plugin-react": "^6.0.1",
47
43
  "@vitest/coverage-v8": "5.0.1",
48
- "@webority/canvas-kit": "0.128.0",
49
- "@webority/ui-elements": "0.128.0",
50
- "@webority/ui-react": "0.128.0",
44
+ "@webority/analytics": "0.34.0",
45
+ "@webority/chat-core": "0.134.0",
46
+ "@webority/chat-elements": "0.134.0",
47
+ "@webority/markdown-core": "0.130.3",
48
+ "@webority/ui-elements": "0.130.3",
49
+ "@webority/ui-react": "0.130.3",
51
50
  "bootstrap": "5.3.3",
52
51
  "jsdom": "30.1.1",
53
- "react": "^19.2.6",
52
+ "react": "19.2.8",
54
53
  "react-bootstrap": "^2.10.6",
55
- "react-dom": "^19.2.6",
54
+ "react-dom": "19.2.8",
56
55
  "typescript": "^7.0.2",
57
56
  "vite": "^8.0.12",
58
57
  "vitest": "5.0.1"
59
58
  },
60
59
  "scripts": {
61
- "build": "vite build && tsc -p tsconfig.json && node ../canvas-kit/dist/cli.js guidance --config canvas-kit.json --out dist/guidance.json",
60
+ "build": "vite build && tsc -p tsconfig.json",
62
61
  "test": "vitest run",
63
- "test:watch": "vitest",
64
- "test:coverage": "vitest run --coverage"
62
+ "test:watch": "vitest"
65
63
  }
66
64
  }
package/README.md DELETED
@@ -1,320 +0,0 @@
1
- # @webority/chat-react
2
-
3
- An AI assistant for a React portal: a client that streams the assistant's reply, a chat hook with
4
- no store of its own, and the pieces of the assistant's UI (a floating launcher, a side panel, the
5
- conversation, reply ratings, a past-chats list and support action cards). It talks to the chat
6
- endpoint the product's backend hosts with `Webority.Ai.Chat.AspNetCore`, and it is built on
7
- `@webority/ui-react` and `@webority/theme`, so it looks like the rest of the portal with no extra
8
- CSS.
9
-
10
- ## Install
11
-
12
- ```bash
13
- npm install @webority/chat-react @webority/ui-react react-bootstrap bootstrap@5.3.3
14
- ```
15
-
16
- `@webority/ui-react`, `react`, `react-dom`, `react-bootstrap` and `bootstrap` are peer
17
- dependencies: the portal already has them. Pin `@webority/chat-react` to the same exact version as
18
- `@webority/ui-react`.
19
-
20
- ## Wire it up
21
-
22
- Give the client the portal's own axios instance. That instance already carries the bearer token,
23
- the tenant headers and the refresh on 401, so the chat calls sign in the same way as every other
24
- call. The package never handles auth.
25
-
26
- ```jsx
27
- import { ChatLauncher, ChatPanel, createChatClient, useChat } from "@webority/chat-react";
28
- import { createSupportClient } from "@webority/support-react";
29
- import { useState } from "react";
30
- import { Link, useLocation, useNavigate } from "react-router-dom";
31
- import { userClient } from "./services/api/clients";
32
-
33
- const chatClient = createChatClient(userClient, { base: "/api/assistant" });
34
- const supportClient = createSupportClient(userClient, "/api/support");
35
-
36
- // Reply links look like [label](scheme:kind/id); map the ones the product knows to a route.
37
- const resolveLink = (href) => {
38
- const [scheme, rest] = href.split(":");
39
- if (scheme === "ticket") return `/support?ticket=${rest.split("/")[1]}`;
40
- return null;
41
- };
42
-
43
- export function Assistant() {
44
- const [open, setOpen] = useState(false);
45
- const navigate = useNavigate();
46
- const { pathname } = useLocation();
47
- const chat = useChat({ client: chatClient, pageContext: { path: pathname } });
48
-
49
- return (
50
- <>
51
- <ChatLauncher open={open} onClick={() => setOpen(true)} style={{ bottom: "5rem" }} />
52
- <ChatPanel
53
- chat={chat}
54
- open={open}
55
- onClose={() => setOpen(false)}
56
- resolveLink={resolveLink}
57
- linkComponent={Link}
58
- confirmAction={supportClient.confirmAction}
59
- onViewTicket={(ticket) => navigate(`/support?ticket=${ticket.id}`)}
60
- />
61
- </>
62
- );
63
- }
64
- ```
65
-
66
- Call `chat.reset()` when the person signs out or switches account, so nothing of one person's chat
67
- shows to the next. The hook keeps its state in the component that calls it; mount it once, above
68
- the routes, so the conversation survives navigation.
69
-
70
- The streamed reply is read through axios's XHR adapter, the browser default. An instance forced
71
- onto the fetch adapter still works, but the reply then appears whole at the end.
72
-
73
- ## The engine and the contract
74
-
75
- The client, the stream reader, the conversation rules and the server contract (the routes, the
76
- request bodies, the events and the error codes) live in
77
- [`@webority/markdown-core/chat`](https://www.npmjs.com/package/@webority/markdown-core/chat). This package draws the
78
- assistant on top of it and re-exports its names, so a product imports every chat name from
79
- `@webority/chat-react`. That includes `CHAT_CONTRACT_VERSION`, `createChatClient`,
80
- `createConversationList`, `DEFAULT_CHAT_LABELS` and `mergeLabels` from the engine, and
81
- `splitCitations` from `@webority/markdown-core`.
82
-
83
- ## Server contract
84
-
85
- The client sends contract number 2 (`CHAT_CONTRACT_VERSION`). A server that reports a lower number, or a 404 on the settings route, makes the client answer `assistant_outdated`, whose message is "The assistant needs an update before it can answer. Please try again later." The panel shows that message in place of the answer.
86
-
87
- ## Settings
88
-
89
- The chat needs the server side of `Webority.Ai.Chat`, served by `Webority.Ai.Chat.AspNetCore`, with
90
- `GET {base}/settings` mapped. The panel reads that route once and keeps the answer. It carries the
91
- attachment limits: the panel refuses a file over them before upload, and the Attach button appears
92
- once they have loaded. A 404 on that route means the server is too old, and the panel shows the
93
- assistant as outdated. A server without the attachment routes gives no limits, so no Attach button.
94
-
95
- ## Panel behaviour
96
-
97
- - Stop cancels the answer arriving. The question and its files stay in the turn.
98
- - Retry sends again the last turn that failed or was stopped, with its files.
99
- - Regenerate asks for a new answer to the last answered turn, replacing it.
100
- - Edit puts a question and its files back in the box. Sending replaces that question and every later turn.
101
- - Attach uploads files in parallel, each with its progress. An upload still running blocks sending; a failed upload is skipped.
102
-
103
- ## Support actions
104
-
105
-
106
- A support card's Confirm calls the `confirmAction(token)` it is given. With
107
- `@webority/support-react` that is `supportClient.confirmAction`, which sends
108
- `POST {supportBase}/actions/confirm` with `{ token }` and resolves to the ticket it acted on. Nothing
109
- reaches support until the person confirms.
110
-
111
- ## On a Razor site
112
-
113
- A server-rendered Razor site uses `<app-chat base="/api/assistant" />` from `Webority.Ui.Razor`
114
- instead. It wraps the `<wui-chat>` element from `@webority/ui-elements/chat`, which reads the same
115
- routes with this package's client, labels and reply parser, and shows the launcher, the panel and
116
- the conversation. Its attributes are this package's props in kebab case: `base`, `position`,
117
- `icon`, `compact`, `panel-title`, `disclaimer`, `max-length`, `allowance-threshold`, `rating`,
118
- `labels` (JSON) and `page-context` (JSON). `title` is `panel-title` there, because `title` is a
119
- global HTML attribute. The `conversations` attribute offers the past-chats list. Support action cards, the rating note, `linkComponent`
120
- and `renderReply` are not in the element.
121
-
122
- ## The hook
123
-
124
- `useChat({ client, pageContext })` returns:
125
-
126
- | Field | What it is |
127
- |---|---|
128
- | `turns` | `[{ id, questionId, question, attachments, answer, streaming, stopped, step, error, actions, messageId, rating, ratingNote }]`, oldest first. `questionId` is the stored question's id (null until the server answers; Edit needs it). `attachments` are the files sent with the question. `stopped` is true when the person stopped the answer. `step` is the name of the tool the assistant is running, or null (set by a `tool` event, cleared when text arrives, on a reset and when the turn ends), for the product to map to its own sentence. `suggestions` are the follow-up questions offered under a settled answer, `[]` when none |
129
- | `client` | The chat client the session talks to; pass it to `ChatConversationList` for the past-chats list |
130
- | `conversationId` | The conversation being continued, or null |
131
- | `messagesLeftToday` | From the last answer or `refreshAllowance()`; null with no daily limit |
132
- | `streaming` | An answer is arriving |
133
- | `loading`, `loadError` | `openConversation` is loading, or failed |
134
- | `settings` | `{ contractVersion, titleMaxLength, attachments }` from `GET {base}/settings`, where `titleMaxLength` caps a chat's renamed title and `attachments` is `{ maxFiles, maxFileBytes, contentTypes }` or null when attachments are off; null until loaded |
135
- | `settingsError` | The settings read failed; the error shows until reset |
136
- | `editing` | `{ turnId, text }` while a question is being edited, or null |
137
- | `attachments` | The files in the question being written: `{ key, fileName, contentType, length, status, progress, error }`, status `Uploading`, `Ready` or `Failed` |
138
- | `submit(message)` | Asks a question. Ignored while an answer is still arriving. |
139
- | `stop()` | Cancels the answer arriving; the question and its files stay in the turn |
140
- | `retry(turnId)` | Sends the last turn again when it failed or was stopped, with its files |
141
- | `regenerate(turnId)` | Asks for a new answer to the last answered turn, replacing it |
142
- | `startEdit(turnId)` | Puts that question and its files back in the box for editing; sending replaces it and every later turn |
143
- | `cancelEdit()` | Leaves editing without sending |
144
- | `attach(files)` | Uploads picked files, each with its progress; a failed upload stays listed with its error |
145
- | `removeAttachment(key)` | Removes a file from the question being written |
146
- | `openConversation(id)` | Replaces the thread with a stored conversation |
147
- | `newConversation()` | Clears the thread; the next question starts a conversation |
148
- | `rate(turnId, rating, note?)` | Saves a rating, shown at once; a failed save puts the old one back and rejects |
149
- | `refreshAllowance()` | Reads the questions left today |
150
- | `reset()` | Clears everything, for sign-out or an account switch |
151
-
152
- An answer still arriving is cancelled on `reset`, `newConversation`, `openConversation` and
153
- unmount. A failed turn keeps the question, drops the half-streamed text and carries `error`
154
- (`{ code, message, resetsAtUtc }`). After `daily_limit`, `messagesLeftToday` becomes 0; after
155
- `conversation_not_found`, the next question starts a new conversation.
156
-
157
- ## Components
158
-
159
- Every component takes `labels`, any subset of `DEFAULT_CHAT_LABELS`, to change its wording. The keys
160
- added for copy, suggestions, citations, past chats and renaming are `copy`, `copied`, `toolStep`,
161
- `suggestions`, `openCitation`, `renameConversation`, `conversationTitle`, `renameSave`,
162
- `renameFailed` and `backToChat`.
163
-
164
- ### `<ChatLauncher />`
165
-
166
- The floating pill that opens the panel. `onClick`, `open` (announced on the button), `position`
167
- (`end` or `start`, the bottom corner), `icon`, `compact`, and `className` and `style` on the
168
- floating wrapper to move it clear of other fixed controls, such as `ReportIssue`. The launcher is
169
- left out of `ReportIssue`'s page capture.
170
-
171
- `compact` makes it a 48px icon-only circle with the label as its tooltip and accessible name. It
172
- joins the shared floating stack (`useFloatingStack` from `@webority/ui-react`), one fixed container
173
- per corner that the compact `ReportIssue` from `@webority/support-react` also uses: the launcher
174
- sits in the corner and the report button stacks above it with a gap, so neither needs an offset.
175
- `className` and `style` then land on the item inside the stack, which is not itself fixed.
176
-
177
- ```jsx
178
- <ChatLauncher compact open={open} onClick={() => setOpen(true)} />
179
- <ReportIssue floating compact />
180
- ```
181
-
182
- ### `<ChatPanel />`
183
-
184
- The drawer: 440px from the right (`width`), the full screen on a phone. Focus stays inside it,
185
- Escape closes it, and the question box takes focus when it opens.
186
-
187
- | Prop | What it does |
188
- |---|---|
189
- | `chat` | The `useChat` result. |
190
- | `open`, `onClose` | Open state and close handler. |
191
- | `title`, `titleIcon` | Header title (default "Assistant") and its library icon. |
192
- | `headerActions` | Extra header controls before New chat, e.g. a past-chats button. |
193
- | `empty` | Shown before the first question. |
194
- | `disclaimer` | The footnote under the question box. |
195
- | `maxLength` | The server's message limit. Default 4000. |
196
- | `allowanceThreshold` | Show the questions left once this many or fewer remain. Default 10. |
197
- | `resolveLink`, `linkComponent` | Reply links; see Replies below. |
198
- | `confirmAction`, `onViewTicket` | Support action cards; see `ActionCard`. |
199
- | `rating` | Offer ratings under stored replies. Default true. |
200
- | `renderReply` | Draws each assistant reply your way; see Custom reply rendering below. |
201
- | `openAttachment` | Opens a file attached to a question, called with `{ publicId, fileName, contentType, length }`. The session has no open action, so the app supplies one, for example with `client.getAttachment(publicId)` (the bytes) and a blob URL: `(file) => client.getAttachment(file.publicId).then((bytes) => window.open(URL.createObjectURL(new Blob([bytes], { type: file.contentType }))))`. Without it the attachment chips on a question are not buttons. |
202
- | `conversations` | Off by default. When true, a history icon in the header (labelled `labels.conversations`) shows the person's past chats in place of the conversation; opening one loads it. A back icon (labelled `labels.backToChat`) returns to the chat. |
203
- | `isCitation`, `onOpenCitation` | Draw a run of the reply as a citation chip and handle its press; see Citation chips. |
204
- | `labels` | Replacements for any subset of `DEFAULT_CHAT_LABELS`. |
205
-
206
- ### `<ChatThread />`, `<ChatMessage />`, `<ChatComposer />`
207
-
208
- The panel's parts, for a product that lays out its own assistant page. `ChatThread` takes
209
- `turns`, `empty`, `onRate`, `resolveLink`, `linkComponent`, `confirmAction`, `onViewTicket`,
210
- `renderReply`, `onRetry`, `onRegenerate`, `onEdit`, `onOpenAttachment`, `onAskSuggestion`, `isCitation` and `onOpenCitation`. `onRetry` is offered on the
211
- last turn only, `onRegenerate` (New answer) on the last answered turn only, `onEdit` beside each
212
- question that has a `questionId`, and `onOpenAttachment` makes each attachment chip a button.
213
- Each answer is a polite live region, marked busy while it streams. `ChatMessage` draws one turn with the same reply props. Under a settled answer, `onAskSuggestion(text)` offers the suggested follow-up questions; `ChatPanel` wires it to send the chosen question through `submit`.
214
-
215
- `ChatComposer` takes `onSubmit`, `busy`, `disabled`, `maxLength` and `inputRef`; Enter sends, Shift
216
- and Enter starts a new line. With `onStop` it shows Stop in place of Send while `busy`. With
217
- `onAttach` it shows the attach button, and `accept` sets the file types the picker offers; the picked
218
- files come to `onAttach(files)`, and `attachments` (each with `key`, `fileName`, `status`, `progress`
219
- and `error`) show as chips that `onRemoveAttachment(key)` removes. `editing` (`{ text }`) fills the
220
- box and shows the editing notice, whose Cancel calls `onCancelEdit`.
221
-
222
- ### `<ReplyRating />`
223
-
224
- Helpful and Not helpful under a reply. Either saves at once; Not helpful then offers an optional
225
- note, saved with the same rating. Takes `rating` and `onRate(rating, note?)`.
226
-
227
- ### `<ChatConversationList />`
228
-
229
- Past chats, newest first, for a page or a panel: `client`, `onOpen(conversation)`,
230
- `onDeleted(id)` and `pageSize` (default 20). It pages with Show more, opens one through `onOpen`,
231
- renames one in place and deletes one after a confirm. The rename form caps the title at the
232
- server's `titleMaxLength`. If the settings read fails, its message shows in the rename form and Save
233
- stays enabled, because the server enforces the limit. The component calls `client.getSettings()`
234
- only when the client has that method.
235
-
236
- ### The paged past-chats list
237
-
238
- `createConversationList({ client, pageSize })` (exported from `@webority/chat-react`) builds the
239
- state the component draws. It returns `getState()`, `subscribe(listener)`, `load()` (reads the first
240
- page and replaces the list), `loadMore()` (reads the next page), `rename(id, title)`, `remove(id)`
241
- and `dispose()`. `getState()` returns `{ items, totalCount, loading, error, hasMore }`, where
242
- `error` is `{ code, message, resetsAtUtc }` and its message is written for the person.
243
-
244
- The client it reads from provides `listConversations({ page, pageSize })`, which resolves to a
245
- `PagedDataObject` `{ items, page, pageSize, totalCount, totalPages }`, plus `renameConversation(id,
246
- title)`, `deleteConversation(id)` and `getSettings()`.
247
-
248
- ### `<ActionCard />`
249
-
250
- One support action under a reply: what will be sent, then Confirm or Not now. It moves through
251
- sending to done (with View ticket when `onViewTicket` is given), and an expired action shows
252
- without a button. Takes `action`, `confirmAction(token)` and `onViewTicket(ticket)`.
253
-
254
- ### `<ConfirmCard />`
255
-
256
- One general card for an action the assistant prepared. Nothing happens until the person presses
257
- Confirm. It moves through sending to done, showing the message `onConfirm` resolves to (or Done.),
258
- and a failed confirm shows its message and stays ready to try again. Not now dismisses it without
259
- sending. Takes `title`, `subtitle`, `lines` (strings, one paragraph each), `note` (replaces the
260
- default "Nothing is sent until you confirm."), `onConfirm()` and `labels`.
261
-
262
- ```jsx
263
- <ConfirmCard
264
- title="Archive project"
265
- subtitle="Planning"
266
- lines={["Moves the project to the archive."]}
267
- onConfirm={() => archiveProject(projectId)}
268
- />
269
- ```
270
-
271
- ### Citation chips
272
-
273
- A reply can cite its sources as `[Clause 4.2]`. `splitCitations(text, isCitation)` splits the reply into text parts and citation parts. The function lives in `@webority/markdown-core`; `@webority/chat-react` re-exports it, so the import stays the same. `CitationChip` draws each citation as a chip that opens its source. Only the runs that `isCitation` accepts become chips: a markdown link such as `[text](url)` and an empty `[]` stay text. `CitationChip` takes `citation`, `onOpen(citation)`, and optionally `label` (the chip text, defaulting to the citation) and `ariaLabel`. `ChatMarkdown`, `ChatMessage`, `ChatThread` and `ChatPanel` take `isCitation` and `onOpenCitation`: a run that `isCitation` accepts draws as a chip, and pressing it calls `onOpenCitation(citation)` with the citation text.
274
-
275
- ```jsx
276
- const parts = splitCitations(reply.text, (inner) => sources.has(inner));
277
-
278
- {parts.map((part, i) =>
279
- "citation" in part ? (
280
- <CitationChip key={i} citation={part.citation} onOpen={openSource} />
281
- ) : (
282
- <span key={i}>{part.text}</span>
283
- ),
284
- )}
285
- ```
286
-
287
- ## Replies
288
-
289
- `<ChatMarkdown text resolveLink linkComponent />` draws a reply through `AppMarkdown` from
290
- `@webority/ui-react`, with the chat link and heading rules: paragraphs, bold, italics, inline code,
291
- bullet and numbered lists, tables, headings (as bold lines) and code blocks. It never renders HTML:
292
- every character reaches the page as text. Text still arriving updates the last block in place, and an unclosed `**` shows as typed
293
- until its partner arrives.
294
-
295
- A link shows only when its href has the form `scheme:kind/id` (for example `ticket:support/3f2a`)
296
- and `resolveLink(href)` returns an in-app route starting with `/`. Any other link, including every
297
- web address, shows its label as plain text. Pass the router's `Link` as `linkComponent` so a link
298
- navigates inside the portal.
299
-
300
- Each settled answer has a Copy button that copies the answer as plain text, without the markdown marks.
301
-
302
- While a tool runs, the waiting line reads `labels.toolStep(name)`. It receives the server's tool name and defaults to "Looking this up", so the name never shows unless the product maps it to the person's words.
303
-
304
- ### Custom reply rendering
305
-
306
- A product that draws replies its own way (charts, maths) passes `renderReply` to `ChatPanel`,
307
- `ChatThread` or `ChatMessage`. It is called as `renderReply(turn, { streaming })` for each
308
- assistant reply that has text, and what it returns replaces `ChatMarkdown`. `turn.answer` is the
309
- text so far, and `streaming` is true while it is still arriving. The person's question, the
310
- "thinking" state, errors, action cards, the rating and the layout stay the library's. With no
311
- `renderReply`, replies render as above.
312
-
313
- ```jsx
314
- <ChatPanel
315
- chat={chat}
316
- open={open}
317
- onClose={() => setOpen(false)}
318
- renderReply={(turn, { streaming }) => <RichReply text={turn.answer} live={streaming} />}
319
- />
320
- ```