@yadsh/dsh-qa-surface 0.2.0 → 0.4.0

package/lib/types/client/QaSurface.d.ts

@@ -1,15 +1,26 @@
-import type { HostDescriptionSource } from "@deepseek-ai/dsh-client-connection/client";
+import type { ConnectionGenerationState } from "@deepseek-ai/dsh-client-connection/client";
 import type { InjectFace, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
 import type { QaConfigController } from "./QaConfigController.js";
 import type { QaRouteController } from "./QaRouteController.js";
-import type { QaSecureSession, QaSessions, QaSessionsApi } from "./types.js";
+import type { QaAccountsController } from "./QaAccountsController.js";
+import type { QaConversation, QaCreateSession, QaFileUpload, QaSecureSession, QaSessions, QaSessionsApi, QaSourceApi } from "./types.js";
 export interface QaSurfaceFace {
     readonly route: QaRouteController;
     readonly config: QaConfigController;
     readonly sessions: QaSessions;
+    readonly conversation: QaConversation;
     readonly api: QaSessionsApi;
-    readonly connection: HostDescriptionSource;
+    readonly connection: ConnectionGenerationState;
     readonly secureSession: QaSecureSession;
+    readonly createSession: QaCreateSession;
+    readonly sourceApi: QaSourceApi;
+    /**
+     * Browser file-upload service, when the page serves the upload plugin.
+     * Resolved per send so a page that loads it later still gets file support.
+     */
+    readonly fileUpload?: () => QaFileUpload | undefined;
+    /** Present when the deployment mounts the QA account gate. */
+    readonly accounts?: QaAccountsController;
 }
 type QaSurfaceProps = PropsRuntime<"shell.overlay"> & InjectFace<QaSurfaceFace>;
 export declare function QaSurface(props: QaSurfaceProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/types/client/QaTranscriptAdapter.d.ts

@@ -1,5 +1,5 @@
-import type { ConversationSnapshot } from "@deepseek-ai/dsh-client-runtime/client";
-import type { QaMessage, QaSource } from "../types.js";
+import type { ConversationSnapshot } from "@deepseek-ai/dsh-client-ui-conversation/client";
+import type { QaMessage } from "../types.js";
 /**
  * The hidden regeneration prompt. Regenerate sends this as an ordinary
  * prompt — the session has no truncation seam, so a "variant" is a real
@@ -8,15 +8,10 @@ import type { QaMessage, QaSource } from "../types.js";
  */
 export declare const QA_REGENERATE_MARKER = "\u041F\u0435\u0440\u0435\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u0443\u0439 \u0441\u0432\u043E\u0439 \u043F\u0440\u0435\u0434\u044B\u0434\u0443\u0449\u0438\u0439 \u043E\u0442\u0432\u0435\u0442 \u2014 \u0434\u0430\u0439 \u043D\u043E\u0432\u044B\u0439 \u0432\u0430\u0440\u0438\u0430\u043D\u0442, \u043D\u0435 \u043F\u043E\u0432\u0442\u043E\u0440\u044F\u044F \u043F\u0440\u0435\u0434\u044B\u0434\u0443\u0449\u0438\u0439.";
 /** Project end-user messages plus optional operator-approved work detail. */
-export declare function projectTranscript(snapshot: ConversationSnapshot, options?: {
+export declare function projectTranscript(snapshot: ConversationSnapshot | undefined, options?: {
+    /** Live turn lifecycle from the bound Session (drives running-row status). */
+    readonly running?: boolean;
     readonly showToolActivity?: boolean;
     readonly showReasoning?: boolean;
 }): readonly QaMessage[];
-/**
- * Collect the sources this chat has actually touched, in first-use order:
- * fetched pages, searches, and files read. This is the same tool activity the
- * work groups render, projected as a flat citation-style list, so it carries
- * no information beyond `ui.showToolActivity`.
- */
-export declare function projectSources(snapshot: ConversationSnapshot): readonly QaSource[];
 //# sourceMappingURL=QaTranscriptAdapter.d.ts.map

package/lib/types/client/attachments.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Composer-side attachment intake: which files are accepted, how a pasted
+ * blob turns into an attachment, and the browser-side ceilings. The Host
+ * remains authoritative — these checks exist so a refusal happens before a
+ * round trip, not to replace the Host's own admission.
+ */
+import type { QaAttachmentDraft, QaFileDraft, QaImageMediaType, ResolvedQaSurfaceConfig } from "../types.js";
+/** Raster formats the host attachment path accepts. */
+export declare const QA_IMAGE_MEDIA_TYPES: readonly QaImageMediaType[];
+/** Soft image ceiling; the Host stays authoritative at admission. */
+export declare const QA_MAX_IMAGE_BYTES: number;
+/** The attachment policy as the composer reads it. */
+export interface QaAttachmentLimits {
+    readonly textFiles: boolean;
+    readonly pastedTextLines: number;
+    readonly maxFileBytes: number;
+    readonly maxPending: number;
+    readonly extensions: readonly string[];
+}
+/**
+ * Project the deployment's resolved configuration into the composer's policy.
+ * @param config - effective QA configuration.
+ * @returns the attachment ceilings the composer enforces.
+ */
+export declare function attachmentLimits(config: ResolvedQaSurfaceConfig): QaAttachmentLimits;
+/**
+ * The file picker's `accept` value: the raster formats plus either the
+ * configured text extensions or the browser's whole `text/*` family.
+ * @param limits - attachment policy in effect.
+ * @returns the accept attribute value.
+ */
+export declare function attachmentAccept(limits: QaAttachmentLimits): string;
+/** Whether a dropped payload may be attached as a text file at all. */
+export declare function acceptsTextFile(name: string, mediaType: string, limits: QaAttachmentLimits): boolean;
+/**
+ * Turn one dropped or picked file into a composer draft, or into the message
+ * the visitor sees when the file is not accepted.
+ * @param file - browser file from a picker, drop or paste.
+ * @param limits - attachment policy in effect.
+ * @returns the draft, or a refusal message.
+ */
+export declare function draftFromFile(file: File, limits: QaAttachmentLimits): Promise<QaAttachmentDraft | string>;
+/**
+ * Convert a large pasted blob into an attached file. Pasted text has no file
+ * name of its own, so the name states what it is; the model resolves it from
+ * the durable store like any other attachment.
+ * @param text - pasted plain text.
+ * @param limits - attachment policy in effect.
+ * @returns the draft, or null when the paste stays in the input field.
+ */
+export declare function draftFromPaste(text: string, limits: QaAttachmentLimits): QaFileDraft | null;
+/** Format one attachment size for a card, a chip or a refusal message. */
+export declare function formatFileSize(bytes: number): string;
+//# sourceMappingURL=attachments.d.ts.map

package/lib/types/client/base64.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser-side binary-to-base64. Chunked so `String.fromCharCode` never
+ * crosses the engine's argument limit on large attachments.
+ */
+/**
+ * @param bytes - raw bytes to encode.
+ * @returns the canonical base64 text (no `data:` prefix, no padding tricks).
+ */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+//# sourceMappingURL=base64.d.ts.map

package/lib/types/client/chat-files.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Attachment roster of one chat, projected for the rail's files tab: a pure
+ * scan of the durable transcript, newest message first. The browser never
+ * re-reads file bytes (the attachment route serves images), so a row keeps
+ * the same handle the transcript shows.
+ */
+import type { QaImageView, QaMessage, QaFileView } from "../types.js";
+/** Everything one user message carried, in prompt order. */
+export interface QaChatFileGroup {
+    /** The user message id; doubles as the transcript turn anchor. */
+    readonly messageId: string;
+    /** Wall-clock send time, when the transcript recorded one. */
+    readonly timestamp?: number;
+    readonly files: readonly QaFileView[];
+    readonly images: readonly QaImageView[];
+}
+/** Whether the group carries at least one attachment of either kind. */
+export declare function groupHasAttachments(group: QaChatFileGroup): boolean;
+/** Total attachment count across groups; the header badge's value. */
+export declare function countChatAttachments(groups: readonly QaChatFileGroup[]): number;
+/**
+ * Group the attachments of a chat by their sending message. Only user
+ * messages can carry attachments; messages without any are dropped. The
+ * groups come out newest message first, matching a roster that grows at the
+ * bottom of the transcript.
+ * @param messages - the chat's projected transcript.
+ * @returns attachment groups, newest message first.
+ */
+export declare function collectChatFiles(messages: readonly QaMessage[]): readonly QaChatFileGroup[];
+//# sourceMappingURL=chat-files.d.ts.map

package/lib/types/client/components/Markdown.d.ts

@@ -1,9 +1,19 @@
+import type { QaSource } from "../../types.js";
+import { type QaSourceRefs } from "./source-refs.js";
+/** Inline source awareness handed down from the owning assistant message. */
+export interface MarkdownSourceContext {
+    readonly refs?: QaSourceRefs;
+    /** Open a path-backed source in the sources drawer's detail view. */
+    readonly onSourceOpen?: (source: QaSource) => void;
+}
 /**
  * Deliberately small, HTML-free Markdown renderer for assistant-visible text.
  * Memoized on the text value: stream updates re-render only the message whose
  * text actually changed, so committed history is never re-parsed.
  */
-export declare const Markdown: import("react").MemoExoticComponent<({ text, }: {
+export declare const Markdown: import("react").MemoExoticComponent<({ text, sourceRefs, onSourceOpen, }: {
     readonly text: string;
+    readonly sourceRefs?: QaSourceRefs;
+    readonly onSourceOpen?: (source: QaSource) => void;
 }) => import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=Markdown.d.ts.map

package/lib/types/client/components/QaAgentsDrawer.d.ts

@@ -1,4 +1,4 @@
-import type { SessionSummary } from "@deepseek-ai/dsh-client-runtime/client";
+import type { SessionSummary } from "@deepseek-ai/dsh-api-session-controller/client";
 /** One row of the agents panel: a subagent session of the open chat. */
 export interface QaSubagentRow {
     readonly id: string;

package/lib/types/client/components/QaAuthGate.d.ts

@@ -0,0 +1,15 @@
+import type { QaAccountsController, QaAccountsSnapshot } from "../QaAccountsController.js";
+export interface QaAuthGateProps {
+    readonly accounts: QaAccountsController;
+    readonly snapshot: QaAccountsSnapshot;
+    readonly title: string;
+    readonly logoUrl: string | null;
+    readonly allowRegistration: boolean;
+}
+/**
+ * The full-frame login/registration card shown instead of the chat while the
+ * deployment has accounts enabled and the browser holds no valid identity.
+ * Errors are the Host's coarse codes rendered as audience-safe copy.
+ */
+export declare function QaAuthGate(props: QaAuthGateProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaAuthGate.d.ts.map

package/lib/types/client/components/QaChangelog.d.ts

@@ -0,0 +1,21 @@
+export declare const QA_VERSION: string;
+export interface QaChangelogEntry {
+    readonly version: string;
+    readonly date: string;
+    readonly sections: readonly {
+        readonly title: string;
+        readonly items: readonly string[];
+    }[];
+}
+export declare const QA_CHANGELOG: readonly QaChangelogEntry[];
+/** Props of the {@link QaChangelogModal} dialog. */
+export interface QaChangelogModalProps {
+    readonly open: boolean;
+    readonly onClose: () => void;
+}
+/**
+ * The version/changelog dialog opened from the sidebar footer. Rendering is
+ * a no-op while closed; Escape and a backdrop click close it.
+ */
+export declare function QaChangelogModal(props: QaChangelogModalProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaChangelog.d.ts.map

package/lib/types/client/components/QaComposer.d.ts

@@ -1,4 +1,5 @@
-import type { QaImageDraft } from "../../types.js";
+import type { QaAttachmentDraft } from "../../types.js";
+import { type QaAttachmentLimits } from "../attachments.js";
 export interface QaComposerProps {
     readonly placeholder: string;
     readonly quickQuestions?: readonly string[];
@@ -7,15 +8,18 @@ export interface QaComposerProps {
     readonly running: boolean;
     readonly showStop: boolean;
     readonly status: string | null;
-    readonly images: readonly QaImageDraft[];
-    readonly onImagesChange: (images: readonly QaImageDraft[]) => void;
-    readonly onSend: (text: string, images: readonly QaImageDraft[]) => Promise<boolean>;
+    readonly attachments: readonly QaAttachmentDraft[];
+    /** Deployment policy: accepted kinds, ceilings and the paste threshold. */
+    readonly limits: QaAttachmentLimits;
+    readonly onAttachmentsChange: (attachments: readonly QaAttachmentDraft[]) => void;
+    readonly onSend: (text: string, attachments: readonly QaAttachmentDraft[]) => Promise<boolean>;
     readonly onStop: () => Promise<void>;
 }
 /**
  * Memoized with the default shallow compare: every prop is a scalar, a
  * stable array or a stable callback, so a stream of transcript frames never
  * re-renders the composer and typing stays responsive while an answer runs.
+ * The caller owns the draft array identity: `limits` must be stable too.
  */
 export declare const QaComposer: import("react").MemoExoticComponent<(props: QaComposerProps) => import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=QaComposer.d.ts.map

package/lib/types/client/components/QaFileAttachment.d.ts

@@ -0,0 +1,14 @@
+export interface QaFileAttachmentProps {
+    readonly name: string;
+    readonly bytes: number;
+    /** Pending draft vs already-sent attachment: pending offers removal. */
+    readonly tone: "draft" | "sent";
+    readonly onRemove?: () => void;
+}
+/**
+ * One attached file: the extension badge, the name and the size. The browser
+ * never re-reads these bytes (the Host attachment route serves images), so
+ * both the composer card and the sent row show the same handle.
+ */
+export declare function QaFileAttachment({ name, bytes, tone, onRemove, }: QaFileAttachmentProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaFileAttachment.d.ts.map

package/lib/types/client/components/QaFilesPanel.d.ts

@@ -0,0 +1,15 @@
+import type { QaChatFileGroup } from "../chat-files.js";
+export interface QaFilesPanelProps {
+    readonly groups: readonly QaChatFileGroup[];
+    /** Resolve an image attachment to an object URL; images render inert without it. */
+    readonly resolveImage?: (attachmentId: string) => Promise<string>;
+    /** Scroll the transcript to the group's user message. */
+    readonly onJumpToMessage: (messageId: string) => void;
+}
+/**
+ * The chat's attachment roster: one section per sending message, newest
+ * first. Rows mirror the transcript's handles — the browser never reads a
+ * file back, and the images are the same object URLs the message showed.
+ */
+export declare function QaFilesPanel({ groups, resolveImage, onJumpToMessage, }: QaFilesPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaFilesPanel.d.ts.map

package/lib/types/client/components/QaHeader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The surface's header chrome: brand row, the derived conversation title, the
+ * agents/sources/files controls and the reset action. Plain (non-memoized)
+ * rendering — the badge counts move with the session state anyway, so
+ * reference guards would never pay off here.
+ */
+/**
+ * The subagent indication for headerless deployments: a slim status line
+ * above the transcript with the way back to the parent chat. With a header,
+ * the same indication lives in the title row instead.
+ */
+export declare function QaSubagentBanner({ onClose, }: {
+    readonly onClose: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export interface QaHeaderProps {
+    readonly logoUrl: string | null;
+    /** The derived conversation title; null hides the heading. */
+    readonly title: string | null;
+    /** A subagent view replaces the mode caption with its return control. */
+    readonly viewingSubagent: boolean;
+    readonly onCloseSubagent: () => void;
+    readonly agentPreset: string | null;
+    readonly agentCount: number;
+    readonly agentsOpen: boolean;
+    /** Toggles the agents drawer; also closes the right rail. */
+    readonly onToggleAgents: () => void;
+    /** Whether the deployment shows the sources control in the header at all. */
+    readonly sourcesVisible: boolean;
+    readonly sourcesCount: number;
+    readonly sourcesComplete: boolean;
+    readonly sourcesOpen: boolean;
+    readonly onOpenSources: () => void;
+    readonly fileCount: number;
+    readonly filesOpen: boolean;
+    readonly onOpenFiles: () => void;
+    readonly showReset: boolean;
+    readonly resetDisabled: boolean;
+    readonly onReset: () => void;
+}
+export declare function QaHeader({ logoUrl, title, viewingSubagent, onCloseSubagent, agentPreset, agentCount, agentsOpen, onToggleAgents, sourcesVisible, sourcesCount, sourcesComplete, sourcesOpen, onOpenSources, fileCount, filesOpen, onOpenFiles, showReset, resetDisabled, onReset, }: QaHeaderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaHeader.d.ts.map

package/lib/types/client/components/QaMessage.d.ts

@@ -1,14 +1,23 @@
-import type { QaMessage as QaMessageModel } from "../../types.js";
+import type { QaMessage as QaMessageModel, QaSource, QaTurnSources } from "../../types.js";
 export interface QaMessageProps {
     readonly message: QaMessageModel;
     readonly renderMarkdown: boolean;
     readonly showTimestamp: boolean;
-    /** Storage prefix persisted message ratings live under. */
+    /**
+     * Storage prefix persisted message ratings live under. Callers scope it to
+     * the chat: message ids repeat across chats (`assistant:<seq>`).
+     */
     readonly stateKey?: string;
     /** Ask for a fresh variant of this answer; omit to hide the control. */
     readonly onRegenerate?: () => void;
     /** Resolve one durable attachment into a viewable URL. */
     readonly resolveImage?: (attachmentId: string) => Promise<string>;
+    /** Open the drawer at the exact canonical snapshot shown in this footer. */
+    readonly onOpenSources?: (sources: readonly QaSource[], complete: boolean, incompleteOrigins: QaTurnSources["incompleteOrigins"]) => void;
+    /** Open one path-backed source's detail (an inline footnote click). */
+    readonly onSourceDetail?: (source: QaSource) => void;
+    /** Operator-configured running phrases; omitted reads the built-in list. */
+    readonly thinkingPhrases?: readonly string[];
 }
 /**
  * Whether two transcript messages render identically. The transcript
@@ -17,5 +26,5 @@ export interface QaMessageProps {
  * comparison is by value, which keeps fresh copies cheap to recognize.
  */
 export declare function sameMessage(a: QaMessageModel, b: QaMessageModel): boolean;
-export declare const QaMessage: import("react").MemoExoticComponent<({ message, renderMarkdown, showTimestamp, stateKey, onRegenerate, resolveImage, }: QaMessageProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const QaMessage: import("react").MemoExoticComponent<({ message, renderMarkdown, showTimestamp, stateKey, onRegenerate, resolveImage, onOpenSources, onSourceDetail, thinkingPhrases, }: QaMessageProps) => import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=QaMessage.d.ts.map

package/lib/types/client/components/QaModal.d.ts

@@ -0,0 +1,26 @@
+import { type ReactNode } from "react";
+export interface QaModalProps {
+    readonly open: boolean;
+    /** Dialog title; also the dialog's accessible name. */
+    readonly title: string;
+    /** Accessible label of the close control, e.g. "Закрыть профиль". */
+    readonly closeLabel: string;
+    readonly onClose: () => void;
+    readonly children: ReactNode;
+    /** Actions pinned under the body; omit for a body-only dialog. */
+    readonly footer?: ReactNode;
+    /**
+     * Wider panel, for a dialog whose prose must not wrap mid-sentence: the
+     * profile form and the changelog both take it. The default width stays with
+     * the text-list dialogs it was sized for.
+     */
+    readonly wide?: boolean;
+}
+/**
+ * The shared QA dialog shell: backdrop, panel, head with the close control,
+ * a scrolling body, and an optional footer. Escape and a backdrop click close
+ * it, and the close control takes focus on open. Rendering is a no-op while
+ * closed, so a closed dialog costs nothing.
+ */
+export declare function QaModal(props: QaModalProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=QaModal.d.ts.map

package/lib/types/client/components/QaProfile.d.ts

@@ -0,0 +1,25 @@
+import type { QaAccountIdentityField, QaAccountProfile, QaAccountProfileInput } from "../../types.js";
+export interface QaProfileModalProps {
+    readonly open: boolean;
+    readonly email: string;
+    readonly profile: QaAccountProfile;
+    /** Handle fields the deployment declares, in its configured order. */
+    readonly identities: readonly QaAccountIdentityField[];
+    readonly instructionsMaxLength: number;
+    readonly onClose: () => void;
+    /**
+     * Persist the edited profile. Resolves to audience-safe refusal copy, or
+     * null once the Host stored it.
+     */
+    readonly onSave: (input: QaAccountProfileInput) => Promise<string | null>;
+}
+/**
+ * The signed-in user's own profile: the full name, one field per declared
+ * external system, and the free-form instructions the assistant receives.
+ *
+ * The form is seeded from the stored profile each time it opens, so a closed
+ * dialog never keeps stale edits; limits mirror the Host's, which stays the
+ * authority — the browser only avoids a round trip for the obvious refusals.
+ */
+export declare function QaProfileModal(props: QaProfileModalProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaProfile.d.ts.map

package/lib/types/client/components/QaRightRail.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from "react";
+import type { QaRailTab } from "../use-session-ui-state.js";
+/** One rail tab's strip chip: label, live count, and its body is the panel. */
+export interface QaRailTabModel {
+    readonly id: QaRailTab;
+    readonly title: string;
+    /** Items the tab will show; 0 hides the badge. */
+    readonly count: number;
+    readonly body: ReactNode;
+}
+export interface QaRightRailProps {
+    readonly tabs: readonly QaRailTabModel[];
+    readonly activeTab: QaRailTab;
+    readonly onTabSelect: (tab: QaRailTab) => void;
+    readonly onClose: () => void;
+}
+/**
+ * The chat's right rail: a fixed column whose top edge is the tab strip,
+ * mirroring the Harness right Sidebar's chrome. Tabs are plain chips with
+ * counts; the strip's last control collapses the whole column.
+ */
+export declare function QaRightRail({ tabs, activeTab, onTabSelect, onClose, }: QaRightRailProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=QaRightRail.d.ts.map

package/lib/types/client/components/QaSidebar.d.ts

@@ -1,4 +1,5 @@
-import type { SessionSummary } from "@deepseek-ai/dsh-client-runtime/client";
+import type { SessionSummary } from "@deepseek-ai/dsh-api-session-controller/client";
+import type { QaAccountIdentityField, QaAccountProfile, QaAccountProfileInput } from "../../types.js";
 /** One renderable row of the chat-history sidebar. */
 export interface QaChatRow {
     readonly id: string;
@@ -7,6 +8,8 @@ export interface QaChatRow {
     readonly active: boolean;
     readonly meta: string;
     readonly updatedAt: number;
+    /** Chat owner's display name; present in the admin ownership view only. */
+    readonly ownerName?: string;
 }
 /**
  * Project this browser's indexed chat ids onto the host session list, most
@@ -14,9 +17,29 @@ export interface QaChatRow {
  * `updatedAt` (fresh messages) orders the list. Ids the host no longer lists
  * are skipped (the controller prunes them on switch).
  */
-export declare function buildChatRows(chatIds: readonly string[], byId: Readonly<Record<string, SessionSummary>>, activeId: string | null, now?: number): readonly QaChatRow[];
+export declare function buildChatRows(chatIds: readonly string[], byId: Readonly<Record<string, SessionSummary>>, activeId: string | null, ownerNameOf?: (sessionId: string) => string | undefined, now?: number): readonly QaChatRow[];
+/** One per-owner section of the admin sidebar grouping. */
+export interface QaSidebarSection {
+    /**
+     * Section header; chats nobody claimed group under "Без владельца". An
+     * empty name renders no header (the flat, non-grouped mode).
+     */
+    readonly name: string;
+    readonly rows: readonly QaChatRow[];
+}
+/**
+ * Group rows into per-owner sections for the admin view. Sections order by
+ * their freshest row so the busiest users float up; unclaimed chats go last.
+ * Row order inside a section is already the global updatedAt order.
+ */
+export declare function buildOwnerSections(rows: readonly QaChatRow[]): readonly QaSidebarSection[];
 export interface QaSidebarProps {
     readonly rows: readonly QaChatRow[];
+    /**
+     * Render per-owner sections instead of the flat list; the admin ownership
+     * view. Rows without an owner name fall into a trailing section.
+     */
+    readonly groupByOwner?: boolean;
     /** Deployment brand shown next to the logo (also while collapsed). */
     readonly title: string;
     /** Optional image logo; a built-in mark is drawn when null. */
@@ -29,6 +52,25 @@ export interface QaSidebarProps {
     readonly onNewChat: () => void;
     /** Removes a chat from this browser's index; omit to hide the control. */
     readonly onDelete?: (sessionId: string) => void;
+    /** The signed-in account; omit when accounts are disabled. */
+    readonly account?: {
+        readonly email: string;
+        readonly role: string;
+        readonly onLogout: () => void;
+        /**
+         * Self-service profile editing. Omitted when the deployment turns the
+         * feature off, which also leaves the footer name as plain text. Memoized
+         * by the caller: this object is compared by reference.
+         */
+        readonly profileDialog?: {
+            readonly profile: QaAccountProfile;
+            /** Handle fields the dialog renders, in the deployment's order. */
+            readonly fields: readonly QaAccountIdentityField[];
+            readonly instructionsMaxLength: number;
+            /** Persist edited fields; resolves to refusal copy, or null. */
+            readonly onSave: (input: QaAccountProfileInput) => Promise<string | null>;
+        };
+    };
 }
 /**
  * Whether two sidebar row lists show the same thing. Rows are rebuilt on

package/lib/types/client/components/QaSourcesPanel.d.ts

@@ -0,0 +1,23 @@
+import type { QaSource, QaTurnSources, ResolvedQaSurfaceConfig } from "../../types.js";
+import type { QaBoundSourceApi } from "../types.js";
+export declare function SourceIcon({ kind }: {
+    readonly kind: QaSource["kind"];
+}): import("react/jsx-runtime").JSX.Element;
+export interface QaSourcesPanelProps {
+    readonly sources: readonly QaSource[];
+    readonly complete: boolean;
+    readonly incompleteOrigins?: QaTurnSources["incompleteOrigins"];
+    readonly sessionId: string | null;
+    readonly sourceApi: QaBoundSourceApi;
+    readonly display: ResolvedQaSurfaceConfig["sources"]["display"];
+    readonly filePreview: ResolvedQaSurfaceConfig["sources"]["filePreview"];
+    /** Open straight onto this source's detail (an inline footnote click). */
+    readonly initialDetail?: QaSource | null;
+    /** The list is a message-scoped subset rather than the whole chat. */
+    readonly pinned?: boolean;
+    /** Dismiss the pinned subset and show the whole chat's sources. */
+    readonly onShowAll?: () => void;
+}
+/** Canonical grouped source panel and safe local-file preview. */
+export declare function QaSourcesPanel({ sources, complete, incompleteOrigins, sessionId, sourceApi, display, filePreview, initialDetail, pinned, onShowAll, }: QaSourcesPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QaSourcesPanel.d.ts.map

package/lib/types/client/components/QaTurnRail.d.ts

@@ -0,0 +1,65 @@
+import { type RefObject } from "react";
+import type { QaMessage } from "../../types.js";
+/**
+ * One mark of the turn rail: the user prompt that opens the turn, a bounded
+ * answer preview for the hover tooltip, and the message id that anchors the
+ * jump (the prompt's message slot in the transcript).
+ */
+export interface QaTurnRailItem {
+    /** 1-based position in the visible transcript; also the React key. */
+    readonly turn: number;
+    /** The user message id that opens the turn (scroll anchor). */
+    readonly id: string;
+    readonly prompt: string;
+    readonly response: string;
+}
+/** Transcript attribute marking the message slot that opens a turn. */
+export declare const QA_TURN_ANCHOR_ATTRIBUTE = "data-dsh-qa-turn-anchor";
+/** Scroll distance from the floor at which the rail still calls it "at bottom". */
+export declare const QA_TURN_FOLLOW_PX = 96;
+/** The reading line: reading offset from the scrollport top while scrolling. */
+export declare const QA_TURN_READING_PX = 96;
+/**
+ * Rail ladder of the visible transcript: every user prompt opens a turn, the
+ * first non-empty answer after it fills the response preview. Hidden variant
+ * answers never reach this list because callers pass the already-filtered
+ * messages.
+ */
+export declare function buildTurnRailItems(messages: readonly QaMessage[]): readonly QaTurnRailItem[];
+/** Deep equality guard so the memoized rail skips streaming commits. */
+export declare function sameTurnRailItems(left: readonly QaTurnRailItem[], right: readonly QaTurnRailItem[]): boolean;
+/**
+ * Turn owning the transcript's reading line, or the newest one while the
+ * reader follows the live tail. Anchors above the line are scanned in flow
+ * order; the last one at or above it owns the mark.
+ */
+export declare function computeActiveTurn(scroller: HTMLElement, items: readonly QaTurnRailItem[]): number | null;
+export interface QaTurnRailProps {
+    readonly items: readonly QaTurnRailItem[];
+    readonly activeTurn: number | null;
+    /** Turn still generating; its mark pulses. */
+    readonly busyTurn: number | null;
+    /** The transcript scroller the rail floats over and measures its band from. */
+    readonly scrollerRef: RefObject<HTMLDivElement | null>;
+    readonly onNavigate: (item: QaTurnRailItem) => void;
+}
+declare function QaTurnRailView({ items, activeTurn, busyTurn, scrollerRef, onNavigate, }: QaTurnRailProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Fixed-pitch rail of every turn of the visible transcript, floating over the
+ * transcript's right gutter: the active mark follows the reading line, a
+ * hover/focus preview shows the prompt and answer, and a click lands the
+ * transcript on that turn. Memoized like the harness rail — the transcript
+ * re-renders on every streaming delta, and the rail only changes when a turn
+ * is added or becomes active.
+ */
+export declare const QaTurnRail: import("react").MemoExoticComponent<typeof QaTurnRailView>;
+/** Land the transcript on a turn's prompt row, harness-style. */
+export declare function turnScrollTarget(scroller: HTMLElement, row: HTMLElement): number;
+/**
+ * Find the message slot carrying `anchorId` and land the transcript on it,
+ * harness-style. Returns whether the anchor row exists; callers tie their
+ * near-bottom bookkeeping and rail-mark updates to that outcome.
+ */
+export declare function scrollToTranscriptAnchor(scroller: HTMLElement, anchorId: string): boolean;
+export {};
+//# sourceMappingURL=QaTurnRail.d.ts.map

package/lib/types/client/components/QaWelcomeNotice.d.ts

@@ -0,0 +1,27 @@
+import type { SettingsOnboardingOwnerProps } from "@deepseek-ai/dsh-client-ui-settings/client";
+import type { StorageLike } from "../types.js";
+/** Bump when the notice changes materially and must be acknowledged again. */
+export declare const QA_WELCOME_NOTICE_VERSION = "2026-09-12.1";
+export declare const QA_WELCOME_NOTICE_COPY: Readonly<{
+    title: "Перед началом тестирования";
+    paragraphs: readonly string[];
+    continueLabel: "Понятно, продолжить";
+}>;
+export interface QaWelcomeNoticeFace {
+    readonly storage: StorageLike;
+    readonly storageKey: string;
+}
+export interface QaWelcomeNoticeProps extends QaWelcomeNoticeFace {
+    readonly complete?: () => void;
+}
+export interface QaWelcomeNoticeStepProps extends SettingsOnboardingOwnerProps, QaWelcomeNoticeFace {
+}
+/** Route-scoped replacement for DSH's stock `welcome-notice` onboarding step. */
+export declare function QaWelcomeNotice(props: QaWelcomeNoticeProps): import("react").ReactPortal | null;
+/**
+ * Invisible shadow for DSH's stock welcome step. The host coordinator removes
+ * onboarding content as soon as a chat stops being blank, so the visible QA
+ * notice is owned by the route overlay above instead of this lifecycle.
+ */
+export declare function QaWelcomeNoticeStep(props: QaWelcomeNoticeStepProps): null;
+//# sourceMappingURL=QaWelcomeNotice.d.ts.map