asyar-sdk 3.0.0 → 3.1.0

package/dist/services/BrowserServiceProxy.js

@@ -0,0 +1,119 @@
+import { BaseServiceProxy } from './BaseServiceProxy';
+export class BrowserServiceProxy extends BaseServiceProxy {
+    constructor() {
+        super(...arguments);
+        // Per-kind ref-counting state mirroring SystemEventsServiceProxy. Each kind
+        // owns its own subscriptionId so we can ref-count + unsubscribe independently.
+        this.states = new Map();
+        this.pushListenerInstalled = false;
+    }
+    listAvailableBrowsers() {
+        return this.broker.invoke('browser:listAvailableBrowsers', {}, undefined, 5000);
+    }
+    isCompanionInstalled(family) {
+        return this.broker.invoke('browser:isCompanionInstalled', { family }, undefined, 5000);
+    }
+    listBookmarks(filter) {
+        return this.broker.invoke('browser:listBookmarks', { filter: filter !== null && filter !== void 0 ? filter : {} }, undefined, 5000);
+    }
+    searchHistory(query, opts) {
+        return this.broker.invoke('browser:searchHistory', { query, opts: opts !== null && opts !== void 0 ? opts : {} }, undefined, 5000);
+    }
+    listTabs(filter) {
+        return this.broker.invoke('browser:listTabs', { filter: filter !== null && filter !== void 0 ? filter : {} }, undefined, 5000);
+    }
+    getActiveTab(browser) {
+        return this.broker.invoke('browser:getActiveTab', { browser }, undefined, 5000);
+    }
+    activateTab(tabId) {
+        return this.broker.invoke('browser:activateTab', { tabId }, undefined, 5000);
+    }
+    closeTab(tabId) {
+        return this.broker.invoke('browser:closeTab', { tabId }, undefined, 5000);
+    }
+    openUrl(url, target) {
+        return this.broker.invoke('browser:openUrl', { url, target: target !== null && target !== void 0 ? target : {} }, undefined, 5000);
+    }
+    listPairedBrowsers() {
+        return this.broker.invoke('browser:listPairedBrowsers', {}, undefined, 5000);
+    }
+    onTabsChanged(handler) {
+        return this.subscribe('tabs.changed', 'browser:subscribeTabsChanged', 'browser:unsubscribeTabsChanged', handler);
+    }
+    onPageChanged(handler) {
+        return this.subscribe('page.changed', 'browser:subscribePageChanged', 'browser:unsubscribePageChanged', handler);
+    }
+    subscribe(kind, subscribeMethod, unsubscribeMethod, handler) {
+        this.ensurePushListener();
+        let state = this.states.get(kind);
+        if (!state) {
+            const subscriptionIdPromise = this.broker.invoke(subscribeMethod, {}, undefined, 5000);
+            state = { subscriptionIdPromise, callbacks: new Set() };
+            this.states.set(kind, state);
+        }
+        const wrapped = (e) => handler(e);
+        state.callbacks.add(wrapped);
+        let disposed = false;
+        return () => {
+            if (disposed)
+                return;
+            disposed = true;
+            const s = this.states.get(kind);
+            if (!s)
+                return;
+            s.callbacks.delete(wrapped);
+            if (s.callbacks.size === 0) {
+                this.states.delete(kind);
+                s.subscriptionIdPromise
+                    .then((id) => this.broker.invoke(unsubscribeMethod, { subscriptionId: id }, undefined, 5000))
+                    .catch(() => {
+                    // Subscribe failed; nothing to unsubscribe.
+                });
+            }
+        };
+    }
+    ensurePushListener() {
+        if (this.pushListenerInstalled)
+            return;
+        this.pushListenerInstalled = true;
+        this.broker.on('asyar:event:browser-event:push', (payload) => {
+            if (!payload || typeof payload !== 'object' || !('type' in payload))
+                return;
+            const env = payload;
+            const kind = env.type === 'tabs-changed' ? 'tabs.changed' :
+                env.type === 'page-changed' ? 'page.changed' :
+                    null;
+            if (!kind)
+                return;
+            const state = this.states.get(kind);
+            if (!state)
+                return;
+            for (const cb of state.callbacks) {
+                try {
+                    cb(payload);
+                }
+                catch (_a) {
+                    // One bad callback must not block the rest on this push.
+                }
+            }
+        });
+    }
+    // — Page content methods (Plan 3)
+    getCurrentPage(browser) {
+        return this.broker.invoke('browser:getCurrentPage', { browser }, undefined, 10000);
+    }
+    queryPage(tabId, selector, attrs) {
+        return this.broker.invoke('browser:queryPage', { tabId, selector, attrs }, undefined, 10000);
+    }
+    actOnPage(tabId, action) {
+        return this.broker.invoke('browser:actOnPage', { tabId, action }, undefined, 10000);
+    }
+    // — Plan A (command-bar additions) —
+    searchWeb(text, browser) {
+        return this.broker.invoke('browser:searchWeb', { text, browser }, undefined, 5000);
+    }
+    getMostRecentActiveBrowser() {
+        return this.broker.invoke('browser:getMostRecentActiveBrowser', {}, undefined, 5000);
+    }
+}
+//# sourceMappingURL=BrowserServiceProxy.js.map

