feishu-user-plugin 1.3.0 → 1.3.2

package/src/index.js

@@ -144,12 +144,17 @@ const TOOLS = [
   // ========== User Identity — Send Messages ==========
   {
     name: 'send_as_user',
-    description: '[User Identity] Send a text message as the logged-in Feishu user. Supports reply threading.',
+    description: '[User Identity] Send a text message as the logged-in Feishu user. Supports reply threading and real @-mentions (triggers push notifications).',
     inputSchema: {
       type: 'object',
       properties: {
         chat_id: { type: 'string', description: 'Target chat ID (numeric)' },
-        text: { type: 'string', description: 'Message text' },
+        text: { type: 'string', description: 'Message text. If `ats` is provided, include the display marker for each @ in this text (default marker is `@<name>`).' },
+        ats: {
+          type: 'array',
+          description: 'Optional @-mentions. Each entry: {userId: "ou_xxx", name: "DisplayName"}. The text must contain each @<name> marker in order — it gets spliced into a real AT element so the mentioned user receives a notification.',
+          items: { type: 'object', properties: { userId: { type: 'string' }, name: { type: 'string' }, marker: { type: 'string' } } },
+        },
         root_id: { type: 'string', description: 'Thread root message ID (for reply, optional)' },
         parent_id: { type: 'string', description: 'Parent message ID (for nested reply, optional)' },
       },
@@ -164,6 +169,11 @@ const TOOLS = [
       properties: {
         user_name: { type: 'string', description: 'Recipient name (Chinese or English)' },
         text: { type: 'string', description: 'Message text' },
+        ats: {
+          type: 'array',
+          description: 'Optional @-mentions. Same format as send_as_user.ats: [{userId, name}]. Text must contain the `@<name>` marker for each entry.',
+          items: { type: 'object', properties: { userId: { type: 'string' }, name: { type: 'string' }, marker: { type: 'string' } } },
+        },
       },
       required: ['user_name', 'text'],
     },
@@ -176,6 +186,11 @@ const TOOLS = [
       properties: {
         group_name: { type: 'string', description: 'Group chat name' },
         text: { type: 'string', description: 'Message text' },
+        ats: {
+          type: 'array',
+          description: 'Optional @-mentions that trigger real notifications. Each entry: {userId, name}. Text must contain `@<name>` marker for each entry.',
+          items: { type: 'object', properties: { userId: { type: 'string' }, name: { type: 'string' }, marker: { type: 'string' } } },
+        },
       },
       required: ['group_name', 'text'],
     },
@@ -222,7 +237,7 @@ const TOOLS = [
   },
   {
     name: 'send_post_as_user',
-    description: '[User Identity] Send a rich text (POST) message with title and formatted paragraphs.',
+    description: '[User Identity] Send a rich text (POST) message with title and formatted paragraphs. Supports real @-mentions that trigger notifications.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -230,7 +245,7 @@ const TOOLS = [
         title: { type: 'string', description: 'Post title (optional)' },
         paragraphs: {
           type: 'array',
-          description: 'Array of paragraphs. Each paragraph is an array of elements: {tag:"text",text:"..."} or {tag:"a",href:"...",text:"..."} or {tag:"at",userId:"..."}',
+          description: 'Array of paragraphs. Each paragraph is an array of elements:\n• {tag:"text",text:"..."} — plain text\n• {tag:"a",href:"https://...",text:"display"} — hyperlink\n• {tag:"at",userId:"ou_xxx",name:"Display Name"} — real @-mention (triggers notification)',
           items: { type: 'array', items: { type: 'object' } },
         },
         root_id: { type: 'string', description: 'Thread root message ID (optional)' },
@@ -541,49 +556,9 @@ const TOOLS = [
       required: ['app_token', 'table_id'],
     },
   },
-  {
-    name: 'create_bitable_record',
-    description: '[Official API] Create a new record (row) in a Bitable table.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        app_token: { type: 'string', description: 'Bitable app token' },
-        table_id: { type: 'string', description: 'Table ID' },
-        fields: { type: 'object', description: 'Field name → value mapping' },
-      },
-      required: ['app_token', 'table_id', 'fields'],
-    },
-  },
-  {
-    name: 'update_bitable_record',
-    description: '[Official API] Update an existing record in a Bitable table.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        app_token: { type: 'string', description: 'Bitable app token' },
-        table_id: { type: 'string', description: 'Table ID' },
-        record_id: { type: 'string', description: 'Record ID to update' },
-        fields: { type: 'object', description: 'Field name → new value mapping' },
-      },
-      required: ['app_token', 'table_id', 'record_id', 'fields'],
-    },
-  },
-  {
-    name: 'delete_bitable_record',
-    description: '[Official API] Delete a record (row) from a Bitable table.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        app_token: { type: 'string', description: 'Bitable app token' },
-        table_id: { type: 'string', description: 'Table ID' },
-        record_id: { type: 'string', description: 'Record ID to delete' },
-      },
-      required: ['app_token', 'table_id', 'record_id'],
-    },
-  },
   {
     name: 'batch_create_bitable_records',
-    description: '[Official API] Batch create multiple records (rows) in a Bitable table. Max 500 per call.',
+    description: '[Official API] Create one or more records (rows) in a Bitable table. Pass a single record or up to 500.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -596,7 +571,7 @@ const TOOLS = [
   },
   {
     name: 'batch_update_bitable_records',
-    description: '[Official API] Batch update multiple records in a Bitable table. Max 500 per call.',
+    description: '[Official API] Update one or more records in a Bitable table. Pass a single record or up to 500.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -609,7 +584,7 @@ const TOOLS = [
   },
   {
     name: 'batch_delete_bitable_records',
-    description: '[Official API] Batch delete multiple records from a Bitable table. Max 500 per call.',
+    description: '[Official API] Delete one or more records from a Bitable table. Pass a single ID or up to 500.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -714,13 +689,13 @@ const TOOLS = [
   // ========== IM — Bot Send / Edit / Delete ==========
   {
     name: 'send_message_as_bot',
-    description: '[Official API] Send a message as the bot to any chat. Supports text, post, interactive, etc.',
+    description: '[Official API] Send a message as the bot to any chat. Supports text, post, interactive, etc. This is the reliable path for @-mentions: include `<at user_id="ou_xxx">Name</at>` inline in text content and Feishu resolves it to a real @-notification.',
     inputSchema: {
       type: 'object',
       properties: {
         chat_id: { type: 'string', description: 'Target chat_id (oc_xxx) or open_id' },
         msg_type: { type: 'string', description: 'Message type: text, post, image, interactive, etc.', enum: ['text', 'post', 'image', 'interactive', 'share_chat', 'share_user', 'audio', 'media', 'file', 'sticker'] },
-        content: { description: 'Message content (string or object, auto-serialized). For text: {"text":"hello"}' },
+        content: { description: 'Message content (string or object, auto-serialized). Plain text: {"text":"hello"}. Text with @-mention: {"text":"<at user_id=\\"ou_xxx\\">Alice</at> hi"} — the inline tag becomes a real @-notification.' },
       },
       required: ['chat_id', 'msg_type', 'content'],
     },
@@ -777,19 +752,13 @@ const TOOLS = [
   // ========== IM — Pin Messages ==========
   {
     name: 'pin_message',
-    description: '[Official API] Pin a message in a chat.',
+    description: '[Official API] Pin or unpin a message in a chat.',
     inputSchema: {
       type: 'object',
-      properties: { message_id: { type: 'string', description: 'Message ID to pin' } },
-      required: ['message_id'],
-    },
-  },
-  {
-    name: 'unpin_message',
-    description: '[Official API] Unpin a message from a chat.',
-    inputSchema: {
-      type: 'object',
-      properties: { message_id: { type: 'string', description: 'Message ID to unpin' } },
+      properties: {
+        message_id: { type: 'string', description: 'Message ID' },
+        pinned: { type: 'boolean', description: 'true to pin, false to unpin', default: true },
+      },
       required: ['message_id'],
     },
   },
@@ -835,27 +804,16 @@ const TOOLS = [
     },
   },
   {
-    name: 'add_members',
-    description: '[Official API] Add users to a group chat.',
+    name: 'manage_members',
+    description: '[Official API] Add or remove members from a group chat.',
     inputSchema: {
       type: 'object',
       properties: {
-        chat_id: { type: 'string', description: 'Chat ID (oc_xxx)' },
-        user_ids: { type: 'array', items: { type: 'string' }, description: 'Array of user open_ids to add' },
+        chat_id: { type: 'string', description: 'Group chat ID (oc_xxx)' },
+        member_ids: { type: 'array', items: { type: 'string' }, description: 'Array of user open_ids' },
+        action: { type: 'string', enum: ['add', 'remove'], description: 'Action to perform' },
       },
-      required: ['chat_id', 'user_ids'],
-    },
-  },
-  {
-    name: 'remove_members',
-    description: '[Official API] Remove users from a group chat.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        chat_id: { type: 'string', description: 'Chat ID (oc_xxx)' },
-        user_ids: { type: 'array', items: { type: 'string' }, description: 'Array of user open_ids to remove' },
-      },
-      required: ['chat_id', 'user_ids'],
+      required: ['chat_id', 'member_ids', 'action'],
     },
   },
 
