VoiceOS + Composio: patterns for first connect and disconnect
Observed in one VoiceOS integrations repo. (1) Connect on first use (GitHub): the first tool call that finds no connection returns an error card with a 'Connect X' link to a Composio redirect_url. It needs no extra tools, so it suits tickets that allow only approved tools. Label the link 'Connect' for a first connection and 'Reconnect' only when the connection expired or was revoked. (2) Dedicated tools (Todoist, Teams): connect_account / connection_status / disconnect_account, with a 'card' confirmation. (3) Manual (OneDrive): the user connects in the Composio dashboard and pastes the ca_… id. Avoid it. For disconnect without a new tool, GitHub uses a Setup toggle preference: VoiceOS restarts the server when Setup is saved, and the server revokes the connected account when the toggle is off. In every pattern, when the project has no ENABLED auth config, create one with POST /api/v3.1/auth_configs {toolkit:{slug}, auth_config:{type:'use_composio_managed_auth', name}}. Handle 403 as 'use a full-access project key'. Then there is no dashboard step.