@jackwener/opencli 1.3.3 → 1.4.1

package/src/clis/pixiv/utils.ts

@@ -0,0 +1,62 @@
+/**
+ * Pixiv shared helpers: authenticated Ajax fetch with standard error handling.
+ *
+ * All Pixiv Ajax APIs return `{ error: false, body: ... }` on success.
+ * On failure the HTTP status code is used to distinguish auth (401/403),
+ * not-found (404), and other errors.
+ */
+
+import type { IPage } from '../../types.js';
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
+
+const PIXIV_DOMAIN = 'www.pixiv.net';
+
+/**
+ * Navigate to Pixiv (to attach cookies) then fetch a Pixiv Ajax API endpoint.
+ *
+ * Handles the common navigate → evaluate(fetch) → error-check pattern used
+ * by every Pixiv TS adapter.
+ *
+ * @param page  - Browser page instance
+ * @param path  - API path, e.g. '/ajax/illust/12345'
+ * @param opts  - Optional query params
+ * @returns     - The parsed `body` from the JSON response
+ * @throws AuthRequiredError on 401/403
+ * @throws CommandExecutionError on 404 or other HTTP errors
+ */
+export async function pixivFetch(
+  page: IPage,
+  path: string,
+  opts: { params?: Record<string, string | number>; notFoundMsg?: string } = {},
+): Promise<any> {
+  await page.goto(`https://${PIXIV_DOMAIN}`);
+
+  const qs = opts.params
+    ? '?' + Object.entries(opts.params).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join('&')
+    : '';
+  const url = `https://${PIXIV_DOMAIN}${path}${qs}`;
+
+  const data: any = await page.evaluate(`
+    (async () => {
+      const res = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+      if (!res.ok) return { __httpError: res.status };
+      return await res.json();
+    })()
+  `);
+
+  if (data?.__httpError) {
+    const status = data.__httpError;
+    if (status === 401 || status === 403) {
+      throw new AuthRequiredError(PIXIV_DOMAIN, 'Authentication required — please log in to Pixiv in Chrome');
+    }
+    if (status === 404) {
+      throw new CommandExecutionError(opts.notFoundMsg || `Pixiv resource not found (HTTP 404)`);
+    }
+    throw new CommandExecutionError(`Pixiv request failed (HTTP ${status})`);
+  }
+
+  return data?.body;
+}
+
+/** Maximum number of illust IDs per batch detail request (Pixiv server limit). */
+export const BATCH_SIZE = 48;

package/src/clis/reddit/comment.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 

package/src/clis/reddit/read.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './read.js';
+
+describe('reddit read adapter', () => {
+  const command = getRegistry().get('reddit/read');
+
+  it('returns threaded rows from the browser-evaluated payload', async () => {
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue([
+        { type: 'POST', author: 'alice', score: 10, text: 'Title' },
+        { type: 'L0', author: 'bob', score: 5, text: 'Comment' },
+      ]),
+    } as any;
+
+    const result = await command!.func!(page, { 'post-id': 'abc123', limit: 5 });
+
+    expect(page.goto).toHaveBeenCalledWith('https://www.reddit.com');
+    expect(result).toEqual([
+      { type: 'POST', author: 'alice', score: 10, text: 'Title' },
+      { type: 'L0', author: 'bob', score: 5, text: 'Comment' },
+    ]);
+  });
+
+  it('surfaces adapter-level API errors clearly', async () => {
+    const page = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn().mockResolvedValue({ error: 'Reddit API returned HTTP 403' }),
+    } as any;
+
+    await expect(command!.func!(page, { 'post-id': 'abc123' })).rejects.toThrow('Reddit API returned HTTP 403');
+  });
+});

package/src/clis/reddit/read.ts

