@devries-cameron20 / composio Mirror · read-only / commits / c89e66efb
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 12:15 UTC

fix(cli): curated help for every command family and a help command (#4421)

This PR: - follows https://github.com/ComposioHQ/composio/pull/3901 (merged as 0abc629f5) - fixes a help-system inconsistency: whole command families (`orgs`, `signup`, `agent`, `connections`, `triggers`, `artifacts`, `install`) silently fell through to the framework's raw parser rendering instead of the curated styled help pages every other family gets - adds curated help entries for the `agent` children (`agent signup`, `agent login`, `agent whoami`, `agent inbox`, `agent claim`), mirroring the `orgs list`/`orgs switch` pattern - adds `composio help [command] [level]` — the framework has no builtin help command, so `composio help orgs` now routes to the same curated page as `composio orgs --help`; bare `composio help` keeps printing the root help. The spelling resolves targets with the same longest-prefix scan as `--help` (so `composio help dev toolkits` renders the curated dev page), and an unknown target falls through to the framework parser (stderr, "Did you mean?", exit 1) exactly like any other unknown command - fixes the stale `orgs` description in the contextual-error help registry - adds a consistency regression test that walks every visible root command and fails when any lacks a curated help entry, plus routing tests for every `composio help` path (bare, family, child, level suffixes, trailing `--help`, deep-path fallback, and unknown targets) ## Context Auditing the CLI surfaced that `composio orgs --help` rendered a completely different page from `composio config --help`: unstyled headers, a different section layout, and the root-level `--log-level` flag exposed on a subcommand page. Root cause: `root-help.ts`'s `SUBCOMMAND_HELP` registry — which drives the curated `--help` pages — was missing those commands, so they fell through `matchSubcommandHelp` to v4's default parser rendering. The new consistency test walks the visible root command graph and locks this class shut; it caught `signup` and `agent` during development. Review follow-ups (from code review + prior feedback): - the `agent` family now has per-command entries, so `composio agent signup --help` and `composio help agent signup` show signup's own flags instead of the group page / an "Unknown command" line - `composio help <unknown>` no longer prints "Unknown command" to stdout with exit 0; it fails through the framework parser like every other unknown command, so scripted probes and the stdout data channel stay honest - the `help` spelling resolves deep paths with the same longest-prefix fallback `--help` uses - the two rendering tests now actually execute (`layer(TestLive())` + `it.effect`) — previously they returned a bare `Effect` from a plain `it` and passed vacuously - the changelog no longer lists `tools` as newly curated (its entry already existed at the base of this PR) Guidance-only surface: no parsing, execution, or exit-code behavior changes beyond the `help` spelling itself — help pages and the new `help` command only. Validation: - `pnpm --filter @composio/cli typecheck` and full suite: 1342 passed (16 new tests, all executing under `layer(TestLive())`) - oxlint and prettier clean - binary smoke-tested: orgs/signup/agent (group + children)/connections/triggers/tools/artifacts/install help pages, all `composio help` paths (bare, family, child, level, deep-path, unknown -> parser error on stderr), and `whoami` against the staging API Built on top of the merged #3901.

Alberto Schiabel committed Sep 16, 2026 at 23:19 UTC c89e66efbc250b68e9f7ae1bf73a482efea89e69

No changes.