Repository navigation
docs(relay): match Core's relay behaviour in the guide, skill and help (v2.16.1) - #244
Merged
Merged
Conversation
…p (v2.16.1) `one guide relay` and the skill's relay reference were checked against Core's relay code. What agents were told that was wrong: - Only GitHub and Typeform need --metadata, and Airtable needs none. 49 platforms need it, Airtable included; the full table is in both. A create response with a warning means the webhook wasn't registered. - A wrong --webhook-secret gives "events but 0 deliveries". It gives no events at all (401 at the door) on every relay on the connection. - url actions forward the raw event. They POST a JSON envelope signed with X-Relay-Signature. - agent actions can be built from the CLI. They only deliver through an agent's event trigger, so the guide now says to use a url action. Also: rendered template values are always strings, pathVariables are templated, update replaces lists, delete leaves the source webhook, retries, and one relay per source connection. --metadata and --webhook-secret help text say the same. Version bump so installed skill files refresh. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
paulkr
added a commit
to RachitSrivastava12/cli
that referenced
this pull request
Nov 20, 2026
main took 2.16.1 (withoneai#244) while this PR was open. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Agents set up relays by following
one guide relayand the skill'sreferences/relay.md. Both had claims that don't match Core's relay code, and the worst one makes relays fail without any error: they told agents that Airtable needs no--metadata, so an agent would create an Airtable relay whose webhook never gets registered.What changed
src/lib/guide-content.ts(GUIDE_RELAY) andskills/one/references/relay.md:--metadata: the table now lists all 49 platforms that need it (Airtable, Asana, Calendly, Monday and more), not only GitHub and Typeform. Awarningin the create response means the webhook wasn't registered: show it to the user, delete the endpoint, and create it again.--webhook-secret: a wrong secret doesn't give "events but 0 deliveries". It replaces the secret stored for the whole connection, so One answers the source's webhooks with 401 and records no events. Agents should pass it only when activate asks for one.{{json}}gives a string, andpathVariablesare templated and fail on a missing value. Triple braces are refused inheadersandpathVariables.urlaction: the request body is a JSON envelope, not the raw event. The guide and skill now list theX-Relay-*headers and theX-Relay-SignatureHMAC.agentaction: it only delivers through an agent's event trigger, so agents are told to use aurlaction to reach the user's own agent or server.updatereplaces lists.--no-activestill records events.deleteleaves the webhook at the source.src/cli.ts: therelay create --metadataandrelay activate --webhook-secrethelp text say the same.Version 2.16.0 → 2.16.1, so users' installed skill files refresh.
Testing
tsc --noEmitpasses.npm test: 910 of 918 pass. The 6 failures are theresolveConfigtests, which fail the same way onmain.one --agent guide relayand the two--helpoutputs with an emptyHOME; the new text is there.main(webhook/src/registration/platform/*.rsfor the metadata keys,webhook/src/inboundandcore/src/http/routes/common/webhook_relay.rsfor signatures and delivery). I did not trigger live webhooks.Companion website PR: withoneai/landing#190. It also lists the Core and dashboard issues found along the way.
🤖 Generated with Claude Code