@@ -929,165 +887,111 @@ const TOOLS = [
     },
   },
 
-  // ========== Drive — File Operations ==========
   {
-    name: 'copy_file',
-    description: '[Official API] Copy a file/doc in Drive.',
+    name: 'get_bitable_meta',
+    description: '[Official API] Get metadata of a Bitable app (name, revision, etc.).',
     inputSchema: {
       type: 'object',
       properties: {
-        file_token: { type: 'string', description: 'File token to copy' },
-        name: { type: 'string', description: 'New file name' },
-        folder_token: { type: 'string', description: 'Destination folder token (optional)' },
-        type: { type: 'string', description: 'File type: file, doc, sheet, bitable, docx, mindnote, slides (optional)' },
-      },
-      required: ['file_token', 'name'],
-    },
-  },
-  {
-    name: 'move_file',
-    description: '[Official API] Move a file to another folder in Drive.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        file_token: { type: 'string', description: 'File token to move' },
-        folder_token: { type: 'string', description: 'Destination folder token' },
-      },
-      required: ['file_token', 'folder_token'],
-    },
-  },
-  {
-    name: 'delete_file',
-    description: '[Official API] Delete a file/folder from Drive.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        file_token: { type: 'string', description: 'File token to delete' },
-        type: { type: 'string', description: 'Type: file, folder, doc, sheet, bitable, docx, mindnote, slides' },
+        app_token: { type: 'string', description: 'Bitable app token' },
       },
