feishu-user-plugin 1.3.6 → 1.3.8

package/scripts/test-ws-events.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+'use strict';
+// Manual e2e: spawn MCP server, wait for WS connect, send a message to a test
+// chat (configurable via TEST_CHAT_ID env), then call get_new_events and verify
+// the message appears.
+//
+// Skipped on CI (POSIX 77) when no LARK_APP_ID/SECRET/UAT or no TEST_CHAT_ID.
+
+const { spawn } = require('child_process');
+const path = require('path');
+const { readCredentials } = require('../src/auth/credentials');
+
+const creds = readCredentials();
+const TEST_CHAT_ID = process.env.TEST_CHAT_ID;
+if (!creds.LARK_APP_ID || !creds.LARK_APP_SECRET || !TEST_CHAT_ID) {
+  console.error('Skipped: needs LARK_APP_ID/SECRET (real, not mock) and TEST_CHAT_ID env.');
+  process.exit(77);
+}
+
+(async () => {
+  console.log('Spawning MCP server with WS...');
+  const child = spawn('node', [path.join(__dirname, '..', 'src', 'index.js')], {
+    stdio: ['pipe', 'pipe', 'pipe'],
+    env: process.env,
+  });
+
+  let buf = ''; const responses = new Map();
+  child.stdout.on('data', (d) => {
+    buf += d.toString();
+    const lines = buf.split('\n'); buf = lines.pop();
+    for (const line of lines) try { const m = JSON.parse(line); if (m.id != null) responses.set(m.id, m); } catch {}
+  });
+  let wsConnected = false;
+  child.stderr.on('data', (d) => {
+    const s = d.toString();
+    process.stderr.write('  child: ' + s);
+    if (/WS connected/i.test(s)) wsConnected = true;
+  });
+
+  const send = (id, method, params) => child.stdin.write(JSON.stringify({jsonrpc:'2.0', id, method, params})+'\n');
+  const wait = (id, ms = 10000) => new Promise((res, rej) => {
+    const t = setInterval(() => { if (responses.has(id)) { clearInterval(t); res(responses.get(id)); } }, 50);
+    setTimeout(() => { clearInterval(t); rej(new Error('timeout id=' + id)); }, ms);
+  });
+
+  send(1, 'initialize', { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'ws-test', version: '0' }});
+  await wait(1);
+
+  // Wait for WS to connect (up to 15s).
+  const wsStart = Date.now();
+  while (!wsConnected && Date.now() - wsStart < 15000) {
+    await new Promise(r => setTimeout(r, 200));
+  }
+  if (!wsConnected) {
+    console.error('FAIL: WS did not connect within 15s.');
+    child.kill();
+    process.exit(1);
+  }
+  console.log('  WS connected after', Date.now() - wsStart, 'ms');
+
+  // Send a test message via send_message_as_bot (requires bot to be in TEST_CHAT_ID).
+  const stamp = `ws-test-${Date.now()}`;
+  send(2, 'tools/call', { name: 'send_message_as_bot', arguments: { chat_id: TEST_CHAT_ID, msg_type: 'text', payload: { text: stamp } } });
+  await wait(2, 15000);
+  console.log('  sent test message:', stamp);
+
+  // Wait a few seconds for the WS round-trip.
+  await new Promise(r => setTimeout(r, 5000));
+
+  send(3, 'tools/call', { name: 'get_new_events', arguments: { since_seconds: 30, max_events: 50 } });
+  const r3 = await wait(3, 5000);
+  const txt = r3.result?.content?.[0]?.text || '';
+  const found = txt.includes(stamp);
+  console.log('  get_new_events response includes stamp?', found);
+
+  child.kill();
+
+  if (!found) {
+    console.error('FAIL: WS did not deliver the test message via get_new_events.');
+    console.error('Response:', txt.slice(0, 500));
+    process.exit(1);
+  }
+  console.log('PASS: WS delivered the test message.');
+})().catch((e) => { console.error('Error:', e.message); process.exit(1); });

