@silicajs/assistant 0.1.0

package/dist/server/wikilinks.js

@@ -0,0 +1,149 @@
+class AssistantWikiLinkFilter {
+  constructor(resolve) {
+    this.resolve = resolve;
+  }
+  resolve;
+  buffer = "";
+  inFence = false;
+  inlineCodeTicks = 0;
+  lineStart = true;
+  async push(chunk) {
+    this.buffer += chunk;
+    return this.drain(false);
+  }
+  async flush() {
+    return this.drain(true);
+  }
+  async drain(flush) {
+    let output = "";
+    let index = 0;
+    while (index < this.buffer.length) {
+      if (this.buffer[index] === "`") {
+        const tickCount = countBackticks(this.buffer, index);
+        if (!flush && index + tickCount === this.buffer.length && tickCount < 3) {
+          this.buffer = this.buffer.slice(index);
+          return output;
+        }
+        const backticks = this.buffer.slice(index, index + tickCount);
+        this.updateCodeState(tickCount);
+        output += backticks;
+        this.updateLineState(backticks);
+        index += tickCount;
+        continue;
+      }
+      const inCode = this.inFence || this.inlineCodeTicks > 0;
+      if (!inCode && this.buffer.startsWith("[[", index)) {
+        const end = this.buffer.indexOf("]]", index + 2);
+        if (end === -1) {
+          if (flush) {
+            const raw = this.buffer.slice(index);
+            output += raw;
+            this.updateLineState(raw);
+            this.buffer = "";
+          } else {
+            this.buffer = this.buffer.slice(index);
+          }
+          return output;
+        }
+        const rendered = await renderWikiLink(
+          this.buffer.slice(index + 2, end),
+          this.resolve
+        );
+        output += rendered;
+        this.updateLineState(rendered);
+        index = end + 2;
+        continue;
+      }
+      if (!inCode && !flush && this.buffer[index] === "[" && index === this.buffer.length - 1) {
+        this.buffer = this.buffer.slice(index);
+        return output;
+      }
+      const char = this.buffer[index];
+      output += char;
+      this.updateLineState(char);
+      index += 1;
+    }
+    this.buffer = "";
+    return output;
+  }
+  updateCodeState(tickCount) {
+    if (this.inFence) {
+      if (this.lineStart && tickCount >= 3) this.inFence = false;
+      return;
+    }
+    if (this.inlineCodeTicks > 0) {
+      if (tickCount === this.inlineCodeTicks) this.inlineCodeTicks = 0;
+      return;
+    }
+    if (this.lineStart && tickCount >= 3) {
+      this.inFence = true;
+      return;
+    }
+    this.inlineCodeTicks = tickCount;
+  }
+  updateLineState(text) {
+    for (const char of text) {
+      if (char === "\n") {
+        this.lineStart = true;
+      } else if (char !== "\r") {
+        this.lineStart = false;
+      }
+    }
+  }
+}
+async function resolveAssistantWikiLinks(text, resolve) {
+  const filter = new AssistantWikiLinkFilter(resolve);
+  return await filter.push(text) + await filter.flush();
+}
+function createAssistantWikiLinkFilter(options) {
+  return new AssistantWikiLinkFilter(
+    async (target) => options.resolveWikiLink?.(options.currentSourcePath, target)
+  );
+}
+async function renderWikiLink(rawValue, resolve) {
+  const parsed = parseWikiLink(rawValue);
+  if (!parsed) return rawValue;
+  const citation = await resolve(parsed.target);
+  if (!citation) return escapeMarkdownText(parsed.label);
+  return `[${escapeMarkdownLinkLabel(parsed.label)}](${citation.href})`;
+}
+function parseWikiLink(rawValue) {
+  const pipeIndex = findUnescapedPipe(rawValue);
+  const rawTarget = pipeIndex === -1 ? rawValue : rawValue.slice(0, pipeIndex);
+  const rawLabel = pipeIndex === -1 ? rawTarget : rawValue.slice(pipeIndex + 1);
+  const target = unescapeWikiText(rawTarget).trim();
+  const label = unescapeWikiText(rawLabel).trim() || target;
+  if (!target) return void 0;
+  return { target, label };
+}
+function findUnescapedPipe(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    if (value[index] !== "|") continue;
+    let slashCount = 0;
+    for (let cursor = index - 1; cursor >= 0 && value[cursor] === "\\"; cursor -= 1) {
+      slashCount += 1;
+    }
+    if (slashCount % 2 === 0) return index;
+  }
+  return -1;
+}
+function countBackticks(value, start) {
+  let count = 0;
+  while (value[start + count] === "`") count += 1;
+  return count;
+}
+function unescapeWikiText(value) {
+  return value.replace(/\\([\\|])/g, "$1");
+}
+function escapeMarkdownLinkLabel(value) {
+  return value.replace(/([\\[\]])/g, "\\$1");
+}
+function escapeMarkdownText(value) {
+  return value.replace(/([\\[\]])/g, "\\$1");
+}
+export {
+  AssistantWikiLinkFilter,
+  createAssistantWikiLinkFilter,
+  resolveAssistantWikiLinks
+};
+//# sourceMappingURL=wikilinks.js.map