-      required: ['file_token'],
+      required: ['app_token'],
     },
   },
-
-  // ========== Calendar ==========
   {
-    name: 'list_calendars',
-    description: '[Official API] List all calendars accessible by the bot.',
-    inputSchema: { type: 'object', properties: {} },
-  },
-  {
-    name: 'create_calendar_event',
-    description: '[Official API] Create a calendar event.',
+    name: 'update_bitable_table',
+    description: '[Official API] Rename a data table in a Bitable app.',
     inputSchema: {
       type: 'object',
       properties: {
-        calendar_id: { type: 'string', description: 'Calendar ID (from list_calendars)' },
-        summary: { type: 'string', description: 'Event title' },
-        start_time: { type: 'string', description: 'Start time (RFC3339 or Unix timestamp string)' },
-        end_time: { type: 'string', description: 'End time (RFC3339 or Unix timestamp string)' },
-        description: { type: 'string', description: 'Event description (optional)' },
-        location: { type: 'string', description: 'Event location (optional)' },
+        app_token: { type: 'string', description: 'Bitable app token' },
+        table_id: { type: 'string', description: 'Table ID' },
+        name: { type: 'string', description: 'New table name' },
       },
-      required: ['calendar_id', 'summary', 'start_time', 'end_time'],
+      required: ['app_token', 'table_id', 'name'],
     },
   },
   {
-    name: 'list_calendar_events',
-    description: '[Official API] List events in a calendar.',
+    name: 'create_bitable_view',
+    description: '[Official API] Create a new view in a Bitable table.',
     inputSchema: {
       type: 'object',
       properties: {
-        calendar_id: { type: 'string', description: 'Calendar ID' },
-        start_time: { type: 'string', description: 'Start time filter (Unix timestamp string, optional)' },
-        end_time: { type: 'string', description: 'End time filter (Unix timestamp string, optional)' },
-        page_size: { type: 'number', description: 'Items per page (default 50)' },
+        app_token: { type: 'string', description: 'Bitable app token' },
+        table_id: { type: 'string', description: 'Table ID' },
+        view_name: { type: 'string', description: 'View name' },
+        view_type: { type: 'string', description: 'View type: grid (default), kanban, gallery, form, gantt, calendar', default: 'grid' },
       },
-      required: ['calendar_id'],
+      required: ['app_token', 'table_id', 'view_name'],
     },
   },
   {
-    name: 'delete_calendar_event',
-    description: '[Official API] Delete a calendar event.',
+    name: 'delete_bitable_view',
+    description: '[Official API] Delete a view from a Bitable table.',
     inputSchema: {
       type: 'object',
       properties: {
-        calendar_id: { type: 'string', description: 'Calendar ID' },
-        event_id: { type: 'string', description: 'Event ID to delete' },
+        app_token: { type: 'string', description: 'Bitable app token' },
+        table_id: { type: 'string', description: 'Table ID' },
+        view_id: { type: 'string', description: 'View ID to delete' },
       },
-      required: ['calendar_id', 'event_id'],
+      required: ['app_token', 'table_id', 'view_id'],
     },
   },
   {
-    name: 'get_freebusy',
-    description: '[Official API] Check free/busy status of users for a time range.',
+    name: 'copy_bitable',
+    description: '[Official API] Copy a Bitable app to create a new one.',
     inputSchema: {
       type: 'object',
       properties: {
-        user_ids: { type: 'array', items: { type: 'string' }, description: 'Array of user open_ids to check' },
-        start_time: { type: 'string', description: 'Range start (RFC3339)' },
-        end_time: { type: 'string', description: 'Range end (RFC3339)' },
+        app_token: { type: 'string', description: 'Bitable app token to copy' },
+        name: { type: 'string', description: 'New Bitable name' },
+        folder_id: { type: 'string', description: 'Destination folder token (optional)' },
       },
-      required: ['user_ids', 'start_time', 'end_time'],
+      required: ['app_token', 'name'],
     },
   },
 