package/skills/feishu-user-plugin/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: feishu-user-plugin
-version: "1.3.6"
-description: "All-in-one Feishu plugin — send messages as yourself (incl. batch_send), read group/P2P chats (auto-expands merge_forward), manage docs/tables/wiki/drive (image + file blocks, drive uploads, bitable attachments), OKR, calendar, multi-profile. v1.3.6: upload completeness, sheets:spreadsheet scope, batch_send, multi-profile, send_card_as_user (bot-default)."
-allowed-tools: send_to_user, send_to_group, send_as_user, send_image_as_user, send_file_as_user, send_post_as_user, send_sticker_as_user, send_audio_as_user, batch_send, send_card_as_user, search_contacts, create_p2p_chat, get_chat_info, get_user_info, get_login_status, list_profiles, switch_profile, read_p2p_messages, list_user_chats, list_chats, read_messages, reply_message, forward_message, search_docs, read_doc, create_doc, create_doc_block, update_doc_block, list_bitable_tables, list_bitable_fields, search_bitable_records, batch_create_bitable_records, batch_update_bitable_records, upload_bitable_attachment, list_wiki_spaces, search_wiki, list_wiki_nodes, get_wiki_node, list_files, create_folder, upload_drive_file, find_user, download_image, download_file, list_user_okrs, get_okrs, list_okr_periods, list_calendars, list_calendar_events, get_calendar_event
+version: "1.3.8"
+description: "All-in-one Feishu plugin — send messages as yourself (incl. batch_send), read group/P2P chats (auto-expands merge_forward), manage docs/tables/wiki (full CRUD)/drive, OKR (with progress writes), calendar (read+write), Tasks v2, multi-profile auto-switch, real-time WS events. v1.3.8: multi-profile auto-switch on read errors (B), WebSocket realtime im.message events via get_new_events (C), credential pointer-only mode (E), CI gates (F), auth/uat.js + auth/cookie.js extracts (D)."
+allowed-tools: send_to_user, send_to_group, send_as_user, send_image_as_user, send_file_as_user, send_post_as_user, batch_send, send_card_as_user, search_contacts, create_p2p_chat, get_chat_info, get_user_info, get_login_status, list_profiles, switch_profile, manage_profile_hints, read_p2p_messages, list_user_chats, list_chats, read_messages, send_message_as_bot, reply_message, forward_message, delete_message, update_message, add_reaction, delete_reaction, pin_message, create_group, update_group, list_members, manage_members, search_docs, read_doc, get_doc_blocks, create_doc, manage_doc_block, manage_bitable_app, manage_bitable_table, manage_bitable_field, manage_bitable_view, manage_bitable_record, upload_bitable_attachment, list_wiki_spaces, search_wiki, list_wiki_nodes, get_wiki_node, create_wiki_node, update_wiki_node, move_wiki_node, copy_wiki_node, delete_wiki_node, list_files, create_folder, upload_drive_file, manage_drive_file, upload_image, upload_file, download_message_resource, download_doc_image, list_user_okrs, get_okrs, list_okr_periods, create_okr_progress_record, list_okr_progress_records, delete_okr_progress_record, list_calendars, list_calendar_events, get_calendar_event, create_calendar_event, update_calendar_event, delete_calendar_event, respond_calendar_event, get_freebusy, list_tasks, get_task, create_task, update_task, complete_task, delete_task, manage_task_members, get_new_events
 user_invocable: true
 ---
 
 # Feishu User Plugin
 
 All-in-one Feishu plugin for Claude Code with three auth layers:
-- **User Identity** (cookie auth): Send messages as yourself — text, image, file, rich text, sticker, audio
+- **User Identity** (cookie auth): Send messages as yourself — text, image, file, rich text (post)
 - **Official API** (app credentials): Read group messages, docs, tables, wiki, drive, contacts
 - **User OAuth** (user_access_token): Read P2P (direct message) chat history
 
@@ -43,7 +43,7 @@ Search users and groups by name, display results grouped by type.
 Search (search_docs), read (read_doc), create (create_doc) — three in one.
 
 ### /table — Bitable operations
-Query (list tables → list fields → search records), create records, update records.
+Query (`manage_bitable_table(action=list)` → `manage_bitable_field(action=list)` → `manage_bitable_record(action=search)`), create / update / delete records via `manage_bitable_record(action=create|update|delete)`.
 
 ### /wiki — Wiki management
 List spaces (list_wiki_spaces), search content (search_wiki), browse nodes (list_wiki_nodes).