dsh-smooth-stream 0.6.1 → 0.7.0

package/src/client/harnessIcons.ts

@@ -0,0 +1,27 @@
+import type { ComponentType } from 'react'
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+type IconProps = { className?: string | undefined; size?: number | undefined }
+type IconExports = Record<string, ComponentType<IconProps> | undefined>
+
+// Harness renamed size-suffixed icon exports to weight-suffixed names. Resolve
+// at runtime so this plugin bundle works with both the older published
+// primitive package used for development and current Harness module tables.
+const icons = primitives as unknown as IconExports
+
+function resolveIcon(currentName: string, legacyName: string): ComponentType<IconProps> {
+  const icon = icons[currentName] ?? icons[legacyName]
+  if (icon === undefined) {
+    throw new Error(`dsh-smooth-stream: Harness icon export is missing (${currentName}, ${legacyName})`)
+  }
+  return icon
+}
+
+export const IconChevronDown = resolveIcon('IconChevronDownOutlineRegular', 'IconChevronDownOutline14')
+export const IconClose = resolveIcon('IconCloseOutlineRegular', 'IconCloseOutline16')
+export const IconCode = resolveIcon('IconCodeOutlineRegular', 'IconCodeOutline16')
+export const IconCopy = resolveIcon('IconCopyOutlineRegular', 'IconCopyOutline16')
+export const IconQuestion = resolveIcon('IconQuestionOutlineRegular', 'IconQuestionOutline14')
+export const IconRefresh = resolveIcon('IconRefreshOutlineRegular', 'IconRefreshOutline14')
+export const IconRefreshSmall = resolveIcon('IconRefreshOutlineRegular', 'IconRefreshOutline16')
+export const IconThink = resolveIcon('IconThinkOutlineRegular', 'IconThinkOutline14')

package/src/client/index.ts

@@ -13,7 +13,7 @@ import { SmoothStreamCardController } from './smooth-stream-card-controller.ts'
 import { createSmoothStreamSettingsApi } from './smooth-stream-settings-api.ts'
 import { DebugPanel } from './DebugPanel.tsx'
 import { debugRuntime } from './debugRuntime.ts'
-import { NS as SETTINGS_NS, en, zh } from './locales.ts'
+import { NS as SETTINGS_NS, CHAT_NS, en, zh, chatEn, chatZh } from './locales.ts'
 import { DEFAULT_STREAM_CONFIG, STREAM_BOOT_GLOBAL, type StreamConfig } from '../config.ts'
 import { DEFAULT_STREAM_SETTINGS, STREAM_SETTINGS_NS, type StreamSettings } from '../settings.ts'
 
@@ -37,8 +37,34 @@ const STREAM_PRESETS: readonly string[] = ['realtime', 'balanced', 'silky']
  * generic follow boundary. This is deliberately keyed by the owner that
  * provides the renderer, not by individual tool names, so new Context,
  * Command, and Tool rows are covered automatically.
+ *
+ * Host chrome and controllers are excluded on a different rule: `turn-process`
+ * (the completed-turn process summary control) and `turn-tail` (the turn usage
+ * footer) are not Agent output. The Host renders them as bare controls and
+ * flips their visibility itself, so wrapping them has three measured costs and
+ * no benefit:
+ *
+ * 1. The wrapper element defeats ChatView's `.flowItem:empty { display: none }`
+ *    rule. A `turn-process` renderer returns null whenever the Host's fold is
+ *    unavailable (e.g. `processWindowReady === false`), and that null render is
+ *    exactly what the `:empty` rule exists to erase; with a wrapper the row
+ *    stays in flow and still consumes the 16px column gap, painting an empty
+ *    band where the fold control should be.
+ * 2. The summary label (`N tool calls · M messages`) is not streamed model
+ *    text, so pushing it through the character-reveal engine is wrong by
+ *    construction.
+ * 3. The row would inherit the generic entrance animation (opacity + clip-path)
+ *    on a row the Host may mount and hide inside a single commit.
  */
