@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/zhihu/write-shared.test.js

@@ -1,176 +0,0 @@
-import { mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import { describe, expect, it, vi } from 'vitest';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { __test__ } from './write-shared.js';
-class FakeNode {
-    attrs;
-    textContent;
-    hasAvatar;
-    constructor(attrs, textContent = null, hasAvatar = false) {
-        this.attrs = attrs;
-        this.textContent = textContent;
-        this.hasAvatar = hasAvatar;
-    }
-    getAttribute(name) {
-        return this.attrs[name] ?? null;
-    }
-    querySelector(selector) {
-        if (this.hasAvatar && selector.includes('img'))
-            return {};
-        return null;
-    }
-}
-class FakeRoot {
-    selectors;
-    constructor(selectors) {
-        this.selectors = selectors;
-    }
-    querySelectorAll(selector) {
-        return this.selectors[selector] ?? [];
-    }
-}
-function createPageForDom(documentRoot, state = undefined) {
-    return {
-        evaluate: vi.fn().mockImplementation(async (js) => {
-            const previousDocument = globalThis.document;
-            const previousWindow = globalThis.window;
-            const previousState = globalThis.__INITIAL_STATE__;
-            const windowObject = { __INITIAL_STATE__: state };
-            try {
-                Object.assign(globalThis, {
-                    document: documentRoot,
-                    window: windowObject,
-                    __INITIAL_STATE__: state,
-                });
-                return globalThis.eval(js);
-            }
-            finally {
-                Object.assign(globalThis, {
-                    document: previousDocument,
-                    window: previousWindow,
-                    __INITIAL_STATE__: previousState,
-                });
-            }
-        }),
-    };
-}
-describe('zhihu write shared helpers', () => {
-    it('rejects missing --execute', () => {
-        expect(() => __test__.requireExecute({})).toThrowError(CliError);
-    });
-    it('accepts a non-empty text payload', async () => {
-        await expect(__test__.resolvePayload({ text: 'hello' })).resolves.toBe('hello');
-    });
-    it('rejects whitespace-only payloads', async () => {
-        await expect(__test__.resolvePayload({ text: '   ' })).rejects.toMatchObject({ code: 'INVALID_INPUT' });
-    });
-    it('rejects missing file payloads as INVALID_INPUT', async () => {
-        await expect(__test__.resolvePayload({ file: join(tmpdir(), 'zhihu-write-shared-missing.txt') })).rejects.toMatchObject({
-            code: 'INVALID_INPUT',
-            message: expect.stringContaining('File not found'),
-        });
-    });
-    it('rejects invalid UTF-8 file payloads as INVALID_INPUT', async () => {
-        const dir = await mkdtemp(join(tmpdir(), 'zhihu-write-shared-'));
-        const file = join(dir, 'payload.txt');
-        await writeFile(file, Buffer.from([0xc3, 0x28]));
-        try {
-            await expect(__test__.resolvePayload({ file })).rejects.toMatchObject({
-                code: 'INVALID_INPUT',
-                message: expect.stringContaining('decoded as UTF-8'),
-            });
-        }
-        finally {
-            await rm(dir, { recursive: true, force: true });
-        }
-    });
-    it('rejects generic file read failures as INVALID_INPUT', async () => {
-        const dir = await mkdtemp(join(tmpdir(), 'zhihu-write-shared-'));
-        const file = join(dir, 'payload.txt');
-        await writeFile(file, 'hello');
-        try {
-            await expect(__test__.resolvePayload({ file }, {
-                stat: async () => ({ isFile: () => true }),
-                readFile: async () => {
-                    throw new Error('boom');
-                },
-                decodeUtf8: (raw) => new TextDecoder('utf-8', { fatal: true }).decode(raw),
-            })).rejects.toMatchObject({
-                code: 'INVALID_INPUT',
-                message: expect.stringContaining('could not be read'),
-            });
-        }
-        finally {
-            await rm(dir, { recursive: true, force: true });
-        }
-    });
-    it('prefers the state slug before DOM fallback', async () => {
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [],
-            'a[href^="/people/"]': [new FakeNode({ href: '/people/not-used', 'data-testid': 'profile-link' }, null, true)],
-        });
-        expect(__test__.resolveCurrentUserSlugFromDom({ me: { slug: 'alice' } }, documentRoot)).toBe('alice');
-    });
-    it('accepts nav avatar links as a conservative fallback', async () => {
-        const navRoot = new FakeRoot({
-            'a[href^="/people/"]': [new FakeNode({ href: '/people/alice' }, null, true)],
-        });
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [navRoot],
-            'a[href^="/people/"]': [],
-        });
-        expect(__test__.resolveCurrentUserSlugFromDom(undefined, documentRoot)).toBe('alice');
-    });
-    it('accepts document-wide fallback only for explicit account/profile signals', async () => {
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [],
-            'a[href^="/people/"]': [
-                new FakeNode({ href: '/people/alice', 'data-testid': 'account-profile-link' }),
-            ],
-        });
-        expect(__test__.resolveCurrentUserSlugFromDom(undefined, documentRoot)).toBe('alice');
-    });
-    it('does not accept a document-wide author avatar link as current-user fallback', async () => {
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [],
-            'a[href^="/people/"]': [new FakeNode({ href: '/people/author-1' }, 'Author', true)],
-        });
-        expect(__test__.resolveCurrentUserSlugFromDom(undefined, documentRoot)).toBeNull();
-    });
-    it('does not accept generic document metadata like user or dropdown alone', async () => {
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [],
-            'a[href^="/people/"]': [
-                new FakeNode({ href: '/people/author-1', 'data-testid': 'user-menu-dropdown' }, 'Author'),
-            ],
-        });
-        expect(__test__.resolveCurrentUserSlugFromDom(undefined, documentRoot)).toBeNull();
-    });
-    it('freezes a stable current-user identity before write', async () => {
-        const navRoot = new FakeRoot({
-            'a[href^="/people/"]': [new FakeNode({ href: '/people/alice' }, null, true)],
-        });
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [navRoot],
-            'a[href^="/people/"]': [],
-        });
-        const page = createPageForDom(documentRoot);
-        await expect(__test__.resolveCurrentUserIdentity(page)).resolves.toBe('alice');
-    });
-    it('rejects when current-user identity cannot be resolved', async () => {
-        const documentRoot = new FakeRoot({
-            'header, nav, [role="banner"], [role="navigation"]': [],
-            'a[href^="/people/"]': [],
-            'header img[alt*="\u4e3b\u9875"]': [],
-        });
-        const page = createPageForDom(documentRoot);
-        await expect(__test__.resolveCurrentUserIdentity(page)).rejects.toMatchObject({
-            code: 'ACTION_NOT_AVAILABLE',
-        });
-    });
-    it('rejects reserved buildResultRow extra keys', () => {
-        expect(() => __test__.buildResultRow('done', 'question', '123', 'applied', { status: 'oops' })).toThrowError(CliError);
-    });
-});

