@softr/sdk 0.0.89-alpha.3 → 0.0.89

package/dist/agent/use-agent-chat.js

@@ -1,486 +0,0 @@
-import { assert } from "../assertions.js";
-import { useCurrentUser } from "../auth/isomorphic.js";
-import { agentChatFn, awaitAgentConnectionFn, decideAgentToolFn, finishAgentConnectionFn, listAgentChatsFn, loadAgentChatFn, startAgentConnectionFn } from "./agent-fns.js";
-import { useCallback, useEffect, useRef, useState } from "react";
-
-//#region src/agent/use-agent-chat.ts
-/**
-* A chat with one of the app's Softr agents, as the signed-in visitor. No UI:
-* render `messages` with the app's own components.
-*
-* @example
-* const chat = useAgentChat(AGENT_ID, { record: ticket && { id: ticket.id, fields: ticket.fields } })
-* <form onSubmit={(e) => { e.preventDefault(); chat.send(draft) }}>
-*/
-function useAgentChat(agentId, options = {}) {
-	const [messages, setMessages] = useState([]);
-	const [live, setLive] = useState(null);
-	const [status, setStatus] = useState("idle");
-	const [loading, setLoading] = useState(false);
-	const [error, setError] = useState(null);
-	const [chatId, setChatId] = useState(null);
-	const storeKey = chatKey(agentId, useCurrentUser()?.id ?? null);
-	const chatIdRef = useRef(chatId);
-	chatIdRef.current = chatId;
-	const recordRef = useRef(options.record ?? null);
-	recordRef.current = options.record ?? null;
-	const liveRef = useRef(live);
-	liveRef.current = live;
-	const abortRef = useRef(null);
-	useEffect(() => () => abortRef.current?.abort(), []);
-	const commitLive = useCallback((blocks) => {
-		setLive(null);
-		if (!blocks?.some((b) => b.type !== "text" || b.text.trim())) return;
-		setMessages((prev) => [...prev, {
-			id: crypto.randomUUID(),
-			role: "assistant",
-			blocks: endRunningTools(blocks)
-		}]);
-	}, []);
-	const stream = useCallback(async (message) => {
-		abortRef.current?.abort();
-		const controller = new AbortController();
-		abortRef.current = controller;
-		setError(null);
-		setStatus("thinking");
-		let blocks = [];
-		try {
-			const request = {
-				agentId,
-				message,
-				sessionId: chatIdRef.current,
-				timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-				pageName: document.title,
-				pageUrl: location.href,
-				record: recordRef.current
-			};
-			const form = new FormData();
-			form.append("payload", JSON.stringify(request));
-			const res = await fetch(agentChatFn.url, {
-				method: "POST",
-				body: form,
-				signal: controller.signal
-			});
-			if (!res.ok) throw new Error(await failureMessage(res));
-			assert(res.body, "agent chat: the reply has no body");
-			const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
-			let buffer = "";
-			const onLine = (line) => {
-				const event = parseEvent(line);
-				if (event === null) return;
-				if (event.sessionId && event.sessionId !== chatIdRef.current) {
-					chatIdRef.current = event.sessionId;
-					setChatId(event.sessionId);
-					saveChatId(storeKey, event.sessionId);
-				}
-				blocks = reduceEvent(blocks, event);
-				setLive(blocks);
-				setStatus("replying");
-			};
-			for (;;) {
-				const { done, value } = await reader.read();
-				if (done) break;
-				buffer += value;
-				const lines = buffer.split("\n");
-				buffer = lines.pop() ?? "";
-				lines.forEach(onLine);
-			}
-			onLine(buffer);
-		} catch (err) {
-			if (controller.signal.aborted) return;
-			setError(err instanceof Error ? err : new Error(String(err)));
-		}
-		if (abortRef.current !== controller) return;
-		abortRef.current = null;
-		commitLive(blocks);
-		setStatus("idle");
-	}, [
-		agentId,
-		storeKey,
-		commitLive
-	]);
-	const send = useCallback((text) => {
-		const trimmed = text.trim();
-		if (!trimmed) return;
-		abortRef.current?.abort();
-		commitLive(liveRef.current);
-		setMessages((prev) => [...prev, {
-			id: crypto.randomUUID(),
-			role: "user",
-			blocks: [{
-				type: "text",
-				text: trimmed
-			}]
-		}]);
-		stream(trimmed);
-	}, [stream, commitLive]);
-	const stop = useCallback(() => {
-		if (abortRef.current === null) return;
-		abortRef.current.abort();
-		abortRef.current = null;
-		commitLive(liveRef.current);
-		setStatus("idle");
-	}, [commitLive]);
-	const reset = useCallback((id) => {
-		abortRef.current?.abort();
-		abortRef.current = null;
-		chatIdRef.current = id;
-		setChatId(id);
-		saveChatId(storeKey, id);
-		setMessages([]);
-		setLive(null);
-		setStatus("idle");
-		setLoading(false);
-		setError(null);
-	}, [storeKey]);
-	const newChat = useCallback(() => reset(null), [reset]);
-	const load = useCallback((id, restoring) => {
-		reset(id);
-		setLoading(true);
-		loadAgentChatFn({ data: {
-			agentId,
-			sessionId: id
-		} }).then((history) => {
-			if (chatIdRef.current !== id) return;
-			if (history === null) {
-				reset(null);
-				if (!restoring) setError(new Error(CHAT_GONE_MESSAGE));
-				return;
-			}
-			setLoading(false);
-			setMessages(fromHistory(history));
-		}).catch((err) => {
-			if (chatIdRef.current !== id) return;
-			setLoading(false);
-			setError(err instanceof Error ? err : new Error(String(err)));
-		});
-	}, [agentId, reset]);
-	const openChat = useCallback((id) => load(id, false), [load]);
-	useEffect(() => {
-		const saved = savedChatId(storeKey);
-		if (saved) load(saved, true);
-		else newChat();
-	}, [
-		storeKey,
-		load,
-		newChat
-	]);
-	const listChats = useCallback(() => listAgentChatsFn({ data: { agentId } }), [agentId]);
-	const setToolStatus = useCallback((toolCallId, next) => {
-		const update = (blocks) => blocks.map((b) => b.type === "tool" && b.id === toolCallId ? {
-			...b,
-			status: next
-		} : b);
-		setLive((prev) => prev && update(prev));
-		setMessages((prev) => prev.map((m) => ({
-			...m,
-			blocks: update(m.blocks)
-		})));
-	}, []);
-	const decide = useCallback((toolCallId, decision, scope) => {
-		const sessionId = chatIdRef.current;
-		const tool = [...messages.flatMap((m) => m.blocks), ...liveRef.current ?? []].find((b) => b.type === "tool" && b.id === toolCallId);
-		if (sessionId === null || tool?.status !== "awaiting-approval") return;
-		setToolStatus(toolCallId, decision === "APPROVE" ? "approved" : "rejected");
-		decideAgentToolFn({ data: {
-			agentId,
-			sessionId,
-			toolCallId,
-			toolName: tool.name,
-			decision,
-			scope
-		} }).then((saved) => {
-			if (!saved) {
-				reset(null);
-				setError(new Error(CHAT_GONE_MESSAGE));
-				return;
-			}
-			if (decision !== "APPROVE") return;
-			abortRef.current?.abort();
-			commitLive(liveRef.current);
-			stream("");
-		}).catch((err) => {
-			setToolStatus(toolCallId, "awaiting-approval");
-			setError(err instanceof Error ? err : new Error(String(err)));
-		});
-	}, [
-		agentId,
-		messages,
-		setToolStatus,
-		commitLive,
-		stream,
-		reset
-	]);
-	const approve = useCallback((toolCallId, scope = "ONCE") => decide(toolCallId, "APPROVE", scope), [decide]);
-	const reject = useCallback((toolCallId) => decide(toolCallId, "REJECT", "ONCE"), [decide]);
-	const connect = useCallback((toolCallId) => {
-		const sessionId = chatIdRef.current;
-		const tool = [...messages.flatMap((m) => m.blocks), ...liveRef.current ?? []].find((b) => b.type === "tool" && b.id === toolCallId);
-		if (sessionId === null || tool?.status !== "awaiting-connection" || !tool.integration) return;
-		const popup = window.open("", "softr-agent-connect", popupFeatures(500, 600));
-		if (!popup) {
-			setError(/* @__PURE__ */ new Error("Allow pop-ups for this site to connect your account."));
-			return;
-		}
-		setToolStatus(toolCallId, "connecting");
-		const connection = {
-			integration: tool.integration,
-			requestId: crypto.randomUUID()
-		};
-		const deadline = Date.now() + CONNECT_TIMEOUT_MS;
-		(async () => {
-			popup.location.href = await startAgentConnectionFn({ data: connection });
-			while (!await awaitAgentConnectionFn({ data: connection })) {
-				if (Date.now() > deadline) throw new Error("Connecting took too long. Try again.");
-				await new Promise((resolve) => setTimeout(resolve, CONNECT_RETRY_MS));
-			}
-			popup.close();
-			if (!await finishAgentConnectionFn({ data: {
-				agentId,
-				sessionId,
-				toolCallId
-			} })) {
-				reset(null);
-				setError(new Error(CHAT_GONE_MESSAGE));
-				return;
-			}
-			setToolStatus(toolCallId, "approved");
-			abortRef.current?.abort();
-			commitLive(liveRef.current);
-			stream("");
-		})().catch((err) => {
-			popup.close();
-			setToolStatus(toolCallId, "awaiting-connection");
-			setError(err instanceof Error ? err : new Error(String(err)));
-		});
-	}, [
-		agentId,
-		messages,
-		setToolStatus,
-		commitLive,
-		stream,
-		reset
-	]);
-	return {
-		messages: (live === null ? messages : [...messages, {
-			id: "live",
-			role: "assistant",
-			blocks: live
-		}]).map(waitingLast),
-		status,
-		loading,
-		error,
-		chatId,
-		send,
-		stop,
-		newChat,
-		openChat,
-		listChats,
-		approve,
-		reject,
-		connect
-	};
-}
-const waitsForVisitor = (b) => b.type === "tool" && (b.status === "awaiting-approval" || b.status === "awaiting-connection" || b.status === "connecting");
-function waitingLast(message) {
-	if (!message.blocks.some(waitsForVisitor)) return message;
-	const blocks = [...message.blocks.filter((b) => !waitsForVisitor(b)), ...message.blocks.filter(waitsForVisitor)];
-	return {
-		...message,
-		blocks
-	};
-}
-const CONNECT_TIMEOUT_MS = 5 * 6e4;
-const CONNECT_RETRY_MS = 3e3;
-function popupFeatures(width, height) {
-	return `width=${width},height=${height},left=${window.screenX + (window.innerWidth - width) / 2},top=${window.screenY + (window.innerHeight - height) / 2}`;
-}
-const TODO_TOOL = "TodoWrite";
-/** Its question shows as a question block, so the call itself is noise. */
-const QUESTION_TOOL = "AskUserQuestion";
-function parseEvent(line) {
-	if (!line.trim()) return null;
-	try {
-		return JSON.parse(line);
-	} catch {
-		return null;
-	}
-}
-function reduceEvent(blocks, event) {
-	switch (event.type) {
-		case "TEXT": {
-			const last = blocks.at(-1);
-			return last?.type === "text" ? [...blocks.slice(0, -1), {
-				type: "text",
-				text: last.text + event.response
-			}] : [...blocks, {
-				type: "text",
-				text: event.response
-			}];
-		}
-		case "TOOL_CALL_START":
-			if (event.toolName === TODO_TOOL) {
-				const todos = parseTodos(event.input);
-				if (todos) return upsertTodos(blocks, todos);
-			}
-			if (event.toolName === QUESTION_TOOL) return blocks;
-			if (blocks.some((b) => b.type === "tool" && b.id === event.toolCallId)) return updateTool(blocks, event.toolCallId, (b) => b.status === "running" ? {
-				...b,
-				input: event.input ?? b.input,
-				thought: event.innerThought ?? b.thought
-			} : b);
-			return [...blocks, {
-				type: "tool",
-				id: event.toolCallId,
-				name: event.toolName,
-				input: event.input,
-				thought: event.innerThought,
-				integration: event.integrationType,
-				status: "running"
-			}];
-		case "TOOL_CALL_END": return updateTool(blocks, event.toolCallId, (b) => b.status === "running" || b.status === "approved" ? {
-			...b,
-			status: event.failed ? "failed" : "done",
-			error: event.errorMessage,
-			durationMs: event.durationMs
-		} : b);
-		case "TOOL_PERMISSION_REQUEST":
-		case "INTEGRATION_AUTH_REQUEST": {
-			const status = event.type === "TOOL_PERMISSION_REQUEST" ? "awaiting-approval" : "awaiting-connection";
-			const integration = event.type === "INTEGRATION_AUTH_REQUEST" ? event.integrationType : void 0;
-			if (blocks.some((b) => b.type === "tool" && b.id === event.toolCallId)) return updateTool(blocks, event.toolCallId, (b) => ({
-				...b,
-				status,
-				integration: integration ?? b.integration,
-				input: ("input" in event ? event.input : void 0) ?? b.input
-			}));
-			return [...blocks, {
-				type: "tool",
-				id: event.toolCallId,
-				name: event.toolName,
-				input: "input" in event ? event.input : void 0,
-				integration,
-				status
-			}];
-		}
-		case "QUESTION": return [...blocks, {
-			type: "question",
-			questions: event.questions
-		}];
-		case "ERROR": return [...blocks, {
-			type: "error",
-			message: event.message
-		}];
-		default: return blocks;
-	}
-}
-function updateTool(blocks, id, update) {
-	return blocks.map((b) => b.type === "tool" && b.id === id ? update(b) : b);
-}
-/** A reply that ended without finishing a tool call, stopped or cut off, never will. */
-function endRunningTools(blocks) {
-	return blocks.map((b) => b.type === "tool" && b.status === "running" ? {
-		...b,
-		status: "failed",
-		error: "The agent stopped before this step finished."
-	} : b);
-}
-/** Each plan update re-sends the whole list, so only the latest one is kept, where the first one was. */
-function upsertTodos(blocks, todos) {
-	const index = blocks.findIndex((b) => b.type === "todo");
-	if (index === -1) return [...blocks, {
-		type: "todo",
-		todos
-	}];
-	return blocks.map((b, i) => i === index ? {
-		type: "todo",
-		todos
-	} : b);
-}
-function parseTodos(input) {
-	if (!input) return null;
-	try {
-		const parsed = JSON.parse(input);
-		if (typeof parsed !== "object" || parsed === null || !("todos" in parsed)) return null;
-		const outer = parsed.todos;
-		const raw = typeof outer === "object" && outer !== null && "todos" in outer ? outer.todos : outer;
-		if (!Array.isArray(raw)) return null;
-		const todos = raw.flatMap((item) => {
-			if (typeof item !== "object" || item === null) return [];
-			const { content, status } = item;
-			if (typeof content !== "string" || !content.trim()) return [];
-			if (status !== "pending" && status !== "in_progress" && status !== "completed") return [];
-			return [{
-				content,
-				status
-			}];
-		});
-		return todos.length > 0 ? todos : null;
-	} catch {
-		return null;
-	}
-}
-function fromHistory(history) {
-	const toolsByMessage = Map.groupBy(history.toolCalls, (call) => call.messageId);
-	return history.messages.filter((m) => m.role !== "USER" || m.content.trim()).map((m) => {
-		if (m.role === "USER") return {
-			id: m.id,
-			role: "user",
-			blocks: [{
-				type: "text",
-				text: m.content
-			}]
-		};
-		let blocks = [];
-		const calls = (toolsByMessage.get(m.id) ?? []).toSorted((a, b) => a.createdAt - b.createdAt);
-		for (const call of calls) {
-			const todos = call.toolName === TODO_TOOL ? parseTodos(call.input) : null;
-			if (todos) blocks = upsertTodos(blocks, todos);
-			else if (call.toolName !== QUESTION_TOOL) blocks.push({
-				type: "tool",
-				id: call.id,
-				name: call.toolName,
-				input: call.input,
-				thought: call.metadata.innerThought ?? void 0,
-				durationMs: call.metadata.durationMs ?? void 0,
-				status: call.metadata.failed ? "failed" : "done"
-			});
-		}
-		if (m.content) blocks.push({
-			type: "text",
-			text: m.content
-		});
-		return {
-			id: m.id,
-			role: "assistant",
-			blocks
-		};
-	});
-}
-const CHAT_GONE_MESSAGE = "This chat is no longer available. Start a new one.";
-const VISITOR = "visitor";
-const chatKey = (agentId, userId) => `softr-code-app:agent-chat:${agentId}:${userId ?? VISITOR}`;
-function chatStore(key) {
-	return key.endsWith(`:${VISITOR}`) ? sessionStorage : localStorage;
-}
-function savedChatId(key) {
-	try {
-		return chatStore(key).getItem(key);
-	} catch {
-		return null;
-	}
-}
-function saveChatId(key, chatId) {
-	try {
-		if (chatId) chatStore(key).setItem(key, chatId);
-		else chatStore(key).removeItem(key);
-	} catch {}
-}
-async function failureMessage(res) {
-	const body = await res.json().catch(() => null);
-	if (typeof body === "object" && body !== null && "message" in body && typeof body.message === "string") return body.message;
-	return `The agent could not answer (${res.status}).`;
-}
-
-//#endregion
-export { useAgentChat };

