@vforsh/argus 0.1.16 → 0.1.19

package/dist/cli/register/extensionCommands.js

@@ -0,0 +1,215 @@
+import { runExtensionSetup } from '../../commands/extension/setup.js';
+import { runExtensionRemove } from '../../commands/extension/remove.js';
+import { runExtensionStatus } from '../../commands/extension/status.js';
+import { runExtensionInfo } from '../../commands/extension/info.js';
+import { runExtensionTabs } from '../../commands/extension/tabs.js';
+import { runExtensionAttach, runExtensionDetach } from '../../commands/extension/attach.js';
+import { runExtensionShow } from '../../commands/extension/show.js';
+import { runExtensionUse } from '../../commands/extension/use.js';
+import { runExtensionDoctor } from '../../commands/extension/doctor.js';
+import { runExtensionTargets } from '../../commands/extension/targets.js';
+import { runExtensionSelect } from '../../commands/extension/select.js';
+const jsonOption = { flags: '--json', description: 'Output JSON for automation' };
+const tabTargetOptions = [
+    { flags: '--tab <tabId>', description: 'Browser tab id' },
+    { flags: '--url <substring>', description: 'Resolve tab by URL substring' },
+    { flags: '--title <substring>', description: 'Resolve tab by title substring' },
+    jsonOption,
+];
+const attachTargetOptions = [
+    { flags: '--tab <tabId>', description: 'Browser tab id' },
+    { flags: '--url <substring>', description: 'Resolve tab by URL substring' },
+    { flags: '--title <substring>', description: 'Resolve tab by title substring' },
+    { flags: '--as <watcherId>', description: 'Start the tab watcher with a stable id' },
+    { flags: '--no-wait', description: 'Return after the extension acknowledges the attach request' },
+    { flags: '--show', description: 'After attaching, lock the tab shown+focused' },
+    jsonOption,
+];
+const useTargetOptions = [
+    { flags: '--tab <tabId>', description: 'Browser tab id' },
+    { flags: '--url <substring>', description: 'Resolve tab by URL substring' },
+    { flags: '--title <substring>', description: 'Resolve tab by title substring' },
+    { flags: '--as <watcherId>', description: 'Start the tab watcher with a stable id when attaching' },
+    { flags: '--iframe <mode>', description: 'Select an iframe after attaching (currently: auto)' },
+    { flags: '--iframe-url <substring>', description: 'Select iframe by URL substring after attaching' },
+    { flags: '--iframe-title <substring>', description: 'Select iframe by title substring after attaching' },
+    { flags: '--show', description: 'Lock the resolved watcher shown+focused' },
+    jsonOption,
+];
+const iframeTargetOptions = [
+    { flags: '--page', description: 'Select the top page target' },
+    { flags: '--iframe <mode>', description: 'Select an iframe target (currently: auto)' },
+    { flags: '--iframe-url <substring>', description: 'Select iframe by URL substring' },
+    { flags: '--iframe-title <substring>', description: 'Select iframe by title substring' },
+];
+const showTargetOptions = [
+    { flags: '--tab <tabId>', description: 'Browser tab id' },
+    { flags: '--url <substring>', description: 'Resolve tab by URL substring' },
+    { flags: '--title <substring>', description: 'Resolve tab by title substring' },
+    { flags: '--as <watcherId>', description: 'Start the tab watcher with a stable id when attaching' },
+    jsonOption,
+];
+export const extensionCommands = [
+    {
+        name: 'extension',
+        alias: 'ext',
+        description: 'Browser extension management',
+        subcommands: [
+            {
+                name: 'setup <extensionId>',
+                description: 'Install native messaging host for the browser extension',
+                options: [jsonOption],
+                configure: (command) => {
+                    command.addHelpText('after', '\nTo get your extension ID:\n  1. Open chrome://extensions\n  2. Enable Developer mode\n  3. Load argus-extension as unpacked\n  4. Copy the ID from the extension card\n');
+                },
+                action: async (extensionId, options) => {
+                    await runExtensionSetup({ extensionId, ...options });
+                },
+            },
+            {
+                name: 'remove',
+                description: 'Uninstall native messaging host',
+                options: [jsonOption],
+                action: async (options) => {
+                    await runExtensionRemove(options);
+                },
+            },
+            {
+                name: 'status',
+                description: 'Check native messaging host configuration',
+                options: [jsonOption],
+                action: async (options) => {
+                    await runExtensionStatus(options);
+                },
+            },
+            {
+                name: 'doctor',
+                description: 'Diagnose native host and live extension-control state',
+                options: [{ flags: '--watcher <watcherId>', description: 'Include diagnostics for one extension-backed watcher' }, jsonOption],
+                examples: ['argus ext doctor', 'argus ext doctor --watcher vk-game', 'argus ext doctor --json'],
+                action: async (options) => {
+                    await runExtensionDoctor(options);
+                },
+            },
+            {
+                name: 'info',
+                description: 'Show native messaging host paths and configuration',
+                options: [jsonOption],
+                action: async (options) => {
+                    await runExtensionInfo(options);
+                },
+            },
+            {
+                name: 'tabs',
+                description: 'List browser tabs visible to the extension transport',
+                options: [
+                    { flags: '--id <watcherId>', description: 'Extension-backed watcher id to use as the transport (default: extension-control)' },
+                    { flags: '--url <substring>', description: 'Filter tabs by URL substring' },
+                    { flags: '--title <substring>', description: 'Filter tabs by title substring' },
+                    jsonOption,
+                ],
+                examples: [
+                    'argus ext tabs',
+                    'argus ext tabs --url localhost',
+                    'argus ext tabs --title Docs --json',
+                    'argus ext tabs --id extension-2',
+                ],
+                action: async (options) => {
+                    await runExtensionTabs(options);
+                },
+            },
+            {
+                name: 'attach',
+                description: 'Attach a browser tab through the extension control watcher',
+                options: attachTargetOptions,
+                examples: [
+                    'argus ext attach --tab 123',
+                    'argus ext attach --url localhost --as app',
+                    'argus ext attach --url localhost --show',
+                    'argus ext attach --title Docs --no-wait --json',
+                ],
+                action: async (options) => {
+                    await runExtensionAttach(options);
+                },
+            },
+            {
+                name: 'use',
+                description: 'Resolve or attach an extension tab and print its watcher id',
+                options: useTargetOptions,
+                examples: [
+                    'argus ext use --url localhost --as app',
+                    'argus ext use --url vk.com/app --as vk-game --iframe-url stark.games',
+                    'argus ext use --url vk.com/app --as vk-game --iframe auto',
+                    'argus ext use --title Docs --show',
+                    'argus ext use --tab 123 --json',
+                ],
+                action: async (options) => {
+                    await runExtensionUse(options);
+                },
+            },
+            {
+                name: 'targets',
+                description: 'List page and iframe targets for an extension tab watcher',
+                arguments: [{ flags: '[id]', description: 'Attached extension watcher id' }],
+                options: [
+                    { flags: '--tab <tabId>', description: 'Browser tab id' },
+                    { flags: '--url <substring>', description: 'Resolve tab by URL substring' },
+                    { flags: '--title <substring>', description: 'Resolve tab by title substring' },
+                    { flags: '--as <watcherId>', description: 'Stable id to use if the tab must be attached first' },
+                    { flags: '--type <type>', description: 'Filter targets by type, e.g. page or iframe' },
+                    { flags: '--tree', description: 'Print targets as a parent/child tree' },
+                    jsonOption,
+                ],
+                examples: [
+                    'argus ext targets vk-game --tree',
+                    'argus ext targets --url vk.com/app --as vk-game',
+                    'argus ext targets --tab 123 --type iframe --json',
+                ],
+                action: async (id, options) => {
+                    await runExtensionTargets(id, options);
+                },
+            },
+            {
+                name: 'select',
+                description: 'Select the page or an iframe target inside an extension tab watcher',
+                arguments: [{ flags: '[id]', description: 'Attached extension watcher id' }],
+                options: [
+                    ...iframeTargetOptions,
+                    { flags: '--no-wait', description: 'Return after the extension acknowledges the target switch' },
+                    jsonOption,
+                ],
+                examples: [
+                    'argus ext select vk-game --iframe-url stark.games',
+                    'argus ext select vk-game --iframe-title "Ёлочка 2025"',
+                    'argus ext select vk-game --iframe auto',
+                    'argus ext select vk-game --page',
+                ],
+                action: async (id, options) => {
+                    await runExtensionSelect(id, options);
+                },
+            },
+            {
+                name: 'detach',
+                description: 'Ask the extension control watcher to detach a browser tab',
+                options: tabTargetOptions,
+                examples: ['argus ext detach --tab 123', 'argus ext detach --url localhost', 'argus ext detach --title Docs --json'],
+                action: async (options) => {
+                    await runExtensionDetach(options);
+                },
+            },
+            {
+                name: 'show',
+                description: 'Attach or resolve an extension tab and lock it shown+focused',
+                arguments: [{ flags: '[id]', description: 'Attached extension watcher id' }],
+                options: showTargetOptions,
+                configure: (command) => {
+                    command.addHelpText('after', '\nExamples:\n  $ argus ext show extension\n  $ argus ext show --tab 123\n  $ argus ext show --url localhost\n  $ argus ext show --title "Cocos Creator" --json\n\nWith --tab/--url/--title, attaches the tab first if needed, then applies the\nsame sticky shown+focused lock as `argus page show <watcherId>`.\n');
+                },
+                action: async (id, options) => {
+                    await runExtensionShow(id, options);
+                },
+            },
+        ],
+    },
+];
+//# sourceMappingURL=extensionCommands.js.map