package/clis/zsxq/auth.js

@@ -1,68 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-// zsxq auth cookies are all httpOnly and span multiple subdomains
-// (wx.zsxq.com / api.zsxq.com / .zsxq.com), so document.cookie / cookie
-// probes are unreliable. Verify via a lightweight API 401 probe instead.
-async function verifyZsxqIdentity(page) {
-  await page.goto('https://wx.zsxq.com/');
-  await page.wait(2);
-  const probe = await page.evaluate(`
-    (async () => {
-      const url = location.href;
-      if (/\\/login(\\b|$)/.test(url)) {
-        return { kind: 'auth', detail: 'zsxq wx page redirected to /login — anonymous session' };
-      }
-      try {
-        const r = await fetch('https://api.zsxq.com/v2/users/self', {
-          credentials: 'include',
-          headers: { Accept: 'application/json' },
-        });
-        if (r.status === 401 || r.status === 403) {
-          return { kind: 'auth', detail: 'zsxq /v2/users/self returned HTTP ' + r.status };
-        }
-        if (!r.ok) return { kind: 'http', httpStatus: r.status };
-        const d = await r.json();
-        if (d?.succeeded === false || !d?.resp_data?.user) {
-          return { kind: 'auth', detail: 'zsxq /v2/users/self returned succeeded=false — anonymous' };
-        }
-        const u = d.resp_data.user;
-        return { ok: true, user_id: String(u.user_id || u.id || ''), name: String(u.name || u.nickname || '') };
-      } catch (e) {
-        return { kind: 'exception', detail: String(e && e.message || e) };
-      }
-    })()
-  `);
-  if (probe?.kind === 'auth') throw new AuthRequiredError('zsxq.com', probe.detail);
-  if (probe?.kind === 'http') throw new CommandExecutionError(`HTTP ${probe.httpStatus} from zsxq /v2/users/self`);
-  if (probe?.kind === 'exception') throw new CommandExecutionError(`zsxq whoami failed: ${probe.detail}`);
-  if (!probe?.ok) throw new CommandExecutionError(`Unexpected zsxq probe: ${JSON.stringify(probe)}`);
-  if (!probe.user_id) {
-    throw new AuthRequiredError('zsxq.com', 'zsxq /v2/users/self 200 but user_id missing — incomplete session');
-  }
-  return { user_id: probe.user_id, name: probe.name };
-}
-
-registerSiteAuthCommands({
-  site: 'zsxq',
-  domain: 'zsxq.com',
-  loginUrl: 'https://wx.zsxq.com/login',
-  columns: ['user_id', 'name'],
-  verify: verifyZsxqIdentity,
-  // No-navigation poll: probe the API from the current page so the login-page
-  // QR code isn't reset by a goto on every interval.
-  poll: async (page) => {
-    const loggedIn = await page.evaluate(`(async () => {
-      try {
-        const r = await fetch('https://api.zsxq.com/v2/users/self', { credentials: 'include', headers: { Accept: 'application/json' } });
-        if (!r.ok) return false;
-        const d = await r.json();
-        return !!(d?.resp_data?.user);
-      } catch { return false; }
-    })()`);
-    if (!loggedIn) {
-      throw new AuthRequiredError('zsxq.com', 'Waiting for zsxq login');
-    }
-    return verifyZsxqIdentity(page);
-  },
-});