-const SKIP_WRAP = new Set(['assistant-step', 'user', 'steering', 'command-input'])
+const SKIP_WRAP = new Set([
+  'assistant-step',
+  'user',
+  'steering',
+  'command-input',
+  'turn-process',
+  'turn-tail',
+  'tool-call',
+])
 
 /** React function/class or an exotic component such as memo/forwardRef/lazy. */
 function isWrappableComponent(value: unknown): value is ComponentType<FollowWrapProps> {
@@ -157,6 +183,7 @@ class SettingsCell {
       pending === this.pending
       && next.enabled === this.value.enabled
       && next.controlScroll === this.value.controlScroll
+      && next.preset === this.value.preset
       && next.motionPreference === this.value.motionPreference
       && next.thinkAutoExpand === this.value.thinkAutoExpand
       && next.logarithmicFade === this.value.logarithmicFade
@@ -173,6 +200,16 @@ class SettingsCell {
     return !this.pending && this.value.enabled
   }
 
+  /**
+   * True only once an attached settings service has produced its loaded values.
+   * Until then — and when no settings service is composed at all — `value` is
+   * still the shared client default, so callers that must not let that default
+   * shadow the install-time config have to ask before trusting it.
+   */
+  ready(): boolean {
+    return this.card?.getSnapshot().status === 'ready'
+  }
+
   readonly getSnapshot = (): StreamSettings => this.value
 
   readonly subscribe = (listener: () => void): () => void => {
@@ -201,6 +238,55 @@ export function apply(ctx: ClientContext): void {
     () => settings.getSnapshot().controlScroll,
   )
 
+  /**
+   * Layered `t` for the assistant renderer.
+   *
+   * The renderer's keys have no single owner: `conversation` owns the
+   * `image.*` family in every Harness version, `chat` (0.1.5+) owns
+   * `message.think`, and three `message.*` keys MOVED from `conversation` to
+   * `chat` between the version this package pins and the current one. Binding
+   * the slot to either namespace alone degrades a real slice of the UI to raw
+   * keys, which is the defect this replaces.
+   *
+   * The order is deliberate: `conversation` first, so the pinned Harness keeps
+   * resolving the keys it still owns there; then `chat` for what moved or is
+   * new; then this plugin's own namespace for keys no Harness version
+   * provides. A namespace that is not registered returns its key unchanged
+   * (`LocaleRuntime.bind` does not throw), so an older Harness without `chat`
+   * falls straight through.
+   *
+   * The reference is built once and held stable: the seat feeds a memoized
+   * renderer, and a fresh identity per render would defeat that memoization.
+   * Until the locale service arrives the seat's own binding stays in use.
+   */
+  let assistantT: AssistantProps['t'] | undefined
+
+  // Locale routing belongs to the renderer lifecycle, not to the optional
+  // Connection-backed settings card. Keeping this injection independent means
+  // a deployment can stream localized replies without Connection, and a
+  // transient disconnect cannot dispose the renderer's fallback dictionary.
+  ctx.inject(['locale'], (localeCtx) => {
+    localeCtx.effect(
+      () => localeCtx.locale.register(CHAT_NS, { zh: chatZh, en: chatEn }),
+      'dsh-smooth-stream: conversation fallback dictionary',
+    )
+    const conversationT = localeCtx.locale.bind('conversation')
+    const chatT = localeCtx.locale.bind('chat') as (key: string, params?: Record<string, unknown>) => string
+    const fallbackT = localeCtx.locale.bind(CHAT_NS) as (key: string, params?: Record<string, unknown>) => string
+    const merged = (key: string, params?: Record<string, unknown>): string => {
+      const primary = (conversationT as (k: string, p?: unknown) => string)(key, params)
+      if (primary !== key) return primary
+      const secondary = chatT(key, params)
+      if (secondary !== key) return secondary
+      return fallbackT(key, params)
+    }
+    const bound = merged as unknown as AssistantProps['t']
+    assistantT = bound
+    return () => {
+      if (assistantT === bound) assistantT = undefined
+    }
+  })
+
   // The card talks to the plugin-owned loopback RPC, so the core settings
   // namespace allowlist cannot make it disappear. The stream still applies
   // with defaults when the optional Settings UI or Connection is absent.
@@ -265,8 +351,18 @@ export function apply(ctx: ClientContext): void {
     )
     return createElement(TypewriterAssistantNodeView, {
       ...props,
+      // Override the seat's single-namespace binding with the layered lookup
+      // described above. Falls back to the seat's own binding only if the
+      // locale service never arrived (renderer then receives the prop it
+      // already had).
+      ...(assistantT === undefined ? {} : { t: assistantT }),
       mode: config.mode,
-      preset: config.preset,
+      // Loaded settings hold the resolved preset (user layer over the install
+      // config), so they own the prop. Without them — no settings service, a
+      // failed load, or the frames before the first read lands — the shared
+      // client default is NOT an authority on the installed preset; the boot
+      // config is.
+      preset: settings.ready() ? preferences.preset ?? config.preset : config.preset,
       revealCharsPerSec: config.revealCharsPerSec,
       scrollSpeedPxPerSec: config.scrollSpeedPxPerSec,
       maxScrollSpeedPxPerSec: config.maxScrollSpeedPxPerSec,
@@ -278,6 +374,7 @@ export function apply(ctx: ClientContext): void {
   }
   ctx.slots.inject('conversation.chat.node', () => {
     let releaseTakeover: (() => void) | undefined
+    let usedSwap = false
 
     const syncTakeover = (): void => {
       if (!settings.takeoverEnabled()) {
@@ -287,24 +384,67 @@ export function apply(ctx: ClientContext): void {
       }
       if (releaseTakeover !== undefined) return
       const unwrap = wrapAgentChatRows(ctx, useControlScroll)
-      const unshadow = ctx.slots.register({
-        name: 'conversation.chat.node',
-        key: 'assistant-step',
-        priority: -100,
-        locale: 'conversation',
-        registrant: 'dsh-smooth-stream',
-      }, configured)
+      // dsh 0.2.x renders every keyed entry of `conversation.chat.node` as
+      // its own seat, so a lower-priority registration no longer shadows the
+      // built-in assistant row — the same assistant step then renders twice
+      // (built-in + takeover), duplicating every reasoning block in the
+      // transcript. Swap the built-in entry's component in place instead,
+      // exactly like the other keyed rows below; this keeps the original
+      // children, locale, and inject seats on every kernel generation. The
+      // shadow registration survives only as a fallback for compositions
+      // that declare no built-in assistant row to swap.
+      const builtin = ctx.slots.entries('conversation.chat.node').find(
+        entry => entry.options.key === 'assistant-step'
+          // The pinned SlotOptions type predates `registrant`; every current
+          // runtime carries it (see the register spread in the slots package).
+          && (entry.options as { registrant?: string }).registrant !== 'dsh-smooth-stream'
+          && entry.component !== configured,
+      )
+      let unshadow: () => void
+      if (builtin !== undefined && isWrappableComponent(builtin.component)) {
+        usedSwap = true
+        const inner = builtin.component as ComponentType<FollowWrapProps>
+        builtin.component = configured
+        unshadow = () => {
+          if (builtin.component === configured) builtin.component = inner
+        }
+      } else {
+        unshadow = ctx.slots.register({
+          name: 'conversation.chat.node',
+          key: 'assistant-step',
+          priority: -100,
+          // `conversation` (not `chat`): it is the namespace the pinned Harness
+          // actually registers, so it is the one whose keys must keep resolving.
+          // The layered `t` handed to the renderer covers what this namespace
+          // does not own. A namespace the composition does not declare would
+          // degrade every `t()` call to its raw key.
+          locale: 'conversation',
+          registrant: 'dsh-smooth-stream',
+        }, configured)
+      }
       releaseTakeover = () => {
-        // Stop observing slot changes before the shadow entry is removed.
+        // Stop observing slot changes before the takeover is removed.
         unwrap()
         unshadow()
       }
     }
 
+    // If the shadow fallback was taken because the built-in assistant row
+    // had not registered yet, re-take through the in-place swap as soon as
+    // it appears, so 0.2.x never renders the row twice.
+    const offSlotChange = ctx.on('slots/changed', (key: string) => {
+      if (key !== 'conversation.chat.node' || usedSwap || releaseTakeover === undefined) return
+      if (!settings.takeoverEnabled()) return
+      releaseTakeover()
+      releaseTakeover = undefined
+      syncTakeover()
+    })
+
     const unsubscribe = settings.subscribe(syncTakeover)
     syncTakeover()
     return () => {
       unsubscribe()
+      offSlotChange()
       releaseTakeover?.()
     }
   })

package/src/client/locales.ts

@@ -3,11 +3,59 @@
 /** Dictionary namespace owned by this plugin's settings card. */
 export const NS = 'settings.smoothStream'
 
+/**
+ * Namespace owning the conversation keys THIS PLUGIN must be able to render
+ * but the Harness does not always provide.
+ *
+ * The plugin consumes keys from two Harness namespaces, and which one owns a
+ * given key is not stable across Harness versions:
+ *
+ * - `conversation` (`dsh-client-ui-conversation`) owns the `image.*` family in
+ *   every version, and also owned `message.stopped`, `message.unknownBlock`
+ *   and `json.truncated` before those moved to `chat`.
+ * - `chat` (`dsh-client-ui-chat`, present from 0.1.5 on) owns `message.think`
+ *   and now owns the three keys above. It does not exist at all in rc.6, the
+ *   version this package still pins in devDependencies.
+ *
+ * Neither namespace alone can serve every key this plugin renders, so
+ * `index.ts` layers them. This plugin-owned namespace is the final layer; it
+ * exists because a plugin may NOT register into `chat` or `conversation` —
+ * `LocaleRuntime.register` throws when the (namespace, locale) pair already
+ * has an owner, and the Harness owns both.
+ */
+export const CHAT_NS = 'smoothStream.chat'
+
+/**
+ * Keys the plugin resolves through {@link CHAT_NS}. Only keys with no
+ * dependable Harness owner belong here; anything the Harness already provides
+ * must keep coming from the Harness so a language pack can override it.
+ */
+export type SmoothStreamChatKey = 'message.think' | 'image.serviceUnavailable'
+
+/** English fallback for {@link SmoothStreamChatKey}. */
+export const chatEn: Record<SmoothStreamChatKey, string> = {
+  'message.think': 'Think',
+  // Removed from the Harness dictionaries in 0.1.5 (rc.6 had it under
+  // `conversation`), and the plugin interpolates it into a thrown Error, so
+  // the raw key must never reach a reader.
+  'image.serviceUnavailable': 'Image service unavailable',
+}
+
+/** Simplified Chinese fallback for {@link SmoothStreamChatKey}. */
+export const chatZh: Record<SmoothStreamChatKey, string> = {
+  'message.think': '思考',
+  'image.serviceUnavailable': '图片服务不可用',
+}
+
 /** Locale keys the card renders. */
 export type SmoothStreamLocaleKey =
   | 'title' | 'description'
   | 'enabled' | 'enabledHint'
   | 'controlScroll' | 'controlScrollHint'
+  | 'preset' | 'presetHint'
+  | 'presetRealtime' | 'presetRealtimeHint'
+  | 'presetBalanced' | 'presetBalancedHint'
+  | 'presetSilky' | 'presetSilkyHint'
   | 'motionPreference' | 'motionPreferenceHint'
   | 'motionAuto' | 'motionAutoHint'
   | 'motionForceSmooth' | 'motionForceSmoothHint'
@@ -22,6 +70,8 @@ export type SmoothStreamLocaleKey =
   | 'debugFps' | 'debugFrameTime' | 'debugBacklog' | 'debugRevealSpeed' | 'debugProgress'
   | 'debugFollowState' | 'debugFollowing' | 'debugReleased'
   | 'debugLag' | 'debugVelocity' | 'debugReserve' | 'debugCapacity' | 'debugAppliedScale'
+  | 'debugTerminalPhase' | 'debugOwnedRunway' | 'debugTerminalBudget' | 'debugBaselineShift'
+  | 'debugAnchorDelta' | 'debugPhaseLive' | 'debugPhaseDrain' | 'debugPhaseCascade' | 'debugPhaseNatural'
   | 'debugRevealMultiplier' | 'debugQueuePressure' | 'debugMaxReveal'
   | 'debugSpringStiffness' | 'debugSpringDamping' | 'debugSpringMass'
   | 'debugRunway' | 'debugReserveResponse' | 'debugBackpressureMin'
@@ -42,6 +92,14 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: 'Let this plugin render and follow streaming replies. Turn off to use the built-in Harness renderer.',
   controlScroll: 'Take over scrolling',
   controlScrollHint: 'On by default; smooth-stream writes the conversation scroll position. Turn off to leave bottom-follow to Harness.',
+  preset: 'Pacing preset',
+  presetHint: 'Smoothing cadence profile for text reveal and glide.',
+  presetRealtime: 'Realtime',
+  presetRealtimeHint: 'Aggressive cadence, low latency, tracks output closely.',
+  presetBalanced: 'Balanced',
+  presetBalancedHint: 'Default balance between pace and visual rhythm.',
+  presetSilky: 'Silky',
+  presetSilkyHint: 'Higher backlog buffer, gentle EMA damping, maximum fluidity.',
   motionPreference: 'Motion',
   motionPreferenceHint: 'How streaming responds to the system reduce-motion setting.',
   motionAuto: 'Follow system',
@@ -85,6 +143,15 @@ export const en: Record<SmoothStreamLocaleKey, string> = {
   debugReserve: 'Reserve',
   debugCapacity: 'Capacity',
   debugAppliedScale: 'Applied scale',
+  debugTerminalPhase: 'Terminal phase',
+  debugOwnedRunway: 'Owned runway',
+  debugTerminalBudget: 'Terminal budget',
+  debugBaselineShift: 'Baseline shift',
+  debugAnchorDelta: 'Anchor Δ',
+  debugPhaseLive: 'live',
+  debugPhaseDrain: 'terminal-drain',
+  debugPhaseCascade: 'host-cascade',
+  debugPhaseNatural: 'natural',
   debugRevealMultiplier: 'Reveal multiplier',
   debugQueuePressure: 'Queue pressure',
   debugMaxReveal: 'Maximum reveal',
@@ -132,6 +199,14 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   enabledHint: '由本插件渲染并跟随流式回复；关闭后使用 Harness 内置渲染。',
   controlScroll: '接管滚动',
   controlScrollHint: '默认开启，由丝滑流式写入会话滚动位置；关闭后贴底滚动交给 Harness。',
+  preset: '手感预设',
+  presetHint: '文字吐字节奏与视口跟随阻尼风格。',
+  presetRealtime: '激进快速 (realtime)',
+  presetRealtimeHint: '缓冲低、流速快，紧跟模型生成。',
+  presetBalanced: '均衡自然 (balanced)',
+  presetBalancedHint: '官方默认，平衡流速与节奏感。',
+  presetSilky: '极致丝滑 (silky)',
+  presetSilkyHint: '字符积压缓冲加大、阻尼更高、EMA 平滑度更好，视觉呼吸感最强。',
   motionPreference: '动效偏好',
   motionPreferenceHint: '流式渲染如何响应系统的「减少动态效果」设置。',
   motionAuto: '跟随系统',
@@ -175,6 +250,15 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
   debugReserve: '预留空间',
   debugCapacity: '安全容量',
   debugAppliedScale: '实际倍率',
+  debugTerminalPhase: '收尾阶段',
+  debugOwnedRunway: '实体留白',
+  debugTerminalBudget: '收尾预算',
+  debugBaselineShift: '基线位移',
+  debugAnchorDelta: '锚点位移',
+  debugPhaseLive: '流式中',
+  debugPhaseDrain: '收尾排空',
+  debugPhaseCascade: '宿主交接',
+  debugPhaseNatural: '自然态',
   debugRevealMultiplier: '揭示倍率',
   debugQueuePressure: '队列压力',
   debugMaxReveal: '最大揭示速度',
@@ -217,5 +301,6 @@ export const zh: Record<SmoothStreamLocaleKey, string> = {
 declare module '@deepseek-ai/dsh-client-ui-slots' {
   interface LocaleNamespaceMap {
     'settings.smoothStream': SmoothStreamLocaleKey
+    'smoothStream.chat': SmoothStreamChatKey
   }
 }

package/src/client/smooth-stream-card-controller.ts

@@ -7,6 +7,7 @@ import {
   type StreamDebugTuning,
   type StreamMotionPreference,
   type StreamSettings,
+  type StreamSmoothingPreset,
 } from '../settings.ts'
 import type {
   StreamDebugSettingsView,
@@ -24,6 +25,7 @@ export interface SmoothStreamCardState {
   failed: boolean
   enabled: boolean
   controlScroll: boolean
+  preset: StreamSmoothingPreset
   motionPreference: StreamMotionPreference
   thinkAutoExpand: boolean
   logarithmicFade: boolean
@@ -55,7 +57,7 @@ export class SmoothStreamCardController {
   private readonly store = createSnapshotStore<SmoothStreamCardState>(this.projection())
   private loaded: StreamSettingsView | undefined
   private loadedDebug: StreamDebugSettingsView | undefined
-  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> | undefined
+  private stagedBase: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> | undefined
   private stagedDebug: Pick<StreamSettings, 'debugEnabled' | 'debugTuning'> | undefined
   private saving = false
   private failed = false
@@ -93,11 +95,12 @@ export class SmoothStreamCardController {
       hooks: { smoothStreamCard: this.store },
       edit: (patch) => {
         if (this.saving) return
-        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.motionPreference !== undefined || patch.thinkAutoExpand !== undefined || patch.logarithmicFade !== undefined) {
+        if (patch.enabled !== undefined || patch.controlScroll !== undefined || patch.preset !== undefined || patch.motionPreference !== undefined || patch.thinkAutoExpand !== undefined || patch.logarithmicFade !== undefined) {
           this.stagedBase = {
             ...this.baseValues(),
             ...(patch.enabled === undefined ? {} : { enabled: patch.enabled }),
             ...(patch.controlScroll === undefined ? {} : { controlScroll: patch.controlScroll }),
+            ...(patch.preset === undefined ? {} : { preset: patch.preset }),
             ...(patch.motionPreference === undefined ? {} : { motionPreference: patch.motionPreference }),
             ...(patch.thinkAutoExpand === undefined ? {} : { thinkAutoExpand: patch.thinkAutoExpand }),
             ...(patch.logarithmicFade === undefined ? {} : { logarithmicFade: patch.logarithmicFade }),
@@ -145,10 +148,11 @@ export class SmoothStreamCardController {
     }
   }
 
-  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> {
+  private baseValues(): Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> {
     return this.stagedBase ?? {
       enabled: this.loaded?.enabled ?? DEFAULT_STREAM_SETTINGS.enabled,
       controlScroll: this.loaded?.controlScroll ?? DEFAULT_STREAM_SETTINGS.controlScroll,
+      preset: this.loaded?.preset ?? DEFAULT_STREAM_SETTINGS.preset,
       motionPreference: this.loaded?.motionPreference ?? DEFAULT_STREAM_SETTINGS.motionPreference,
       thinkAutoExpand: this.loaded?.thinkAutoExpand ?? DEFAULT_STREAM_SETTINGS.thinkAutoExpand,
       logarithmicFade: this.loaded?.logarithmicFade ?? DEFAULT_STREAM_SETTINGS.logarithmicFade,

package/src/client/smooth-stream-settings-api.ts

@@ -24,13 +24,14 @@ function settingsView(value: unknown): StreamSettingsView {
     || typeof data.writable !== 'boolean'
     || typeof data.enabled !== 'boolean'
     || typeof data.controlScroll !== 'boolean'
+    || (data.preset !== undefined && !['realtime', 'balanced', 'silky'].includes(data.preset as string))
     || !['auto', 'force-smooth', 'force-reduced'].includes(data.motionPreference as string)
     || typeof data.thinkAutoExpand !== 'boolean'
     || (data.logarithmicFade !== undefined && typeof data.logarithmicFade !== 'boolean')
     || typeof data.canUpgrade !== 'boolean') {
     throw new Error('dsh-smooth-stream: malformed settings response')
   }
-  return { ...data, logarithmicFade: data.logarithmicFade ?? true } as unknown as StreamSettingsView
+  return { ...data, preset: (data.preset ?? 'balanced') as StreamSettingsView['preset'], logarithmicFade: data.logarithmicFade ?? true } as unknown as StreamSettingsView
 }
 
 function upgradeView(value: unknown): StreamUpgradeView {
@@ -82,13 +83,14 @@ export function createSmoothStreamSettingsApi(connection: ConnectionHandle): Smo
     async read(): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(STREAM_SETTINGS_RPC_CHANNEL, STREAM_SETTINGS_RPC.read, {})))
     },
-    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
+    async write(settings: Pick<StreamSettings, 'enabled' | 'controlScroll' | 'preset' | 'motionPreference' | 'thinkAutoExpand' | 'logarithmicFade'> & Partial<Pick<StreamSettings, 'debugEnabled' | 'debugTuning'>>): Promise<StreamSettingsView> {
       return settingsView(accepted(await connection.rpc.call(
         STREAM_SETTINGS_RPC_CHANNEL,
         STREAM_SETTINGS_RPC.write,
         {
           enabled: settings.enabled,
           controlScroll: settings.controlScroll,
+          preset: settings.preset,
           motionPreference: settings.motionPreference,
           thinkAutoExpand: settings.thinkAutoExpand,
           logarithmicFade: settings.logarithmicFade,