@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/xiaoyuzhou/podcast-episodes.js

@@ -1,41 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { loadXiaoyuzhouCredentials, requestXiaoyuzhouJson } from './auth.js';
-import { formatDuration, formatDate } from './utils.js';
-cli({
-    site: 'xiaoyuzhou',
-    name: 'podcast-episodes',
-    access: 'read',
-    description: 'List episodes of a Xiaoyuzhou podcast',
-    domain: 'www.xiaoyuzhoufm.com',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'Podcast ID (from xiaoyuzhoufm.com URL)' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max episodes to show' },
-    ],
-    columns: ['eid', 'title', 'duration', 'plays', 'date'],
-    func: async (args) => {
-        const requestedLimit = Number(args.limit);
-        if (!Number.isInteger(requestedLimit) || requestedLimit < 1) {
-            throw new CliError('INVALID_ARGUMENT', 'limit must be a positive integer', 'Example: --limit 5');
-        }
-        const credentials = loadXiaoyuzhouCredentials();
-        const response = await requestXiaoyuzhouJson('/v1/episode/list', {
-            method: 'POST',
-            body: { pid: args.id, order: 'desc', limit: requestedLimit },
-            credentials,
-        });
-        const episodes = response.data ?? [];
-        if (!Array.isArray(episodes)) {
-            throw new CliError('PARSE_ERROR', 'Unexpected API response format', 'Expected an array of episodes');
-        }
-        return episodes.map((ep) => ({
-            eid: ep.eid,
-            title: ep.title,
-            duration: formatDuration(ep.duration),
-            plays: ep.playCount,
-            date: formatDate(ep.pubDate),
-        }));
-    },
-});

package/clis/xiaoyuzhou/podcast-episodes.test.js

@@ -1,78 +0,0 @@
-import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-
-const { mockRequestJson, mockLoadCredentials } = vi.hoisted(() => ({
-    mockRequestJson: vi.fn(),
-    mockLoadCredentials: vi.fn(),
-}));
-
-vi.mock('./auth.js', async () => {
-    const actual = await vi.importActual('./auth.js');
-    return {
-        ...actual,
-        requestXiaoyuzhouJson: mockRequestJson,
-        loadXiaoyuzhouCredentials: mockLoadCredentials,
-    };
-});
-
-await import('./podcast-episodes.js');
-
-let cmd;
-
-beforeAll(() => {
-    cmd = getRegistry().get('xiaoyuzhou/podcast-episodes');
-    expect(cmd?.func).toBeTypeOf('function');
-});
-
-describe('xiaoyuzhou podcast-episodes', () => {
-    beforeEach(() => {
-        mockRequestJson.mockReset();
-        mockLoadCredentials.mockReset();
-        mockLoadCredentials.mockReturnValue({ access_token: 'access', refresh_token: 'refresh' });
-    });
-
-    it('calls the fixed episode list endpoint with desc ordering', async () => {
-        mockRequestJson.mockResolvedValue({
-            data: [
-                {
-                    eid: 'ep-1',
-                    title: 'Episode 1',
-                    duration: 3661,
-                    playCount: 42,
-                    pubDate: '2026-04-20T10:00:00.000Z',
-                },
-            ],
-        });
-
-        const result = await cmd.func({
-            id: 'podcast-1',
-            limit: 3,
-        });
-
-        expect(mockRequestJson).toHaveBeenCalledWith('/v1/episode/list', {
-            method: 'POST',
-            body: { pid: 'podcast-1', order: 'desc', limit: 3 },
-            credentials: { access_token: 'access', refresh_token: 'refresh' },
-        });
-        expect(result).toEqual([
-            {
-                eid: 'ep-1',
-                title: 'Episode 1',
-                duration: '61:01',
-                plays: 42,
-                date: '2026-04-20',
-            },
-        ]);
-    });
-
-    it('rejects non-positive limits before hitting the API', async () => {
-        await expect(cmd.func({
-            id: 'podcast-1',
-            limit: 0,
-        })).rejects.toMatchObject({
-            code: 'INVALID_ARGUMENT',
-            message: 'limit must be a positive integer',
-        });
-        expect(mockRequestJson).not.toHaveBeenCalled();
-    });
-});

package/clis/xiaoyuzhou/podcast.js

