Problem
Several tool sections in the Twitter connector reference page (src/content/docs/reference/agent-connectors/twitter.mdx) describe the authenticated user id parameter as being auto-populated from the OAuth token, yet the parameter tables still mark id as Required. This inconsistency will mislead developers about the actual payload they need to send.
Affected tools / line ranges (as of PR #593)
| Tool |
Prose says |
Table says |
twitter_post_retweet |
ID auto-fetched from session |
id → Required |
twitter_post_like |
ID auto-determined from OAuth token |
id → Required |
twitter_post_unlike |
(same pattern) |
id → Required |
twitter_list_unfollow |
(same pattern) |
id → Required |
twitter_list_unpin |
user ID auto-retrieved if not provided |
id → Required |
| (and other occurrences) |
|
|
Approximate line ranges in twitter.mdx: ~362–378, 500–507, 545–552, 860–876.
Expected fix
Update scripts/sync-agent-connectors.js (or the upstream connector source metadata it reads) to set required: false for the id parameter on operations annotated with an "auto-populate from auth" marker, then regenerate the affected docs so the prose and the Required column are consistent everywhere this pattern appears.
References
/cc @saif-at-scalekit
Problem
Several tool sections in the Twitter connector reference page (
src/content/docs/reference/agent-connectors/twitter.mdx) describe the authenticated useridparameter as being auto-populated from the OAuth token, yet the parameter tables still markidas Required. This inconsistency will mislead developers about the actual payload they need to send.Affected tools / line ranges (as of PR #593)
twitter_post_retweetid→ Requiredtwitter_post_likeid→ Requiredtwitter_post_unlikeid→ Requiredtwitter_list_unfollowid→ Requiredtwitter_list_unpinid→ RequiredApproximate line ranges in
twitter.mdx: ~362–378, 500–507, 545–552, 860–876.Expected fix
Update
scripts/sync-agent-connectors.js(or the upstream connector source metadata it reads) to setrequired: falsefor theidparameter on operations annotated with an "auto-populate from auth" marker, then regenerate the affected docs so the prose and the Required column are consistent everywhere this pattern appears.References
/cc @saif-at-scalekit