~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.
Python academiaanthropicarxivbravedeep-researchencryptionhome-automationhomeserverlocallocal-deep-researchlocal-llmmistralollamaopenaipubmedresearchresearch-toolretrieval-augmented-generationsearxngself-hosted
/** Live ownership contracts between progress HTTP snapshots and socket frames. */
import '@js/config/urls.js';
import '@js/services/api.js';
const RESEARCH_ID = 'progress-socket-owner-3299';
function deferred() {
let resolvePromise;
const promise = new Promise(resolve => {
resolvePromise = resolve;
});
return { promise, resolve: resolvePromise };
}
let progressCallback;
beforeEach(() => {
progressCallback = null;
document.body.innerHTML = `
<div role="progressbar" aria-valuenow="0">
<div id="progress-bar"></div>
</div>
<div id="progress-percentage"></div>
<div id="status-text" class="ldr-status-indicator"></div>
<div id="current-task"></div>
<button id="cancel-research-btn"></button>
<a id="view-results-btn" style="display: none"></a>
`;
window.RESEARCH_STATUS = {
QUEUED: 'queued',
IN_PROGRESS: 'in_progress',
COMPLETED: 'completed',
FAILED: 'failed',
ERROR: 'error',
CANCELLED: 'cancelled',
};
window.ResearchStates = {
isTerminal: status => [
'completed',
'failed',
'error',
'cancelled',
].includes(status),
isCompleted: status => status === 'completed',
isFailed: status => ['failed', 'error'].includes(status),
isCancelled: status => status === 'cancelled',
isInProgress: status => status === 'in_progress',
formatStatus: status => status,
logLevel: () => 'info',
};
window.socket = {
subscribeToResearch: vi.fn((_researchId, callback) => {
progressCallback = callback;
}),
onReconnect: vi.fn(),
isUsingPolling: vi.fn(() => false),
};
});
afterEach(() => {
vi.restoreAllMocks();
vi.unstubAllGlobals();
delete window.socket;
delete window.ResearchStates;
delete window.RESEARCH_STATUS;
delete window.progressComponent;
delete window.showNotification;
document.body.replaceChildren();
});
it('keeps nonterminal ownership ordered but never suppresses HTTP completion', async () => {
vi.stubGlobal('URLBuilder', window.URLBuilder);
vi.stubGlobal('URLS', window.URLS);
vi.stubGlobal('ResearchStates', window.ResearchStates);
vi.stubGlobal('Notification', { permission: 'denied' });
vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false }));
vi.spyOn(window.URLBuilder, 'extractResearchIdFromPattern')
.mockReturnValue(RESEARCH_ID);
const olderBootstrap = deferred();
const newerBootstrap = deferred();
const statusMock = vi.spyOn(window.api, 'getResearchStatus')
.mockImplementationOnce(() => olderBootstrap.promise)
.mockImplementationOnce(() => newerBootstrap.promise);
await import('@js/components/progress.js');
document.dispatchEvent(new Event('DOMContentLoaded'));
await vi.waitFor(() => {
expect(statusMock).toHaveBeenCalledTimes(2);
expect(progressCallback).toBeTypeOf('function');
});
progressCallback({
log_entry: {
message: 'A socket log with no status snapshot',
type: 'INFO',
time: '2026-09-01T00:00:00Z',
},
});
newerBootstrap.resolve({
status: 'in_progress',
progress: 40,
current_task: 'Hydrated from HTTP',
});
await vi.waitFor(() => {
expect(document.getElementById('progress-bar').style.width).toBe('40%');
expect(document.getElementById('current-task').textContent)
.toBe('Hydrated from HTTP');
});
olderBootstrap.resolve({
status: 'in_progress',
progress: 10,
current_task: 'Older bootstrap snapshot',
});
await olderBootstrap.promise;
await Promise.resolve();
const stalePoll = deferred();
statusMock.mockImplementationOnce(() => stalePoll.promise);
const stalePollRequest = window.progressComponent.checkProgress();
await vi.waitFor(() => expect(statusMock).toHaveBeenCalledTimes(3));
progressCallback({
status: 'in_progress',
progress: 80,
current_task: 'Owned by live socket status',
});
expect(document.getElementById('progress-bar').style.width).toBe('80%');
expect(document.getElementById('current-task').textContent)
.toBe('Owned by live socket status');
stalePoll.resolve({
status: 'in_progress',
progress: 20,
current_task: 'Stale HTTP status',
});
await stalePollRequest;
expect(document.getElementById('progress-bar').style.width).toBe('80%');
expect(document.getElementById('current-task').textContent)
.toBe('Owned by live socket status');
const terminalPoll = deferred();
statusMock.mockImplementationOnce(() => terminalPoll.promise);
const terminalRequest = window.progressComponent.checkProgress();
await vi.waitFor(() => expect(statusMock).toHaveBeenCalledTimes(4));
progressCallback({
status: 'in_progress',
progress: 85,
current_task: 'Latest nonterminal socket frame',
});
expect(document.getElementById('progress-bar').style.width).toBe('85%');
terminalPoll.resolve({
status: 'completed',
progress: 100,
});
await terminalRequest;
expect(document.getElementById('progress-bar').style.width).toBe('100%');
expect(document.getElementById('view-results-btn').style.display)
.toBe('inline-block');
progressCallback({
status: 'in_progress',
progress: 25,
current_task: 'Late nonterminal socket frame',
});
expect(document.getElementById('progress-bar').style.width).toBe('100%');
});