package/dist/services/BrowserServiceProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserServiceProxy.js","sourceRoot":"","sources":["../../src/services/BrowserServiceProxy.ts"],"names":[],"mappings":"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"}

package/dist/services/BrowserServiceProxy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BrowserServiceProxy.test.d.ts.map

package/dist/services/BrowserServiceProxy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserServiceProxy.test.d.ts","sourceRoot":"","sources":["../../src/services/BrowserServiceProxy.test.ts"],"names":[],"mappings":""}

package/dist/services/BrowserServiceProxy.test.js

@@ -0,0 +1,305 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// Mock MessageBroker BEFORE import (matches CacheServiceProxy.test.ts pattern)
+vi.mock('../ipc/MessageBroker', () => {
+    return {
+        messageBroker: {
+            invoke: vi.fn(),
+            on: vi.fn(),
+            off: vi.fn(),
+        },
+    };
+});
+import { BrowserServiceProxy } from './BrowserServiceProxy';
+import { messageBroker } from '../ipc/MessageBroker';
+describe('BrowserServiceProxy', () => {
+    let proxy;
+    let mockBroker;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockBroker = messageBroker;
+        proxy = new BrowserServiceProxy();
+    });
+    it('listAvailableBrowsers invokes browser:listAvailableBrowsers', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce([]);
+        yield proxy.listAvailableBrowsers();
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:listAvailableBrowsers', {}, undefined, 5000);
+    }));
+    it('isCompanionInstalled invokes browser:isCompanionInstalled with family', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce(false);
+        yield proxy.isCompanionInstalled('firefox');
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:isCompanionInstalled', { family: 'firefox' }, undefined, 5000);
+    }));
+    it('listBookmarks forwards filter', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce([]);
+        yield proxy.listBookmarks({ query: 'doc' });
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:listBookmarks', { filter: { query: 'doc' } }, undefined, 5000);
+    }));
+    it('searchHistory forwards query + opts', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce([]);
+        yield proxy.searchHistory('rust', { limit: 10 });
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:searchHistory', { query: 'rust', opts: { limit: 10 } }, undefined, 5000);
+    }));
+});
+describe('BrowserServiceProxy — bridge methods', () => {
+    let proxy;
+    let mockBroker;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockBroker = messageBroker;
+        proxy = new BrowserServiceProxy();
+    });
+    it('listTabs invokes browser:listTabs', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce([]);
+        yield proxy.listTabs({ query: 'react' });
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:listTabs', { filter: { query: 'react' } }, undefined, 5000);
+    }));
+    it('activateTab invokes browser:activateTab', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce(undefined);
+        yield proxy.activateTab('t1');
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:activateTab', { tabId: 't1' }, undefined, 5000);
+    }));
+    it('openUrl invokes browser:openUrl with target', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce(undefined);
+        yield proxy.openUrl('https://x', { newWindow: true });
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:openUrl', { url: 'https://x', target: { newWindow: true } }, undefined, 5000);
+    }));
+    it('getCurrentPage invokes browser:getCurrentPage with timeout 10000', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce(null);
+        yield proxy.getCurrentPage();
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:getCurrentPage', { browser: undefined }, undefined, 10000);
+    }));
+    it('queryPage invokes browser:queryPage with timeout 10000', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce([]);
+        yield proxy.queryPage('t1', 'body', ['class']);
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:queryPage', { tabId: 't1', selector: 'body', attrs: ['class'] }, undefined, 10000);
+    }));
+    it('actOnPage invokes browser:actOnPage with timeout 10000', () => __awaiter(void 0, void 0, void 0, function* () {
+        vi.mocked(mockBroker.invoke).mockResolvedValueOnce(undefined);
+        yield proxy.actOnPage('t1', { kind: 'goBack' });
+        expect(mockBroker.invoke).toHaveBeenCalledWith('browser:actOnPage', { tabId: 't1', action: { kind: 'goBack' } }, undefined, 10000);
+    }));
+});
+describe('BrowserServiceProxy.onTabsChanged — subscribe pattern', () => {
+    let proxy;
+    let invokeMock;
+    let onMock;
+    let offMock;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        invokeMock = vi.fn();
+        onMock = vi.fn();
+        offMock = vi.fn();
+        proxy = new BrowserServiceProxy();
+        proxy.broker = {
+            invoke: invokeMock,
+            on: onMock,
+            off: offMock,
+        };
+    });
+    it('first listener issues browser:subscribeTabsChanged and installs push listener once', () => {
+        invokeMock.mockResolvedValueOnce('sub-1');
+        const handler = vi.fn();
+        proxy.onTabsChanged(handler);
+        expect(invokeMock).toHaveBeenCalledWith('browser:subscribeTabsChanged', {}, undefined, 5000);
+        expect(onMock).toHaveBeenCalledWith('asyar:event:browser-event:push', expect.any(Function));
+        expect(onMock).toHaveBeenCalledTimes(1);
+        // Second listener: no new subscribe, no new push listener.
+        invokeMock.mockClear();
+        onMock.mockClear();
+        proxy.onTabsChanged(vi.fn());
+        expect(invokeMock).not.toHaveBeenCalled();
+        expect(onMock).not.toHaveBeenCalled();
+    });
+    it('disposer issues browser:unsubscribeTabsChanged only when last listener is removed', () => __awaiter(void 0, void 0, void 0, function* () {
+        let resolveSub = () => { };
+        invokeMock.mockImplementation((cmd) => {
+            if (cmd === 'browser:subscribeTabsChanged') {
+                return new Promise((res) => {
+                    resolveSub = res;
+                });
+            }
+            return Promise.resolve(undefined);
+        });
+        const dispose1 = proxy.onTabsChanged(vi.fn());
+        const dispose2 = proxy.onTabsChanged(vi.fn());
+        resolveSub('sub-1');
+        yield Promise.resolve();
+        // Disposing one of two listeners must NOT unsubscribe.
+        dispose1();
+        // Allow any microtask flush.
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const unsubCallsAfterFirstDispose = invokeMock.mock.calls.filter((c) => c[0] === 'browser:unsubscribeTabsChanged');
+        expect(unsubCallsAfterFirstDispose).toHaveLength(0);
+        dispose2();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const unsubCalls = invokeMock.mock.calls.filter((c) => c[0] === 'browser:unsubscribeTabsChanged');
+        expect(unsubCalls).toHaveLength(1);
+        expect(unsubCalls[0]).toEqual([
+            'browser:unsubscribeTabsChanged',
+            { subscriptionId: 'sub-1' },
+            undefined,
+            5000,
+        ]);
+    }));
+    it('disposer is idempotent', () => __awaiter(void 0, void 0, void 0, function* () {
+        invokeMock.mockResolvedValue('sub-1');
+        const dispose = proxy.onTabsChanged(vi.fn());
+        yield Promise.resolve();
+        dispose();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const unsubCount = invokeMock.mock.calls.filter((c) => c[0] === 'browser:unsubscribeTabsChanged').length;
+        dispose();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const unsubCountAfter = invokeMock.mock.calls.filter((c) => c[0] === 'browser:unsubscribeTabsChanged').length;
+        expect(unsubCountAfter).toBe(unsubCount); // No extra unsubscribe on second call.
+    }));
+    it('only fires callbacks for matching tabs-changed payload', () => {
+        invokeMock.mockResolvedValue('sub-1');
+        let pushHandler;
+        onMock.mockImplementation((event, h) => {
+            if (event === 'asyar:event:browser-event:push')
+                pushHandler = h;
+        });
+        const handler = vi.fn();
+        proxy.onTabsChanged(handler);
+        expect(pushHandler).toBeDefined();
+        // Wrong shape: ignored.
+        pushHandler(null);
+        pushHandler({});
+        pushHandler({ type: 'something-else', tabs: [] });
+        expect(handler).not.toHaveBeenCalled();
+        // Correct shape: fired.
+        const evt = {
+            type: 'tabs-changed',
+            browser: { family: 'chromium', variant: 'chrome' },
+            tabs: [],
+        };
+        pushHandler(evt);
+        expect(handler).toHaveBeenCalledTimes(1);
+        expect(handler).toHaveBeenCalledWith(evt);
+    });
+    it('a thrown callback does not block other callbacks on the same kind', () => {
+        invokeMock.mockResolvedValue('sub-1');
+        let pushHandler;
+        onMock.mockImplementation((event, h) => {
+            if (event === 'asyar:event:browser-event:push')
+                pushHandler = h;
+        });
+        const a = vi.fn(() => { throw new Error('bad'); });
+        const b = vi.fn();
+        proxy.onTabsChanged(a);
+        proxy.onTabsChanged(b);
+        pushHandler({
+            type: 'tabs-changed',
+            browser: { family: 'chromium', variant: 'chrome' },
+            tabs: [],
+        });
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledTimes(1);
+    });
+});
+describe('BrowserServiceProxy — command-bar additions', () => {
+    it('searchWeb invokes browser:searchWeb with text + browser', () => __awaiter(void 0, void 0, void 0, function* () {
+        const invokeMock = vi.fn(() => __awaiter(void 0, void 0, void 0, function* () { return undefined; }));
+        const proxy = new BrowserServiceProxy();
+        proxy.broker = { invoke: invokeMock, on: vi.fn(), off: vi.fn() };
+        yield proxy.searchWeb('react hooks');
+        expect(invokeMock).toHaveBeenCalledWith('browser:searchWeb', { text: 'react hooks', browser: undefined }, undefined, 5000);
+    }));
+    it('getMostRecentActiveBrowser invokes browser:getMostRecentActiveBrowser', () => __awaiter(void 0, void 0, void 0, function* () {
+        const invokeMock = vi.fn(() => __awaiter(void 0, void 0, void 0, function* () { return null; }));
+        const proxy = new BrowserServiceProxy();
+        proxy.broker = { invoke: invokeMock, on: vi.fn(), off: vi.fn() };
+        yield proxy.getMostRecentActiveBrowser();
+        expect(invokeMock).toHaveBeenCalledWith('browser:getMostRecentActiveBrowser', {}, undefined, 5000);
+    }));
+});
+describe('BrowserServiceProxy.onPageChanged — subscribe pattern', () => {
+    let proxy;
+    let invokeMock;
+    let onMock;
+    let offMock;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        invokeMock = vi.fn();
+        onMock = vi.fn();
+        offMock = vi.fn();
+        proxy = new BrowserServiceProxy();
+        proxy.broker = {
+            invoke: invokeMock,
+            on: onMock,
+            off: offMock,
+        };
+    });
+    it('first listener issues browser:subscribePageChanged with empty payload (host hard-codes eventTypes)', () => {
+        invokeMock.mockResolvedValueOnce('sub-pg');
+        proxy.onPageChanged(vi.fn());
+        expect(invokeMock).toHaveBeenCalledWith('browser:subscribePageChanged', {}, undefined, 5000);
+        expect(onMock).toHaveBeenCalledWith('asyar:event:browser-event:push', expect.any(Function));
+    });
+    it('tabs-changed payload does NOT fire page-changed callback (isolation)', () => {
+        invokeMock.mockResolvedValue('sub');
+        let pushHandler;
+        onMock.mockImplementation((event, h) => {
+            if (event === 'asyar:event:browser-event:push')
+                pushHandler = h;
+        });
+        const pageHandler = vi.fn();
+        const tabsHandler = vi.fn();
+        proxy.onPageChanged(pageHandler);
+        proxy.onTabsChanged(tabsHandler);
+        expect(pushHandler).toBeDefined();
+        pushHandler({
+            type: 'page-changed',
+            browser: { family: 'chromium', variant: 'chrome' },
+            tabId: 't1',
+            page: { url: 'x', title: 'T', readableText: 'body', meta: {} },
+        });
+        expect(pageHandler).toHaveBeenCalledTimes(1);
+        expect(tabsHandler).toHaveBeenCalledTimes(0);
+        pushHandler({
+            type: 'tabs-changed',
+            browser: { family: 'chromium', variant: 'chrome' },
+            tabs: [],
+        });
+        expect(pageHandler).toHaveBeenCalledTimes(1);
+        expect(tabsHandler).toHaveBeenCalledTimes(1);
+    });
+    it('disposer issues browser:unsubscribePageChanged when last listener leaves', () => __awaiter(void 0, void 0, void 0, function* () {
+        let resolveSub = () => { };
+        invokeMock.mockImplementation((cmd) => {
+            if (cmd === 'browser:subscribePageChanged') {
+                return new Promise((res) => { resolveSub = res; });
+            }
+            return Promise.resolve(undefined);
+        });
+        const dispose = proxy.onPageChanged(vi.fn());
+        resolveSub('sub-pg');
+        yield Promise.resolve();
+        dispose();
+        yield Promise.resolve();
+        yield Promise.resolve();
+        const unsubCalls = invokeMock.mock.calls.filter((c) => c[0] === 'browser:unsubscribePageChanged');
+        expect(unsubCalls).toHaveLength(1);
+        expect(unsubCalls[0]).toEqual([
+            'browser:unsubscribePageChanged',
+            { subscriptionId: 'sub-pg' },
+            undefined,
+            5000,
+        ]);
+    }));
+});
+//# sourceMappingURL=BrowserServiceProxy.test.js.map

