import { describe, expect, test } from "vitest"; import type { OpenClawConfig } from "../config/config.js"; import type { SessionEntry } from "../config/sessions.js"; import { applySessionsPatchToStore } from "./sessions-patch.js"; const SUBAGENT_MODEL = "synthetic/hf:moonshotai/Kimi-K2.5"; const KIMI_SUBAGENT_KEY = "agent:kimi:subagent:child"; async function applySubagentModelPatch(cfg: OpenClawConfig) { const res = await applySessionsPatchToStore({ cfg, store: {}, storeKey: KIMI_SUBAGENT_KEY, patch: { key: KIMI_SUBAGENT_KEY, model: SUBAGENT_MODEL, }, loadGatewayModelCatalog: async () => [ { provider: "anthropic", id: "claude-sonnet-4-6", name: "sonnet" }, { provider: "synthetic", id: "hf:moonshotai/Kimi-K2.5", name: "kimi" }, ], }); expect(res.ok).toBe(true); if (!res.ok) { throw new Error(res.error.message); } return res.entry; } function makeKimiSubagentCfg(params: { agentPrimaryModel: string; agentSubagentModel?: string; defaultsSubagentModel?: string; }): OpenClawConfig { return { agents: { defaults: { model: { primary: "anthropic/claude-sonnet-4-6" }, subagents: params.defaultsSubagentModel ? { model: params.defaultsSubagentModel } : undefined, models: { "anthropic/claude-sonnet-4-6": { alias: "default" }, }, }, list: [ { id: "kimi", model: { primary: params.agentPrimaryModel }, subagents: params.agentSubagentModel ? { model: params.agentSubagentModel } : undefined, }, ], }, } as OpenClawConfig; } describe("gateway sessions patch", () => { test("persists thinkingLevel=off (does not clear)", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", thinkingLevel: "off" }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.thinkingLevel).toBe("off"); }); test("clears thinkingLevel when patch sets null", async () => { const store: Record = { "agent:main:main": { thinkingLevel: "low" } as SessionEntry, }; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", thinkingLevel: null }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.thinkingLevel).toBeUndefined(); }); test("persists reasoningLevel=off (does not clear)", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", reasoningLevel: "off" }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.reasoningLevel).toBe("off"); }); test("clears reasoningLevel when patch sets null", async () => { const store: Record = { "agent:main:main": { reasoningLevel: "stream" } as SessionEntry, }; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", reasoningLevel: null }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.reasoningLevel).toBeUndefined(); }); test("persists elevatedLevel=off (does not clear)", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", elevatedLevel: "off" }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.elevatedLevel).toBe("off"); }); test("persists elevatedLevel=on", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", elevatedLevel: "on" }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.elevatedLevel).toBe("on"); }); test("clears elevatedLevel when patch sets null", async () => { const store: Record = { "agent:main:main": { elevatedLevel: "off" } as SessionEntry, }; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", elevatedLevel: null }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.elevatedLevel).toBeUndefined(); }); test("rejects invalid elevatedLevel values", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", elevatedLevel: "maybe" }, }); expect(res.ok).toBe(false); if (res.ok) { return; } expect(res.error.message).toContain("invalid elevatedLevel"); }); test("clears auth overrides when model patch changes", async () => { const store: Record = { "agent:main:main": { sessionId: "sess", updatedAt: 1, providerOverride: "anthropic", modelOverride: "claude-opus-4-5", authProfileOverride: "anthropic:default", authProfileOverrideSource: "user", authProfileOverrideCompactionCount: 3, } as SessionEntry, }; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", model: "openai/gpt-5.2" }, loadGatewayModelCatalog: async () => [{ provider: "openai", id: "gpt-5.2", name: "gpt-5.2" }], }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.providerOverride).toBe("openai"); expect(res.entry.modelOverride).toBe("gpt-5.2"); expect(res.entry.authProfileOverride).toBeUndefined(); expect(res.entry.authProfileOverrideSource).toBeUndefined(); expect(res.entry.authProfileOverrideCompactionCount).toBeUndefined(); }); test("accepts explicit allowlisted provider/model refs from sessions.patch", async () => { const store: Record = {}; const cfg = { agents: { defaults: { model: { primary: "openai/gpt-5.2" }, models: { "anthropic/claude-sonnet-4-6": { alias: "sonnet" }, }, }, }, } as OpenClawConfig; const res = await applySessionsPatchToStore({ cfg, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", model: "anthropic/claude-sonnet-4-6" }, loadGatewayModelCatalog: async () => [ { provider: "anthropic", id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" }, { provider: "anthropic", id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" }, ], }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.providerOverride).toBe("anthropic"); expect(res.entry.modelOverride).toBe("claude-sonnet-4-6"); }); test("accepts explicit allowlisted refs absent from bundled catalog", async () => { const store: Record = {}; const cfg = { agents: { defaults: { model: { primary: "openai/gpt-5.2" }, models: { "anthropic/claude-sonnet-4-6": { alias: "sonnet" }, }, }, }, } as OpenClawConfig; const res = await applySessionsPatchToStore({ cfg, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", model: "anthropic/claude-sonnet-4-6" }, loadGatewayModelCatalog: async () => [ { provider: "anthropic", id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" }, { provider: "openai", id: "gpt-5.2", name: "GPT-5.2" }, ], }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.providerOverride).toBe("anthropic"); expect(res.entry.modelOverride).toBe("claude-sonnet-4-6"); }); test("sets spawnDepth for subagent sessions", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:subagent:child", patch: { key: "agent:main:subagent:child", spawnDepth: 2 }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.spawnDepth).toBe(2); }); test("rejects spawnDepth on non-subagent sessions", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", spawnDepth: 1 }, }); expect(res.ok).toBe(false); if (res.ok) { return; } expect(res.error.message).toContain("spawnDepth is only supported"); }); test("normalizes exec/send/group patches", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", execHost: " NODE ", execSecurity: " ALLOWLIST ", execAsk: " ON-MISS ", execNode: " worker-1 ", sendPolicy: "DENY" as unknown as "allow", groupActivation: "Always" as unknown as "mention", }, }); expect(res.ok).toBe(true); if (!res.ok) { return; } expect(res.entry.execHost).toBe("node"); expect(res.entry.execSecurity).toBe("allowlist"); expect(res.entry.execAsk).toBe("on-miss"); expect(res.entry.execNode).toBe("worker-1"); expect(res.entry.sendPolicy).toBe("deny"); expect(res.entry.groupActivation).toBe("always"); }); test("rejects invalid execHost values", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", execHost: "edge" }, }); expect(res.ok).toBe(false); if (res.ok) { return; } expect(res.error.message).toContain("invalid execHost"); }); test("rejects invalid sendPolicy values", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", sendPolicy: "ask" as unknown as "allow" }, }); expect(res.ok).toBe(false); if (res.ok) { return; } expect(res.error.message).toContain("invalid sendPolicy"); }); test("rejects invalid groupActivation values", async () => { const store: Record = {}; const res = await applySessionsPatchToStore({ cfg: {} as OpenClawConfig, store, storeKey: "agent:main:main", patch: { key: "agent:main:main", groupActivation: "never" as unknown as "mention" }, }); expect(res.ok).toBe(false); if (res.ok) { return; } expect(res.error.message).toContain("invalid groupActivation"); }); test("allows target agent own model for subagent session even when missing from global allowlist", async () => { const cfg = makeKimiSubagentCfg({ agentPrimaryModel: "synthetic/hf:moonshotai/Kimi-K2.5", }); const entry = await applySubagentModelPatch(cfg); // Selected model matches the target agent default, so no override is stored. expect(entry.providerOverride).toBeUndefined(); expect(entry.modelOverride).toBeUndefined(); }); test("allows target agent subagents.model for subagent session even when missing from global allowlist", async () => { const cfg = makeKimiSubagentCfg({ agentPrimaryModel: "anthropic/claude-sonnet-4-6", agentSubagentModel: SUBAGENT_MODEL, }); const entry = await applySubagentModelPatch(cfg); expect(entry.providerOverride).toBe("synthetic"); expect(entry.modelOverride).toBe("hf:moonshotai/Kimi-K2.5"); }); test("allows global defaults.subagents.model for subagent session even when missing from global allowlist", async () => { const cfg = makeKimiSubagentCfg({ agentPrimaryModel: "anthropic/claude-sonnet-4-6", defaultsSubagentModel: SUBAGENT_MODEL, }); const entry = await applySubagentModelPatch(cfg); expect(entry.providerOverride).toBe("synthetic"); expect(entry.modelOverride).toBe("hf:moonshotai/Kimi-K2.5"); }); });