@@ -1,33 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { loadXiaoyuzhouCredentials, requestXiaoyuzhouJson } from './auth.js';
-import { formatDate } from './utils.js';
-cli({
-    site: 'xiaoyuzhou',
-    name: 'podcast',
-    access: 'read',
-    description: 'View a Xiaoyuzhou podcast profile',
-    domain: 'www.xiaoyuzhoufm.com',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [{ name: 'id', positional: true, required: true, help: 'Podcast ID (from xiaoyuzhoufm.com URL)' }],
-    columns: ['title', 'author', 'description', 'subscribers', 'episodes', 'updated'],
-    func: async (args) => {
-        const credentials = loadXiaoyuzhouCredentials();
-        const response = await requestXiaoyuzhouJson('/v1/podcast/get', {
-            query: { pid: args.id },
-            credentials,
-        });
-        const p = response.data;
-        if (!p)
-            throw new CliError('NOT_FOUND', 'Podcast not found', 'Please check the ID');
-        return [{
-                title: p.title,
-                author: p.author,
-                description: p.brief,
-                subscribers: p.subscriptionCount,
-                episodes: p.episodeCount,
-                updated: formatDate(p.latestEpisodePubDate),
-            }];
-    },
-});

package/clis/xiaoyuzhou/transcript.js

@@ -1,77 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ArgumentError, CliError } from '@agentrhq/webcmd/errors';
-import { loadXiaoyuzhouCredentials, requestXiaoyuzhouJson, fetchXiaoyuzhouTranscriptBody, extractTranscriptText } from './auth.js';
-
-cli({
-    site: 'xiaoyuzhou',
-    name: 'transcript',
-    access: 'read',
-    description: 'Download Xiaoyuzhou transcript as JSON and text (requires local credentials)',
-    domain: 'www.xiaoyuzhoufm.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'Episode ID (eid from podcast-episodes output)' },
-        { name: 'output', default: './xiaoyuzhou-transcripts', help: 'Output directory' },
-        { name: 'json', type: 'boolean', default: true, help: 'Save transcript JSON file' },
-        { name: 'text', type: 'boolean', default: true, help: 'Save extracted transcript text file' },
-    ],
-    columns: ['title', 'podcast', 'status', 'segments', 'json_file', 'text_file'],
-    func: async (kwargs) => {
-        if (kwargs.json === false && kwargs.text === false) {
-            throw new ArgumentError('At least one of --json or --text must be enabled', 'Example: webcmd xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --text true');
-        }
-        let credentials = loadXiaoyuzhouCredentials();
-        const episodeResponse = await requestXiaoyuzhouJson('/v1/episode/get', {
-            query: { eid: kwargs.id },
-            credentials,
-        });
-        credentials = episodeResponse.credentials;
-        const episode = episodeResponse.data;
-        if (!episode) {
-            throw new CliError('NOT_FOUND', 'Episode not found', 'Please check the episode ID');
-        }
-        const mediaId = String(episode.transcript?.mediaId || episode.media?.id || episode.transcriptMediaId || '').trim();
-        if (!mediaId) {
-            throw new CliError('PARSE_ERROR', 'mediaId not found in episode payload', 'Transcript metadata requires episode.transcript.mediaId, episode.media.id, or episode.transcriptMediaId');
-        }
-        const transcriptResponse = await requestXiaoyuzhouJson('/v1/episode-transcript/get', {
-            method: 'POST',
-            body: {
-                eid: kwargs.id,
-                mediaId,
-            },
-            credentials,
-        });
-        const transcriptMeta = transcriptResponse.data;
-        const transcriptUrl = String(transcriptMeta?.transcriptUrl || transcriptMeta?.url || '').trim();
-        if (!transcriptUrl) {
-            throw new CliError('EMPTY_RESULT', 'Transcript URL not found', 'This episode may not have transcript data available');
-        }
-        const transcriptBody = await fetchXiaoyuzhouTranscriptBody(transcriptUrl);
-        const { text, segmentCount } = extractTranscriptText(transcriptBody);
-        if (kwargs.text !== false && transcriptBody.trim() && !text.trim()) {
-            throw new CliError('PARSE_ERROR', 'Failed to extract transcript text', 'Transcript payload format is unsupported. Re-run with --json true to inspect the raw payload.');
-        }
-        const outputDir = path.join(String(kwargs.output || './xiaoyuzhou-transcripts'), String(kwargs.id));
-        fs.mkdirSync(outputDir, { recursive: true });
-        const jsonPath = path.join(outputDir, 'transcript.json');
-        const textPath = path.join(outputDir, 'transcript.txt');
-        if (kwargs.json !== false) {
-            fs.writeFileSync(jsonPath, transcriptBody, 'utf-8');
-        }
-        if (kwargs.text !== false) {
-            fs.writeFileSync(textPath, text, 'utf-8');
-        }
-        return [{
-                title: episode.title || 'episode',
-                podcast: episode.podcast?.title || '',
-                status: 'success',
-                segments: kwargs.text === false ? '-' : String(segmentCount),
-                json_file: kwargs.json === false ? '-' : jsonPath,
-                text_file: kwargs.text === false ? '-' : textPath,
-            }];
-    },
-});

