Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

7.4 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0

import assert from "node:assert/strict";
import test from "node:test";

import { readSrc } from "./helpers/kit.ts";

const TAB = readSrc("features/settings/tabs/api-keys-tab.tsx");
const LAN_API = readSrc("features/settings/api/lan-access.ts");

test("the API tab leaves Remote & LAN to its own tab, the next one down", () => {
  assert.doesNotMatch(
    TAB,
    /<RemoteAccessSection|<LanAccessSection|<RemoteLanSummary/,
  );
});

test("the API tab still publishes a tunnel URL that comes up after it opens", () => {
  const hook = readSrc("features/settings/hooks/use-publish-access-urls.ts");
  assert.match(TAB, /usePublishAccessUrls\(isOwner\);/);
  assert.match(
    hook,
    /usePlatformStore\.setState\(\{ cloudflareUrl: next\.url \}\)/,
  );
  assert.match(
    hook,
    /next\.state === "starting" \|\| next\.state === "stopping"/,
  );
  assert.match(
    hook,
    /window\.setTimeout\(readRemote, remoteAccessPollDelay\(next\)\)/,
  );
  assert.match(hook, /publishLanUrls\(next\)/);
});

test("usage examples sit right under the keys, where a new key lands", () => {
  const examples = TAB.indexOf("<ApiExamplesPanel");
  assert.ok(examples > TAB.indexOf("<CreateKeyForm"));
  assert.ok(examples < TAB.indexOf("<MonitorLink hideHeading={true} />"));
  assert.ok(examples < TAB.indexOf("<KeylessApiAccessLink"));
});

test("MCP, keyless access and the monitor sit under one heading", () => {
  assert.match(
    TAB,
    /<SettingsSection title="Access & monitoring">\s*\{isOwner \? <UnslothStudioMcpRow \/> : null\}\s*\{isOwner \? <KeylessApiAccessLink \/> : null\}\s*<MonitorLink hideHeading=\{true\} \/>\s*<\/SettingsSection>/,
  );
  const keyless = readSrc("features/settings/components/keyless-api-access-link.tsx");
  assert.match(keyless, /<SettingsRow\s+label="Keyless API access"/);
  assert.doesNotMatch(keyless, /SettingsSection/);
  const monitor = readSrc("features/settings/components/monitor-link.tsx");
  assert.match(monitor, /hideHeading=\{hideHeading\}/);
});

test("one tab row holds every example, with no jump links above it; Agents opens its own settings", () => {
  const examples = readSrc("features/settings/components/usage-examples.tsx");
  const tabs = readSrc("features/settings/components/api-example-tabs.tsx");
  assert.match(TAB, /<ApiExamplesPanel/);
  for (const gone of ["<UsageExamples", "<MediaApiExamples", "<AudioApiExamples", "<DecisionApiSection"]) {
    assert.ok(!TAB.includes(gone), gone);
  }
  for (const card of [
    /<UsageExamples\s+part="chat"/,
    /<MediaApiExamples[^>]*showHeading=\{false\}/,
    /<AudioApiExamples[^>]*showHeading=\{false\}/,
    /<DecisionApiSection[^>]*showHeading=\{false\}/,
  ]) {
    assert.match(tabs, card);
  }
  assert.equal(tabs.match(/<h2/g)?.length, 1);
  assert.match(tabs, /<h2[^>]*>\s*\{t\("settings\.apiKeys\.quickstartTitle"\)\}/);
  assert.doesNotMatch(tabs, /<h3/);
  assert.match(tabs, /entry\.id === "agents"\s*\? useSettingsDialogStore\.getState\(\)\.openDialog\("agents"\)/);
  assert.match(tabs, /\.\.\.\(isOwner\s*\? \[[\s\S]*?id: "agents" as const/);
  for (const [target, tab] of [["api-keys-media-api", "media"], ["api-keys-audio-api", "audio"], ["api-keys-decision-api", "decision"]]) {
    assert.match(tabs, new RegExp(`"${target}": "${tab}"`));
  }
  for (const [file, target] of [
    ["media-api-examples.tsx", "api-keys-media-api"],
    ["audio-api-examples.tsx", "api-keys-audio-api"],
    ["decision-api-section.tsx", "api-keys-decision-api"],
  ]) {
    assert.match(readSrc(`features/settings/components/${file}`), new RegExp(`if \\(!showHeading \\|\\| scrollTarget !== "${target}"`), file);
  }
  assert.match(examples, /if \(agentsOnly \|\| part !== "all"\) return;/);
  assert.match(examples, /\{part === "chat" \? null : \(/);
  assert.ok(!TAB.includes("ApiJumpLinks"));
  assert.match(TAB, /<h2 className="settings-heading text-base font-semibold font-heading">\s*\{t\("settings\.apiKeys\.accessTokens"\)\}\s*<\/h2>\s*<AnimatePresence/);
  const monitor = readSrc("features/api-monitor/api-monitor-page.tsx");
  assert.doesNotMatch(monitor, /<ApiJumpLinks|<UsageExamples/);
  assert.match(monitor, /<ApiExampleTabNav kind=\{kind\} onChange=\{setKind\}/);
  assert.match(tabs, /font-heading text-ui-15/);
  for (const icon of ["MessageCircleIcon", "ImageIcon", "AiSpeechIcon", "TaskDone01Icon", "BotIcon"]) {
    assert.match(tabs, new RegExp(`icon: ${icon}`));
  }
  const decision = readSrc("features/settings/components/decision-api-section.tsx");
  assert.match(
    decision,
    /<h2 className="settings-heading flex items-center gap-2 text-base font-semibold font-heading">\s*<HugeiconsIcon\s+icon=\{TaskDone01Icon\}/,
  );
});

test("keyless API access is edited on Remote & LAN; the API tab links there and reads it for the examples", () => {
  const link = readSrc("features/settings/components/keyless-api-access-link.tsx");
  assert.match(link, /openDialog\("remote-lan", \{ scrollTarget: "remote-lan-keyless" \}\)/);
  const remoteLan = readSrc("features/settings/tabs/remote-lan-tab.tsx");
  assert.match(remoteLan, /scrollTarget !== "remote-lan-keyless"/);
  assert.match(remoteLan, /<div ref=\{keylessRef\}>\s*<KeylessApiAccessSection \/>/);
  assert.match(TAB, /useKeylessExampleAccess\(isOwner\)/);
  const hook = readSrc("features/settings/hooks/use-keyless-example-access.ts");
  assert.match(hook, /loadKeylessApiAccess\(\)/);
  assert.match(hook, /scope: next\.suspendedByAccounts \? "off" : next\.scope/);
  assert.doesNotMatch(TAB, /<KeylessApiAccessSection/);
});

test("the remote and LAN polls skip their request while the tab is hidden", () => {
  for (const path of [
    "features/settings/components/lan-access-section.tsx",
    "features/settings/components/remote-access-section.tsx",
  ]) {
    assert.match(
      readSrc(path),
      /if \(document\.hidden\) \{\s*schedule\([^)]*\);\s*return;\s*\}/,
      path,
    );
  }
});

test("LAN URLs publish only when they change", () => {
  assert.match(
    LAN_API,
    /next\.every\(\(url, i\) => url === current\[i\]\)[\s\S]{0,40}return;/,
  );
  assert.doesNotMatch(
    readSrc("features/settings/components/lan-access-section.tsx"),
    /setState\(\{ lanUrls/,
  );
  assert.doesNotMatch(
    readSrc("features/api-monitor/api-monitor-page.tsx"),
    /setState\(\{ lanUrls/,
  );
});

test("the API page marks one served row as the primary, found by checkpoint first", () => {
  const page = readSrc("features/api-monitor/api-monitor-page.tsx");
  assert.match(page, /active: index === activeIndex,/);
  assert.match(
    page,
    /\(model\.checkpoint \?\? model\.id\) === residentCheckpoint/,
  );
  assert.match(page, /\(model\.active && !canEditSettings\)/);
});

test("the keyless note shows beside a public address too, since LAN callers stay keyless", () => {
  const lan = readSrc("features/settings/components/lan-access-section.tsx");
  assert.doesNotMatch(
    lan,
    /keylessLanEligible &&\s*status\.publicUrls\.length === 0/,
  );
  assert.equal(lan.match(/\{keylessNote\}/g)?.length, 2);
});

test("the no-model note sits above the Basic / With tools / Advanced sampling toggle", () => {
  const examples = readSrc("features/settings/components/usage-examples.tsx");
  const note = examples.indexOf('t("settings.apiKeys.usageNoModel")');
  assert.ok(note > 0);
  assert.ok(note < examples.indexOf('label={t("settings.apiKeys.exampleRequest")}'));
});