Skip to content

feat: add human-friendly connected-app action prompts - #282

Merged
iamjr15 merged 1 commit into
mainfrom
feat/human-connected-actions
Aug 13, 2026
Merged

feat: add human-friendly connected-app action prompts#282
iamjr15 merged 1 commit into
mainfrom
feat/human-connected-actions

Conversation

@iamjr15

@iamjr15 iamjr15 commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Replace raw provider API descriptions in connected-app drawers with product-owned starter prompts.
  • Keep actions immediately usable while collecting only missing details in plain language.
  • Require confirmation before destructive actions and preserve connected-app branding.

Architecture

Composio remains the bounded source of tool schemas for the agent. The gateway now owns a separate presentation boundary that maps provider tool metadata to the strict { name, prompt, slug } UI contract. The web renders and launches that prompt without deriving copy from provider documentation.

Decisions Made

Decision Choice Alternatives considered Reasoning
UI copy ownership Gateway-owned shared formatter Display description or human_description Both provider fields contain API concepts and identifiers; product copy must be stable and user-facing.
Safety Confirmation language for destructive actions Generic prompt for every action Delete, revoke, and similar operations need explicit confirmation before execution.
Compatibility One toolkit-agnostic formatter Per-connector prompt tables A shared action-family model covers every current and future Composio toolkit without connector patches.

Edge Cases Handled

  • Missing optional tool names fall back to readable slugs.
  • Singular, plural, uncountable, and vowel-sound wording stays grammatical.
  • Toolkit display names retain official capitalization.
  • Oversized but valid provider descriptions remain bounded and parseable.
  • Deprecated actions remain excluded.

How to Review

  1. Start with integration-action-presentation-support.ts for the presentation policy.
  2. Check integrations-catalog.ts and packages/types/src/api.ts for the API boundary.
  3. Check integration-skill-drawer.tsx for the direct prompt-launch behavior.

Verification

  • pnpm lint
  • pnpm typecheck
  • pnpm turbo build --force
  • pnpm deadcode
  • pnpm architecture:check
  • pnpm turbo skills:build
  • Live Composio sweep: 424 important actions across the 20 most-used toolkits, zero jargon/grammar/contract violations
  • Production Gmail and Notion drawer interaction after deploy
  • Production Gmail safe read action after deploy

Replace provider API documentation in connected-app drawers with product-owned prompts.
Collect missing details, preserve app branding, and confirm destructive actions.
@iamjr15
iamjr15 merged commit 6e4b5d1 into main Aug 13, 2026
4 checks passed
@iamjr15
iamjr15 deleted the feat/human-connected-actions branch August 13, 2026 13:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant