@nextclaw/channel-plugin-feishu 0.2.29-beta.0 → 0.2.29-beta.2

package/dist/src/calendar-calendar.js

@@ -0,0 +1,54 @@
+import { assertLarkOk, createToolContext, handleInvokeError, json, registerTool } from "./user-tool-helpers.js";
+import { Type } from "@sinclair/typebox";
+//#region src/calendar-calendar.ts
+const CalendarCalendarSchema = Type.Union([
+	Type.Object({
+		action: Type.Literal("list"),
+		page_size: Type.Optional(Type.Number()),
+		page_token: Type.Optional(Type.String())
+	}),
+	Type.Object({
+		action: Type.Literal("get"),
+		calendar_id: Type.String()
+	}),
+	Type.Object({ action: Type.Literal("primary") })
+]);
+function registerFeishuCalendarCalendarTool(api) {
+	const { toolClient } = createToolContext(api, "feishu_calendar_calendar");
+	registerTool(api, {
+		name: "feishu_calendar_calendar",
+		label: "Feishu Calendar",
+		description: "按本人身份查询飞书日历列表、主日历和指定日历详情。",
+		parameters: CalendarCalendarSchema,
+		async execute(_toolCallId, params) {
+			const payload = params;
+			try {
+				const client = toolClient();
+				if (payload.action === "list") {
+					const response = await client.invoke("feishu_calendar_calendar.list", (sdk, opts) => sdk.calendar.calendar.list({ params: {
+						page_size: payload.page_size,
+						page_token: payload.page_token
+					} }, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({
+						calendars: response.data?.calendar_list ?? [],
+						has_more: response.data?.has_more ?? false,
+						page_token: response.data?.page_token
+					});
+				}
+				if (payload.action === "primary") {
+					const response = await client.invoke("feishu_calendar_calendar.primary", (sdk, opts) => sdk.calendar.calendar.primary({}, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({ calendars: response.data?.calendars ?? [] });
+				}
+				const response = await client.invoke("feishu_calendar_calendar.get", (sdk, opts) => sdk.calendar.calendar.get({ path: { calendar_id: payload.calendar_id } }, opts), { as: "user" });
+				assertLarkOk(response);
+				return json({ calendar: response.data?.calendar ?? response.data });
+			} catch (error) {
+				return handleInvokeError(error, api);
+			}
+		}
+	}, { name: "feishu_calendar_calendar" });
+}
+//#endregion
+export { registerFeishuCalendarCalendarTool };

package/dist/src/calendar-event-attendee.js

@@ -0,0 +1,98 @@
+import { StringEnum, assertLarkOk, createToolContext, handleInvokeError, json, registerTool } from "./user-tool-helpers.js";
+import { Type } from "@sinclair/typebox";
+//#region src/calendar-event-attendee.ts
+const CalendarAttendeeSchema = Type.Union([Type.Object({
+	action: Type.Literal("create"),
+	calendar_id: Type.String(),
+	event_id: Type.String(),
+	attendees: Type.Array(Type.Object({
+		type: StringEnum([
+			"user",
+			"chat",
+			"resource",
+			"third_party"
+		]),
+		attendee_id: Type.String()
+	})),
+	need_notification: Type.Optional(Type.Boolean())
+}), Type.Object({
+	action: Type.Literal("list"),
+	calendar_id: Type.String(),
+	event_id: Type.String(),
+	page_size: Type.Optional(Type.Number()),
+	page_token: Type.Optional(Type.String()),
+	user_id_type: Type.Optional(StringEnum([
+		"open_id",
+		"union_id",
+		"user_id"
+	]))
+})]);
+function registerFeishuCalendarEventAttendeeTool(api) {
+	const { toolClient } = createToolContext(api, "feishu_calendar_event_attendee");
+	registerTool(api, {
+		name: "feishu_calendar_event_attendee",
+		label: "Feishu Calendar Event Attendee",
+		description: "按本人身份添加日程参会人或查看参会人列表。",
+		parameters: CalendarAttendeeSchema,
+		async execute(_toolCallId, params) {
+			const payload = params;
+			try {
+				const client = toolClient();
+				if (payload.action === "create") {
+					const attendeePayload = (payload.attendees ?? []).map((attendee) => {
+						if (attendee.type === "user") return {
+							type: attendee.type,
+							user_id: attendee.attendee_id
+						};
+						if (attendee.type === "chat") return {
+							type: attendee.type,
+							chat_id: attendee.attendee_id
+						};
+						if (attendee.type === "resource") return {
+							type: attendee.type,
+							room_id: attendee.attendee_id
+						};
+						return {
+							type: attendee.type,
+							third_party_email: attendee.attendee_id
+						};
+					});
+					const response = await client.invoke("feishu_calendar_event_attendee.create", (sdk, opts) => sdk.calendar.calendarEventAttendee.create({
+						path: {
+							calendar_id: payload.calendar_id,
+							event_id: payload.event_id
+						},
+						params: { user_id_type: "open_id" },
+						data: {
+							attendees: attendeePayload,
+							need_notification: payload.need_notification ?? true
+						}
+					}, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({ attendees: response.data?.attendees ?? [] });
+				}
+				const response = await client.invoke("feishu_calendar_event_attendee.list", (sdk, opts) => sdk.calendar.calendarEventAttendee.list({
+					path: {
+						calendar_id: payload.calendar_id,
+						event_id: payload.event_id
+					},
+					params: {
+						page_size: payload.page_size,
+						page_token: payload.page_token,
+						user_id_type: payload.user_id_type ?? "open_id"
+					}
+				}, opts), { as: "user" });
+				assertLarkOk(response);
+				return json({
+					attendees: response.data?.items ?? [],
+					has_more: response.data?.has_more ?? false,
+					page_token: response.data?.page_token
+				});
+			} catch (error) {
+				return handleInvokeError(error, api);
+			}
+		}
+	}, { name: "feishu_calendar_event_attendee" });
+}
+//#endregion
+export { registerFeishuCalendarEventAttendeeTool };

package/dist/src/calendar-event.js

@@ -0,0 +1,193 @@
+import { StringEnum, assertLarkOk, createToolContext, handleInvokeError, json, parseTimeToTimestamp, registerTool } from "./user-tool-helpers.js";
+import { normalizeEventTimes, resolveCalendarId } from "./calendar-shared.js";
+import { Type } from "@sinclair/typebox";
+//#region src/calendar-event.ts
+const CalendarEventSchema = Type.Union([
+	Type.Object({
+		action: Type.Literal("create"),
+		start_time: Type.String(),
+		end_time: Type.String(),
+		summary: Type.Optional(Type.String()),
+		calendar_id: Type.Optional(Type.String()),
+		description: Type.Optional(Type.String()),
+		attendees: Type.Optional(Type.Array(Type.Object({
+			type: StringEnum([
+				"user",
+				"chat",
+				"resource",
+				"third_party"
+			]),
+			id: Type.String()
+		}))),
+		user_open_id: Type.Optional(Type.String()),
+		need_notification: Type.Optional(Type.Boolean()),
+		location: Type.Optional(Type.String())
+	}),
+	Type.Object({
+		action: Type.Literal("list"),
+		start_time: Type.String(),
+		end_time: Type.String(),
+		calendar_id: Type.Optional(Type.String()),
+		page_size: Type.Optional(Type.Number()),
+		page_token: Type.Optional(Type.String())
+	}),
+	Type.Object({
+		action: Type.Literal("get"),
+		event_id: Type.String(),
+		calendar_id: Type.Optional(Type.String())
+	}),
+	Type.Object({
+		action: Type.Literal("patch"),
+		event_id: Type.String(),
+		calendar_id: Type.Optional(Type.String()),
+		summary: Type.Optional(Type.String()),
+		description: Type.Optional(Type.String()),
+		start_time: Type.Optional(Type.String()),
+		end_time: Type.Optional(Type.String()),
+		location: Type.Optional(Type.String())
+	}),
+	Type.Object({
+		action: Type.Literal("delete"),
+		event_id: Type.String(),
+		calendar_id: Type.Optional(Type.String()),
+		need_notification: Type.Optional(Type.Boolean())
+	})
+]);
+function buildAttendees(payload) {
+	return [...payload.user_open_id ? [{
+		type: "user",
+		id: payload.user_open_id
+	}] : [], ...payload.attendees ?? []].map((attendee) => {
+		if (attendee.type === "user") return {
+			type: attendee.type,
+			user_id: attendee.id
+		};
+		if (attendee.type === "chat") return {
+			type: attendee.type,
+			chat_id: attendee.id
+		};
+		if (attendee.type === "resource") return {
+			type: attendee.type,
+			room_id: attendee.id
+		};
+		return {
+			type: attendee.type,
+			third_party_email: attendee.id
+		};
+	});
+}
+function registerFeishuCalendarEventTool(api) {
+	const { toolClient } = createToolContext(api, "feishu_calendar_event");
+	registerTool(api, {
+		name: "feishu_calendar_event",
+		label: "Feishu Calendar Event",
+		description: "按本人身份创建、查询、修改、删除飞书日程。",
+		parameters: CalendarEventSchema,
+		async execute(_toolCallId, params) {
+			const payload = params;
+			try {
+				const client = toolClient();
+				const calendarId = await resolveCalendarId(client, payload.calendar_id);
+				if (payload.action === "create") {
+					const startTs = payload.start_time ? parseTimeToTimestamp(payload.start_time) : null;
+					const endTs = payload.end_time ? parseTimeToTimestamp(payload.end_time) : null;
+					if (!startTs || !endTs) return json({ error: "start_time 和 end_time 必须为带时区的 ISO 8601 / RFC 3339 时间。" });
+					const response = await client.invoke("feishu_calendar_event.create", (sdk, opts) => sdk.calendar.calendarEvent.create({
+						path: { calendar_id: calendarId },
+						data: {
+							summary: payload.summary,
+							description: payload.description,
+							start_time: { timestamp: startTs },
+							end_time: { timestamp: endTs },
+							...payload.location ? { location: { name: payload.location } } : {}
+						}
+					}, opts), { as: "user" });
+					assertLarkOk(response);
+					const event = response.data?.event;
+					const attendeePayload = buildAttendees(payload);
+					if (event?.event_id && attendeePayload.length > 0) await client.invoke("feishu_calendar_event.create", (sdk, opts) => sdk.calendar.calendarEventAttendee.create({
+						path: {
+							calendar_id: calendarId,
+							event_id: event.event_id
+						},
+						params: { user_id_type: "open_id" },
+						data: {
+							attendees: attendeePayload,
+							need_notification: payload.need_notification ?? true
+						}
+					}, opts), { as: "user" });
+					return json({ event: normalizeEventTimes(response.data?.event) });
+				}
+				if (payload.action === "list") {
+					const startTs = payload.start_time ? parseTimeToTimestamp(payload.start_time) : null;
+					const endTs = payload.end_time ? parseTimeToTimestamp(payload.end_time) : null;
+					if (!startTs || !endTs) return json({ error: "start_time 和 end_time 必须为带时区的 ISO 8601 / RFC 3339 时间。" });
+					const response = await client.invoke("feishu_calendar_event.instance_view", (sdk, opts) => sdk.calendar.calendarEvent.instanceView({
+						path: { calendar_id: calendarId },
+						params: {
+							start_time: startTs,
+							end_time: endTs,
+							page_size: payload.page_size,
+							page_token: payload.page_token,
+							user_id_type: "open_id"
+						}
+					}, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({
+						events: (response.data?.items ?? []).map(normalizeEventTimes),
+						has_more: response.data?.has_more ?? false,
+						page_token: response.data?.page_token
+					});
+				}
+				if (payload.action === "get") {
+					const response = await client.invoke("feishu_calendar_event.get", (sdk, opts) => sdk.calendar.calendarEvent.get({ path: {
+						calendar_id: calendarId,
+						event_id: payload.event_id
+					} }, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({ event: normalizeEventTimes(response.data?.event) });
+				}
+				if (payload.action === "patch") {
+					const updateData = {};
+					if (payload.summary) updateData.summary = payload.summary;
+					if (payload.description) updateData.description = payload.description;
+					if (payload.location) updateData.location = { name: payload.location };
+					if (payload.start_time) {
+						const startTs = parseTimeToTimestamp(payload.start_time);
+						if (!startTs) return json({ error: "start_time 必须为带时区的 ISO 8601 / RFC 3339 时间。" });
+						updateData.start_time = { timestamp: startTs };
+					}
+					if (payload.end_time) {
+						const endTs = parseTimeToTimestamp(payload.end_time);
+						if (!endTs) return json({ error: "end_time 必须为带时区的 ISO 8601 / RFC 3339 时间。" });
+						updateData.end_time = { timestamp: endTs };
+					}
+					const response = await client.invoke("feishu_calendar_event.patch", (sdk, opts) => sdk.calendar.calendarEvent.patch({
+						path: {
+							calendar_id: calendarId,
+							event_id: payload.event_id
+						},
+						data: updateData
+					}, opts), { as: "user" });
+					assertLarkOk(response);
+					return json({ event: normalizeEventTimes(response.data?.event) });
+				}
+				assertLarkOk(await client.invoke("feishu_calendar_event.delete", (sdk, opts) => sdk.calendar.calendarEvent.delete({
+					path: {
+						calendar_id: calendarId,
+						event_id: payload.event_id
+					},
+					params: { need_notification: payload.need_notification ?? true }
+				}, opts), { as: "user" }));
+				return json({
+					success: true,
+					event_id: payload.event_id
+				});
+			} catch (error) {
+				return handleInvokeError(error, api);
+			}
+		}
+	}, { name: "feishu_calendar_event" });
+}
+//#endregion
+export { registerFeishuCalendarEventTool };

package/dist/src/calendar-freebusy.js

@@ -0,0 +1,40 @@
+import { assertLarkOk, createToolContext, handleInvokeError, json, parseTimeToRFC3339, registerTool } from "./user-tool-helpers.js";
+import { Type } from "@sinclair/typebox";
+//#region src/calendar-freebusy.ts
+const CalendarFreebusySchema = Type.Object({
+	action: Type.Literal("list"),
+	user_ids: Type.Array(Type.String()),
+	time_min: Type.String(),
+	time_max: Type.String()
+});
+function registerFeishuCalendarFreebusyTool(api) {
+	const { toolClient } = createToolContext(api, "feishu_calendar_freebusy");
+	registerTool(api, {
+		name: "feishu_calendar_freebusy",
+		label: "Feishu Calendar Freebusy",
+		description: "按本人身份查询 1-10 位用户在一段时间内的忙闲状态。",
+		parameters: CalendarFreebusySchema,
+		async execute(_toolCallId, params) {
+			const payload = params;
+			try {
+				if (!payload.user_ids?.length || payload.user_ids.length > 10) return json({ error: "user_ids 必须是 1-10 个用户 open_id。" });
+				const timeMin = parseTimeToRFC3339(payload.time_min);
+				const timeMax = parseTimeToRFC3339(payload.time_max);
+				if (!timeMin || !timeMax) return json({ error: "time_min 和 time_max 必须是带时区的 RFC 3339 时间。" });
+				const response = await toolClient().invoke("feishu_calendar_freebusy.list", (sdk, opts) => sdk.calendar.freebusy.batch({ data: {
+					time_min: timeMin,
+					time_max: timeMax,
+					user_ids: payload.user_ids,
+					include_external_calendar: true,
+					only_busy: true
+				} }, opts), { as: "user" });
+				assertLarkOk(response);
+				return json({ freebusy_lists: response.data?.freebusy_lists ?? [] });
+			} catch (error) {
+				return handleInvokeError(error, api);
+			}
+		}
+	}, { name: "feishu_calendar_freebusy" });
+}
+//#endregion
+export { registerFeishuCalendarFreebusyTool };

package/dist/src/calendar-shared.js

@@ -0,0 +1,23 @@
+import { assertLarkOk, unixTimestampToISO8601 } from "./user-tool-helpers.js";
+//#region src/calendar-shared.ts
+function normalizeEventTimes(event) {
+	if (!event) return event;
+	const typed = event;
+	const start = typed.start_time;
+	const end = typed.end_time;
+	return {
+		...typed,
+		start_time_iso8601: unixTimestampToISO8601(start?.timestamp),
+		end_time_iso8601: unixTimestampToISO8601(end?.timestamp)
+	};
+}
+async function resolveCalendarId(client, calendarId) {
+	if (calendarId) return calendarId;
+	const response = await client.invoke("feishu_calendar_calendar.primary", (sdk, opts) => sdk.calendar.calendar.primary({}, opts), { as: "user" });
+	assertLarkOk(response);
+	const primaryId = (response.data?.calendars)?.[0]?.calendar_id;
+	if (!primaryId) throw new Error("No primary calendar found for current user.");
+	return primaryId;
+}
+//#endregion
+export { normalizeEventTimes, resolveCalendarId };

package/dist/src/calendar.js

@@ -0,0 +1,16 @@
+import { registerFeishuCalendarCalendarTool } from "./calendar-calendar.js";
+import { registerFeishuCalendarEventTool } from "./calendar-event.js";
+import { registerFeishuCalendarEventAttendeeTool } from "./calendar-event-attendee.js";
+import { registerFeishuCalendarFreebusyTool } from "./calendar-freebusy.js";
+import { resolveRegisteredFeishuToolsConfig } from "./tool-account.js";
+//#region src/calendar.ts
+function registerFeishuCalendarTools(api) {
+	if (!api.config) return;
+	if (!resolveRegisteredFeishuToolsConfig(api.config).calendar) return;
+	registerFeishuCalendarCalendarTool(api);
+	registerFeishuCalendarEventTool(api);
+	registerFeishuCalendarEventAttendeeTool(api);
+	registerFeishuCalendarFreebusyTool(api);
+}
+//#endregion
+export { registerFeishuCalendarTools };

package/dist/src/card-action.js

@@ -0,0 +1,49 @@
+import { resolveFeishuAccount } from "./accounts.js";
+import { withTicket } from "./lark-ticket.js";
+import { handleFeishuMessage } from "./bot.js";
+//#region src/card-action.ts
+async function handleFeishuCardAction(params) {
+	const { cfg, event, runtime, accountId } = params;
+	const account = resolveFeishuAccount({
+		cfg,
+		accountId
+	});
+	const log = runtime?.log ?? console.log;
+	const actionValue = event.action.value;
+	let content = "";
+	if (typeof actionValue === "object" && actionValue !== null) if ("text" in actionValue && typeof actionValue.text === "string") content = actionValue.text;
+	else if ("command" in actionValue && typeof actionValue.command === "string") content = actionValue.command;
+	else content = JSON.stringify(actionValue);
+	else content = String(actionValue);
+	const messageEvent = {
+		sender: { sender_id: {
+			open_id: event.operator.open_id,
+			user_id: event.operator.user_id,
+			union_id: event.operator.union_id
+		} },
+		message: {
+			message_id: `card-action-${event.token}`,
+			chat_id: event.context.chat_id || event.operator.open_id,
+			chat_type: event.context.chat_id ? "group" : "p2p",
+			message_type: "text",
+			content: JSON.stringify({ text: content })
+		}
+	};
+	log(`feishu[${account.accountId}]: handling card action from ${event.operator.open_id}: ${content}`);
+	await withTicket({
+		accountId: account.accountId,
+		messageId: messageEvent.message.message_id,
+		chatId: messageEvent.message.chat_id,
+		senderOpenId: event.operator.open_id,
+		chatType: messageEvent.message.chat_type,
+		startTime: Date.now()
+	}, () => handleFeishuMessage({
+		cfg,
+		event: messageEvent,
+		botOpenId: params.botOpenId,
+		runtime,
+		accountId
+	}));
+}
+//#endregion
+export { handleFeishuCardAction };

package/dist/src/channel.d.ts

@@ -0,0 +1,7 @@
+import { ChannelPlugin } from "./nextclaw-sdk/types.js";
+import { ResolvedFeishuAccount } from "./types.js";
+
+//#region src/channel.d.ts
+declare const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount>;
+//#endregion
+export { feishuPlugin };