Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import { DEFAULT_SERVER_SETTINGS, ProviderDriverKind, ProviderInstanceId } from "@akeru/contracts";
import * as Duration from "effect/Duration";
import { describe, expect, it } from "vite-plus/test";
import { resolveServerBackgroundActivitySettings } from "./backgroundActivitySettings.ts";
import { createModelSelection } from "./model.ts";
import {
applyServerSettingsPatch,
extractPersistedServerObservabilitySettings,
normalizePersistedServerSettingString,
parsePersistedServerObservabilitySettings,
} from "./serverSettings.ts";
describe("serverSettings helpers", () => {
it("normalizes optional persisted strings", () => {
expect(normalizePersistedServerSettingString(undefined)).toBeUndefined();
expect(normalizePersistedServerSettingString(" ")).toBeUndefined();
expect(normalizePersistedServerSettingString(" http://localhost:4318/v1/traces ")).toBe(
"http://localhost:4318/v1/traces",
);
});
it("extracts persisted observability settings", () => {
expect(
extractPersistedServerObservabilitySettings({
observability: {
otlpTracesUrl: " http://localhost:4318/v1/traces ",
otlpMetricsUrl: " http://localhost:4318/v1/metrics ",
},
}),
).toEqual({
otlpTracesUrl: "http://localhost:4318/v1/traces",
otlpMetricsUrl: "http://localhost:4318/v1/metrics",
});
});
it("parses lenient persisted settings JSON", () => {
expect(
parsePersistedServerObservabilitySettings(
JSON.stringify({
observability: {
otlpTracesUrl: "http://localhost:4318/v1/traces",
otlpMetricsUrl: "http://localhost:4318/v1/metrics",
},
}),
),
).toEqual({
otlpTracesUrl: "http://localhost:4318/v1/traces",
otlpMetricsUrl: "http://localhost:4318/v1/metrics",
});
});
it("falls back cleanly when persisted settings are invalid", () => {
expect(parsePersistedServerObservabilitySettings("{")).toEqual({
otlpTracesUrl: undefined,
otlpMetricsUrl: undefined,
});
});
it("replaces text generation selection when provider/model are provided", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
textGenerationModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
[
{ id: "reasoningEffort", value: "high" },
{ id: "fastMode", value: true },
],
),
};
expect(
applyServerSettingsPatch(current, {
textGenerationModelSelection: {
instanceId: ProviderInstanceId.make("codex"),
model: "gpt-5.4-mini",
},
}).textGenerationModelSelection,
).toEqual({
instanceId: "codex",
model: "gpt-5.4-mini",
});
});
it("still deep merges text generation selection when only options are provided", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
textGenerationModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
[
{ id: "reasoningEffort", value: "high" },
{ id: "fastMode", value: true },
],
),
};
expect(
applyServerSettingsPatch(current, {
textGenerationModelSelection: {
options: [{ id: "fastMode", value: false }],
},
}).textGenerationModelSelection,
).toEqual({
instanceId: "codex",
model: "gpt-5.4-mini",
options: [
{ id: "reasoningEffort", value: "high" },
{ id: "fastMode", value: false },
],
});
});
it("replaces text generation selection across providers without leaking stale options", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
textGenerationModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
[
{ id: "reasoningEffort", value: "high" },
{ id: "fastMode", value: true },
],
),
};
expect(
applyServerSettingsPatch(current, {
textGenerationModelSelection: {
instanceId: ProviderInstanceId.make("opencode"),
model: "openai/gpt-5",
},
}).textGenerationModelSelection,
).toEqual({
instanceId: "opencode",
model: "openai/gpt-5",
});
});
it("accepts array-based text generation selection patches", () => {
expect(
applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
textGenerationModelSelection: {
instanceId: ProviderInstanceId.make("opencode"),
model: "openai/gpt-5",
options: [
{ id: "variant", value: "prod" },
{ id: "agent", value: "build" },
],
},
}).textGenerationModelSelection,
).toEqual({
instanceId: "opencode",
model: "openai/gpt-5",
options: [
{ id: "variant", value: "prod" },
{ id: "agent", value: "build" },
],
});
});
it("replaces source control writer selection without retaining stale options", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
sourceControlWriterModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
[{ id: "reasoningEffort", value: "high" }],
),
};
expect(
applyServerSettingsPatch(current, {
sourceControlWriterModelSelection: {
instanceId: ProviderInstanceId.make("opencode"),
model: "openai/gpt-5",
},
}).sourceControlWriterModelSelection,
).toEqual({
instanceId: "opencode",
model: "openai/gpt-5",
});
});
it("clears source control writer selection with null", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
sourceControlWriterModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
),
};
expect(
applyServerSettingsPatch(current, {
sourceControlWriterModelSelection: null,
}).sourceControlWriterModelSelection,
).toBeNull();
});
it("replaces providerInstances maps so omitted instance fields are cleared", () => {
const codexId = ProviderInstanceId.make("codex");
const current = {
...DEFAULT_SERVER_SETTINGS,
providerInstances: {
[codexId]: {
driver: ProviderDriverKind.make("codex"),
displayName: "Codex Work",
accentColor: "#7c3aed",
enabled: true,
config: { homePath: "~/.codex" },
},
},
};
expect(
applyServerSettingsPatch(current, {
providerInstances: {
[codexId]: {
driver: ProviderDriverKind.make("codex"),
displayName: "Codex Work",
enabled: true,
config: { homePath: "~/.codex" },
},
},
}).providerInstances[codexId],
).toEqual({
driver: ProviderDriverKind.make("codex"),
displayName: "Codex Work",
enabled: true,
config: { homePath: "~/.codex" },
});
});
it("stores background activity profiles as a versioned object and syncs legacy aliases", () => {
const next = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
backgroundActivity: {
schemaVersion: 1,
profile: "battery-saver",
overrides: {},
},
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "battery-saver",
overrides: {},
});
expect(next.backgroundActivityProfile).toBe("battery-saver");
expect(Duration.toMillis(next.automaticGitFetchInterval)).toBe(0);
expect(Duration.toMillis(next.providerHealthRefreshInterval)).toBe(
Duration.toMillis(Duration.minutes(15)),
);
});
it("turns legacy interval patches into custom background activity overrides", () => {
const next = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
automaticGitFetchInterval: Duration.seconds(15),
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "custom",
baseProfile: "balanced",
overrides: {
automaticGitFetchInterval: Duration.seconds(15),
},
});
expect(resolveServerBackgroundActivitySettings(next).profile).toBe("balanced");
expect(
Duration.toMillis(resolveServerBackgroundActivitySettings(next).automaticGitFetchInterval),
).toBe(15_000);
});
it("preserves legacy background activity settings when applying an unrelated patch", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
backgroundActivityProfile: "performance" as const,
automaticGitFetchInterval: Duration.seconds(7),
providerHealthRefreshInterval: Duration.minutes(4),
};
const next = applyServerSettingsPatch(current, {
sourceControlWriterModelSelection: createModelSelection(
ProviderInstanceId.make("codex"),
"gpt-5.4-mini",
),
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "custom",
baseProfile: "performance",
overrides: {
automaticGitFetchInterval: Duration.seconds(7),
providerHealthRefreshInterval: Duration.minutes(4),
},
});
expect(next.backgroundActivityProfile).toBe("performance");
expect(Duration.toMillis(next.automaticGitFetchInterval)).toBe(7_000);
expect(Duration.toMillis(next.providerHealthRefreshInterval)).toBe(240_000);
});
it("does not reactivate dormant overrides from a concrete profile", () => {
const current = {
...DEFAULT_SERVER_SETTINGS,
backgroundActivity: {
schemaVersion: 1 as const,
profile: "battery-saver" as const,
overrides: {
providerHealthRefreshInterval: Duration.seconds(5),
},
},
};
const next = applyServerSettingsPatch(current, {
automaticGitFetchInterval: Duration.seconds(15),
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "custom",
baseProfile: "battery-saver",
overrides: {
automaticGitFetchInterval: Duration.seconds(15),
},
});
});
it("prefers structured background activity settings over legacy aliases", () => {
const next = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
backgroundActivity: {
schemaVersion: 1,
profile: "battery-saver",
overrides: {},
},
automaticGitFetchInterval: Duration.seconds(5),
providerHealthRefreshInterval: Duration.seconds(10),
backgroundActivityProfile: "performance",
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "battery-saver",
overrides: {},
});
expect(next.backgroundActivityProfile).toBe("battery-saver");
expect(Duration.toMillis(next.automaticGitFetchInterval)).toBe(0);
expect(Duration.toMillis(next.providerHealthRefreshInterval)).toBe(15 * 60_000);
});
it("reconciles custom background activity back to a preset when overrides match the preset", () => {
const custom = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
automaticGitFetchInterval: Duration.seconds(15),
});
const next = applyServerSettingsPatch(custom, {
automaticGitFetchInterval: Duration.seconds(30),
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "balanced",
overrides: {},
});
expect(next.backgroundActivityProfile).toBe("balanced");
expect(Duration.toMillis(next.automaticGitFetchInterval)).toBe(30_000);
});
it("drops custom overrides that duplicate the base profile", () => {
const next = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
backgroundActivity: {
schemaVersion: 1,
profile: "custom",
baseProfile: "balanced",
overrides: {
automaticGitFetchInterval: Duration.seconds(30),
},
},
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "balanced",
overrides: {},
});
});
it("replaces the complete background override record", () => {
const current = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
backgroundActivity: {
schemaVersion: 1,
profile: "custom",
baseProfile: "balanced",
overrides: {
automaticGitFetchInterval: Duration.seconds(15),
providerHealthRefreshInterval: Duration.minutes(3),
},
},
});
const next = applyServerSettingsPatch(current, {
backgroundActivity: {
overrides: {
automaticGitFetchInterval: Duration.seconds(10),
},
},
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "custom",
baseProfile: "balanced",
overrides: {
automaticGitFetchInterval: Duration.seconds(10),
},
});
});
it("keeps interval overrides supplied with a profile patch", () => {
const next = applyServerSettingsPatch(DEFAULT_SERVER_SETTINGS, {
backgroundActivityProfile: "performance",
automaticGitFetchInterval: Duration.seconds(0),
providerHealthRefreshInterval: Duration.minutes(4),
});
expect(next.backgroundActivity).toEqual({
schemaVersion: 1,
profile: "custom",
baseProfile: "performance",
overrides: {
automaticGitFetchInterval: Duration.seconds(0),
providerHealthRefreshInterval: Duration.minutes(4),
},
});
});
it("ignores overrides attached to a concrete background profile", () => {
const resolved = resolveServerBackgroundActivitySettings({
...DEFAULT_SERVER_SETTINGS,
backgroundActivity: {
schemaVersion: 1,
profile: "balanced",
overrides: {
pauseWhenOnBattery: true,
},
},
});
expect(resolved.pauseWhenOnBattery).toBe(false);
});
});