research-agent-ui 0.1.293 → 0.1.294

package/dist/components/ArticleReader/ExtractPanelContext.d.ts

@@ -1,17 +1,33 @@
 import React, { ReactNode } from 'react';
+/** How the reader should behave once the page is read. */
+export interface OpenPanelOptions {
+    /**
+     * Write questions about the page as soon as its text is in, when it has
+     * none cached — so opening it lands on something to ask, not a blank prompt.
+     */
+    suggestQuestions?: boolean;
+}
 interface ExtractPanelContextType {
     isOpen: boolean;
     url: string;
     searchText: string;
+    /** Set by the last `openPanel` call; see {@link OpenPanelOptions.suggestQuestions}. */
+    suggestQuestions: boolean;
     panelWidth: number;
     setIsOpen: (isOpen: boolean) => void;
     setUrl: (url: string) => void;
     setSearchText: (searchText: string) => void;
     setPanelWidth: (width: number) => void;
-    openPanel: (url: string, searchText?: string) => void;
+    openPanel: (url: string, searchText?: string, options?: OpenPanelOptions) => void;
     closePanel: () => void;
 }
 export declare const useExtractPanel: () => ExtractPanelContextType;
+/**
+ * Like {@link useExtractPanel}, but `undefined` outside an
+ * `ExtractPanelProvider` instead of throwing — for components (the homepage
+ * widgets) that offer the reader when a host provides one and work without it.
+ */
+export declare const useOptionalExtractPanel: () => ExtractPanelContextType;
 export declare const ExtractPanelProvider: React.FC<{
     children: ReactNode;
 }>;

package/dist/components/ChatConversation/MessageBubble/AssistantMessageActions.d.ts

