@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/ones/common.js

@@ -1,144 +0,0 @@
-/**
- * ONES 旧版 Project API — 经 Browser Bridge 在已登录标签页内 fetch（携带 Cookie）。
- * 文档：https://developer.ones.cn/zh-CN/docs/api/readme/
- */
-import { CliError } from '@agentrhq/webcmd/errors';
-export const API_PREFIX = '/project/api/project';
-export function getOnesBaseUrl() {
-    const u = process.env.ONES_BASE_URL?.trim().replace(/\/+$/, '');
-    if (!u) {
-        throw new CliError('CONFIG', 'Missing ONES_BASE_URL', 'Set ONES_BASE_URL to your deployment origin, e.g. https://your-team.ones.cn (no trailing slash).');
-    }
-    return u;
-}
-export function onesApiUrl(apiPath) {
-    const base = getOnesBaseUrl();
-    const p = apiPath.replace(/^\/+/, '');
-    return `${base}${API_PREFIX}/${p}`;
-}
-/** 打开 ONES 根地址，确保后续 fetch 与页面同源、带上登录 Cookie */
-export async function gotoOnesHome(page) {
-    await page.goto(getOnesBaseUrl(), { waitUntil: 'load' });
-    await page.wait(2);
-}
-/**
- * 在页面内发起请求。默认带 credentials；若设置了 ONES_USER_ID + ONES_AUTH_TOKEN，则附加文档要求的 Header（与纯 Cookie 二选一或并存，取决于部署）。
- */
-function buildHeaders(auth, includeJsonContentType) {
-    const ref = getOnesBaseUrl();
-    const out = { Referer: ref };
-    if (auth) {
-        const uid = process.env.ONES_USER_ID?.trim() ||
-            process.env.ONES_USER_UUID?.trim() ||
-            process.env.Ones_User_Id?.trim();
-        const tok = process.env.ONES_AUTH_TOKEN?.trim() || process.env.Ones_Auth_Token?.trim();
-        if (uid && tok) {
-            out['Ones-User-Id'] = uid;
-            out['Ones-Auth-Token'] = tok;
-        }
-    }
-    if (includeJsonContentType)
-        out['Content-Type'] = 'application/json';
-    return out;
-}
-export function summarizeOnesError(status, body) {
-    if (body && typeof body === 'object') {
-        const o = body;
-        const parts = [];
-        if (typeof o.type === 'string')
-            parts.push(o.type);
-        if (typeof o.reason === 'string')
-            parts.push(o.reason);
-        if (typeof o.errcode === 'string')
-            parts.push(o.errcode);
-        if (typeof o.message === 'string')
-            parts.push(o.message);
-        if (o.code !== undefined && o.code !== null)
-            parts.push(`code=${String(o.code)}`);
-        if (parts.length)
-            return parts.filter(Boolean).join(' · ');
-    }
-    return status === 401 ? 'Unauthorized' : `HTTP ${status}`;
-}
-/** ONES 部分接口 HTTP 200 但 body 仍为错误（如 reason: ServerError） */
-function throwIfOnesPeekBusinessError(apiPath, parsed) {
-    if (parsed === null || typeof parsed !== 'object')
-        return;
-    const o = parsed;
-    if (Array.isArray(o.groups))
-        return;
-    const hasErr = (typeof o.reason === 'string' && o.reason.length > 0) ||
-        (typeof o.errcode === 'string' && o.errcode.length > 0) ||
-        (typeof o.type === 'string' && o.type.length > 0);
-    if (!hasErr)
-        return;
-    const detail = summarizeOnesError(200, parsed);
-    throw new CliError('FETCH_ERROR', `ONES ${apiPath}: ${detail}`, '若 query 不合法会返回 ServerError；可试 webcmd ones tasks（空 must）或检查筛选器文档。响应全文可用 -v 或临时打日志。');
-}
-export async function onesFetchInPageWithMeta(page, apiPath, options = {}) {
-    if (!options.skipGoto) {
-        await gotoOnesHome(page);
-    }
-    const url = onesApiUrl(apiPath);
-    const method = (options.method ?? 'GET').toUpperCase();
-    const auth = options.auth !== false;
-    const body = options.body ?? null;
-    const includeCt = body !== null || method === 'POST' || method === 'PUT' || method === 'PATCH';
-    const headers = buildHeaders(auth, includeCt);
-    const urlJs = JSON.stringify(url);
-    const methodJs = JSON.stringify(method);
-    const headersJs = JSON.stringify(headers);
-    const bodyJs = body === null ? 'null' : JSON.stringify(body);
-    const raw = await page.evaluate(`
-    (async () => {
-      const url = ${urlJs};
-      const method = ${methodJs};
-      const headers = ${headersJs};
-      const body = ${bodyJs};
-      const init = {
-        method,
-        headers: { ...headers },
-        credentials: 'include',
-      };
-      if (body !== null) init.body = body;
-      const res = await fetch(url, init);
-      const text = await res.text();
-      let parsed = null;
-      try {
-        parsed = text ? JSON.parse(text) : null;
-      } catch {
-        parsed = text;
-      }
-      return { ok: res.ok, status: res.status, parsed };
-    })()
-  `);
-    return raw;
-}
-/** 当前操作用户 8 位 uuid（Header 或 GET users/me） */
-export async function resolveOnesUserUuid(page, opts) {
-    const fromEnv = process.env.ONES_USER_ID?.trim() ||
-        process.env.ONES_USER_UUID?.trim() ||
-        process.env.Ones_User_Id?.trim();
-    if (fromEnv)
-        return fromEnv;
-    const data = (await onesFetchInPage(page, 'users/me', { skipGoto: opts?.skipGoto }));
-    const u = data.user && typeof data.user === 'object' ? data.user : data;
-    if (!u || typeof u.uuid !== 'string') {
-        throw new CliError('FETCH_ERROR', 'Could not read current user uuid from users/me', 'Set ONES_USER_ID or ensure Chrome is logged in; try: webcmd ones me -f json');
-    }
-    return String(u.uuid);
-}
-export async function onesFetchInPage(page, apiPath, options = {}) {
-    const r = await onesFetchInPageWithMeta(page, apiPath, options);
-    if (!r.ok) {
-        const detail = summarizeOnesError(r.status, r.parsed);
-        const hint = r.status === 401
-            ? '在 Chrome 中打开 ONES 并登录；或先执行 webcmd ones login 后按提示 export ONES_USER_ID / ONES_AUTH_TOKEN；并确认 ONES_BASE_URL 与浏览器地址一致。'
-            : '检查 ONES_BASE_URL、VPN/内网，以及实例是否仍为 Project API 路径。';
-        throw new CliError('FETCH_ERROR', `ONES ${apiPath}: ${detail}`, hint);
-    }
-    if (apiPath.includes('/filters/peek')) {
-        throwIfOnesPeekBusinessError(apiPath, r.parsed);
-    }
-    return r.parsed;
-}

package/clis/ones/enrich-tasks.js

@@ -1,37 +0,0 @@
-/**
- * peek 列表只有轻量字段，用 batch tasks/info 补全 summary 等（ONES 文档 #7）
- */
-import { onesFetchInPage } from './common.js';
-const BATCH_SIZE = 40;
-export async function enrichPeekEntriesWithDetails(page, team, entries, skipGoto) {
-    const ids = [...new Set(entries.map((e) => String(e.uuid ?? '').trim()).filter(Boolean))];
-    if (ids.length === 0)
-        return entries;
-    const byId = new Map();
-    try {
-        for (let i = 0; i < ids.length; i += BATCH_SIZE) {
-            const slice = ids.slice(i, i + BATCH_SIZE);
-            const parsed = (await onesFetchInPage(page, `team/${team}/tasks/info`, {
-                method: 'POST',
-                body: JSON.stringify({ ids: slice }),
-                skipGoto,
-            }));
-            const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
-            for (const t of tasks) {
-                const id = String(t.uuid ?? '');
-                if (id)
-                    byId.set(id, t);
-            }
-        }
-    }
-    catch {
-        return entries;
-    }
-    if (byId.size === 0)
-        return entries;
-    return entries.map((e) => {
-        const id = String(e.uuid ?? '');
-        const full = id ? byId.get(id) : undefined;
-        return full ? { ...e, ...full } : e;
-    });
-}