package/dist/server/wikilinks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/wikilinks.ts"],"sourcesContent":["import type { AssistantCitation, AssistantWikiLinkResolver } from \"../types.js\";\n\nexport type WikiLinkResolver = (\n  target: string,\n) => AssistantCitation | undefined | Promise<AssistantCitation | undefined>;\n\n/**\n * Converts assistant-visible Obsidian wikilinks into regular markdown links.\n * Unresolved wikilinks degrade to their visible label so internal targets never\n * leak into the answer UI.\n */\nexport class AssistantWikiLinkFilter {\n  private buffer = \"\";\n  private inFence = false;\n  private inlineCodeTicks = 0;\n  private lineStart = true;\n\n  constructor(private readonly resolve: WikiLinkResolver) {}\n\n  async push(chunk: string): Promise<string> {\n    this.buffer += chunk;\n    return this.drain(false);\n  }\n\n  async flush(): Promise<string> {\n    return this.drain(true);\n  }\n\n  private async drain(flush: boolean): Promise<string> {\n    let output = \"\";\n    let index = 0;\n\n    while (index < this.buffer.length) {\n      if (this.buffer[index] === \"`\") {\n        const tickCount = countBackticks(this.buffer, index);\n        if (\n          !flush &&\n          index + tickCount === this.buffer.length &&\n          tickCount < 3\n        ) {\n          this.buffer = this.buffer.slice(index);\n          return output;\n        }\n\n        const backticks = this.buffer.slice(index, index + tickCount);\n        this.updateCodeState(tickCount);\n        output += backticks;\n        this.updateLineState(backticks);\n        index += tickCount;\n        continue;\n      }\n\n      const inCode = this.inFence || this.inlineCodeTicks > 0;\n      if (!inCode && this.buffer.startsWith(\"[[\", index)) {\n        const end = this.buffer.indexOf(\"]]\", index + 2);\n        if (end === -1) {\n          if (flush) {\n            const raw = this.buffer.slice(index);\n            output += raw;\n            this.updateLineState(raw);\n            this.buffer = \"\";\n          } else {\n            this.buffer = this.buffer.slice(index);\n          }\n          return output;\n        }\n\n        const rendered = await renderWikiLink(\n          this.buffer.slice(index + 2, end),\n          this.resolve,\n        );\n        output += rendered;\n        this.updateLineState(rendered);\n        index = end + 2;\n        continue;\n      }\n\n      if (\n        !inCode &&\n        !flush &&\n        this.buffer[index] === \"[\" &&\n        index === this.buffer.length - 1\n      ) {\n        this.buffer = this.buffer.slice(index);\n        return output;\n      }\n\n      const char = this.buffer[index]!;\n      output += char;\n      this.updateLineState(char);\n      index += 1;\n    }\n\n    this.buffer = \"\";\n    return output;\n  }\n\n  private updateCodeState(tickCount: number): void {\n    if (this.inFence) {\n      if (this.lineStart && tickCount >= 3) this.inFence = false;\n      return;\n    }\n\n    if (this.inlineCodeTicks > 0) {\n      if (tickCount === this.inlineCodeTicks) this.inlineCodeTicks = 0;\n      return;\n    }\n\n    if (this.lineStart && tickCount >= 3) {\n      this.inFence = true;\n      return;\n    }\n\n    this.inlineCodeTicks = tickCount;\n  }\n\n  private updateLineState(text: string): void {\n    for (const char of text) {\n      if (char === \"\\n\") {\n        this.lineStart = true;\n      } else if (char !== \"\\r\") {\n        this.lineStart = false;\n      }\n    }\n  }\n}\n\nexport async function resolveAssistantWikiLinks(\n  text: string,\n  resolve: WikiLinkResolver,\n): Promise<string> {\n  const filter = new AssistantWikiLinkFilter(resolve);\n  return (await filter.push(text)) + (await filter.flush());\n}\n\nexport function createAssistantWikiLinkFilter(options: {\n  currentSourcePath: string;\n  resolveWikiLink?: AssistantWikiLinkResolver;\n}): AssistantWikiLinkFilter {\n  return new AssistantWikiLinkFilter(async (target) =>\n    options.resolveWikiLink?.(options.currentSourcePath, target),\n  );\n}\n\nasync function renderWikiLink(\n  rawValue: string,\n  resolve: WikiLinkResolver,\n): Promise<string> {\n  const parsed = parseWikiLink(rawValue);\n  if (!parsed) return rawValue;\n\n  const citation = await resolve(parsed.target);\n  if (!citation) return escapeMarkdownText(parsed.label);\n\n  return `[${escapeMarkdownLinkLabel(parsed.label)}](${citation.href})`;\n}\n\nfunction parseWikiLink(\n  rawValue: string,\n): { target: string; label: string } | undefined {\n  const pipeIndex = findUnescapedPipe(rawValue);\n  const rawTarget = pipeIndex === -1 ? rawValue : rawValue.slice(0, pipeIndex);\n  const rawLabel = pipeIndex === -1 ? rawTarget : rawValue.slice(pipeIndex + 1);\n  const target = unescapeWikiText(rawTarget).trim();\n  const label = unescapeWikiText(rawLabel).trim() || target;\n  if (!target) return undefined;\n  return { target, label };\n}\n\nfunction findUnescapedPipe(value: string): number {\n  for (let index = 0; index < value.length; index += 1) {\n    if (value[index] !== \"|\") continue;\n    let slashCount = 0;\n    for (\n      let cursor = index - 1;\n      cursor >= 0 && value[cursor] === \"\\\\\";\n      cursor -= 1\n    ) {\n      slashCount += 1;\n    }\n    if (slashCount % 2 === 0) return index;\n  }\n  return -1;\n}\n\nfunction countBackticks(value: string, start: number): number {\n  let count = 0;\n  while (value[start + count] === \"`\") count += 1;\n  return count;\n}\n\nfunction unescapeWikiText(value: string): string {\n  return value.replace(/\\\\([\\\\|])/g, \"$1\");\n}\n\nfunction escapeMarkdownLinkLabel(value: string): string {\n  return value.replace(/([\\\\[\\]])/g, \"\\\\$1\");\n}\n\nfunction escapeMarkdownText(value: string): string {\n  return value.replace(/([\\\\[\\]])/g, \"\\\\$1\");\n}\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/** A source page the assistant used to answer a question. */
+type AssistantCitation = {
+    slug: string;
+    title: string;
+    href: string;
+    /** Path of the original markdown file relative to the content root. */
+    sourcePath: string;
+};
+/** One user turn of the client-held conversation transcript. */
+type AssistantUserTranscriptMessage = {
+    id: string;
+    previousMessageId: string | null;
+    role: "user";
+    content: string;
+};
+/** One assistant turn signed by the server for stateless transcript replay. */
+type AssistantSignedTranscriptMessage = {
+    id: string;
+    previousMessageId: string | null;
+    role: "assistant";
+    content: string;
+    signature: string;
+};
+/** One turn of the client-held conversation transcript. */
+type AssistantTranscriptMessage = AssistantUserTranscriptMessage | AssistantSignedTranscriptMessage;
+/** Request body of `POST /api/assistant`. */
+type AssistantRequest = {
+    messages: AssistantTranscriptMessage[];
+    responseMessageId: string;
+    /** Current page source path relative to the assistant content root. */
+    currentSourcePath?: string;
+    /** Fallback route slug used when the client cannot provide a source path. */
+    currentSlug?: string;
+};
+/**
+ * Newline-delimited JSON events streamed back by the assistant route.
+ */
+type AssistantStreamEvent = {
+    type: "text-delta";
+    text: string;
+} | {
+    type: "tool-status";
+    command: string;
+} | {
+    type: "citations";
+    citations: AssistantCitation[];
+} | {
+    type: "message-signature";
+    id: string;
+    previousMessageId: string | null;
+    signature: string;
+} | {
+    type: "done";
+} | {
+    type: "error";
+    message: string;
+};
+/** Resolves a model-reported source path to a published page citation. */
+type AssistantCitationResolver = (sourcePath: string) => AssistantCitation | undefined | Promise<AssistantCitation | undefined>;
+/** Resolves an Obsidian-style wikilink target from a current source page. */
+type AssistantWikiLinkResolver = (currentSourcePath: string, target: string) => AssistantCitation | undefined | Promise<AssistantCitation | undefined>;
+/** Knowledge-site context the server runtime operates on. */
+type AssistantSiteContext = {
+    siteTitle: string;
+    siteDescription?: string;
+    homePage?: {
+        title: string;
+        sourcePath: string;
+        excerpt: string;
+    };
+    currentPage?: {
+        title: string;
+        slug: string;
+        sourcePath: string;
+        excerpt: string;
+    };
+    /** Filesystem directory mounted read-only as `/` for shell tools. */
+    contentRoot: string;
+    resolveCitation: AssistantCitationResolver;
+    resolveWikiLink?: AssistantWikiLinkResolver;
+};
+
+export type { AssistantCitation, AssistantCitationResolver, AssistantRequest, AssistantSignedTranscriptMessage, AssistantSiteContext, AssistantStreamEvent, AssistantTranscriptMessage, AssistantUserTranscriptMessage, AssistantWikiLinkResolver };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ui/index.d.ts