package/clis/zsxq/dynamics.js

@@ -1,48 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicText, getTopicAuthor, getTopicUrl, } from './utils.js';
-cli({
-    site: 'zsxq',
-    name: 'dynamics',
-    access: 'read',
-    description: '获取所有星球的最新动态',
-    domain: 'wx.zsxq.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of dynamics to return' },
-    ],
-    columns: ['time', 'group', 'author', 'title', 'comments', 'likes', 'url'],
-    func: async (page, kwargs) => {
-        await ensureZsxqPage(page);
-        await ensureZsxqAuth(page);
-        const limit = Math.max(1, Number(kwargs.limit) || 20);
-        const { data } = await fetchFirstJson(page, [
-            `https://api.zsxq.com/v2/dynamics?scope=general&count=${limit}`,
-        ]);
-        const respData = data?.resp_data || data;
-        const dynamics = respData?.dynamics || [];
-        return dynamics.slice(0, limit).map((d) => {
-            const topic = d.topic;
-            if (!topic) {
-                return {
-                    time: d.create_time || '',
-                    group: '',
-                    author: '',
-                    title: `[${d.action || 'unknown'}]`,
-                    comments: 0,
-                    likes: 0,
-                    url: '',
-                };
-            }
-            return {
-                time: d.create_time || topic.create_time || '',
-                group: topic.group?.name || '',
-                author: getTopicAuthor(topic),
-                title: getTopicText(topic),
-                comments: topic.comments_count ?? 0,
-                likes: topic.likes_count ?? 0,
-                url: getTopicUrl(topic.topic_id),
-            };
-        });
-    },
-});

package/clis/zsxq/groups.js

@@ -1,33 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, } from './utils.js';
-cli({
-    site: 'zsxq',
-    name: 'groups',
-    access: 'read',
-    description: '列出当前账号加入的星球',
-    domain: 'wx.zsxq.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 50, help: 'Number of groups to return' },
-    ],
-    columns: ['group_id', 'name', 'category', 'members', 'topics', 'joined_at', 'url'],
-    func: async (page, kwargs) => {
-        await ensureZsxqPage(page);
-        await ensureZsxqAuth(page);
-        const limit = Math.max(1, Number(kwargs.limit) || 50);
-        const { data } = await fetchFirstJson(page, [
-            `https://api.zsxq.com/v2/groups`,
-        ]);
-        return getGroupsFromResponse(data).slice(0, limit).map((group) => ({
-            group_id: group.group_id ?? '',
-            name: group.name || '',
-            category: group.category?.title || '',
-            members: group.statistics?.subscriptions_count ?? 0,
-            topics: group.statistics?.topics_count ?? 0,
-            joined_at: group.user_specific?.join_time || '',
-            valid_until: group.user_specific?.validity?.end_time || '',
-            url: group.group_id ? `https://wx.zsxq.com/group/${group.group_id}` : 'https://wx.zsxq.com',
-        }));
-    },
-});

