Skip to content

Support multiple agent frameworks including Cargo AI and Mastra#7

Closed
ryw wants to merge 2 commits into
mainfrom
tembo/research-agent-frameworks-1
Closed

Support multiple agent frameworks including Cargo AI and Mastra#7
ryw wants to merge 2 commits into
mainfrom
tembo/research-agent-frameworks-1

Conversation

@ryw
Copy link
Copy Markdown
Member

@ryw ryw commented May 19, 2026

Summary

  • Added detailed documentation on supported agent frameworks in context/0.1/AGENT_FORMAT.md, recommending Pydantic AI AgentSpec and Cargo AI JSON as declarative defaults.
  • Included support for code-defined frameworks like LangGraph, OpenAI Agents SDK, Mastra, and CrewAI.
  • Updated onboarding script to create starter agents in both Pydantic AI YAML and Cargo AI JSON formats.
  • Enhanced agents/README.md to explain supported agent formats and usage guidance.
  • Updated context docs (README.md, DEMO_SCRIPT.md, USER_STORIES.md) to reflect multi-format support and governance model.
  • Provided a sample Pydantic AI AgentSpec YAML agent starter file (hello-world.yaml).
  • Clarified that PR policy engine governs all formats equally, enabling flexible authoring and review workflows.

This PR researches, documents, and implements multi-format agent support, including cargo-ai and Mastra, with recommendations and starter templates.


Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

View on Tembo View Agent Settings

tembo Bot and others added 2 commits May 19, 2026 17:04
…pport

Co-authored-by: Ry <4283+ryw@users.noreply.github.com>
…gent formats

Co-authored-by: Ry <4283+ryw@users.noreply.github.com>
@tembo tembo Bot added the tembo Pull request created by Tembo label May 19, 2026
ryw added a commit that referenced this pull request May 22, 2026
PR #7 argued — correctly — that the v0.1 AGENT_FORMAT decision's universal
diff-readability premise breaks down once you account for v0.2's YOLO mode
(CI as the gate) and v0.4's RBAC (production review applies regardless of
format). Capturing that intent here rather than merging #7, which conflicts
with the deleted Node CLI placeholder and pre-dates PR #5/#6 + the v0.1
scaffold.

- context/0.3/README.md: new "Direction (v0.3+): Multi-framework agent
  runtime support" section names LangGraph / OpenAI Agents SDK / Mastra /
  CrewAI / Pydantic AI code mode as candidate first-class supported
  runtimes, defines what "supported" means (runtime, git, runs/logs, HITL,
  observability, governance), and explicitly defers shipping pacing to
  pilot demand. Adds matching FAQ + open questions.
- context/0.3/USER_STORIES.md: US-0.3-13 — run a code-defined agent with
  full parity on governance, dashboards, and HITL.
- context/0.1/AGENT_FORMAT.md: forward-pointer from "Why we did not pick a
  code-first framework" to the v0.3 direction, and a matching bullet in
  the v0.3 row of the per-phase table.

Closes-in-intent: #7 (PR closed manually; substance recorded here).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@ryw
Copy link
Copy Markdown
Member Author

ryw commented May 22, 2026

Closing in favor of c2b4829 on main, which captures the intent of this PR as a v0.3+ direction rather than a v0.1 ADR revision.

Why not merge as-is

What got captured in c2b4829

  • context/0.3/README.md — new top-level "Direction (v0.3+): Multi-framework agent runtime support" section. Names LangGraph, OpenAI Agents SDK, Mastra, CrewAI, and Pydantic AI code mode as candidate first-class supported runtimes; defines what "supported" means (runtime, git, runs/logs, HITL, observability, governance — all format-agnostic); explicit non-promise that this lands inside v0.3's exit bar.
  • context/0.3/USER_STORIES.md — US-0.3-13 for running a code-defined agent with full parity.
  • context/0.1/AGENT_FORMAT.md — forward-pointer in "Why we did not pick a code-first framework" so the v0.3 relaxation is visible to anyone reading the v0.1 decision.

Key argument from this PR that survives: YOLO mode (per v0.2 PR policy) breaks the "universal diff-readability" premise the v0.1 AGENT_FORMAT decision rests on. Format is not the governance lever; the policy engine is. That reasoning is now in the v0.3 README direction section.

What was not pulled forward

  • The dev-vs-production lifecycle gating table — already implicit in v0.2 + v0.4 docs.
  • Deletion of the "Why we did not pick CrewAI specifically" section in AGENT_FORMAT.md — kept so the historical v0.1 decision stays legible.
  • The bin/tembo-agent-studio.js changes — file no longer exists.

Thanks for the research and the well-argued case — it shifted the decision.

@ryw ryw closed this May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tembo Pull request created by Tembo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant