@qilin-agent/client-ui-chat 0.0.0-stage → 3.1.4

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

@@ -0,0 +1,386 @@
+/** Chat-owned locale namespace and dictionaries. */
+/** Namespace for Chat target, node, statistics, and details copy. */
+export declare const NS = "chat";
+/** Simplified Chinese dictionary and key-set source of truth. */
+export declare const zh: {
+    'view.chat': string;
+    'image.open': string;
+    'image.loading': string;
+    'image.failed': string;
+    'image.dialog': string;
+    'image.close': string;
+    'number.groupSeparator': string;
+    'duration.compactSeconds': string;
+    'duration.compactMinutes': string;
+    'duration.milliseconds': string;
+    'stats.counts': string;
+    'stats.cacheHit': string;
+    'stats.dialog.title': string;
+    'stats.dialog.usageTitle': string;
+    'stats.dialog.llmTime': string;
+    'stats.dialog.toolTime': string;
+    'stats.dialog.ttft': string;
+    'stats.dialog.speed': string;
+    'chat.loadingHistory': string;
+    'chat.loadError': string;
+    'chat.loadOlder': string;
+    'chat.toBottom': string;
+    'chat.running': string;
+    'chat.runningFor': string;
+    'chat.turnNavigation.label': string;
+    'chat.turnNavigation.jump': string;
+    'chat.turnNavigation.jumpLoad': string;
+    'chat.turnNavigation.turn': string;
+    'settings.transcript.title': string;
+    'settings.transcript.description': string;
+    'settings.transcript.compact': string;
+    'settings.transcript.standard': string;
+    'settings.transcript.detailed': string;
+    'settings.transcript.verbose': string;
+    'settings.performance.title': string;
+    'settings.performance.description': string;
+    'settings.performance.compact': string;
+    'settings.performance.detailed': string;
+    'settings.links.title': string;
+    'settings.links.description': string;
+    'settings.links.sidebar': string;
+    'settings.links.newTab': string;
+    'settings.collapse.title': string;
+    'settings.collapse.description': string;
+    'settings.collapse.completion': string;
+    'settings.collapse.nextInput': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'message.extraBlock': string;
+    'message.systemPrompt': string;
+    'message.systemPromptUpdate': string;
+    'message.contextInjection': string;
+    'message.toolAdded': string;
+    'message.toolRemoved': string;
+    'message.toolsAdded': string;
+    'message.toolsAddedCount': string;
+    'message.toolsChanged': string;
+    'message.toolsRemoved': string;
+    'message.toolsRemovedCount': string;
+    'message.toolsUpdated': string;
+    'message.contextRecall': string;
+    'message.referenceSummary': string;
+    'message.referenceSeparator': string;
+    'message.context.instructions.loaded': string;
+    'message.context.instructions.added': string;
+    'message.context.instructions.updated': string;
+    'message.context.instructions.removed': string;
+    'message.context.catalog.replaced': string;
+    'message.context.catalog.more': string;
+    'message.context.snapshot.supersedes': string;
+    'message.context.relay.from': string;
+    'message.context.recall.counts': string;
+    'message.context.recall.truncated': string;
+    'message.compaction': string;
+    'message.compaction.running': string;
+    'message.compaction.completed': string;
+    'message.compaction.expand': string;
+    'message.compaction.unavailable': string;
+    'message.compaction.commandTitle': string;
+    'message.think': string;
+    'message.unknownSurface': string;
+    'message.unknownBlock': string;
+    'message.turnProcess.worked': string;
+    'message.turnProcess.took': string;
+    'message.turnProcess.failed': string;
+    'message.turnProcess.toolCalls.one': string;
+    'message.turnProcess.toolCalls.other': string;
+    'message.turnProcess.messages.one': string;
+    'message.turnProcess.messages.other': string;
+    'message.turnProcess.subagents.one': string;
+    'message.turnProcess.subagents.other': string;
+    'message.turnProcess.thoughtForAWhile': string;
+    'message.turnProcess.separator': string;
+    'message.stepProcess.thinking': string;
+    'message.stepProcess.read': string;
+    'message.stepProcess.readImage': string;
+    'message.stepProcess.write': string;
+    'message.stepProcess.search': string;
+    'message.stepProcess.edit': string;
+    'message.stepProcess.commands': string;
+    'message.stepProcess.code': string;
+    'message.stepProcess.webSearch': string;
+    'message.stepProcess.webFetch': string;
+    'message.stepProcess.subagents': string;
+    'message.stepProcess.plan': string;
+    'message.stepProcess.questions': string;
+    'message.stepProcess.tools': string;
+    'message.stepProcess.prepare.read': string;
+    'message.stepProcess.prepare.readImage': string;
+    'message.stepProcess.prepare.write': string;
+    'message.stepProcess.prepare.search': string;
+    'message.stepProcess.prepare.edit': string;
+    'message.stepProcess.prepare.commands': string;
+    'message.stepProcess.prepare.code': string;
+    'message.stepProcess.prepare.webSearch': string;
+    'message.stepProcess.prepare.webFetch': string;
+    'message.stepProcess.prepare.subagents': string;
+    'message.stepProcess.prepare.plan': string;
+    'message.stepProcess.prepare.questions': string;
+    'message.stepProcess.prepare.tools': string;
+    'message.stepProcess.done.thinking': string;
+    'message.stepProcess.done.read': string;
+    'message.stepProcess.done.readImage': string;
+    'message.stepProcess.done.write': string;
+    'message.stepProcess.done.search': string;
+    'message.stepProcess.done.edit': string;
+    'message.stepProcess.done.commands': string;
+    'message.stepProcess.done.code': string;
+    'message.stepProcess.done.webSearch': string;
+    'message.stepProcess.done.webFetch': string;
+    'message.stepProcess.done.subagents': string;
+    'message.stepProcess.done.plan': string;
+    'message.stepProcess.done.questions': string;
+    'message.stepProcess.done.tools': string;
+    'message.stepProcess.joinTwo': string;
+    'message.stepProcess.comma': string;
+    'message.stepProcess.sharedPrefix': string;
+    'message.stepProcess.more': string;
+    'message.trigger.request': string;
+    'message.trigger.goal': string;
+    'message.trigger.agent': string;
+    'message.trigger.team': string;
+    'message.trigger.subagent': string;
+    'message.trigger.github': string;
+    'message.trigger.webhook': string;
+    'message.trigger.schedule': string;
+    'message.trigger.job': string;
+    'message.trigger.plugin': string;
+    'message.trigger.explanation': string;
+    'message.stopped': string;
+    'message.branch': string;
+    'message.branchUnavailable': string;
+    'message.edit': string;
+    'message.retry.active': string;
+    'message.retry.cancelled': string;
+    'message.retry.started': string;
+    'message.retry.scheduled': string;
+    'message.retry.status': string;
+    'message.retry.delay': string;
+    'message.retry.failure': string;
+    'message.failure.auth': string;
+    'message.turnError': string;
+    'message.maxTokens': string;
+    'message.maxTokens.hint': string;
+    'message.tokensPerSecond': string;
+    'message.turnUsage.title': string;
+    'message.turnUsage.consumed': string;
+    'message.turnUsage.model': string;
+    'message.turnUsage.cacheHit': string;
+    'message.turnUsage.input': string;
+    'message.turnUsage.cacheRead': string;
+    'message.turnUsage.cacheWrite': string;
+    'message.turnUsage.output': string;
+    'message.turnUsage.reasoning': string;
+    'message.turnUsage.count': string;
+    'duration.secondUnit': string;
+    'duration.minuteUnit': string;
+    'duration.hourUnit': string;
+    'command.running': string;
+    'command.failed': string;
+    'command.done': string;
+    'command.title': string;
+    'row.running': string;
+    'row.failed': string;
+    'json.truncated': string;
+    'clock.md': string;
+    'clock.ymd': string;
+};
+/** Chat dictionary key union. */
+export type ChatKey = keyof typeof zh;
+/** English dictionary, checked against the Chinese key set. */
+export declare const en: {
+    'view.chat': string;
+    'image.open': string;
+    'image.loading': string;
+    'image.failed': string;
+    'image.dialog': string;
+    'image.close': string;
+    'number.groupSeparator': string;
+    'duration.compactSeconds': string;
+    'duration.compactMinutes': string;
+    'duration.milliseconds': string;
+    'stats.counts': string;
+    'stats.cacheHit': string;
+    'stats.dialog.title': string;
+    'stats.dialog.usageTitle': string;
+    'stats.dialog.llmTime': string;
+    'stats.dialog.toolTime': string;
+    'stats.dialog.ttft': string;
+    'stats.dialog.speed': string;
+    'chat.loadingHistory': string;
+    'chat.loadError': string;
+    'chat.loadOlder': string;
+    'chat.toBottom': string;
+    'chat.running': string;
+    'chat.runningFor': string;
+    'chat.turnNavigation.label': string;
+    'chat.turnNavigation.jump': string;
+    'chat.turnNavigation.jumpLoad': string;
+    'chat.turnNavigation.turn': string;
+    'settings.transcript.title': string;
+    'settings.transcript.description': string;
+    'settings.transcript.compact': string;
+    'settings.transcript.standard': string;
+    'settings.transcript.detailed': string;
+    'settings.transcript.verbose': string;
+    'settings.performance.title': string;
+    'settings.performance.description': string;
+    'settings.performance.compact': string;
+    'settings.performance.detailed': string;
+    'settings.links.title': string;
+    'settings.links.description': string;
+    'settings.links.sidebar': string;
+    'settings.links.newTab': string;
+    'settings.collapse.title': string;
+    'settings.collapse.description': string;
+    'settings.collapse.completion': string;
+    'settings.collapse.nextInput': string;
+    'fileOpen.title': string;
+    'fileOpen.unknown': string;
+    'message.extraBlock': string;
+    'message.systemPrompt': string;
+    'message.systemPromptUpdate': string;
+    'message.contextInjection': string;
+    'message.toolAdded': string;
+    'message.toolRemoved': string;
+    'message.toolsAdded': string;
+    'message.toolsAddedCount': string;
+    'message.toolsChanged': string;
+    'message.toolsRemoved': string;
+    'message.toolsRemovedCount': string;
+    'message.toolsUpdated': string;
+    'message.contextRecall': string;
+    'message.referenceSummary': string;
+    'message.referenceSeparator': string;
+    'message.context.instructions.loaded': string;
+    'message.context.instructions.added': string;
+    'message.context.instructions.updated': string;
+    'message.context.instructions.removed': string;
+    'message.context.catalog.replaced': string;
+    'message.context.catalog.more': string;
+    'message.context.snapshot.supersedes': string;
+    'message.context.relay.from': string;
+    'message.context.recall.counts': string;
+    'message.context.recall.truncated': string;
+    'message.compaction': string;
+    'message.compaction.running': string;
+    'message.compaction.completed': string;
+    'message.compaction.expand': string;
+    'message.compaction.unavailable': string;
+    'message.compaction.commandTitle': string;
+    'message.think': string;
+    'message.unknownSurface': string;
+    'message.unknownBlock': string;
+    'message.turnProcess.worked': string;
+    'message.turnProcess.took': string;
+    'message.turnProcess.failed': string;
+    'message.turnProcess.toolCalls.one': string;
+    'message.turnProcess.toolCalls.other': string;
+    'message.turnProcess.messages.one': string;
+    'message.turnProcess.messages.other': string;
+    'message.turnProcess.subagents.one': string;
+    'message.turnProcess.subagents.other': string;
+    'message.turnProcess.thoughtForAWhile': string;
+    'message.turnProcess.separator': string;
+    'message.stepProcess.thinking': string;
+    'message.stepProcess.read': string;
+    'message.stepProcess.readImage': string;
+    'message.stepProcess.write': string;
+    'message.stepProcess.search': string;
+    'message.stepProcess.edit': string;
+    'message.stepProcess.commands': string;
+    'message.stepProcess.code': string;
+    'message.stepProcess.webSearch': string;
+    'message.stepProcess.webFetch': string;
+    'message.stepProcess.subagents': string;
+    'message.stepProcess.plan': string;
+    'message.stepProcess.questions': string;
+    'message.stepProcess.tools': string;
+    'message.stepProcess.prepare.read': string;
+    'message.stepProcess.prepare.readImage': string;
+    'message.stepProcess.prepare.write': string;
+    'message.stepProcess.prepare.search': string;
+    'message.stepProcess.prepare.edit': string;
+    'message.stepProcess.prepare.commands': string;
+    'message.stepProcess.prepare.code': string;
+    'message.stepProcess.prepare.webSearch': string;
+    'message.stepProcess.prepare.webFetch': string;
+    'message.stepProcess.prepare.subagents': string;
+    'message.stepProcess.prepare.plan': string;
+    'message.stepProcess.prepare.questions': string;
+    'message.stepProcess.prepare.tools': string;
+    'message.stepProcess.done.thinking': string;
+    'message.stepProcess.done.read': string;
+    'message.stepProcess.done.readImage': string;
+    'message.stepProcess.done.write': string;
+    'message.stepProcess.done.search': string;
+    'message.stepProcess.done.edit': string;
+    'message.stepProcess.done.commands': string;
+    'message.stepProcess.done.code': string;
+    'message.stepProcess.done.webSearch': string;
+    'message.stepProcess.done.webFetch': string;
+    'message.stepProcess.done.subagents': string;
+    'message.stepProcess.done.plan': string;
+    'message.stepProcess.done.questions': string;
+    'message.stepProcess.done.tools': string;
+    'message.stepProcess.joinTwo': string;
+    'message.stepProcess.comma': string;
+    'message.stepProcess.sharedPrefix': string;
+    'message.stepProcess.more': string;
+    'message.trigger.request': string;
+    'message.trigger.goal': string;
+    'message.trigger.agent': string;
+    'message.trigger.team': string;
+    'message.trigger.subagent': string;
+    'message.trigger.github': string;
+    'message.trigger.webhook': string;
+    'message.trigger.schedule': string;
+    'message.trigger.job': string;
+    'message.trigger.plugin': string;
+    'message.trigger.explanation': string;
+    'message.stopped': string;
+    'message.branch': string;
+    'message.branchUnavailable': string;
+    'message.edit': string;
+    'message.retry.active': string;
+    'message.retry.cancelled': string;
+    'message.retry.started': string;
+    'message.retry.scheduled': string;
+    'message.retry.status': string;
+    'message.retry.delay': string;
+    'message.retry.failure': string;
+    'message.failure.auth': string;
+    'message.turnError': string;
+    'message.maxTokens': string;
+    'message.maxTokens.hint': string;
+    'message.tokensPerSecond': string;
+    'message.turnUsage.title': string;
+    'message.turnUsage.consumed': string;
+    'message.turnUsage.model': string;
+    'message.turnUsage.cacheHit': string;
+    'message.turnUsage.input': string;
+    'message.turnUsage.cacheRead': string;
+    'message.turnUsage.cacheWrite': string;
+    'message.turnUsage.output': string;
+    'message.turnUsage.reasoning': string;
+    'message.turnUsage.count': string;
+    'duration.secondUnit': string;
+    'duration.minuteUnit': string;
+    'duration.hourUnit': string;
+    'command.running': string;
+    'command.failed': string;
+    'command.done': string;
+    'command.title': string;
+    'row.running': string;
+    'row.failed': string;
+    'json.truncated': string;
+    'clock.md': string;
+    'clock.ymd': string;
+};
+//# sourceMappingURL=locale.d.ts.map

package/lib/types/client/markdown-labels.d.ts

@@ -0,0 +1,10 @@
+/** Localized copy adapters for Cordis-free Markdown primitives. */
+import type { MarkdownLabels } from '@qilin-agent/client-ui-primitives';
+import type { ChatViewSlotProps } from './contract/slots.ts';
+/**
+ * Build the complete Markdown chrome copy for one locale revision.
+ * @param t - Chat locale seat.
+ * @returns Labels for code fences and footnotes.
+ */
+export declare function markdownLabels(t: ChatViewSlotProps['t']): MarkdownLabels;
+//# sourceMappingURL=markdown-labels.d.ts.map

package/lib/types/client/model/conversation-context.d.ts

@@ -0,0 +1,21 @@
+import type { ConversationNode, ConversationPromptSnapshot } from '@qilin-agent/client-ui-conversation/client';
+/** Operation that started a new append-only model context. */
+export type ConversationContextOriginKind = 'compaction' | 'rewind' | 'rewrite';
+/** One immutable model-context generation reconstructed from surface replacements. */
+export interface ConversationContext {
+    /** Zero-based generation within the session; stable across later appends. */
+    id: number;
+    /** Previous generation in this session; absent for the initial context. */
+    parentId?: number;
+    /** Why this generation exists; absent for the initial context. */
+    origin?: ConversationContextOriginKind;
+    /** Event seq of the replacement that created this generation. */
+    originSeq?: number;
+    /** Unix epoch ms of the replacement that created this generation. */
+    createdAt?: number;
+    /** Latest request header observed in this generation, inherited until a later header replaces it. */
+    prompt?: ConversationPromptSnapshot;
+    /** Final frozen nodes for historical generations, or current folded nodes for the tail. */
+    nodes: readonly ConversationNode[];
+}
+//# sourceMappingURL=conversation-context.d.ts.map

package/lib/types/client/model/tool-call-tree.d.ts

@@ -0,0 +1,45 @@
+import type { SessionEvent } from '@qilin-agent/session/types';
+import type { ConversationNode, RunningToolCall } from '@qilin-agent/client-ui-conversation/client';
+/** Fixed wire-safety ceiling for every recursive Tool call consumer. */
+export declare const MAX_TOOL_CALL_TREE_DEPTH = 256;
+/**
+ * Owns PTC dispatch pairing and projects its private parent index into the
+ * recursive Tool call contract exposed by conversation snapshots.
+ */
+export declare class ToolCallTree {
+    private readonly childrenByParent;
+    private readonly depthByCall;
+    private readonly projectedByCall;
+    private revision;
+    private nodesCache;
+    private runningCache;
+    /** Forget all event-derived child calls before replaying a new window. */
+    reset(): void;
+    /**
+     * Fold one event when it belongs to the PTC dispatch lifecycle.
+     * @param event - Session event from the current live or history window.
+     * @returns Whether the event was consumed as a child-call lifecycle event.
+     */
+    apply(event: SessionEvent): boolean;
+    /**
+     * Attach recursively projected children to all settled roots in a node list.
+     * @param nodes - Cache-stable base conversation nodes.
+     * @returns The original list when no root changed, otherwise a structurally shared list.
+     */
+    projectNodes(nodes: readonly ConversationNode[]): readonly ConversationNode[];
+    /**
+     * Attach recursively projected children to all running root calls.
+     * @param calls - Cache-stable base running calls.
+     * @returns The original list when no root changed, otherwise a structurally shared list.
+     */
+    projectRunningCalls(calls: readonly RunningToolCall[]): readonly RunningToolCall[];
+    private projectBlock;
+    /**
+     * Accept an edge only when every recursive consumer can traverse it safely.
+     * Host-minted ids exclude cycles and current bindings emit one level; a
+     * malformed wire/history edge is consumed without hiding the rest of the session.
+     */
+    private acceptEdge;
+    private wouldCreateCycle;
+}
+//# sourceMappingURL=tool-call-tree.d.ts.map

