@devries-cameron20 / composio-1 / commits / 6de7d67a9
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: replace legacy Gmail FAQ execution with sessions (#5018)

## Change Replace the Gmail attachment FAQ’s hard-coded direct-execution examples with a session-first workflow: runtime tool discovery, explicit session file upload, conversion from sandbox paths to toolkit attachment storage keys, and checking the tool result before reporting success. The conflict with `next` is resolved by linking the maintained session quickstart and Python/TypeScript/API file-upload examples instead of duplicating SDK snippets in the FAQ. The updated FAQ preserves the corrected warning that automatic file upload is off by default, explains that the session files API is experimental, and links Gmail authentication and attachment storage-key guidance. ## Conflict resolution (2026-10-27) Merged `next` into `docs/gmail-session-faq` in cd7b4ed85. The change remains relevant because the target branch still used a hard-coded Gmail action for this FAQ. ## Verification of the resolved version - `cd docs && bun run test`: 815 passed, 0 failed. - `cd docs && bun run check:code-examples`: no violations in 444 files. - `cd docs && bun run lint:links`: both documentation and SDK link checks reported 0 errors. - Ran the local documentation app and visually checked the expanded Gmail attachment FAQ in Chromium, including keyboard activation of the accordion. - `/toolkits/gmail.md`: HTTP 200; the attachment answer contains session file upload and storage-key conversion guidance and no `composio.tools.execute` snippet. - No live Gmail send performed. These checks do not establish live email delivery or agent tool-selection quality. ## Original finding and prior evaluation - Original finding: https://agents.withgauge.com/composio-aclx/runs/cmvfzawkc00ay01nu9g4b5xhi?tab=logs - Historical Gauge rerun, before conflict resolution: https://agents.withgauge.com/composio-aclx/runs/cmvh6upes000c01jyx67upd8s - That single rerun was `NOT_EVALUABLE` and did not establish an overall improvement. It did not execute a live Gmail call. See the existing comments for details; Gauge was not rerun for this resolution.

Brendan O'Leary committed Oct 27, 2026 at 11:10 UTC 6de7d67a946cc8d166edf1d044745744771822b5

No changes.