@agentrhq/webcmd 0.2.5 → 0.3.1

package/README.md

@@ -1,4 +1,5 @@
-<img width="2054" height="766" alt="Webcmd banner" src="https://github.com/user-attachments/assets/3e5b9702-5ffd-43bd-ab1b-2319a8cc0e2a" />
+<img width="2056" height="765" alt="ChatGPT Image Jul 15, 2026, 12_14_45 PM" src="https://github.com/user-attachments/assets/5bcba7ee-588c-4839-9927-4f151055cdf6" />
+
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@agentrhq/webcmd">
@@ -258,7 +259,17 @@ webcmd plugin uninstall <name>
 webcmd plugin create <name>
 ```
 
-Use plugins for private company workflows, community adapters, or experiments that are not ready for the built-in registry. This repo is also a plugin monorepo: community CLIs promoted here live under [`plugins/`](./plugins/) and are advertised through [`webcmd-plugin.json`](./webcmd-plugin.json).
+`plugin create` prompts for the author's display name and GitHub handle. For non-interactive use, pass `--author-name <name>` and `--author-handle <handle>`.
+
+Use plugins for private company workflows, community adapters, or experiments that are not ready for the built-in registry. This repo is also a plugin monorepo: community plugins promoted here live under [`plugins/`](./plugins/) and are advertised through [`webcmd-plugin.json`](./webcmd-plugin.json).
+
+<!-- webcmd-community-plugins:start -->
+### Community plugins
+
+| Plugin | Description | Author |
+| --- | --- | --- |
+| [`skyscanner`](./plugins/skyscanner/) | Skyscanner flight search commands for Webcmd | [Rishabh](https://github.com/rishabhraj36) |
+<!-- webcmd-community-plugins:end -->
 
 ## Writing Adapters
 

package/cli-manifest.json

@@ -3733,7 +3733,7 @@
   {
     "site": "chatgpt",
     "name": "deep-research-result",
-    "description": "Read a completed ChatGPT Deep Research report from the conversation payload",
+    "description": "Read a ChatGPT Deep Research report or progress from the conversation payload",
     "access": "read",
     "domain": "chatgpt.com",
     "strategy": "cookie",
@@ -3773,6 +3773,15 @@
       "status",
       "report",
       "sources",
+      "progress",
+      "asyncTaskConversationId",
+      "widgetSessionId",
+      "asyncStatus",
+      "venusMessageType",
+      "venusStatus",
+      "waitingForUserUntil",
+      "planTitle",
+      "planId",
       "url",
       "method",
       "diagnostics"
@@ -3890,7 +3899,20 @@
         "name": "image",
         "type": "str",
         "required": false,
-        "help": "Local image path to attach before prompting; comma-separated paths are supported"
+        "help": "Local image path to attach before prompting; comma-separated paths are supported",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": true,
+          "separator": ",",
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       },
       {
         "name": "project",
@@ -3903,7 +3925,13 @@
         "name": "op",
         "type": "str",
         "required": false,
-        "help": "Output directory (default: ~/Pictures/chatgpt)"
+        "help": "Output directory (default: ~/Pictures/chatgpt)",
+        "file": {
+          "direction": "output",
+          "pathKind": "directory",
+          "multiple": false,
+          "defaultPath": "~/Pictures/chatgpt"
+        }
       },
       {
         "name": "sd",
@@ -4056,7 +4084,25 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": "Local file path(s) to upload; comma-separated paths are supported"
+        "help": "Local file path(s) to upload; comma-separated paths are supported",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": true,
+          "separator": ",",
+          "contentTypes": [
+            "application/pdf",
+            "text/plain",
+            "text/markdown",
+            "text/csv",
+            "application/json",
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       },
       {
         "name": "id",
@@ -4795,7 +4841,24 @@
         "name": "file",
         "type": "str",
         "required": false,
-        "help": "Attach a file (image, PDF, text) with the prompt"
+        "help": "Attach a file (image, PDF, text) with the prompt",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": false,
+          "contentTypes": [
+            "application/pdf",
+            "text/plain",
+            "text/markdown",
+            "text/csv",
+            "application/json",
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       }
     ],
     "columns": [
@@ -8495,7 +8558,7 @@
     "type": "js",
     "modulePath": "facebook/search.js",
     "sourceFile": "facebook/search.js",
-    "navigateBefore": "https://www.facebook.com"
+    "navigateBefore": false
   },
   {
     "site": "facebook",
@@ -11587,7 +11650,20 @@
         "type": "str",
         "required": false,
         "valueRequired": true,
-        "help": "Comma-separated media paths (images/videos, up to 10)"
+        "help": "Comma-separated media paths (images/videos, up to 10)",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": true,
+          "separator": ",",
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/webp",
+            "video/mp4"
+          ],
+          "maxBytes": 262144000
+        }
       },
       {
         "name": "content",
@@ -11659,7 +11735,16 @@
         "type": "str",
         "required": false,
         "valueRequired": true,
-        "help": "Path to a single .mp4 video file"
+        "help": "Path to a single .mp4 video file",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": false,
+          "contentTypes": [
+            "video/mp4"
+          ],
+          "maxBytes": 262144000
+        }
       },
       {
         "name": "content",
@@ -12670,6 +12755,40 @@
     "modulePath": "lichess/user.js",
     "sourceFile": "lichess/user.js"
   },
+  {
+    "site": "linkedin",
+    "name": "company",
+    "description": "Read a LinkedIn company page: industry, size, HQ, founded, website, followers, and about text",
+    "access": "read",
+    "domain": "www.linkedin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "company",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "Company universal name, /company/<name> path, or full URL"
+      }
+    ],
+    "columns": [
+      "name",
+      "industry",
+      "size",
+      "headquarters",
+      "founded",
+      "website",
+      "specialties",
+      "followers",
+      "about",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "linkedin/company.js",
+    "sourceFile": "linkedin/company.js",
+    "navigateBefore": "https://www.linkedin.com"
+  },
   {
     "site": "linkedin",
     "name": "connect",
@@ -12728,6 +12847,36 @@
     "sourceFile": "linkedin/connect.js",
     "navigateBefore": true
   },
+  {
+    "site": "linkedin",
+    "name": "connections",
+    "description": "List your LinkedIn first-degree connections with names, headlines, and profile URLs",
+    "access": "read",
+    "domain": "www.linkedin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Number of connections to return (max 500)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "name",
+      "occupation",
+      "public_id",
+      "connected_at",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "linkedin/connections.js",
+    "sourceFile": "linkedin/connections.js",
+    "navigateBefore": "https://www.linkedin.com"
+  },
   {
     "site": "linkedin",
     "name": "inbox",
@@ -14536,7 +14685,20 @@
         "name": "receipt",
         "type": "str",
         "required": true,
-        "help": "Local receipt/proof file path"
+        "help": "Local receipt/proof file path",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": false,
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp",
+            "application/pdf"
+          ],
+          "maxBytes": 26214400
+        }
       },
       {
         "name": "amount",
@@ -23992,7 +24154,12 @@
         "type": "str",
         "default": "./twitter-downloads",
         "required": false,
-        "help": "Output directory (default ./twitter-downloads). A per-source subdir is created inside."
+        "help": "Output directory (default ./twitter-downloads). A per-source subdir is created inside.",
+        "file": {
+          "direction": "output",
+          "pathKind": "directory",
+          "multiple": false
+        }
       }
     ],
     "columns": [
@@ -24657,7 +24824,20 @@
         "name": "images",
         "type": "string",
         "required": false,
-        "help": "Image paths, comma-separated, max 4 (jpg/png/gif/webp)"
+        "help": "Image paths, comma-separated, max 4 (jpg/png/gif/webp)",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": true,
+          "separator": ",",
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       }
     ],
     "columns": [
@@ -24734,7 +24914,19 @@
         "name": "image",
         "type": "str",
         "required": false,
-        "help": "Optional local image path to attach to the quote tweet"
+        "help": "Optional local image path to attach to the quote tweet",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": false,
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       },
       {
         "name": "image-url",
@@ -24780,7 +24972,19 @@
         "name": "image",
         "type": "str",
         "required": false,
-        "help": "Optional local image path to attach to the reply"
+        "help": "Optional local image path to attach to the reply",
+        "file": {
+          "direction": "input",
+          "pathKind": "file",
+          "multiple": false,
+          "contentTypes": [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp"
+          ],
+          "maxBytes": 26214400
+        }
       },
       {
         "name": "image-url",

package/clis/_shared/site-auth.js

@@ -72,7 +72,7 @@ export function registerSiteAuthCommands(config) {
         ? { refresh: async (page, kwargs) => normalizeRefreshResult(await config.refresh(page, kwargs)) }
         : {}),
     },
-    func: async (page) => tryProbe(config, page, 'identity'),
+    func: async (page) => [await tryProbe(config, page, 'identity')],
   });
 
   cli({
@@ -92,7 +92,7 @@ export function registerSiteAuthCommands(config) {
     columns: ['status', ...commandColumns(config)],
     func: async (page, kwargs) => {
       try {
-        return { status: 'already_logged_in', ...await tryProbe(config, page, 'identity') };
+        return [{ status: 'already_logged_in', ...await tryProbe(config, page, 'identity') }];
       } catch (error) {
         if (!isAuthRequired(error)) throw error;
       }
@@ -106,7 +106,7 @@ export function registerSiteAuthCommands(config) {
         await page.wait(Math.min(POLL_INTERVAL_MS / 1000, Math.max(0.2, (deadline - Date.now()) / 1000)));
         try {
           const identity = await tryProbe(config, page, 'poll');
-          return { status: 'login_complete', ...identity };
+          return [{ status: 'login_complete', ...identity }];
         } catch (error) {
           if (!isAuthRequired(error)) throw error;
           lastAuthMessage = getErrorMessage(error);

package/clis/_shared/site-auth.test.js

@@ -47,11 +47,11 @@ describe('site auth command helper', () => {
     const cmd = getRegistry().get('auth-helper-whoami/whoami');
     const page = pageMock();
 
-    await expect(cmd.func(page, {})).resolves.toEqual({
+    await expect(cmd.func(page, {})).resolves.toEqual([{
       logged_in: true,
       site: 'auth-helper-whoami',
       username: 'alice',
-    });
+    }]);
     expect(page.goto).not.toHaveBeenCalled();
   });
 
@@ -70,12 +70,12 @@ describe('site auth command helper', () => {
     const cmd = getRegistry().get('auth-helper-login/login');
     const page = pageMock();
 
-    await expect(cmd.func(page, { timeout: 1 })).resolves.toEqual({
+    await expect(cmd.func(page, { timeout: 1 })).resolves.toEqual([{
       status: 'login_complete',
       logged_in: true,
       site: 'auth-helper-login',
       username: 'alice',
-    });
+    }]);
     expect(page.goto).toHaveBeenCalledWith('https://example.com/login');
     expect(page.wait).toHaveBeenCalled();
     expect(poll).toHaveBeenCalledTimes(2);

package/clis/chatgpt/ask.js

@@ -105,7 +105,7 @@ export const askCommand = cli({
             if (Date.now() - settleStart > timeout * 1000) {
                 throw new CommandExecutionError('ChatGPT conversation is still generating; wait for it to finish before sending another message.');
             }
-            await page.wait(3);
+            await page.sleep(3);
         }
 
         const baselineMessages = await getVisibleMessages(page);

package/clis/chatgpt/ask.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from 'vitest';
+import { askCommand } from './ask.js';
+
+describe('chatgpt ask polling', () => {
+  it('uses pure sleep while waiting for an active generation to finish', () => {
+    const source = askCommand.func.toString();
+
+    expect(source).toContain('await page.sleep(3)');
+    expect(source).not.toContain('await page.wait(3)');
+  });
+});

package/clis/chatgpt/commands.test.js

@@ -130,7 +130,24 @@ describe('chatgpt browser command registration', () => {
             expect.objectContaining({ name: 'timeout', type: 'int', default: 120 }),
             expect.objectContaining({ name: 'stable', type: 'int', default: 6 }),
         ]));
-        expect(command.columns).toEqual(['conversationId', 'status', 'report', 'sources', 'url', 'method', 'diagnostics']);
+        expect(command.columns).toEqual([
+            'conversationId',
+            'status',
+            'report',
+            'sources',
+            'progress',
+            'asyncTaskConversationId',
+            'widgetSessionId',
+            'asyncStatus',
+            'venusMessageType',
+            'venusStatus',
+            'waitingForUserUntil',
+            'planTitle',
+            'planId',
+            'url',
+            'method',
+            'diagnostics',
+        ]);
     });
 
     it('does not return a success row when no completed deep research report exists', async () => {
@@ -178,6 +195,90 @@ describe('chatgpt browser command registration', () => {
             .rejects.toBeInstanceOf(EmptyResultError);
     });
 
+    it('returns structured deep research progress without a completed report', async () => {
+        const command = getRegistry().get('chatgpt/deep-research-result');
+        const payload = {
+            conversation_id: 'requested123',
+            mapping: {
+                progress_node: {
+                    message: {
+                        metadata: {
+                            chatgpt_sdk: {
+                                widget_state: JSON.stringify({
+                                    status: 'waiting_for_user_response_on_plan',
+                                    waiting_for_user_response_on_plan_until: '2026-07-02T02:29:48.298274Z',
+                                    plan: { plan_id: 'plan-demo', title: 'Research plan' },
+                                }),
+                                response_metadata: {
+                                    async_task_conversation_id: 'async-conversation-123',
+                                    'openai/widgetSessionId': 'widget-session-123',
+                                    'openai/asyncStatus': 7,
+                                    venus_message_type: 'initial_loading_message',
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            wait: vi.fn().mockResolvedValue(undefined),
+            startNetworkCapture: vi.fn().mockResolvedValue(true),
+            readNetworkCapture: vi.fn().mockResolvedValue([]),
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn((script) => {
+                const source = String(script);
+                if (source === 'window.location.href') return Promise.resolve('https://chatgpt.com/');
+                if (source.includes("fetch('/backend-api/conversation/requested123'")) {
+                    return Promise.resolve({
+                        ok: true,
+                        status: 200,
+                        contentType: 'application/json',
+                        text: JSON.stringify(payload),
+                    });
+                }
+                if (source.includes("document.querySelectorAll('iframe')")) {
+                    return Promise.resolve({
+                        url: 'https://chatgpt.com/c/requested123',
+                        title: 'ChatGPT',
+                        iframes: [],
+                        deepResearchIframe: null,
+                    });
+                }
+                if (source.includes('composerSelectors') && source.includes('hasComposer')) {
+                    return Promise.resolve({
+                        url: 'https://chatgpt.com/c/requested123',
+                        title: 'ChatGPT',
+                        hasComposer: true,
+                        isLoggedIn: true,
+                        hasLoginGate: false,
+                    });
+                }
+                if (source.includes('Stop generating') || source.includes('Thinking')) return Promise.resolve(false);
+                return Promise.resolve(undefined);
+            }),
+        };
+
+        await expect(command.func(page, { id: 'requested123' })).resolves.toEqual([
+            expect.objectContaining({
+                conversationId: 'requested123',
+                status: 'waiting_for_user',
+                report: '',
+                sources: [],
+                asyncTaskConversationId: 'async-conversation-123',
+                widgetSessionId: 'widget-session-123',
+                asyncStatus: 7,
+                venusMessageType: 'initial_loading_message',
+                venusStatus: 'waiting_for_user_response_on_plan',
+                waitingForUserUntil: '2026-07-02T02:29:48.298274Z',
+                planTitle: 'Research plan',
+                planId: 'plan-demo',
+                method: 'conversation-widget-progress',
+            }),
+        ]);
+    });
+
     it('typed-fails malformed deep research source rows instead of falling back to empty success', async () => {
         const command = getRegistry().get('chatgpt/deep-research-result');
         const report = `# Executive Summary\n\n${'Completed Deep Research report paragraph with enough detail to pass extraction heuristics. '.repeat(12)}\n\n## Sources`;

