Add Hypha to Agent Frameworks (tri-lingual) - #87
Conversation
Hypha (CodeSoul-co/Hypha) is an Apache-2.0 TypeScript agent framework that separates an Agent Core from a Production Harness, with versioned DomainPacks and a cache plane that cannot authorise side effects. Listed with the Unverified tag rather than as a plain entry: - The vendor's Skill Garden gates private Skill downloads behind starring this repo, so the star count is not a clean adoption signal. - npm downloads for @codesoul-co/hypha-core were ~32/month on 2026-08-22. - The vendor-published tau-cubed result (0.636 vs 0.626 over 385 single-trial tasks) is inside statistical noise, so it is described as such rather than quoted as a win. Verified 2026-08-22: v1.0.1 (2026-08-14), Apache-2.0, 15 npm packages, 4 contributors, CI active. sync_audit and check_markdown both pass (858 entries, en/zh/ja fully in sync).
π PR Spam Guard reportSubmitter:
|
There was a problem hiding this comment.
π‘ Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: cad8305091
βΉοΈ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with π.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| - [Pydantic AI](https://github.com/pydantic/pydantic-ai) - π β‘ **v2.31.0 (August 15, 2026)** β near-daily release cadence; a 1.107.x maintenance line stays active. Agent framework from the Pydantic team that brings FastAPI-style ergonomics and real type safety to LLM apps β structured outputs validated by Pydantic models, dependency injection, streaming, and model-agnostic providers. The default pick when you want static typing and validated tool I/O rather than free-form prompt chaining.  | ||
| - [Mastra](https://github.com/mastra-ai/mastra) - π β‘ TypeScript-first agent framework with workflow-driven development and built-in observability. **`@mastra/core@1.59.0` (August 14, 2026)**.  | ||
| - [Agon](https://github.com/AutoResearch-Factory/Agon) - π β οΈ **Unverified** (35 stars, MIT). Autonomous omnidisciplinary research orchestrator built as a **Claude Code plugin** β scientist/coder/auditor multi-agent loop takes a bare topic all the way to running experiments with no human-written experimental code. 18 roles in 230.6 KiB of prompts across 10+ disciplines; 30-day continuous autonomous run documented.  | ||
| - [Hypha](https://github.com/CodeSoul-co/Hypha) - π β οΈ **Unverified** (v1.0.1, August 14, 2026; Apache-2.0). TypeScript agent framework from CodeSoul that separates an **Agent Core** (ReAct, planning, tool selection, memory) from a **Production Harness** (FSM execution, policy/approval, checkpoints, recovery, replay, audit); product behaviour is declared as versioned **DomainPacks**, and a typed cache plane is explicitly barred from authorising side effects or advancing the FSM. 15 `@codesoul-co/hypha-*` packages on npm. β οΈ Treat the star count with caution: the vendor's Skill Garden gates private Skill downloads behind starring this repo, npm downloads were ~32/month as of 2026-08-22, and the vendor-published ΟΒ³ result (0.636 vs 0.626 direct-model baseline over 385 single-trial tasks) is inside statistical noise.  |
There was a problem hiding this comment.
Link the non-obvious evidence directly
The new entry gives a release date, npm download count, Skill Garden gating claim, and benchmark results, but its only destinations are the repository root and a star badge. This prevents readers from verifying the claims and violates CONTRIBUTING.md:31-33, which requires dates and benchmark scores to link directly to primary sources; add direct release notes, npm statistics, gating-policy, and benchmark links to this entry and its two translations.
Useful? React with πΒ / π.
Keep the Unverified tag on adoption grounds only (npm downloads, benchmark inside noise). The star-gating observation is removed from the public entry.
Adds Hypha to Agent Frameworks in all three READMEs, following an outreach email from the CodeSoul team.
Why it belongs
Apache-2.0, TypeScript, public release v1.0.1 (2026-08-14), 15 aligned
@codesoul-co/hypha-*packages on npm, 4 contributors, CI active. The design point is real and under-represented in this list: an Agent Core (ReAct, planning, tool selection, memory) split from a Production Harness (FSM execution, policy/approval, checkpoints, recovery, replay, audit), with product behaviour declared as versioned DomainPacks. Its "reuse without authority" rule β a cache hit may skip recomputation but can never authorise a tool call, advance the FSM, or replace event evidence β is a genuinely useful invariant.Why the Unverified tag rather than a plain entry
It clears the 100+ star bar on paper (432 stars on 2026-08-22), but independent adoption has not shown up yet:
@codesoul-co/hypha-corehad 32 downloads in the last month as of 2026-08-22.The tag can come off once third-party adoption appears.
Verification
python3 scripts/sync_audit.py --summary->RESULT: en/zh/ja fully in sync(858 entries each)python3 scripts/check_markdown.py->RESULT: markdown structurally cleanNot included
CodeSoul's Skill Garden is deliberately left out. The public repo is a usage guide; the actual Skill packages sit behind sign-in and eligibility checks, which fails the "publicly accessible" requirement in CONTRIBUTING.md.