@yadsh/dsh-qa-surface 0.3.0 → 0.4.0

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

@@ -1,4 +1,4 @@
-import type { QaAccountUserPublic, QaOwnershipEntry, ResolvedQaSurfaceConfig } from "../types.js";
+import type { QaAccountProfileInput, QaAccountUserPublic, QaOwnershipEntry, ResolvedQaSurfaceConfig } from "../types.js";
 import type { QaAccountsApi, StorageLike } from "./types.js";
 export type QaAccountsSnapshot = {
     readonly stage: "checking";
@@ -72,6 +72,13 @@ export declare class QaAccountsController {
     signOut(): void;
     /** Claim one freshly created chat so the ownership map stays current. */
     claimNewSession(sessionId: string): Promise<void>;
+    /**
+     * Replace the signed-in user's own profile. Resolves to audience-safe
+     * refusal copy when the Host rejected the write, and to null once the
+     * snapshot carries the stored profile — the form reports the outcome inline
+     * rather than through the gate's state machine.
+     */
+    updateProfile(input: QaAccountProfileInput): Promise<string | null>;
     private authenticate;
     /** Own the account, migrate the legacy index, then project authed. */
     private enterSession;

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

@@ -1,6 +1,6 @@
 import type { ConnectionGenerationState } from "@deepseek-ai/dsh-client-connection/client";
-import type { QaImageDraft, QaSessionState, ResolvedQaSurfaceConfig } from "../types.js";
-import type { QaConversation, QaSecureSession, QaSessions, QaSessionsApi, QaSourceApi, StorageLike } from "./types.js";
+import type { QaAttachmentDraft, QaSessionState, ResolvedQaSurfaceConfig } from "../types.js";
+import type { QaConversation, QaCreateSession, QaFileUpload, QaSecureSession, QaSessions, QaSessionsApi, QaSourceApi, StorageLike } from "./types.js";
 export interface QaAccountsFacade {
     /** The account bearer token, or null while anonymous. */
     readonly token: () => string | null;
@@ -19,6 +19,7 @@ export interface QaAccountsFacade {
 export interface QaSessionControllerOptions {
     readonly sessions: QaSessions;
     readonly api: QaSessionsApi;
+    readonly createSession: QaCreateSession;
     /** Conversation assembly feeding the transcript projection. */
     readonly conversation: QaConversation;
     readonly connection: ConnectionGenerationState;
@@ -26,6 +27,11 @@ export interface QaSessionControllerOptions {
     readonly secureSession: QaSecureSession;
     readonly sourceApi?: QaSourceApi;
     readonly storage?: StorageLike;
+    /**
+     * Browser file-upload service, resolved lazily: the page may not serve the
+     * upload plugin, and a deployment without it keeps images and text only.
+     */
+    readonly fileUpload?: () => QaFileUpload | undefined;
     /** Present while the deployment gates QA users with accounts. */
     readonly accounts?: QaAccountsFacade;
     readonly timeoutMs?: number;
@@ -45,7 +51,7 @@ export interface QaSessionControllerOptions {
 export declare class QaSessionController {
     private readonly listeners;
     private readonly sessions;
-    private readonly api;
+    private readonly createSessionRemote;
     private readonly conversation;
     private readonly connection;
     private readonly config;
@@ -53,10 +59,13 @@ export declare class QaSessionController {
     private readonly sourceApi;
     private readonly chats;
     private readonly accounts;
+    /** Resolved per send: a page without the upload plugin has no receipts. */
+    private readonly fileUpload;
     /** Per-chat attachment URL cache; blob URLs die with the chat binding. */
     private readonly assets;
     private readonly timeoutMs;
-    private readonly streamIntervalMs;
+    /** Spacing for a running turn's stream frames; the policy lives there. */
+    private readonly streamPublisher;
     private state;
     private session;
     private conversationBinding;
@@ -69,7 +78,6 @@ export declare class QaSessionController {
     private admissionPending;
     private policyReady;
     private drafting;
-    private streamFlushTimer;
     /** The chat session to return to when a subagent view closes. */
     private chatSessionId;
     private viewingSubagent;
@@ -83,7 +91,7 @@ export declare class QaSessionController {
     getSnapshot: () => QaSessionState;
     subscribe: (listener: () => void) => (() => void);
     ensureSession(): Promise<void>;
-    send(text: string, images?: readonly QaImageDraft[]): Promise<boolean>;
+    send(text: string, attachments?: readonly QaAttachmentDraft[]): Promise<boolean>;
     /**
      * Ask for a fresh variant of the previous answer. The session has no
      * truncation seam, so this sends the hidden regeneration instruction as an
@@ -160,17 +168,9 @@ export declare class QaSessionController {
     private bind;
     private unbind;
     private waitForConnection;
-    /**
-     * Project one session notification. A running turn's frames arrive at
-     * animation-frame cadence, so re-projections are spaced at least
-     * {@link streamIntervalMs} apart: the first frame of a window projects at
-     * once and further frames are absorbed (the memoized render path replays
-     * nothing, so absorbing a frame only defers it). Everything outside a
-     * running turn - phase flips, errors, turn completion - projects
-     * immediately.
-     */
+    /** Project one session notification; the running-turn spacing policy
+     * (first frame at once, further frames absorbed) lives in the publisher. */
     private publishSessionUpdate;
-    private clearStreamFlush;
     private publish;
     private fail;
     /**

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

@@ -3,7 +3,7 @@ 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 { QaAccountsController } from "./QaAccountsController.js";
-import type { QaConversation, QaSecureSession, QaSessions, QaSessionsApi, QaSourceApi } from "./types.js";
+import type { QaConversation, QaCreateSession, QaFileUpload, QaSecureSession, QaSessions, QaSessionsApi, QaSourceApi } from "./types.js";
 export interface QaSurfaceFace {
     readonly route: QaRouteController;
     readonly config: QaConfigController;
@@ -12,7 +12,13 @@ export interface QaSurfaceFace {
     readonly api: QaSessionsApi;
     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;
 }

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/QaChangelog.d.ts

@@ -17,5 +17,5 @@ export interface QaChangelogModalProps {
  * 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 | null;
+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

@@ -16,6 +16,8 @@ export interface QaMessageProps {
     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
@@ -24,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, onOpenSources, onSourceDetail, }: 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-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;
@@ -56,6 +57,19 @@ export interface QaSidebarProps {
         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>;
+        };
     };
 }
 /**

package/lib/types/client/components/{QaSourcesDrawer.d.ts → QaSourcesPanel.d.ts}

@@ -3,7 +3,7 @@ import type { QaBoundSourceApi } from "../types.js";
 export declare function SourceIcon({ kind }: {
     readonly kind: QaSource["kind"];
 }): import("react/jsx-runtime").JSX.Element;
-export interface QaSourcesDrawerProps {
+export interface QaSourcesPanelProps {
     readonly sources: readonly QaSource[];
     readonly complete: boolean;
     readonly incompleteOrigins?: QaTurnSources["incompleteOrigins"];
@@ -13,8 +13,11 @@ export interface QaSourcesDrawerProps {
     readonly filePreview: ResolvedQaSurfaceConfig["sources"]["filePreview"];
     /** Open straight onto this source's detail (an inline footnote click). */
     readonly initialDetail?: QaSource | null;
-    readonly onClose: () => void;
+    /** 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 QaSourcesDrawer({ sources, complete, incompleteOrigins, sessionId, sourceApi, display, filePreview, initialDetail, onClose, }: QaSourcesDrawerProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=QaSourcesDrawer.d.ts.map
+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

@@ -55,5 +55,11 @@ declare function QaTurnRailView({ items, activeTurn, busyTurn, scrollerRef, onNa
 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/QaWidthHandle.d.ts

@@ -1,15 +1,21 @@
 import { type RefObject } from "react";
-/** DSH's dragged content-width floor; a lower operator cap still wins. */
-export declare const QA_CONTENT_MIN_WIDTH = 640;
 /**
  * Space kept outside the content: 88px per side leaves room for the handle,
- * its inset, and a safe zone that remains draggable in both directions.
+ * its inset, and a safe zone that remains draggable in both directions. It is
+ * the whole ceiling too: like DSH, the page bounds the width, so a wide column
+ * lets the transcript fill it.
  */
 export declare const QA_CONTENT_EDGE_BUDGET = 176;
 export declare function readQaContentWidth(storage: Pick<Storage, "getItem">, key: string): number | null;
 export declare function writeQaContentWidth(storage: Pick<Storage, "setItem">, key: string, width: number): void;
-/** Resolve the centered content width for the currently available column. */
-export declare function resolveQaContentWidth(columnWidth: number, preference: number | null, maxContentWidth: number): number;
+/**
+ * Resolve the centered content width for the currently available column. The
+ * operator sets only the floor; the column is the ceiling, so the content may
+ * grow until its handles reach the edge budget and a wider window keeps
+ * widening it. A column too narrow even for the floor wins over the floor —
+ * there is nothing else to give up.
+ */
+export declare function resolveQaContentWidth(columnWidth: number, preference: number | null, minContentWidth: number): number;
 interface QaWidthHandleProps {
     readonly side: "left" | "right";
     readonly onStart: () => number;
@@ -24,13 +30,14 @@ interface UseQaContentWidthOptions {
     readonly root: RefObject<HTMLDivElement | null>;
     readonly storage: Pick<Storage, "getItem" | "setItem">;
     readonly storageKey: string;
-    readonly maxContentWidth: number;
+    readonly minContentWidth: number;
 }
-export declare function useQaContentWidth({ active, root, storage, storageKey, maxContentWidth, }: UseQaContentWidthOptions): {
+export declare function useQaContentWidth({ active, root, storage, storageKey, minContentWidth, }: UseQaContentWidthOptions): {
     readonly onStart: () => number;
     readonly onDrag: (requestedWidth: number) => void;
     readonly onCommit: (requestedWidth: number) => void;
     readonly onEnd: () => void;
 };
+export type UseQaContentWidthResult = ReturnType<typeof useQaContentWidth>;
 export {};
 //# sourceMappingURL=QaWidthHandle.d.ts.map

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

@@ -1,12 +1,14 @@
 import type { QaWorkItem } from "../../types.js";
 export interface QaWorkGroupProps {
-    readonly status: "running" | "complete";
+    /** "error" marks a turn the host ended with a provider failure. */
+    readonly status: "running" | "complete" | "error";
     readonly startedAt?: number;
     readonly endedAt?: number;
     readonly items: readonly QaWorkItem[];
     readonly renderMarkdown: boolean;
+    /** Operator-configured running phrases; omitted reads the built-in list. */
+    readonly thinkingPhrases?: readonly string[];
 }
-export declare const THINKING_PHRASES: readonly string[];
 /**
  * Whether two work items render identically. The transcript projection
  * rebuilds every item object on each published frame, so memoized work rows
@@ -15,5 +17,5 @@ export declare const THINKING_PHRASES: readonly string[];
 export declare function sameWorkItem(a: QaWorkItem, b: QaWorkItem): boolean;
 /** Whether two work item lists render identically, item for item. */
 export declare function sameWorkItems(a: readonly QaWorkItem[], b: readonly QaWorkItem[]): boolean;
-export declare const QaWorkGroup: import("react").MemoExoticComponent<({ status, startedAt, endedAt, items, renderMarkdown, }: QaWorkGroupProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const QaWorkGroup: import("react").MemoExoticComponent<({ status, startedAt, endedAt, items, renderMarkdown, thinkingPhrases, }: QaWorkGroupProps) => import("react/jsx-runtime").JSX.Element>;
 //# sourceMappingURL=QaWorkGroup.d.ts.map

package/lib/types/client/components/surface-utils.d.ts

@@ -0,0 +1,11 @@
+import type { QaSessionState } from "../../types.js";
+/**
+ * Small pure projections of the session state shared by surface regions: the
+ * composer's status line and the conversation title. Keeping them out of
+ * QaSurface leaves that file pure composition.
+ */
+/** The composer's status line, or null when nothing is due. */
+export declare function statusText(state: QaSessionState, runningPhrase: string | null): string | null;
+/** The conversation title derived from the first user prompt, clipped. */
+export declare function titleFromMessages(state: QaSessionState): string | null;
+//# sourceMappingURL=surface-utils.d.ts.map

package/lib/types/client/components/thinking-phrases.d.ts

@@ -0,0 +1,9 @@
+import { DEFAULT_THINKING_PHRASES, thinkingPhrase } from "../../thinking-phrases.js";
+export { DEFAULT_THINKING_PHRASES, thinkingPhrase };
+/**
+ * Phrase for a turn that started at `startedAt`. Every reader that passes the
+ * same start time and phrase list lands on the same phrase, so the composer
+ * hint and the work list never disagree.
+ */
+export declare function useThinkingPhrase(running: boolean, startedAt: number | undefined, phrases?: readonly string[]): string | null;
+//# sourceMappingURL=thinking-phrases.d.ts.map

package/lib/types/client/create-session.d.ts

@@ -1,16 +1,13 @@
-import type { ResolvedQaSurfaceConfig } from "../types.js";
-import type { QaSessions, QaSessionsApi } from "./types.js";
+import type { QaCreateSession } from "./types.js";
 /**
- * Create one Host session and pin the configured preset and model onto the
- * still-blank session. The creation wire takes no preset, so
- * agentPresets/select recomposes the agent and durably logs
- * `agent-preset/selected`, which the client projection replays. The session
+ * Ask the QA Host boundary to create a fully composed session. The browser
+ * supplies only its account token and cannot select cwd, workspace, owner,
+ * preset, model, or permission policy. The resulting session
  * is addressed only here — no prompt can run before the caller attests the
  * composed preset.
  */
 export declare function createQaSession(args: {
-    readonly sessions: QaSessions;
-    readonly api: QaSessionsApi;
-    readonly config: ResolvedQaSurfaceConfig;
+    readonly createSession: QaCreateSession;
+    readonly token: string;
 }): Promise<string>;
 //# sourceMappingURL=create-session.d.ts.map

package/lib/types/client/failure-copy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * QA-facing copy for provider failures, keyed by the stable failure code the
+ * host records on retry and turn-end events. Raw provider messages never
+ * reach these rows — they can carry stack traces and local paths — so every
+ * text here derives from the code alone.
+ */
+/** Terminal turn-failure row shown after the work group. */
+export declare function turnErrorCopy(code: string | undefined): string;
+export interface RetryCopySource {
+    readonly mode: "normal" | "always";
+    readonly retry: number;
+    readonly maxRetries?: number;
+    readonly delayMs: number;
+    readonly retryState: "scheduled" | "started" | "cancelled";
+    readonly failureCode?: string;
+}
+/** Work-group row for one host-scheduled model-request retry. */
+export declare function retryWorkCopy(node: RetryCopySource): string;
+//# sourceMappingURL=failure-copy.d.ts.map