package/clis/ones/login.js

@@ -1,81 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { getOnesBaseUrl, onesFetchInPage } from './common.js';
-cli({
-    site: 'ones',
-    name: 'login',
-    access: 'write',
-    description: 'ONES Project API — login via Chrome Bridge (POST auth/login); stderr prints export hints for ONES_USER_ID / TOKEN',
-    domain: 'ones.cn',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        {
-            name: 'email',
-            type: 'str',
-            required: false,
-            help: 'Account email (or set ONES_EMAIL)',
-        },
-        {
-            name: 'phone',
-            type: 'str',
-            required: false,
-            help: 'Account phone (or set ONES_PHONE); ignored if email is set',
-        },
-        {
-            name: 'password',
-            type: 'str',
-            required: false,
-            help: 'Password (or set ONES_PASSWORD)',
-        },
-    ],
-    columns: ['uuid', 'name', 'email', 'token_preview'],
-    func: async (page, kwargs) => {
-        const email = kwargs.email?.trim() || process.env.ONES_EMAIL?.trim();
-        const phone = kwargs.phone?.trim() || process.env.ONES_PHONE?.trim();
-        const password = kwargs.password || process.env.ONES_PASSWORD || '';
-        if (!password) {
-            throw new CliError('CONFIG', 'Password required', 'Pass --password or set ONES_PASSWORD for non-interactive use.');
-        }
-        if (!email && !phone) {
-            throw new CliError('CONFIG', 'email or phone required', 'Pass --email or --phone (or set ONES_EMAIL / ONES_PHONE).');
-        }
-        getOnesBaseUrl();
-        const bodyObj = { password };
-        if (email)
-            bodyObj.email = email;
-        else
-            bodyObj.phone = phone;
-        const parsed = (await onesFetchInPage(page, 'auth/login', {
-            method: 'POST',
-            body: JSON.stringify(bodyObj),
-            auth: false,
-        }));
-        const user = parsed.user;
-        if (!user?.uuid || !user?.token) {
-            throw new CliError('FETCH_ERROR', 'ONES login response missing user.uuid or user.token', 'Your server build may differ from documented Project API.');
-        }
-        const uuid = String(user.uuid);
-        const token = String(user.token);
-        const name = String(user.name ?? '');
-        const em = String(user.email ?? '');
-        const base = getOnesBaseUrl();
-        console.error([
-            '',
-            '后续请求会优先使用当前 Chrome 会话 Cookie；若接口仍要求 Header，可 export：',
-            `  export ONES_BASE_URL=${JSON.stringify(base)}`,
-            `  export ONES_USER_ID=${JSON.stringify(uuid)}`,
-            `  export ONES_AUTH_TOKEN=${JSON.stringify(token)}`,
-            '',
-        ].join('\n'));
-        return [
-            {
-                uuid,
-                name,
-                email: em,
-                token_preview: token.length > 12 ? `${token.slice(0, 6)}…${token.slice(-4)}` : '***',
-            },
-        ];
-    },
-});

package/clis/ones/logout.js

@@ -1,18 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { onesFetchInPage } from './common.js';
-cli({
-    site: 'ones',
-    name: 'logout',
-    access: 'write',
-    description: 'ONES Project API — invalidate current token (GET auth/logout) via Chrome Bridge',
-    domain: 'ones.cn',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [],
-    columns: ['ok', 'detail'],
-    func: async (page) => {
-        await onesFetchInPage(page, 'auth/logout', { method: 'GET' });
-        return [{ ok: 'true', detail: 'Server logout ok; clear local ONES_AUTH_TOKEN if set.' }];
-    },
-});

package/clis/ones/me.js

@@ -1,31 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { onesFetchInPage } from './common.js';
-cli({
-    site: 'ones',
-    name: 'me',
-    access: 'read',
-    description: 'ONES Project API — current user (GET users/me) via Chrome Bridge',
-    domain: 'ones.cn',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [],
-    columns: ['uuid', 'name', 'email', 'phone', 'status'],
-    func: async (page) => {
-        const data = (await onesFetchInPage(page, 'users/me'));
-        const u = data.user && typeof data.user === 'object' ? data.user : data;
-        if (!u || typeof u.uuid !== 'string') {
-            throw new CliError('FETCH_ERROR', 'Unexpected users/me response', 'See raw JSON with: webcmd ones me -f json');
-        }
-        return [
-            {
-                uuid: String(u.uuid),
-                name: String(u.name ?? ''),
-                email: String(u.email ?? ''),
-                phone: String(u.phone ?? ''),
-                status: u.status != null ? String(u.status) : '',
-            },
-        ];
-    },
-});

package/clis/ones/my-tasks.js

@@ -1,121 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { gotoOnesHome, onesFetchInPage, resolveOnesUserUuid } from './common.js';
-import { enrichPeekEntriesWithDetails } from './enrich-tasks.js';
-import { resolveTaskListLabels } from './resolve-labels.js';
-import { defaultPeekBody, flattenPeekGroups, mapTaskEntry, parsePeekLimit, } from './task-helpers.js';
-/** 文档示例里「负责人」常用 field004；与顶层 assign 在不同部署上二选一有效 */
-function queryAssign(userUuid) {
-    return { must: [{ equal: { assign: userUuid } }] };
-}
-function queryAssignField004(userUuid) {
-    return { must: [{ in: { 'field_values.field004': [userUuid] } }] };
-}
-function queryOwner(userUuid) {
-    return { must: [{ equal: { owner: userUuid } }] };
-}
-function dedupeByUuid(entries) {
-    const seen = new Set();
-    const out = [];
-    for (const e of entries) {
-        const id = String(e.uuid ?? '');
-        if (!id || seen.has(id))
-            continue;
-        seen.add(id);
-        out.push(e);
-    }
-    return out;
-}
-async function peekTasks(page, team, query, cap) {
-    const path = `team/${team}/filters/peek`;
-    const body = defaultPeekBody(query);
-    const parsed = (await onesFetchInPage(page, path, {
-        method: 'POST',
-        body: JSON.stringify(body),
-        skipGoto: true,
-    }));
-    return flattenPeekGroups(parsed, cap);
-}
-cli({
-    site: 'ones',
-    name: 'my-tasks',
-    access: 'read',
-    description: 'ONES — my work items (filters/peek + strict must query). Default: assignee=me. Use --mode if your site uses field004 for assignee.',
-    domain: 'ones.cn',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        {
-            name: 'team',
-            type: 'str',
-            required: false,
-            positional: true,
-            help: 'Team UUID from URL …/team/<uuid>/…, or set ONES_TEAM_UUID',
-        },
-        {
-            name: 'limit',
-            type: 'int',
-            default: 100,
-            help: 'Max rows (default 100, max 500)',
-        },
-        {
-            name: 'mode',
-            type: 'str',
-            default: 'assign',
-            choices: ['assign', 'field004', 'owner', 'both'],
-            help: 'assign=负责人(顶层 assign)；field004=负责人(筛选器示例里的 field004)；owner=创建者；both=负责人∪创建者(两次 peek 去重)',
-        },
-    ],
-    columns: ['title', 'status', 'project', 'uuid', 'updated', '工时'],
-    func: async (page, kwargs) => {
-        const team = kwargs.team?.trim() ||
-            process.env.ONES_TEAM_UUID?.trim() ||
-            process.env.ONES_TEAM_ID?.trim();
-        if (!team) {
-            throw new CliError('CONFIG', 'team UUID required', 'Pass team from URL …/team/<team>/… or set ONES_TEAM_UUID.');
-        }
-        const limit = parsePeekLimit(kwargs.limit, 100);
-        const mode = String(kwargs.mode ?? 'assign');
-        await gotoOnesHome(page);
-        const userUuid = await resolveOnesUserUuid(page, { skipGoto: true });
-        let entries = [];
-        if (mode === 'both') {
-            const cap = Math.min(500, limit * 2);
-            const asAssign = await peekTasks(page, team, queryAssign(userUuid), cap);
-            const asOwner = await peekTasks(page, team, queryOwner(userUuid), cap);
-            entries = dedupeByUuid([...asAssign, ...asOwner]).slice(0, limit);
-        }
-        else {
-            const queryByMode = () => {
-                switch (mode) {
-                    case 'field004':
-                        return queryAssignField004(userUuid);
-                    case 'owner':
-                        return queryOwner(userUuid);
-                    case 'assign':
-                    default:
-                        return queryAssign(userUuid);
-                }
-            };
-            const primary = queryByMode();
-            try {
-                entries = await peekTasks(page, team, primary, limit);
-            }
-            catch (e) {
-                const msg = e instanceof Error ? e.message : '';
-                const canFallback = mode === 'assign' &&
-                    (msg.includes('ServerError') || msg.includes('801') || msg.includes('Params is invalid'));
-                if (canFallback) {
-                    entries = await peekTasks(page, team, queryAssignField004(userUuid), limit);
-                }
-                else {
-                    throw e;
-                }
-            }
-        }
-        const enriched = await enrichPeekEntriesWithDetails(page, team, entries, true);
-        const labels = await resolveTaskListLabels(page, team, enriched, true);
-        return enriched.map((e) => mapTaskEntry(e, labels));
-    },
-});

