@twentyfourg/chat-kit 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -114,8 +114,21 @@ that changes once the conversation has started, say) can be a computed.
 | `message-actions` | Scoped, gives you `{ message }`. Sits on the left of the row that holds the thumbs, on finished replies. This is where an app's own button goes, an export for example, and it comes before the kit's copy button so your actions stay together. |
 | `message-footer` | Scoped, gives you `{ message }`. Whatever your app wants under a reply, below its sources and actions: follow-up prompts, a link back to something above. Rendered for every reply, streaming included, so check `message.isStreaming` if it should wait. |
 | `composer` | Replaces the whole composer. For a state the kit's field has no shape for, such as a locked bar with an upgrade prompt. Your content calls `engine.sendMessage` itself if it needs to send. |
+| `send` | Scoped, gives you `{ send, canSend }`. Replaces the send button and nothing else, so the field keeps its own typing, dictation, and Enter handling. For a client whose send button is a finished asset that draws its own shape and disabled state. Not rendered while an answer streams, when the stop button has the spot. |
 | `composer-footer` | Sits inside the composer, under the field. An option that changes how the next question is handled, a hint, a counter. |
 
+Your own send button, keeping everything else the kit does:
+
+```vue
+<Chat :engine="engine">
+  <template #send="{ send, canSend }">
+    <button :disabled="!canSend" @click="send">
+      <img :src="canSend ? sendIcon : sendDisabledIcon" alt="Send" />
+    </button>
+  </template>
+</Chat>
+```
+
 ### Events
 
 `Chat` emits `rated` with the message and the rating now on it, or `null`
@@ -152,6 +165,24 @@ The heading, label, and interface fonts follow `--font-body` unless you set
 them. The citation and button accents follow `--accent`. An app that already
 defines the whole set itself can skip the import.
 
+### Room around the chat
+
+Two properties control how much space the chat takes, separately from the rest
+of the theme:
+
+| Property | Default | What it does |
+| --- | --- | --- |
+| `--chat-inset` | `24px` | The gutter between the chat's edge and its contents. The conversation and the composer both read it, so they stay lined up with each other. |
+| `--composer-padding` | `8px` | Space between the composer's border and the field inside it. The 40px buttons set the height, not the text, so this is added to those: the default makes a 56px composer plus its border. |
+
+A roomier chat, for a design with space to spend:
+
+```css
+:root {
+  --composer-padding: 24px;
+}
+```
+
 One thing to watch. If your own tokens live inside a CSS cascade layer, layer
 order decides the winner before anything else does. Import `theme.css` before
 your layered styles, or state the order yourself:

package/dist/chat-kit.js

@@ -717,7 +717,7 @@ function Qe(e) {
 			inputMode: i
 		});
 		o.value.push(u);