package/lib/types/client/performance-usage.d.ts

@@ -0,0 +1,20 @@
+/** Performance detail preference with process-local choices on memory-only settings scopes. */
+import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import { type ChatSettings, type PerformanceUsageMode } from '../chat-settings.ts';
+/** Shared live preference for the settings row and chat statistics. */
+export declare class PerformanceUsagePolicy {
+    private readonly host;
+    private readonly unsubscribe;
+    /** Current choice, reconciled with accepted Host settings when available. */
+    readonly mode: import("@qilin-agent/client-store").SnapshotStore<"compact" | "detailed">;
+    /** @param host - Chat settings scope, durable on loopback and memory-only elsewhere. */
+    constructor(host: ConfigForm<ChatSettings>);
+    /** Release the accepted-value subscription. */
+    dispose(): void;
+    /**
+     * Publish a choice immediately and persist it when the scope supports writes.
+     * @param mode - Statistics detail selected by the user.
+     */
+    setMode(mode: PerformanceUsageMode): void;
+}
+//# sourceMappingURL=performance-usage.d.ts.map

package/lib/types/client/presentation-policy.d.ts

@@ -0,0 +1,37 @@
+/** Chat presentation derived from Host-backed detail and in-memory collapse timing. */
+import type { ObservableSnapshot } from '@qilin-agent/client-store';
+import type { TranscriptViewMode } from '../chat-settings.ts';
+/** Available points when a completed Turn returns to its historical presentation. */
+export declare const COLLAPSE_TIMINGS: readonly ["completion", "next-input"];
+/** When a completed Turn returns to its historical presentation. */
+export type CollapseTiming = typeof COLLAPSE_TIMINGS[number];
+/** Presentation capabilities that one work-details mode enables. */
+export interface ChatPresentationPolicy {
+    /** Preference identity for layout resets and diagnostics; renderers select the capabilities below. */
+    readonly mode: TranscriptViewMode;
+    /** Browser-local experiment; completion retains the default immediate folding and scrolling. */
+    readonly collapseTiming: CollapseTiming;
+    /** Whether a normally completed Turn folds its process rows behind the whole-Turn control. */
+    readonly foldCompletedTurns: boolean;
+    /** Collapsible group headers for all Turns, historical Turns only, or no Turns. */
+    readonly stepGrouping: 'collapsed' | 'history' | 'none';
+    /** Show the running command, path, query, or reasoning detail in group titles. */
+    readonly liveProcessDetail: boolean;
+    /** Whether a settled reasoning row previews its first line beside the Think title. */
+    readonly settledReasoningPreview: boolean;
+}
+/**
+ * Resolve a stable policy for one detail mode and collapse timing.
+ * @param mode - persisted work-details mode.
+ * @param collapseTiming - in-memory timing; defaults to immediate completion folding.
+ * @returns the same policy object for the same pair of choices.
+ */
+export declare function presentationPolicyFor(mode: TranscriptViewMode, collapseTiming?: CollapseTiming): ChatPresentationPolicy;
+/**
+ * Combine Host-backed detail and in-memory timing without owning subscriptions.
+ * @param mode - live work-details mode.
+ * @param collapseTiming - live, in-memory collapse timing.
+ * @returns observable policy whose subscriptions follow both preferences.
+ */
+export declare function derivePresentationPolicy(mode: ObservableSnapshot<TranscriptViewMode>, collapseTiming: ObservableSnapshot<CollapseTiming>): ObservableSnapshot<ChatPresentationPolicy>;
+//# sourceMappingURL=presentation-policy.d.ts.map