@@ -0,0 +1,6 @@
+export { AssistantChatMessage, AssistantContextValue, AssistantProvider, AssistantProviderProps, useAssistant } from './provider.js';
+export { AssistantTrigger, AssistantTriggerProps } from './trigger.js';
+export { AssistantPanel, AssistantPanelProps } from './panel.js';
+export { AssistantMessage, AssistantMessageProps } from './message.js';
+export { AssistantCitation, AssistantStreamEvent, AssistantTranscriptMessage } from '../types.js';
+import 'react';

package/dist/ui/index.js

@@ -0,0 +1,15 @@
+import {
+  AssistantProvider,
+  useAssistant
+} from "./provider.js";
+import { AssistantTrigger } from "./trigger.js";
+import { AssistantPanel } from "./panel.js";
+import { AssistantMessage } from "./message.js";
+export {
+  AssistantMessage,
+  AssistantPanel,
+  AssistantProvider,
+  AssistantTrigger,
+  useAssistant
+};
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ui/index.ts"],"sourcesContent":["export {\n  AssistantProvider,\n  useAssistant,\n  type AssistantChatMessage,\n  type AssistantContextValue,\n  type AssistantProviderProps,\n} from \"./provider.js\";\nexport { AssistantTrigger, type AssistantTriggerProps } from \"./trigger.js\";\nexport { AssistantPanel, type AssistantPanelProps } from \"./panel.js\";\nexport { AssistantMessage, type AssistantMessageProps } from \"./message.js\";\nexport type {\n  AssistantCitation,\n  AssistantStreamEvent,\n  AssistantTranscriptMessage,\n} from \"../types.js\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP,SAAS,wBAAoD;AAC7D,SAAS,sBAAgD;AACzD,SAAS,wBAAoD;","names":[]}

