@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/tools/oapi/calendar/event.js

@@ -0,0 +1,834 @@
+import { Type } from "@sinclair/typebox";
+import {
+  json,
+  createToolContext,
+  parseTimeToTimestamp,
+  assertLarkOk,
+  handleInvokeErrorWithAutoAuth,
+  formatLarkError,
+  unixTimestampToISO8601
+} from "../helpers";
+const FeishuCalendarEventSchema = Type.Union([
+  // CREATE
+  Type.Object({
+    action: Type.Literal("create"),
+    start_time: Type.String({
+      description: "\u5F00\u59CB\u65F6\u95F4\uFF08\u5FC5\u586B\uFF09\u3002ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'"
+    }),
+    end_time: Type.String({
+      description: "\u7ED3\u675F\u65F6\u95F4\uFF08\u5FC5\u586B\uFF09\u3002\u683C\u5F0F\u540C start_time\u3002\u5982\u679C\u7528\u6237\u672A\u6307\u5B9A\u65F6\u957F\uFF0C\u9ED8\u8BA4\u4E3A\u5F00\u59CB\u65F6\u95F4\u540E1\u5C0F\u65F6\u3002"
+    }),
+    summary: Type.Optional(
+      Type.String({
+        description: "\u65E5\u7A0B\u6807\u9898\uFF08\u53EF\u9009\uFF0C\u4F46\u5F3A\u70C8\u5EFA\u8BAE\u63D0\u4F9B\uFF09"
+      })
+    ),
+    user_open_id: Type.Optional(
+      Type.String({
+        description: "\u5F53\u524D\u8BF7\u6C42\u7528\u6237\u7684 open_id\uFF08\u53EF\u9009\uFF0C\u4F46\u5F3A\u70C8\u5EFA\u8BAE\u63D0\u4F9B\uFF09\u3002\u4ECE\u6D88\u606F\u4E0A\u4E0B\u6587\u7684 SenderId \u5B57\u6BB5\u83B7\u53D6\uFF0C\u683C\u5F0F\u4E3A ou_xxx\u3002\u65E5\u7A0B\u521B\u5EFA\u5728\u5E94\u7528\u65E5\u5386\u4E0A\uFF0C\u5FC5\u987B\u901A\u8FC7\u6B64\u53C2\u6570\u5C06\u7528\u6237\u52A0\u4E3A\u53C2\u4F1A\u4EBA\uFF0C\u65E5\u7A0B\u624D\u4F1A\u51FA\u73B0\u5728\u7528\u6237\u7684\u98DE\u4E66\u65E5\u5386\u4E2D\u3002"
+      })
+    ),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    description: Type.Optional(
+      Type.String({
+        description: "\u65E5\u7A0B\u63CF\u8FF0"
+      })
+    ),
+    attendees: Type.Optional(
+      Type.Array(
+        Type.Object({
+          type: Type.Union([
+            Type.Literal("user"),
+            Type.Literal("chat"),
+            Type.Literal("resource"),
+            Type.Literal("third_party")
+          ]),
+          id: Type.String({
+            description: "Attendee open_id, chat_id, resource_id, or email"
+          })
+        }),
+        {
+          description: "\u53C2\u4F1A\u4EBA\u5217\u8868\uFF08\u5F3A\u70C8\u5EFA\u8BAE\u63D0\u4F9B\uFF0C\u5426\u5219\u65E5\u7A0B\u53EA\u5728\u5E94\u7528\u65E5\u5386\u4E0A\uFF0C\u7528\u6237\u770B\u4E0D\u5230\uFF09\u3002type='user' \u65F6 id \u586B open_id\uFF0Ctype='third_party' \u65F6 id \u586B\u90AE\u7BB1\u3002"
+        }
+      )
+    ),
+    vchat: Type.Optional(
+      Type.Object(
+        {
+          vc_type: Type.Optional(
+            Type.Union([Type.Literal("vc"), Type.Literal("third_party"), Type.Literal("no_meeting")], {
+              description: "\u89C6\u9891\u4F1A\u8BAE\u7C7B\u578B\uFF1Avc\uFF08\u98DE\u4E66\u89C6\u9891\u4F1A\u8BAE\uFF09\u3001third_party\uFF08\u7B2C\u4E09\u65B9\u94FE\u63A5\uFF09\u3001no_meeting\uFF08\u65E0\u89C6\u9891\u4F1A\u8BAE\uFF09\u3002\u9ED8\u8BA4\u4E3A\u7A7A\uFF0C\u9996\u6B21\u6DFB\u52A0\u53C2\u4E0E\u4EBA\u65F6\u81EA\u52A8\u751F\u6210\u98DE\u4E66\u89C6\u9891\u4F1A\u8BAE\u3002"
+            })
+          ),
+          icon_type: Type.Optional(
+            Type.Union([Type.Literal("vc"), Type.Literal("live"), Type.Literal("default")], {
+              description: "\u7B2C\u4E09\u65B9\u89C6\u9891\u4F1A\u8BAE icon \u7C7B\u578B\uFF08\u4EC5 vc_type=third_party \u65F6\u6709\u6548\uFF09\u3002"
+            })
+          ),
+          description: Type.Optional(
+            Type.String({
+              description: "\u7B2C\u4E09\u65B9\u89C6\u9891\u4F1A\u8BAE\u6587\u6848\uFF08\u4EC5 vc_type=third_party \u65F6\u6709\u6548\uFF09\u3002"
+            })
+          ),
+          meeting_url: Type.Optional(
+            Type.String({
+              description: "\u7B2C\u4E09\u65B9\u89C6\u9891\u4F1A\u8BAE\u94FE\u63A5\uFF08\u4EC5 vc_type=third_party \u65F6\u6709\u6548\uFF09\u3002"
+            })
+          )
+        },
+        {
+          description: "\u89C6\u9891\u4F1A\u8BAE\u4FE1\u606F\u3002\u4E0D\u4F20\u5219\u9ED8\u8BA4\u5728\u9996\u6B21\u6DFB\u52A0\u53C2\u4E0E\u4EBA\u65F6\u81EA\u52A8\u751F\u6210\u98DE\u4E66\u89C6\u9891\u4F1A\u8BAE\u3002"
+        }
+      )
+    ),
+    visibility: Type.Optional(
+      Type.Union([Type.Literal("default"), Type.Literal("public"), Type.Literal("private")], {
+        description: "\u65E5\u7A0B\u516C\u5F00\u8303\u56F4\u3002default\uFF08\u9ED8\u8BA4\uFF0C\u8DDF\u968F\u65E5\u5386\u6743\u9650\uFF09\u3001public\uFF08\u516C\u5F00\u8BE6\u60C5\uFF09\u3001private\uFF08\u79C1\u5BC6\uFF0C\u4EC5\u81EA\u5DF1\u53EF\u89C1\uFF09\u3002\u9ED8\u8BA4\u503C\uFF1Adefault\u3002"
+      })
+    ),
+    attendee_ability: Type.Optional(
+      Type.Union(
+        [
+          Type.Literal("none"),
+          Type.Literal("can_see_others"),
+          Type.Literal("can_invite_others"),
+          Type.Literal("can_modify_event")
+        ],
+        {
+          description: "\u53C2\u4E0E\u4EBA\u6743\u9650\u3002none\uFF08\u65E0\u6CD5\u7F16\u8F91\u3001\u9080\u8BF7\u3001\u67E5\u770B\uFF09\u3001can_see_others\uFF08\u53EF\u67E5\u770B\u53C2\u4E0E\u4EBA\u5217\u8868\uFF09\u3001can_invite_others\uFF08\u53EF\u9080\u8BF7\u5176\u4ED6\u4EBA\uFF09\u3001can_modify_event\uFF08\u53EF\u7F16\u8F91\u65E5\u7A0B\uFF09\u3002\u9ED8\u8BA4\u503C\uFF1Anone\u3002"
+        }
+      )
+    ),
+    free_busy_status: Type.Optional(
+      Type.Union([Type.Literal("busy"), Type.Literal("free")], {
+        description: "\u65E5\u7A0B\u5360\u7528\u7684\u5FD9\u95F2\u72B6\u6001\u3002busy\uFF08\u5FD9\u788C\uFF09\u3001free\uFF08\u7A7A\u95F2\uFF09\u3002\u9ED8\u8BA4\u503C\uFF1Abusy\u3002"
+      })
+    ),
+    location: Type.Optional(
+      Type.Object(
+        {
+          name: Type.Optional(
+            Type.String({
+              description: "\u5730\u70B9\u540D\u79F0"
+            })
+          ),
+          address: Type.Optional(
+            Type.String({
+              description: "\u5730\u70B9\u5730\u5740"
+            })
+          ),
+          latitude: Type.Optional(
+            Type.Number({
+              description: "\u5730\u70B9\u5750\u6807\u7EAC\u5EA6\uFF08\u56FD\u5185\u91C7\u7528 GCJ-02 \u6807\u51C6\uFF0C\u6D77\u5916\u91C7\u7528 WGS84 \u6807\u51C6\uFF09"
+            })
+          ),
+          longitude: Type.Optional(
+            Type.Number({
+              description: "\u5730\u70B9\u5750\u6807\u7ECF\u5EA6\uFF08\u56FD\u5185\u91C7\u7528 GCJ-02 \u6807\u51C6\uFF0C\u6D77\u5916\u91C7\u7528 WGS84 \u6807\u51C6\uFF09"
+            })
+          )
+        },
+        {
+          description: "\u65E5\u7A0B\u5730\u70B9\u4FE1\u606F"
+        }
+      )
+    ),
+    reminders: Type.Optional(
+      Type.Array(
+        Type.Object({
+          minutes: Type.Number({
+            description: "\u65E5\u7A0B\u63D0\u9192\u65F6\u95F4\u7684\u504F\u79FB\u91CF\uFF08\u5206\u949F\uFF09\u3002\u6B63\u6570\u8868\u793A\u5728\u65E5\u7A0B\u5F00\u59CB\u524D\u63D0\u9192\uFF0C\u8D1F\u6570\u8868\u793A\u5728\u65E5\u7A0B\u5F00\u59CB\u540E\u63D0\u9192\u3002\u8303\u56F4\uFF1A-20160 ~ 20160\u3002"
+          })
+        }),
+        {
+          description: "\u65E5\u7A0B\u63D0\u9192\u5217\u8868"
+        }
+      )
+    ),
+    recurrence: Type.Optional(
+      Type.String({
+        description: "\u91CD\u590D\u65E5\u7A0B\u7684\u91CD\u590D\u6027\u89C4\u5219\uFF08RFC5545 RRULE \u683C\u5F0F\uFF09\u3002\u4F8B\u5982\uFF1A'FREQ=DAILY;INTERVAL=1' \u8868\u793A\u6BCF\u5929\u91CD\u590D\u3002"
+      })
+    )
+  }),
+  // LIST (使用 instance_view 接口)
+  Type.Object({
+    action: Type.Literal("list"),
+    start_time: Type.String({
+      description: "\u5F00\u59CB\u65F6\u95F4\u3002ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\u3002\u6CE8\u610F\uFF1Astart_time \u4E0E end_time \u4E4B\u95F4\u7684\u65F6\u95F4\u533A\u95F4\u9700\u8981\u5C0F\u4E8E 40 \u5929\u3002"
+    }),
+    end_time: Type.String({
+      description: "\u7ED3\u675F\u65F6\u95F4\u3002\u683C\u5F0F\u540C start_time\u3002\u6CE8\u610F\uFF1Astart_time \u4E0E end_time \u4E4B\u95F4\u7684\u65F6\u95F4\u533A\u95F4\u9700\u8981\u5C0F\u4E8E 40 \u5929\u3002"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    )
+  }),
+  // GET
+  Type.Object({
+    action: Type.Literal("get"),
+    event_id: Type.String({
+      description: "Event ID"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    )
+  }),
+  // PATCH (P1)
+  Type.Object({
+    action: Type.Literal("patch"),
+    event_id: Type.String({
+      description: "Event ID"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    summary: Type.Optional(
+      Type.String({
+        description: "\u65B0\u7684\u65E5\u7A0B\u6807\u9898"
+      })
+    ),
+    description: Type.Optional(
+      Type.String({
+        description: "\u65B0\u7684\u65E5\u7A0B\u63CF\u8FF0"
+      })
+    ),
+    start_time: Type.Optional(
+      Type.String({
+        description: "\u65B0\u7684\u5F00\u59CB\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+      })
+    ),
+    end_time: Type.Optional(
+      Type.String({
+        description: "\u65B0\u7684\u7ED3\u675F\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+      })
+    ),
+    location: Type.Optional(
+      Type.String({
+        description: "\u65B0\u7684\u5730\u70B9"
+      })
+    )
+  }),
+  // DELETE (P1)
+  Type.Object({
+    action: Type.Literal("delete"),
+    event_id: Type.String({
+      description: "Event ID"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    need_notification: Type.Optional(
+      Type.Boolean({
+        description: "\u662F\u5426\u901A\u77E5\u53C2\u4F1A\u4EBA\uFF08\u9ED8\u8BA4 true\uFF09"
+      })
+    )
+  }),
+  // SEARCH (P1)
+  Type.Object({
+    action: Type.Literal("search"),
+    query: Type.String({
+      description: "\u641C\u7D22\u5173\u952E\u8BCD"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    page_size: Type.Optional(
+      Type.Number({
+        description: "\u6BCF\u9875\u6570\u91CF"
+      })
+    ),
+    page_token: Type.Optional(
+      Type.String({
+        description: "\u5206\u9875\u6807\u8BB0"
+      })
+    )
+  }),
+  // REPLY (P1)
+  Type.Object({
+    action: Type.Literal("reply"),
+    event_id: Type.String({
+      description: "Event ID"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    rsvp_status: Type.Union([Type.Literal("accept"), Type.Literal("decline"), Type.Literal("tentative")])
+  }),
+  // INSTANCES (P1)
+  Type.Object({
+    action: Type.Literal("instances"),
+    event_id: Type.String({
+      description: "\u91CD\u590D\u65E5\u7A0B\u7684 Event ID"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    start_time: Type.String({
+      description: "\u67E5\u8BE2\u8D77\u59CB\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+    }),
+    end_time: Type.String({
+      description: "\u67E5\u8BE2\u7ED3\u675F\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+    }),
+    page_size: Type.Optional(
+      Type.Number({
+        description: "\u6BCF\u9875\u6570\u91CF"
+      })
+    ),
+    page_token: Type.Optional(
+      Type.String({
+        description: "\u5206\u9875\u6807\u8BB0"
+      })
+    )
+  }),
+  // INSTANCE_VIEW (P1)
+  Type.Object({
+    action: Type.Literal("instance_view"),
+    start_time: Type.String({
+      description: "\u67E5\u8BE2\u8D77\u59CB\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+    }),
+    end_time: Type.String({
+      description: "\u67E5\u8BE2\u7ED3\u675F\u65F6\u95F4\uFF08ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\uFF09"
+    }),
+    calendar_id: Type.Optional(
+      Type.String({
+        description: "Calendar ID (optional; primary calendar used if omitted)"
+      })
+    ),
+    page_size: Type.Optional(
+      Type.Number({
+        description: "\u6BCF\u9875\u6570\u91CF"
+      })
+    ),
+    page_token: Type.Optional(
+      Type.String({
+        description: "\u5206\u9875\u6807\u8BB0"
+      })
+    )
+  })
+]);
+function normalizeCalendarTimeValue(value) {
+  if (value === null || value === void 0) return void 0;
+  if (typeof value === "string") {
+    const iso = unixTimestampToISO8601(value);
+    return iso ?? value;
+  }
+  if (typeof value !== "object") return void 0;
+  const timeObj = value;
+  const fromTimestamp = unixTimestampToISO8601(timeObj.timestamp);
+  if (fromTimestamp) return fromTimestamp;
+  if (typeof timeObj.date === "string") return timeObj.date;
+  return void 0;
+}
+function normalizeEventTimeFields(event) {
+  if (!event) return event;
+  const normalized = { ...event };
+  const startTime = normalizeCalendarTimeValue(event.start_time);
+  if (startTime) {
+    normalized.start_time = startTime;
+  }
+  const endTime = normalizeCalendarTimeValue(event.end_time);
+  if (endTime) {
+    normalized.end_time = endTime;
+  }
+  const createTime = unixTimestampToISO8601(event.create_time);
+  if (createTime) {
+    normalized.create_time = createTime;
+  }
+  return normalized;
+}
+function normalizeEventListTimeFields(events) {
+  if (!events) return events;
+  return events.map((item) => normalizeEventTimeFields(item));
+}
+function registerFeishuCalendarEventTool(api) {
+  if (!api.config) return;
+  const cfg = api.config;
+  const { toolClient, log } = createToolContext(api, "feishu_calendar_event");
+  const resolveCalendarId = async (client) => {
+    const primaryRes = await client.invoke(
+      "feishu_calendar_calendar.primary",
+      (sdk, opts) => sdk.calendar.calendar.primary({}, opts),
+      { as: "user" }
+    );
+    const data = primaryRes.data;
+    const cid = data?.calendars?.[0]?.calendar?.calendar_id;
+    if (cid) {
+      log.info(`resolveCalendarId: primary() returned calendar_id=${cid}`);
+      return cid;
+    }
+    return null;
+  };
+  const resolveCalendarIdOrFail = async (calendarId, client) => {
+    if (calendarId) return calendarId;
+    const resolved = await resolveCalendarId(client);
+    if (!resolved) throw new Error("Could not determine primary calendar");
+    return resolved;
+  };
+  api.registerTool(
+    {
+      name: "feishu_calendar_event",
+      label: "Feishu Calendar Events",
+      description: "\u3010\u4EE5\u7528\u6237\u8EAB\u4EFD\u3011\u98DE\u4E66\u65E5\u7A0B\u7BA1\u7406\u5DE5\u5177\u3002\u5F53\u7528\u6237\u8981\u6C42\u67E5\u770B\u65E5\u7A0B\u3001\u521B\u5EFA\u4F1A\u8BAE\u3001\u7EA6\u4F1A\u8BAE\u3001\u4FEE\u6539\u65E5\u7A0B\u3001\u5220\u9664\u65E5\u7A0B\u3001\u641C\u7D22\u65E5\u7A0B\u3001\u56DE\u590D\u65E5\u7A0B\u9080\u8BF7\u65F6\u4F7F\u7528\u3002Actions: create\uFF08\u521B\u5EFA\u65E5\u5386\u4E8B\u4EF6\uFF09, list\uFF08\u67E5\u8BE2\u65F6\u95F4\u8303\u56F4\u5185\u7684\u65E5\u7A0B\uFF0C\u81EA\u52A8\u5C55\u5F00\u91CD\u590D\u65E5\u7A0B\uFF09, get\uFF08\u83B7\u53D6\u65E5\u7A0B\u8BE6\u60C5\uFF09, patch\uFF08\u66F4\u65B0\u65E5\u7A0B\uFF09, delete\uFF08\u5220\u9664\u65E5\u7A0B\uFF09, search\uFF08\u641C\u7D22\u65E5\u7A0B\uFF09, reply\uFF08\u56DE\u590D\u65E5\u7A0B\u9080\u8BF7\uFF09, instances\uFF08\u83B7\u53D6\u91CD\u590D\u65E5\u7A0B\u7684\u5B9E\u4F8B\u5217\u8868\uFF0C\u4EC5\u5BF9\u91CD\u590D\u65E5\u7A0B\u6709\u6548\uFF09, instance_view\uFF08\u67E5\u770B\u5C55\u5F00\u540E\u7684\u65E5\u7A0B\u5217\u8868\uFF09\u3002\u3010\u91CD\u8981\u3011create \u65F6\u5FC5\u987B\u4F20 user_open_id \u53C2\u6570\uFF0C\u503C\u4E3A\u6D88\u606F\u4E0A\u4E0B\u6587\u4E2D\u7684 SenderId\uFF08\u683C\u5F0F ou_xxx\uFF09\uFF0C\u5426\u5219\u65E5\u7A0B\u53EA\u5728\u5E94\u7528\u65E5\u5386\u4E0A\uFF0C\u7528\u6237\u5B8C\u5168\u770B\u4E0D\u5230\u3002list \u64CD\u4F5C\u4F7F\u7528 instance_view \u63A5\u53E3\uFF0C\u4F1A\u81EA\u52A8\u5C55\u5F00\u91CD\u590D\u65E5\u7A0B\u4E3A\u591A\u4E2A\u5B9E\u4F8B\uFF0C\u65F6\u95F4\u533A\u95F4\u4E0D\u80FD\u8D85\u8FC740\u5929\uFF0C\u8FD4\u56DE\u5B9E\u4F8B\u6570\u91CF\u4E0A\u96501000\u3002\u65F6\u95F4\u53C2\u6570\u4F7F\u7528ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'\u3002",
+      parameters: FeishuCalendarEventSchema,
+      async execute(_toolCallId, params) {
+        const p = params;
+        try {
+          const client = toolClient();
+          switch (p.action) {
+            // -----------------------------------------------------------------
+            // CREATE EVENT
+            // -----------------------------------------------------------------
+            case "create": {
+              if (!p.summary) return json({ error: "summary is required" });
+              if (!p.start_time) return json({ error: "start_time is required" });
+              if (!p.end_time) return json({ error: "end_time is required" });
+              const startTs = parseTimeToTimestamp(p.start_time);
+              const endTs = parseTimeToTimestamp(p.end_time);
+              if (!startTs || !endTs)
+                return json({
+                  error: "Invalid time format. Must use ISO 8601 / RFC 3339 with timezone, e.g. '2024-01-01T00:00:00+08:00' or '2026-02-25 14:00:00'. Do not pass Unix timestamp numbers.",
+                  received_start: p.start_time,
+                  received_end: p.end_time
+                });
+              log.info(
+                `create: summary=${p.summary}, start_time=${p.start_time} -> ts=${startTs}, end_time=${p.end_time} -> ts=${endTs}, user_open_id=${p.user_open_id ?? "MISSING"}, attendees=${JSON.stringify(p.attendees ?? [])}, vchat=${p.vchat?.vc_type ?? "auto"}, location=${p.location?.name ?? "none"}`
+              );
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              const eventData = {
+                summary: p.summary,
+                start_time: { timestamp: startTs },
+                end_time: { timestamp: endTs },
+                need_notification: true,
+                attendee_ability: p.attendee_ability ?? "can_modify_event"
+              };
+              if (p.description) eventData.description = p.description;
+              if (p.vchat) {
+                eventData.vchat = {};
+                if (p.vchat.vc_type) eventData.vchat.vc_type = p.vchat.vc_type;
+                if (p.vchat.icon_type) eventData.vchat.icon_type = p.vchat.icon_type;
+                if (p.vchat.description) eventData.vchat.description = p.vchat.description;
+                if (p.vchat.meeting_url) eventData.vchat.meeting_url = p.vchat.meeting_url;
+              }
+              if (p.visibility) eventData.visibility = p.visibility;
+              if (p.free_busy_status) eventData.free_busy_status = p.free_busy_status;
+              if (p.location) {
+                eventData.location = {};
+                if (p.location.name) eventData.location.name = p.location.name;
+                if (p.location.address) eventData.location.address = p.location.address;
+                if (p.location.latitude !== void 0) eventData.location.latitude = p.location.latitude;
+                if (p.location.longitude !== void 0) eventData.location.longitude = p.location.longitude;
+              }
+              if (p.reminders) {
+                eventData.reminders = p.reminders.map((r) => ({ minutes: r.minutes }));
+              }
+              if (p.recurrence) eventData.recurrence = p.recurrence;
+              const res = await client.invoke(
+                "feishu_calendar_event.create",
+                (sdk, opts) => sdk.calendar.calendarEvent.create(
+                  {
+                    path: { calendar_id: calendarId },
+                    data: eventData
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              log.info(`event created: event_id=${res.data?.event?.event_id}`);
+              const allAttendees = [...p.attendees ?? []];
+              if (p.user_open_id) {
+                const alreadyIncluded = allAttendees.some((a) => a.type === "user" && a.id === p.user_open_id);
+                if (!alreadyIncluded) {
+                  allAttendees.push({ type: "user", id: p.user_open_id });
+                }
+              }
+              log.info(`allAttendees=${JSON.stringify(allAttendees)}`);
+              let attendeeError;
+              const operateId = p.user_open_id ?? p.attendees?.find((a) => a.type === "user")?.id;
+              if (allAttendees.length > 0 && res.data?.event?.event_id) {
+                const attendeeData = allAttendees.map((a) => ({
+                  type: a.type,
+                  user_id: a.type === "user" ? a.id : void 0,
+                  chat_id: a.type === "chat" ? a.id : void 0,
+                  room_id: a.type === "resource" ? a.id : void 0,
+                  third_party_email: a.type === "third_party" ? a.id : void 0,
+                  operate_id: operateId
+                }));
+                try {
+                  const attendeeRes = await client.invoke(
+                    "feishu_calendar_event.create",
+                    (sdk, opts) => sdk.calendar.calendarEventAttendee.create(
+                      {
+                        path: {
+                          calendar_id: calendarId,
+                          event_id: res.data?.event?.event_id
+                        },
+                        params: { user_id_type: "open_id" },
+                        data: {
+                          attendees: attendeeData,
+                          need_notification: true
+                        }
+                      },
+                      opts
+                    ),
+                    { as: "user" }
+                  );
+                  assertLarkOk(attendeeRes);
+                  log.info(`attendee API response: ${JSON.stringify(attendeeRes.data)}`);
+                } catch (attendeeErr) {
+                  attendeeError = formatLarkError(attendeeErr);
+                  log.info(`attendee add FAILED: ${attendeeError}`);
+                }
+              }
+              const appLink = res.data?.event?.app_link;
+              const safeEvent = res.data?.event ? {
+                event_id: res.data.event.event_id,
+                summary: res.data.event.summary,
+                app_link: appLink,
+                start_time: unixTimestampToISO8601(startTs) ?? p.start_time,
+                end_time: unixTimestampToISO8601(endTs) ?? p.end_time
+              } : void 0;
+              const result = {
+                event: safeEvent,
+                attendees: allAttendees.map((a) => ({
+                  type: a.type,
+                  id: a.id
+                })),
+                _debug: {
+                  calendar_id: calendarId,
+                  operate_id: operateId,
+                  start_input: p.start_time,
+                  start_iso8601: unixTimestampToISO8601(startTs) ?? p.start_time,
+                  end_input: p.end_time,
+                  end_iso8601: unixTimestampToISO8601(endTs) ?? p.end_time,
+                  attendees_count: allAttendees.length
+                }
+              };
+              if (attendeeError) {
+                result.warning = `\u65E5\u7A0B\u5DF2\u521B\u5EFA\uFF0C\u4F46\u6DFB\u52A0\u53C2\u4F1A\u4EBA\u5931\u8D25\uFF1A${attendeeError}`;
+              } else if (allAttendees.length === 0) {
+                result.error = "\u65E5\u7A0B\u5DF2\u521B\u5EFA\u5728\u5E94\u7528\u65E5\u5386\u4E0A\uFF0C\u4F46\u672A\u6DFB\u52A0\u4EFB\u4F55\u53C2\u4F1A\u4EBA\uFF0C\u7528\u6237\u770B\u4E0D\u5230\u6B64\u65E5\u7A0B\u3002\u8BF7\u91CD\u65B0\u8C03\u7528\u65F6\u4F20\u5165 user_open_id \u53C2\u6570\u3002";
+              } else {
+                result.note = `\u5DF2\u6210\u529F\u6DFB\u52A0 ${allAttendees.length} \u4F4D\u53C2\u4F1A\u4EBA\uFF0C\u65E5\u7A0B\u5E94\u51FA\u73B0\u5728\u53C2\u4F1A\u4EBA\u7684\u98DE\u4E66\u65E5\u5386\u4E2D\u3002`;
+              }
+              return json(result);
+            }
+            // -----------------------------------------------------------------
+            // LIST EVENTS (使用 instance_view 接口，自动展开重复日程)
+            // -----------------------------------------------------------------
+            case "list": {
+              if (!p.start_time) return json({ error: "start_time is required" });
+              if (!p.end_time) return json({ error: "end_time is required" });
+              const startTs = parseTimeToTimestamp(p.start_time);
+              const endTs = parseTimeToTimestamp(p.end_time);
+              if (!startTs || !endTs)
+                return json({
+                  error: "Invalid time format. Must use ISO 8601 / RFC 3339 with timezone, e.g. '2024-01-01T00:00:00+08:00' or '2026-02-25 14:00:00'. Do not pass Unix timestamps.",
+                  received_start: p.start_time,
+                  received_end: p.end_time
+                });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              log.info(
+                `list: calendar_id=${calendarId}, start_time=${startTs}, end_time=${endTs} (using instance_view)`
+              );
+              const res = 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,
+                      user_id_type: "open_id"
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              const data = res.data;
+              log.info(`list: returned ${data?.items?.length ?? 0} event instances`);
+              return json({
+                events: normalizeEventListTimeFields(data?.items),
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token
+              });
+            }
+            // -----------------------------------------------------------------
+            // GET EVENT
+            // -----------------------------------------------------------------
+            case "get": {
+              if (!p.event_id) return json({ error: "event_id is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              log.info(`get: calendar_id=${calendarId}, event_id=${p.event_id}`);
+              const res = await client.invoke(
+                "feishu_calendar_event.get",
+                (sdk, opts) => sdk.calendar.calendarEvent.get(
+                  {
+                    path: { calendar_id: calendarId, event_id: p.event_id }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              log.info(`get: retrieved event ${p.event_id}`);
+              return json({
+                event: normalizeEventTimeFields(res.data?.event)
+              });
+            }
+            // -----------------------------------------------------------------
+            // PATCH EVENT (P1)
+            // -----------------------------------------------------------------
+            case "patch": {
+              if (!p.event_id) return json({ error: "event_id is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              const updateData = {};
+              if (p.start_time) {
+                const startTs = parseTimeToTimestamp(p.start_time);
+                if (!startTs)
+                  return json({
+                    error: "start_time \u683C\u5F0F\u9519\u8BEF\uFF01\u5FC5\u987B\u4F7F\u7528ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'",
+                    received: p.start_time
+                  });
+                updateData.start_time = { timestamp: startTs };
+              }
+              if (p.end_time) {
+                const endTs = parseTimeToTimestamp(p.end_time);
+                if (!endTs)
+                  return json({
+                    error: "end_time \u683C\u5F0F\u9519\u8BEF\uFF01\u5FC5\u987B\u4F7F\u7528ISO 8601 / RFC 3339 \u683C\u5F0F\uFF08\u5305\u542B\u65F6\u533A\uFF09\uFF0C\u4F8B\u5982 '2024-01-01T00:00:00+08:00'",
+                    received: p.end_time
+                  });
+                updateData.end_time = { timestamp: endTs };
+              }
+              if (p.summary) updateData.summary = p.summary;
+              if (p.description) updateData.description = p.description;
+              if (p.location) updateData.location = { name: p.location };
+              log.info(
+                `patch: calendar_id=${calendarId}, event_id=${p.event_id}, fields=${Object.keys(updateData).join(",")}`
+              );
+              const res = await client.invoke(
+                "feishu_calendar_event.patch",
+                (sdk, opts) => sdk.calendar.calendarEvent.patch(
+                  {
+                    path: { calendar_id: calendarId, event_id: p.event_id },
+                    data: updateData
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              log.info(`patch: updated event ${p.event_id}`);
+              return json({
+                event: normalizeEventTimeFields(res.data?.event)
+              });
+            }
+            // -----------------------------------------------------------------
+            // DELETE EVENT (P1)
+            // -----------------------------------------------------------------
+            case "delete": {
+              if (!p.event_id) return json({ error: "event_id is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              log.info(
+                `delete: calendar_id=${calendarId}, event_id=${p.event_id}, notify=${p.need_notification ?? true}`
+              );
+              const res = await client.invoke(
+                "feishu_calendar_event.delete",
+                (sdk, opts) => sdk.calendar.calendarEvent.delete(
+                  {
+                    path: { calendar_id: calendarId, event_id: p.event_id },
+                    params: {
+                      need_notification: p.need_notification ?? true
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              log.info(`delete: deleted event ${p.event_id}`);
+              return json({
+                success: true,
+                event_id: p.event_id
+              });
+            }
+            // -----------------------------------------------------------------
+            // SEARCH EVENT (P1)
+            // -----------------------------------------------------------------
+            case "search": {
+              if (!p.query) return json({ error: "query is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              log.info(`search: calendar_id=${calendarId}, query=${p.query}, page_size=${p.page_size ?? 50}`);
+              const res = await client.invoke(
+                "feishu_calendar_event.search",
+                (sdk, opts) => sdk.calendar.calendarEvent.search(
+                  {
+                    path: { calendar_id: calendarId },
+                    params: {
+                      page_size: p.page_size,
+                      page_token: p.page_token
+                    },
+                    data: {
+                      query: p.query
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              const data = res.data;
+              log.info(`search: found ${data?.items?.length ?? 0} events`);
+              return json({
+                events: normalizeEventListTimeFields(data?.items),
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token
+              });
+            }
+            // -----------------------------------------------------------------
+            // REPLY EVENT (P1)
+            // -----------------------------------------------------------------
+            case "reply": {
+              if (!p.event_id) return json({ error: "event_id is required" });
+              if (!p.rsvp_status) return json({ error: "rsvp_status is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              log.info(`reply: calendar_id=${calendarId}, event_id=${p.event_id}, rsvp=${p.rsvp_status}`);
+              const res = await client.invoke(
+                "feishu_calendar_event.reply",
+                (sdk, opts) => sdk.calendar.calendarEvent.reply(
+                  {
+                    path: { calendar_id: calendarId, event_id: p.event_id },
+                    data: {
+                      rsvp_status: p.rsvp_status
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              log.info(`reply: replied to event ${p.event_id} with ${p.rsvp_status}`);
+              return json({
+                success: true,
+                event_id: p.event_id,
+                rsvp_status: p.rsvp_status
+              });
+            }
+            // -----------------------------------------------------------------
+            // INSTANCES (P1)
+            // -----------------------------------------------------------------
+            case "instances": {
+              if (!p.event_id) return json({ error: "event_id is required" });
+              if (!p.start_time) return json({ error: "start_time is required" });
+              if (!p.end_time) return json({ error: "end_time is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              const startTs = parseTimeToTimestamp(p.start_time);
+              const endTs = parseTimeToTimestamp(p.end_time);
+              if (!startTs || !endTs)
+                return json({
+                  error: "Invalid time format. Must use ISO 8601 / RFC 3339 with timezone, e.g. '2024-01-01T00:00:00+08:00'",
+                  received_start: p.start_time,
+                  received_end: p.end_time
+                });
+              log.info(`instances: calendar_id=${calendarId}, event_id=${p.event_id}, start=${startTs}, end=${endTs}`);
+              const res = await client.invoke(
+                "feishu_calendar_event.instances",
+                (sdk, opts) => sdk.calendar.calendarEvent.instances(
+                  {
+                    path: { calendar_id: calendarId, event_id: p.event_id },
+                    params: {
+                      start_time: startTs,
+                      end_time: endTs,
+                      page_size: p.page_size,
+                      page_token: p.page_token
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              const data = res.data;
+              log.info(`instances: returned ${data?.items?.length ?? 0} instances`);
+              return json({
+                instances: normalizeEventListTimeFields(data?.items),
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token
+              });
+            }
+            // -----------------------------------------------------------------
+            // INSTANCE_VIEW (P1)
+            // -----------------------------------------------------------------
+            case "instance_view": {
+              if (!p.start_time) return json({ error: "start_time is required" });
+              if (!p.end_time) return json({ error: "end_time is required" });
+              const calendarId = await resolveCalendarIdOrFail(p.calendar_id, client);
+              const startTs = parseTimeToTimestamp(p.start_time);
+              const endTs = parseTimeToTimestamp(p.end_time);
+              if (!startTs || !endTs)
+                return json({
+                  error: "Invalid time format. Must use ISO 8601 / RFC 3339 with timezone, e.g. '2024-01-01T00:00:00+08:00'",
+                  received_start: p.start_time,
+                  received_end: p.end_time
+                });
+              log.info(`instance_view: calendar_id=${calendarId}, start=${startTs}, end=${endTs}`);
+              const res = 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,
+                      user_id_type: "open_id"
+                    }
+                  },
+                  opts
+                ),
+                { as: "user" }
+              );
+              assertLarkOk(res);
+              const data = res.data;
+              log.info(`instance_view: returned ${data?.items?.length ?? 0} events`);
+              return json({
+                events: normalizeEventListTimeFields(data?.items),
+                has_more: data?.has_more ?? false,
+                page_token: data?.page_token
+              });
+            }
+          }
+        } catch (err) {
+          return await handleInvokeErrorWithAutoAuth(err, cfg);
+        }
+      }
+    },
+    { name: "feishu_calendar_event" }
+  );
+  api.logger.info?.("feishu_calendar_event: Registered feishu_calendar_event tool");
+}
+export {
+  registerFeishuCalendarEventTool
+};
+//# sourceMappingURL=event.js.map