Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
import { describe, expect, it, vi } from 'vitest';
import { LEGACY_SETTINGS_REDIRECTS } from './settingsRoutes';
import {
normalizeRestorablePwaPath,
readLastPwaPath,
resolvePwaLaunchPath,
shouldRestorePwaLaunch,
writeLastPwaPath,
} from './pwaRouteMemory';
describe('PWA route memory', () => {
it('restores canonical and dynamic app pages while dropping URL state', () => {
expect(normalizeRestorablePwaPath('/inbox')).toBe('/inbox');
expect(normalizeRestorablePwaPath('/settings/shortcuts')).toBe('/settings/shortcuts');
expect(normalizeRestorablePwaPath('/chat/session-123?from=push#latest')).toBe('/chat/session-123');
expect(normalizeRestorablePwaPath('/apps/show/page-123?from=push#latest')).toBe('/apps/show/page-123');
expect(normalizeRestorablePwaPath('/admin/settings/backends/codex')).toBe(
'/settings/backends/codex',
);
});
it.each(LEGACY_SETTINGS_REDIRECTS)('canonicalizes declared alias $from through storage and launch', ({ from, to }) => {
const canonical = new URL(to, 'https://avibe.local').pathname;
// Every currently declared destination is safe and restorable. New aliases
// must satisfy that policy rather than silently expanding a second list.
expect(normalizeRestorablePwaPath(to)).toBe(canonical);
const remembered = readLastPwaPath({ getItem: () => `${from}?obsolete=1#旧` });
expect(remembered).toBe(canonical);
expect(resolvePwaLaunchPath(true, { pathname: '/', search: '', hash: '' }, remembered)).toBe(canonical);
const setItem = vi.fn();
writeLastPwaPath(from, { setItem });
expect(setItem).toHaveBeenCalledWith('avibe.pwa.last-route.v1', canonical);
});
it.each(['/settings/memory/unknown', '/admin/settings/unknown', '/admin/unknown',
'//evil.example/settings/memory', '/\\evil.example/settings/memory',
'https://avibe.local/settings/memory', 'javascript:alert(1)'])('rejects unsafe or undeclared alias %s', (path) => {
expect(normalizeRestorablePwaPath(path)).toBeNull();
});
it('rejects setup, retired, unknown, and cross-origin paths', () => {
expect(normalizeRestorablePwaPath('/setup')).toBeNull();
expect(normalizeRestorablePwaPath('/more')).toBeNull();
expect(normalizeRestorablePwaPath('/unknown')).toBeNull();
expect(normalizeRestorablePwaPath('//example.com/inbox')).toBeNull();
expect(normalizeRestorablePwaPath('https://example.com/inbox')).toBeNull();
});
it('restores only an installed PWA launched at the manifest root', () => {
const root = { pathname: '/', search: '', hash: '' };
expect(resolvePwaLaunchPath(true, root, '/chat/session-123')).toBe('/chat/session-123');
expect(resolvePwaLaunchPath(false, root, '/chat/session-123')).toBeNull();
expect(resolvePwaLaunchPath(true, { ...root, pathname: '/inbox' }, '/chat/session-123')).toBeNull();
expect(resolvePwaLaunchPath(true, { ...root, search: '?login=1' }, '/chat/session-123')).toBeNull();
expect(resolvePwaLaunchPath(true, { ...root, hash: '#explicit' }, '/settings/memory')).toBeNull();
expect(resolvePwaLaunchPath(true, root, '/')).toBeNull();
});
it('does not hijack a later in-app navigation back to the workbench root', () => {
expect(shouldRestorePwaLaunch('/inbox', 'default', { key: 'default', pathname: '/' })).toBe(true);
expect(shouldRestorePwaLaunch('/inbox', 'default', { key: 'later', pathname: '/' })).toBe(false);
});
it('reads and writes through best-effort storage', () => {
const getItem = vi.fn(() => '/apps/files');
const setItem = vi.fn();
expect(readLastPwaPath({ getItem })).toBe('/apps/files');
writeLastPwaPath('/chat/session-456?ignored=1', { setItem });
expect(getItem).toHaveBeenCalledOnce();
expect(setItem).toHaveBeenCalledWith('avibe.pwa.last-route.v1', '/chat/session-456');
});
it('cold-launches an installed PWA back onto General through the whole chain', () => {
// One test-owned store carries the actual write -> read -> resolve path, so
// the allowlist entry is exercised where the product uses it rather than
// only where it is declared.
const store = new Map<string, string>();
const storage = {
getItem: (key: string) => store.get(key) ?? null,
setItem: (key: string, value: string) => { store.set(key, value); },
};
writeLastPwaPath('/settings/general?tab=theme#appearance', storage);
expect(store.get('avibe.pwa.last-route.v1')).toBe('/settings/general');
const remembered = readLastPwaPath(storage);
expect(remembered).toBe('/settings/general');
expect(resolvePwaLaunchPath(true, { pathname: '/', search: '', hash: '' }, remembered))
.toBe('/settings/general');
// The allowlist is still a list, not a prefix rule: an unknown sub-path is
// rejected at the write, leaving the last restorable route intact.
expect(normalizeRestorablePwaPath('/settings/general/theme')).toBeNull();
writeLastPwaPath('/settings/general/theme', storage);
expect(readLastPwaPath(storage)).toBe('/settings/general');
});
it('tolerates unavailable browser storage', () => {
expect(
readLastPwaPath({
getItem: () => {
throw new Error('blocked');
},
}),
).toBeNull();
expect(() =>
writeLastPwaPath('/inbox', {
setItem: () => {
throw new Error('blocked');
},
}),
).not.toThrow();
});
});