package/clis/ones/resolve-labels.js

@@ -1,64 +0,0 @@
-/**
- * 把 status / project 的 uuid 解析为中文名（团队级接口各查一次或按批）
- */
-import { onesFetchInPage } from './common.js';
-import { getTaskProjectRawId } from './task-helpers.js';
-export async function loadTaskStatusLabels(page, team, skipGoto) {
-    const map = new Map();
-    try {
-        const parsed = (await onesFetchInPage(page, `team/${team}/task_statuses`, {
-            method: 'GET',
-            skipGoto,
-        }));
-        const list = Array.isArray(parsed.task_statuses)
-            ? parsed.task_statuses
-            : [];
-        for (const s of list) {
-            const id = String(s.uuid ?? '');
-            const name = String(s.name ?? '');
-            if (id && name)
-                map.set(id, name);
-        }
-    }
-    catch {
-        /* 降级为仅显示 uuid */
-    }
-    return map;
-}
-const PROJECT_INFO_CHUNK = 25;
-export async function loadProjectLabels(page, team, projectUuids, skipGoto) {
-    const map = new Map();
-    const ids = [...new Set(projectUuids.filter(Boolean))];
-    if (ids.length === 0)
-        return map;
-    try {
-        for (let i = 0; i < ids.length; i += PROJECT_INFO_CHUNK) {
-            const slice = ids.slice(i, i + PROJECT_INFO_CHUNK);
-            const q = slice.map(encodeURIComponent).join(',');
-            const path = `team/${team}/projects/info?ids=${q}`;
-            const parsed = (await onesFetchInPage(page, path, {
-                method: 'GET',
-                skipGoto,
-            }));
-            const projects = Array.isArray(parsed.projects) ? parsed.projects : [];
-            for (const p of projects) {
-                const id = String(p.uuid ?? '');
-                const name = String(p.name ?? '');
-                if (id && name)
-                    map.set(id, name);
-            }
-        }
-    }
-    catch {
-        /* 降级 */
-    }
-    return map;
-}
-export async function resolveTaskListLabels(page, team, entries, skipGoto) {
-    const projectUuids = entries.map((e) => getTaskProjectRawId(e)).filter(Boolean);
-    const [statusByUuid, projectByUuid] = await Promise.all([
-        loadTaskStatusLabels(page, team, skipGoto),
-        loadProjectLabels(page, team, projectUuids, skipGoto),
-    ]);
-    return { statusByUuid, projectByUuid };
-}