weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/mail/index.js

@@ -0,0 +1,519 @@
+import { readFile } from 'node:fs/promises';
+import { ExitCode, isCliError, toErrorEnvelope } from '../../core/errors.js';
+import { createMailContinuationSigner } from './continuation.js';
+import { createMailHost } from './host.js';
+import { mailManifest } from './manifest.js';
+import { executeMailOperation } from './operations.js';
+import { mailValidationError } from './errors.js';
+function asOptions(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function stripBom(value) {
+    return value.replace(/^\uFEFF+/, '');
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function inputFrom(options, extra = {}) {
+    const opts = asOptions(options);
+    let input = {};
+    if (opts.input && opts.inputJson) {
+        throw mailValidationError('input_conflict', '不能同时传 --input 和 --input-json');
+    }
+    if (opts.inputJson) {
+        input = parseJsonInput(String(opts.inputJson), '--input-json');
+    }
+    if (opts.input) {
+        let raw;
+        try {
+            raw = stripBom(opts.input === '-' ? await readStdin() : await readFile(String(opts.input), 'utf8'));
+        }
+        catch {
+            throw mailValidationError('input_unreadable', `无法读取 --input：${String(opts.input)}`);
+        }
+        input = parseJsonInput(raw, '--input');
+    }
+    return {
+        ...input,
+        ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value !== undefined && value !== '')),
+    };
+}
+function parseJsonInput(raw, label) {
+    try {
+        const parsed = JSON.parse(stripBom(raw));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error('input must be an object');
+        }
+        return parsed;
+    }
+    catch {
+        throw mailValidationError('input_invalid', `${label} 不是合法 JSON 对象`);
+    }
+}
+export function successEnvelope(operation, result) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        operation,
+        data: result.data === undefined ? null : result.data,
+        ...(result.meta ? { meta: result.meta } : {}),
+        warnings: [],
+    };
+}
+function failureEnvelope(error) {
+    const structured = error;
+    return {
+        schemaVersion: 1,
+        ok: false,
+        ...(structured?.partialData === undefined ? {} : { data: structured.partialData }),
+        error: toErrorEnvelope(error),
+    };
+}
+async function executeAndPrint(ctx, operation, input) {
+    try {
+        const result = await executeMailOperation(operation, input, {
+            ctx,
+            host: createMailHost(ctx),
+            continuation: createMailContinuationSigner(ctx),
+        });
+        ctx.output.write(successEnvelope(operation, result), { json: true });
+    }
+    catch (error) {
+        console.error(JSON.stringify(failureEnvelope(error), null, 2));
+        process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+    }
+}
+export const mailShortcut = {
+    name: 'mail',
+    description: '泛微E10邮件管理 CLI',
+    category: 'shortcut',
+    register({ program, action }) {
+        const mail = program.command('mail').description('泛微E10邮件管理（查询/发送/管理）');
+        mail.command('schema')
+            .description('Print mail operation manifest for agents')
+            .action(action((ctx) => {
+            ctx.output.write(mailManifest, { json: true });
+        }));
+        mail.command('run')
+            .description('Run a mail operation with JSON input')
+            .argument('<operation>', 'operation name, e.g. mail.list')
+            .option('--input <path>', 'JSON input file, or - for stdin')
+            .option('--input-json <json>', 'inline JSON input object')
+            .action(action(async (ctx, operation, options) => {
+            await executeAndPrint(ctx, String(operation), await inputFrom(options));
+        }));
+        const withJson = (command) => command.option('--input <path>', 'JSON input file, or - for stdin').option('--input-json <json>', 'inline JSON input object');
+        // ---- 查询 ----
+        mail.command('list')
+            .description('查询邮件列表（支持文件夹/关键字/未读/附件/时间过滤）')
+            .option('--folder <id>', '文件夹：0收件箱 -1已发送 -2草稿箱 -3垃圾箱 -4已删除 -10全部')
+            .option('--keyword <kw>', '主题关键字')
+            .option('--from <name>', '发件人')
+            .option('--to <name>', '收件人')
+            .option('--unread', '仅未读')
+            .option('--star', '仅星标')
+            .option('--todo', '仅待办')
+            .option('--attach', '仅带附件')
+            .option('--date <range>', '时间范围 起始,结束 (YYYY-MM-DD)')
+            .option('--page <n>', '页码')
+            .option('--size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            const extra = {
+                folder: opts.folder,
+                keyword: opts.keyword,
+                from: opts.from,
+                to: opts.to,
+                unread: opts.unread === true ? true : undefined,
+                star: opts.star === true ? true : undefined,
+                todo: opts.todo === true ? true : undefined,
+                hasFile: opts.attach === true ? true : undefined,
+                page: opts.page,
+                size: opts.size,
+            };
+            if (opts.date) {
+                const [s, e] = String(opts.date).split(',');
+                extra.startDate = s?.trim();
+                extra.endDate = e?.trim();
+            }
+            await executeAndPrint(ctx, 'mail.list', await inputFrom(options, extra));
+        }));
+        mail.command('contact')
+            .description('往来邮件（对方发来 + 我发给对方）')
+            .option('--name <name>', '人员姓名/工号')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.contact.list', await inputFrom(options, { name: opts.name }));
+        }));
+        mail.command('view')
+            .description('查看邮件详情（含正文/附件）')
+            .option('--id <id>', '邮件 id')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.view.info', await inputFrom(options, { id: opts.id }));
+        }));
+        mail.command('content')
+            .description('查看邮件正文')
+            .option('--id <id>', '邮件 id')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.view.content', await inputFrom(options, { id: opts.id }));
+        }));
+        mail.command('unread')
+            .description('未读邮件统计（收件箱/已删除/垃圾箱/待办/星标）')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.unread.count', await inputFrom(options));
+        }));
+        mail.command('config')
+            .description('获取邮件配置（发送开关/附件限制）')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.config.get', await inputFrom(options));
+        }));
+        // ---- 收件人解析（Agent 辅助）----
+        const search = mail.command('search').description('收件人解析命令');
+        withJson(search.command('person')
+            .description('内部人员/部门搜索')
+            .option('--keyword <kw>', '姓名/工号')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.person.search', await inputFrom(options, { keyword: opts.keyword }));
+        })));
+        withJson(search.command('dep')
+            .description('部门树定位')
+            .option('--keyword <kw>', '部门名')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.dep.search', await inputFrom(options, { keyword: opts.keyword }));
+        })));
+        withJson(search.command('address')
+            .description('外部邮箱搜索')
+            .option('--keyword <kw>', '邮箱关键字')
+            .action(action(async (ctx, options) => {
+            const opts = asOptions(options);
+            await executeAndPrint(ctx, 'mail.address.search', await inputFrom(options, { keyword: opts.keyword }));
+        })));
+        // ---- 发送（prepare/apply）----
+        const send = mail.command('send').description('发送/回复/转发/存草稿（prepare→apply）');
+        withJson(send.command('prepare')
+            .description('准备发送（组装请求 + 安全预检 + 输出摘要，不发送）')
+            .option('--flag <flag>', '新建 -1 / 回复 1 / 转发 3 / 编辑草稿 4')
+            .option('--id <id>', '原邮件 id（回复/转发/编辑草稿）')
+            .option('--to <names>', '收件人（姓名/工号/部门 --to-dep）')
+            .option('--cc <names>', '抄送')
+            .option('--bcc <names>', '密送')
+            .option('--to-dep <deps>', '部门收件人')
+            .option('--to-id <ids>', '精确收件人 id')
+            .option('--cc-id <ids>', '精确抄送 id')
+            .option('--bcc-id <ids>', '精确密送 id')
+            .option('--external', '外部邮件')
+            .option('--subject <subject>', '主题')
+            .option('--content <content>', '正文')
+            .option('--timing <datetime>', '定时发送 YYYY-MM-DD HH:mm:ss')
+            .option('--files <ids>', '附件 fileid（逗号）')
+            .option('--filesizes <sizes>', '附件大小（逗号）')
+            .option('--draft', '存草稿（不发送）')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.send.prepare', await inputFrom(options, {
+                flag: o.flag, id: o.id, to: o.to, cc: o.cc, bcc: o.bcc,
+                toDep: o.toDep, ccDep: o.ccDep, bccDep: o.bccDep,
+                toId: o.toId, ccId: o.ccId, bccId: o.bccId,
+                external: o.external === true ? true : undefined,
+                subject: o.subject, content: o.content, timing: o.timing,
+                files: o.files, filesizes: o.filesizes, draft: o.draft === true ? true : undefined,
+            }));
+        })));
+        withJson(send.command('apply')
+            .description('执行发送（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'prepare 返回的 continuation')
+            .option('--yes', '确认发送')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.send.apply', await inputFrom(options, {
+                continuation: o.continuation,
+                confirm: o.yes === true ? true : undefined,
+            }));
+        })));
+        // ---- 标记 / 待办 / 移动 / 删除 ----
+        withJson(mail.command('star')
+            .description('标星/取消标星')
+            .option('--id <id>', '邮件 id')
+            .option('--star <0|1>', '1 标星 / 0 取消')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.star', await inputFrom(options, { id: o.id, star: o.star }));
+        })));
+        withJson(mail.command('read-status')
+            .description('标记单封已读/未读')
+            .option('--id <id>', '邮件 id')
+            .option('--read <0|1>', '1 已读 / 0 未读')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.read.status', await inputFrom(options, { id: o.id, read: o.read }));
+        })));
+        withJson(mail.command('read-all')
+            .description('标记全部已读')
+            .option('--folder <id>', '文件夹 id（默认全部）')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.read.all', await inputFrom(options, { folder: o.folder }));
+        })));
+        withJson(mail.command('wait')
+            .description('创建待办/提醒')
+            .option('--id <id>', '邮件 id')
+            .option('--title <title>', '待办标题')
+            .option('--enddate <date>', '截止日期')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.wait.add', await inputFrom(options, { id: o.id, title: o.title, endDate: o.enddate }));
+        })));
+        withJson(mail.command('move')
+            .description('移动邮件至文件夹')
+            .option('--id <id>', '邮件 id')
+            .option('--folder <id>', '目标文件夹 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.move.folder', await inputFrom(options, { id: o.id, folder: o.folder }));
+        })));
+        mail.command('delete')
+            .description('删除邮件（默认逻辑删除移至已删除）')
+            .option('--id <id>', '邮件 id 或逗号分隔多个')
+            .option('--permanent', '永久删除（WITHHELD，未实现）')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            if (o.permanent === true) {
+                throw mailValidationError('operation_withheld', '永久删除（mail.delete.batch）已暂缓实现，不可逆且无法撤销');
+            }
+            await executeAndPrint(ctx, 'mail.delete.move', await inputFrom(options, { id: o.id }));
+        }));
+        // ---- 文件夹 ----
+        const folder = mail.command('folder').description('文件夹管理');
+        withJson(folder.command('create')
+            .description('新建邮件文件夹')
+            .option('--name <name>', '文件夹名')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.folder.create', await inputFrom(options, { name: o.name }));
+        })));
+        withJson(folder.command('delete')
+            .description('删除邮件文件夹')
+            .option('--id <id>', '文件夹 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.folder.delete', await inputFrom(options, { id: o.id }));
+        })));
+        // ---- 联系人 / 分组 ----
+        const contacts = mail.command('contacts').description('联系人管理');
+        withJson(contacts.command('list')
+            .description('联系人列表/搜索')
+            .option('--keyword <kw>', '关键字')
+            .option('--page <n>', '页码')
+            .option('--size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.contacts.list', await inputFrom(options, { keyword: o.keyword, page: o.page, size: o.size }));
+        })));
+        withJson(contacts.command('save')
+            .description('新增/编辑联系人（GET 全量 + 保存，prepare→apply）')
+            .option('--prepare', '准备（查全量 + 输出摘要）')
+            .option('--apply', '执行保存（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'prepare 返回的 continuation')
+            .option('--yes', '确认')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            const op = o.prepare === true ? 'mail.contacts.save.prepare' : 'mail.contacts.save.apply';
+            await executeAndPrint(ctx, op, await inputFrom(options, {
+                continuation: o.continuation,
+                confirm: o.yes === true ? true : undefined,
+            }));
+        })));
+        withJson(contacts.command('delete')
+            .description('删除联系人')
+            .option('--id <id>', '联系人 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.contacts.delete', await inputFrom(options, { id: o.id }));
+        })));
+        const group = contacts.command('group').description('联系人分组');
+        withJson(group.command('list')
+            .description('分组列表')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.contacts.group.list', await inputFrom(options));
+        })));
+        withJson(group.command('detail')
+            .description('分组详情（含统计）')
+            .option('--id <id>', '分组 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.contacts.group.detail', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(group.command('save')
+            .description('新增/编辑分组（prepare→apply）')
+            .option('--prepare', '准备')
+            .option('--apply', '执行（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'continuation')
+            .option('--yes', '确认')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            const op = o.prepare === true ? 'mail.contacts.group.save.prepare' : 'mail.contacts.group.save.apply';
+            await executeAndPrint(ctx, op, await inputFrom(options, { continuation: o.continuation, confirm: o.yes === true ? true : undefined }));
+        })));
+        withJson(group.command('delete')
+            .description('删除分组')
+            .option('--id <id>', '分组 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.contacts.group.delete', await inputFrom(options, { id: o.id }));
+        })));
+        // ---- 模板 ----
+        const template = mail.command('template').description('模板管理');
+        withJson(template.command('list')
+            .description('模板列表')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.template.list', await inputFrom(options));
+        })));
+        withJson(template.command('save')
+            .description('新增模板（prepare→apply）')
+            .option('--prepare', '准备')
+            .option('--apply', '执行（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'continuation')
+            .option('--yes', '确认')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            const op = o.prepare === true ? 'mail.template.save.prepare' : 'mail.template.save.apply';
+            await executeAndPrint(ctx, op, await inputFrom(options, { continuation: o.continuation, confirm: o.yes === true ? true : undefined }));
+        })));
+        withJson(template.command('update')
+            .description('编辑模板（GET 全量 + 保存）')
+            .option('--id <id>', '模板 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.template.update', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(template.command('delete')
+            .description('删除模板')
+            .option('--id <id>', '模板 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.template.delete', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(template.command('default')
+            .description('设为默认模板')
+            .option('--id <id>', '模板 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.template.default', await inputFrom(options, { id: o.id }));
+        })));
+        // ---- 签名 ----
+        const sign = mail.command('sign').description('签名管理');
+        withJson(sign.command('list')
+            .description('签名列表')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.sign.list', await inputFrom(options));
+        })));
+        withJson(sign.command('save')
+            .description('新增签名（prepare→apply）')
+            .option('--prepare', '准备')
+            .option('--apply', '执行（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'continuation')
+            .option('--yes', '确认')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            const op = o.prepare === true ? 'mail.sign.save.prepare' : 'mail.sign.save.apply';
+            await executeAndPrint(ctx, op, await inputFrom(options, { continuation: o.continuation, confirm: o.yes === true ? true : undefined }));
+        })));
+        withJson(sign.command('update')
+            .description('编辑签名')
+            .option('--id <id>', '签名 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.sign.update', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(sign.command('delete')
+            .description('删除签名')
+            .option('--id <id>', '签名 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.sign.delete', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(sign.command('default')
+            .description('设为默认签名')
+            .option('--id <id>', '签名 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.sign.default', await inputFrom(options, { id: o.id }));
+        })));
+        withJson(sign.command('qrcode')
+            .description('生成二维码名片')
+            .option('--id <id>', '签名 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.sign.qrcode', await inputFrom(options, { id: o.id }));
+        })));
+        // ---- 黑名单 ----
+        const blacklist = mail.command('blacklist').description('黑名单管理');
+        withJson(blacklist.command('list')
+            .description('黑名单列表')
+            .action(action(async (ctx, options) => {
+            await executeAndPrint(ctx, 'mail.blacklist.list', await inputFrom(options));
+        })));
+        withJson(blacklist.command('operate')
+            .description('新增/删除黑名单（prepare→apply）')
+            .option('--prepare', '准备')
+            .option('--apply', '执行（需 --continuation 与 --yes）')
+            .option('--continuation <token>', 'continuation')
+            .option('--yes', '确认')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            const op = o.prepare === true ? 'mail.blacklist.operate.prepare' : 'mail.blacklist.operate.apply';
+            await executeAndPrint(ctx, op, await inputFrom(options, { continuation: o.continuation, confirm: o.yes === true ? true : undefined }));
+        })));
+        // ---- 附件中心 ----
+        const attachment = mail.command('attachment').description('附件中心');
+        withJson(attachment.command('center')
+            .description('附件中心列表/搜索')
+            .option('--keyword <kw>', '关键字')
+            .option('--page <n>', '页码')
+            .option('--size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.attachment.center', await inputFrom(options, { keyword: o.keyword, page: o.page, size: o.size }));
+        })));
+        withJson(attachment.command('upload')
+            .description('上传附件（三步：预检→上传→绑定，返回 fileid）')
+            .option('--file <path>', '本地文件路径')
+            .option('--name <name>', '附件名')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.attachment.upload', await inputFrom(options, { file: o.file, name: o.name }));
+        })));
+        withJson(attachment.command('download')
+            .description('批量下载附件')
+            .option('--ids <ids>', '附件 id（逗号）')
+            .option('--output <dir>', '输出目录')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.attachment.download', await inputFrom(options, { ids: o.ids, output: o.output }));
+        })));
+        // ---- 清理日志 / 撤回 ----
+        withJson(mail.command('clearlog')
+            .description('邮件清理日志列表')
+            .option('--page <n>', '页码')
+            .option('--size <n>', '每页条数')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.clearlog.list', await inputFrom(options, { page: o.page, size: o.size }));
+        })));
+        withJson(mail.command('recall')
+            .description('撤回已发送的内部邮件')
+            .option('--id <id>', '邮件 id')
+            .action(action(async (ctx, options) => {
+            const o = asOptions(options);
+            await executeAndPrint(ctx, 'mail.recall', await inputFrom(options, { id: o.id }));
+        })));
+    },
+};

package/dist/shortcuts/mail/manifest.js

@@ -0,0 +1,38 @@
+import { mailOperationDefinitions } from './operations/registry.js';
+/**
+ * 邮件模块禁用边界（破坏性/缺口操作，与招聘 entry.cancel 同策略）：
+ * - mail.delete.batch：物理永久删除，不可逆、无法撤销，破坏性最强，暂缓实现。
+ * - mail.resend：重发依赖「邮件发送日志 id」(mailRemindLogId)，源技能未封装日志查询接口，
+ *   无法获得该 id 时如实提示，不臆造；暂缓实现。
+ * 其余读操作与写操作（发送/回复/转发/存草稿、标星、已读、待办、移动、逻辑删除、文件夹、
+ * 联系人、分组、模板、签名、黑名单、附件上传/下载、撤回）均已可用。不得编造或绕过。
+ */
+const MAIL_WITHHELD = ['mail.delete.batch', 'mail.resend'];
+function buildOperations() {
+    return mailOperationDefinitions().map((definition) => ({
+        name: definition.name,
+        resource: definition.resource,
+        summary: definition.summary,
+        ...(definition.capability ? { capability: definition.capability } : {}),
+        risk: definition.risk,
+        ...(definition.requiresConfirmation ? { requiresConfirmation: true } : {}),
+        inputSchema: definition.inputSchema,
+    }));
+}
+export const mailManifest = {
+    schemaVersion: 1,
+    name: 'mail',
+    title: '泛微E10邮件管理',
+    version: '0.1.0',
+    host: 'e10-mail',
+    status: 'builtin',
+    sourceSkill: 'weaver-e10-mail',
+    capabilities: ['mail'],
+    operations: buildOperations(),
+    withheldOperations: MAIL_WITHHELD.map((name) => ({
+        name,
+        reason: name === 'mail.delete.batch'
+            ? '物理永久删除（deleteMailResourceBatch）不可逆、无法撤销，破坏性最强；如确需执行，请在确认风险后以单独授权方式处理，不在常规 CLI 提供。'
+            : '重发邮件（resendMail）依赖「邮件发送日志 id」(mailRemindLogId)，源技能未封装日志查询接口，无法获得该 id 时如实提示，不臆造；暂缓实现。',
+    })),
+};

package/dist/shortcuts/mail/operations/mail-blacklist.js

@@ -0,0 +1,79 @@
+import { mailValidationError } from '../errors.js';
+import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
+const CONTINUATION_TTL_MS = 600_000;
+const BLACKLIST_SCHEMA = schemaOf({
+    operateType: { type: 'string', description: 'add / delete' },
+    mailAddress: SCHEMA_STRING,
+    id: SCHEMA_STRING,
+    confirm: { type: 'boolean' },
+    continuation: SCHEMA_STRING,
+}, { description: '黑名单操作（prepare/apply）' });
+function buildBlacklistBody(args) {
+    const operateType = String(args.operateType || 'add').toLowerCase();
+    if (operateType !== 'add' && operateType !== 'delete')
+        throw new Error('operateType 必须是 add 或 delete');
+    const body = { operateType };
+    if (operateType === 'add') {
+        const mailAddress = String(args.mailAddress || '').trim();
+        if (!mailAddress)
+            throw new Error('add 操作必须提供 mailAddress（邮箱地址）');
+        body.mailAddress = mailAddress;
+    }
+    else {
+        const id = String(args.id || '').trim();
+        if (!id)
+            throw new Error('delete 操作必须提供 id（黑名单记录 id）');
+        body.id = id;
+    }
+    return body;
+}
+const opBlacklistOperatePrepare = {
+    name: 'mail.blacklist.operate.prepare',
+    resource: 'mail/base/setting/blacklist/operateUserMailBlacklist',
+    method: 'POST',
+    action: 'mail.blacklist.operate.prepare',
+    summary: '新增/删除黑名单（prepare，不执行）',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: BLACKLIST_SCHEMA,
+    async handler(args, env) {
+        const body = buildBlacklistBody(args);
+        const session = await env.host.getSession();
+        const continuation = await env.continuation.issue({
+            operation: 'mail.blacklist.operate.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            body,
+        }, CONTINUATION_TTL_MS);
+        return mailSuccess('mail.blacklist.operate.prepare', {
+            operateType: body.operateType,
+            target: body.mailAddress || body.id,
+            tip: '确认后以 mail blacklist operate --apply --continuation <token> --yes 执行',
+        }, { continuation });
+    },
+};
+const opBlacklistOperateApply = {
+    name: 'mail.blacklist.operate.apply',
+    resource: 'mail/base/setting/blacklist/operateUserMailBlacklist',
+    method: 'POST',
+    action: 'mail.blacklist.operate.apply',
+    summary: '执行黑名单新增/删除',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: BLACKLIST_SCHEMA,
+    async handler(args, env) {
+        if (args.confirm !== true)
+            throw new Error('mail.blacklist.operate.apply 必须传入 confirm=true 与 prepare 返回的 continuation');
+        if (!args.continuation)
+            throw new Error('mail.blacklist.operate.apply 必须传入 prepare 返回的 continuation');
+        const lease = await env.continuation.verify(String(args.continuation), 'mail.blacklist.operate.apply');
+        const session = await env.host.getSession();
+        if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
+            throw mailValidationError('context_mismatch', '确认上下文已变化（租户或登录账号不同），请重新执行 prepare');
+        }
+        const value = (await env.host.request({ path: '/api/mail/base/setting/blacklist/operateUserMailBlacklist', method: 'POST', body: lease.body }));
+        return mailSuccess('mail.blacklist.operate.apply', value?.data ?? 'SUCCESS', { operateType: lease.body?.operateType, target: lease.body?.mailAddress || lease.body?.id });
+    },
+};
+export const mailBlacklistOperations = [opBlacklistOperatePrepare, opBlacklistOperateApply];