package/dist/services/BrowserServiceProxy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserServiceProxy.test.js","sourceRoot":"","sources":["../../src/services/BrowserServiceProxy.test.ts"],"names":[],"mappings":"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"}

package/dist/services/IBrowserService.d.ts

@@ -0,0 +1,140 @@
+export type BrowserFamily = 'chromium' | 'firefox' | 'safari';
+export interface BrowserId {
+    family: BrowserFamily;
+    variant: string;
+    profileId: string;
+}
+export interface Bookmark {
+    id: string;
+    browser: BrowserId;
+    title: string;
+    url: string;
+    folderPath: string[];
+    addedAt: number;
+}
+export interface HistoryEntry {
+    url: string;
+    title: string;
+    browser: BrowserId;
+    lastVisitAt: number;
+    visitCount: number;
+}
+export interface ListBookmarksFilter {
+    browser?: BrowserId;
+    query?: string;
+}
+export interface SearchHistoryOptions {
+    limit?: number;
+    sinceMs?: number;
+}
+export interface Tab {
+    id: string;
+    browser: BrowserId;
+    windowId: string;
+    index: number;
+    title: string;
+    url: string;
+    faviconUrl?: string;
+    isActive: boolean;
+    isPinned: boolean;
+    isAudible: boolean;
+    groupName?: string;
+}
+export interface OpenUrlTarget {
+    browser?: BrowserId;
+    newWindow?: boolean;
+}
+export interface BrowserKey {
+    family: BrowserFamily;
+    variant: string;
+}
+export interface TabsChangedEvent {
+    type: 'tabs-changed';
+    browser: BrowserKey;
+    tabs: Tab[];
+}
+export interface PageMeta {
+    description?: string;
+    ogImage?: string | null;
+    lang?: string;
+}
+export interface PageSnapshot {
+    url: string;
+    title: string;
+    readableText: string;
+    html?: string;
+    selection?: string;
+    meta: PageMeta;
+}
+export interface PageMatch {
+    tag: string;
+    attrs: Record<string, string>;
+    textContent: string;
+}
+export type PageAction = {
+    kind: 'reload';
+} | {
+    kind: 'goBack';
+} | {
+    kind: 'goForward';
+} | {
+    kind: 'scrollToTop';
+};
+export interface PageChangedEvent {
+    type: 'page-changed';
+    browser: BrowserKey;
+    tabId: string;
+    page: PageSnapshot;
+}
+export interface IBrowserService {
+    /** Browsers detected on disk (have a readable data directory). No permission required. */
+    listAvailableBrowsers(): Promise<BrowserId[]>;
+    /** Returns true when the companion extension is currently paired for the given family. */
+    isCompanionInstalled(family: BrowserFamily): Promise<boolean>;
+    /** Reads bookmarks from on-disk files. Requires `browser:bookmarks.read`. */
+    listBookmarks(filter?: ListBookmarksFilter): Promise<Bookmark[]>;
+    /** Reads visit history from on-disk SQLite. Requires `browser:history.read`. */
+    searchHistory(query: string, opts?: SearchHistoryOptions): Promise<HistoryEntry[]>;
+    /** Lists open tabs from paired browsers. Requires `browser:tabs.read`. */
+    listTabs(filter?: {
+        browser?: BrowserId;
+        query?: string;
+    }): Promise<Tab[]>;
+    /** Returns the active tab for the given browser (or the frontmost paired browser). */
+    getActiveTab(browser?: BrowserId): Promise<Tab | null>;
+    /** Focuses the given tab. Requires `browser:tabs.control`. */
+    activateTab(tabId: string): Promise<void>;
+    /** Closes the given tab. Requires `browser:tabs.control`. */
+    closeTab(tabId: string): Promise<void>;
+    /** Opens the URL in the requested target. Requires `browser:openUrl`. */
+    openUrl(url: string, target?: OpenUrlTarget): Promise<void>;
+    /** Lists browser families/variants currently paired with the companion bridge. */
+    listPairedBrowsers(): Promise<BrowserKey[]>;
+    /**
+     * Subscribe to live tab changes. Requires `browser:tabs.read` (gated at the
+     * `browser:subscribeTabsChanged` RPC in the launcher).
+     *
+     * Returns a synchronous disposer — invoke it to unsubscribe. Listeners are
+     * ref-counted: the first listener issues one `browser:subscribeTabsChanged`
+     * RPC; subsequent listeners reuse that subscription. The last disposer
+     * triggers one `browser:unsubscribeTabsChanged` RPC. The disposer is
+     * idempotent.
+     */
+    onTabsChanged(handler: (e: TabsChangedEvent) => void): () => void;
+    /** Snapshot the currently active tab's page content. Requires `browser:page.read`. */
+    getCurrentPage(browser?: BrowserId): Promise<PageSnapshot | null>;
+    /** Run a CSS selector against the given tab and return matched element descriptors. Requires `browser:page.read`. */
+    queryPage(tabId: string, selector: string, attrs?: string[]): Promise<PageMatch[]>;
+    /** Perform a side-effecting action on a tab's page (reload / nav / scroll). Requires `browser:page.write`. */
+    actOnPage(tabId: string, action: PageAction): Promise<void>;
+    /**
+     * Subscribe to live page content changes. Requires `browser:page.read` (gated at the
+     * `browser:subscribePageChanged` RPC in Rust). Disposer is idempotent and ref-counted.
+     */
+    onPageChanged(handler: (e: PageChangedEvent) => void): () => void;
+    /** Open a web search using the browser's own default engine (new tab). Requires browser:tabs.write. */
+    searchWeb(text: string, browser?: BrowserId): Promise<void>;
+    /** The browser whose window was most recently focused (for "open new content here"). Requires browser:tabs.read. */
+    getMostRecentActiveBrowser(): Promise<BrowserKey | null>;
+}
+//# sourceMappingURL=IBrowserService.d.ts.map

