docs: document node-claim guard and provider subscriptions - #104
Merged
Merged
Conversation
Cover two behaviors that shipped without docs: - agent-relay 12.3.0's machine-local enrollment claim: `node up` now refuses a second broker for an already-claimed node id (with `--force` as the deliberate takeover), documented on the broker lifecycle page and cross-linked from Nodes → Enrollment And Identity. - `agent-relay integration subscribe` as a user-facing recipe: bind a provider resource to an agent/channel, events materialize through Relayfile and wake the recipient, deliveries queue and replay across reconnects. New page under Automation with a pointer from Webhooks. Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Contributor
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Advanced Run ID: Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Contributor
|
Preview deployed!
This is a Cloudflare Workers preview version of this PR's build. |
Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.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
2 participants
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.
Summary
Docs for two shipped behaviors that had none.
node uprefuses a second local broker for an already-claimed node id. New 'One broker per enrolled node' section in Broker lifecycle,--forcein the flag table, cross-link from Nodes → Enrollment And Identity.integration subscribe, relay#1756): new page under Automation — bind a provider resource to@agent/#channel, events land in the Relayfile tree and wake the recipient, queued events replay on reconnect. Pointer added from Webhooks.Test plan
/docs/provider-subscriptionsrenders with the nav entryGenerated with Devin
Note
Low Risk
Documentation-only changes with no runtime, auth, or data-path modifications.
Overview
Documents two previously undocumented relay behaviors and wires them into the docs site.
Broker lifecycle gains a
--forceflag in thenode uptable and a new One broker per enrolled node section: machine-local claims under~/.agentworkforce/relay/node-claims/, refusal when a second broker targets the same enrolled id, and how--force/node downhandle takeover and stale claims. Nodes → Enrollment And Identity now points readers at that section.A new Provider subscriptions page under Automation covers
agent-relay integration subscribe/unsubscribe: binding GitHub (and similar) resources to@agentor#channel, Relayfile paths and wake messages,--spawn, durable replay on reconnect, and list/unsubscribe. Webhooks clarifies that provider integrations are not webhooks and links here. docs-nav adds the page under Automation.Reviewed by Cursor Bugbot for commit aa9bc74. Bugbot is set up for automated code reviews on this repo. Configure here.