@talk2view/sdk 0.15.0 → 0.16.1

package/dist/chat/lib/launcher-variant.js

@@ -0,0 +1,109 @@
+'use client';
+/**
+ * The launcher's colourway, and whether the visitor has met it before.
+ *
+ * The three colourways are the brand's own logomark pairings (brand book,
+ * "Logo" — each is named for its background):
+ *
+ * | value        | tile   | mark   |
+ * |--------------|--------|--------|
+ * | `smoke-teal` | Teal   | Smoke  |
+ * | `teal-smoke` | Smoke  | Teal   |
+ * | `teal-white` | white  | Teal   |
+ *
+ * The integrator picks one with `colourway`. With `visitorColourway` they also
+ * let the end-user pick, from Settings; that choice is remembered in
+ * localStorage and broadcast on a DOM event, so the launcher repaints the moment
+ * it changes. The paint itself is in `styles/chat.src.css`, keyed on the
+ * `data-launcher-variant` attribute this module's value is written to.
+ */
+import { createContext, useContext, useSyncExternalStore } from 'react';
+export const LAUNCHER_COLOURWAYS = ['smoke-teal', 'teal-smoke', 'teal-white'];
+export const DEFAULT_LAUNCHER_COLOURWAY = 'smoke-teal';
+export const LAUNCHER_COLOURWAY_LABELS = {
+    'smoke-teal': 'Smoke on Teal',
+    'teal-smoke': 'Teal on Smoke',
+    'teal-white': 'Teal on white',
+};
+const COLOURWAY_KEY = 't2v-launcher-colourway';
+const COLOURWAY_EVENT = 't2v-launcher-colourway-changed';
+const isColourway = (value) => typeof value === 'string' && LAUNCHER_COLOURWAYS.includes(value);
+/** The visitor's own choice, or null: they have not made one, or cannot. */
+function readColourway() {
+    try {
+        const stored = localStorage.getItem(COLOURWAY_KEY);
+        return isColourway(stored) ? stored : null;
+    }
+    catch {
+        // A private window, or storage the host page has blocked.
+        return null;
+    }
+}
+function subscribeColourway(onChange) {
+    window.addEventListener(COLOURWAY_EVENT, onChange);
+    window.addEventListener('storage', onChange); // another tab
+    return () => {
+        window.removeEventListener(COLOURWAY_EVENT, onChange);
+        window.removeEventListener('storage', onChange);
+    };
+}
+/** Remember the visitor's choice and repaint every launcher on the page. */
+export function setLauncherColourway(colourway) {
+    try {
+        localStorage.setItem(COLOURWAY_KEY, colourway);
+    }
+    catch {
+        // Without storage the choice lasts until the page reloads.
+    }
+    window.dispatchEvent(new Event(COLOURWAY_EVENT));
+}
+/**
+ * The colourway to paint: the visitor's, when the integrator allows one, else
+ * the integrator's. A remembered choice is ignored — not deleted — when the
+ * integrator takes the option away, so turning it back on restores it.
+ */
+export function useLauncherColourway(fallback, visitorChoice) {
+    const stored = useSyncExternalStore(subscribeColourway, readColourway, () => null);
+    return (visitorChoice && stored) || fallback;
+}
+/* The label beside the mark is an introduction, not furniture: once the visitor
+   has opened the chat they know what the mark is, and the launcher shrinks back
+   to the tile. */
+const OPENED_KEY = 't2v-launcher-opened';
+const OPENED_EVENT = 't2v-launcher-opened-changed';
+function readOpened() {
+    try {
+        return localStorage.getItem(OPENED_KEY) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+function subscribeOpened(onChange) {
+    window.addEventListener(OPENED_EVENT, onChange);
+    return () => window.removeEventListener(OPENED_EVENT, onChange);
+}
+export function markLauncherOpened() {
+    try {
+        localStorage.setItem(OPENED_KEY, '1');
+    }
+    catch {
+        // Without storage the label comes back on the next page.
+    }
+    window.dispatchEvent(new Event(OPENED_EVENT));
+}
+/**
+ * True once this visitor has opened the chat. Renders as true on a server, so a
+ * returning visitor never sees the label flash in and back out on hydration.
+ */
+export function useLauncherOpened() {
+    return useSyncExternalStore(subscribeOpened, readOpened, () => true);
+}
+const NO_LAUNCHER = {
+    colourway: DEFAULT_LAUNCHER_COLOURWAY,
+    visitorColourway: false,
+};
+export const LauncherOptionsContext = createContext(NO_LAUNCHER);
+/** The launcher around this chat. The defaults mean "there isn't one". */
+export const useLauncherOptions = () => useContext(LauncherOptionsContext);
+//# sourceMappingURL=launcher-variant.js.map

package/dist/chat/lib/launcher-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-variant.js","sourceRoot":"","sources":["../../../src/chat/lib/launcher-variant.ts"],"names":[],"mappings":"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"}

package/dist/chat/lib/portal-host.d.ts

@@ -0,0 +1,13 @@
+/** The element portals inside the chat render into; null outside a chat. */
+export declare const PortalHostContext: import("react").Context<HTMLElement | null>;
+/**
+ * The chat's portal host. Null outside `<Talk2ViewChat>`, which is a valid
+ * answer: Base UI reads `container={null}` as "use the default", `<body>`.
+ */
+export declare const usePortalHost: () => HTMLElement | null;
+/**
+ * Create (or join) this document's portal host. Returns null while rendering on
+ * a server, where there is no document and nothing portals anyway.
+ */
+export declare function useCreatePortalHost(): HTMLElement | null;
+//# sourceMappingURL=portal-host.d.ts.map

package/dist/chat/lib/portal-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-host.d.ts","sourceRoot":"","sources":["../../../src/chat/lib/portal-host.ts"],"names":[],"mappings":"AAaA,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,6CAA0C,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAO,WAAW,GAAG,IAAqC,CAAC;AAmBrF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAmBxD"}

package/dist/chat/lib/portal-host.js

@@ -0,0 +1,58 @@
+/**
+ * Every popover, tooltip and dialog in the chat is portaled, and a portal
+ * defaults to `<body>` — outside the `.t2v-chat` element the whole stylesheet is
+ * scoped to, so a portaled popup would render unstyled. The provider keeps one
+ * host element in `<body>` that carries the same class, and every portal points
+ * at it.
+ *
+ * One host per document, shared by every chat on the page and removed when the
+ * last one unmounts, so a page that mounts and unmounts chats does not
+ * accumulate empty divs.
+ */
+import { createContext, useContext, useEffect, useState } from 'react';
+/** The element portals inside the chat render into; null outside a chat. */
+export const PortalHostContext = createContext(null);
+/**
+ * The chat's portal host. Null outside `<Talk2ViewChat>`, which is a valid
+ * answer: Base UI reads `container={null}` as "use the default", `<body>`.
+ */
+export const usePortalHost = () => useContext(PortalHostContext);
+const hosts = new WeakMap();
+function ensure(doc) {
+    let host = hosts.get(doc);
+    if (!host) {
+        const el = doc.createElement('div');
+        el.className = 't2v-chat t2v-portal-host';
+        host = { el, refs: 0 };
+        hosts.set(doc, host);
+    }
+    // Re-attached rather than recreated, so React's StrictMode double-mount (and
+    // any host page that empties <body>) gets the same element back.
+    if (!host.el.isConnected)
+        doc.body.appendChild(host.el);
+    return host;
+}
+/**
+ * Create (or join) this document's portal host. Returns null while rendering on
+ * a server, where there is no document and nothing portals anyway.
+ */
+export function useCreatePortalHost() {
+    // In the state initialiser, not an effect: a popup can be open on the very
+    // first render, and a detached container renders nothing.
+    const [el] = useState(() => typeof document === 'undefined' ? null : ensure(document).el);
+    useEffect(() => {
+        if (!el)
+            return;
+        const host = ensure(el.ownerDocument);
+        host.refs += 1;
+        return () => {
+            host.refs -= 1;
+            if (host.refs <= 0) {
+                host.refs = 0;
+                host.el.remove();
+            }
+        };
+    }, [el]);
+    return el;
+}
+//# sourceMappingURL=portal-host.js.map

package/dist/chat/lib/portal-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-host.js","sourceRoot":"","sources":["../../../src/chat/lib/portal-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAuB,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAGrF,MAAM,KAAK,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE5C,SAAS,MAAM,CAAC,GAAa;IAC3B,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,EAAE,CAAC,SAAS,GAAG,0BAA0B,CAAC;QAC1C,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,6EAA6E;IAC7E,iEAAiE;IACjE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW;QAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,2EAA2E;IAC3E,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAC7C,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAC7D,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACf,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YACf,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;gBACd,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACT,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/chat/markdown.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The chat's markdown renderer: the vendored one, with the links the model
+ * writes opened beside the host app instead of navigating it away.
+ *
+ * The packaged chat's whole premise is that it lives inside somebody else's
+ * application — a Word task pane, an ERP dashboard, a partner's SPA. Upstream's
+ * `a` renderer emits a bare `<a href>`, so one click on a source the agent cited
+ * replaces the host app, taking whatever unsaved state it held with it. The
+ * chat already made this call for its own link: the password-reset link in
+ * `views/account.tsx` opens in a new tab for exactly this reason, and it applies
+ * far more strongly to a link nobody on either side authored.
+ *
+ * Always, with no prop to turn it off. A same-tab link out of an agent's answer
+ * is not something a partner should be able to opt into by accident.
+ *
+ * This is not an injection guard — there is none to add here. react-markdown's
+ * `defaultUrlTransform` is in force (`@assistant-ui/react-markdown` sets no
+ * override) and no `rehype-raw` is configured, so `javascript:` hrefs and raw
+ * HTML are already neutralised. `rel="noopener noreferrer"` is about the opened
+ * page, which must not reach back through `window.opener` or be handed the
+ * partner's URL as a referrer.
+ *
+ * Why the wrapper, and not the vendored file: `src/chat/vendor/*` is
+ * hash-pinned and refetched from an unversioned registry, so an edit there is a
+ * hunk to reconcile on every bump. Upstream renders `<MarkdownText />` with no
+ * components map and offers no other seam, so `sync-registry.mjs` points its two
+ * call sites at this file instead — a path rewrite, which needs no reconciling.
+ */
+import type { FC } from 'react';
+/** Drop-in for the vendored `MarkdownText`; takes no props, as upstream's use does. */
+export declare const MarkdownText: FC;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/chat/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/chat/markdown.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAkB,EAAE,EAAE,MAAM,OAAO,CAAC;AAoBhD,uFAAuF;AACvF,eAAO,MAAM,YAAY,EAAE,EAA2D,CAAC"}

package/dist/chat/markdown.js

@@ -0,0 +1,18 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MarkdownText as VendoredMarkdownText } from './vendor/markdown-text.js';
+import { cn } from './lib/cn.js';
+/**
+ * Upstream's own `a` classes, repeated: a component passed in `components`
+ * REPLACES the default rather than wrapping it, and the default is not
+ * exported. If a bump restyles links in `vendor/markdown-text.tsx`, copy the
+ * class list across.
+ */
+const LINK_CLASS = 'aui-md-a text-primary hover:text-primary/80 underline underline-offset-2';
+// The spread comes FIRST: `target` and `rel` are the point of this component
+// and nothing coming out of the markdown may displace them.
+const ExternalLink = ({ className, ...props }) => (_jsx("a", { ...props, className: cn(LINK_CLASS, className), target: "_blank", rel: "noopener noreferrer" }));
+const COMPONENTS = { a: ExternalLink };
+/** Drop-in for the vendored `MarkdownText`; takes no props, as upstream's use does. */
+export const MarkdownText = () => _jsx(VendoredMarkdownText, { components: COMPONENTS });
+//# sourceMappingURL=markdown.js.map

package/dist/chat/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/chat/markdown.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AA+Bb,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,GAAG,0EAA0E,CAAC;AAE9F,6EAA6E;AAC7E,4DAA4D;AAC5D,MAAM,YAAY,GAA4B,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzE,eAAO,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAC,QAAQ,EAAC,GAAG,EAAC,qBAAqB,GAAG,CACjG,CAAC;AAEF,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;AAEvC,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAO,GAAG,EAAE,CAAC,KAAC,oBAAoB,IAAC,UAAU,EAAE,UAAU,GAAI,CAAC"}

package/dist/chat/provider.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Everything the packaged chat needs, in one place: the Talk2View client, the
+ * assistant-ui runtime built on it, the suggestion store, the portal host, and
+ * the end-user's own choices from Settings.
+ *
+ * `<Talk2ViewChat>` and (from Task 6) `<Talk2ViewChatLauncher>` are both this
+ * provider plus a different frame around the same shell.
+ */
+import { type ReactNode } from 'react';
+import { Talk2View } from '../index.js';
+import type { ClientTool, ClientToolSchema, PartnerConfig, T2VConfig } from '../types.js';
+import { type GuestLimits } from './auth-gate.js';
+import { type DictationPhaseStore } from './lib/dictation-phase.js';
+/** The opening screen: a heading and the openers offered under the composer. */
+export interface Talk2ViewChatWelcome {
+    heading?: string;
+    suggestions?: string[];
+}
+/**
+ * Built-in views, all on by default. `dictation` also needs a browser
+ * microphone: without one the voice button never appears.
+ */
+export interface Talk2ViewChatFeatures {
+    dictation?: boolean;
+    attachments?: boolean;
+    settings?: boolean;
+    account?: boolean;
+    threadList?: boolean;
+}
+export interface Talk2ViewChatProps extends Omit<T2VConfig, 'partnerKey'> {
+    /** Either give the config (a client is created for you) … */
+    partnerKey?: string;
+    /** … or an existing client (e.g. shared with the rest of the app). */
+    client?: Talk2View;
+    tools?: (ClientToolSchema | ClientTool)[];
+    /**
+     * Your own instructions, sent with every message — the same prop `/ui` and
+     * `/assistant-ui` take. It is a runtime option, not part of `T2VConfig`, so
+     * changing it does not rebuild the client or drop the conversation.
+     */
+    systemPrompt?: string;
+    welcome?: Talk2ViewChatWelcome;
+    /**
+     * Logged-out visitors chat as guests (default true). false → sign-in first:
+     * the Account view replaces the thread, and no guest session is started.
+     */
+    allowAnonymous?: boolean;
+    features?: Talk2ViewChatFeatures;
+    /** The host's own font stack, e.g. '"Space Grotesk", sans-serif'. Default: inherit. */
+    fontFamily?: string;
+    /** Where "Forgot it?" sends people. Default: none (the link is left out). */
+    resetPasswordUrl?: string;
+    /** A short line under the composer, e.g. terms. */
+    footer?: ReactNode;
+    /**
+     * Tool approvals. `describeToolActivity` names what a running tool is doing
+     * ("Inserting 240 characters"); `isToolDestructive` marks a call that changes
+     * the end-user's work, and `destructiveWarning` replaces the warning shown
+     * above the approval buttons when it does.
+     */
+    describeToolActivity?: (name: string, args?: Record<string, unknown>) => string | null;
+    isToolDestructive?: (name: string, args?: Record<string, unknown>) => boolean;
+    destructiveWarning?: (name: string, activity: string | null) => ReactNode;
+    className?: string;
+}
+/**
+ * The props a slot component cannot be handed directly (assistant-ui's
+ * `components={{ ToolFallback }}` takes a component, not a closure), read
+ * through a ref so adding one does not re-render the whole chat.
+ */
+export interface Talk2ViewChatBehaviour {
+    allowAnonymous: boolean;
+    resetPasswordUrl?: string | undefined;
+    describeToolActivity?: Talk2ViewChatProps['describeToolActivity'];
+    isToolDestructive?: Talk2ViewChatProps['isToolDestructive'];
+    destructiveWarning?: Talk2ViewChatProps['destructiveWarning'];
+}
+export interface Talk2ViewChatContextValue {
+    client: Talk2View;
+    /** The partner's defaults, shown as "Default — …" in Settings. Null until loaded. */
+    config: PartnerConfig | null;
+    features: Required<Talk2ViewChatFeatures>;
+    welcome: Talk2ViewChatWelcome;
+    /** Where portaled popups render. Null only while rendering on a server. */
+    portalHost: HTMLElement | null;
+    /**
+     * Whether a guest has been turned away. Tracked here rather than in the view
+     * that shows the sign-in, because the launcher's panel is unmounted when the
+     * refusal arrives.
+     */
+    limits: GuestLimits;
+    dictation: DictationPhaseStore;
+    /**
+     * Whether the integrator asked for dark mode, i.e. `className` carries
+     * `dark`. Read by anything that renders OUTSIDE the chat's own element — see
+     * the portal-host effect below.
+     */
+    dark: boolean;
+    /** Always the latest render's values; stable identity. */
+    behaviour: {
+        readonly current: Talk2ViewChatBehaviour;
+    };
+}
+/** `dark` as a whole word, so `darkroom-theme` is not dark mode. */
+export declare function hasDarkClass(className: string | undefined): boolean;
+export declare function useChatContext(): Talk2ViewChatContextValue;
+/** The client behind the chat, for the host's own UI (sign-out buttons and the like). */
+export declare function useTalk2ViewChatClient(): Talk2View;
+export interface ChatProviderProps extends Talk2ViewChatProps {
+    children: ReactNode;
+}
+export declare function ChatProvider({ children, ...props }: ChatProviderProps): ReactNode;
+//# sourceMappingURL=provider.d.ts.map

package/dist/chat/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/chat/provider.tsx"],"names":[],"mappings":"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"}

package/dist/chat/provider.js

@@ -0,0 +1,176 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Everything the packaged chat needs, in one place: the Talk2View client, the
+ * assistant-ui runtime built on it, the suggestion store, the portal host, and
+ * the end-user's own choices from Settings.
+ *
+ * `<Talk2ViewChat>` and (from Task 6) `<Talk2ViewChatLauncher>` are both this
+ * provider plus a different frame around the same shell.
+ */
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { AssistantRuntimeProvider, AuiProvider, Suggestions, useAui } from '@assistant-ui/react';
+import { Talk2View } from '../index.js';
+import { useTalk2ViewRuntimeForClient } from '../assistant-ui/index.js';
+import { useUserPreferences } from '../react/useUserPreferences.js';
+import { assertOneAssistantUi } from './lib/guard.js';
+import { useGuestLimits } from './auth-gate.js';
+import { PortalHostContext, useCreatePortalHost } from './lib/portal-host.js';
+import { createDictationPhaseStore } from './lib/dictation-phase.js';
+/** `dark` as a whole word, so `darkroom-theme` is not dark mode. */
+export function hasDarkClass(className) {
+    return !!className && /(^|\s)dark(\s|$)/.test(className);
+}
+const ChatContext = createContext(null);
+export function useChatContext() {
+    const value = useContext(ChatContext);
+    if (!value) {
+        throw new Error('This component must be rendered inside <Talk2ViewChat>.');
+    }
+    return value;
+}
+/** The client behind the chat, for the host's own UI (sign-out buttons and the like). */
+export function useTalk2ViewChatClient() {
+    return useChatContext().client;
+}
+const FEATURE_DEFAULTS = {
+    dictation: true,
+    attachments: true,
+    settings: true,
+    account: true,
+    threadList: true,
+};
+const NO_WELCOME = {};
+export function ChatProvider({ children, ...props }) {
+    assertOneAssistantUi();
+    const { client: givenClient, partnerKey, tools, systemPrompt, welcome = NO_WELCOME, features: givenFeatures, allowAnonymous = true, resetPasswordUrl, describeToolActivity, isToolDestructive, destructiveWarning, 
+    // Not connection options: `fontFamily`, `footer` and `className` belong to
+    // the frame, and the rest of `props` is T2VConfig.
+    fontFamily: _fontFamily, footer: _footer, className, ...config } = props;
+    if (!givenClient && !partnerKey) {
+        throw new Error('<Talk2ViewChat> needs either a partnerKey or a client.');
+    }
+    // `allowAnonymous: false` has to reach the client, not just the view: the gate
+    // is computed from whether anyone is signed in, and a guest session started
+    // behind it — by listing the models for Settings, say — would open it. An
+    // explicit `anonymousAutoStart` still wins; this only fills in the default.
+    const anonymousAutoStart = config.anonymousAutoStart ?? allowAnonymous;
+    // A new client only when the connection details change. `model` is not one of
+    // them: it travels with each message, so an end-user can switch models in
+    // Settings without losing the conversation.
+    //
+    // React invokes this factory TWICE per mount under StrictMode and keeps only
+    // one of the two clients, so it must leave nothing behind: `new Talk2View()`
+    // registers two `window` listeners for auth, and the instance React discards
+    // is unreachable from the effect below and could never take them off again.
+    // So every client built here starts asleep and the effect wakes the survivor.
+    // Nothing outside the instance can tell the difference — auth events only
+    // matter to a mounted chat, and the gap is one commit long.
+    const client = useMemo(() => {
+        if (givenClient)
+            return givenClient;
+        const made = new Talk2View({ ...config, anonymousAutoStart, partnerKey: partnerKey });
+        made.auth.destroy();
+        return made;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [givenClient, partnerKey, config.baseUrl, config.debug, anonymousAutoStart]);
+    const ours = client !== givenClient;
+    const features = useMemo(() => ({ ...FEATURE_DEFAULTS, ...givenFeatures }), [givenFeatures]);
+    const [partnerConfig, setPartnerConfig] = useState(null);
+    useEffect(() => {
+        let live = true;
+        // Single-flighted and cached by the client, so Settings asking again is free.
+        // A brand-new visitor has no session yet and this 401s; Settings retries
+        // once the model list has started a guest session.
+        client
+            .getConfig()
+            .then((value) => live && value && setPartnerConfig(value))
+            .catch(() => { });
+        return () => {
+            live = false;
+        };
+    }, [client]);
+    const dictation = useMemo(() => createDictationPhaseStore(), []);
+    const { preferences } = useUserPreferences();
+    const runtime = useTalk2ViewRuntimeForClient(client, {
+        systemPrompt,
+        tools,
+        // The end-user's choice from Settings; empty means the partner's default.
+        model: preferences.model || undefined,
+        attachments: features.attachments,
+        dictation: features.dictation && {
+            model: preferences.sttModel || undefined,
+            language: preferences.sttLanguage || undefined,
+            // assistant-ui has no surface for a dictation failure; at least leave a trace.
+            onError: (error) => console.warn('[Talk2View] Dictation failed:', error),
+            onPhaseChange: dictation.set,
+        },
+    });
+    // After the runtime hook, so its subscriptions are torn down before the
+    // client we own is destroyed. A client the integrator passed in is theirs.
+    //
+    // Setup wakes it and cleanup puts it back to sleep, both ways round and any
+    // number of times: StrictMode runs this as setup → cleanup → setup, and a
+    // cleanup that only tore listeners off would leave the surviving client deaf
+    // to cross-tab sign-out and to `clearAuth()` for the rest of the session.
+    useEffect(() => {
+        if (!ours)
+            return;
+        client.auth.listen();
+        return () => client.destroy();
+    }, [client, ours]);
+    const portalHost = useCreatePortalHost();
+    const limits = useGuestLimits(client);
+    // Dark mode is `dark` on the chat's container, and every token it redefines
+    // is declared on `.t2v-chat.dark`. But tooltips, dialogs and the launcher's
+    // own panel do not render inside that element — they render in the portal
+    // host, a sibling of the chat in <body> — so a dark chat was opening a white
+    // panel and showing light-themed tooltips. The class has to travel with them.
+    //
+    // One portal host serves every chat on the page: two chats with different
+    // themes would share whichever was set last. Nobody does that today, and the
+    // alternative is a host per chat.
+    const dark = hasDarkClass(className);
+    useEffect(() => {
+        if (!portalHost)
+            return;
+        portalHost.classList.toggle('dark', dark);
+        return () => portalHost.classList.remove('dark');
+    }, [portalHost, dark]);
+    const behaviour = useRef({ allowAnonymous });
+    behaviour.current = {
+        allowAnonymous,
+        resetPasswordUrl,
+        describeToolActivity,
+        isToolDestructive,
+        destructiveWarning,
+    };
+    const value = useMemo(() => ({
+        client,
+        config: partnerConfig,
+        features,
+        welcome,
+        portalHost,
+        limits,
+        dictation,
+        dark,
+        behaviour,
+    }), [client, partnerConfig, features, welcome, portalHost, limits, dictation, dark]);
+    return (_jsx(ChatContext.Provider, { value: value, children: _jsx(PortalHostContext.Provider, { value: portalHost, children: _jsx(AssistantRuntimeProvider, { runtime: runtime, children: _jsx(SuggestionStore, { suggestions: welcome.suggestions, children: children }) }) }) }));
+}
+/**
+ * The openers the thread shows under the composer on an empty chat. Inside the
+ * runtime provider, so they attach to this chat's store and not another's.
+ */
+function SuggestionStore({ suggestions, children, }) {
+    // Joined on a character that cannot occur in an opener, so two different
+    // lists can never produce the same key. Written as the escape, not as a
+    // literal NUL byte: one of those makes the whole file binary to grep, git and
+    // half the editors that open it.
+    const key = suggestions?.join('\0') ?? '';
+    const aui = useAui(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    useMemo(() => (suggestions?.length ? { suggestions: Suggestions(suggestions) } : {}), [key]));
+    return _jsx(AuiProvider, { value: aui, children: children });
+}
+//# sourceMappingURL=provider.js.map

package/dist/chat/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/chat/provider.tsx"],"names":[],"mappings":"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"}

package/dist/chat/tool-fallback.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How every tool call looks in the packaged chat — one component, no tool names
+ * hard-coded, passed to the thread as `components={{ ToolFallback }}`.
+ *
+ * Three states:
+ *  - running — an activity row: what the host says the agent is doing
+ *    (`describeToolActivity`) and how long it has been at it;
+ *  - waiting on the end-user — the approval card: allow once, always allow, or
+ *    deny with a reason, with the arguments editable first, and a warning above
+ *    the buttons for a tool the host marks as changing the end-user's work;
+ *  - finished — the collapsed "Used tool" line, opening to the arguments and the
+ *    result.
+ *
+ * Two things worth knowing before restyling the card:
+ *  - Edited arguments apply to THIS call only. "Always allow" skips the card for
+ *    later calls, which then run with whatever the agent proposes — so the card
+ *    does not offer it while the arguments are edited.
+ *  - Decisions go straight to the Talk2View client (`approveToolCall`), not
+ *    through assistant-ui's approval seam, because that seam carries a decision
+ *    and a reason but not changed input.
+ */
+import { type ReactNode } from 'react';
+import { type ToolCallMessagePartComponent } from '@assistant-ui/react';
+import type { ThreadGroupPart } from './vendor/thread.aui.js';
+export declare const ToolFallback: ToolCallMessagePartComponent;
+/**
+ * The run of tool calls in one assistant turn, as a single "2 tool calls" line.
+ *
+ * Upstream's group starts closed and stays closed, which is right for a finished
+ * turn and wrong for a live one: an approval card inside a closed group leaves
+ * the end-user looking at "1 tool call" while the agent waits on them, with
+ * nothing to say a decision is needed. This opens the group while the run is
+ * under way and leaves whatever the end-user last chose standing once it settles.
+ */
+export declare function ToolGroup({ group, children, }: {
+    group: ThreadGroupPart;
+    children?: ReactNode;
+}): ReactNode;
+//# sourceMappingURL=tool-fallback.d.ts.map

package/dist/chat/tool-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-fallback.d.ts","sourceRoot":"","sources":["../../src/chat/tool-fallback.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAyD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9F,OAAO,EAEL,KAAK,4BAA4B,EAElC,MAAM,qBAAqB,CAAC;AAW7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAuB9D,eAAO,MAAM,YAAY,EAAE,4BAU1B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,SAAS,CAgBZ"}