package/clis/zsxq/search.js

@@ -1,44 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, getTopicsFromResponse, toTopicRow, } from './utils.js';
-cli({
-    site: 'zsxq',
-    name: 'search',
-    access: 'read',
-    description: '搜索星球内容',
-    domain: 'wx.zsxq.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'keyword', required: true, positional: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results to return' },
-        { name: 'group_id', help: 'Optional group id; defaults to the active group in Chrome' },
-    ],
-    columns: ['topic_id', 'group', 'author', 'title', 'comments', 'likes', 'time', 'url'],
-    func: async (page, kwargs) => {
-        await ensureZsxqPage(page);
-        await ensureZsxqAuth(page);
-        const keyword = String(kwargs.keyword || '').trim();
-        const limit = Math.max(1, Number(kwargs.limit) || 20);
-        const groupId = String(kwargs.group_id || await getActiveGroupId(page));
-        const query = encodeURIComponent(keyword);
-        // Resolve group name from groups API
-        let groupName = groupId;
-        try {
-            const { data: groupsData } = await fetchFirstJson(page, [
-                `https://api.zsxq.com/v2/groups`,
-            ]);
-            const groups = getGroupsFromResponse(groupsData);
-            const found = groups.find(g => String(g.group_id) === groupId);
-            if (found?.name)
-                groupName = found.name;
-        }
-        catch { /* ignore */ }
-        const { data } = await fetchFirstJson(page, [
-            `https://api.zsxq.com/v2/search/groups/${groupId}/topics?keyword=${query}&count=${limit}`,
-        ]);
-        return getTopicsFromResponse(data).slice(0, limit).map((topic) => ({
-            ...toTopicRow(topic),
-            group: groupName,
-        }));
-    },
-});

package/clis/zsxq/search.test.js

@@ -1,24 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './search.js';
-describe('zsxq search command', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('requires an explicit group_id when there is no active group context', async () => {
-        const command = getRegistry().get('zsxq/search');
-        expect(command?.func).toBeTypeOf('function');
-        const mockPage = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(true)
-                .mockResolvedValueOnce(null),
-        };
-        await expect(command.func(mockPage, { keyword: 'webcmd', limit: 20 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: 'Cannot determine active group_id',
-        });
-        expect(mockPage.goto).toHaveBeenCalledWith('https://wx.zsxq.com');
-        expect(mockPage.evaluate).toHaveBeenCalledTimes(2);
-    });
-});

package/clis/zsxq/topic.js