package/lib/types/client/settings/LinkOpeningRow.d.ts

@@ -0,0 +1,24 @@
+/** General Settings row for Chat HTTP(S) link destinations. */
+import type { ObservableSnapshot } from '@qilin-agent/client-store';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { LinkOpening } from '../../chat-settings.ts';
+/** Registration-side link-opening preference. */
+export interface LinkOpeningRowInjected {
+    hooks: {
+        /** Current destination, bound as useLinkOpening. */
+        linkOpening: ObservableSnapshot<LinkOpening>;
+        /** Whether the built-in browser is registered, bound as useBrowserAvailable. */
+        browserAvailable: ObservableSnapshot<boolean>;
+    };
+    /** Change the default destination for Chat HTTP(S) links. */
+    setLinkOpening: (destination: LinkOpening) => void;
+}
+/** Full Settings-row props. */
+export type LinkOpeningRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'chat'> & InjectFace<LinkOpeningRowInjected>;
+/**
+ * Render the link-opening destination selector.
+ * @param props - Composed Settings slot props.
+ * @returns The preference row.
+ */
+export declare function LinkOpeningRow({ useLinkOpening, useBrowserAvailable, setLinkOpening, t }: LinkOpeningRowProps): import("react").JSX.Element | null;
+//# sourceMappingURL=LinkOpeningRow.d.ts.map

