@vforsh/argus 0.1.16 → 0.1.19

package/dist/commands/extension/show.js

@@ -0,0 +1,132 @@
+import { createOutput } from '../../output/io.js';
+import { fetchWatcherJson } from '../../watchers/requestWatcher.js';
+import { resolveWatcher } from '../../watchers/resolveWatcher.js';
+import { resolveExtensionWatcher } from './resolveExtensionWatcher.js';
+import { attachTab, waitForTabWatcher } from './tabAttach.js';
+import { fetchExtensionTabs, formatExtensionTabLine, hasTabSelector, isExtensionTab, parseTabSelector, resolveTab, } from './tabSelection.js';
+export const runExtensionShow = async (id, options, config = {}) => {
+    const output = createOutput(options);
+    if (id && hasTabSelector(options)) {
+        writeFailure(output, options, 'Use either watcher id or --tab/--url/--title, not both.', 2);
+        return;
+    }
+    if (id) {
+        const resolved = await resolveWatcher({ id });
+        if (!resolved.ok) {
+            writeFailure(output, options, resolved.error, resolved.exitCode);
+            return;
+        }
+        if (resolved.watcher.source !== 'extension') {
+            writeFailure(output, options, `Watcher ${resolved.watcher.id} is not extension-backed. Use argus page show ${resolved.watcher.id}.`, 2);
+            return;
+        }
+        await showWatcher(resolved.watcher, null, output, options);
+        return;
+    }
+    const selector = parseTabSelector(options, config.missingSelectorReason ?? 'Specify a watcher id, --tab <tabId>, --url <substring>, or --title <substring>.');
+    if (!selector.ok) {
+        writeFailure(output, options, selector.reason, selector.exitCode);
+        return;
+    }
+    const control = await resolveExtensionWatcher({});
+    if (!control.ok) {
+        writeFailure(output, options, control.error, control.exitCode);
+        return;
+    }
+    const tabs = await fetchExtensionTabs(control.watcher, selector.selector);
+    if (!tabs.ok) {
+        writeFailure(output, options, tabs.error, 1);
+        return;
+    }
+    const tabResult = resolveTab(tabs.tabs, selector.selector);
+    if (!tabResult.ok) {
+        writeTabFailure(output, options, tabResult);
+        return;
+    }
+    const tab = tabResult.tab;
+    if (options.as && tab.attached && tab.watcherId && tab.watcherId !== options.as) {
+        writeFailure(output, options, `Tab ${tab.tabId} is already attached as ${tab.watcherId}. Detach it before re-attaching as ${options.as}.`, 2);
+        return;
+    }
+    let attachedTab = tab;
+    let attachedWatcherId = tab.watcherId;
+    if (!tab.attached) {
+        const attached = await attachTab(control.watcher, tab, { watcherId: options.as });
+        if (!attached.ok) {
+            writeFailure(output, options, attached.error, 1);
+            return;
+        }
+        attachedTab = attached.tab;
+        attachedWatcherId = attached.watcherId;
+    }
+    const watcherResult = await waitForTabWatcher(control.watcher, selector.selector, { ...attachedTab, attached: true }, attachedWatcherId ?? options.as);
+    if (!watcherResult.ok) {
+        writeWatcherFailure(output, options, watcherResult);
+        return;
+    }
+    await showWatcher(watcherResult.watcher, watcherResult.tab, output, options);
+};
+export const showWatcher = async (watcher, tab, output, options) => {
+    let response;
+    try {
+        response = await fetchWatcherJson(watcher, {
+            path: '/visibility',
+            method: 'POST',
+            body: { action: 'show' },
+            timeoutMs: 5_000,
+            returnErrorResponse: true,
+        });
+    }
+    catch (error) {
+        writeFailure(output, options, `${watcher.id}: failed to show page (${formatError(error)})`, 1);
+        return;
+    }
+    if (!response.ok) {
+        writeFailure(output, options, `Error: ${response.error.message}`, 1);
+        return;
+    }
+    if (options.json) {
+        output.writeJson({
+            ok: true,
+            watcherId: watcher.id,
+            tab,
+            visibility: response,
+        });
+        return;
+    }
+    const suffix = response.attached ? '' : ' (will apply on reattach)';
+    output.writeHuman(`shown ${watcher.id}${suffix}`);
+    if (tab) {
+        output.writeHuman(`  ${formatExtensionTabLine(tab)}`);
+    }
+};
+const writeTabFailure = (output, options, result) => {
+    writeFailure(output, options, result.reason, result.exitCode, { matches: result.matches ?? [] });
+};
+const writeWatcherFailure = (output, options, result) => {
+    writeFailure(output, options, result.reason, result.exitCode, {
+        matches: result.matches?.map((entry) => ({
+            watcherId: entry.watcher.id,
+            target: entry.status.target,
+        })),
+    });
+};
+const writeFailure = (output, options, error, exitCode, extra = {}) => {
+    if (options.json) {
+        output.writeJson({ ok: false, error, ...extra });
+    }
+    else {
+        output.writeWarn(error);
+        const matches = extra.matches;
+        if (Array.isArray(matches)) {
+            for (const match of matches) {
+                if (isExtensionTab(match)) {
+                    output.writeWarn(`  ${formatExtensionTabLine(match)}`);
+                }
+            }
+        }
+    }
+    process.exitCode = exitCode;
+};
+const formatError = (error) => (error instanceof Error ? error.message : String(error));
+//# sourceMappingURL=show.js.map