@@ -7,6 +7,7 @@
  * - Indented output showing conversation threads
  */
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../errors.js';
 
 cli({
   site: 'reddit',
@@ -176,9 +177,9 @@ cli({
       })()
     `);
 
-    if (!data || typeof data !== 'object') throw new Error('Failed to fetch post data');
-    if (!Array.isArray(data) && data.error) throw new Error(data.error);
-    if (!Array.isArray(data)) throw new Error('Unexpected response');
+    if (!data || typeof data !== 'object') throw new CommandExecutionError('Failed to fetch post data');
+    if (!Array.isArray(data) && data.error) throw new CommandExecutionError(data.error);
+    if (!Array.isArray(data)) throw new CommandExecutionError('Unexpected response');
 
     return data;
   },

package/src/clis/reddit/save.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 

package/src/clis/reddit/saved.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -12,7 +13,7 @@ cli({
   ],
   columns: ['title', 'subreddit', 'score', 'comments', 'url'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 
@@ -41,7 +42,10 @@ cli({
       }
     })()`);
 
-    if (result?.error) throw new Error(result.error);
+    if (result?.error) {
+      if (String(result.error).includes('Not logged in')) throw new AuthRequiredError('reddit.com', result.error);
+      throw new CommandExecutionError(result.error);
+    }
     return (result || []).slice(0, kwargs.limit);
   }
 });

package/src/clis/reddit/subscribe.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 

package/src/clis/reddit/upvote.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 

package/src/clis/reddit/upvoted.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -12,7 +13,7 @@ cli({
   ],
   columns: ['title', 'subreddit', 'score', 'comments', 'url'],
   func: async (page, kwargs) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required');
 
     await page.goto('https://www.reddit.com');
 
@@ -41,7 +42,10 @@ cli({
       }
     })()`);
 
-    if (result?.error) throw new Error(result.error);
+    if (result?.error) {
+      if (String(result.error).includes('Not logged in')) throw new AuthRequiredError('reddit.com', result.error);
+      throw new CommandExecutionError(result.error);
+    }
     return (result || []).slice(0, kwargs.limit);
   }
 });

package/src/clis/reuters/search.ts

@@ -1,6 +1,5 @@
 /**
  * Reuters news search — API with HTML fallback.
- * Source: bb-sites/reuters/search.js
  */
 import { cli, Strategy } from '../../registry.js';
 

package/src/clis/sinablog/article.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadSinaBlogArticle } from './shared.js';
+import { loadSinaBlogArticle } from './utils.js';
 
 cli({
   site: 'sinablog',

package/src/clis/sinablog/hot.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadSinaBlogHot } from './shared.js';
+import { loadSinaBlogHot } from './utils.js';
 
 cli({
   site: 'sinablog',

package/src/clis/sinablog/user.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadSinaBlogUser } from './shared.js';
+import { loadSinaBlogUser } from './utils.js';
 
 cli({
   site: 'sinablog',

package/src/clis/substack/feed.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { buildSubstackBrowseUrl, loadSubstackFeed } from './shared.js';
+import { buildSubstackBrowseUrl, loadSubstackFeed } from './utils.js';
 
 cli({
   site: 'substack',

package/src/clis/substack/publication.ts

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
-import { loadSubstackArchive } from './shared.js';
+import { loadSubstackArchive } from './utils.js';
 
 cli({
   site: 'substack',

package/src/clis/substack/search.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 type SubstackPostResult = {
@@ -32,7 +33,7 @@ async function searchPosts(keyword: string, limit: number): Promise<SubstackPost
   url.searchParams.set('includePlatformResults', 'true');
 
   const resp = await fetch(url, { headers: headers() });
-  if (!resp.ok) throw new Error(`Substack post search failed: HTTP ${resp.status}`);
+  if (!resp.ok) throw new CommandExecutionError(`Substack post search failed: HTTP ${resp.status}`);
 
   const data = await resp.json() as { results?: any[] };
   const results = Array.isArray(data?.results) ? data.results : [];
@@ -52,7 +53,7 @@ async function searchPublications(keyword: string, limit: number): Promise<Subst
   url.searchParams.set('page', '0');
 
   const resp = await fetch(url, { headers: headers() });
-  if (!resp.ok) throw new Error(`Substack publication search failed: HTTP ${resp.status}`);
+  if (!resp.ok) throw new CommandExecutionError(`Substack publication search failed: HTTP ${resp.status}`);
 
   const data = await resp.json() as { results?: any[] };
   const results = Array.isArray(data?.results) ? data.results : [];

package/src/clis/substack/{shared.ts → utils.ts}

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 export function buildSubstackBrowseUrl(category?: string): string {
@@ -7,7 +8,7 @@ export function buildSubstackBrowseUrl(category?: string): string {
 }
 
 export async function loadSubstackFeed(page: IPage, url: string, limit: number): Promise<any[]> {
-  if (!page) throw new Error('Requires browser session');
+  if (!page) throw new CommandExecutionError('Browser session required for substack feed');
   await page.goto(url);
   await page.wait(5);
   const data = await page.evaluate(`
