diff --git a/docs/event-based-agents/adapters/00-index.md b/docs/event-based-agents/adapters/00-index.md index e802bc4f..a7bc1346 100644 --- a/docs/event-based-agents/adapters/00-index.md +++ b/docs/event-based-agents/adapters/00-index.md @@ -15,10 +15,10 @@ Current acceptance report: [EBA Adapter Acceptance Report](./acceptance-report.m | Adapter | Status | Document | |---------|--------|----------| -| Telegram | Migrated; partial plugin E2E, media-inbound gaps remain | [Telegram](./telegram.md) | +| Telegram | Migrated; partial plugin E2E, real UI inbound image/file verified | [Telegram](./telegram.md) | | Discord | Migrated; partial plugin E2E, media-inbound gaps remain | [Discord](./discord.md) | | OneBot v11 / aiocqhttp | Migrated; Matcha UI plus protocol-level multi-component coverage | [OneBot v11 / aiocqhttp](./aiocqhttp.md) | -| DingTalk | Migrated; partial plugin E2E, group/media-inbound gaps remain | [DingTalk](./dingtalk.md) | +| DingTalk | Migrated; partial plugin E2E, real UI inbound image/file verified; group gap remains | [DingTalk](./dingtalk.md) | ## Documentation Checklist diff --git a/docs/event-based-agents/adapters/acceptance-report.md b/docs/event-based-agents/adapters/acceptance-report.md index acb47a7a..420fbd7e 100644 --- a/docs/event-based-agents/adapters/acceptance-report.md +++ b/docs/event-based-agents/adapters/acceptance-report.md @@ -22,23 +22,25 @@ This report follows `acceptance-checklist.md`. Evidence levels are intentionally | Adapter | Status | Honest acceptance summary | |---------|--------|---------------------------| -| Telegram | Partial EBA acceptance | Real Telegram UI covered private text, group mention text, bot invite, outbound component sweep, safe SDK APIs, and safe Telegram platform APIs. Real UI inbound image/file/voice/quote was not completed in the latest plugin run. | +| Telegram | Partial EBA acceptance | Real Telegram UI covered private text, group mention text, bot invite, inbound private image/file, outbound component sweep, safe SDK APIs, and safe Telegram platform APIs. Real UI inbound voice/quote was not completed in the latest plugin run. | | Discord | Partial EBA acceptance | Real Discord UI covered group text, outbound image/file/quote/mention components, safe SDK APIs, and safe Discord platform APIs. Real UI inbound attachment/image/file/reply/mention was not completed. A later UI retry was blocked because the Discord client kept the send button disabled. | | OneBot v11 / aiocqhttp | Partial EBA acceptance | Matcha UI covered real group text and outbound supported components/APIs. Multi-component inbound `Source/Plain/At/Face/Image/Voice/File/Quote` was verified through the real OneBot reverse WebSocket adapter endpoint, but not through Matcha UI upload/send. Matcha blocks file-send and merged-forward APIs. | -| DingTalk | Partial EBA acceptance | Real DingTalk UI covered private text and emoji-as-text inbound, outbound image/file/quote/mention fallback components, safe SDK APIs, and safe DingTalk platform APIs. Real UI inbound image/file/voice/quote and group trigger were not completed. | +| DingTalk | Partial EBA acceptance | Real DingTalk UI covered private text, emoji-as-text inbound, private inbound image/file, outbound image/file/quote/mention fallback components, safe SDK APIs, and safe DingTalk platform APIs. Real UI inbound voice/quote and group trigger were not completed. | -No adapter in this report is marked as fully accepted for production-grade media inbound until real user-side UI image/file upload evidence exists in the plugin JSONL. +Telegram and DingTalk now have real user-side UI image/file upload evidence in plugin JSONL. Discord and aiocqhttp do not yet have real UI inbound image/file evidence. ## Evidence Files | Adapter | Endpoint | Evidence | |---------|----------|----------| | Telegram private | Telegram Lite, `@rockchinq_bot` private chat | `data/temp/telegram-plugin-e2e-rerun.jsonl` | +| Telegram private media | Telegram Lite, `@rockchinq_bot` private chat | `data/temp/telegram-plugin-e2e-media-ui.jsonl` | | Telegram group | Telegram Lite, `Rock'sBotGroup` | `data/temp/telegram-plugin-e2e-group.jsonl` | | Discord | Discord client, LangBot server, `#debugging` | `data/temp/discord-plugin-e2e-20260510-final.jsonl` | | aiocqhttp UI | local Matcha, group `test group` | `data/temp/aiocqhttp-plugin-e2e-20260510-multiformat.jsonl` | | aiocqhttp protocol | OneBot reverse WebSocket endpoint `127.0.0.1:2280/ws` | `data/temp/aiocqhttp-plugin-e2e-20260510-multiformat.jsonl` | | DingTalk | DingTalk Mac, `LangBot Team` org private chat | `data/temp/dingtalk-plugin-e2e-20260510-rerun.jsonl` | +| DingTalk private media | DingTalk Mac, `LangBot Team` org private chat | `data/temp/dingtalk-plugin-e2e-media-ui.jsonl` | All plugin runs used SDK standalone runtime ports `5400/5401`, LangBot `--standalone-runtime`, and the real plugin at `langbot-plugin-demo/EBAEventProbe`. @@ -50,7 +52,7 @@ All four adapters deliver common SDK entities to plugins before LangBot core/plu |-------------|----------|---------|-----------|----------| | `bot_uuid` filled | plugin-e2e | plugin-e2e | plugin-e2e | plugin-e2e | | `adapter_name` filled | `telegram` | `discord` | `aiocqhttp` | `dingtalk` | -| common `MessageChain` delivered | `Plain`, group `At + Plain` | `Source + Plain` | UI `Source + Plain`; protocol `Source + Plain + At + Face + Image + Voice + File + Quote + Plain` | `Source + Plain` | +| common `MessageChain` delivered | `Plain`, group `At + Plain`, private `Image`, private `File` | `Source + Plain` | UI `Source + Plain`; protocol `Source + Plain + At + Face + Image + Voice + File + Quote + Plain` | `Source + Plain`, private `Source + Image`, private `Source + File` | | common user/group entities | plugin-e2e | plugin-e2e | plugin-e2e | plugin-e2e private user; group not completed | | raw native object isolation | raw data stays in `source_platform_object` | raw data stays in `source_platform_object` | raw data stays in `source_platform_object` | raw data stays in `source_platform_object` | @@ -62,13 +64,13 @@ All four adapters deliver common SDK entities to plugins before LangBot core/plu | `Plain` | plugin-e2e-ui private/group | plugin-e2e-ui | plugin-e2e-ui/protocol | plugin-e2e-ui | | `At` | plugin-e2e-ui group mention | unit; real UI mention not completed in latest run | plugin-e2e-protocol; unit | unit; group trigger not completed | | `AtAll` | not-supported | unit only | unit only | unit/send fallback only | -| `Image` | converter/unit; real UI inbound not completed | converter/unit; real UI attachment not completed | plugin-e2e-protocol, not Matcha UI | converter/unit; real UI inbound not completed | +| `Image` | plugin-e2e-ui private | converter/unit; real UI attachment not completed | plugin-e2e-protocol, not Matcha UI | plugin-e2e-ui private | | `Voice` | converter/unit; real UI inbound not completed | not-supported as native voice; audio is attachment/file | plugin-e2e-protocol, not Matcha UI | converter/unit; real UI inbound not completed | -| `File` | converter/unit; real UI inbound not completed | converter/unit; real UI attachment not completed | plugin-e2e-protocol, not Matcha UI | converter/unit; real UI inbound not completed | +| `File` | plugin-e2e-ui private | converter/unit; real UI attachment not completed | plugin-e2e-protocol, not Matcha UI | plugin-e2e-ui private | | `Quote` | converter/unit; real UI reply not completed | unit; real UI reply not completed | plugin-e2e-protocol | converter/unit; real UI quote not completed | | `Face` | not-supported as common `Face` | not-supported as common `Face` | plugin-e2e-protocol | UI emoji becomes `Plain` (`[smile]` text), not `Face` | | `Forward` | not-supported inbound | not-supported inbound | unit; Matcha forward UI/action blocked | not-supported inbound | -| Mixed chain | group `At + Plain` only | not completed inbound | plugin-e2e-protocol | not completed inbound | +| Mixed chain | group `At + Plain`; media tested as separate messages | not completed inbound | plugin-e2e-protocol | media tested as separate messages; mixed inbound not completed | ## Message Send Components @@ -108,17 +110,17 @@ All four adapters deliver common SDK entities to plugins before LangBot core/plu | group info/member info | plugin-e2e safe subset | plugin-e2e safe subset | plugin-e2e safe subset | private path only; group not completed | | user/friend info | plugin-e2e where platform allows | plugin-e2e where platform allows | plugin-e2e | plugin-e2e private user | | moderation/leave | blocked without disposable safe targets | blocked without disposable safe targets | blocked without disposable safe targets | blocked/not declared | -| `get_file_url` | implemented; not latest inbound-file verified | URL passthrough for attachments; inbound attachment not completed | not portable/endpoint-dependent | implemented through DingTalk media API; inbound file not completed | +| `get_file_url` | implemented; latest inbound `File` carried downloadable file data in plugin evidence | URL passthrough for attachments; inbound attachment not completed | not portable/endpoint-dependent | implemented through DingTalk media API; latest inbound `File` carried a platform file URL | | `call_platform_api` | plugin-e2e safe actions | plugin-e2e safe actions | plugin-e2e safe actions, Matcha gaps documented | plugin-e2e safe `check_access_token` | ## Platform-Specific API Acceptance | Adapter | plugin-e2e verified | Blocked or not reproduced | |---------|---------------------|---------------------------| -| Telegram | safe chat/admin/member count/chat-action actions | mutating actions and callback-only actions were not repeated; inbound file URL path lacks latest UI file evidence | +| Telegram | safe chat/admin/member count/chat-action actions | mutating actions and callback-only actions were not repeated | | Discord | safe channel/guild/role/typing actions | mutating pin/reaction/invite actions were not repeated in the latest plugin run; inbound attachment paths not completed | | aiocqhttp | safe OneBot actions such as status/version/can-send checks | `get_group_honor_info` unsupported by Matcha; admin/card/title/ban/record/file/forward require better endpoint fixtures | -| DingTalk | `check_access_token` | media download/get-file-url actions need real inbound media IDs; group actions need a working group trigger | +| DingTalk | `check_access_token`; real inbound file produced a file URL in the common `File` component | separate media-download replay APIs and group actions need a working follow-up fixture | ## SDK API Acceptance @@ -136,7 +138,7 @@ The probe logs set `ok=true` when the sweep completed with only expected unsuppo ## Residual Risks And Required Follow-Up -- Telegram, Discord, and DingTalk still require real UI inbound image and file upload evidence before they can be called media-complete. +- Discord still requires real UI inbound image/file upload evidence before it can be called media-complete. - aiocqhttp has rich inbound component evidence only at the OneBot reverse WebSocket boundary; Matcha UI did not provide image/file upload coverage. - DingTalk group trigger remains unclosed; current evidence is private chat only. - Discord UI retry on May 10, 2026 was blocked by the client keeping the send button disabled even after text was entered. @@ -144,4 +146,4 @@ The probe logs set `ok=true` when the sweep completed with only expected unsuppo ## Conclusion -The EBA conversion path is implemented and partially proven for all four adapters, but the current evidence does not support a claim that all platforms are fully end-to-end tested for real user-side image/file inbound. This report therefore treats the adapters as partial acceptance with explicit gaps, not production-complete media acceptance. +The EBA conversion path is implemented and partially proven for all four adapters. Telegram and DingTalk now have real UI private-chat image/file inbound evidence. Discord and aiocqhttp still have explicit UI-level media gaps, so the overall adapter set remains partial acceptance rather than production-complete media acceptance. diff --git a/docs/event-based-agents/adapters/dingtalk.md b/docs/event-based-agents/adapters/dingtalk.md index 3e1d38c0..ff6ce611 100644 --- a/docs/event-based-agents/adapters/dingtalk.md +++ b/docs/event-based-agents/adapters/dingtalk.md @@ -43,9 +43,9 @@ The legacy DingTalk HTTP client now returns successful JSON response bodies from | `Plain` | supported | `plugin-e2e-ui` private text. DingTalk emoji currently arrives as plain text such as `[smile]`. | | `At` | converter path | Group trigger was not completed in the latest run. | | `AtAll` | fallback/send-side only | Not completed inbound. | -| `Image` | converter path | Real UI inbound image was not completed. | +| `Image` | supported | Real DingTalk Mac private-chat image upload reached the plugin as common `Image`. | | `Voice` | converter path | Real UI inbound voice was not completed. | -| `File` | converter path | Real UI inbound file was not completed. | +| `File` | supported | Real DingTalk Mac private-chat file upload reached the plugin as common `File`. | | `Quote` | converter path | Real UI inbound quote was not completed. | | `Face` | not native common mapping | DingTalk emoji was observed as `Plain`, not `Face`. | | `Forward` | not-supported inbound | DingTalk does not expose a portable structured forward event in this adapter. | @@ -76,7 +76,7 @@ The legacy DingTalk HTTP client now returns successful JSON response bodies from | `get_group_member_info` | supported where DingTalk API allows | Limited live coverage. | | `get_user_info` | supported | Private sender path verified. | | `get_friend_list` | limited | DingTalk does not expose a portable friend-list equivalent. | -| `get_file_url` | supported with media/file identifiers | Needs real inbound media evidence. | +| `get_file_url` | supported with media/file identifiers | Real inbound file yielded a platform file URL in the converted `File` component. | | `call_platform_api` | supported | Safe action `check_access_token` verified. | ## Platform-Specific APIs @@ -85,26 +85,29 @@ The legacy DingTalk HTTP client now returns successful JSON response bodies from |--------|---------|----------| | `check_access_token` | supported | `plugin-e2e`. | | `refresh_access_token` | supported | Implemented; not separately reproduced in the latest plugin run. | -| `get_file_url` | supported | Needs real inbound file/media ID. | +| `get_file_url` | supported | Real inbound file yielded a platform file URL in the converted `File` component. | | `get_audio_base64` | supported | Needs real inbound audio/media ID. | -| `download_image_base64` | supported | Needs real inbound image/media ID. | +| `download_image_base64` | supported | Real inbound image reached the plugin as `Image`; separate image-download API replay was not completed. | ## End-to-End Evidence -Evidence file: `data/temp/dingtalk-plugin-e2e-20260510-rerun.jsonl` +Evidence files: + +- Text/API/component JSONL: `data/temp/dingtalk-plugin-e2e-20260510-rerun.jsonl` +- Real UI inbound media JSONL: `data/temp/dingtalk-plugin-e2e-media-ui.jsonl` Verified: - DingTalk Mac private chat in the `LangBot Team` organization produced `MessageReceived` through LangBot standalone runtime and `EBAEventProbe`. - The common chain was `Source + Plain` for normal text. - DingTalk emoji was received as `Source + Plain`, not common `Face`. +- Real DingTalk Mac private-chat image upload was received as `Source + Image`. +- Real DingTalk Mac private-chat file upload was received as `Source + File`. - The plugin sent outbound text, mention/fallback, image, quote/fallback, file, and forward/fallback messages visible in DingTalk. - The plugin called safe SDK and DingTalk platform APIs. Not completed: -- Real UI inbound image. -- Real UI inbound file. - Real UI inbound voice. - Real UI inbound quote. - Group trigger with a real robot mention. diff --git a/docs/event-based-agents/adapters/telegram.md b/docs/event-based-agents/adapters/telegram.md index 4e15e6bc..33650842 100644 --- a/docs/event-based-agents/adapters/telegram.md +++ b/docs/event-based-agents/adapters/telegram.md @@ -110,6 +110,7 @@ Evidence: - Private chat JSONL: `data/temp/telegram-plugin-e2e-rerun.jsonl` - Group chat JSONL: `data/temp/telegram-plugin-e2e-group.jsonl` +- Private media JSONL: `data/temp/telegram-plugin-e2e-media-ui.jsonl` Observed and verified: @@ -117,12 +118,13 @@ Observed and verified: - `BotInvitedToGroup` reached the plugin after adding the bot to `Rock'sBotGroup`. - SDK API calls succeeded: `get_langbot_version`, `get_bots`, `get_bot_info`, `send_message`, plugin storage, workspace storage, `list_plugins_manifest`, `list_commands`, `list_tools`, and `list_knowledge_bases`. - Outbound component sweep succeeded in private and group chats: plain text, mention text/equivalent, base64 image, quoted reply, file/document, and flattened forward fallback. Group mode also covered `AtAll` fallback behavior. +- Real Telegram Lite private-chat inbound media was verified through the plugin path: a sent document arrived as common `File`, and a sent photo arrived as common `Image`. - Telegram platform API sweep succeeded for safe group actions: `get_chat_administrators`, `get_chat_member_count`, and `send_chat_action`. - Common group/user APIs succeeded in group mode: `get_user_info`, `get_group_info`, `get_group_member_list`, and `get_group_member_info`. Documented limits in this E2E run: -- Real Telegram UI inbound image, file, voice, sticker/emoji-as-common-component, and reply/quote messages were not completed in the plugin E2E evidence. Outbound image/file messages from the bot do not prove inbound media conversion. +- Real Telegram UI inbound voice, sticker/emoji-as-common-component, and reply/quote messages were not completed in the plugin E2E evidence. - `get_message`, `get_friend_list`, and `get_group_list` are not supported by this Telegram adapter. - Mutating/destructive Telegram-specific actions such as pin/unpin, title/description changes, invite-link creation, moderation, kick, and leave were not repeated in the plugin run. They remain opt-in live-probe cases. - Telegram does not expose a portable common `Face` component for native sticker/emoji semantics in the current adapter.