package/dist/services/IBrowserService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBrowserService.d.ts","sourceRoot":"","sources":["../../src/services/IBrowserService.ts"],"names":[],"mappings":"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"}

package/dist/services/IBrowserService.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IBrowserService.js.map

package/dist/services/IBrowserService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBrowserService.js","sourceRoot":"","sources":["../../src/services/IBrowserService.ts"],"names":[],"mappings":""}

package/dist/types/ActionType.d.ts

@@ -35,7 +35,7 @@ export interface ExtensionAction {
     extensionId: string;
     category?: string;
     context?: ActionContext;
-    execute: () => Promise<void> | void;
+    execute: (payload?: unknown) => Promise<void> | void;
     confirm?: boolean;
     shortcut?: string;
     /** Renders in the launcher's danger color. Independent of `confirm`. */
@@ -51,7 +51,7 @@ export interface IActionService {
     }): void;
     getContext(): ActionContext;
     /** Register a handler for a manifest-declared action. Local-only — no IPC. */
-    registerActionHandler(actionId: string, handler: () => Promise<void> | void): void;
+    registerActionHandler(actionId: string, handler: (payload?: unknown) => Promise<void> | void): void;
 }
 /**
  * Standard action category names.

package/dist/types/ActionType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionType.d.ts","sourceRoot":"","sources":["../../src/types/ActionType.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACvB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,cAAc,mBAAmB;IAEjC;;OAEG;IACH,WAAW,gBAAgB;IAE3B;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,cAAc,mBAAmB;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,EAAE,CAAC;IACvD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,IAAI,aAAa,CAAC;IAC5B,8EAA8E;IAC9E,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CACpF;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA"}
+{"version":3,"file":"ActionType.d.ts","sourceRoot":"","sources":["../../src/types/ActionType.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACvB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,cAAc,mBAAmB;IAEjC;;OAEG;IACH,WAAW,gBAAgB;IAE3B;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,cAAc,mBAAmB;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,EAAE,CAAC;IACvD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,IAAI,aAAa,CAAC;IAC5B,8EAA8E;IAC9E,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CACrG;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA"}