-  // ========== Tasks ==========
+  // ========== Drive — File Operations ==========
   {
-    name: 'create_task',
-    description: '[Official API] Create a new task in Feishu Tasks.',
+    name: 'copy_file',
+    description: '[Official API] Copy a file/doc in Drive.',
     inputSchema: {
       type: 'object',
       properties: {
-        summary: { type: 'string', description: 'Task title/summary' },
-        description: { type: 'string', description: 'Task description (optional)' },
-        due: { type: 'string', description: 'Due date/time (RFC3339 or Unix timestamp string, optional)' },
+        file_token: { type: 'string', description: 'File token to copy' },
+        name: { type: 'string', description: 'New file name' },
+        folder_token: { type: 'string', description: 'Destination folder token (optional)' },
+        type: { type: 'string', description: 'File type: file, doc, sheet, bitable, docx, mindnote, slides (optional)' },
       },
-      required: ['summary'],
-    },
-  },
-  {
-    name: 'get_task',
-    description: '[Official API] Get task details by ID.',
-    inputSchema: {
-      type: 'object',
-      properties: { task_id: { type: 'string', description: 'Task ID' } },
-      required: ['task_id'],
+      required: ['file_token', 'name'],
     },
   },
   {
-    name: 'list_tasks',
-    description: '[Official API] List tasks.',
+    name: 'move_file',
+    description: '[Official API] Move a file to another folder in Drive.',
     inputSchema: {
       type: 'object',
       properties: {
-        page_size: { type: 'number', description: 'Items per page (default 50)' },
-        page_token: { type: 'string', description: 'Pagination token' },
+        file_token: { type: 'string', description: 'File token to move' },
+        folder_token: { type: 'string', description: 'Destination folder token' },
       },
+      required: ['file_token', 'folder_token'],
     },
   },
   {
-    name: 'update_task',
-    description: '[Official API] Update a task (title, description, due date, etc.).',
+    name: 'delete_file',
+    description: '[Official API] Delete a file/folder from Drive.',
     inputSchema: {
       type: 'object',
       properties: {
-        task_id: { type: 'string', description: 'Task ID' },
-        summary: { type: 'string', description: 'New title (optional)' },
-        description: { type: 'string', description: 'New description (optional)' },
-        due: { type: 'string', description: 'New due date (optional)' },
+        file_token: { type: 'string', description: 'File token to delete' },
+        type: { type: 'string', description: 'Type: file, folder, doc, sheet, bitable, docx, mindnote, slides' },
       },
-      required: ['task_id'],
-    },
-  },
-  {
-    name: 'complete_task',
-    description: '[Official API] Mark a task as complete.',
-    inputSchema: {
-      type: 'object',
-      properties: { task_id: { type: 'string', description: 'Task ID to complete' } },
-      required: ['task_id'],
+      required: ['file_token'],
     },
   },