-		let d = b({
+		let m = b({
 			id: K(),
 			role: "assistant",
 			text: "",
@@ -731,64 +731,71 @@ function Qe(e) {
 			isReceiving: !1,
 			failed: !1
 		});
-		p.value = d;
-		let m = new AbortController();
-		g = m;
-		let h = new Ke((e) => {
-			d.html = e;
+		p.value = m;
+		let h = new AbortController();
+		g = h;
+		let _ = new Ke((e) => {
+			m.html = e;
 		}, 25, e.showMath);
-		function _() {
-			s.value !== "streaming" && (s.value = "streaming", d.isStreaming = !0, d.isReceiving = !0, o.value.push(d));
+		function v() {
+			s.value !== "streaming" && (s.value = "streaming", m.isStreaming = !0, m.isReceiving = !0, o.value.push(m));
 		}
-		let v = new Ye((e) => {
-			_(), d.text += e, h.addChunk(e);
-		}, e.typewriter ?? !0), y = null;
+		let y = new Ye((e) => {
+			v(), m.text += e, _.addChunk(e);
+		}, e.typewriter ?? !0), x = null, S = null;
 		try {
 			let o = await D();
 			if (await U(await t.sendMessage(r, o, {
 				message: n,
 				stream: !0,
 				...i === "voice" && { inputMode: "dictation" }
-			}, { signal: m.signal }), {
+			}, { signal: h.signal }), {
 				onChunk: (e) => {
-					v.push(e);
+					y.push(e);
 				},
 				onComplete: () => {},
 				onError: (e) => {
-					y = e;
+					x = e;
 				},
 				onMetadata: (e) => {
-					e.sources && (d.sources = e.sources);
+					e.sources && (m.sources = e.sources);
+				},
+				onRateLimit: ({ limit: e, remaining: t, resetSeconds: n }) => {
+					S = {
+						limit: e,
+						remaining: t,
+						resetAt: Number.isFinite(n) ? (/* @__PURE__ */ new Date(n * 1e3)).toISOString() : ""
+					};
 				},
 				onThinkingChunk: (e) => {
-					d.thinking += e;
+					m.thinking += e;
 				}
 			}, (e, t) => {
-				if (e === "citations" && Array.isArray(t)) return d.citations = t, !0;
+				if (e === "citations" && Array.isArray(t)) return m.citations = t, !0;
 				let n = t ?? {};
-				return e === "message_id" && typeof n.messageId == "string" ? (u.basecampMessageId = n.messageId, !0) : e === "assistant_message_id" && typeof n.messageId == "string" ? (d.basecampMessageId = n.messageId, !0) : e === "used_sources" && Array.isArray(t) ? (d.sources = t, !0) : e === "token_usage" && n.thread ? (l.value = n.thread, !0) : !1;
-			}), y) throw y;
-			if (m.signal.aborted) {
-				v.flush(), await h.complete(), d.isReceiving = !1, d.isStreaming = !1;
+				return e === "message_id" && typeof n.messageId == "string" ? (u.basecampMessageId = n.messageId, !0) : e === "assistant_message_id" && typeof n.messageId == "string" ? (m.basecampMessageId = n.messageId, !0) : e === "used_sources" && Array.isArray(t) ? (m.sources = t, !0) : e === "token_usage" && n.thread ? (l.value = n.thread, !0) : !1;
+			}), x) throw x;
+			if (h.signal.aborted) {
+				y.flush(), await _.complete(), m.isReceiving = !1, m.isStreaming = !1;
 				return;
 			}
-			if (d.isReceiving = !1, await v.finish(), !d.text) throw Error("The response ended without any content.");
-			await h.complete(), d.isOutOfScope = e.isOutOfScope?.(d.text) ?? !1, d.isStreaming = !1, w({
+			if (m.isReceiving = !1, await y.finish(), !m.text) throw Error("The response ended without any content.");
+			await _.complete(), m.isOutOfScope = e.isOutOfScope?.(m.text) ?? !1, m.isStreaming = !1, w({
 				type: "turn",
 				query: n,
 				inputMode: i,
-				response: d.text,
-				isOutOfScope: d.isOutOfScope,
-				citations: d.citations,
-				sources: d.sources,
+				response: m.text,
+				isOutOfScope: m.isOutOfScope,
+				citations: m.citations,
+				sources: m.sources,
 				threadId: a.value,
 				userMessageId: u.basecampMessageId,
-				assistantMessageId: d.basecampMessageId
+				assistantMessageId: m.basecampMessageId
 			});
 		} catch (t) {
-			v.flush(), t?.name !== "AbortError" && (d.text ? d.failed = !0 : c.value = t instanceof Error ? t : Error(String(t))), h.stop(), d.isReceiving = !1, d.isStreaming = !1, d.text && (d.html = await W(d.text, { showMath: e.showMath }));
+			y.flush(), t?.name !== "AbortError" && (m.text ? m.failed = !0 : c.value = t instanceof Error ? t : Error(String(t))), _.stop(), m.isReceiving = !1, m.isStreaming = !1, m.text && (m.html = await W(m.text, { showMath: e.showMath }));
 		} finally {
-			v.destroy(), g = null, p.value = null, s.value = "idle", f();
+			y.destroy(), g = null, p.value = null, s.value = "idle", S ? d.value = S : f();
 		}
 	}
 	async function A() {
@@ -1034,9 +1041,22 @@ var J = (e) => new Promise((t) => setTimeout(t, e)), et = class {
 		} });
 		return new Response(m, {
 			status: 200,
-			headers: { "Content-Type": "text/event-stream" }
+			headers: {
+				"Content-Type": "text/event-stream",
+				...this.rateLimitHeaders()
+			}
 		});
 	}
+	rateLimitHeaders() {
+		let e = this.options.messageLimit;
+		if (e === void 0) return { "X-RateLimit-Limit": "unlimited" };
+		let t = Math.ceil(this.messageCount / 2);
+		return {
+			"X-RateLimit-Limit": String(e),
+			"X-RateLimit-Remaining": String(Math.max(0, e - t)),
+			"X-RateLimit-Reset": String(Math.floor(new Date(this.quotaResetAt).getTime() / 1e3))
+		};
+	}
 	async stopMessage() {
 		return {
 			success: !0,
@@ -1271,8 +1291,10 @@ var it = {
 		}, {
 			default: j(() => [l(Z, { name: "stop" })]),
 			_: 1
-		}, 8, ["label"])) : (v(), r(X, {
-			key: 3,
+		}, 8, ["label"])) : w(t.$slots, "send", {
+			send: O,
+			canSend: x.value
+		}, () => [l(X, {
 			class: "input-bar__send",
 			label: D(u).composer.sendLabel,
 			disabled: !x.value,
@@ -1283,9 +1305,9 @@ var it = {
 				size: 20
 			})]),
 			_: 1
-		}, 8, ["label", "disabled"]))])]), w(t.$slots, "footer", {}, void 0, !0)]));
+		}, 8, ["label", "disabled"])], !0, 3)])]), w(t.$slots, "footer", {}, void 0, !0)]));
 	}
