@yanhaidao/wecom 2.4.120 → 2.5.110

package/{src/capability/calendar/schema.ts → dist/src/capability/calendar/schema.js}

@@ -3,35 +3,29 @@
 // 完整参考企业微信官方 API 文档：https://developer.work.weixin.qq.com/document/path/93329
 // 所有参数验证规则严格遵循官方文档要求
 // ============================================================================
-
 const accountIdProperty = {
     type: "string",
     minLength: 1,
     description: "可选：指定企业微信账号 ID",
 };
-
 // --- Calendar Properties ---
-
 const calendarSummaryProperty = {
     type: "string",
     minLength: 1,
     maxLength: 128,
     description: "日历标题，1-128 字符",
 };
-
 const calendarColorProperty = {
     type: "string",
     pattern: "^#?[0-9A-Fa-f]{6}$",
     description: "日历颜色，RGB 十六进制格式，如 #FF3030 或 FF3030",
 };
-
 const calendarDescriptionProperty = {
     type: "string",
     minLength: 0,
     maxLength: 512,
     description: "日历描述，0-512 字符",
 };
-
 const calendarAdminsProperty = {
     type: "array",
     minItems: 1,
@@ -39,7 +33,6 @@ const calendarAdminsProperty = {
     items: { type: "string", minLength: 1 },
     description: "日历管理员 userid 列表，最多 3 人",
 };
-
 const calendarSharesEntrySchema = {
     type: "object",
     required: ["userid"],
@@ -48,7 +41,6 @@ const calendarSharesEntrySchema = {
         permission: { type: "integer", enum: [1, 3], description: "1:可查看，3:仅查看闲忙状态" },
     },
 };
-
 const calendarSharesProperty = {
     type: "array",
     minItems: 1,
@@ -56,7 +48,6 @@ const calendarSharesProperty = {
     items: calendarSharesEntrySchema,
     description: "日历通知范围成员列表，最多 2000 人",
 };
-
 const calendarPublicRangeProperty = {
     type: "object",
     properties: {
@@ -64,15 +55,12 @@ const calendarPublicRangeProperty = {
         partyids: { type: "array", minItems: 1, maxItems: 100, items: { type: "integer" }, description: "公开的部门列表，最多 100 个" },
     },
 };
-
 // --- Schedule Properties ---
-
 const scheduleTimeProperty = {
     type: "integer",
     minimum: 0,
     description: "Unix 时间戳（秒）",
 };
-
 const scheduleAttendeeSchema = {
     type: "object",
     required: ["userid"],
@@ -80,7 +68,6 @@ const scheduleAttendeeSchema = {
         userid: { type: "string", minLength: 1, maxLength: 64, description: "日程参与者 ID，不多于 64 字节" },
     },
 };
-
 const scheduleAttendeesProperty = {
     type: "array",
     minItems: 1,
@@ -88,7 +75,6 @@ const scheduleAttendeesProperty = {
     items: scheduleAttendeeSchema,
     description: "日程参与者列表，最多 1000 人",
 };
-
 const scheduleAdminsProperty = {
     type: "array",
     minItems: 1,
@@ -96,28 +82,24 @@ const scheduleAdminsProperty = {
     items: { type: "string", minLength: 1 },
     description: "日程管理员 userid 列表，最多 3 人",
 };
-
 const scheduleSummaryProperty = {
     type: "string",
     minLength: 0,
     maxLength: 128,
     description: "日程标题，0-128 字符，不填默认显示为新建事件",
 };
-
 const scheduleDescriptionProperty = {
     type: "string",
     minLength: 0,
     maxLength: 1000,
     description: "日程描述，不多于 1000 字符",
 };
-
 const scheduleLocationProperty = {
     type: "string",
     minLength: 0,
     maxLength: 128,
     description: "日程地址，不多于 128 字符",
 };
-
 // 官方严格限定的提醒时间枚举值
 const scheduleRemindersSchema = {
     type: "object",
@@ -164,23 +146,19 @@ const scheduleRemindersSchema = {
         },
     },
 };
-
 const opModeSchema = {
     type: "integer",
     enum: [0, 1, 2],
     description: "操作模式：0-全部修改/删除，1-仅修改/删除此日程，2-修改/删除将来的所有日程",
 };
-
 const opStartTimeProperty = {
     type: "integer",
     minimum: 0,
     description: "操作起始时间，Unix 时间戳。仅当 op_mode 为 1 或 2 时有效，必须是重复日程的某次开始时间",
 };
-
 // ============================================================================
 // Calendar Action Schemas (4 个)
 // ============================================================================
-
 const calendarCreateSchema = {
     type: "object",
     additionalProperties: false,
@@ -199,7 +177,6 @@ const calendarCreateSchema = {
         is_corp_calendar: { type: "integer", enum: [0, 1], description: "是否全员日历，0-否，1-是" },
     },
 };
-
 const calendarUpdateSchema = {
     type: "object",
     additionalProperties: false,
@@ -217,7 +194,6 @@ const calendarUpdateSchema = {
         public_range: calendarPublicRangeProperty,
     },
 };
-
 const calendarGetSchema = {
     type: "object",
     additionalProperties: false,
@@ -234,7 +210,6 @@ const calendarGetSchema = {
         },
     },
 };
-
 const calendarDeleteSchema = {
     type: "object",
     additionalProperties: false,
@@ -245,11 +220,9 @@ const calendarDeleteSchema = {
         cal_id: { type: "string", minLength: 1, description: "日历 ID" },
     },
 };
-
 // ============================================================================
 // Schedule Action Schemas (7 个)
 // ============================================================================
-
 const scheduleCreateSchema = {
     type: "object",
     additionalProperties: false,
@@ -269,7 +242,6 @@ const scheduleCreateSchema = {
         cal_id: { type: "string", minLength: 1, maxLength: 64, description: "日程所属日历 ID（第三方应用必须指定）" },
     },
 };
-
 const scheduleUpdateSchema = {
     type: "object",
     additionalProperties: false,
@@ -292,7 +264,6 @@ const scheduleUpdateSchema = {
         reminders: scheduleRemindersSchema,
     },
 };
-
 const scheduleAddAttendeesSchema = {
     type: "object",
     additionalProperties: false,
@@ -304,7 +275,6 @@ const scheduleAddAttendeesSchema = {
         attendees: scheduleAttendeesProperty,
     },
 };
-
 const scheduleDelAttendeesSchema = {
     type: "object",
     additionalProperties: false,
@@ -316,7 +286,6 @@ const scheduleDelAttendeesSchema = {
         attendees: scheduleAttendeesProperty,
     },
 };
-
 const scheduleGetByCalendarSchema = {
     type: "object",
     additionalProperties: false,
@@ -329,7 +298,6 @@ const scheduleGetByCalendarSchema = {
         limit: { type: "integer", minimum: 1, maximum: 1000, description: "分页大小，默认 500，范围 1-1000" },
     },
 };
-
 const scheduleGetSchema = {
     type: "object",
     additionalProperties: false,
@@ -346,7 +314,6 @@ const scheduleGetSchema = {
         },
     },
 };
-
 const scheduleDeleteSchema = {
     type: "object",
     additionalProperties: false,
@@ -359,11 +326,9 @@ const scheduleDeleteSchema = {
         op_start_time: opStartTimeProperty,
     },
 };
-
 // ============================================================================
 // System Calendar Action Schemas (2 个)
 // ============================================================================
-
 const scheduleGetSystemCalidSchema = {
     type: "object",
     additionalProperties: false,
@@ -374,7 +339,6 @@ const scheduleGetSystemCalidSchema = {
         userid: { type: "string", minLength: 1, description: "指定成员的 userid" },
     },
 };
-
 const scheduleCreateInSystemSchema = {
     type: "object",
     additionalProperties: false,
@@ -393,11 +357,9 @@ const scheduleCreateInSystemSchema = {
         reminders: scheduleRemindersSchema,
     },
 };
-
 // ============================================================================
 // Export Schema
 // ============================================================================
-
 export const wecomCalendarToolSchema = {
     oneOf: [
         calendarCreateSchema,

package/dist/src/capability/calendar/tool.js

@@ -0,0 +1,365 @@
+import { isWecomAgentSource } from "../../runtime/source-registry.js";
+import { resolveAgentAccountOrUndefined } from "../bot/fallback-delivery.js";
+import { WecomCalendarClient } from "./client.js";
+import { wecomCalendarToolSchema } from "./schema.js";
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function readString(v) {
+    return String(v ?? "").trim();
+}
+function readNumber(v) {
+    const num = Number(v);
+    return isNaN(num) ? 0 : num;
+}
+function readArray(v) {
+    return Array.isArray(v) ? v : [];
+}
+function buildResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        details: payload,
+    };
+}
+function resolveAccount(api, paramsAccountId, toolContext) {
+    const accountId = paramsAccountId || toolContext?.agentAccountId || toolContext?.accountId || "default";
+    return resolveAgentAccountOrUndefined(api.config, accountId);
+}
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerWecomCalendarTools(api) {
+    if (typeof api?.registerTool !== "function") {
+        return;
+    }
+    const client = new WecomCalendarClient();
+    api.registerTool((toolContext) => {
+        if (toolContext?.messageChannel !== "wecom" ||
+            !isWecomAgentSource({
+                accountId: toolContext?.agentAccountId || toolContext?.accountId,
+                sessionKey: toolContext?.sessionKey,
+                sessionId: toolContext?.sessionId,
+            })) {
+            return null;
+        }
+        return {
+            name: "wecom_calendar",
+            label: "WeCom Calendar",
+            description: "企业微信日历工具，支持创建/更新/删除日历和日程，获取日程详情等功能",
+            parameters: wecomCalendarToolSchema,
+            async execute(_toolCallId, params) {
+                try {
+                    const account = resolveAccount(api, params.accountId, toolContext);
+                    if (!account || !account.configured) {
+                        return buildResult({
+                            ok: false,
+                            action: params.action,
+                            error: "账号未配置或不存在",
+                            accountId: params.accountId,
+                        });
+                    }
+                    switch (params.action) {
+                        // ========================================================================
+                        // Calendar APIs
+                        // ========================================================================
+                        case "calendar_create": {
+                            const r = await client.createCalendar({
+                                agent: account,
+                                request: {
+                                    calendar: {
+                                        summary: readString(params.summary),
+                                        color: readString(params.color),
+                                        description: params.description !== undefined ? readString(params.description) : undefined,
+                                        admins: readArray(params.admins),
+                                        set_as_default: params.set_as_default,
+                                        shares: readArray(params.shares),
+                                        is_public: params.is_public,
+                                        public_range: params.public_range,
+                                        is_corp_calendar: params.is_corp_calendar,
+                                    },
+                                    agentid: params.agentid,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "calendar_create",
+                                calId: r.calId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "calendar_update": {
+                            const r = await client.updateCalendar({
+                                agent: account,
+                                request: {
+                                    skip_public_range: params.skip_public_range,
+                                    calendar: {
+                                        cal_id: readString(params.cal_id),
+                                        summary: readString(params.summary),
+                                        color: readString(params.color),
+                                        description: params.description !== undefined ? readString(params.description) : undefined,
+                                        admins: readArray(params.admins),
+                                        shares: readArray(params.shares),
+                                        public_range: params.public_range,
+                                    },
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "calendar_update",
+                                calId: r.calId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "calendar_get": {
+                            const r = await client.getCalendar({
+                                agent: account,
+                                request: {
+                                    cal_id_list: readArray(params.cal_id_list),
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "calendar_get",
+                                calendarList: r.calendarList,
+                                raw: r.raw,
+                            });
+                        }
+                        case "calendar_delete": {
+                            const r = await client.deleteCalendar({
+                                agent: account,
+                                calId: readString(params.cal_id),
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "calendar_delete",
+                                calId: r.calId,
+                                raw: r.raw,
+                            });
+                        }
+                        // ========================================================================
+                        // Schedule APIs
+                        // ========================================================================
+                        case "schedule_create": {
+                            const r = await client.createSchedule({
+                                agent: account,
+                                request: {
+                                    schedule: {
+                                        start_time: readNumber(params.start_time),
+                                        end_time: readNumber(params.end_time),
+                                        is_whole_day: params.is_whole_day,
+                                        summary: params.summary !== undefined ? readString(params.summary) : undefined,
+                                        description: params.description !== undefined ? readString(params.description) : undefined,
+                                        location: params.location !== undefined ? readString(params.location) : undefined,
+                                        attendees: readArray(params.attendees),
+                                        admins: readArray(params.admins),
+                                        reminders: params.reminders,
+                                        cal_id: params.cal_id !== undefined ? readString(params.cal_id) : undefined,
+                                    },
+                                    agentid: params.agentid,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_create",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_update": {
+                            const r = await client.updateSchedule({
+                                agent: account,
+                                request: {
+                                    skip_attendees: params.skip_attendees,
+                                    op_mode: params.op_mode,
+                                    op_start_time: params.op_start_time,
+                                    schedule: {
+                                        schedule_id: readString(params.schedule_id),
+                                        start_time: readNumber(params.start_time),
+                                        end_time: readNumber(params.end_time),
+                                        is_whole_day: params.is_whole_day,
+                                        summary: params.summary !== undefined ? readString(params.summary) : undefined,
+                                        description: params.description !== undefined ? readString(params.description) : undefined,
+                                        location: params.location !== undefined ? readString(params.location) : undefined,
+                                        attendees: readArray(params.attendees),
+                                        admins: readArray(params.admins),
+                                        reminders: params.reminders,
+                                    },
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_update",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_add_attendees": {
+                            const r = await client.addScheduleAttendees({
+                                agent: account,
+                                request: {
+                                    schedule_id: readString(params.schedule_id),
+                                    attendees: readArray(params.attendees),
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_add_attendees",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_del_attendees": {
+                            const r = await client.deleteScheduleAttendees({
+                                agent: account,
+                                request: {
+                                    schedule_id: readString(params.schedule_id),
+                                    attendees: readArray(params.attendees),
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_del_attendees",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_get_by_calendar": {
+                            const r = await client.getScheduleByCalendar({
+                                agent: account,
+                                request: {
+                                    cal_id: readString(params.cal_id),
+                                    offset: params.offset,
+                                    limit: params.limit,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_get_by_calendar",
+                                scheduleList: r.scheduleList,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_get": {
+                            const r = await client.getSchedule({
+                                agent: account,
+                                request: {
+                                    schedule_id_list: readArray(params.schedule_id_list),
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_get",
+                                scheduleList: r.scheduleList,
+                                meetingCode: r.meetingCode,
+                                meetingLink: r.meetingLink,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_delete": {
+                            const r = await client.deleteSchedule({
+                                agent: account,
+                                request: {
+                                    schedule_id: readString(params.schedule_id),
+                                    op_mode: params.op_mode,
+                                    op_start_time: params.op_start_time,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_delete",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        // ========================================================================
+                        // System Calendar APIs
+                        // ========================================================================
+                        case "schedule_get_system_calid": {
+                            const r = await client.getSystemCalendarId({
+                                agent: account,
+                                userid: readString(params.userid),
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_get_system_calid",
+                                calId: r.calId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_create_in_system": {
+                            const r = await client.createSystemSchedule({
+                                agent: account,
+                                request: {
+                                    schedule: {
+                                        organizer: readString(params.organizer),
+                                        start_time: readNumber(params.start_time),
+                                        end_time: readNumber(params.end_time),
+                                        is_whole_day: params.is_whole_day,
+                                        summary: params.summary !== undefined ? readString(params.summary) : undefined,
+                                        description: params.description !== undefined ? readString(params.description) : undefined,
+                                        location: params.location !== undefined ? readString(params.location) : undefined,
+                                        attendees: readArray(params.attendees),
+                                        reminders: params.reminders,
+                                    },
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_create_in_system",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_respond": {
+                            const r = await client.respondSchedule({
+                                agent: account,
+                                request: {
+                                    schedule_id: readString(params.schedule_id),
+                                    op_mode: params.op_mode,
+                                    op_start_time: params.op_start_time,
+                                    attendee: readString(params.attendee),
+                                    response_status: params.response_status,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_respond",
+                                scheduleId: r.scheduleId,
+                                raw: r.raw,
+                            });
+                        }
+                        case "schedule_sync": {
+                            const r = await client.syncSchedule({
+                                agent: account,
+                                request: {
+                                    cal_id: readString(params.cal_id),
+                                    cursor: params.cursor,
+                                    limit: params.limit,
+                                },
+                            });
+                            return buildResult({
+                                ok: true,
+                                action: "schedule_sync",
+                                nextCursor: r.nextCursor,
+                                scheduleList: r.scheduleList,
+                                raw: r.raw,
+                            });
+                        }
+                        // ========================================================================
+                        // Default: Unknown Action
+                        // ========================================================================
+                        default:
+                            throw new Error(`未知操作：${params.action}`);
+                    }
+                }
+                catch (err) {
+                    return buildResult({
+                        ok: false,
+                        action: params.action,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            },
+        };
+    });
+}

package/dist/src/capability/calendar/types.js

@@ -0,0 +1,12 @@
+// ============================================================================
+// Calendar Types (日历类型定义)
+// 完整参考企业微信官方 API 文档：https://developer.work.weixin.qq.com/document/path/93329
+// ============================================================================
+// --- Constants ---
+export const REMINDER_BEFORE_EVENT_VALUES = [0, 300, 900, 3600, 86400];
+export const REMINDER_TIME_DIFFS_VALUES = [0, -300, -900, -3600, -86400, 32400, -172800, -604800];
+export const REPEAT_TYPE = { DAILY: 0, WEEKLY: 1, MONTHLY: 2, YEARLY: 5, WORKDAY: 7 };
+export const PERMISSION_TYPE = { VIEW: 1, BUSY_ONLY: 3 };
+export const SCHEDULE_RESPONSE_STATUS = { UNPROCESSED: 0, TENTATIVE: 1, ACCEPTED: 2, ACCEPTED_ONCE: 3, DECLINED: 4 };
+export const OP_MODE = { ALL: 0, THIS_ONLY: 1, FUTURE: 2 };
+export const SCHEDULE_STATUS = { NORMAL: 0, CANCELLED: 1 };