Repository navigation
docs(plugins): document the decisions API in the authoring guide - #2994
Merged
Merged
Conversation
Agents that build plugins read docs/plugin-authoring-guide.md through plugin_authoring_guide. Its extension-points table had no decisions row, so an agent without a buzz-app checkout could not find ctx.decisions, and the guide gave no pointer to the full plugin API. Add a decisions row in the shape of the other rows, including which provider answers by default (Builderlab with Jev, else TypeSafe), and a line that points to docs/plugin-architecture.md and the author types for services the table does not cover. Co-authored-by: Larry <627498bd4bd1f281a16431e3c6cce3b5c25b6692798c78672298aefbf2f8f8b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Logan Johnson <loganj@squareup.com>
Jev is the model both default providers answer with, not Builderlab's alone. timeoutMs is milliseconds, clamped to 1000-30000. Show how a plugin gets the community a decision bills, with a request and result example, and move the detail out of the table into its own section. Co-authored-by: Larry <627498bd4bd1f281a16431e3c6cce3b5c25b6692798c78672298aefbf2f8f8b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Logan Johnson <loganj@squareup.com>
Move the pointer to the full plugin API out of the Decisions section, say the row's Jev note is about the default providers, and treat an unconfirmed decisions status as possibly usable. Co-authored-by: Larry <627498bd4bd1f281a16431e3c6cce3b5c25b6692798c78672298aefbf2f8f8b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Logan Johnson <loganj@squareup.com>
The guide documents each service in one table row; a separate section for decisions made it a third longer. Keep the call, question types, timeout units, community and default provider in the row. Co-authored-by: Larry <627498bd4bd1f281a16431e3c6cce3b5c25b6692798c78672298aefbf2f8f8b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Logan Johnson <loganj@squareup.com>
loganj
marked this pull request as ready for review
November 7, 2026 17:54
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
channelContext is optional; only panels opened from a channel get it. Co-authored-by: Larry <627498bd4bd1f281a16431e3c6cce3b5c25b6692798c78672298aefbf2f8f8b5@buzz.block.builderlab.xyz> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Logan Johnson <loganj@squareup.com>
This comment has been minimized.
This comment has been minimized.
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
baxen
approved these changes
Nov 7, 2026
tlongwell-block
added a commit
that referenced
this pull request
Nov 8, 2026
* origin/main: (47 commits) fix(relay): report a community's membership refusal once, not as raw 403s (#3012) test(browser): fix red main and two cross-PR flakes (#3015) feat(agent-activity): keep remote agent outcomes readable (#2913) test(solo): cover agent tagging behind a background read-state snapshot (#2941) fix(desktop): quit on SIGTERM, SIGINT and SIGHUP so agents stop with Buzz (#2905) feat(unread): opening a channel quiets its sidebar row (#2998) fix(goose): end the turn when a final send succeeds (#2997) fix(relay): report a community's refusal once, not as raw 403s (#2978) Give fast Builderlab models their own section and a bolt in the model picker (#2592) feat(dev): `just desktop me` keeps Keychain approvals across rebuilds (#3002) fix(relay): show one quiet reconnect toast after 30 s, above the composer (#2968) feat(memory): render rich markdown and navigable buzz links (#2981) fix(identity): never strand first run on a key another account holds (#2996) Let agent_create propose instructions (#2332) fix(unread): raise a local read floor over dropped marks, and halve save validation (#2977) Add Codex huddle auto-join and thinking presence (#2927) feat(claude): set up Claude from a button beside Harness (#2975) docs(plugins): document the decisions API in the authoring guide (#2994) fix(agent-harness): stop telling agents to use GitHub-flavored Markdown (#2639) feat(identity): brand federated sign-in and return to the app (#2982) ... Signed-off-by: Tyler Longwell <tlongwell@squareup.com> Co-authored-by: Eva <011987e296fd5006292d2f930b574be47c7801048d1983c46c425d3c95f0cffd@buzz.block.builderlab.xyz> # Conflicts: # src/bundled/codex/voice.ts
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.
Summary
plugin_authoring_guideagent tool). That guide had no entry for the decisions API, which lets a plugin ask fast yes/no, choice or score questions about a piece of text. An agent working without the Buzz source could not find it.decisionsrow like its neighbours: the call, the question types, the result, how to pass the community the text came from (Builderlab refuses a request without it), and which provider answers by default (Builderlab or TypeSafe, with the Jev model).maincan describe services the running app does not have yet.Details
docs/plugin-authoring-guide.md. The app bundles this file and returns it as is fromplugin_authoring_guide, so the change reaches agents with the next build.timeoutMsis documented as milliseconds (1000–30000), assrc/features/decisions/service.tsenforces; an agent reading "seconds" would pass5and get a 1 s deadline.decisions_askdoes), andchannelContext.relayUrlin a panel opened from a channel.🤖 Generated with Claude Code