feat: add Agno AgentOS chat example

[vishxrad]

What

Adds a runnable Agno AgentOS example on top of the @openuidev/agno package from the first PR in this stack.

This is PR 2 of 2. It depends on #1063 and should be reviewed after that package PR.

Closes #1061.

Changes

• add examples/agent-frameworks/agno using the default AgentInterface shell and the repository's shared example verification contract
• include a deterministic AgentOS-compatible harness for tools, multi-delta streaming, charts, follow-ups, validated forms, pause/resume, session CRUD, and reloads
• include a normal Python AgentOS backend for live model testing
• keep normal visual answers as fenced assistant text: AgentOS stores readable Markdown source while @openuidev/agno unwraps and progressively renders the same stream
• use Agno prompt_openui only for blocking input or approval; the generated UI uses @ToAssistant, which resumes the exact paused run and session as a tool result
• select OpenUI instructions with a transient openui_client context entry while native AgentOS chat remains text/Markdown and does not call the UI tool
• add a generic getThreadMenuActions API to Agent Interface
• maintain a 1:1 OpenUI threadId to AgentOS session_id mapping and add an Open in AgentOS action for the same persisted session
• make the AgentOS web-interface handoff configurable with VITE_AGENT_OS_SESSION_URL_TEMPLATE, defaulting to the hosted session route
• document why Vite proxies local AgentOS and how production can use a same-origin endpoint or reverse proxy

Test Plan

• Verified locally

Commands run after rebasing both stacked branches onto the current main:

pnpm install --frozen-lockfile --ignore-scripts
pnpm --filter @openuidev/example-agno run verify
pnpm --filter @openuidev/agno run ci
pnpm --filter @openuidev/react-ui run typecheck
pnpm --filter @openuidev/react-ui run ci
pnpm --filter @openuidev/react-ui run build
python3 -m py_compile examples/agent-frameworks/agno/server.py
pnpm --filter @openuidev/docs run types:check

Results: the Agno package passed 17 tests, lint, formatting, and typecheck. React UI passed typecheck, 39 tests, lint, formatting, build, and CSS artifact checks. The example passed its credential-free typecheck and production build. Python compilation and Docs MDX/type generation passed. The Vite build reports expected dependency use client and chunk-size warnings.

Browser validation used both the deterministic harness and a live AgentOS with a real model credential supplied outside the repository. It covered a streamed chart and follow-up, required-field validation, a prompt_openui submission that resumed the same run and session, acknowledgement after resume, reload persistence, native AgentOS Markdown output, and the materialized AgentOS session-detail link.

Current AgentOS sends the completed prompt_openui arguments as one event, so the blocking form appears when that tool call closes. The assistant response after resume streams normally.

No API key, generated system prompt, database, virtual environment, build output, screenshot, or local runtime artifact is included.

Checklist

• I linked a related issue, if applicable
• I updated docs/README when needed
• I considered backwards compatibility

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
openui-docs	Ready	Preview	Aug 25, 2026 6:39pm