package/dist/ui/message.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import { AssistantChatMessage } from './provider.js';
+import '../types.js';
+
+type AssistantMessageProps = {
+    message: AssistantChatMessage;
+    onRetry: () => void;
+};
+declare function AssistantMessage({ message, onRetry }: AssistantMessageProps): React.JSX.Element;
+
+export { AssistantMessage, type AssistantMessageProps };

package/dist/ui/message.js

@@ -0,0 +1,114 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import ReactMarkdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { SilicaLink } from "@silicajs/components";
+import { cn } from "@silicajs/ui/lib/utils";
+import { Button } from "@silicajs/ui/components/button";
+import {
+  ChevronDownIcon,
+  FileTextIcon,
+  LoaderCircleIcon,
+  SearchIcon,
+  TerminalIcon
+} from "lucide-react";
+function AssistantMessage({ message, onRetry }) {
+  if (message.role === "user") {
+    return /* @__PURE__ */ jsx("div", { className: "flex min-w-0 justify-end", children: /* @__PURE__ */ jsx("div", { className: "min-w-0 max-w-[85%] rounded-xl rounded-br-sm bg-muted px-3 py-2 text-sm whitespace-pre-wrap break-words text-foreground", children: message.content }) });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 max-w-full flex-col gap-2 overflow-hidden", children: [
+    message.commands.length > 0 || message.state === "streaming" && !message.content ? /* @__PURE__ */ jsx(
+      AssistantActivity,
+      {
+        commands: message.commands,
+        searching: message.state === "streaming" && !message.content
+      }
+    ) : null,
+    message.content ? /* @__PURE__ */ jsx("div", { className: "prose prose-sm dark:prose-invert min-w-0 max-w-none break-words text-sm", children: /* @__PURE__ */ jsx(
+      ReactMarkdown,
+      {
+        remarkPlugins: [remarkGfm],
+        components: { a: MarkdownLink },
+        children: message.content
+      }
+    ) }) : null,
+    message.state === "error" ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-start gap-2 rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-destructive", children: message.error ?? "Something went wrong." }),
+      /* @__PURE__ */ jsx(Button, { type: "button", variant: "outline", size: "sm", onClick: onRetry, children: "Retry" })
+    ] }) : null,
+    message.citations.length > 0 ? /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: message.citations.map((citation) => /* @__PURE__ */ jsxs(
+      SilicaLink,
+      {
+        href: citation.href,
+        className: "inline-flex max-w-full items-center gap-1.5 rounded-full border border-border px-2.5 py-1 text-xs text-muted-foreground transition-colors hover:border-primary/40 hover:text-foreground",
+        children: [
+          /* @__PURE__ */ jsx(FileTextIcon, { className: "size-3 shrink-0" }),
+          /* @__PURE__ */ jsx("span", { className: "truncate", children: citation.title })
+        ]
+      },
+      citation.slug
+    )) }) : null
+  ] });
+}
+function AssistantActivity({
+  commands,
+  searching
+}) {
+  const [expanded, setExpanded] = React.useState(false);
+  if (commands.length === 0) {
+    return /* @__PURE__ */ jsx("div", { className: "flex min-w-0 max-w-full flex-col gap-1.5 overflow-hidden text-xs text-muted-foreground", children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 self-start", children: [
+      /* @__PURE__ */ jsx(LoaderCircleIcon, { className: "size-3.5 shrink-0 animate-spin" }),
+      /* @__PURE__ */ jsx("span", { children: "Thinking\u2026" })
+    ] }) });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 max-w-full flex-col gap-1.5 overflow-hidden text-xs text-muted-foreground", children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: () => setExpanded((value) => !value),
+        "aria-expanded": expanded,
+        className: "group flex items-center gap-2 self-start rounded-md text-left transition-colors hover:text-foreground",
+        children: [
+          searching ? /* @__PURE__ */ jsx(LoaderCircleIcon, { className: "size-3.5 shrink-0 animate-spin" }) : /* @__PURE__ */ jsx(SearchIcon, { className: "size-3.5 shrink-0" }),
+          /* @__PURE__ */ jsx("span", { children: searching ? "Searching the site\u2026" : "Searched the site" }),
+          /* @__PURE__ */ jsx(
+            ChevronDownIcon,
+            {
+              className: cn(
+                "size-3.5 shrink-0 transition-transform",
+                expanded && "rotate-180"
+              )
+            }
+          )
+        ]
+      }
+    ),
+    expanded ? /* @__PURE__ */ jsx("ul", { className: "flex min-w-0 max-w-full flex-col gap-1 overflow-hidden pl-[1.375rem]", children: commands.map((command, index) => /* @__PURE__ */ jsxs(
+      "li",
+      {
+        className: "flex min-w-0 max-w-full items-center gap-2 overflow-hidden",
+        children: [
+          /* @__PURE__ */ jsx(TerminalIcon, { className: "size-3 shrink-0" }),
+          /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 overflow-hidden", children: /* @__PURE__ */ jsx("code", { className: "block truncate font-mono", children: command }) })
+        ]
+      },
+      `${index}-${command}`
+    )) }) : null
+  ] });
+}
+function MarkdownLink({
+  href = "",
+  children,
+  ...props
+}) {
+  if (href.startsWith("/")) {
+    return /* @__PURE__ */ jsx(SilicaLink, { href, ...props, children });
+  }
+  return /* @__PURE__ */ jsx("a", { href, target: "_blank", rel: "noreferrer", ...props, children });
+}
+export {
+  AssistantMessage
+};
+//# sourceMappingURL=message.js.map