@@ -1,50 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { getActiveGroupId, browserJsonRequest, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getCommentsFromResponse, getTopicFromResponse, getTopicUrl, summarizeComments, toTopicRow, } from './utils.js';
-cli({
-    site: 'zsxq',
-    name: 'topic',
-    access: 'read',
-    description: '获取单个话题详情和评论',
-    domain: 'wx.zsxq.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'id', required: true, positional: true, help: 'Topic ID' },
-        { name: 'group_id', help: 'Group ID (optional; defaults to active group in Chrome)' },
-        { name: 'comment_limit', type: 'int', default: 20, help: 'Number of comments to fetch' },
-    ],
-    columns: ['topic_id', 'type', 'author', 'title', 'comments', 'likes', 'comment_preview', 'url'],
-    func: async (page, kwargs) => {
-        await ensureZsxqPage(page);
-        await ensureZsxqAuth(page);
-        const topicId = String(kwargs.id);
-        const groupId = String(kwargs.group_id || await getActiveGroupId(page));
-        const commentLimit = Math.max(1, Number(kwargs.comment_limit) || 20);
-        const detailUrl = `https://api.zsxq.com/v2/groups/${groupId}/topics/${topicId}`;
-        const detailResp = await browserJsonRequest(page, detailUrl);
-        if (detailResp.status === 404) {
-            throw new CliError('NOT_FOUND', `Topic ${topicId} not found`);
-        }
-        if (!detailResp.ok) {
-            throw new CliError('FETCH_ERROR', detailResp.error || `Failed to fetch topic ${topicId}`, `Checked endpoint: ${detailUrl}`);
-        }
-        const commentsResp = await fetchFirstJson(page, [
-            `https://api.zsxq.com/v2/groups/${groupId}/topics/${topicId}/comments?sort=asc&count=${commentLimit}`,
-        ]);
-        const topic = getTopicFromResponse(detailResp.data);
-        if (!topic)
-            throw new CliError('NOT_FOUND', `Topic ${topicId} not found`);
-        const comments = getCommentsFromResponse(commentsResp.data);
-        const row = toTopicRow({
-            ...topic,
-            comments,
-            comments_count: topic.comments_count ?? comments.length,
-        });
-        return [{
-                ...row,
-                comment_preview: summarizeComments(comments, 5),
-                url: getTopicUrl(topic.topic_id ?? topicId),
-            }];
-    },
-});

package/clis/zsxq/topic.test.js

@@ -1,30 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './topic.js';
-describe('zsxq topic command', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('maps topic detail 404 responses to NOT_FOUND before fetching comments', async () => {
-        const command = getRegistry().get('zsxq/topic');
-        expect(command?.func).toBeTypeOf('function');
-        const mockPage = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(true) // ensureZsxqAuth
-                .mockResolvedValueOnce('12345') // getActiveGroupId
-                .mockResolvedValueOnce({
-                ok: true,
-                status: 404,
-                url: 'https://api.zsxq.com/v2/groups/12345/topics/404',
-                data: null,
-            }),
-        };
-        await expect(command.func(mockPage, { id: '404', comment_limit: 20 })).rejects.toMatchObject({
-            code: 'NOT_FOUND',
-            message: 'Topic 404 not found',
-        });
-        expect(mockPage.goto).toHaveBeenCalledWith('https://wx.zsxq.com');
-        expect(mockPage.evaluate).toHaveBeenCalledTimes(3);
-    });
-});

package/clis/zsxq/topics.js

@@ -1,26 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicsFromResponse, toTopicRow, } from './utils.js';
-cli({
-    site: 'zsxq',
-    name: 'topics',
-    access: 'read',
-    description: '获取当前星球的话题列表',
-    domain: 'wx.zsxq.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of topics to return' },
-        { name: 'group_id', help: 'Optional group id; defaults to the active group in Chrome' },
-    ],
-    columns: ['topic_id', 'type', 'author', 'title', 'comments', 'likes', 'time', 'url'],
-    func: async (page, kwargs) => {
-        await ensureZsxqPage(page);
-        await ensureZsxqAuth(page);
-        const limit = Math.max(1, Number(kwargs.limit) || 20);
-        const groupId = String(kwargs.group_id || await getActiveGroupId(page));
-        const { data } = await fetchFirstJson(page, [
-            `https://api.zsxq.com/v2/groups/${groupId}/topics?scope=all&count=${limit}`,
-        ]);
-        return getTopicsFromResponse(data).slice(0, limit).map(toTopicRow);
-    },
-});

package/clis/zsxq/topics.test.js

@@ -1,24 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './topics.js';
-describe('zsxq topics command', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('requires an explicit group_id when there is no active group context', async () => {
-        const command = getRegistry().get('zsxq/topics');
-        expect(command?.func).toBeTypeOf('function');
-        const mockPage = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn()
-                .mockResolvedValueOnce(true)
-                .mockResolvedValueOnce(null),
-        };
-        await expect(command.func(mockPage, { limit: 20 })).rejects.toMatchObject({
-            code: 'ARGUMENT',
-            message: 'Cannot determine active group_id',
-        });
-        expect(mockPage.goto).toHaveBeenCalledWith('https://wx.zsxq.com');
-        expect(mockPage.evaluate).toHaveBeenCalledTimes(2);
-    });
-});