Skip to content

feat: one relay platforms — discover relay-capable platforms#124

Merged
moekatib merged 2 commits intomainfrom
feature/int-2189-cli-list-relay-platforms
Apr 22, 2026
Merged

feat: one relay platforms — discover relay-capable platforms#124
moekatib merged 2 commits intomainfrom
feature/int-2189-cli-list-relay-platforms

Conversation

@siddharth-bhansali
Copy link
Copy Markdown
Collaborator

Summary

Adds a new one relay platforms subcommand that lists every platform supporting webhook relay, with the number of event types each exposes. Previously users had to guess a platform and try relay event-types <platform> to find out whether relay was supported at all.

Also includes a small pre-existing fix: sync/index.ts was constructing new OneApi(apiKey) without passing apiBase, causing sync to always hit prod even when the CLI was configured for dev.

Closes #123

Changes

New command

# Agent mode
$ one --agent relay platforms
{"platforms":[{"platform":"airtable","eventTypeCount":3},{"platform":"attio","eventTypeCount":27}, ...]}

# Human mode
$ one relay platforms
  Platform         Event types
  ───────────────  ───────────
  airtable         3
  attio            27
  autodesk         20
  brevo            17
  ...
  stripe           224
  typeform         2
  webflow          14

  Run `one relay event-types <platform>` to see the full event list for a platform.

Calls GET /webhooks/relay/platforms (no auth required).

Files changed

  • src/lib/api.ts — added listRelayPlatforms()
  • src/commands/relay.ts — added relayPlatformsCommand with agent + human output
  • src/index.ts — registered one relay platforms and added it to the top-level help text
  • src/lib/guide-content.ts — surfaced in overview + relay topic
  • skills/one/references/relay.md — added to Step 1 discovery flow + new "Discovery Commands" section
  • README.md — added a one relay section (was previously undocumented)
  • src/lib/sync/index.ts — pass getApiBase() to sync's OneApi instance
  • package.json — 1.41.0 → 1.42.0

Test plan

  • npx tsup builds cleanly
  • one relay platforms --agent returns the platforms array
  • one relay platforms renders the table in human mode
  • one relay event-types airtable still works (no regression)
  • one relay --help lists the new platforms subcommand
  • Reviewer to verify docs read well in rendered GitHub preview

🤖 Generated with Claude Code

siddharth-bhansali and others added 2 commits April 22, 2026 21:23
sync/index.ts constructed `new OneApi(apiKey)` without the apiBase
argument, so sync always hit prod even when the CLI was configured
for dev. This caused "Invalid or expired API key" errors on sync
commands (test, run) despite the config being valid.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a new subcommand to discover which platforms support webhook
relay and how many event types each offers. Previously users had to
guess a platform and try `relay event-types <platform>` to find out.

Calls GET /webhooks/relay/platforms (no auth) and renders:
- agent mode: {"platforms": [{"platform", "eventTypeCount"}, ...]}
- human mode: two-column table with event type counts

Updates README, `one guide relay`, and the agent-facing skill doc
(skills/one/references/relay.md) to surface the new discovery path.

Version bumped to 1.42.0 per release checklist.

Closes #123

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@siddharth-bhansali siddharth-bhansali self-assigned this Apr 22, 2026
@linear
Copy link
Copy Markdown

linear Bot commented Apr 22, 2026

INT-2189

@moekatib moekatib marked this pull request as ready for review April 22, 2026 17:01
@moekatib moekatib merged commit 582cce1 into main Apr 22, 2026
@moekatib moekatib deleted the feature/int-2189-cli-list-relay-platforms branch April 22, 2026 17:01
@moekatib moekatib mentioned this pull request May 3, 2026
8 tasks
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.

[Relay] Add command to list relay-capable platforms

2 participants