Skip to content

docs(readme): new loop diagram and a first-class README - #279

Merged
yuanhao merged 3 commits into
mainfrom
docs/readme-refresh
Oct 9, 2026
Merged

yuanhao merged 3 commits into
mainfrom
docs/readme-refresh

Conversation

@yuanhao

@yuanhao yuanhao commented Oct 9, 2026

Copy link
Copy Markdown
Collaborator

Diagram (docs/images/loop.svg + loop-light.svg, same style): the old one predated Extension (July, ~0.13). The new one shows the hooks at their real points — on_input, before_model, before_tool (after middleware), after_tool, on_stop — with on_stop's continue back into the loop, limits / loop detection as a second exit, "7 protocols · retry" (Bedrock streams eventstream, not SSE), and the title "a loop library, not an agent".

README

  • Proof line under the tagline (yoyo since March 2026; laptop to Cloudflare Worker).
  • "How yoagent differs" → Why yoagent: the failure modes, the core rule, a link to the design philosophy; fail-closed note on extensions.
  • New Extend it: a 15-line RunHooks policy (compile-checked against main), how yoagent's own budget/gate/guard use it, plugins via yoagent-rutis and the pi / DSH adapters.
  • New Runs where agents run: Workers numbers (4 ms start, ~45 ms CPU median per run, ~330 KiB gzipped with one provider), HTTP MCP over fetch, yoagent-workers.
  • What's in the box as a table; examples count (17 of 21) plus the companion crates' examples.
  • Contributing (issues, help wanted), Security link, Acknowledgements (rutis).

Unchanged: the one-command demo, Install, Quick start, comparison table, Built with, Examples table, Testing, Documentation, License.

🤖 Generated with Claude Code

https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG

yuanhao and others added 3 commits October 9, 2026 13:40
…tributing

- Diagram (dark + light): the Extension hooks at their real points
  (on_input, before_model, before_tool, after_tool, on_stop), on_stop's
  continue back into the loop, limits as a second exit, '7 protocols ·
  retry' (Bedrock is not SSE), title 'a loop library, not an agent'.
- README: proof line under the tagline; 'Why yoagent' with the core rule;
  'Extend it' (a compiled-checked policy snippet, plugins and the pi/DSH
  ecosystems); 'Runs where agents run' (Workers numbers); What's in the box
  as a table; examples count and the companion crates' examples;
  Contributing, Security, Acknowledgements.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG
Fail-closed scoped to hooks that guard a call; Workers numbers qualified
(yoyo's Worker; a minimal Worker for the size); 'many' pi extensions, and
refused rather than half-run; GASP plugin logs opt-in; 22 examples.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG
@yuanhao
yuanhao merged commit a2d76ab into main Oct 9, 2026
15 checks passed
@yuanhao
yuanhao deleted the docs/readme-refresh branch October 9, 2026 11:48
@yuanhao yuanhao mentioned this pull request Oct 9, 2026
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