package/dist/ui/message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ui/message.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport ReactMarkdown from \"react-markdown\";\nimport remarkGfm from \"remark-gfm\";\nimport { SilicaLink } from \"@silicajs/components\";\nimport { cn } from \"@silicajs/ui/lib/utils\";\nimport { Button } from \"@silicajs/ui/components/button\";\nimport {\n  ChevronDownIcon,\n  FileTextIcon,\n  LoaderCircleIcon,\n  SearchIcon,\n  TerminalIcon,\n} from \"lucide-react\";\nimport type { AssistantChatMessage } from \"./provider.js\";\n\nexport type AssistantMessageProps = {\n  message: AssistantChatMessage;\n  onRetry: () => void;\n};\n\nexport function AssistantMessage({ message, onRetry }: AssistantMessageProps) {\n  if (message.role === \"user\") {\n    return (\n      <div className=\"flex min-w-0 justify-end\">\n        <div className=\"min-w-0 max-w-[85%] rounded-xl rounded-br-sm bg-muted px-3 py-2 text-sm whitespace-pre-wrap break-words text-foreground\">\n          {message.content}\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"flex min-w-0 max-w-full flex-col gap-2 overflow-hidden\">\n      {message.commands.length > 0 ||\n      (message.state === \"streaming\" && !message.content) ? (\n        <AssistantActivity\n          commands={message.commands}\n          searching={message.state === \"streaming\" && !message.content}\n        />\n      ) : null}\n      {message.content ? (\n        <div className=\"prose prose-sm dark:prose-invert min-w-0 max-w-none break-words text-sm\">\n          <ReactMarkdown\n            remarkPlugins={[remarkGfm]}\n            components={{ a: MarkdownLink }}\n          >\n            {message.content}\n          </ReactMarkdown>\n        </div>\n      ) : null}\n      {message.state === \"error\" ? (\n        <div className=\"flex flex-col items-start gap-2 rounded-lg border border-destructive/30 bg-destructive/5 px-3 py-2\">\n          <p className=\"text-sm text-destructive\">\n            {message.error ?? \"Something went wrong.\"}\n          </p>\n          <Button type=\"button\" variant=\"outline\" size=\"sm\" onClick={onRetry}>\n            Retry\n          </Button>\n        </div>\n      ) : null}\n      {message.citations.length > 0 ? (\n        <div className=\"flex flex-wrap gap-1.5\">\n          {message.citations.map((citation) => (\n            <SilicaLink\n              key={citation.slug}\n              href={citation.href}\n              className=\"inline-flex max-w-full items-center gap-1.5 rounded-full border border-border px-2.5 py-1 text-xs text-muted-foreground transition-colors hover:border-primary/40 hover:text-foreground\"\n            >\n              <FileTextIcon className=\"size-3 shrink-0\" />\n              <span className=\"truncate\">{citation.title}</span>\n            </SilicaLink>\n          ))}\n        </div>\n      ) : null}\n    </div>\n  );\n}\n\nfunction AssistantActivity({\n  commands,\n  searching,\n}: {\n  commands: string[];\n  /** True only while still gathering pages (before the answer streams). */\n  searching: boolean;\n}) {\n  const [expanded, setExpanded] = React.useState(false);\n\n  // Searching has begun but no command has run yet: a plain progress line.\n  // Keep the row markup identical to the toggle below so swapping between the\n  // two states does not shift anything vertically.\n  if (commands.length === 0) {\n    return (\n      <div className=\"flex min-w-0 max-w-full flex-col gap-1.5 overflow-hidden text-xs text-muted-foreground\">\n        <div className=\"flex items-center gap-2 self-start\">\n          <LoaderCircleIcon className=\"size-3.5 shrink-0 animate-spin\" />\n          <span>Thinking…</span>\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div className=\"flex min-w-0 max-w-full flex-col gap-1.5 overflow-hidden text-xs text-muted-foreground\">\n      <button\n        type=\"button\"\n        onClick={() => setExpanded((value) => !value)}\n        aria-expanded={expanded}\n        className=\"group flex items-center gap-2 self-start rounded-md text-left transition-colors hover:text-foreground\"\n      >\n        {searching ? (\n          <LoaderCircleIcon className=\"size-3.5 shrink-0 animate-spin\" />\n        ) : (\n          <SearchIcon className=\"size-3.5 shrink-0\" />\n        )}\n        <span>{searching ? \"Searching the site…\" : \"Searched the site\"}</span>\n        <ChevronDownIcon\n          className={cn(\n            \"size-3.5 shrink-0 transition-transform\",\n            expanded && \"rotate-180\",\n          )}\n        />\n      </button>\n      {expanded ? (\n        <ul className=\"flex min-w-0 max-w-full flex-col gap-1 overflow-hidden pl-[1.375rem]\">\n          {commands.map((command, index) => (\n            <li\n              key={`${index}-${command}`}\n              className=\"flex min-w-0 max-w-full items-center gap-2 overflow-hidden\"\n            >\n              <TerminalIcon className=\"size-3 shrink-0\" />\n              <span className=\"min-w-0 flex-1 overflow-hidden\">\n                <code className=\"block truncate font-mono\">{command}</code>\n              </span>\n            </li>\n          ))}\n        </ul>\n      ) : null}\n    </div>\n  );\n}\n\nfunction MarkdownLink({\n  href = \"\",\n  children,\n  ...props\n}: React.AnchorHTMLAttributes<HTMLAnchorElement>) {\n  if (href.startsWith(\"/\")) {\n    return (\n      <SilicaLink href={href} {...props}>\n        {children}\n      </SilicaLink>\n    );\n  }\n  return (\n    <a href={href} target=\"_blank\" rel=\"noreferrer\" {...props}>\n      {children}\n    </a>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/ui/panel.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+type AssistantPanelProps = {
+    className?: string;
+};
+/**
+ * The assistant chat window: header, conversation, and composer. Fills its
+ * container; themes decide where and how to present it (docked sidebar,
+ * overlay, …) and typically mount it only while the assistant is open.
+ */
+declare function AssistantPanel({ className }: AssistantPanelProps): React.JSX.Element | null;
+
+export { AssistantPanel, type AssistantPanelProps };