@@ -3,6 +3,7 @@ import { Section } from '../../../hooks/useChat';
 interface AssistantMessageActionsProps {
     section: Section;
     speechStatus: string;
+    isLoadingTTS?: boolean;
     start: () => void;
     stop: () => void;
     handleOpenInLLM: (platform: string) => void;
@@ -11,5 +12,5 @@ interface AssistantMessageActionsProps {
  * Component for message actions related to the assistant's response.
  * Includes rewrite, copy, text-to-speech, export, and external LLM links.
  */
-declare const AssistantMessageActions: ({ section, speechStatus, start, stop, handleOpenInLLM, }: AssistantMessageActionsProps) => React.JSX.Element;
+declare const AssistantMessageActions: ({ section, speechStatus, isLoadingTTS, start, stop, handleOpenInLLM, }: AssistantMessageActionsProps) => React.JSX.Element;
 export default AssistantMessageActions;

package/dist/components/ChatConversation/background-art.d.ts

@@ -1,9 +1,11 @@
 /**
  * @fileoverview Helper functions providing randomized background artwork URLs and time-of-day greeting strings for the chat homepage.
  */
+/** Every background artwork, as the full Imgur URL. */
+export declare const BACKGROUND_ARTWORKS: readonly string[];
 /**
  * Gets a random artistic background about graph theory
- * and collective consciousness, 50+ AI-gen artworks found online
+ * and collective consciousness
  * @returns {string} Imgur URL of random artistic background
  */
 export declare function getBackgroundArtwork(): string;

package/dist/components/ChatConversation/background-cache.d.ts

@@ -0,0 +1,41 @@
+/** The Cache Storage bucket the artwork lives in. Bump to drop old entries. */
+export declare const BACKGROUND_CACHE_NAME = "qwksearch-background-art-v1";
+/** The `localStorage` key holding the URLs in the cache, oldest first. */
+export declare const BACKGROUND_CACHE_LIST_KEY = "backgroundArtCache";
+/**
+ * How many pieces are kept. Once full, the homepage rotates through these and
+ * stops downloading, since some of the pieces are multi-megabyte video.
+ */
+export declare const MAX_CACHED_BACKGROUNDS = 10;
+/** A piece larger than this is still shown, but not stored. */
+export declare const MAX_CACHED_BACKGROUND_BYTES: number;
+/**
+ * The cached URLs, oldest first. Anything that is not (or is no longer) one of
+ * the artworks is dropped, so a stale or hand-edited entry can never be loaded.
+ */
+export declare function readCachedBackgroundList(): string[];
+/**
+ * Records `url` as cached (most recent last) and returns the URLs that fell off
+ * the end of the list, which the caller deletes from Cache Storage.
+ */
+export declare function rememberCachedBackground(url: string): string[];
+/** Drops `url` from the list, e.g. when its cache entry has gone missing. */
+export declare function forgetCachedBackground(url: string): void;
+/** A random cached piece other than `exclude`, or `null` if there is none. */
+export declare function pickCachedBackground(exclude?: string | null): string | null;
+/** A random piece that is not cached yet, or `null` once every one is. */
+export declare function pickUncachedBackground(): string | null;
+/**
+ * Reads a cached piece back as an object URL the page can display, without
+ * touching the network. Returns `null` if it is not actually in the cache, in
+ * which case it is also dropped from the list.
+ */
+export declare function loadCachedBackground(url: string): Promise<string | null>;
+/**
+ * Downloads a piece, stores it and records it in the list, evicting the oldest
+ * past {@link MAX_CACHED_BACKGROUNDS}. Returns what the page should display:
+ * an object URL of the download, or the plain URL where it cannot be cached
+ * (no Cache Storage, or the fetch was refused), so the element loads it from
+ * the network as it always did. Returns `null` for a failed download.
+ */
+export declare function cacheBackground(url: string): Promise<string | null>;

package/dist/components/Footer.d.ts

@@ -14,10 +14,11 @@ interface FooterProps {
 /**
  * Footer component that displays a list of links with optional icons.
  *
- * On desktop the links render as a bar pinned to the bottom-center of the screen.
- * On mobile the bar is collapsed into a small info icon in the bottom corner that,
- * when tapped, reveals the same links in a popover — keeping the chat input clear
- * of the footer and the OS app dock.
+ * The links render as a single compact line at every width, in normal flow,
+ * so the parent decides where it sits (the homepage puts it directly under
+ * the weather widget). Below the `sm` breakpoint the icons
+ * are dropped and the labels shrink so all of the links fit on one line on a
+ * phone.
  *
  * @param listFooterLinks - Array of footer links with their properties
  * @param optionShowIcons - Whether to show icons next to links (default: true)

package/dist/components/Footer.stories.d.ts

@@ -1,9 +1,9 @@
 import type { Meta, StoryObj } from '@storybook/react-vite';
 import Footer from './Footer';
 /**
- * `Footer` renders a compact bar of links (with optional Lucide icons) pinned
- * to the bottom of the screen. On small screens it collapses into an info icon
- * that reveals the links in a popover. `icon` values are Lucide icon names.
+ * `Footer` renders a compact bar of links (with optional Lucide icons) in the
+ * normal flow, on a single line at every width; below `sm` the
+ * icons are hidden so the labels still fit. `icon` values are Lucide icon names.
  */
 declare const meta: Meta<typeof Footer>;
 export default meta;

package/dist/config.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={appName:`QwkSearch`,defaultSummarizePrompt:`Summarize in bullet points and bold topics`,maxArticleLength:1500,downloadChromeUrl:`https://chromewebstore.google.com/detail/tab-manager-ai/manhemnhmipdhdpabojcplebckhckeko`,downloadWindowsStoreId:`9PCGF9GNK460`,footerLinks:[],googleApiKey:``,googleAppId:``,getAutoMediaSearch:()=>!0,appIconUrl:`/apple-touch-icon.png`,trendingNewsApiUrl:`/api/news/trending`,trendingNewsSettingsUrl:`/api/news/settings`};function t(t){Object.assign(e,t)}exports.configureResearchAgentUI=t,exports.researchAgentUIConfig=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={appName:`QwkSearch`,defaultSummarizePrompt:`Summarize in bullet points and bold topics`,maxArticleLength:1500,downloadChromeUrl:`https://chromewebstore.google.com/detail/tab-manager-ai/manhemnhmipdhdpabojcplebckhckeko`,downloadWindowsStoreId:`9PCGF9GNK460`,footerLinks:[],googleApiKey:``,googleAppId:``,getAutoMediaSearch:()=>!0,appIconUrl:`/apple-touch-icon.png`,trendingNewsApiUrl:`/api/news/trending`,trendingNewsSettingsUrl:`/api/news/settings`,educationPlaylistsApiUrl:`/api/learn`,educationPlaylistsPageUrl:`/learn`};function t(t){Object.assign(e,t)}exports.configureResearchAgentUI=t,exports.researchAgentUIConfig=e;

package/dist/config.d.ts

@@ -79,6 +79,15 @@ export interface ResearchAgentUIConfig {
      * the local settings alone.
      */
     trendingNewsSettingsUrl: string;
+    /**
+     * The education-playlists planner endpoint (`education-playlists/server`
+     * mounted by the host). Defaults to this app's `/api/learn`. Set it to an
+     * empty string on a host without that route: the homepage widget then plans
+     * locally from its bundled catalog, without AI.
+     */
+    educationPlaylistsApiUrl: string;
+    /** Full-page education playlists view the homepage card links to. Empty hides the link. */
+    educationPlaylistsPageUrl: string;
     /**
      * Requests that the settings UI be opened. Lets the consuming app render
      * settings in a modal (e.g. on large desktop screens) instead of navigating

package/dist/config.mjs

@@ -1,4 +1,4 @@
-//#region src/config.ts
+// src/config.ts
 var e = {
 	appName: "QwkSearch",
 	defaultSummarizePrompt: "Summarize in bullet points and bold topics",
@@ -11,10 +11,11 @@ var e = {
 	getAutoMediaSearch: () => !0,
 	appIconUrl: "/apple-touch-icon.png",
 	trendingNewsApiUrl: "/api/news/trending",
-	trendingNewsSettingsUrl: "/api/news/settings"
+	trendingNewsSettingsUrl: "/api/news/settings",
+	educationPlaylistsApiUrl: "/api/learn",
+	educationPlaylistsPageUrl: "/learn"
 };
 function t(t) {
 	Object.assign(e, t);
 }
-//#endregion
 export { t as configureResearchAgentUI, e as researchAgentUIConfig };

package/dist/dialog-7GDz0sWx.cjs

@@ -0,0 +1 @@
+const e=require("./rolldown-runtime-BocRIvOZ.cjs");let t=require("react");t=e.t(t,1);let n=require("react/jsx-runtime"),r=require("lucide-react"),i=require("clsx"),a=require("tailwind-merge"),o=require("@radix-ui/react-dialog");o=e.t(o,1);function s(...e){return(0,a.twMerge)((0,i.clsx)(e))}var c=e=>{let t=new Date(e);return Number.isNaN(t.getTime())?``:t.toLocaleTimeString([],{hour:`numeric`,minute:`2-digit`})},l=(e,t)=>{e=new Date(e),t=new Date(t);let n=Math.floor(Math.abs(t.getTime()-e.getTime())/1e3);return n<60?`${n} second${n===1?``:`s`}`:n<3600?`${Math.floor(n/60)} minute${Math.floor(n/60)===1?``:`s`}`:n<86400?`${Math.floor(n/3600)} hour${Math.floor(n/3600)===1?``:`s`}`:n<31536e3?`${Math.floor(n/86400)} day${Math.floor(n/86400)===1?``:`s`}`:`${Math.floor(n/31536e3)} year${Math.floor(n/31536e3)===1?``:`s`}`};function u({...e}){return(0,n.jsx)(o.Root,{"data-slot":`dialog`,...e})}function d({...e}){return(0,n.jsx)(o.Trigger,{"data-slot":`dialog-trigger`,...e})}function f({...e}){return(0,n.jsx)(o.Portal,{"data-slot":`dialog-portal`,...e})}function p({className:e,...t}){return(0,n.jsx)(o.Overlay,{"data-slot":`dialog-overlay`,className:s(`data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50 backdrop-blur-xs`,e),...t})}function m({className:e,children:t,hideCloseButton:i=!1,...a}){return(0,n.jsxs)(f,{"data-slot":`dialog-portal`,children:[(0,n.jsx)(p,{}),(0,n.jsxs)(o.Content,{"data-slot":`dialog-content`,"aria-describedby":a[`aria-describedby`]??void 0,className:s(`z-[9999] bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-2xl border p-6 shadow-lg duration-200`,e),...a,children:[t,!i&&(0,n.jsxs)(o.Close,{className:`ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4`,children:[(0,n.jsx)(r.XIcon,{}),(0,n.jsx)(`span`,{className:`sr-only`,children:`Close`})]})]})]})}function h({className:e,...t}){return(0,n.jsx)(o.Title,{"data-slot":`dialog-title`,className:s(`text-lg leading-none font-semibold`,e),...t})}function g({className:e,...t}){return(0,n.jsx)(o.Description,{"data-slot":`dialog-description`,className:s(`text-muted-foreground text-sm`,e),...t})}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});

package/dist/dialog-Cufn2u50.js

@@ -0,0 +1,80 @@
+import "react";
+import { jsx as e, jsxs as t } from "react/jsx-runtime";
+import { XIcon as n } from "lucide-react";
+import { clsx as r } from "clsx";
+import { twMerge as i } from "tailwind-merge";
+import * as a from "@radix-ui/react-dialog";
+// src/lib/utils.ts
+function o(...e) {
+	return i(r(e));
+}
+var s = (e) => {
+	let t = new Date(e);
+	return Number.isNaN(t.getTime()) ? "" : t.toLocaleTimeString([], {
+		hour: "numeric",
+		minute: "2-digit"
+	});
+}, c = (e, t) => {
+	e = new Date(e), t = new Date(t);
+	let n = Math.floor(Math.abs(t.getTime() - e.getTime()) / 1e3);
+	return n < 60 ? `${n} second${n === 1 ? "" : "s"}` : n < 3600 ? `${Math.floor(n / 60)} minute${Math.floor(n / 60) === 1 ? "" : "s"}` : n < 86400 ? `${Math.floor(n / 3600)} hour${Math.floor(n / 3600) === 1 ? "" : "s"}` : n < 31536e3 ? `${Math.floor(n / 86400)} day${Math.floor(n / 86400) === 1 ? "" : "s"}` : `${Math.floor(n / 31536e3)} year${Math.floor(n / 31536e3) === 1 ? "" : "s"}`;
+};
+// src/ui/dialog.tsx
+function l({ ...t }) {
+	return /* @__PURE__ */ e(a.Root, {
+		"data-slot": "dialog",
+		...t
+	});
+}
+function u({ ...t }) {
+	return /* @__PURE__ */ e(a.Trigger, {
+		"data-slot": "dialog-trigger",
+		...t
+	});
+}
+function d({ ...t }) {
+	return /* @__PURE__ */ e(a.Portal, {
+		"data-slot": "dialog-portal",
+		...t
+	});
+}
+function f({ className: t, ...n }) {
+	return /* @__PURE__ */ e(a.Overlay, {
+		"data-slot": "dialog-overlay",
+		className: o("data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50 backdrop-blur-xs", t),
+		...n
+	});
+}
+function p({ className: r, children: i, hideCloseButton: s = !1, ...c }) {
+	return /* @__PURE__ */ t(d, {
+		"data-slot": "dialog-portal",
+		children: [/* @__PURE__ */ e(f, {}), /* @__PURE__ */ t(a.Content, {
+			"data-slot": "dialog-content",
+			"aria-describedby": c["aria-describedby"] ?? void 0,
+			className: o("z-[9999] bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-2xl border p-6 shadow-lg duration-200", r),
+			...c,
+			children: [i, !s && /* @__PURE__ */ t(a.Close, {
+				className: "ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+				children: [/* @__PURE__ */ e(n, {}), /* @__PURE__ */ e("span", {
+					className: "sr-only",
+					children: "Close"
+				})]
+			})]
+		})]
+	});
+}
+function m({ className: t, ...n }) {
+	return /* @__PURE__ */ e(a.Title, {
+		"data-slot": "dialog-title",
+		className: o("text-lg leading-none font-semibold", t),
+		...n
+	});
+}
+function h({ className: t, ...n }) {
+	return /* @__PURE__ */ e(a.Description, {
+		"data-slot": "dialog-description",
+		className: o("text-muted-foreground text-sm", t),
+		...n
+	});
+}
+export { u as a, c, m as i, p as n, o, h as r, s, l as t };