package/lib/types/client/settings/PerformanceUsageRow.d.ts

@@ -0,0 +1,22 @@
+/** General Settings row for performance and usage detail. */
+import type { ObservableSnapshot } from '@qilin-agent/client-store';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import type { PerformanceUsageMode } from '../../chat-settings.ts';
+/** Registration-side performance and usage preference face. */
+export interface PerformanceUsageRowInjected {
+    hooks: {
+        /** Accepted performance and usage detail preference, bound as usePerformanceUsage. */
+        performanceUsage: ObservableSnapshot<PerformanceUsageMode>;
+    };
+    /** Change the performance and usage detail. */
+    setPerformanceUsage: (mode: PerformanceUsageMode) => void;
+}
+/** Full Settings-row props. */
+export type PerformanceUsageRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'chat'> & InjectFace<PerformanceUsageRowInjected>;
+/**
+ * Render the performance and usage detail selector.
+ * @param props - composed Settings slot props.
+ * @returns the preference row.
+ */
+export declare function PerformanceUsageRow({ usePerformanceUsage, setPerformanceUsage, t }: PerformanceUsageRowProps): import("react").JSX.Element;
+//# sourceMappingURL=PerformanceUsageRow.d.ts.map

package/lib/types/client/settings/PreferenceRow.d.ts