package/dist/ui/panel.js

@@ -0,0 +1,201 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Button } from "@silicajs/ui/components/button";
+import { Textarea } from "@silicajs/ui/components/textarea";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger
+} from "@silicajs/ui/components/tooltip";
+import { cn } from "@silicajs/ui/lib/utils";
+import {
+  ArrowUpIcon,
+  SparklesIcon,
+  SquareIcon,
+  SquarePenIcon,
+  XIcon
+} from "lucide-react";
+import { AssistantMessage } from "./message.js";
+import { useAssistant } from "./provider.js";
+function AssistantPanel({ className }) {
+  const assistant = useAssistant();
+  const scrollRef = React.useRef(null);
+  const open = assistant?.open ?? false;
+  const messageCount = assistant?.messages.length ?? 0;
+  const lastMessage = assistant?.messages.at(-1);
+  React.useEffect(() => {
+    const node = scrollRef.current;
+    if (node) node.scrollTop = node.scrollHeight;
+  }, [
+    messageCount,
+    lastMessage?.content,
+    lastMessage?.state,
+    lastMessage?.commands.length
+  ]);
+  if (!assistant) return null;
+  return /* @__PURE__ */ jsxs(
+    "aside",
+    {
+      "aria-label": "AI assistant",
+      className: cn(
+        "flex h-full min-h-0 w-full min-w-0 flex-col bg-background",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxs("header", { className: "flex h-12 shrink-0 items-center gap-2 px-3", children: [
+          /* @__PURE__ */ jsx(SparklesIcon, { className: "size-4 text-primary" }),
+          /* @__PURE__ */ jsx("span", { className: "flex-1 text-sm font-semibold tracking-tight", children: "Assistant" }),
+          assistant.messages.length > 0 ? /* @__PURE__ */ jsxs(Tooltip, { children: [
+            /* @__PURE__ */ jsx(
+              TooltipTrigger,
+              {
+                render: /* @__PURE__ */ jsxs(
+                  Button,
+                  {
+                    type: "button",
+                    variant: "ghost",
+                    size: "icon-sm",
+                    onClick: assistant.reset,
+                    children: [
+                      /* @__PURE__ */ jsx(SquarePenIcon, {}),
+                      /* @__PURE__ */ jsx("span", { className: "sr-only", children: "New conversation" })
+                    ]
+                  }
+                )
+              }
+            ),
+            /* @__PURE__ */ jsx(TooltipContent, { side: "bottom", children: "New conversation" })
+          ] }) : null,
+          /* @__PURE__ */ jsxs(Tooltip, { children: [
+            /* @__PURE__ */ jsx(
+              TooltipTrigger,
+              {
+                render: /* @__PURE__ */ jsxs(
+                  Button,
+                  {
+                    type: "button",
+                    variant: "ghost",
+                    size: "icon-sm",
+                    onClick: () => assistant.setOpen(false),
+                    children: [
+                      /* @__PURE__ */ jsx(XIcon, {}),
+                      /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Close assistant" })
+                    ]
+                  }
+                )
+              }
+            ),
+            /* @__PURE__ */ jsx(TooltipContent, { side: "bottom", children: "Close assistant" })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            ref: scrollRef,
+            className: "min-w-0 flex-1 overflow-x-hidden overflow-y-auto",
+            children: assistant.messages.length === 0 ? /* @__PURE__ */ jsxs("div", { className: "flex h-full flex-col items-center justify-center gap-2 px-8 text-center", children: [
+              /* @__PURE__ */ jsx(SparklesIcon, { className: "size-6 text-muted-foreground/60" }),
+              /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-foreground", children: "Ask anything" }),
+              /* @__PURE__ */ jsx("p", { className: "text-xs leading-relaxed text-muted-foreground", children: "Answers come from this site's pages and include links to the sources used." })
+            ] }) : /* @__PURE__ */ jsx("div", { className: "flex min-w-0 flex-col gap-5 px-4 py-4", children: assistant.messages.map((message) => /* @__PURE__ */ jsx(
+              AssistantMessage,
+              {
+                message,
+                onRetry: assistant.retry
+              },
+              message.id
+            )) })
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          AssistantComposer,
+          {
+            isStreaming: assistant.isStreaming,
+            onAsk: assistant.ask,
+            onStop: assistant.stop,
+            focusToken: open
+          }
+        )
+      ]
+    }
+  );
+}
+function AssistantComposer({
+  isStreaming,
+  onAsk,
+  onStop,
+  focusToken
+}) {
+  const [draft, setDraft] = React.useState("");
+  const textareaRef = React.useRef(null);
+  React.useEffect(() => {
+    if (focusToken) textareaRef.current?.focus();
+  }, [focusToken]);
+  const submit = () => {
+    if (isStreaming || !draft.trim()) return;
+    onAsk(draft);
+    setDraft("");
+  };
+  return /* @__PURE__ */ jsx(
+    "form",
+    {
+      className: "shrink-0 px-3 pb-3",
+      onSubmit: (event) => {
+        event.preventDefault();
+        submit();
+      },
+      children: /* @__PURE__ */ jsxs("div", { className: "relative", children: [
+        /* @__PURE__ */ jsx(
+          Textarea,
+          {
+            ref: textareaRef,
+            value: draft,
+            onChange: (event) => setDraft(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key === "Enter" && !event.shiftKey) {
+                event.preventDefault();
+                submit();
+              }
+            },
+            placeholder: "Ask a question\u2026",
+            rows: 2,
+            className: "max-h-40 min-h-14 resize-none pr-11"
+          }
+        ),
+        isStreaming ? /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            size: "icon-sm",
+            className: "absolute bottom-1.5 right-1.5",
+            onClick: onStop,
+            title: "Stop answering",
+            children: [
+              /* @__PURE__ */ jsx(SquareIcon, {}),
+              /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Stop answering" })
+            ]
+          }
+        ) : /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "submit",
+            size: "icon-sm",
+            className: "absolute bottom-1.5 right-1.5",
+            disabled: !draft.trim(),
+            title: "Send question",
+            children: [
+              /* @__PURE__ */ jsx(ArrowUpIcon, {}),
+              /* @__PURE__ */ jsx("span", { className: "sr-only", children: "Send question" })
+            ]
+          }
+        )
+      ] })
+    }
+  );
+}
+export {
+  AssistantPanel
+};
+//# sourceMappingURL=panel.js.map