@withone/cli 1.41.0 → 1.42.0

package/README.md

@@ -349,6 +349,22 @@ one sync run stripe --full-refresh
 
 Change hooks (`onInsert`, `onUpdate`, `onChange`) fire per-page during sync — pipe to a shell command, a flow, or an event log. Root-array responses (e.g. Hacker News `/v0/topstories.json` → `[9129911, 9129199, ...]`) are supported by setting `resultsPath` to `""`, `"$"`, or `"."`; primitive elements are auto-wrapped as `{ [idField]: value }`. Run `one guide sync` for the full reference.
 
+### `one relay`
+
+Receive webhooks from platforms and forward them to any connected platform via passthrough actions.
+
+```bash
+one relay platforms                        # List relay-capable platforms + event type counts
+one relay event-types <platform>           # List supported event types for a platform
+one relay create --connection-key <key> --create-webhook --event-filters '["event.type"]'
+one relay activate <id> --actions '<json>' # Attach passthrough forwarding actions
+one relay list                             # List existing relay endpoints
+one relay events --platform <p>            # Inspect received events
+one relay deliveries --endpoint-id <id>    # Check delivery status
+```
+
+Start with `one relay platforms` to discover which platforms support relay at all, then drill into `event-types <platform>` for the specific events. Run `one guide relay` for the full reference including `--metadata` requirements per platform.
+
 ### `one guide [topic]`
 
 Get the full CLI usage guide, designed for AI agents that only have the binary (no MCP, no IDE skills).

package/dist/{chunk-A5AFLKCQ.js → chunk-PK2RAVAF.js}