+
 ];
 
 // --- Server ---
@@ -1119,7 +1023,7 @@ async function handleTool(name, args) {
 
     case 'send_as_user': {
       const c = await getUserClient();
-      const r = await c.sendMessage(args.chat_id, args.text, { rootId: args.root_id, parentId: args.parent_id });
+      const r = await c.sendMessage(args.chat_id, args.text, { rootId: args.root_id, parentId: args.parent_id, ats: args.ats });
       return sendResult(r, `Text sent as user to ${args.chat_id}`);
     }
     case 'send_to_user': {
@@ -1134,7 +1038,7 @@ async function handleTool(name, args) {
       const user = users[0];
       const chatId = await c.createChat(user.id);
       if (!chatId) return text(`Failed to create chat with ${user.title}`);
-      const r = await c.sendMessage(chatId, args.text);
+      const r = await c.sendMessage(chatId, args.text, { ats: args.ats });
       return sendResult(r, `Text sent to ${user.title} (chat: ${chatId})`);
     }
     case 'send_to_group': {
@@ -1147,7 +1051,7 @@ async function handleTool(name, args) {
         return text(`Multiple groups match "${args.group_name}":\n${candidates}\nUse search_contacts to find the exact group, then send_as_user with the ID.`);
       }
       const group = groups[0];
-      const r = await c.sendMessage(group.id, args.text);
+      const r = await c.sendMessage(group.id, args.text, { ats: args.ats });
       return sendResult(r, `Text sent to group "${group.title}" (${group.id})`);
     }
 
@@ -1331,14 +1235,19 @@ async function handleTool(name, args) {
       return json(await getOfficialClient().readDoc(args.document_id));
     case 'get_doc_blocks':
       return json(await getOfficialClient().getDocBlocks(args.document_id));
-    case 'create_doc':
-      return text(`Document created: ${(await getOfficialClient().createDoc(args.title, args.folder_id)).documentId}`);
+    case 'create_doc': {
+      const official = getOfficialClient();
+      const ownership = official.hasUAT ? ' (as user)' : '';
+      return text(`Document created${ownership}: ${(await official.createDoc(args.title, args.folder_id)).documentId}`);
+    }
 
     // --- Official API: Bitable ---
 
     case 'create_bitable': {
-      const r = await getOfficialClient().createBitable(args.name, args.folder_id);
-      return text(`Bitable created: ${r.appToken}${r.url ? `\nURL: ${r.url}` : ''}`);
+      const official = getOfficialClient();
+      const ownership = official.hasUAT ? ' (as user)' : '';
+      const r = await official.createBitable(args.name, args.folder_id);
+      return text(`Bitable created${ownership}: ${r.appToken}\nURL: ${r.url || ''}`);
     }
     case 'list_bitable_tables':
       return json(await getOfficialClient().listBitableTables(args.app_token));
@@ -1368,12 +1277,6 @@ async function handleTool(name, args) {
       return json(await getOfficialClient().searchBitableRecords(args.app_token, args.table_id, {
         filter: args.filter, sort: args.sort, pageSize: args.page_size,
       }));
-    case 'create_bitable_record':
-      return text(`Record created: ${(await getOfficialClient().createBitableRecord(args.app_token, args.table_id, args.fields)).recordId}`);
-    case 'update_bitable_record':
-      return text(`Record updated: ${(await getOfficialClient().updateBitableRecord(args.app_token, args.table_id, args.record_id, args.fields)).recordId}`);
-    case 'delete_bitable_record':
-      return text(`Record deleted: ${(await getOfficialClient().deleteBitableRecord(args.app_token, args.table_id, args.record_id)).deleted}`);
     case 'batch_create_bitable_records':
       return json(await getOfficialClient().batchCreateBitableRecords(args.app_token, args.table_id, args.records));
     case 'batch_update_bitable_records':
@@ -1394,8 +1297,11 @@ async function handleTool(name, args) {
 
     case 'list_files':
       return json(await getOfficialClient().listFiles(args.folder_token));
-    case 'create_folder':
-      return text(`Folder created: ${(await getOfficialClient().createFolder(args.name, args.parent_token)).token}`);
+    case 'create_folder': {
+      const official = getOfficialClient();
+      const ownership = official.hasUAT ? ' (as user)' : '';
+      return text(`Folder created${ownership}: ${(await official.createFolder(args.name, args.parent_token)).token}`);
+    }
 
     // --- Official API: Contact ---
 
@@ -1434,9 +1340,7 @@ async function handleTool(name, args) {
     // --- Official API: Pins ---
 
     case 'pin_message':
-      return json(await getOfficialClient().pinMessage(args.message_id));
-    case 'unpin_message':
-      return text(`Unpinned: ${(await getOfficialClient().unpinMessage(args.message_id)).deleted}`);
+      return json(await getOfficialClient().pinMessage(args.message_id, args.pinned !== false));
 
     // --- Official API: Chat Management ---
 
@@ -1446,13 +1350,12 @@ async function handleTool(name, args) {
       return text(`Group updated: ${(await getOfficialClient().updateChat(args.chat_id, { name: args.name, description: args.description })).updated}`);
     case 'list_members':
       return json(await getOfficialClient().listChatMembers(args.chat_id, { pageSize: args.page_size, pageToken: args.page_token }));
-    case 'add_members': {
-      const r = await getOfficialClient().addChatMembers(args.chat_id, args.user_ids);
-      return text(r.invalidIds.length ? `Added (invalid IDs: ${r.invalidIds.join(', ')})` : 'Members added');
-    }
-    case 'remove_members': {
-      const r = await getOfficialClient().removeChatMembers(args.chat_id, args.user_ids);
-      return text(r.invalidIds.length ? `Removed (invalid IDs: ${r.invalidIds.join(', ')})` : 'Members removed');
+    case 'manage_members': {
+      const official = getOfficialClient();
+      if (args.action === 'remove') {
+        return json(await official.removeChatMembers(args.chat_id, args.member_ids));
+      }
+      return json(await official.addChatMembers(args.chat_id, args.member_ids));
     }
 
     // --- Official API: Doc Block Editing ---
@@ -1470,6 +1373,16 @@ async function handleTool(name, args) {
       return json(await getOfficialClient().getBitableRecord(args.app_token, args.table_id, args.record_id));
     case 'delete_bitable_table':
       return text(`Table deleted: ${(await getOfficialClient().deleteBitableTable(args.app_token, args.table_id)).deleted}`);
+    case 'get_bitable_meta':
+      return json(await getOfficialClient().getBitableMeta(args.app_token));
+    case 'update_bitable_table':
+      return text(`Table renamed: ${(await getOfficialClient().updateBitableTable(args.app_token, args.table_id, args.name)).name}`);
+    case 'create_bitable_view':
+      return json(await getOfficialClient().createBitableView(args.app_token, args.table_id, args.view_name, args.view_type));
+    case 'delete_bitable_view':
+      return text(`View deleted: ${(await getOfficialClient().deleteBitableView(args.app_token, args.table_id, args.view_id)).deleted}`);
+    case 'copy_bitable':
+      return json(await getOfficialClient().copyBitable(args.app_token, args.name, args.folder_id));
 
     // --- Official API: Drive File Operations ---
 
@@ -1480,53 +1393,22 @@ async function handleTool(name, args) {
     case 'delete_file':
       return text(`File deleted: task=${(await getOfficialClient().deleteFile(args.file_token, args.type)).taskId}`);
 
-    // --- Official API: Calendar ---
-
-    case 'list_calendars':
-      return json(await getOfficialClient().listCalendars());
-    case 'create_calendar_event': {
-      const event = { summary: args.summary, description: args.description || '' };
-      event.start_time = { timestamp: args.start_time };
-      event.end_time = { timestamp: args.end_time };
-      if (args.location) event.location = { name: args.location };
-      return json(await getOfficialClient().createCalendarEvent(args.calendar_id, event));
-    }
-    case 'list_calendar_events':
-      return json(await getOfficialClient().listCalendarEvents(args.calendar_id, {
-        startTime: args.start_time, endTime: args.end_time, pageSize: args.page_size,
-      }));
-    case 'delete_calendar_event':
-      return text(`Event deleted: ${(await getOfficialClient().deleteCalendarEvent(args.calendar_id, args.event_id)).deleted}`);
-    case 'get_freebusy':
-      return json(await getOfficialClient().getFreeBusy(args.user_ids, args.start_time, args.end_time));
-
-    // --- Official API: Tasks ---
-
-    case 'create_task': {
-      const task = { summary: args.summary };
-      if (args.description) task.description = args.description;
-      if (args.due) task.due = { timestamp: args.due };
-      return json(await getOfficialClient().createTask(task));
-    }
-    case 'get_task':
-      return json(await getOfficialClient().getTask(args.task_id));
-    case 'list_tasks':
-      return json(await getOfficialClient().listTasks({ pageSize: args.page_size, pageToken: args.page_token }));
-    case 'update_task': {
-      const task = {};
-      if (args.summary) task.summary = args.summary;
-      if (args.description) task.description = args.description;
-      if (args.due) task.due = { timestamp: args.due };
-      return json(await getOfficialClient().updateTask(args.task_id, task));
-    }
-    case 'complete_task':
-      return text(`Task completed: ${(await getOfficialClient().completeTask(args.task_id)).completed}`);
-
     default:
       return text(`Unknown tool: ${name}`);
   }
 }
 
+// --- Process-level error handlers ---
+// Prevent stray promise rejections or uncaught exceptions from killing the MCP server.
+process.on('uncaughtException', (err) => {
+  console.error('[feishu-user-plugin] Uncaught exception:', err.message);
+  console.error(err.stack);
+});
+
+process.on('unhandledRejection', (reason) => {
+  console.error('[feishu-user-plugin] Unhandled rejection:', reason);
+});
+
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/src/oauth.js

@@ -22,7 +22,8 @@ const APP_SECRET = creds.LARK_APP_SECRET;
 const PORT = 9997;
 const REDIRECT_URI = `http://127.0.0.1:${PORT}/callback`;
 // offline_access is required to get refresh_token for auto-renewal
-const SCOPES = 'offline_access im:message im:message:readonly im:chat:readonly contact:user.base:readonly';
+// Write scopes (docx:document, drive:drive, bitable:app) allow creating resources as the user, not the app
+const SCOPES = 'offline_access auth:user.id:read im:message im:message:readonly im:chat im:chat:readonly contact:user.base:readonly contact:user.id:readonly docx:document drive:drive bitable:app wiki:wiki:readonly';
 
 if (!APP_ID || !APP_SECRET) {
   console.error('Missing LARK_APP_ID or LARK_APP_SECRET.');