package/dist/cli/register/extensionCommands.js.map

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

package/dist/cli/register/fillCommand.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const fillCommand: ArgusCommandDefinition;
+//# sourceMappingURL=fillCommand.d.ts.map

package/dist/cli/register/fillCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/register/fillCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAIjE,eAAO,MAAM,WAAW,EAAE,sBAuCzB,CAAA"}

package/dist/cli/register/fillCommand.js

@@ -0,0 +1,44 @@
+import { runDomFill } from '../../commands/domFill.js';
+import { resolveTestId } from '../../commands/resolveTestId.js';
+export const fillCommand = {
+    name: 'fill',
+    description: 'Fill input/textarea/contenteditable elements with a value',
+    arguments: [
+        { flags: '[id]', description: 'Watcher id to query' },
+        { flags: '[value]', description: 'Value to fill (or use --value-file / --value-stdin / "-" for stdin)' },
+    ],
+    options: [
+        { flags: '--selector <css>', description: 'CSS selector for target element(s)' },
+        { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+        { flags: '--ref <elementRef>', description: 'Stable element ref from snapshot/locate output' },
+        { flags: '--name <attr>', description: 'Shorthand for --selector "[name=<attr>]"' },
+        { flags: '--value-file <path>', description: 'Read value from a file' },
+        { flags: '--value-stdin', description: 'Read value from stdin (also triggered by "-" as value arg)' },
+        { flags: '--all', description: 'Allow multiple matches (default: error if >1 match)' },
+        { flags: '--text <string>', description: 'Filter by textContent (trimmed). Supports /regex/flags syntax' },
+        { flags: '--wait <duration>', description: 'Wait for selector to appear (e.g. 5s, 500ms)' },
+        { flags: '--json', description: 'Output JSON for automation' },
+    ],
+    examples: [
+        'argus fill app --selector "#username" "Bob"',
+        'argus fill app --testid "username" "Bob"',
+        'argus fill app --ref e7 "Bob"',
+        'argus fill app --name "title" "Hello"',
+        'argus fill app --selector "textarea" "New content"',
+        'argus fill app --selector "input[type=text]" --all "reset"',
+        'argus fill app --selector "#desc" --value-file ./description.txt',
+        'echo "hello" | argus fill app --selector "#input" --value-stdin',
+        'argus fill app --selector "#input" - < value.txt',
+    ],
+    action: async (id, value, options) => {
+        if (options.name && (options.testid || options.ref)) {
+            console.error('Cannot use --name with --testid or --ref.');
+            process.exitCode = 2;
+            return;
+        }
+        if (!resolveTestId(options))
+            return;
+        await runDomFill(id, value, options);
+    },
+};
+//# sourceMappingURL=fillCommand.js.map

package/dist/cli/register/fillCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillCommand.js","sourceRoot":"","sources":["../../../src/cli/register/fillCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAE/D,MAAM,CAAC,MAAM,WAAW,GAA2B;IAClD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2DAA2D;IACxE,SAAS,EAAE;QACV,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE;QACrD,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,qEAAqE,EAAE;KACxG;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,oCAAoC,EAAE;QAChF,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC5F,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAC9F,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;QACnF,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACvE,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,4DAA4D,EAAE;QACrG,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACtF,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,+DAA+D,EAAE;QAC1G,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,8CAA8C,EAAE;QAC3F,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;KAC9D;IACD,QAAQ,EAAE;QACT,6CAA6C;QAC7C,0CAA0C;QAC1C,+BAA+B;QAC/B,uCAAuC;QACvC,oDAAoD;QACpD,4DAA4D;QAC5D,kEAAkE;QAClE,iEAAiE;QACjE,kDAAkD;KAClD;IACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpC,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;YAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;YACpB,OAAM;QACP,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAM;QACnC,MAAM,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;CACD,CAAA"}

package/dist/cli/register/hoverCommand.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const hoverCommand: ArgusCommandDefinition;
+//# sourceMappingURL=hoverCommand.d.ts.map

package/dist/cli/register/hoverCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoverCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/register/hoverCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAIjE,eAAO,MAAM,YAAY,EAAE,sBAsB1B,CAAA"}

package/dist/cli/register/hoverCommand.js

@@ -0,0 +1,27 @@
+import { runDomHover } from '../../commands/domHover.js';
+import { resolveTestId } from '../../commands/resolveTestId.js';
+export const hoverCommand = {
+    name: 'hover',
+    description: 'Hover over element(s) matching a CSS selector',
+    arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+    options: [
+        { flags: '--selector <css>', description: 'CSS selector to match element(s)' },
+        { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+        { flags: '--ref <elementRef>', description: 'Stable element ref from snapshot/locate output' },
+        { flags: '--all', description: 'Allow multiple matches (default: error if >1 match)' },
+        { flags: '--text <string>', description: 'Filter by textContent (trimmed). Supports /regex/flags syntax' },
+        { flags: '--json', description: 'Output JSON for automation' },
+    ],
+    examples: [
+        'argus hover app --selector "#btn"',
+        'argus hover app --ref e5',
+        'argus hover app --selector ".item" --all',
+        'argus hover app --selector "#btn" --json',
+    ],
+    action: async (id, options) => {
+        if (!resolveTestId(options))
+            return;
+        await runDomHover(id, options);
+    },
+};
+//# sourceMappingURL=hoverCommand.js.map

package/dist/cli/register/hoverCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoverCommand.js","sourceRoot":"","sources":["../../../src/cli/register/hoverCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAE/D,MAAM,CAAC,MAAM,YAAY,GAA2B;IACnD,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,+CAA+C;IAC5D,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAClE,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC9E,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC5F,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAC9F,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,qDAAqD,EAAE;QACtF,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,+DAA+D,EAAE;QAC1G,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;KAC9D;IACD,QAAQ,EAAE;QACT,mCAAmC;QACnC,0BAA0B;QAC1B,0CAA0C;QAC1C,0CAA0C;KAC1C;IACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAM;QACnC,MAAM,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/B,CAAC;CACD,CAAA"}

package/dist/cli/register/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/register/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA2BxC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AAMzD,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAyB5D,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/register/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA+BxC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AAiCzD,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAAmE,CAAA"}

package/dist/cli/register/index.js

@@ -1,55 +1,60 @@
-import { domClickCommandDefinition } from '../../commands/domClick.js';
 import { defineCommands } from '../defineCommand.js';
-import { registerQuickAccess } from './registerQuickAccess.js';
-import { registerChrome } from './registerChrome.js';
-import { registerWatcher } from './registerWatcher.js';
-import { registerPage } from './registerPage.js';
-import { registerDialog } from './registerDialog.js';
-import { registerLogs } from './registerLogs.js';
-import { registerNet } from './registerNet.js';
-import { registerAuth } from './registerAuth.js';
-import { registerEval } from './registerEval.js';
-import { registerDom } from './registerDom.js';
-import { registerKeydown } from './registerKeydown.js';
-import { registerFill } from './registerFill.js';
-import { registerHover } from './registerHover.js';
-import { registerScrollTo } from './registerScrollTo.js';
-import { registerStorage } from './registerStorage.js';
-import { registerThrottle } from './registerThrottle.js';
-import { registerSnapshot } from './registerSnapshot.js';
-import { registerTrace } from './registerTrace.js';
-import { registerConfig } from './registerConfig.js';
-import { registerExtension } from './registerExtension.js';
-import { registerCode } from './registerCode.js';
-import { registerLocate } from './registerLocate.js';
-import { registerPlugin } from './registerPlugin.js';
-const registerDefinedCommands = (program) => {
-    defineCommands(program, [domClickCommandDefinition]);
-};
-export const coreProgramRegistrars = [
-    registerQuickAccess,
-    registerChrome,
-    registerWatcher,
-    registerPage,
-    registerDialog,
-    registerLogs,
-    registerNet,
-    registerAuth,
-    registerEval,
-    registerLocate,
-    registerCode,
-    registerDom,
-    registerDefinedCommands,
-    registerKeydown,
-    registerFill,
-    registerHover,
-    registerScrollTo,
-    registerStorage,
-    registerThrottle,
-    registerSnapshot,
-    registerTrace,
-    registerConfig,
-    registerPlugin,
-    registerExtension,
+import { domClickCommandDefinition } from '../../commands/domClick.js';
+import { domDragCommandDefinition } from '../../commands/domDrag.js';
+import { quickAccessCommands } from './quickAccessCommands.js';
+import { chromeCommands } from './chromeCommands.js';
+import { watcherCommands } from './watcherCommands.js';
+import { pageCommands } from './pageCommands.js';
+import { dialogCommands } from './dialogCommands.js';
+import { logsCommands } from './logsCommands.js';
+import { netCommands } from './netCommands.js';
+import { authCommands } from './authCommands.js';
+import { evalCommands } from './evalCommands.js';
+import { locateCommands } from './locateCommands.js';
+import { codeCommands } from './codeCommands.js';
+import { domCommands } from './domCommands.js';
+import { keydownCommand } from './keydownCommand.js';
+import { fillCommand } from './fillCommand.js';
+import { hoverCommand } from './hoverCommand.js';
+import { scrollToCommand } from './scrollToCommand.js';
+import { storageCommands } from './storageCommands.js';
+import { throttleCommands } from './throttleCommands.js';
+import { snapshotCommands } from './snapshotCommands.js';
+import { recordCommands } from './recordCommands.js';
+import { traceCommands } from './traceCommands.js';
+import { configCommands } from './configCommands.js';
+import { pluginCommands } from './pluginCommands.js';
+import { extensionCommands } from './extensionCommands.js';
+import { skillCommands } from './skillCommands.js';
+/** All built-in CLI commands, in registration (help display) order. */
+const coreCommandDefinitions = [
+    ...quickAccessCommands,
+    ...chromeCommands,
+    ...watcherCommands,
+    ...pageCommands,
+    ...dialogCommands,
+    ...logsCommands,
+    ...netCommands,
+    ...authCommands,
+    ...evalCommands,
+    ...locateCommands,
+    ...codeCommands,
+    ...domCommands,
+    domClickCommandDefinition,
+    domDragCommandDefinition,
+    keydownCommand,
+    fillCommand,
+    hoverCommand,
+    scrollToCommand,
+    ...storageCommands,
+    ...throttleCommands,
+    ...snapshotCommands,
+    ...recordCommands,
+    ...traceCommands,
+    ...configCommands,
+    ...pluginCommands,
+    ...skillCommands,
+    ...extensionCommands,
 ];
+export const coreProgramRegistrars = [(program) => defineCommands(program, coreCommandDefinitions)];
 //# sourceMappingURL=index.js.map

package/dist/cli/register/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/register/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAIpD,MAAM,uBAAuB,GAAqB,CAAC,OAAO,EAAE,EAAE;IAC7D,cAAc,CAAC,OAAO,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IACjE,mBAAmB;IACnB,cAAc;IACd,eAAe;IACf,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,WAAW;IACX,uBAAuB;IACvB,eAAe;IACf,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,cAAc;IACd,iBAAiB;CACjB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/register/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIlD,uEAAuE;AACvE,MAAM,sBAAsB,GAAsC;IACjE,GAAG,mBAAmB;IACtB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,YAAY;IACf,GAAG,WAAW;IACd,yBAAyB;IACzB,wBAAwB;IACxB,cAAc;IACd,WAAW;IACX,YAAY;IACZ,eAAe;IACf,GAAG,eAAe;IAClB,GAAG,gBAAgB;IACnB,GAAG,gBAAgB;IACnB,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,cAAc;IACjB,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,iBAAiB;CACpB,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAgC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAA"}

package/dist/cli/register/keydownCommand.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const keydownCommand: ArgusCommandDefinition;
+//# sourceMappingURL=keydownCommand.d.ts.map

package/dist/cli/register/keydownCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keydownCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/register/keydownCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAIjE,eAAO,MAAM,cAAc,EAAE,sBAgB5B,CAAA"}

package/dist/cli/register/keydownCommand.js

@@ -0,0 +1,21 @@
+import { runDomKeydown } from '../../commands/domKeydown.js';
+import { resolveTestId } from '../../commands/resolveTestId.js';
+export const keydownCommand = {
+    name: 'keydown',
+    description: 'Dispatch a keyboard event to the connected page',
+    arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
+    options: [
+        { flags: '--key <name>', description: 'Key name (e.g. Enter, a, ArrowUp)', required: true },
+        { flags: '--selector <css>', description: 'Focus element before dispatching' },
+        { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
+        { flags: '--modifiers <list>', description: 'Comma-separated modifiers: shift,ctrl,alt,meta' },
+        { flags: '--json', description: 'Output JSON for automation' },
+    ],
+    examples: ['argus keydown app --key Enter', 'argus keydown app --key a --selector "#input"', 'argus keydown app --key a --modifiers shift,ctrl'],
+    action: async (id, options) => {
+        if (!resolveTestId(options))
+            return;
+        await runDomKeydown(id, options);
+    },
+};
+//# sourceMappingURL=keydownCommand.js.map

package/dist/cli/register/keydownCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keydownCommand.js","sourceRoot":"","sources":["../../../src/cli/register/keydownCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAE/D,MAAM,CAAC,MAAM,cAAc,GAA2B;IACrD,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,iDAAiD;IAC9D,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAClE,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3F,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC9E,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC5F,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAC9F,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;KAC9D;IACD,QAAQ,EAAE,CAAC,+BAA+B,EAAE,+CAA+C,EAAE,kDAAkD,CAAC;IAChJ,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAM;QACnC,MAAM,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC;CACD,CAAA"}

package/dist/cli/register/locateCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const locateCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=locateCommands.d.ts.map

package/dist/cli/register/locateCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locateCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/locateCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAWjE,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EAkD3D,CAAA"}

package/dist/cli/register/locateCommands.js

@@ -0,0 +1,60 @@
+import { runLocateLabel, runLocateRole, runLocateText } from '../../commands/locate.js';
+const sharedLocateOptions = [
+    { flags: '--exact', description: 'Require an exact normalized text match' },
+    { flags: '--all', description: 'Return all matches (default: error if >1 match)' },
+    { flags: '--action <action>', description: 'Immediately run one action: click, fill, focus, hover' },
+    { flags: '--value <text>', description: 'Fill value when used with --action fill' },
+    { flags: '--json', description: 'Output JSON for automation' },
+];
+export const locateCommands = [
+    {
+        name: 'locate',
+        description: 'Find semantic elements and return stable refs for later actions',
+        subcommands: [
+            {
+                name: 'role',
+                description: 'Locate elements by accessibility role and optional accessible name',
+                arguments: [
+                    { flags: '[id]', description: 'Watcher id to query' },
+                    { flags: '<role>', description: 'Accessibility role to match (e.g. button, textbox, link)' },
+                ],
+                options: [{ flags: '--name <text>', description: 'Match the element accessible name' }, ...sharedLocateOptions],
+                examples: [
+                    'argus locate role app button --name "Submit"',
+                    'argus locate role app textbox --name "Email" --action fill --value "me@example.com"',
+                    'argus locate role app link --all',
+                ],
+                action: async (id, role, options) => {
+                    await runLocateRole(id, role, options);
+                },
+            },
+            {
+                name: 'text',
+                description: 'Locate elements by visible/accessible text',
+                arguments: [
+                    { flags: '[id]', description: 'Watcher id to query' },
+                    { flags: '<text>', description: 'Visible/accessible text to match' },
+                ],
+                options: sharedLocateOptions,
+                examples: ['argus locate text app "Accept"', 'argus locate text app "Continue" --action click', 'argus locate text app "Home" --all'],
+                action: async (id, text, options) => {
+                    await runLocateText(id, text, options);
+                },
+            },
+            {
+                name: 'label',
+                description: 'Locate form controls by their label or accessible name',
+                arguments: [
+                    { flags: '[id]', description: 'Watcher id to query' },
+                    { flags: '<label>', description: 'Form label / accessible name to match' },
+                ],
+                options: sharedLocateOptions,
+                examples: ['argus locate label app "Email"', 'argus locate label app "Email" --action fill --value "me@example.com"'],
+                action: async (id, label, options) => {
+                    await runLocateLabel(id, label, options);
+                },
+            },
+        ],
+    },
+];
+//# sourceMappingURL=locateCommands.js.map

package/dist/cli/register/locateCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locateCommands.js","sourceRoot":"","sources":["../../../src/cli/register/locateCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAEvF,MAAM,mBAAmB,GAAG;IAC3B,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,wCAAwC,EAAE;IAC3E,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,iDAAiD,EAAE;IAClF,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,uDAAuD,EAAE;IACpG,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACnF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;CACrD,CAAA;AAEV,MAAM,CAAC,MAAM,cAAc,GAAsC;IAChE;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE;YACZ;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,oEAAoE;gBACjF,SAAS,EAAE;oBACV,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBACrD,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;iBAC5F;gBACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mCAAmC,EAAE,EAAE,GAAG,mBAAmB,CAAC;gBAC/G,QAAQ,EAAE;oBACT,8CAA8C;oBAC9C,qFAAqF;oBACrF,kCAAkC;iBAClC;gBACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;oBACnC,MAAM,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACvC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,4CAA4C;gBACzD,SAAS,EAAE;oBACV,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBACrD,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;iBACpE;gBACD,OAAO,EAAE,mBAAmB;gBAC5B,QAAQ,EAAE,CAAC,gCAAgC,EAAE,iDAAiD,EAAE,oCAAoC,CAAC;gBACrI,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;oBACnC,MAAM,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACvC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,wDAAwD;gBACrE,SAAS,EAAE;oBACV,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBACrD,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE;iBAC1E;gBACD,OAAO,EAAE,mBAAmB;gBAC5B,QAAQ,EAAE,CAAC,gCAAgC,EAAE,uEAAuE,CAAC;gBACrH,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACpC,MAAM,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;gBACzC,CAAC;aACD;SACD;KACD;CACD,CAAA"}

package/dist/cli/register/logsCommands.d.ts

@@ -0,0 +1,3 @@
+import type { ArgusCommandDefinition } from '../defineCommand.js';
+export declare const logsCommands: readonly ArgusCommandDefinition[];
+//# sourceMappingURL=logsCommands.d.ts.map

package/dist/cli/register/logsCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logsCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/logsCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,qBAAqB,CAAA;AA4BrF,eAAO,MAAM,YAAY,EAAE,SAAS,sBAAsB,EA6CzD,CAAA"}