@pellux/goodvibes-tui 0.20.3 → 0.22.0

package/src/input/onboarding/onboarding-wizard-steps.ts

@@ -9,10 +9,10 @@ import {
   type ExternalSurfaceSpec,
 } from './onboarding-wizard-external-surfaces.ts';
 import { countSelected, modelSelectionLabel, normalizeText } from './onboarding-wizard-helpers.ts';
-import type { OnboardingWizardController } from './onboarding-wizard.ts';
+import type { OnboardingWizardControllerLike } from './onboarding-wizard-types.ts';
 import type { OnboardingWizardAcknowledgementFieldDefinition, OnboardingWizardActionFieldDefinition, OnboardingWizardChecklistFieldDefinition, OnboardingWizardExternalSurfaceStepId, OnboardingWizardFieldDefinition, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardRadioFieldDefinition, OnboardingWizardRadioOption, OnboardingWizardStepDefinition } from './onboarding-wizard-types.ts';
 
-export function buildOnboardingWizardSteps(controller: OnboardingWizardController): readonly OnboardingWizardStepDefinition[] {
+export function buildOnboardingWizardSteps(controller: OnboardingWizardControllerLike): readonly OnboardingWizardStepDefinition[] {
   if (controller.hydrationPending || controller.hydrationError !== null) return [buildLoadingStep(controller)];
 
   const capabilities = controller.getCapabilitySelectionState();
@@ -48,8 +48,8 @@ function buildApplyAndContinueAction(step: OnboardingWizardStepDefinition): Onbo
       kind: 'action',
       id: `${step.id}.apply-and-continue`,
       action: 'apply-and-continue',
-      label: 'Apply & Continue To Next Section',
-      hint: 'Save the current wizard selections in this onboarding session and move to the next section. Settings are persisted on the final Review apply.',
+      label: 'Next section',
+      hint: 'Selections are kept in this wizard session and persisted on the final Review apply.',
       defaultValue: 'Apply & next',
       spacerBeforeRows: 2,
     };
@@ -66,7 +66,7 @@ function addApplyAndContinueAction(step: OnboardingWizardStepDefinition): Onboar
     };
   }
 
-export function buildLoadingStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildLoadingStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const failed = controller.hydrationError !== null;
     return {
       id: 'loading',
@@ -98,7 +98,7 @@ export function buildLoadingStep(controller: OnboardingWizardController): Onboar
     };
   }
 
-export function buildCapabilitiesStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildCapabilitiesStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const capabilities = controller.getCapabilitySelectionState();
     const selectedCount = countSelected(capabilities);
     const fields: OnboardingWizardFieldDefinition[] = [
@@ -145,7 +145,7 @@ export function buildCapabilitiesStep(controller: OnboardingWizardController): O
     };
   }
 
-export function buildProvidersStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildProvidersStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const providerAck = controller.runtimeDerived.reopenEditAcknowledgements.providers;
     const activeSubscriptions = controller.runtimeSnapshot?.subscriptions.active ?? [];
     const pendingSubscriptions = controller.runtimeSnapshot?.subscriptions.pending ?? [];
@@ -250,11 +250,11 @@ export function buildProvidersStep(controller: OnboardingWizardController): Onbo
     };
   }
 
-export function buildProviderAccessStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildProviderAccessStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     return buildProvidersStep(controller);
   }
 
-export function buildDefaultModelStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildDefaultModelStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const routing = controller.runtimeSnapshot?.providerRouting;
     const primarySelectionField: OnboardingWizardModelPickerFieldDefinition = {
       kind: 'modelPicker',
@@ -294,7 +294,7 @@ export function buildDefaultModelStep(controller: OnboardingWizardController): O
     };
   }
 
-export function buildExternalServicesStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildExternalServicesStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const selectedCount = EXTERNAL_SURFACE_SPECS
       .filter((surface) => controller.getBooleanFieldValue(
         surface.enabledFieldId,
@@ -355,7 +355,7 @@ export function buildExternalServicesStep(controller: OnboardingWizardController
     };
   }
 
-function getSelectedExternalSurfaceSpecs(controller: OnboardingWizardController): readonly ExternalSurfaceSpec[] {
+function getSelectedExternalSurfaceSpecs(controller: OnboardingWizardControllerLike): readonly ExternalSurfaceSpec[] {
     return EXTERNAL_SURFACE_SPECS.filter((surface) => (
       controller.getBooleanFieldValue(
         surface.enabledFieldId,
@@ -378,7 +378,7 @@ const SURFACE_AUTO_START_OPTIONS: readonly OnboardingWizardRadioOption[] = [
 ];
 
 function buildExternalSurfaceStep(
-  controller: OnboardingWizardController,
+  controller: OnboardingWizardControllerLike,
   surface: ExternalSurfaceSpec,
 ): OnboardingWizardStepDefinition {
     let setupCount = 0;
@@ -461,7 +461,7 @@ function buildExternalSurfaceStep(
     };
   }
 
-export function buildAccessStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildAccessStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const step = buildAccountsStep(controller);
     return {
       ...step,
@@ -471,7 +471,7 @@ export function buildAccessStep(controller: OnboardingWizardController): Onboard
     };
   }
 
-export function buildExperienceStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildExperienceStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     return {
       id: 'experience',
       title: 'Shell experience',
@@ -512,7 +512,7 @@ export function buildExperienceStep(controller: OnboardingWizardController): Onb
     };
   }
 
-export function buildNetworkStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildNetworkStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const bindSettings = controller.runtimeSnapshot?.bindSettings;
     const browserEnabled = controller.shouldEnableBrowserSurface();
     const listenerEnabled = controller.shouldExposeHttpListenerNetworkFields();
@@ -621,6 +621,12 @@ export function buildNetworkStep(controller: OnboardingWizardController): Onboar
       }
     }
 
+    if (controlPlaneRemote || listenerEnabled || browserEnabled) { // TLS warn + CORS notice.
+      const cpOff = controlPlaneRemote && String(controller.runtimeSnapshot?.config.controlPlane?.tls?.mode ?? 'off') === 'off';
+      const hlOff = listenerEnabled && String(controller.runtimeSnapshot?.config.httpListener?.tls?.mode ?? 'off') === 'off';
+      if (cpOff || hlOff) { const a = [cpOff ? 'control plane' : '', hlOff ? 'HTTP listener' : ''].filter(Boolean).join(' and '); fields.push({ kind: 'status', id: 'network.tls-warn', label: `TLS off — ${a} transmits plaintext`, defaultValue: 'Warning', hint: `The ${a} is network-reachable but TLS is off. Traffic travels in plaintext. Enable TLS or use a terminating reverse proxy.` }); }
+      if (listenerEnabled) { fields.push({ kind: 'status', id: 'network.cors-note', label: 'CORS must be configured manually', defaultValue: 'Info', hint: 'httpListener.enforceCors and httpListener.allowedOrigins are not in ConfigKey union (SDK handoff Item 5). Edit ~/.goodvibes/tui/settings.json to set them, then restart the daemon.' }); }
+    }
     return {
       id: 'network',
       title: 'Network setup',
@@ -636,7 +642,7 @@ export function buildNetworkStep(controller: OnboardingWizardController): Onboar
     };
   }
 
-export function buildAccountsStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildAccountsStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const subscriptionsAck = controller.runtimeDerived.reopenEditAcknowledgements.subscriptions;
     const authAck = controller.runtimeDerived.reopenEditAcknowledgements.auth;
     const auth = controller.runtimeSnapshot?.auth.snapshot;
@@ -740,7 +746,7 @@ export function buildAccountsStep(controller: OnboardingWizardController): Onboa
     };
   }
 