package/clis/chatgpt/deep-research-result.js

@@ -13,11 +13,20 @@ import {
     waitForChatGPTDeepResearchResult,
 } from './utils.js';
 
+function hasDeepResearchProgress(result) {
+    return !!result
+        && result.status !== 'completed'
+        && result.progress
+        && typeof result.progress === 'object'
+        && !Array.isArray(result.progress)
+        && Object.keys(result.progress).length > 0;
+}
+
 export const deepResearchResultCommand = cli({
     site: 'chatgpt',
     name: 'deep-research-result',
     access: 'read',
-    description: 'Read a completed ChatGPT Deep Research report from the conversation payload',
+    description: 'Read a ChatGPT Deep Research report or progress from the conversation payload',
     domain: CHATGPT_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
@@ -29,7 +38,24 @@ export const deepResearchResultCommand = cli({
         { name: 'timeout', type: 'int', default: 120, help: 'Max seconds to wait when --wait is true' },
         { name: 'stable', type: 'int', default: 6, help: 'Seconds the report text must remain unchanged when --wait is true' },
     ],
-    columns: ['conversationId', 'status', 'report', 'sources', 'url', 'method', 'diagnostics'],
+    columns: [
+        'conversationId',
+        'status',
+        'report',
+        'sources',
+        'progress',
+        'asyncTaskConversationId',
+        'widgetSessionId',
+        'asyncStatus',
+        'venusMessageType',
+        'venusStatus',
+        'waitingForUserUntil',
+        'planTitle',
+        'planId',
+        'url',
+        'method',
+        'diagnostics',
+    ],
     func: async (page, kwargs) => {
         const id = parseChatGPTConversationId(kwargs.id);
         const shouldWait = normalizeBooleanFlag(kwargs.wait, false);
@@ -59,7 +85,14 @@ export const deepResearchResultCommand = cli({
             ? await waitForChatGPTDeepResearchResult(page, { conversationId: id, timeoutSeconds: timeout, stableSeconds })
             : await getChatGPTDeepResearchResult(page, { conversationId: id, useBridgeProbes: true });
 
-        if (result.status !== 'completed' || !result.report) {
+        if (result.status !== 'completed' && !hasDeepResearchProgress(result)) {
+            throw new EmptyResultError(
+                'chatgpt deep-research-result',
+                `No completed Deep Research report was found for conversation ${id}.`,
+            );
+        }
+
+        if (result.status === 'completed' && !result.report) {
             throw new EmptyResultError(
                 'chatgpt deep-research-result',
                 `No completed Deep Research report was found for conversation ${id}.`,
@@ -71,6 +104,15 @@ export const deepResearchResultCommand = cli({
             status: result.status,
             report: result.report || '',
             sources: result.sources || [],
+            progress: result.progress || {},
+            asyncTaskConversationId: result.asyncTaskConversationId || '',
+            widgetSessionId: result.widgetSessionId || '',
+            asyncStatus: result.asyncStatus ?? '',
+            venusMessageType: result.venusMessageType || '',
+            venusStatus: result.venusStatus || '',
+            waitingForUserUntil: result.waitingForUserUntil || '',
+            planTitle: result.planTitle || '',
+            planId: result.planId || '',
             url: result.url || targetUrl,
             method: result.method || '',
             diagnostics: result.diagnostics || {},

package/clis/chatgpt/image.js

@@ -71,9 +71,29 @@ export const imageCommand = cli({
     defaultFormat: 'plain',
     args: [
         { name: 'prompt', positional: true, required: true, help: 'Image prompt to send to ChatGPT' },
-        { name: 'image', help: 'Local image path to attach before prompting; comma-separated paths are supported' },
+        {
+            name: 'image',
+            help: 'Local image path to attach before prompting; comma-separated paths are supported',
+            file: {
+                direction: 'input',
+                pathKind: 'file',
+                multiple: true,
+                separator: ',',
+                contentTypes: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
+                maxBytes: 26_214_400,
+            },
+        },
         { name: 'project', valueRequired: true, help: 'Start image generation inside a ChatGPT project ID or /g/g-p-<id> URL' },
-        { name: 'op', help: 'Output directory (default: ~/Pictures/chatgpt)' },
+        {
+            name: 'op',
+            help: 'Output directory (default: ~/Pictures/chatgpt)',
+            file: {
+                direction: 'output',
+                pathKind: 'directory',
+                multiple: false,
+                defaultPath: '~/Pictures/chatgpt',
+            },
+        },
         { name: 'sd', type: 'boolean', default: false, help: 'Skip download shorthand; only show ChatGPT link' },
         { name: 'timeout', type: 'int', required: false, default: 240, help: 'Max seconds for the overall command (default: 240)' },
     ],