Skip to content

Support Pydantic AI and Cargo AI agent formats#5

Merged
ryw merged 1 commit into
mainfrom
tembo/research-agent-frameworks
May 19, 2026
Merged

Support Pydantic AI and Cargo AI agent formats#5
ryw merged 1 commit into
mainfrom
tembo/research-agent-frameworks

Conversation

@ryw
Copy link
Copy Markdown
Member

@ryw ryw commented May 19, 2026

  • Added detailed agent format decision document context/0.1/AGENT_FORMAT.md explaining why Pydantic AI AgentSpec is primary and Cargo AI JSON is supported.
  • Updated onboarding script to create a Pydantic AI AgentSpec YAML starter agent and updated agents README to explain supported formats.
  • Added a sample Pydantic AI AgentSpec YAML agent agents/hello-world.yaml.
  • Updated documentation in multiple places (context/0.1/README.md, context/0.1/USER_STORIES.md, context/0.1/DEMO_SCRIPT.md) to reflect support for both Pydantic AI AgentSpec and Cargo AI JSON formats.
  • Clarified that v0.1 supports these two declarative, diff-native, single-file agent formats, with Pydantic AI AgentSpec as the canonical format and Cargo AI JSON as an import path.
  • Explained rationale for not supporting code-first frameworks like Mastra in v0.1 in the format decision document.
  • Ensured all changes emphasize that users do not need to learn these formats in v0.1, as they are implementation details, with chat-to-PR authoring coming in v0.2.

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

View on Tembo View Agent Settings

…pport

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 ryw merged commit 818ef1b into main 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>
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