docs: add --since to message wait/wait-loop in CLI reference [doc-updater] - #1936
Merged
Conversation
…ater] Update orchestrator-cli.md command table to show [--since <id>] for message wait and message wait-loop, and note the new-events-only default (stream-tip cursor) introduced by #1925. The agent-wait-patterns.md zero-drop pattern added in #1933 explicitly uses --since with wait-loop, but the CLI reference table did not show that flag for these commands. Triggered by: #1933 Authored-by: egg
Contributor
There was a problem hiding this comment.
Doc-only change, two lines in a single file. Verified against the implementation:
--sinceflag exists in both CLI parsers (sandbox/bin/egg-orchlines 2223, 2256) and flows through the handler (sandbox/egg_agent_tools/handlers/message.py) to the server endpoint.- Stream-tip default is accurate:
orchestrator/routes/messages.pysetsfrom_tip=since_id is None, so cursor-less calls skip already-seen events — matches the new description. - "zero-drop send→wait semantics" correctly describes the
--sinceescape hatch documented in agent-wait-patterns.md §3. - The section links (§1, §3) are unchanged and still point to the correct anchors.
The usage examples later in the same file (lines 121-134) don't show --since, which is fine — they predate the stream-tip change and remain valid since --since is optional.
No issues found. Accurate, minimal, well-scoped update.
— Authored by egg
Contributor
Author
|
egg review completed. View run logs |
jwbron
approved these changes
Apr 23, 2026
james-in-a-box Bot
added a commit
that referenced
this pull request
Apr 24, 2026
…ater] (#1936) Update orchestrator-cli.md command table to show [--since <id>] for message wait and message wait-loop, and note the new-events-only default (stream-tip cursor) introduced by #1925. The agent-wait-patterns.md zero-drop pattern added in #1933 explicitly uses --since with wait-loop, but the CLI reference table did not show that flag for these commands. Triggered by: #1933 Authored-by: egg Co-authored-by: jwbron <8340608+jwbron@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
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.
Update orchestrator-cli.md to reflect the stream-tip default and
--sinceoption introduced by #1933 (fix #1925).#1933added a "New events only" section toagent-wait-patterns.mddocumenting that cursor-less
wait/wait-loopcalls now start atthe stream tip. That doc's zero-drop pattern explicitly uses
--since <id>withwait-loop, but the command table inorchestrator-cli.mddid not list--sincefor eithermessage waitor
message wait-loop.Changes:
[--since <id>]to themessage waitandmessage wait-loopcommand signatures in the reference table
one-line descriptions so agents reading the CLI reference understand
the behavior change without having to follow the link
Triggered by: #1933
Test Plan
Authored-by: egg