package/clis/xiaoyuzhou/transcript.test.js

@@ -1,195 +0,0 @@
-import path from 'node:path';
-import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-
-const { mockLoadCredentials, mockRequestJson, mockFetchTranscriptBody, mockMkdirSync, mockWriteFileSync } = vi.hoisted(() => ({
-    mockLoadCredentials: vi.fn(),
-    mockRequestJson: vi.fn(),
-    mockFetchTranscriptBody: vi.fn(),
-    mockMkdirSync: vi.fn(),
-    mockWriteFileSync: vi.fn(),
-}));
-
-vi.mock('./auth.js', async () => {
-    const actual = await vi.importActual('./auth.js');
-    return {
-        ...actual,
-        loadXiaoyuzhouCredentials: mockLoadCredentials,
-        requestXiaoyuzhouJson: mockRequestJson,
-        fetchXiaoyuzhouTranscriptBody: mockFetchTranscriptBody,
-    };
-});
-
-vi.mock('node:fs', () => ({
-    mkdirSync: mockMkdirSync,
-    writeFileSync: mockWriteFileSync,
-}));
-
-await import('./transcript.js');
-
-let cmd;
-
-function toPosixPath(value) {
-    return value.replaceAll(path.sep, '/');
-}
-
-beforeAll(() => {
-    cmd = getRegistry().get('xiaoyuzhou/transcript');
-    expect(cmd?.func).toBeTypeOf('function');
-});
-
-describe('xiaoyuzhou transcript', () => {
-    beforeEach(() => {
-        mockLoadCredentials.mockReset();
-        mockRequestJson.mockReset();
-        mockFetchTranscriptBody.mockReset();
-        mockMkdirSync.mockReset();
-        mockWriteFileSync.mockReset();
-        mockLoadCredentials.mockReturnValue({ access_token: 'access', refresh_token: 'refresh' });
-    });
-
-    it('downloads transcript json and extracted text files', async () => {
-        mockRequestJson
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                title: 'Transcript Episode',
-                podcast: { title: 'Webcmd FM' },
-                transcript: { mediaId: 'media-123' },
-            },
-        })
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                transcriptUrl: 'https://cdn.example.com/transcript.json',
-            },
-        });
-        mockFetchTranscriptBody.mockResolvedValue(JSON.stringify({
-            segments: [{ text: 'hello' }, { text: 'world' }],
-        }));
-        const result = await cmd.func({
-            id: 'ep123',
-            output: '/tmp/xiaoyuzhou-transcripts',
-            json: true,
-            text: true,
-        });
-        expect(mockRequestJson).toHaveBeenNthCalledWith(1, '/v1/episode/get', {
-            query: { eid: 'ep123' },
-            credentials: { access_token: 'access', refresh_token: 'refresh' },
-        });
-        expect(mockRequestJson).toHaveBeenNthCalledWith(2, '/v1/episode-transcript/get', {
-            method: 'POST',
-            body: { eid: 'ep123', mediaId: 'media-123' },
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-        });
-        expect(mockMkdirSync).toHaveBeenCalledWith('/tmp/xiaoyuzhou-transcripts/ep123', { recursive: true });
-        expect(mockWriteFileSync).toHaveBeenNthCalledWith(1, '/tmp/xiaoyuzhou-transcripts/ep123/transcript.json', expect.any(String), 'utf-8');
-        expect(mockWriteFileSync).toHaveBeenNthCalledWith(2, '/tmp/xiaoyuzhou-transcripts/ep123/transcript.txt', 'hello\nworld', 'utf-8');
-        expect(result).toEqual([{
-                title: 'Transcript Episode',
-                podcast: 'Webcmd FM',
-                status: 'success',
-                segments: '2',
-                json_file: '/tmp/xiaoyuzhou-transcripts/ep123/transcript.json',
-                text_file: '/tmp/xiaoyuzhou-transcripts/ep123/transcript.txt',
-            }]);
-    });
-
-    it('derives mediaId from episode.media.id when transcript.mediaId is absent', async () => {
-        mockRequestJson
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                title: 'Transcript Episode',
-                podcast: { title: 'Webcmd FM' },
-                media: { id: 'media-456' },
-            },
-        })
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                transcriptUrl: 'https://cdn.example.com/transcript.json',
-            },
-        });
-        mockFetchTranscriptBody.mockResolvedValue(JSON.stringify({ text: 'hello' }));
-        await cmd.func({
-            id: 'ep456',
-            output: '/tmp/xiaoyuzhou-transcripts',
-            json: false,
-            text: true,
-        });
-        expect(mockRequestJson.mock.calls[1][1].body.mediaId).toBe('media-456');
-        expect(mockWriteFileSync).toHaveBeenCalledTimes(1);
-        expect(mockWriteFileSync).toHaveBeenCalledWith('/tmp/xiaoyuzhou-transcripts/ep456/transcript.txt', 'hello', 'utf-8');
-    });
-
-    it('throws when transcript url is missing', async () => {
-        mockRequestJson
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                title: 'Transcript Episode',
-                podcast: { title: 'Webcmd FM' },
-                transcript: { mediaId: 'media-123' },
-            },
-        })
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {},
-        });
-        await expect(cmd.func({
-            id: 'ep123',
-            output: '/tmp/xiaoyuzhou-transcripts',
-            json: true,
-            text: true,
-        })).rejects.toMatchObject({
-            code: 'EMPTY_RESULT',
-            message: 'Transcript URL not found',
-        });
-        expect(mockWriteFileSync).not.toHaveBeenCalled();
-    });
-
-    it('throws parse_error when transcript text extraction fails', async () => {
-        mockRequestJson
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                title: 'Transcript Episode',
-                podcast: { title: 'Webcmd FM' },
-                transcript: { mediaId: 'media-123' },
-            },
-        })
-            .mockResolvedValueOnce({
-            credentials: { access_token: 'access-1', refresh_token: 'refresh-1' },
-            data: {
-                transcriptUrl: 'https://cdn.example.com/transcript.json',
-            },
-        });
-        mockFetchTranscriptBody.mockResolvedValue(JSON.stringify({
-            segments: [{ startAt: 0, endAt: 1 }],
-        }));
-        await expect(cmd.func({
-            id: 'ep123',
-            output: '/tmp/xiaoyuzhou-transcripts',
-            json: true,
-            text: true,
-        })).rejects.toMatchObject({
-            code: 'PARSE_ERROR',
-            message: 'Failed to extract transcript text',
-        });
-        expect(mockWriteFileSync).not.toHaveBeenCalled();
-    });
-
-    it('rejects disabling both json and text outputs', async () => {
-        await expect(cmd.func({
-            id: 'ep123',
-            output: '/tmp/xiaoyuzhou-transcripts',
-            json: false,
-            text: false,
-        })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: 'At least one of --json or --text must be enabled',
-        });
-        expect(mockRequestJson).not.toHaveBeenCalled();
-    });
-});