package/skills/softr-sdk/agent-chat/SKILL.md

@@ -1,125 +0,0 @@
----
-name: agent-chat
-description: >-
-  Let visitors chat with one of the app's Softr agents: listAgents() from
-  @softr/sdk gives the agents the visitor may use, and useAgentChat(agentId, {
-  record }) returns the messages, the reply as it streams, past chats, and
-  send, stop, approve, reject and connect, with no UI. Load it for an agent
-  chat panel, approving the agent's actions, or connecting the visitor's own
-  account (Gmail, Slack…) that a tool needs. Build the chat from the app's own
-  components. The agent acts on the app's data through the app's MCP, so
-  softrMcpMiddleware must list the actions it may use.
-metadata:
-  type: sub-skill
-  library: softr-sdk
-  library_version: 0.0.89-alpha.3
----
-
-**Boundary.** `listAgents` and `useAgentChat` live on `@softr/sdk`. `listAgents` runs in a route loader, `useAgentChat` in a component. Neither needs a route, server function or registration of its own. It chats as the signed-in visitor, or anonymously when no one is signed in.
-
-# Agent chat
-
-A Softr agent is set up in Studio's Agents tab and attached to the app there. The app gives it a chat. There is no ready-made chat widget: the hook gives the state, and the app draws it with its own components.
-
-## Setup
-
-```ts
-import { listAgents, useAgentChat } from '@softr/sdk'
-```
-
-`listAgents()` resolves to the agents this visitor may chat with, `{ id, title, avatar, thumbnail }[]`. Call it in the route's `loader`. An agent hidden from this visitor isn't in the list, so show no chat when it's empty. When there are several, let the visitor pick one, or pick the one the builder named by its `title`. Take the id from the list, never write one by hand.
-
-## Core pattern
-
-```tsx
-// agentId comes from listAgents() in the route's loader.
-function AgentPanel({ agentId, ticket }: { agentId: string; ticket: Ticket | null }) {
-  const chat = useAgentChat(agentId, {
-    record: ticket && { id: ticket.id, fields: { Title: ticket.title, Status: ticket.status } },
-  })
-  const [draft, setDraft] = useState('')
-
-  return (
-    <>
-      {chat.messages.map((message) => (
-        <Message key={message.id} message={message} onApprove={chat.approve} onReject={chat.reject} />
-      ))}
-      {chat.error && <p role="alert">{chat.error.message}</p>}
-      <form onSubmit={(e) => { e.preventDefault(); chat.send(draft); setDraft('') }}>
-        <Textarea value={draft} onChange={(e) => setDraft(e.target.value)} />
-        {chat.status === 'idle'
-          ? <Button type="submit">Send</Button>
-          : <Button type="button" onClick={chat.stop}>Stop</Button>}
-      </form>
-    </>
-  )
-}
-```
-
-## What the hook returns
-
-- `messages`: the whole chat, oldest first. While the agent answers, its reply is the last message and grows as it streams. A tool waiting for Approve or Connect comes last in its message, so render blocks in the order given.
-- `status`: `thinking` until the first part of the reply arrives, `replying` until it ends, then `idle`. Show a typing hint while it's `thinking`.
-- `loading`: `true` while a past chat loads. Show a spinner, not the empty-chat greeting.
-- `error`: why the last request failed, or `null`.
-- `send(text)`, `stop()`, `newChat()`.
-- `listChats()` resolves to the visitor's past chats, `{ id, title }[]`, with `title` `null` until the agent names the chat. `openChat(id)` loads one. `chatId` is the open one, `null` for a new chat. The open chat is kept in the browser for each signed-in user, so the hook reopens it after a remount or a reload. A signed-out visitor keeps it only until the tab closes.
-- `approve(toolCallId, scope?)` and `reject(toolCallId)` answer a tool waiting for approval. `scope` is `ONCE` (default), `SESSION` for the rest of this chat, or `USER` for always.
-- `connect(toolCallId)` signs the visitor in to a tool's `integration` in a popup. Call it straight from the click, or the browser blocks the popup.
-
-## Rendering a message
-
-Each message has `role` (`user` or `assistant`) and `blocks`, in the order the agent produced them. Render every block type:
-
-| Block | Show it as |
-| --- | --- |
-| `text` | Markdown text |
-| `tool` | One line: the tool `name` and its `status`. Collapse finished ones. Expanded, show `thought`, `input`, `error` and `durationMs`. |
-| `todo` | A checklist of the agent's plan. It updates in place. |
-| `question` | The questions with their options. One question with a single choice sends its label with `send` on click. Several questions, or `multiSelect`, collect the picks and show a Send button, enabled once each question has one. It sends one line per question, picked labels joined by ", ". |
-| `error` | An error line inside the reply |
-
-A `tool` with status `awaiting-approval` blocks the agent until the visitor answers. Show Approve and Reject buttons on it. The agent continues on its own after an approval.
-
-A `tool` with status `awaiting-connection` needs the visitor's own `integration` account, such as their Gmail. Say "You need to connect to {integration} for this request. You'll only need to connect once.", with the name in readable case, and show a Connect button that calls `connect`. While it's `connecting`, show "Connecting…" and disable the button. The agent continues on its own once they're signed in. Any integration works the same way, so don't build one per integration.
-
-## The chat panel
-
-Classic Softr apps ship a chat panel. Visitors expect the same from yours:
-
-- A round button in a corner opens it. A right-side panel on desktop, full screen on mobile.
-- The header shows the agent's avatar and name, a picker when there are several agents, new chat, past chats and close.
-- An empty chat greets the visitor with the agent's avatar.
-- The list scrolls to the newest message as the reply streams, until the visitor scrolls up. Then a button takes them back down.
-- Text renders as Markdown, tables included.
-- The input says "Ask {agent title}…". Enter sends. Shift+Enter adds a line.
-- A line under the input: "AI can make mistakes. Please double-check responses."
-- An answered question stays locked.
-- Approve offers the three scopes: once, for this chat, always for this agent.
-- A tool's `input` is JSON. Show it readable: one `Label: value` line per field, with line breaks kept, never the raw JSON. Leave out `thought`, `input`, `error` or the duration when it's empty.
-- A tool that needs the visitor's account shows a Connect button.
-
-## Context
-
-`record` is the one record the visitor is looking at, so they can say "close this one". Pass it where a page shows one record, and `null` elsewhere. Use readable field names as keys. The agent reads them as they are.
-
-The page title and URL go along on their own. Nothing else about the page does, so don't try to send whole lists.
-
-## Letting the agent act on the app
-
-The agent reads and changes data through the app's own MCP, as the visitor who is chatting. Their groups and each action's `permissions` apply. The actions it may use are the ones listed in `softrMcpMiddleware`. With no MCP wired, the agent can only talk. Load [mcp/SKILL.md](../mcp/SKILL.md) to wire it.
-
-## Failure modes
-
-**Building a chat without the hook.** Calling the agents service from the browser fails: only the app's server can sign the request in as the visitor. Use `useAgentChat`.
-
-**Rendering only `text` blocks.** A tool waiting for approval never shows, and the agent waits forever. Render every block type.
-
-**The hook inside a panel that unmounts when it closes.** Closing it stops a reply that is still coming. Call `useAgentChat` in the component that owns the open state, such as `AppLayout` in `src/routes/_app.tsx`, and pass `chat` into the panel. Keep the selected agent there too, or closing the panel resets it.
-
-**An agent id written by hand.** The chat fails on the first message, and an agent hidden from the visitor still shows. Take the id from `listAgents`.
-
-## References
-
-- [mcp/SKILL.md](../mcp/SKILL.md): the actions the agent may call
-- [current-user/SKILL.md](../current-user/SKILL.md): showing the chat to signed-in visitors only