feishu-user-plugin 1.2.1 → 1.3.1

package/src/index.js

@@ -541,49 +541,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 +556,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 +569,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: {
@@ -710,6 +670,313 @@ 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.',
+    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"}' },
+      },
+      required: ['chat_id', 'msg_type', 'content'],
+    },
+  },
+  {
+    name: 'delete_message',
+    description: '[Official API] Recall/delete a message (bot can only delete its own messages).',
+    inputSchema: {
+      type: 'object',
+      properties: { message_id: { type: 'string', description: 'Message ID (om_xxx)' } },
+      required: ['message_id'],
+    },
+  },
+  {
+    name: 'update_message',
+    description: '[Official API] Edit a sent message (bot can only edit its own messages). Supports text and post.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message_id: { type: 'string', description: 'Message ID (om_xxx)' },
+        msg_type: { type: 'string', description: 'Message type: text or post' },
+        content: { description: 'New content. For text: {"text":"updated text"}' },
+      },
+      required: ['message_id', 'msg_type', 'content'],
+    },
+  },
+
+  // ========== IM — Reactions ==========
+  {
+    name: 'add_reaction',
+    description: '[Official API] Add an emoji reaction to a message.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message_id: { type: 'string', description: 'Message ID (om_xxx)' },
+        emoji_type: { type: 'string', description: 'Emoji type string, e.g. "THUMBSUP", "SMILE", "HEART"' },
+      },
+      required: ['message_id', 'emoji_type'],
+    },
+  },
+  {
+    name: 'delete_reaction',
+    description: '[Official API] Remove an emoji reaction from a message.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message_id: { type: 'string', description: 'Message ID' },
+        reaction_id: { type: 'string', description: 'Reaction ID (from add_reaction response)' },
+      },
+      required: ['message_id', 'reaction_id'],
+    },
+  },
+
+  // ========== IM — Pin Messages ==========
+  {
+    name: 'pin_message',
+    description: '[Official API] Pin or unpin a message in a chat.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message_id: { type: 'string', description: 'Message ID' },
+        pinned: { type: 'boolean', description: 'true to pin, false to unpin', default: true },
+      },
+      required: ['message_id'],
+    },
+  },
+
+  // ========== IM — Chat Management ==========
+  {
+    name: 'create_group',
+    description: '[Official API] Create a new group chat (as bot). Can add initial members.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Group name' },
+        description: { type: 'string', description: 'Group description (optional)' },
+        user_ids: { type: 'array', items: { type: 'string' }, description: 'Initial member open_ids (optional)' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'update_group',
+    description: '[Official API] Update group chat name or description.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chat_id: { type: 'string', description: 'Chat ID (oc_xxx)' },
+        name: { type: 'string', description: 'New group name (optional)' },
+        description: { type: 'string', description: 'New description (optional)' },
+      },
+      required: ['chat_id'],
+    },
+  },
+  {
+    name: 'list_members',
+    description: '[Official API] List all members in a group chat.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chat_id: { type: 'string', description: 'Chat ID (oc_xxx)' },
+        page_size: { type: 'number', description: 'Items per page (default 50)' },
+        page_token: { type: 'string', description: 'Pagination token' },
+      },
+      required: ['chat_id'],
+    },
+  },
+  {
+    name: 'manage_members',
+    description: '[Official API] Add or remove members from a group chat.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        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', 'member_ids', 'action'],
+    },
+  },
+
+  // ========== Docs — Block Editing ==========
+  {
+    name: 'create_doc_block',
+    description: '[Official API] Insert content blocks into a document. Add text, headings, lists, etc. after create_doc.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        document_id: { type: 'string', description: 'Document ID' },
+        parent_block_id: { type: 'string', description: 'Parent block ID (use document_id for root)' },
+        children: { type: 'array', description: 'Array of block objects to insert. E.g. [{block_type:2, text:{elements:[{text_run:{content:"Hello"}}]}}]', items: { type: 'object' } },
+        index: { type: 'number', description: 'Insert position (optional, appends to end if omitted)' },
+      },
+      required: ['document_id', 'parent_block_id', 'children'],
+    },
+  },
+  {
+    name: 'update_doc_block',
+    description: '[Official API] Update a specific block in a document (change text content, style, etc.).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        document_id: { type: 'string', description: 'Document ID' },
+        block_id: { type: 'string', description: 'Block ID to update' },
+        update_body: { type: 'object', description: 'Update payload. E.g. {update_text_elements:{elements:[{text_run:{content:"new text"}}]}}' },
+      },
+      required: ['document_id', 'block_id', 'update_body'],
+    },
+  },
+  {
+    name: 'delete_doc_blocks',
+    description: '[Official API] Delete a range of blocks from a document.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        document_id: { type: 'string', description: 'Document ID' },
+        parent_block_id: { type: 'string', description: 'Parent block ID containing the blocks to delete' },
+        start_index: { type: 'number', description: 'Start index (inclusive)' },
+        end_index: { type: 'number', description: 'End index (exclusive)' },
+      },
+      required: ['document_id', 'parent_block_id', 'start_index', 'end_index'],
+    },
+  },
+
+  // ========== Bitable — Additional ==========
+  {
+    name: 'get_bitable_record',
+    description: '[Official API] Get a single record by ID 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' },
+      },
+      required: ['app_token', 'table_id', 'record_id'],
+    },
+  },
+  {
+    name: 'delete_bitable_table',
+    description: '[Official API] Delete a data table from a Bitable app.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        app_token: { type: 'string', description: 'Bitable app token' },
+        table_id: { type: 'string', description: 'Table ID to delete' },
+      },
+      required: ['app_token', 'table_id'],
+    },
+  },
+
+  {
+    name: 'get_bitable_meta',
+    description: '[Official API] Get metadata of a Bitable app (name, revision, etc.).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        app_token: { type: 'string', description: 'Bitable app token' },
+      },
+      required: ['app_token'],
+    },
+  },
+  {
+    name: 'update_bitable_table',
+    description: '[Official API] Rename a data table in a Bitable app.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        app_token: { type: 'string', description: 'Bitable app token' },
+        table_id: { type: 'string', description: 'Table ID' },
+        name: { type: 'string', description: 'New table name' },
+      },
+      required: ['app_token', 'table_id', 'name'],
+    },
+  },
+  {
+    name: 'create_bitable_view',
+    description: '[Official API] Create a new view in a Bitable table.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        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: ['app_token', 'table_id', 'view_name'],
+    },
+  },
+  {
+    name: 'delete_bitable_view',
+    description: '[Official API] Delete a view from a Bitable table.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        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: ['app_token', 'table_id', 'view_id'],
+    },
+  },
+  {
+    name: 'copy_bitable',
+    description: '[Official API] Copy a Bitable app to create a new one.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        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: ['app_token', 'name'],
+    },
+  },
+
+  // ========== Drive — File Operations ==========
+  {
+    name: 'copy_file',
+    description: '[Official API] Copy a file/doc in Drive.',
+    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' },
+      },
+      required: ['file_token'],
+    },
+  },
+
 ];
 
 // --- Server ---
@@ -953,14 +1220,33 @@ 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();
+      if (official.hasUAT) {
+        try {
+          const result = await official.createDocAsUser(args.title, args.folder_id);
+          return text(`Document created (as user): ${result.documentId}`);
+        } catch (e) {
+          console.error(`[feishu-user-plugin] UAT createDoc failed, falling back to app: ${e.message}`);
+        }
+      }
+      return text(`Document created: ${(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();
+      if (official.hasUAT) {
+        try {
+          const r = await official.createBitableAsUser(args.name, args.folder_id);
+          return text(`Bitable created (as user): ${r.appToken}\nURL: ${r.url || ''}`);
+        } catch (e) {
+          console.error(`[feishu-user-plugin] UAT createBitable failed, falling back to app: ${e.message}`);
+        }
+      }
+      const r = await official.createBitable(args.name, args.folder_id);
+      return text(`Bitable created: ${r.appToken}\nURL: ${r.url || ''}`);
     }
     case 'list_bitable_tables':
       return json(await getOfficialClient().listBitableTables(args.app_token));
@@ -990,12 +1276,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':
@@ -1016,8 +1296,17 @@ 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();
+      if (official.hasUAT) {
+        try {
+          return text(`Folder created (as user): ${(await official.createFolderAsUser(args.name, args.parent_token)).token}`);
+        } catch (e) {
+          console.error(`[feishu-user-plugin] UAT createFolder failed, falling back to app: ${e.message}`);
+        }
+      }
+      return text(`Folder created: ${(await official.createFolder(args.name, args.parent_token)).token}`);
+    }
 
     // --- Official API: Contact ---
 
@@ -1035,11 +1324,96 @@ async function handleTool(name, args) {
       return text(`File uploaded: ${r.fileKey}\nUse this file_key with send_file_as_user to send it.`);
     }
 
+    // --- Official API: Bot Send / Edit / Delete ---
+
+    case 'send_message_as_bot': {
+      const r = await getOfficialClient().sendMessageAsBot(args.chat_id, args.msg_type, args.content);
+      return text(`Message sent (bot): ${r.messageId}`);
+    }
+    case 'delete_message':
+      return text(`Message deleted: ${(await getOfficialClient().deleteMessage(args.message_id)).deleted}`);
+    case 'update_message':
+      return text(`Message updated: ${(await getOfficialClient().updateMessage(args.message_id, args.msg_type, args.content)).messageId}`);
+
+    // --- Official API: Reactions ---
+
+    case 'add_reaction':
+      return text(`Reaction added: ${(await getOfficialClient().addReaction(args.message_id, args.emoji_type)).reactionId}`);
+    case 'delete_reaction':
+      return text(`Reaction removed: ${(await getOfficialClient().deleteReaction(args.message_id, args.reaction_id)).deleted}`);
+
+    // --- Official API: Pins ---
+
+    case 'pin_message':
+      return json(await getOfficialClient().pinMessage(args.message_id, args.pinned !== false));
+
+    // --- Official API: Chat Management ---
+
+    case 'create_group':
+      return text(`Group created: ${(await getOfficialClient().createChat({ name: args.name, description: args.description, userIds: args.user_ids })).chatId}`);
+    case 'update_group':
+      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 '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 ---
+
+    case 'create_doc_block':
+      return json(await getOfficialClient().createDocBlock(args.document_id, args.parent_block_id, args.children, args.index));
+    case 'update_doc_block':
+      return json(await getOfficialClient().updateDocBlock(args.document_id, args.block_id, args.update_body));
+    case 'delete_doc_blocks':
+      return text(`Blocks deleted: ${(await getOfficialClient().deleteDocBlocks(args.document_id, args.parent_block_id, args.start_index, args.end_index)).deleted}`);
+
+    // --- Official API: Bitable Additional ---
+
+    case 'get_bitable_record':
+      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 ---
+
+    case 'copy_file':
+      return json(await getOfficialClient().copyFile(args.file_token, args.name, args.folder_token, args.type));
+    case 'move_file':
+      return text(`File moved: task=${(await getOfficialClient().moveFile(args.file_token, args.folder_token)).taskId}`);
+    case 'delete_file':
+      return text(`File deleted: task=${(await getOfficialClient().deleteFile(args.file_token, args.type)).taskId}`);
+
     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.');