package/clis/xiaoyuzhou/utils.js

@@ -1,15 +0,0 @@
-/** Format seconds to mm:ss (e.g. 3890 → "64:50"). Returns '-' for invalid input. */
-export function formatDuration(seconds) {
-    if (!Number.isFinite(seconds) || seconds < 0)
-        return '-';
-    seconds = Math.round(seconds);
-    const m = Math.floor(seconds / 60);
-    const s = seconds % 60;
-    return `${m}:${String(s).padStart(2, '0')}`;
-}
-/** Format ISO date string to YYYY-MM-DD. Returns '-' for missing input. */
-export function formatDate(iso) {
-    if (!iso)
-        return '-';
-    return iso.slice(0, 10);
-}

package/clis/xiaoyuzhou/utils.test.js

@@ -1,39 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { formatDuration, formatDate } from './utils.js';
-describe('formatDuration', () => {
-    it('formats typical duration', () => {
-        expect(formatDuration(3890)).toBe('64:50');
-    });
-    it('formats zero seconds', () => {
-        expect(formatDuration(0)).toBe('0:00');
-    });
-    it('pads single-digit seconds', () => {
-        expect(formatDuration(62)).toBe('1:02');
-    });
-    it('handles exact minutes', () => {
-        expect(formatDuration(120)).toBe('2:00');
-    });
-    it('rounds fractional seconds', () => {
-        expect(formatDuration(65.7)).toBe('1:06');
-    });
-    it('returns dash for NaN', () => {
-        expect(formatDuration(NaN)).toBe('-');
-    });
-    it('returns dash for negative', () => {
-        expect(formatDuration(-1)).toBe('-');
-    });
-    it('returns dash for Infinity', () => {
-        expect(formatDuration(Infinity)).toBe('-');
-    });
-});
-describe('formatDate', () => {
-    it('slices ISO string to date', () => {
-        expect(formatDate('2026-03-15T12:00:00Z')).toBe('2026-03-15');
-    });
-    it('returns dash for empty string', () => {
-        expect(formatDate('')).toBe('-');
-    });
-    it('returns dash for undefined', () => {
-        expect(formatDate(undefined)).toBe('-');
-    });
-});

