An agentic browser harness: an AI side panel & orb in your own logged-in Chrome, Edge, Arc, Brave or even Firefox run by the agent/subscription you already use (Claude Code, Codex, Antigravity). Free, open source, no API key. Also an MCP server.
TypeScript agentic-browseragentic-browsingagy-cliaiai-agentai-browser-extensionai-toolsbrave-extensionbrowser-agentbrowser-automationbrowser-extensionbrowser-usebrowserskillchrome-extensionclaude-codecodexfirefox-addonmcp-servernanobrowserweb-automation
import { describe, expect, it, vi } from 'vitest';
import type { DeviceNotice } from '@/lib/notices';
import { noticeDesk } from './notice-desk';
const done: DeviceNotice = { id: 'monitor:m1', kind: 'monitor', title: 'Done: build', body: 'Finished after 3:12.', tone: 'live' };
const from = { id: 'install-notice-chrome', browser: 'Google Chrome' };
function desk() {
let clock = 1_000_000;
const changed = vi.fn();
return { desk: noticeDesk({ changed, now: () => clock }), changed, advance: (ms: number) => (clock += ms) };
}
describe('the notice desk', () => {
it('takes nothing while no app may show it, so the browser shows its own card', () => {
const { desk: built, changed } = desk();
expect(built.offer(done, from)).toBe(false);
built.watch({}, false);
expect(built.offer(done, from)).toBe(false);
expect(changed).not.toHaveBeenCalled();
});
it('queues a notice for an app that may show it, says so, and hands it over once', () => {
const { desk: built, changed } = desk();
const app = {};
built.watch(app, true);
expect(built.offer(done, from)).toBe(true);
expect(changed).toHaveBeenCalledOnce();
expect(built.take(app)).toEqual([{ ...done, browser: 'Google Chrome', at: 1_000_000 }]);
expect(built.take(app)).toEqual([]);
});
it('hands notices only to a watcher that may show them, and tells only those', () => {
const { desk: built } = desk();
const silent = {};
const app = {};
built.watch(silent, false);
built.watch(app, true);
built.offer(done, from);
expect(built.showers()).toEqual([app]);
expect(built.take(silent)).toEqual([]);
expect(built.take({})).toEqual([]);
expect(built.take(app).map((notice) => notice.id)).toEqual([done.id]);
});
it('replaces a repeat of the same notice rather than stacking it', () => {
const { desk: built } = desk();
const app = {};
built.watch(app, true);
built.offer(done, from);
built.offer({ ...done, body: 'Finished after 3:13.' }, from);
expect(built.take(app).map((notice) => notice.body)).toEqual(['Finished after 3:13.']);
});
it('drops a notice nobody took within five minutes', () => {
const { desk: built, advance } = desk();
const app = {};
built.watch(app, true);
built.offer(done, from);
advance(5 * 60_000);
expect(built.take(app)).toEqual([]);
});
it('remembers which browser a notice came from after it was taken, for a click', () => {
const { desk: built } = desk();
const app = {};
built.watch(app, true);
built.offer(done, from);
built.take(app);
expect(built.routeOf(done.id)).toBe(from.id);
expect(built.routeOf('monitor:other')).toBeUndefined();
});
it('stops counting an app once it goes, or once notifications are turned off', () => {
const { desk: built } = desk();
const app = {};
built.watch(app, true);
expect(built.canShow()).toBe(true);
built.watch(app, false);
expect(built.canShow()).toBe(false);
built.watch(app, true);
built.unwatch(app);
expect(built.canShow()).toBe(false);
});
});