-}), [["__scopeId", "data-v-2a67b2cf"]]), St = 20, Ct = 300, wt = .3, Tt = 12, Et = 8;
+}), [["__scopeId", "data-v-4e9c096d"]]), St = 20, Ct = 300, wt = .3, Tt = 12, Et = 8;
 function Dt(e, t = {}) {
 	let n = S("following"), r = !1, i = 0, a = !1, o = null, s = !1, c = () => t.mode?.() ?? "reply";
 	function l(e) {
@@ -1728,6 +1750,7 @@ var Mt = { class: "citation-popover__source" }, Nt = ["src"], Pt = { class: "cit
 			e.message.isOutOfScope ? (v(), a("div", Nn, [l(Z, { name: "warning" }), o("span", null, E(D(d).outOfScope.label), 1)])) : i("", !0),
 			e.showThinking && e.message.thinking ? (v(), r(On, {
 				key: 1,
+				class: "assistant-message__reasoning",
 				text: e.message.thinking
 			}, null, 8, ["text"])) : i("", !0),
 			o("div", Pn, [o("div", {
@@ -1769,7 +1792,7 @@ var Mt = { class: "citation-popover__source" }, Nt = ["src"], Pt = { class: "cit
 			w(n.$slots, "message-footer", { message: e.message }, void 0, !0)
 		]));
 	}
-}), [["__scopeId", "data-v-466b7413"]]), Un = { class: "thinking" }, Wn = {
+}), [["__scopeId", "data-v-0cff2e6c"]]), Un = { class: "thinking" }, Wn = {
 	key: 0,
 	class: "thinking__label"
 }, Gn = 2e3, Kn = /*#__PURE__*/ Y(/* @__PURE__ */ u({
@@ -1893,7 +1916,7 @@ var Mt = { class: "citation-popover__source" }, Nt = ["src"], Pt = { class: "cit
 			}, E(D(u).status.retryLabel), 1)])) : i("", !0)
 		], 512));
 	}
-}), [["__scopeId", "data-v-2f494fbc"]]), rr = { class: "chat" }, ir = /*#__PURE__*/ Y(/* @__PURE__ */ u({
+}), [["__scopeId", "data-v-7817c1d9"]]), rr = { class: "chat" }, ir = /*#__PURE__*/ Y(/* @__PURE__ */ u({
 	__name: "Chat",
 	props: {
 		engine: {},
@@ -1957,13 +1980,20 @@ var Mt = { class: "citation-popover__source" }, Nt = ["src"], Pt = { class: "cit
 			"show-mic": e.showMic,
 			onSend: i,
 			onStop: n[1] ||= () => e.engine.stopGeneration()
-		}, s({ _: 2 }, [t.$slots["composer-footer"] ? {
+		}, s({ _: 2 }, [t.$slots.send ? {
+			name: "send",
+			fn: j(({ send: e, canSend: n }) => [w(t.$slots, "send", {
+				send: e,
+				canSend: n
+			}, void 0, !0)]),
+			key: "0"
+		} : void 0, t.$slots["composer-footer"] ? {
 			name: "footer",
 			fn: j(() => [w(t.$slots, "composer-footer", {}, void 0, !0)]),
-			key: "0"
+			key: "1"
 		} : void 0]), 1032, ["busy", "show-mic"])], !0)]));
 	}
-}), [["__scopeId", "data-v-7ad4b6f4"]]);
+}), [["__scopeId", "data-v-7ae994a7"]]);
 //#endregion
 export { H as AnonymousAuthError, ue as BaseCampClient, le as BaseCampError, ir as Chat, X as IconButton, et as MockTransport, fe as RateLimitError, Ke as StreamingMessage, Ye as Typewriter, U as consumeSSEResponse, ce as createAnonymousTokenProvider, G as decodeHtmlEntities, L as defaultChatCopy, ie as fetchAuthConfig, R as formatCopy, re as provideChatCopy, W as renderMarkdownSafe, Ve as renderMarkdownStreaming, te as resolveChatCopy, se as signInAnonymously, Se as streamSSE, Ge as stripHtmlTags, B as useChatCopy, Qe as useChatEngine };