package/dist/hooks/voice/useKokoroTTS.d.ts

@@ -1,3 +1,4 @@
+import { KokoroLoadProgress } from '../../lib/kokoro';
 type SpeechStatus = 'idle' | 'loading' | 'generating' | 'playing' | 'error';
 interface UseKokoroTTSOptions {
     autoPreload?: boolean;
@@ -8,6 +9,7 @@ export declare function useKokoroTTS(text: string, options?: UseKokoroTTSOptions
     voices: string[];
     selectedVoice: string;
     error: string;
+    progress: KokoroLoadProgress;
     warmupModel: () => Promise<void>;
     speak: () => Promise<void>;
     stop: () => void;

package/dist/hooks/voice/useTextToVoice.d.ts

@@ -1,4 +1,4 @@
-type SpeechStatus = "started" | "stopped";
+type SpeechStatus = "started" | "stopped" | "loading";
 interface TextToSpeechOptions {
     /** Enable mic-based interruption detection while TTS is playing. Only activates if mic permission is already granted. */
     enableInterrupt?: boolean;
@@ -7,6 +7,7 @@ interface TextToSpeechOptions {
 }
 export declare function useTextToSpeech(text: string, options?: TextToSpeechOptions): {
     speechStatus: SpeechStatus;
+    isLoading: boolean;
     start: () => Promise<void>;
     stop: () => void;
 };

package/dist/index.cjs

@@ -1 +1 @@
-"use client";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./config.cjs"),t=require("./src-r4BsCIB4.cjs");exports.ARTICLE_TOOLBAR_SHORTCUTS=t.O,exports.ArticleAIResponse=t.T,exports.ArticleActionButtons=t.k,exports.ArticleContent=t.C,exports.ArticleFollowupQuestions=t.E,exports.ArticlePanelHeader=t.j,exports.ArticlePromptInput=t.D,exports.CategoryDock=t.o,exports.ChatInputBox=t.M,exports.ChatProvider=t.N,exports.ChatWindow=t.v,exports.CookieConsent=t.a,exports.ExtractPanelProvider=t.U,exports.HistoryDialogs=t.b,exports.HistoryDropdown=t.y,exports.KokoroVoiceSelector=t.c,exports.LexicalArticleViewer=t.w,exports.MainViewProvider=t.g,exports.QwkSearchApp=t.n,exports.QwkSearchProviders=t.r,exports.SPOTLIGHT_LINKS=t.h,exports.SPOTLIGHT_PREFIXES=t.f,exports.SessionProvider=t.P,exports.SpotlightPalette=t.u,exports.UnifiedMarkdown=t.S,exports.VoiceSettingsPanel=t.s,exports.cn=t.G,exports.configureResearchAgentUI=e.configureResearchAgentUI,exports.formatMessageTime=t.K,exports.formatTimeDifference=t.q,exports.formatToolbarShortcut=t.A,exports.matchSpotlight=t.p,exports.openSpotlight=t.d,exports.parsePrefix=t.m,exports.researchAgentUIConfig=e.researchAgentUIConfig,exports.useChat=t.I,exports.useChatState=t.L,exports.useChatTabs=t.t,exports.useChunkErrorReload=t.i,exports.useExtractPanel=t.W,exports.useHistoryState=t.x,exports.useKokoroTTS=t.l,exports.useMainView=t._,exports.useSession=t.F,exports.useTextToSpeech=t.R;
+"use client";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./config.cjs"),t=require("./src-ebmQu_if.cjs"),n=require("./tooltip-DmUO6ZUz.cjs"),r=require("./dialog-7GDz0sWx.cjs");exports.ARTICLE_TOOLBAR_SHORTCUTS=t.D,exports.ArticleAIResponse=t.w,exports.ArticleActionButtons=t.O,exports.ArticleContent=t.S,exports.ArticleFollowupQuestions=t.T,exports.ArticlePanelHeader=t.A,exports.ArticlePromptInput=t.E,exports.ArticleReaderMount=t.R,exports.CategoryDock=t.c,exports.ChatInputBox=t.U,exports.ChatProvider=t.$,exports.ChatWindow=t.L,exports.CookieConsent=t.s,exports.ExtractPanelProvider=n.i,exports.HistoryDialogs=t.B,exports.HistoryDropdown=t.z,exports.KokoroVoiceSelector=t.u,exports.LexicalArticleViewer=t.C,exports.MainViewProvider=t.y,exports.QWKSEARCH_DEFAULT_ORIGIN=t.j,exports.QwkSearchApp=t.n,exports.QwkSearchProviders=t.r,exports.SPOTLIGHT_LINKS=t.v,exports.SPOTLIGHT_PREFIXES=t.h,exports.SessionProvider=n.s,exports.SpotlightPalette=t.p,exports.UnifiedMarkdown=t.x,exports.VoiceSettingsPanel=t.l,exports.buildConnectStartUrl=t.M,exports.cn=r.o,exports.configureResearchAgentUI=e.configureResearchAgentUI,exports.createQwkSearchConnectAuthClient=t.N,exports.formatMessageTime=r.s,exports.formatTimeDifference=r.c,exports.formatToolbarShortcut=t.k,exports.getQwkSearchApiKey=t.P,exports.isChunkLoadError=t.i,exports.isQwkSearchApiRequest=t.F,exports.matchSpotlight=t.g,exports.openSpotlight=t.m,exports.parsePrefix=t._,exports.reloadForChunkError=t.a,exports.researchAgentUIConfig=e.researchAgentUIConfig,exports.setQwkSearchApiKey=t.I,exports.useChat=n.u,exports.useChatState=t.et,exports.useChatTabs=t.t,exports.useChunkErrorReload=t.o,exports.useExtractPanel=n.a,exports.useHistoryState=t.H,exports.useKokoroTTS=t.f,exports.useMainView=t.b,exports.useOptionalExtractPanel=n.o,exports.useSession=n.c,exports.useTextToSpeech=t.d;

package/dist/index.d.ts

@@ -6,7 +6,11 @@ export type { Message, ChatTurn, UserMessage, AssistantMessage, SourceMessage, S
 export { ChatProvider, useChat, useChatState, } from './hooks/useChat';
 export type { ChatContextValue } from './hooks/useChat';
 export { SessionProvider, useSession } from './hooks/useSession';
-export { ExtractPanelProvider, useExtractPanel, } from './components/ArticleReader/ExtractPanelContext';
+export { createQwkSearchConnectAuthClient, setQwkSearchApiKey, getQwkSearchApiKey, buildConnectStartUrl, isQwkSearchApiRequest, QWKSEARCH_DEFAULT_ORIGIN, } from './lib/qwksearch-connect';
+export type { QwkSearchConnectSession, QwkSearchConnectOptions, QwkSearchConnectAuthClient, } from './lib/qwksearch-connect';
+export { ExtractPanelProvider, useExtractPanel, useOptionalExtractPanel, } from './components/ArticleReader/ExtractPanelContext';
+export type { OpenPanelOptions } from './components/ArticleReader/ExtractPanelContext';
+export { default as ArticleReaderMount } from './components/ArticleReader/ArticleReaderMount';
 export * from './components/ArticleReader';
 export { default as HistoryDropdown } from './components/ChatHistoryDropdown';
 export { HistoryDialogs } from './components/ChatHistoryDropdown/HistoryDialogs';

package/dist/index.mjs

@@ -1,5 +1,7 @@
 "use client";
 "use client";
 import { configureResearchAgentUI as e, researchAgentUIConfig as t } from "./config.mjs";
-import { A as n, C as r, D as i, E as a, F as o, G as s, I as c, K as l, L as u, M as d, N as f, O as p, P as m, R as h, S as g, T as _, U as v, W as y, _ as b, a as x, b as S, c as C, d as w, f as T, g as E, h as D, i as O, j as k, k as A, l as j, m as M, n as N, o as P, p as F, q as I, r as L, s as R, t as z, u as B, v as V, w as H, x as U, y as W } from "./src-HL9JjPc-.js";
-export { p as ARTICLE_TOOLBAR_SHORTCUTS, _ as ArticleAIResponse, A as ArticleActionButtons, r as ArticleContent, a as ArticleFollowupQuestions, k as ArticlePanelHeader, i as ArticlePromptInput, P as CategoryDock, d as ChatInputBox, f as ChatProvider, V as ChatWindow, x as CookieConsent, v as ExtractPanelProvider, S as HistoryDialogs, W as HistoryDropdown, C as KokoroVoiceSelector, H as LexicalArticleViewer, E as MainViewProvider, N as QwkSearchApp, L as QwkSearchProviders, D as SPOTLIGHT_LINKS, T as SPOTLIGHT_PREFIXES, m as SessionProvider, B as SpotlightPalette, g as UnifiedMarkdown, R as VoiceSettingsPanel, s as cn, e as configureResearchAgentUI, l as formatMessageTime, I as formatTimeDifference, n as formatToolbarShortcut, F as matchSpotlight, w as openSpotlight, M as parsePrefix, t as researchAgentUIConfig, c as useChat, u as useChatState, z as useChatTabs, O as useChunkErrorReload, y as useExtractPanel, U as useHistoryState, j as useKokoroTTS, b as useMainView, o as useSession, h as useTextToSpeech };
+import { $ as n, A as r, B as i, C as a, D as o, E as s, F as c, H as l, I as u, L as d, M as f, N as p, O as m, P as h, R as g, S as _, T as v, U as y, _ as b, a as x, b as S, c as C, d as w, et as T, f as E, g as D, h as O, i as k, j as A, k as j, l as M, m as N, n as P, o as F, p as I, r as L, s as R, t as z, u as B, v as V, w as H, x as U, y as W, z as G } from "./src-GPr1ceY8.js";
+import { a as K, c as q, i as J, o as Y, s as X, u as Z } from "./tooltip-Bl3IdX-I.js";
+import { c as Q, o as $, s as ee } from "./dialog-Cufn2u50.js";
+export { o as ARTICLE_TOOLBAR_SHORTCUTS, H as ArticleAIResponse, m as ArticleActionButtons, _ as ArticleContent, v as ArticleFollowupQuestions, r as ArticlePanelHeader, s as ArticlePromptInput, g as ArticleReaderMount, C as CategoryDock, y as ChatInputBox, n as ChatProvider, d as ChatWindow, R as CookieConsent, J as ExtractPanelProvider, i as HistoryDialogs, G as HistoryDropdown, B as KokoroVoiceSelector, a as LexicalArticleViewer, W as MainViewProvider, A as QWKSEARCH_DEFAULT_ORIGIN, P as QwkSearchApp, L as QwkSearchProviders, V as SPOTLIGHT_LINKS, O as SPOTLIGHT_PREFIXES, X as SessionProvider, I as SpotlightPalette, U as UnifiedMarkdown, M as VoiceSettingsPanel, f as buildConnectStartUrl, $ as cn, e as configureResearchAgentUI, p as createQwkSearchConnectAuthClient, ee as formatMessageTime, Q as formatTimeDifference, j as formatToolbarShortcut, h as getQwkSearchApiKey, k as isChunkLoadError, c as isQwkSearchApiRequest, D as matchSpotlight, N as openSpotlight, b as parsePrefix, x as reloadForChunkError, t as researchAgentUIConfig, u as setQwkSearchApiKey, Z as useChat, T as useChatState, z as useChatTabs, F as useChunkErrorReload, K as useExtractPanel, l as useHistoryState, E as useKokoroTTS, S as useMainView, Y as useOptionalExtractPanel, q as useSession, w as useTextToSpeech };

package/dist/lib/file-sources.d.ts

@@ -8,6 +8,14 @@
 import { AnyFileSource } from '../types/fileSource';
 export type { FileSource, AnyFileSource } from '../types/fileSource';
 export type { FileSourceType, SSHCredentials, S3Credentials, R2Credentials, B2Credentials, GoogleDocsCredentials, TursoDBCredentials, LocalFileSource, SSHFileSource, S3FileSource, R2FileSource, B2FileSource, GoogleDocsFileSource, TursoDBFileSource } from '../types/fileSource';
+/**
+ * Dispatched on `window` whenever the saved source list changes, so a mounted
+ * sidebar picks up a source added in settings without a reload. The name is
+ * shared with the other copy of these helpers (research-agent-ui's
+ * `file-sources` and react-reason-editor-sidebar's) — both write the same
+ * localStorage key.
+ */
+export declare const FILE_SOURCES_CHANGED_EVENT = "reason-file-sources-changed";
 export declare function getFileSources(): AnyFileSource[];
 export declare function saveFileSources(sources: AnyFileSource[]): void;
 export declare function addFileSource(source: Omit<AnyFileSource, 'id' | 'createdAt' | 'updatedAt'>): AnyFileSource;

package/dist/lib/google-drive-source.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview The "Google Drive" storage source on the client: connecting
+ * Drive with folder access, browsing folders to sync from settings, turning a
+ * synced folder's listing into file-tree documents, and the
+ * `FileSourceProvider` that hands those to `ReasonDocs`.
+ *
+ * Everything goes through this app's `/api/doc/google-docs/*` routes, which
+ * hold the Google tokens in HTTP-only cookies; no token reaches this code.
+ */
+import type { Document, ExternalDocumentView } from 'react-reason-editor-sidebar';
+import type { FileSourceProvider } from 'react-reason-editor/reason-docs';
+import type { AnyFileSource, GoogleDocsCredentials } from '../types/fileSource';
+/** Base path of the app's Google Drive routes. */
+export declare const GOOGLE_DRIVE_API = "/api/doc/google-docs";
+export declare const GOOGLE_FOLDER = "application/vnd.google-apps.folder";
+/** One Drive file or folder as the folder-tree route returns it. */
+export interface DriveItem {
+    id: string;
+    name: string;
+    mimeType: string;
+    parents?: string[];
+    webViewLink?: string;
+    size?: string;
+    modifiedTime?: string;
+}
+/** A folder chosen for sync. `root` stands for all of My Drive. */
+export interface DriveFolderRef {
+    id: string;
+    name: string;
+}
+/** An error from a Drive route, with the flags the settings UI acts on. */
+export declare class GoogleDriveError extends Error {
+    needsReauth: boolean;
+    needsFolderAccess: boolean;
+    status: number;
+    constructor(message: string, status: number, body?: Record<string, unknown>);
+}
+/**
+ * Pulls a Drive folder ID out of whatever the user pasted: a folder link
+ * (`drive.google.com/drive/folders/<id>`, with or without `/u/0`), an
+ * `?id=` link, "My Drive", or a bare ID. Returns `null` when nothing in it
+ * looks like a folder.
+ */
+export declare function parseDriveFolderInput(input: string): string | null;
+/** How a Drive file opens in the workspace. */
+export declare function driveDocumentView(mimeType: string): ExternalDocumentView;
+/** The extension that picks a Drive file's icon in the tree. */
+export declare function driveExtension(item: Pick<DriveItem, 'name' | 'mimeType'>): string | undefined;
+/** Document ID for a Drive file in a source: unique even when two sources share a file. */
+export declare const driveDocumentId: (sourceId: string, fileId: string) => string;
+/** Bytes (or the export) of a Drive file, served by the app. */
+export declare const driveContentUrl: (fileId: string) => string;
+/**
+ * Turns synced folders' listings into the flat, `parentId`-linked document
+ * list the file tree renders. Each synced folder becomes a top-level folder;
+ * a file reachable from two synced folders appears once, under the first.
+ * Folders sort before files, then by name, the way Drive shows them.
+ */
+export declare function driveTreesToDocuments(sourceId: string, trees: Array<{
+    root: DriveItem;
+    items: DriveItem[];
+}>): Document[];
+/** The folders a Google Drive source syncs, newest field first. */
+export declare function sourceFolders(credentials: Partial<GoogleDocsCredentials> | undefined): DriveFolderRef[];
+/**
+ * Lists every synced folder of a Google Drive source as tree documents. A
+ * folder that fails (unshared, deleted) is skipped as long as another one
+ * loads; when all of them fail, the first error is thrown.
+ */
+export declare function listGoogleDriveSource(source: AnyFileSource): Promise<Document[]>;
+/**
+ * Cleans a Google Docs HTML export for the editor. Google styles text through
+ * generated CSS classes (`.c3{font-weight:700}`) in a `<style>` block, which
+ * the editor would drop along with the stylesheet — so bold, italic,
+ * underline and strikethrough are turned into tags first. Then every class,
+ * inline style and id goes, as do Google's `google.com/url?q=` link
+ * redirects, leaving plain semantic HTML.
+ */
+export declare function googleDocHtmlToEditorHtml(html: string): string;
+/** Fetches the body of a Drive document that opens in the editor. */
+export declare function loadGoogleDriveDocumentContent(doc: Document): Promise<string>;
+/** Shows Google Drive storage sources in the `ReasonDocs` file tree. */
+export declare const googleDriveSourceProvider: FileSourceProvider;
+/** Whether Drive is connected, and whether the grant covers folder sync. */
+export declare function getGoogleDriveStatus(): Promise<{
+    isConnected: boolean;
+    canReadFolders: boolean;
+}>;
+/** One folder and the folders directly inside it, for the settings browser. */
+export declare function browseGoogleDriveFolders(parentId?: string): Promise<{
+    folder: DriveFolderRef;
+    folders: DriveFolderRef[];
+}>;
+/**
+ * Connects Google Drive with folder access in a popup. The popup is opened
+ * before the consent URL is fetched, inside the click, so popup blockers let
+ * it through. Resolves `true` once the callback page reports success and
+ * `false` if the user closes the popup first.
+ */
+export declare function connectGoogleDriveFolders(): Promise<boolean>;

package/dist/lib/kokoro.d.ts

@@ -5,8 +5,20 @@ interface Backend {
     dtype: DType;
 }
 export declare function getRecommendedBackend(): Backend;
-export declare function preloadKokoro(): Promise<any>;
-export declare function getKokoro(): Promise<any>;
+export type KokoroLoadProgress = {
+    status: 'initiate' | 'download' | 'progress' | 'progress_total' | 'done' | 'ready';
+    name?: string;
+    file?: string;
+    progress?: number;
+    loaded?: number;
+    total?: number;
+    files?: Record<string, {
+        loaded: number;
+        total: number;
+    }>;
+};
+export declare function preloadKokoro(progressCallback?: (p: KokoroLoadProgress) => void): Promise<any>;
+export declare function getKokoro(progressCallback?: (p: KokoroLoadProgress) => void): Promise<any>;
 export declare function getVoiceList(): Promise<string[]>;
 export declare function getLoadedBackend(): DeviceMode;
 export {};

package/dist/lib/qwksearch-connect.d.ts

@@ -0,0 +1,79 @@
+/** Default QwkSearch origin the embed's API calls go to. */
+export declare const QWKSEARCH_DEFAULT_ORIGIN = "https://qwksearch.com";
+/** What the host's session endpoint answers. */
+export interface QwkSearchConnectSession {
+    connected: boolean;
+    user?: {
+        id: string;
+        name: string;
+        email?: string;
+        image?: string | null;
+    } | null;
+    /** The linked user's QwkSearch API key. */
+    apiKey?: string | null;
+    /** Lower-case QwkSearch plan key (`"free"`, `"pro"`, …). */
+    plan?: string | null;
+    /** Stripe Payment Link that upgrades this QwkSearch account, when on a free plan. */
+    upgradeUrl?: string | null;
+}
+export interface QwkSearchConnectOptions {
+    sessionUrl: string;
+    connectUrl: string;
+    disconnectUrl: string;
+    /** Origin whose `/api/` requests get the key. Defaults to qwksearch.com. */
+    qwksearchOrigin?: string;
+    /** Called with every session the host reports (e.g. to show the plan). */
+    onSession?: (session: QwkSearchConnectSession) => void;
+}
+/** True when `input` targets `<origin>/api/…`. */
+export declare function isQwkSearchApiRequest(input: RequestInfo | URL, origin: string): boolean;
+/**
+ * Sets (or with `null`, clears) the QwkSearch API key the embed sends.
+ * `origin` defaults to qwksearch.com.
+ */
+export declare function setQwkSearchApiKey(key: string | null, origin?: string): void;
+/** The key currently attached to QwkSearch API requests, if any. */
+export declare function getQwkSearchApiKey(): string | null;
+/** Where `connectUrl` should send the visitor back to: the page they are on. */
+export declare function buildConnectStartUrl(connectUrl: string, returnTo?: string): string;
+/**
+ * An auth client for `SessionProvider` (and better-auth-style
+ * `useSession()` callers) that signs in through QwkSearch's connect flow.
+ */
+export declare function createQwkSearchConnectAuthClient(options: QwkSearchConnectOptions): {
+    /** The last session the host reported (no request). */
+    getCachedSession: () => QwkSearchConnectSession;
+    /** Re-reads the host's session endpoint (e.g. after an upgrade). */
+    refresh: () => Promise<QwkSearchConnectSession>;
+    /** Subscribes to session changes; returns an unsubscribe function. */
+    subscribe: (listener: () => void) => () => boolean;
+    getSession: () => Promise<{
+        data: {
+            user: {
+                id: string;
+                name: string;
+                email?: string;
+                image?: string | null;
+            };
+        };
+    }>;
+    oneTap: (_opts?: {
+        fetchOptions: {
+            onSuccess: () => void;
+        };
+    }) => void;
+    signIn: {
+        social: (_opts?: {
+            provider: string;
+            callbackURL: string;
+        }) => void;
+    };
+    signOut: (opts?: {
+        fetchOptions?: {
+            onSuccess?: () => void;
+        };
+    }) => Promise<{
+        data: any;
+    }>;
+};
+export type QwkSearchConnectAuthClient = ReturnType<typeof createQwkSearchConnectAuthClient>;

package/dist/settings/index.d.ts

@@ -57,3 +57,18 @@ export declare function getSettingsSchema(): {
     sections: SettingsSectionSchema[];
     fieldsBySection: Record<string, SettingsFieldSchema[]>;
 };
+/**
+ * One settings section as a standalone page a host can mount in its own
+ * settings area — the "external page" form of {@link SettingsSectionSchema}.
+ */
+export interface SettingsPageSchema extends SettingsSectionSchema {
+    /** Route the host serves this section at, e.g. `/settings/research/models`. */
+    href: string;
+}
+/**
+ * The settings sections as pages under `basePath`, in menu order. A host that
+ * embeds the research agent registers these alongside its own settings pages
+ * (`basePath` is where it mounts the research settings), so every section the
+ * agent exposes is reachable from the host's global settings.
+ */
+export declare function getSettingsPages(basePath?: string): SettingsPageSchema[];