@@ -0,0 +1,18 @@
+/** Localized two-column selector shared by Chat preference rows. */
+/**
+ * Render a preference label and its menu; selection restores focus before publishing the new value.
+ * @param props - localized copy, selected value, choices, and mutation callback.
+ * @returns the settings row.
+ */
+export declare function PreferenceRow({ title, description, value, selectedLabel, options, onSelect }: {
+    title: string;
+    description: string;
+    value: string;
+    selectedLabel: string;
+    options: readonly {
+        id: string;
+        label: string;
+    }[];
+    onSelect: (value: string) => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PreferenceRow.d.ts.map

package/lib/types/client/settings/TranscriptViewRow.d.ts

@@ -0,0 +1,27 @@
+/** General Settings row for work-details presentation. */
+import type { SnapshotStore } from '@qilin-agent/client-store';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
+import { type TranscriptViewMode } from '../../chat-settings.ts';
+import type { CollapseTiming } from '../presentation-policy.ts';
+/** Registration-side work-details preference face. */
+export interface TranscriptViewRowInjected {
+    hooks: {
+        /** Persisted work-details preference bound as useTranscriptView. */
+        transcriptView: SnapshotStore<TranscriptViewMode>;
+        /** Browser-local timing bound as useCollapseTiming. */
+        collapseTiming: SnapshotStore<CollapseTiming>;
+    };
+    /** Change the work-details presentation. */
+    setTranscriptView: (mode: TranscriptViewMode) => void;
+    /** Save collapse timing in this browser without changing Host settings. */
+    setCollapseTiming: (timing: CollapseTiming) => void;
+}
+/** Full Settings-row props. */
+export type TranscriptViewRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'chat'> & InjectFace<TranscriptViewRowInjected>;
+/**
+ * Render work-details and browser-local collapse-timing selectors.
+ * @param props - composed Settings slot props.
+ * @returns the preference row.
+ */
+export declare function TranscriptViewRow({ useTranscriptView, setTranscriptView, useCollapseTiming, setCollapseTiming, t, }: TranscriptViewRowProps): import("react").JSX.Element;
+//# sourceMappingURL=TranscriptViewRow.d.ts.map

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

@@ -0,0 +1,30 @@
+/** Per-Session Chat view store. */
+import { type EngineStoreHandle } from '@qilin-agent/client-store';
+import type { ChatStoreState, TurnProcessViewEntry } from './contract/store.ts';
+import type { TurnProcessSpec } from './contract/turn-process.ts';
+type ChatActions = {
+    setTurnProcessOpen: (draft: ChatStoreState, turn: number, answerStep: number, open: boolean) => void;
+};
+/**
+ * Resolve the manual disclosure choice for one Turn.
+ * @param state - Chat store snapshot.
+ * @param turn - owning Turn.
+ * @returns the Turn's stored entry, when present.
+ */
+export declare function storedTurnProcessEntry(state: Readonly<ChatStoreState>, turn: number): Readonly<TurnProcessViewEntry> | undefined;
+/**
+ * Whether a foldable Turn's process is open: the reader's choice for the current answer generation
+ * wins; otherwise the latest completed Turn stays open until the next input, and older Turns fold.
+ * @param state - Chat store snapshot.
+ * @param spec - the Turn's process specification.
+ * @param defaultOpen - whether this Turn is exempt from automatic folding.
+ * @returns the effective open state.
+ */
+export declare function turnProcessOpen(state: Readonly<ChatStoreState>, spec: Pick<TurnProcessSpec, 'turn' | 'answerStep'>, defaultOpen: boolean): boolean;
+/**
+ * Create the Chat view store handle.
+ * @returns a handle instantiated once per rendered Session scope.
+ */
+export declare function createChatStore(): EngineStoreHandle<ChatStoreState, ChatActions>;
+export {};
+//# sourceMappingURL=stores.d.ts.map