@@ -442,6 +442,9 @@ var OneApi = class {
   async listRelayEventTypes(platform) {
     return this.requestFull({ path: "/webhooks/relay/event-types", queryParams: { platform } });
   }
+  async listRelayPlatforms() {
+    return this.requestFull({ path: "/webhooks/relay/platforms" });
+  }
   async waitForConnection(platform, timeoutMs = 5 * 60 * 1e3, pollIntervalMs = 5e3, onPoll) {
     const startTime = Date.now();
     const existingConnections = await this.listConnections();
@@ -1137,7 +1140,7 @@ async function executeSubflowStep(step, context, api, permissions, allowedAction
   if (flowStack.includes(resolvedKey)) {
     throw new Error(`Circular flow detected: ${[...flowStack, resolvedKey].join(" \u2192 ")}`);
   }
-  const { loadFlowWithMeta: loadFlowWithMeta2 } = await import("./flow-runner-26LNPU4F.js");
+  const { loadFlowWithMeta: loadFlowWithMeta2 } = await import("./flow-runner-Y2CXXU3U.js");
   const { flow: subFlow, rootDir: subRootDir } = loadFlowWithMeta2(resolvedKey);
   const subContext = await executeFlow(
     subFlow,

package/dist/{flow-runner-26LNPU4F.js → flow-runner-Y2CXXU3U.js}

@@ -11,7 +11,7 @@ import {
   saveFlow,
   summarizeFlowInputs,
   walkSteps
-} from "./chunk-A5AFLKCQ.js";
+} from "./chunk-PK2RAVAF.js";
 export {
   FlowRunner,
   collectStepTypes,

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   resolveFlowPath,
   saveFlow,
   validateActionInput
-} from "./chunk-A5AFLKCQ.js";
+} from "./chunk-PK2RAVAF.js";
 
 // src/index.ts
 import { createRequire as createRequire2 } from "module";
@@ -4643,6 +4643,42 @@ async function relayDeliveriesCommand(options) {
     error(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
   }
 }
+async function relayPlatformsCommand() {
+  const { apiKey } = getConfig3();
+  const api = new OneApi(apiKey, getApiBase());
+  const spinner6 = createSpinner();
+  spinner6.start("Loading relay-capable platforms...");
+  try {
+    const platforms = await api.listRelayPlatforms();
+    if (isAgentMode()) {
+      json({ platforms });
+      return;
+    }
+    spinner6.stop(`${platforms.length} relay-capable platform${platforms.length === 1 ? "" : "s"} found`);
+    if (platforms.length === 0) {
+      console.log("\n  No relay-capable platforms available.\n");
+      return;
+    }
+    console.log();
+    printTable(
+      [
+        { key: "platform", label: "Platform" },
+        { key: "eventTypeCount", label: "Event types", color: pc8.dim }
+      ],
+      platforms.map((p10) => ({ platform: p10.platform, eventTypeCount: String(p10.eventTypeCount) }))
+    );
+    console.log();
+    console.log(
+      pc8.dim(
+        `  Run ${pc8.cyan("one relay event-types <platform>")} to see the full event list for a platform.
+`
+      )
+    );
+  } catch (error2) {
+    spinner6.stop("Failed to load relay platforms");
+    error(`Error: ${error2 instanceof Error ? error2.message : "Unknown error"}`);
+  }
+}
 async function relayEventTypesCommand(platform) {
   const { apiKey } = getConfig3();
   const api = new OneApi(apiKey, getApiBase());
@@ -7395,7 +7431,7 @@ function getApi() {
   if (!apiKey) {
     error('No API key configured. Run "one init" first.');
   }
-  return new OneApi(apiKey);
+  return new OneApi(apiKey, getApiBase());
 }
 async function syncProfilesCommand(platform) {
   const profiles = listBuiltinProfiles(platform);
@@ -8314,6 +8350,7 @@ Receive webhooks from platforms (Stripe, GitHub, Airtable, Attio, Google Calenda
 
 **Quick start:**
 \`\`\`bash
+one --agent relay platforms                                     # See relay-capable platforms
 one --agent relay event-types <platform>                        # See available events
 one --agent relay create --connection-key <key> --create-webhook --event-filters '["event.type"]'
 one --agent relay activate <id> --actions '[{"type":"passthrough","actionId":"...","connectionKey":"...","body":{...}}]'
@@ -8459,6 +8496,7 @@ Webhook relay receives events from platforms (Stripe, GitHub, Airtable, Attio, G
 ## Commands
 
 \`\`\`bash
+one --agent relay platforms                        # List relay-capable platforms + event type counts
 one --agent relay event-types <platform>          # List available events
 one --agent relay create --connection-key <key> --create-webhook --event-filters '["event.type"]'
 one --agent relay activate <id> --actions '<json>' # Add forwarding actions
@@ -8473,7 +8511,7 @@ one --agent relay deliveries --endpoint-id <id>    # Check delivery status
 
 ## Building a Relay
 
-1. **Discover connections** \u2014 identify source and destination platforms
+1. **Discover connections** \u2014 identify source and destination platforms. Use \`one --agent relay platforms\` to see which platforms support relay at all before digging into a specific one.
 2. **Get event types** \u2014 \`one --agent relay event-types <platform>\`
 3. **Get source knowledge** \u2014 understand the incoming webhook payload shape (\`{{payload.*}}\` paths)
 4. **Get destination knowledge** \u2014 understand the outgoing API body shape
@@ -9472,6 +9510,7 @@ program.name("one").option("--agent", "Machine-readable JSON output (no colors,
     one cache update-all                  Re-fetch fresh data for all cached entries
 
   Webhook Relay:
+    one relay platforms                   List platforms that support relay + event type counts
     one relay create                      Create a relay endpoint for a connection
     one relay list                        List relay endpoints
     one relay activate <id>               Activate with passthrough actions
@@ -9775,6 +9814,9 @@ relay.command("deliveries").description("List delivery attempts for an endpoint
 relay.command("event-types <platform>").description("List supported webhook event types for a platform").action(async (platform) => {
   await relayEventTypesCommand(platform);
 });
+relay.command("platforms").description("List all platforms that support webhook relay, with their event type counts").action(async () => {
+  await relayPlatformsCommand();
+});
 registerSyncCommands(program);
 var cache = program.command("cache").description("Manage the local knowledge and search cache");
 cache.command("clear [actionId]").description("Clear all cached data, or a specific action by ID").action(async (actionId) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withone/cli",
-  "version": "1.41.0",
+  "version": "1.42.0",
   "description": "CLI for managing One",
   "type": "module",
   "files": [

package/skills/one/references/relay.md

@@ -16,6 +16,14 @@ one --agent connection list
 
 Identify source (sends webhooks) and destination (receives forwarded data). Note both connection keys.
 
+If you're unsure whether the source platform supports relay at all, list relay-capable platforms first:
+
+```bash
+one --agent relay platforms
+```
+
+This returns `[{ "platform": "<name>", "eventTypeCount": <n> }, ...]` for every platform that One can receive webhooks from. If your source isn't in the list, relay won't work for it.
+
 ### Step 2: Get event types
 
 ```bash
@@ -173,6 +181,13 @@ one --agent relay activate <relay-id> --actions '[{
 }]'
 ```
 
+## Discovery Commands
+
+```bash
+one --agent relay platforms                        # All relay-capable platforms + event type counts
+one --agent relay event-types <platform>           # Event types for a specific platform
+```
+
 ## Management Commands
 
 ```bash