Skip to content

docs(rf-api): add bounded polling for async jobs - #15

Open
ai94iq wants to merge 4 commits into
MarketSquare:mainfrom
ai94iq:docs/bounded-polling
Open

ai94iq wants to merge 4 commits into
MarketSquare:mainfrom
ai94iq:docs/bounded-polling

Conversation

@ai94iq

@ai94iq ai94iq commented Nov 15, 2026 •

Copy link
Copy Markdown

Adds an async job reference to rf-requests: wait for a job with a time-bound poll, not a fixed Sleep.

Verified: the example passes robot --dryrun on Robot Framework 7.5.1 with RequestsLibrary 0.9.7. Catalog, governance, plugin references and docs voice checks pass.

What this changes

The poll lives in a keyword, uses limit=60s with a short pause between calls, and fails with a message on timeout. Builds on #13, so merge #13 first.

Review checklist

Tick each item, or write "n/a: " after it. Reviewers don't approve a PR
with an unticked item that has no reason (see CONTRIBUTING.md, "Review").

  • Purpose. Each new or changed skill and subagent says what it is for and when to use it, in its description. n/a: no skill description change, only a new reference
  • Supported versions. catalog.yaml lists the libraries and version ranges the content was checked against, and the Robot Framework range. n/a: no new library, catalog.yaml is unchanged
  • Examples. .robot examples pass robot --dryrun; Python examples run.
  • Security-relevant changes. Hooks, scripts, MCP configuration, manifests, subagent tools and skill allowed-tools changes are listed below; the security gate passes, and any new baseline entry has a reason. n/a: no hook, script, manifest or tools change
  • Tool permissions. Every subagent declares an explicit tools list; no allowed-tools entry grants unrestricted shell access. n/a: no subagent or allowed-tools change
  • Documentation voice. Text follows the writing rules in CONTRIBUTING.md and passes the docs voice check.

Security-relevant changes

none

Add a reference of checks that pass against a broken endpoint to
rf-requests and rf-restinstance. Each entry names the check to use
instead. Both SKILL.md files link to the new reference.
Add a reference that waits for an async API job with a bounded WHILE
loop instead of Sleep. The rf-requests SKILL.md links to it.
Both branches add one row to the rf-requests reference table. Kept both
rows so the branches merge cleanly in order. Plugin and bundle copies
match (cmp).
@ai94iq
ai94iq requested a review from manykarim as a code owner November 15, 2026 07:48
@ai94iq ai94iq changed the title Docs/bounded polling docs(rf-api): add bounded polling for async jobs Nov 15, 2026
async-jobs.md: limit=60s instead of an iteration count, a short Sleep
between polls, the WHILE loop moved into a keyword, $state expression
form, and the version note corrected (limit since RF 5.0,
on_limit_message since RF 6.1). Plugin and bundle copies match (cmp).
@ai94iq

ai94iq commented Nov 15, 2026

Copy link
Copy Markdown
Author

Merge chain: #11, then #12, then #13, then #14, then #15, then #16.

All six merge into main cleanly in this order (dry run on 2026-11-15).

This one depends on #13: both change the same table in the rf-requests SKILL.md. The branch already has #13 merged in, so its diff shows #13 changes until #13 lands.

Apart from #13 and #15, the PRs do not depend on each other.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant