Pax Historia-style sim where the LLM is the world engine.
- React 19 + Vite 6 + Tailwind v4 + shadcn/ui frontend
- Express single-port backend (/api + /sse + built client + SPA fallback)
- SQLite (better-sqlite3) persistence, one row per game
- MapLibre choropleth map (OpenFreeMap dark + ISO_A3 regions)
- Defensive turn loop: strip fences, balanced-{} extract, parse, clamp 0-100,
retry-once nudge, generic 'unclear' fallback; never crashes on bad output
- 5 seed presets (wwii-1939, coldwar-1955, modern-2025, no-wwii-1940, aegis-2400)
- LLM client over native fetch w/ injectable transport (mesh-bot pattern);
LLM_STUB=1 deterministic transport for tests/e2e
- Unit (vitest, 19) + deterministic Playwright e2e
- Multi-stage node:22-slim Docker + Traefik (history.dev.kkhost.pl:4321)
Co-Authored-By: OpenCode <opencode@users.noreply.github.com>
60 lines
2.3 KiB
TypeScript
60 lines
2.3 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import { createLlmClient } from './llm';
|
|
|
|
function json(body: unknown) {
|
|
return {
|
|
ok: true,
|
|
status: 200,
|
|
json: async () => body,
|
|
text: async () => JSON.stringify(body),
|
|
} as unknown as Response;
|
|
}
|
|
|
|
describe('createLlmClient (injectable transport)', () => {
|
|
it('chat posts model+messages to {base}/chat/completions and returns content', async () => {
|
|
const calls: { url: string; init?: RequestInit }[] = [];
|
|
const transport = async (url: string, init?: RequestInit) => {
|
|
calls.push({ url, init });
|
|
return json({ choices: [{ message: { content: 'hello back' } }] });
|
|
};
|
|
const llm = createLlmClient({ transport, apiBase: 'http://x/v1/', model: 'm1' });
|
|
const out = await llm.chat([{ role: 'user', content: 'hi' }], { maxTokens: 10, temperature: 0.5 });
|
|
expect(out).toBe('hello back');
|
|
expect(calls[0].url).toBe('http://x/v1/chat/completions'); // trailing slash normalized
|
|
const body = JSON.parse(calls[0].init!.body as string);
|
|
expect(body).toEqual({
|
|
model: 'm1',
|
|
messages: [{ role: 'user', content: 'hi' }],
|
|
maxTokens: 10,
|
|
temperature: 0.5,
|
|
});
|
|
});
|
|
|
|
it('listModels returns data[].id from GET {base}/models', async () => {
|
|
const transport = async (url: string) => {
|
|
expect(url).toBe('http://x/v1/models');
|
|
return json({ data: [{ id: 'a' }, { id: 'b' }] });
|
|
};
|
|
const llm = createLlmClient({ transport, apiBase: 'http://x/v1', model: 'm' });
|
|
expect(await llm.listModels()).toEqual(['a', 'b']);
|
|
});
|
|
|
|
it('chat throws on non-2xx with the HTTP status in the message', async () => {
|
|
const transport = async () =>
|
|
({
|
|
ok: false,
|
|
status: 503,
|
|
text: async () => 'upstream down',
|
|
json: async () => ({}),
|
|
} as unknown as Response);
|
|
const llm = createLlmClient({ transport, apiBase: 'http://x/v1', model: 'm' });
|
|
await expect(llm.chat([{ role: 'user', content: 'hi' }])).rejects.toThrow(/HTTP 503/);
|
|
});
|
|
|
|
it('chat throws when the response has no content', async () => {
|
|
const transport = async () => json({ choices: [] });
|
|
const llm = createLlmClient({ transport, apiBase: 'http://x/v1', model: 'm' });
|
|
await expect(llm.chat([{ role: 'user', content: 'hi' }])).rejects.toThrow(/no choices/);
|
|
});
|
|
});
|