Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

3.6 KB
Raw Blame
/**
 * Cross-package parity for the swappable prompt-conditioner sentinel (#4081).
 *
 * Unlike the IC-LoRA registry next door, the OPTIONS themselves are not
 * mirrored — the server decorates each model entry with its own
 * `textEncoderOptions` (videoGen/local.js#decorateVideoModel), so the picker
 * renders whatever this build's runner can key-map and there is nothing on the
 * client to drift.
 *
 * The one duplicated value is the "no override" sentinel, and it carries real
 * weight in both directions: the client's submit builder DROPS the field when
 * it holds this value, and the server treats an absent field and this id
 * identically (`isStockTextEncoder`). If the two strings ever diverged, the
 * client would post `textEncoderId: 'stock'` to a server that reads it as a
 * substitute id and 400s VIDEO_TEXT_ENCODER_UNSUPPORTED on every H3 render.
 *
 * Lives server-side because the server module can't load under the client
 * (jsdom) runner, while the pure client mirror loads fine here.
 */

import { describe, it, expect } from 'vitest';
import {
  STOCK_TEXT_ENCODER_ID, isStockTextEncoder, videoTextEncoderOptions, videoTextEncoderRuntimes,
} from './videoTextEncoders.js';
import {
  STOCK_TEXT_ENCODER_ID as CLIENT_STOCK_TEXT_ENCODER_ID,
  normalizeTextEncoderForModel,
  textEncoderIdFromRecord,
} from '../../client/src/lib/videoGenParams.js';

describe('video text-encoder client/server parity', () => {
  it('mirrors the stock sentinel exactly', () => {
    expect(CLIENT_STOCK_TEXT_ENCODER_ID).toBe(STOCK_TEXT_ENCODER_ID);
  });

  // The client emits this value in three places (initial state, the
  // model-change reset, the record restore). Every one of them must land on
  // something the server reads as "no override".
  // Asserted per RUNTIME rather than for the one the table happened to hold
  // when this was written: every runtime's built-in entry has to normalize to
  // the same sentinel, or adding a table key silently breaks that runtime's
  // model-change reset while the H3 path keeps passing.
  it.each(videoTextEncoderRuntimes())('produces a sentinel the server accepts as no-override (%s)', (runtime) => {
    expect(isStockTextEncoder(CLIENT_STOCK_TEXT_ENCODER_ID)).toBe(true);
    expect(isStockTextEncoder(textEncoderIdFromRecord(undefined))).toBe(true);
    expect(isStockTextEncoder(textEncoderIdFromRecord(''))).toBe(true);
    expect(isStockTextEncoder(normalizeTextEncoderForModel('gone', { runtime }))).toBe(true);
  });

  // The server ships the true option list (including a lone built-in entry), so
  // the client's normalizer has to agree that a stock-only model offers no
  // substitute to select. A runtime whose substitutes are all still gated
  // (ltx25, #4320) is exactly that case, and must normalize the same way.
  it.each(videoTextEncoderRuntimes())('agrees that the built-in option is the stock sentinel (%s)', (runtime) => {
    const options = videoTextEncoderOptions({ runtime });
    const builtIn = options.filter((option) => option.builtIn);
    expect(builtIn).toHaveLength(1);
    expect(builtIn[0].id).toBe(CLIENT_STOCK_TEXT_ENCODER_ID);

    const model = { runtime, textEncoderOptions: options };
    // A substitute the model really offers survives normalization unchanged;
    // with none offered, the built-in is all there is to land on.
    const substitute = options.find((option) => !option.builtIn);
    if (substitute) {
      expect(normalizeTextEncoderForModel(substitute.id, model)).toBe(substitute.id);
    } else {
      expect(isStockTextEncoder(normalizeTextEncoderForModel(CLIENT_STOCK_TEXT_ENCODER_ID, model))).toBe(true);
    }
  });
});