package/clis/xueqiu/auth.js

@@ -1,63 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasXueqiuAccessToken(page) {
-  const cookies = await page.getCookies({ url: 'https://xueqiu.com' });
-  return cookies.some(c => c.name === 'xq_a_token' && c.value);
-}
-
-async function verifyXueqiuIdentity(page) {
-  if (!await hasXueqiuAccessToken(page)) {
-    throw new AuthRequiredError('xueqiu.com', 'Xueqiu xq_a_token cookie missing — anonymous');
-  }
-  await page.goto('https://xueqiu.com/');
-  await page.wait(2);
-  const probe = await page.evaluate(`(async () => {
-    try {
-      const res = await fetch(
-        'https://stock.xueqiu.com/v5/stock/portfolio/stock/list.json?size=1&category=1&pid=-1',
-        { credentials: 'include' },
-      );
-      if (res.status === 403) {
-        return { kind: 'http', httpStatus: 403, detail: 'xueqiu stock API 403 — anti-bot / rate limit' };
-      }
-      if (!res.ok) return { kind: 'http', httpStatus: res.status };
-      const d = await res.json();
-      if (d?.error_code === 60201) {
-        return { kind: 'auth', detail: 'xueqiu portfolio API error_code 60201 用户id无效 — anonymous' };
-      }
-      if (d?.error_code) {
-        return { kind: 'xq-error', errorCode: d.error_code, detail: d.error_description || 'xueqiu API error' };
-      }
-      const uCookie = document.cookie.split('; ').find(c => c.startsWith('u='))?.split('=')[1] || '';
-      const cookiesuCookie = document.cookie.split('; ').find(c => c.startsWith('cookiesu='))?.split('=')[1] || '';
-      if (!uCookie || uCookie === cookiesuCookie) {
-        return { kind: 'auth', detail: 'xueqiu u cookie equals cookiesu (device id) — anonymous despite portfolio API 200' };
-      }
-      return { ok: true, user_id: uCookie };
-    } catch (e) {
-      return { kind: 'exception', detail: String(e && e.message || e) };
-    }
-  })()`);
-  if (probe?.kind === 'auth') throw new AuthRequiredError('xueqiu.com', probe.detail);
-  if (probe?.kind === 'http') throw new CommandExecutionError(`HTTP ${probe.httpStatus} from xueqiu stock API: ${probe.detail || ''}`);
-  if (probe?.kind === 'xq-error') throw new CommandExecutionError(`xueqiu API error_code ${probe.errorCode}: ${probe.detail}`);
-  if (probe?.kind === 'exception') throw new CommandExecutionError(`xueqiu whoami failed: ${probe.detail}`);
-  if (!probe?.ok) throw new CommandExecutionError(`Unexpected xueqiu probe: ${JSON.stringify(probe)}`);
-  return { user_id: String(probe.user_id) };
-}
-
-registerSiteAuthCommands({
-  site: 'xueqiu',
-  domain: 'xueqiu.com',
-  loginUrl: 'https://xueqiu.com/',
-  columns: ['user_id'],
-  quickCheck: hasXueqiuAccessToken,
-  verify: verifyXueqiuIdentity,
-  poll: async (page) => {
-    if (!await hasXueqiuAccessToken(page)) {
-      throw new AuthRequiredError('xueqiu.com', 'Waiting for Xueqiu xq_a_token cookie');
-    }
-    return verifyXueqiuIdentity(page);
-  },
-});