package/dist/commands/extension/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/extension/show.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAgC,MAAM,gBAAgB,CAAA;AAC3F,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,UAAU,GAEV,MAAM,mBAAmB,CAAA;AAiB1B,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAAsB,EAAE,OAA6B,EAAE,SAA8B,EAAE,EAAiB,EAAE;IAChJ,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;IAEpC,IAAI,EAAE,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC,CAAC,CAAA;QAC3F,OAAM;IACP,CAAC;IAED,IAAI,EAAE,EAAE,CAAC;QACR,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAChE,OAAM;QACP,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7C,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,QAAQ,CAAC,OAAO,CAAC,EAAE,iDAAiD,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;YACvI,OAAM;QACP,CAAC;QAED,MAAM,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC1D,OAAM;IACP,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAChC,OAAO,EACP,MAAM,CAAC,qBAAqB,IAAI,iFAAiF,CACjH,CAAA;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACjE,OAAM;IACP,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,EAAE,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACjB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9D,OAAM;IACP,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACzE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACd,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC5C,OAAM;IACP,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAC1D,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;QAC3C,OAAM;IACP,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAA;IACzB,IAAI,OAAO,CAAC,EAAE,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;QACjF,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,KAAK,2BAA2B,GAAG,CAAC,SAAS,sCAAsC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;QAC7I,OAAM;IACP,CAAC;IAED,IAAI,WAAW,GAAG,GAAG,CAAA;IACrB,IAAI,iBAAiB,GAAG,GAAG,CAAC,SAAS,CAAA;IACrC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QACjF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YAChD,OAAM;QACP,CAAC;QACD,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAA;QAC1B,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAA;IACvC,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAC5C,OAAO,CAAC,OAAO,EACf,QAAQ,CAAC,QAAQ,EACjB,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClC,iBAAiB,IAAI,OAAO,CAAC,EAAE,CAC/B,CAAA;IACD,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACvB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;QACnD,OAAM;IACP,CAAC;IAED,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAC7E,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC/B,OAAsB,EACtB,GAA+B,EAC/B,MAAuC,EACvC,OAA6B,EACb,EAAE;IAClB,IAAI,QAA4C,CAAA;IAChD,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,gBAAgB,CAAqC,OAAO,EAAE;YAC9E,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YACxB,SAAS,EAAE,KAAK;YAChB,mBAAmB,EAAE,IAAI;SACzB,CAAC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,0BAA0B,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QAC9F,OAAM;IACP,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;QACpE,OAAM;IACP,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC;YAChB,EAAE,EAAE,IAAI;YACR,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,GAAG;YACH,UAAU,EAAE,QAAQ;SACpB,CAAC,CAAA;QACF,OAAM;IACP,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAA;IACnE,MAAM,CAAC,UAAU,CAAC,SAAS,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;IACjD,IAAI,GAAG,EAAE,CAAC;QACT,MAAM,CAAC,UAAU,CAAC,KAAK,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACtD,CAAC;AACF,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,CAAC,MAAuC,EAAE,OAA6B,EAAE,MAA4B,EAAQ,EAAE;IACtI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAA;AACjG,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,MAAuC,EAAE,OAA6B,EAAE,MAAgC,EAAQ,EAAE;IAC9I,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;QAC7D,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAC;KACH,CAAC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CACpB,MAAuC,EACvC,OAA6B,EAC7B,KAAa,EACb,QAAe,EACf,QAAiC,EAAE,EAC5B,EAAE;IACT,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;IACjD,CAAC;SAAM,CAAC;QACP,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,MAAM,CAAC,SAAS,CAAC,KAAK,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBACvD,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA"}