-export function buildReviewStep(controller: OnboardingWizardController): OnboardingWizardStepDefinition {
+export function buildReviewStep(controller: OnboardingWizardControllerLike): OnboardingWizardStepDefinition {
     const feedback = controller.applyFeedback;
     const feedbackFields: OnboardingWizardFieldDefinition[] = feedback
       ? [
@@ -778,19 +784,12 @@ export function buildReviewStep(controller: OnboardingWizardController): Onboard
       ],
       fields: [
         ...feedbackFields,
-        {
-          kind: 'status',
-          id: 'review.global-marker',
-          label: 'Global onboarding check',
-          hint: 'Opening this wizard marks onboarding as shown for this user account, so new projects do not reopen it automatically.',
-          defaultValue: 'Already marked as shown',
-        },
         {
           kind: 'action',
           id: 'review.apply',
           action: 'apply',
           label: 'Apply settings and verify',
-          hint: 'Persist the wizard settings and verify the resulting runtime state. The global onboarding check was already recorded when the wizard opened.',
+          hint: 'Persist the wizard settings and verify the resulting runtime state. The global onboarding check marker is recorded when apply succeeds.',
           defaultValue: 'Ready',
         },
       ],

package/src/input/onboarding/onboarding-wizard-types.ts

@@ -1,10 +1,7 @@
-import { isIP } from 'node:net';
 import type { ModelPickerTarget } from '../model-picker.ts';
 import {
-  deriveOnboardingStepState,
   type OnboardingAcknowledgementReason,
   type OnboardingAcknowledgementTarget,
-  type OnboardingApplyOperation,
   type OnboardingApplyRequest,
   type OnboardingMode,
   type OnboardingSnapshotState,
@@ -193,3 +190,148 @@ export interface OnboardingWizardRuntimeHydration {
 }
 
 export type MutableModelSelectionMap = Map<ModelPickerTarget, OnboardingWizardModelSelection>;
+
+// ---------------------------------------------------------------------------
+// External surface types (moved here to break the surfaces ↔ extra-specs cycle)
+// ---------------------------------------------------------------------------
+
+export interface ExternalSurfaceSetupFieldSpec {
+  readonly id: string;
+  readonly configKey: ConfigKey;
+  readonly kind: 'text' | 'masked' | 'radio';
+  readonly valueType?: 'string' | 'number';
+  readonly label: string;
+  readonly hint: string;
+  readonly placeholder: string;
+  readonly options?: readonly OnboardingWizardRadioOption[];
+  readonly defaultNumber?: number;
+  readonly min?: number;
+  readonly max?: number;
+  readonly defaultValue: (snapshot: OnboardingSnapshotState | null) => string;
+}
+
+export interface ExternalSurfaceSpec {
+  readonly id: string;
+  readonly enabledFieldId: string;
+  readonly enabledConfigKey: ConfigKey;
+  readonly label: string;
+  readonly hint: string;
+  /**
+   * Existing SDK config key. In onboarding this maps to the per-surface
+   * auto-start choice, not to whether setup fields are shown.
+   */
+  readonly defaultEnabled: (snapshot: OnboardingSnapshotState | null) => boolean;
+  readonly fields: readonly ExternalSurfaceSetupFieldSpec[];
+}
+
+// ---------------------------------------------------------------------------
+// Controller interface (moved here to break the wizard ↔ satellites cycle)
+// ---------------------------------------------------------------------------
+
+/**
+ * Public interface of OnboardingWizardController. Satellite modules
+ * (apply, steps, rules, state, cloudflare, cloudflare-step) receive the
+ * controller through this interface so they do not need to import from
+ * onboarding-wizard.ts and the circular dependency is broken.
+ */
+export interface OnboardingWizardControllerLike {
+  // State fields
+  active: boolean;
+  mode: OnboardingWizardMode;
+  stepIndex: number;
+  hydrationPending: boolean;
+  hydrationError: string | null;
+  pendingModelPickerTarget: ModelPickerTarget | null;
+  pendingAction: OnboardingWizardAction | null;
+  editingFieldId: string | null;
+  editBuffer: string;
+  applyFeedback: OnboardingWizardApplyFeedback | null;
+
+  readonly scrollOffsets: number[];
+  readonly selectedFieldIndices: number[];
+  readonly dirtyStepIds: Set<OnboardingWizardStepId>;
+  readonly toggleState: Map<string, boolean>;
+  readonly touchedActionFields: Set<string>;
+  readonly radioState: Map<string, string>;
+  readonly textState: Map<string, string>;
+  readonly modelSelectionState: MutableModelSelectionMap;
+
+  readonly baselineToggleState: Map<string, boolean>;
+  readonly baselineRadioState: Map<string, string>;
+  readonly baselineTextState: Map<string, string>;
+  readonly baselineModelSelectionState: MutableModelSelectionMap;
+
+  runtimeSnapshot: OnboardingSnapshotState | null;
+  runtimeDerived: OnboardingStepDerivationState;
+
+  // Computed
+  readonly steps: readonly OnboardingWizardStepDefinition[];
+  readonly currentStep: OnboardingWizardStepDefinition;
+  readonly dirty: boolean;
+  readonly dirtyStepCount: number;
+
+  // Field value accessors
+  getFieldValue(field: OnboardingWizardFieldDefinition): boolean | string | OnboardingWizardModelSelection;
+  getFieldById(fieldId: string): OnboardingWizardFieldDefinition | null;
+  getStringFieldValue(fieldId: string, fallback: string): string;
+  getBooleanFieldValue(fieldId: string, fallback: boolean): boolean;
+  parseIntegerFieldValue(fieldId: string, fallback: number): number | null;
+  getPortFieldValue(fieldId: string, fallback: number): number;
+  getNumberFieldValue(fieldId: string, fallback: number, min?: number, max?: number): number;
+
+  // Capability / rules accessors
+  isCapabilitySelected(capabilityId: OnboardingStep1CapabilityId): boolean;
+  hasServerCapabilitiesSelected(): boolean;
+  shouldEnableBrowserSurface(): boolean;
+  hasSelectedInboundExternalSurface(): boolean;
+  isRequiredExternalSetupField(fieldId: string): boolean;
+  getSelectedSecretMedium(): 'secure' | 'plaintext';
+  shouldEnableHttpListener(): boolean;
+  shouldExposeHttpListenerNetworkFields(): boolean;
+  shouldExposeControlPlaneNetwork(): boolean;
+  requiresAuthBootstrap(): boolean;
+  hasAdminAuthUser(): boolean;
+  hasLocalAuthUser(): boolean;
+  hasBootstrapCredentialPresent(): boolean;
+  getDefaultAdminUsername(): string;
+  getSharedIpDefault(enabled: { readonly controlPlane: boolean; readonly httpListener: boolean; readonly web: boolean }): boolean;
+  getSharedIpHostDefault(enabled: { readonly controlPlane: boolean; readonly httpListener: boolean; readonly web: boolean }): string;
+
+  // Capability mutations
+  toggleCapability(capabilityId: OnboardingStep1CapabilityId): void;
+  selectAllServerCapabilities(): void;
+  selectLocalTuiOnly(): void;
+  selectAllExternalSurfaces(): void;
+  clearExternalSurfaces(): void;
+  setCapabilityValue(capabilityId: OnboardingStep1CapabilityId, selected: boolean): void;
+  getCurrentCapabilities(): readonly OnboardingStep1CapabilityItem[];
+  getCapabilitySelectionState(): readonly OnboardingStep1CapabilityItem[];
+
+  // State operations
+  recalculateDirtyState(): void;
+  reconcileStateWithCurrentDefinitions(): void;
+  reconcileStepCursor(stepIndex: number): void;
+  resetValuesFromCurrentDefinitions(): void;
+  ensureSelectionVisible(visibleFields: number): void;
+  isFieldDirty(fieldId: string): boolean;
+  isFieldDirtyByDefinition(field: OnboardingWizardFieldDefinition): boolean;
+  isFieldSatisfied(field: OnboardingWizardFieldDefinition): boolean;
+  isStepDirty(stepIndex: number): boolean;
+  hasExistingAccessState(): boolean;
+  getBlockingFieldLabels(): readonly string[];
+  getFieldValidationError(step: OnboardingWizardStepDefinition, field: OnboardingWizardFieldDefinition): string | null;
+  getToggleFieldCount(stepIndex: number): number;
+  getCompletedToggleCount(stepIndex: number): number;
+  getStepFieldCount(stepIndex: number): number;
+  getCompletedFieldCount(stepIndex: number): number;
+
+  // Additional operations used by steps/apply
+  buildApplyRequest(): OnboardingApplyRequest;
+  isEditingTextField(): boolean;
+  getTextFieldValue(fieldId: string, fallback?: string): string;
+  getFieldValueLabel(field: OnboardingWizardFieldDefinition): string;
+  getSelectedFieldIndex(): number;
+  getSelectedField(): OnboardingWizardFieldDefinition | null;
+  getFieldWindow(visibleFields: number): OnboardingWizardFieldWindow;
+}
+

package/src/input/onboarding/onboarding-wizard-validation.ts

@@ -0,0 +1,77 @@
+import { normalizeText } from './onboarding-wizard-helpers.ts';
+import type { OnboardingWizardControllerLike } from './onboarding-wizard-types.ts';
+import type { OnboardingWizardFieldDefinition, OnboardingWizardStepDefinition } from './onboarding-wizard-types.ts';
+
+export interface WizardStepValidationResult {
+  /** Human-readable error strings for each violating field. */
+  readonly errors: readonly string[];
+  /** ID of the first field that has an error, or null when all pass. */
+  readonly firstOffendingFieldId: string | null;
+}
+
+/**
+ * Validate all fields on a single wizard step, checking:
+ *  - required text / masked fields that are empty
+ *  - required acknowledgement fields that are unchecked
+ *  - any general field-level validation errors (via getFieldValidationError)
+ *
+ * Returns per-field error messages and the first offending field id so the
+ * caller can block navigation and jump focus to the first problem.
+ */
+export function getStepValidationErrors(
+  controller: OnboardingWizardControllerLike,
+  step: OnboardingWizardStepDefinition,
+): WizardStepValidationResult {
+  const errors: string[] = [];
+  let firstOffendingFieldId: string | null = null;
+
+  for (const field of step.fields) {
+    const error = getFieldError(controller, step, field);
+    if (error !== null) {
+      errors.push(error);
+      if (firstOffendingFieldId === null) firstOffendingFieldId = field.id;
+    }
+  }
+
+  return { errors, firstOffendingFieldId };
+}
+
+function getFieldError(
+  controller: OnboardingWizardControllerLike,
+  step: OnboardingWizardStepDefinition,
+  field: OnboardingWizardFieldDefinition,
+): string | null {
+  // Required acknowledgement not checked
+  if (field.kind === 'acknowledgement' && field.required) {
+    if (!controller.isFieldSatisfied(field)) {
+      return `${step.shortLabel}: ${field.label} must be acknowledged before continuing.`;
+    }
+    return null;
+  }
+
+  // Required text / masked field that is empty
+  if ((field.kind === 'text' || field.kind === 'masked') && field.required === true) {
+    const value = normalizeText(controller.getFieldValue(field) as string);
+    if (value.length === 0) {
+      return `${step.shortLabel}: ${field.label} is required.`;
+    }
+  }
+
+  // Delegate all other field-level validation (format errors, port range, etc.)
+  return controller.getFieldValidationError(step, field);
+}
+
+/**
+ * Focus the first offending field on the current step by mutating the
+ * controller's selectedFieldIndices.  The renderer will pick up the change on
+ * the next paint cycle.
+ */
+export function focusFirstOffendingField(
+  controller: OnboardingWizardControllerLike,
+  fieldId: string,
+): void {
+  const fields = controller.currentStep.fields;
+  const index = fields.findIndex((f) => f.id === fieldId);
+  if (index < 0) return;
+  controller.selectedFieldIndices[controller.stepIndex] = index;
+}

package/src/input/onboarding/onboarding-wizard.ts

@@ -34,12 +34,12 @@ import {
   toggleCapability as toggleCapabilityForController,
 } from './onboarding-wizard-rules.ts';
 import { ensureSelectionVisible as ensureSelectionVisibleForController, getBlockingFieldLabels as getBlockingFieldLabelsForController, getCapabilitySelectionState as getCapabilitySelectionStateForController, getCompletedFieldCount as getCompletedFieldCountForController, getCompletedToggleCount as getCompletedToggleCountForController, getCurrentCapabilities as getCurrentCapabilitiesForController, getFieldById as getFieldByIdForController, getFieldValidationError as getFieldValidationErrorForController, getStepFieldCount as getStepFieldCountForController, getToggleFieldCount as getToggleFieldCountForController, hasExistingAccessState as hasExistingAccessStateForController, isFieldDirty as isFieldDirtyForController, isFieldDirtyByDefinition as isFieldDirtyByDefinitionForController, isFieldSatisfied as isFieldSatisfiedForController, isStepDirty as isStepDirtyForController, recalculateDirtyState as recalculateDirtyStateForController, reconcileStateWithCurrentDefinitions as reconcileStateWithCurrentDefinitionsForController, reconcileStepCursor as reconcileStepCursorForController, resetValuesFromCurrentDefinitions as resetValuesFromCurrentDefinitionsForController } from './onboarding-wizard-state.ts';
-import type { MutableModelSelectionMap, OnboardingWizardAction, OnboardingWizardApplyFeedback, OnboardingWizardFieldDefinition, OnboardingWizardFieldWindow, OnboardingWizardMode, OnboardingWizardModelSelection, OnboardingWizardRuntimeHydration, OnboardingWizardSnapshot, OnboardingWizardStepDefinition, OnboardingWizardStepId } from './onboarding-wizard-types.ts';
+import type { OnboardingWizardControllerLike, MutableModelSelectionMap, OnboardingWizardAction, OnboardingWizardApplyFeedback, OnboardingWizardFieldDefinition, OnboardingWizardFieldWindow, OnboardingWizardMode, OnboardingWizardModelSelection, OnboardingWizardRuntimeHydration, OnboardingWizardSnapshot, OnboardingWizardStepDefinition, OnboardingWizardStepId } from './onboarding-wizard-types.ts';
 
-export type { OnboardingWizardAcknowledgementFieldDefinition, OnboardingWizardAction, OnboardingWizardActionFieldDefinition, OnboardingWizardApplyFeedback, OnboardingWizardApplyFeedbackSeverity, OnboardingWizardChecklistFieldDefinition, OnboardingWizardExternalSurfaceStepId, OnboardingWizardFieldDefinition, OnboardingWizardFieldKind, OnboardingWizardFieldWindow, OnboardingWizardMaskedFieldDefinition, OnboardingWizardMode, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardModelSelection, OnboardingWizardRadioFieldDefinition, OnboardingWizardRadioOption, OnboardingWizardRuntimeHydration, OnboardingWizardSnapshot, OnboardingWizardStatusFieldDefinition, OnboardingWizardStepDefinition, OnboardingWizardStepId, OnboardingWizardTextFieldDefinition } from './onboarding-wizard-types.ts';
+export type { OnboardingWizardControllerLike, OnboardingWizardAcknowledgementFieldDefinition, OnboardingWizardAction, OnboardingWizardActionFieldDefinition, OnboardingWizardApplyFeedback, OnboardingWizardApplyFeedbackSeverity, OnboardingWizardChecklistFieldDefinition, OnboardingWizardExternalSurfaceStepId, OnboardingWizardFieldDefinition, OnboardingWizardFieldKind, OnboardingWizardFieldWindow, OnboardingWizardMaskedFieldDefinition, OnboardingWizardMode, OnboardingWizardModelPickerFieldDefinition, OnboardingWizardModelSelection, OnboardingWizardRadioFieldDefinition, OnboardingWizardRadioOption, OnboardingWizardRuntimeHydration, OnboardingWizardSnapshot, OnboardingWizardStatusFieldDefinition, OnboardingWizardStepDefinition, OnboardingWizardStepId, OnboardingWizardTextFieldDefinition } from './onboarding-wizard-types.ts';
 export { getOnboardingWizardBodyRows, getOnboardingWizardVisibleFieldCount } from './onboarding-wizard-helpers.ts';
 
-export class OnboardingWizardController {
+export class OnboardingWizardController implements OnboardingWizardControllerLike {
   public active = false;
   public mode: OnboardingWizardMode = 'new';
   public stepIndex = 0;

package/src/input/settings-modal-behavior.ts

@@ -33,5 +33,10 @@ export function getNumericAdjustmentMeta(setting: ConfigSetting): {
   if (setting.key === 'wrfc.scoreThreshold') {
     return { step: 0.1, min: 0, max: 10, precision: 1 };
   }
+  if ((setting.key as string) === 'tts.speed') {
+    // Speed multiplier: 0.1 increments, min 0.1, no hard max (provider-defined).
+    // tts.speed is not yet a ConfigKey in the SDK schema; cast required.
+    return { step: 0.1, min: 0.1, precision: 1 };
+  }
   return { step: 1, precision: 0 };
 }