@@ -76,7 +77,7 @@ export async function loadSubstackFeed(page: IPage, url: string, limit: number):
 }
 
 export async function loadSubstackArchive(page: IPage, baseUrl: string, limit: number): Promise<any[]> {
-  if (!page) throw new Error('Requires browser session');
+  if (!page) throw new CommandExecutionError('Browser session required for substack archive');
   await page.goto(`${baseUrl}/archive`);
   await page.wait(5);
   const data = await page.evaluate(`

package/src/clis/tiktok/search.yaml

@@ -35,6 +35,7 @@ pipeline:
             rank: idx + 1,
             desc: (v.desc || '').replace(/\n/g, ' ').substring(0, 100),
             author: a.uniqueId || '',
+            url: (a.uniqueId && v.id) ? 'https://www.tiktok.com/@' + a.uniqueId + '/video/' + v.id : '',
             plays: s.playCount || 0,
             likes: s.diggCount || 0,
             comments: s.commentCount || 0,
@@ -43,4 +44,4 @@ pipeline:
         });
       })()
 
-columns: [rank, desc, author, plays, likes, comments, shares]
+columns: [rank, desc, author, url, plays, likes, comments, shares]

package/src/clis/twitter/accept.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -15,7 +16,7 @@ cli({
   ],
   columns: ['index', 'status', 'user', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter accept');
 
     const keywords: string[] = kwargs.query.split(',').map((k: string) => k.trim()).filter(Boolean);
     const maxAccepts: number = kwargs.max ?? 20;

package/src/clis/twitter/article.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -153,7 +154,8 @@ cli({
     `);
 
     if (result?.error) {
-      throw new Error(result.error + (result.hint ? ` (${result.hint})` : ''));
+      if (String(result.error).includes('No ct0 cookie')) throw new AuthRequiredError('x.com', result.error);
+      throw new CommandExecutionError(result.error + (result.hint ? ` (${result.hint})` : ''));
     }
 
     return result || [];

package/src/clis/twitter/block.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter block');
     const username = kwargs.username.replace(/^@/, '');
 
     await page.goto(`https://x.com/${username}`);

package/src/clis/twitter/bookmark.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter bookmark');
 
     await page.goto(kwargs.url);
     await page.wait(5);

package/src/clis/twitter/bookmarks.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
 
 const BEARER_TOKEN = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
 const BOOKMARKS_QUERY_ID = 'Fy0QMy4q_aZCpkO0PnyLYw';
@@ -137,7 +138,7 @@ cli({
     const ct0 = await page.evaluate(`() => {
       return document.cookie.split(';').map(c => c.trim()).find(c => c.startsWith('ct0='))?.split('=')[1] || null;
     }`);
-    if (!ct0) throw new Error('Not logged into x.com (no ct0 cookie)');
+    if (!ct0) throw new AuthRequiredError('x.com', 'Not logged into x.com (no ct0 cookie)');
 
     const queryId = await page.evaluate(`async () => {
       try {
@@ -185,7 +186,7 @@ cli({
       }`);
 
       if (data?.error) {
-        if (allTweets.length === 0) throw new Error(`HTTP ${data.error}: Failed to fetch bookmarks. queryId may have expired.`);
+        if (allTweets.length === 0) throw new CommandExecutionError(`HTTP ${data.error}: Failed to fetch bookmarks. queryId may have expired.`);
         break;
       }
 

package/src/clis/twitter/delete.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter delete');
 
     await page.goto(kwargs.url);
     await page.wait(5); // Wait for tweet to load completely

package/src/clis/twitter/follow.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter follow');
     const username = kwargs.username.replace(/^@/, '');
 
     await page.goto(`https://x.com/${username}`);

package/src/clis/twitter/followers.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, SelectorError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -26,7 +27,7 @@ cli({
         }`);
 
         if (!href) {
-            throw new Error('Could not find logged-in user profile link. Are you logged in?');
+            throw new AuthRequiredError('x.com', 'Could not find logged-in user profile link. Are you logged in?');
         }
         targetUser = href.replace('/', '');
     }
@@ -55,7 +56,7 @@ cli({
         return false;
     }`);
     if (!clicked) {
-        throw new Error('Could not find followers link on profile page. Twitter may have changed the layout.');
+        throw new SelectorError('Twitter followers link', 'Twitter may have changed the layout.');
     }
     await page.wait(5);
 

package/src/clis/twitter/following.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, SelectorError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -26,7 +27,7 @@ cli({
         }`);
 
         if (!href) {
-            throw new Error('Could not find logged-in user profile link. Are you logged in?');
+            throw new AuthRequiredError('x.com', 'Could not find logged-in user profile link. Are you logged in?');
         }
         targetUser = href.replace('/', '');
     }
@@ -48,7 +49,7 @@ cli({
         return false;
     }`);
     if (!clicked) {
-        throw new Error('Could not find following link on profile page. Twitter may have changed the layout.');
+        throw new SelectorError('Twitter following link', 'Twitter may have changed the layout.');
     }
     await page.wait(5);
 

package/src/clis/twitter/hide-reply.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter hide-reply');
 
     await page.goto(kwargs.url);
     await page.wait(5);

package/src/clis/twitter/like.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter like');
 
     await page.goto(kwargs.url);
     await page.wait(5); // Wait for tweet to load completely

package/src/clis/twitter/notifications.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -29,7 +30,7 @@ cli({
     // Verify SPA navigation succeeded
     const currentUrl = await page.evaluate('() => window.location.pathname');
     if (currentUrl !== '/notifications') {
-        throw new Error('SPA navigation to notifications failed. Twitter may have changed its routing.');
+        throw new CommandExecutionError('SPA navigation to notifications failed. Twitter may have changed its routing.');
     }
 
     // 4. Scroll to trigger pagination

package/src/clis/twitter/post.ts

@@ -1,4 +1,5 @@
 import { cli, Strategy } from '../../registry.js';
+import { CommandExecutionError } from '../../errors.js';
 import type { IPage } from '../../types.js';
 
 cli({
@@ -13,7 +14,7 @@ cli({
   ],
   columns: ['status', 'message', 'text'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter post');
 
     // 1. Navigate directly to the compose tweet modal
     await page.goto('https://x.com/compose/tweet');

package/src/clis/twitter/profile.ts

@@ -1,3 +1,4 @@
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 
 cli({
@@ -22,7 +23,7 @@ cli({
         const link = document.querySelector('a[data-testid="AppTabBar_Profile_Link"]');
         return link ? link.getAttribute('href') : null;
       }`);
-      if (!href) throw new Error('Could not detect logged-in user. Are you logged in?');
+      if (!href) throw new AuthRequiredError('x.com', 'Could not detect logged-in user. Are you logged in?');
       username = href.replace('/', '');
     }
 
@@ -121,7 +122,8 @@ cli({
     `);
 
     if (result?.error) {
-      throw new Error(result.error + (result.hint ? ` (${result.hint})` : ''));
+      if (String(result.error).includes('No ct0 cookie')) throw new AuthRequiredError('x.com', result.error);
+      throw new CommandExecutionError(result.error + (result.hint ? ` (${result.hint})` : ''));
     }
 
     return result || [];

package/src/clis/twitter/reply-dm.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -16,7 +17,7 @@ cli({
   ],
   columns: ['index', 'status', 'user', 'message'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter reply-dm');
 
     const messageText: string = kwargs.text;
     const maxSend: number = kwargs.max ?? 20;

package/src/clis/twitter/reply.ts

@@ -1,3 +1,4 @@
+import { CommandExecutionError } from '../../errors.js';
 import { cli, Strategy } from '../../registry.js';
 import type { IPage } from '../../types.js';
 
@@ -14,7 +15,7 @@ cli({
   ],
   columns: ['status', 'message', 'text'],
   func: async (page: IPage | null, kwargs: any) => {
-    if (!page) throw new Error('Requires browser');
+    if (!page) throw new CommandExecutionError('Browser session required for twitter reply');
 
     // 1. Navigate to the tweet page
     await page.goto(kwargs.url);