package/dist/commands/extension/tabAttach.d.ts

@@ -0,0 +1,28 @@
+import type { ExtensionBrowserTab, StatusResponse, WatcherRecord } from '@vforsh/argus-core';
+import { type TabSelector } from './tabSelection.js';
+export type WatcherResolutionResult = {
+    ok: true;
+    watcher: WatcherRecord;
+    tab: ExtensionBrowserTab;
+    status?: StatusResponse;
+} | {
+    ok: false;
+    reason: string;
+    exitCode: 1 | 2;
+    matches?: Array<{
+        watcher: WatcherRecord;
+        status: StatusResponse;
+    }>;
+};
+export declare const attachTab: (controlWatcher: WatcherRecord, tab: ExtensionBrowserTab, options?: {
+    watcherId?: string;
+}) => Promise<{
+    ok: true;
+    tab: ExtensionBrowserTab;
+    watcherId?: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare const waitForTabWatcher: (controlWatcher: WatcherRecord, selector: TabSelector, tab: ExtensionBrowserTab, watcherId?: string) => Promise<WatcherResolutionResult>;
+//# sourceMappingURL=tabAttach.d.ts.map

package/dist/commands/extension/tabAttach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabAttach.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/tabAttach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,mBAAmB,EAA8B,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvI,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpF,MAAM,MAAM,uBAAuB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAC;IAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GACvF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC,CAAA;CAAE,CAAA;AAKtH,eAAO,MAAM,SAAS,GACrB,gBAAgB,aAAa,EAC7B,KAAK,mBAAmB,EACxB,UAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,KAClC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBnG,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC7B,gBAAgB,aAAa,EAC7B,UAAU,WAAW,EACrB,KAAK,mBAAmB,EACxB,YAAY,MAAM,KAChB,OAAO,CAAC,uBAAuB,CA6BjC,CAAA"}

package/dist/commands/extension/tabAttach.js

@@ -0,0 +1,106 @@
+import { pruneRegistry } from '../../registry.js';
+import { fetchWatcherJson } from '../../watchers/requestWatcher.js';
+import { resolveWatcher } from '../../watchers/resolveWatcher.js';
+import { fetchExtensionTabs, resolveTab } from './tabSelection.js';
+const WATCHER_POLL_TIMEOUT_MS = 5_000;
+const WATCHER_POLL_INTERVAL_MS = 200;
+export const attachTab = async (controlWatcher, tab, options = {}) => {
+    try {
+        const response = await fetchWatcherJson(controlWatcher, {
+            path: '/attach',
+            method: 'POST',
+            body: { tabId: tab.tabId, watcherId: options.watcherId },
+            timeoutMs: 5_000,
+            returnErrorResponse: true,
+        });
+        if (!response.ok) {
+            return { ok: false, error: `Error: ${response.error.message}` };
+        }
+        return { ok: true, tab: response.tab, watcherId: response.watcherId };
+    }
+    catch (error) {
+        return { ok: false, error: `${controlWatcher.id}: failed to attach tab (${formatError(error)})` };
+    }
+};
+export const waitForTabWatcher = async (controlWatcher, selector, tab, watcherId) => {
+    const startedAt = Date.now();
+    let lastResult = { ok: false, reason: 'No extension watcher matched the tab.', exitCode: 1 };
+    while (Date.now() - startedAt <= WATCHER_POLL_TIMEOUT_MS) {
+        const latestTab = await refreshTab(controlWatcher, selector, tab);
+        const explicitWatcherId = latestTab?.watcherId ?? watcherId;
+        if (explicitWatcherId) {
+            // Fresh extension attaches report their tab-scoped watcher id asynchronously through `ext tabs`.
+            const watcher = await resolveWatcherById(explicitWatcherId);
+            if (watcher) {
+                const status = await fetchStatus(watcher);
+                if (!status || !statusMatchesTabWatcher(status, latestTab ?? tab, latestTab?.watcherId === explicitWatcherId)) {
+                    await delay(WATCHER_POLL_INTERVAL_MS);
+                    continue;
+                }
+                return { ok: true, watcher, status, tab: latestTab ?? tab };
+            }
+        }
+        lastResult = await resolveTabWatcher(latestTab ?? tab);
+        if (lastResult.ok) {
+            return lastResult;
+        }
+        await delay(WATCHER_POLL_INTERVAL_MS);
+    }
+    return lastResult;
+};
+const refreshTab = async (controlWatcher, selector, fallback) => {
+    const tabs = await fetchExtensionTabs(controlWatcher, selector);
+    if (!tabs.ok) {
+        return null;
+    }
+    const tab = resolveTab(tabs.tabs, { kind: 'tab', tabId: fallback.tabId });
+    return tab.ok ? { ...tab.tab, attached: true } : null;
+};
+const resolveWatcherById = async (id) => {
+    const resolved = await resolveWatcher({ id });
+    return resolved.ok && resolved.watcher.source === 'extension' ? resolved.watcher : null;
+};
+const resolveTabWatcher = async (tab) => {
+    const registry = await pruneRegistry();
+    const extensionWatchers = Object.values(registry.watchers).filter((watcher) => watcher.source === 'extension' && watcher.id !== 'extension-control');
+    const entries = await Promise.all(extensionWatchers.map(async (watcher) => {
+        const status = await fetchStatus(watcher);
+        return status ? { watcher, status } : null;
+    }));
+    const matches = entries.filter((entry) => Boolean(entry?.status.attached && entry.status.target && targetMatchesTab(entry.status.target, tab)));
+    if (matches.length === 0) {
+        return { ok: false, reason: 'No attached extension watcher matched the tab.', exitCode: 1 };
+    }
+    if (matches.length > 1) {
+        return { ok: false, reason: 'Multiple attached extension watchers matched the tab. Use watcher id instead.', exitCode: 2, matches };
+    }
+    return { ok: true, watcher: matches[0].watcher, status: matches[0].status, tab };
+};
+const fetchStatus = async (watcher) => {
+    try {
+        return await fetchWatcherJson(watcher, { path: '/status', timeoutMs: 1_000 });
+    }
+    catch {
+        return null;
+    }
+};
+const statusMatchesTabWatcher = (status, tab, tabListConfirmsWatcher) => {
+    if (!status.attached || !status.target) {
+        return false;
+    }
+    // After target selection, /status may describe an iframe while the tab list
+    // still provides the authoritative tab -> watcher mapping.
+    return tabListConfirmsWatcher || targetMatchesTab(status.target, tab);
+};
+const targetMatchesTab = (target, tab) => {
+    if (target.parentId === `tab:${tab.tabId}`) {
+        return true;
+    }
+    if (target.url && target.url === tab.url) {
+        return true;
+    }
+    return Boolean(target.title && target.title === tab.title && target.url === tab.url);
+};
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const formatError = (error) => (error instanceof Error ? error.message : String(error));
+//# sourceMappingURL=tabAttach.js.map

package/dist/commands/extension/tabAttach.js.map

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

package/dist/commands/extension/tabSelection.d.ts

@@ -0,0 +1,45 @@
+import type { ExtensionBrowserTab, WatcherRecord } from '@vforsh/argus-core';
+export type ExtensionTabSelectorOptions = {
+    tab?: string | number;
+    url?: string;
+    title?: string;
+};
+export type TabSelector = {
+    kind: 'tab';
+    tabId: number;
+} | {
+    kind: 'query';
+    url?: string;
+    title?: string;
+};
+export type SelectorResult = {
+    ok: true;
+    selector: TabSelector;
+} | {
+    ok: false;
+    reason: string;
+    exitCode: 2;
+};
+export type TabResolutionResult = {
+    ok: true;
+    tab: ExtensionBrowserTab;
+} | {
+    ok: false;
+    reason: string;
+    exitCode: 2;
+    matches?: ExtensionBrowserTab[];
+};
+export type ExtensionTabsFetchResult = {
+    ok: true;
+    tabs: ExtensionBrowserTab[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare const parseTabSelector: (options: ExtensionTabSelectorOptions, missingReason: string) => SelectorResult;
+export declare const resolveTab: (tabs: ExtensionBrowserTab[], selector: TabSelector) => TabResolutionResult;
+export declare const fetchExtensionTabs: (watcher: WatcherRecord, selector: TabSelector) => Promise<ExtensionTabsFetchResult>;
+export declare const hasTabSelector: (options: ExtensionTabSelectorOptions) => boolean;
+export declare const isExtensionTab: (value: unknown) => value is ExtensionBrowserTab;
+export declare const formatExtensionTabLine: (tab: ExtensionBrowserTab) => string;
+//# sourceMappingURL=tabSelection.d.ts.map

package/dist/commands/extension/tabSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabSelection.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/tabSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,mBAAmB,EAAyB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlH,MAAM,MAAM,2BAA2B,GAAG;IACzC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1G,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAA;AAE7G,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAA;AAEtJ,MAAM,MAAM,wBAAwB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/G,eAAO,MAAM,gBAAgB,GAAI,SAAS,2BAA2B,EAAE,eAAe,MAAM,KAAG,cAmB9F,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,mBAAmB,EAAE,EAAE,UAAU,WAAW,KAAG,mBAS/E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAU,SAAS,aAAa,EAAE,UAAU,WAAW,KAAG,OAAO,CAAC,wBAAwB,CAiBxH,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,2BAA2B,KAAG,OAAuE,CAAA;AAE7I,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mBAC6C,CAAA;AAEtG,eAAO,MAAM,sBAAsB,GAAI,KAAK,mBAAmB,KAAG,MAIjE,CAAA"}

package/dist/commands/extension/tabSelection.js

@@ -0,0 +1,76 @@
+import { fetchWatcherJson } from '../../watchers/requestWatcher.js';
+export const parseTabSelector = (options, missingReason) => {
+    const tabId = parseTabId(options.tab);
+    const url = options.url?.trim();
+    const title = options.title?.trim();
+    if (tabId !== null && (url || title)) {
+        return { ok: false, reason: 'Use --tab by itself, or resolve by --url/--title.', exitCode: 2 };
+    }
+    if (tabId === null && !url && !title) {
+        return { ok: false, reason: missingReason, exitCode: 2 };
+    }
+    if (options.tab != null && tabId === null) {
+        return { ok: false, reason: `Invalid --tab value: ${options.tab}`, exitCode: 2 };
+    }
+    if (tabId !== null) {
+        return { ok: true, selector: { kind: 'tab', tabId } };
+    }
+    return { ok: true, selector: { kind: 'query', url, title } };
+};
+export const resolveTab = (tabs, selector) => {
+    const matches = selector.kind === 'tab' ? tabs.filter((tab) => tab.tabId === selector.tabId) : tabs;
+    if (matches.length === 0) {
+        return { ok: false, reason: 'No extension tab matched.', exitCode: 2 };
+    }
+    if (matches.length > 1) {
+        return { ok: false, reason: 'Multiple extension tabs matched. Use --tab to pick one.', exitCode: 2, matches };
+    }
+    return { ok: true, tab: matches[0] };
+};
+export const fetchExtensionTabs = async (watcher, selector) => {
+    const query = buildTabsQuery(selector);
+    try {
+        const response = await fetchWatcherJson(watcher, {
+            path: '/tabs',
+            query,
+            timeoutMs: 5_000,
+            returnErrorResponse: true,
+        });
+        if (!response.ok) {
+            return { ok: false, error: `Error: ${response.error.message}` };
+        }
+        return { ok: true, tabs: response.tabs };
+    }
+    catch (error) {
+        return { ok: false, error: `${watcher.id}: failed to list extension tabs (${formatError(error)})` };
+    }
+};
+export const hasTabSelector = (options) => Boolean(options.tab != null || options.url || options.title);
+export const isExtensionTab = (value) => Boolean(value && typeof value === 'object' && 'tabId' in value && 'url' in value && 'title' in value);
+export const formatExtensionTabLine = (tab) => {
+    const state = tab.attached ? 'attached' : 'available';
+    const label = tab.title || '(untitled)';
+    return `${tab.tabId} [${state}] ${label} - ${tab.url}`;
+};
+const parseTabId = (value) => {
+    if (value === undefined) {
+        return null;
+    }
+    const tabId = typeof value === 'number' ? value : Number(value);
+    return Number.isInteger(tabId) ? tabId : null;
+};
+const buildTabsQuery = (selector) => {
+    const query = new URLSearchParams();
+    if (selector.kind === 'tab') {
+        return query;
+    }
+    if (selector.url) {
+        query.set('url', selector.url);
+    }
+    if (selector.title) {
+        query.set('title', selector.title);
+    }
+    return query;
+};
+const formatError = (error) => (error instanceof Error ? error.message : String(error));
+//# sourceMappingURL=tabSelection.js.map

package/dist/commands/extension/tabSelection.js.map

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

package/dist/commands/extension/tabWatcher.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionBrowserTab, StatusResponse, WatcherRecord } from '@vforsh/argus-core';
+import type { Output } from '../../output/io.js';
+export type ExtensionTabWatcherOptions = {
+    tab?: string | number;
+    url?: string;
+    title?: string;
+    as?: string;
+    json?: boolean;
+};
+export type ExtensionTabWatcherResult = {
+    controlWatcher: WatcherRecord;
+    watcher: WatcherRecord;
+    tab: ExtensionBrowserTab;
+    status?: StatusResponse;
+};
+export declare const resolveOrAttachExtensionTabWatcher: (options: ExtensionTabWatcherOptions, output: Output, config: {
+    missingSelectorReason: string;
+}) => Promise<ExtensionTabWatcherResult | null>;
+export declare const writeFailure: (output: Output, options: {
+    json?: boolean;
+}, error: string, exitCode: 1 | 2) => void;
+//# sourceMappingURL=tabWatcher.d.ts.map

package/dist/commands/extension/tabWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabWatcher.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/tabWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAahD,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACvC,cAAc,EAAE,aAAa,CAAA;IAC7B,OAAO,EAAE,aAAa,CAAA;IACtB,GAAG,EAAE,mBAAmB,CAAA;IACxB,MAAM,CAAC,EAAE,cAAc,CAAA;CACvB,CAAA;AAKD,eAAO,MAAM,kCAAkC,GAC9C,SAAS,0BAA0B,EACnC,QAAQ,MAAM,EACd,QAAQ;IAAE,qBAAqB,EAAE,MAAM,CAAA;CAAE,KACvC,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAsD1C,CAAA;AAwCD,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,KAAG,IAO1G,CAAA"}

package/dist/commands/extension/tabWatcher.js

@@ -0,0 +1,89 @@
+import { formatWatcherLine } from '../../output/format.js';
+import { resolveExtensionWatcher } from './resolveExtensionWatcher.js';
+import { fetchExtensionTabs, formatExtensionTabLine, parseTabSelector, resolveTab, } from './tabSelection.js';
+import { attachTab, waitForTabWatcher } from './tabAttach.js';
+export const resolveOrAttachExtensionTabWatcher = async (options, output, config) => {
+    const resolved = await resolveExtensionWatcher({});
+    if (!resolved.ok) {
+        writeResolveFailure(output, options, resolved);
+        return null;
+    }
+    const selector = parseTabSelector(options, config.missingSelectorReason);
+    if (!selector.ok) {
+        writeTabFailure(output, options, selector);
+        return null;
+    }
+    const tabs = await fetchExtensionTabs(resolved.watcher, selector.selector);
+    if (!tabs.ok) {
+        writeFailure(output, options, tabs.error, 1);
+        return null;
+    }
+    const tabResult = resolveTab(tabs.tabs, selector.selector);
+    if (!tabResult.ok) {
+        writeTabFailure(output, options, tabResult);
+        return null;
+    }
+    const tab = tabResult.tab;
+    if (options.as && tab.attached && tab.watcherId && tab.watcherId !== options.as) {
+        writeFailure(output, options, `Tab ${tab.tabId} is already attached as ${tab.watcherId}. Detach it before re-attaching as ${options.as}.`, 2);
+        return null;
+    }
+    const activeTab = await ensureTabAttached(resolved.watcher, tab, options.as);
+    if (!activeTab.ok) {
+        writeFailure(output, options, activeTab.error, 1);
+        return null;
+    }
+    const watcher = await waitForTabWatcher(resolved.watcher, { kind: 'tab', tabId: activeTab.tab.tabId }, { ...activeTab.tab, attached: true }, activeTab.watcherId ?? options.as);
+    if (!watcher.ok) {
+        writeFailure(output, options, watcher.reason, watcher.exitCode);
+        return null;
+    }
+    return {
+        controlWatcher: resolved.watcher,
+        watcher: watcher.watcher,
+        tab: watcher.tab,
+        status: watcher.status,
+    };
+};
+const ensureTabAttached = async (controlWatcher, tab, watcherId) => {
+    if (tab.attached) {
+        return { ok: true, tab, watcherId: tab.watcherId };
+    }
+    return attachTab(controlWatcher, tab, { watcherId });
+};
+const writeResolveFailure = (output, options, resolved) => {
+    if (options.json) {
+        output.writeJson({ ok: false, error: resolved.error, candidates: resolved.candidates?.map((watcher) => watcher.id) ?? [] });
+    }
+    else {
+        output.writeWarn(resolved.error);
+        for (const watcher of resolved.candidates ?? []) {
+            output.writeWarn(formatWatcherLine(watcher));
+        }
+    }
+    process.exitCode = resolved.exitCode;
+};
+const writeTabFailure = (output, options, result) => {
+    if (options.json) {
+        output.writeJson({ ok: false, error: result.reason, matches: 'matches' in result ? (result.matches ?? []) : [] });
+    }
+    else {
+        output.writeWarn(result.reason);
+        if ('matches' in result) {
+            for (const tab of result.matches ?? []) {
+                output.writeWarn(`  ${formatExtensionTabLine(tab)}`);
+            }
+        }
+    }
+    process.exitCode = result.exitCode;
+};
+export const writeFailure = (output, options, error, exitCode) => {
+    if (options.json) {
+        output.writeJson({ ok: false, error });
+    }
+    else {
+        output.writeWarn(error);
+    }
+    process.exitCode = exitCode;
+};
+//# sourceMappingURL=tabWatcher.js.map

package/dist/commands/extension/tabWatcher.js.map

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

package/dist/commands/extension/targetSelection.d.ts

@@ -0,0 +1,62 @@
+import type { ExtensionTabActionResponse, StatusResponse, WatcherRecord } from '@vforsh/argus-core';
+export type ExtensionTarget = {
+    id: string;
+    title: string;
+    url: string;
+    type?: string;
+    parentId?: string | null;
+    faviconUrl?: string;
+    attached?: boolean;
+};
+export type ExtensionTargetSelectorOptions = {
+    iframe?: string;
+    iframeUrl?: string;
+    iframeTitle?: string;
+    page?: boolean;
+};
+export type ExtensionTargetSelectionResult = {
+    ok: true;
+    target: ExtensionTarget;
+} | {
+    ok: false;
+    reason: string;
+    exitCode: 2;
+    matches?: ExtensionTarget[];
+};
+export type ExtensionTargetsResponse = {
+    ok: true;
+    targets: ExtensionTarget[];
+};
+export declare const fetchExtensionTargets: (watcher: WatcherRecord) => Promise<{
+    ok: true;
+    targets: ExtensionTarget[];
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare const selectExtensionTarget: (watcher: WatcherRecord, target: ExtensionTarget) => Promise<{
+    ok: true;
+    tab: ExtensionTabActionResponse["tab"];
+    watcherId?: string;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare const waitForSelectedTarget: (watcher: WatcherRecord, target: ExtensionTarget, options?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+}) => Promise<{
+    ok: true;
+    status: StatusResponse;
+    target: ExtensionTarget;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare const resolveExtensionTarget: (targets: ExtensionTarget[], options: ExtensionTargetSelectorOptions) => ExtensionTargetSelectionResult;
+export declare const hasExtensionTargetSelector: (options: ExtensionTargetSelectorOptions) => boolean;
+export declare const formatExtensionTargetLine: (target: ExtensionTarget) => string;
+export declare const renderExtensionTargetTree: (targets: ExtensionTarget[], output: {
+    writeHuman: (text: string) => void;
+}) => void;
+//# sourceMappingURL=targetSelection.d.ts.map

package/dist/commands/extension/targetSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targetSelection.d.ts","sourceRoot":"","sources":["../../../src/commands/extension/targetSelection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,0BAA0B,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlH,MAAM,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,MAAM,MAAM,8BAA8B,GACvC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,eAAe,EAAE,CAAA;CAC1B,CAAA;AAID,eAAO,MAAM,qBAAqB,GACjC,SAAS,aAAa,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAcjF,CAAA;AAED,eAAO,MAAM,qBAAqB,GACjC,SAAS,aAAa,EACtB,QAAQ,eAAe,KACrB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgBjH,CAAA;AAED,eAAO,MAAM,qBAAqB,GACjC,SAAS,aAAa,EACtB,QAAQ,eAAe,EACvB,UAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,KACvD,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4BtG,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,SAAS,eAAe,EAAE,EAAE,SAAS,8BAA8B,KAAG,8BAyB5G,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,SAAS,8BAA8B,KAAG,OACQ,CAAA;AAE7F,eAAO,MAAM,yBAAyB,GAAI,QAAQ,eAAe,KAAG,MAMnE,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,eAAe,EAAE,EAAE,QAAQ;IAAE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KAAG,IAoBtH,CAAA"}