Track the latest changes, improvements, and bug fixes. The canonical per-package changelogs live in the repo:Documentation Index
Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt
Use this file to discover all available pages before exploring further.
idun-agent-engine, idun-agent-standalone.
The release where Idun Engine becomes the third path between LangGraph Cloud and DIY. One
pip install ships your LangGraph or Google ADK agent as a production-ready FastAPI service with a bundled Next.js chat / admin / traces UI, 15+ guardrails, multi-provider observability via OpenTelemetry, MCP tool governance, 5 memory backends, and OIDC. Self-hosted, open source, no vendor lock-in.Read the launch post →Highlights
- One wheel, three services collapsed.
pip install idun-agent-enginebundles the Next.js admin / chat / traces UI and theidunCLI. The separateidun-agent-manager(FastAPI) andidun-agent-web(React) services are gone — ~151,000 lines removed in one cut so the install path ispip+idun setup+idun serve, nothing else. - Standards composed, not invented. AG-UI streaming (CopilotKit-compatible), OpenTelemetry tracing across 5 providers, MCP tool servers (Linux Foundation governance since 2025), OIDC auth (Google + Microsoft). Pick Idun and your investment moves with you.
- Traces v1 lands. Trace store (asyncpg COPY), REST endpoints, list + detail UI with span tree and waterfall views. ADK spans projected to OpenInference attributes so they flow through the same pipeline as LangGraph spans.
- Brand + docs rebrand. “Idun Platform” → Idun Engine across the public surface. Docs moved to docs.idun-group.com with a paper/ink editorial design that matches the website.
Added
- Standalone trace store: schema, asyncpg writer, REST endpoints, list + detail UI.
- ADK adapter spans projected onto OpenInference attributes so they flow through the same trace pipeline as LangGraph spans.
GoogleGenAIInstrumentorauto-attached for Gemini cache-bucket capture.BaseAgent.register_run_event_observer(observer): async callbacks receive every AG-UI event from/agent/runbefore SSE encoding./healthnow reflects engine assembly state, returningagent_ready: boolandstatus: "degraded"when configured agents failed to come online.IDUN_UI_DIRenv var: mount a custom static UI at/; previous JSON info payload moves to/_engine/info.create_app(..., reload_auth=...): pluggable FastAPI dependency for thePOST /reloadendpoint.- Admin dashboard counters now sourced from the trace store (session count, run count, recent activity timeline).
- Standalone seeder persists all top-level YAML config blocks (agent, guardrails, mcp, prompts, integrations, observability) on first boot.
- Admin link surfaced on chat layouts; new Developer sidebar group links to
/docsand/redoc. - PostHog tracking + masked session replay (opt-in) in the chat UI.
- LangGraph auto-detection scanner: detects agents built via known factories and
CompiledStateGraphannotations, so thegraph_definitionconfig can be inferred rather than hand-written. /adminactivity dashboard: traces-driven KPIs across 24h / 7d / 30d, requests-per-minute sparkline, p50 / p95 latency dual-line chart, top-errors table.get_langchain_tools_sync()for module-load callers: makes MCP tools available in synchronous import-time contexts (e.g.create_deep_agentfactories) that can’tawait.- Microsoft OIDC alongside Google for SSO. Multi-provider auth, multi-tenant support.
- Google Chat integration joins WhatsApp, Discord, Slack, and Microsoft Teams.
- SSE / HTTP transport for ADK MCP toolsets, alongside the existing stdio.
- Real-LLM end-to-end test suite (
pytest-e2e): LangGraph + ADK adapter coverage with real LLM calls in CI, plus Playwright specs for chat and admin reload flows. - Coding-guidelines drift advisory CI: rules-as-YAML pipeline, headless-Claude review check.
Changed
- The engine wheel bundles standalone + schema.
pip install idun-agent-engineships theidunconsole script (mapped toidun_agent_standalone.cli:main), the chat/admin/traces Next.js bundle, alembic migrations, andidun-agent-schemaas a runtime dependency. guardrails-aiis now an optional extra ([guardrails]). Install withpip install idun-agent-engine[guardrails]if you use the Guardrails-AI integration.- Standalone admin DB rework. Run
idun setupafter upgrade to apply the new migrations. - Secure-by-default host binding.
idun serveno longer binds0.0.0.0by default; bind-all requires explicit opt-in. - Standalone “admin-only mode” fails loud instead of logging a single WARNING and serving 503s silently.
- Catch-all 404 for
/admin/api/v1/<unmapped>returns JSON 404 instead of falling through to the chat UI HTML. - Rebrand: “Idun Platform” → “Idun Engine” across
docs.json, OG metadata, navbar, search prompt, and the docs naming guidelines. The GitHub repo name (idun-agent-platform) is unchanged. - Docs moved from MkDocs to Mintlify at
docs.idun-group.com. New paper / ink editorial design matches the website’s Engine product page. ObservabilityConfigschema restructured. The discriminated union now stamps aproviderliteral onto each inner provider config; legacy YAML keeps working because validators auto-sync the parent and inner fields.AdkAgentConfig.app_namenow optional. When omitted, it auto-derives fromname(lowercase + non-alphanumeric → underscore). Non-breaking; explicit values still win.- BREAKING:
RestrictToTopicConfig.topicsis split intovalid_topicsandinvalid_topics. v0.5.x configs usingtopics:will fail validation; rename the key in your YAML.
Deprecated
/agent/invokeis markeddeprecated=Truein OpenAPI. Migrate toPOST /agent/run(AG-UI SSE stream). Removal targeted for 0.7.
Removed
services/idun_agent_manager/+services/idun_agent_web/— the FastAPI manager service and React admin UI. ~90,219 lines across 367 files. Replaced by the bundled Next.js admin / chat / traces UI atservices/idun_agent_standalone_ui/, served by the engine wheel.- TUI (
idun initTextual UI) and the Streamlit demo. 4,093 lines across 26 files. Replaced by the setup wizard inside the bundled Next.js admin at/admin. - MkDocs site (
old-docs/,mkdocs.yml). 11,638 lines across 160 files. Replaced by Mintlify atdocs.idun-group.com. - Haystack agent adapter,
HaystackAgentConfigschema,langfuse-haystackruntime dependency, and all related tests, docs, and UI surfaces. Migrate Haystack agents to LangGraph or ADK before upgrading. - Total: ~151,820 lines deleted in one commit (
9a54145d, “finalize standalone migration”); 712 file deletions; net reduction of 150,883 lines.
Fixed
- MCP tool calls wrapped so AG-UI can serialize event payloads end-to-end.
- Guardrail install failures surface to the reload pipeline instead of silently degrading the running agent.
- Trace pipeline no longer drops trace rows when the runtime OTel context leaks a parent.
- Prompts resolve from the
EngineConfigsnapshot in standalone, mirroring the MCP registry pattern. - Tool calls in the chat UI render their args and result instead of the literal string
"null". - Chat history sidebar auto-refreshes after a run and sorts newest first.
Security
- Third-party GitHub Actions pinned to SHAs; dep-audit job;
SECURITY.mdhardened. - Socket security gates wired into PRs and both publish workflows.
- Next.js and aiohttp CVE patches;
pinactpre-commit hook. guardrails-aimoved out of the default install footprint.
Standards composed
Idun Engine composes open standards rather than inventing new protocols. Your investment in any of these moves with you if you ever leave:- LangGraph and Google ADK — agent frameworks
- AG-UI — streaming protocol, compatible with any CopilotKit client
- OpenTelemetry — tracing, exported to Langfuse, Phoenix, LangSmith, or GCP Trace
- MCP — tool servers, under Linux Foundation governance since 2025
- OIDC — auth (Google, Microsoft, any compliant provider)
- FastAPI, Pydantic — HTTP layer and config models
Upgrading from 0.5.x
- Uninstall any separate
idun-agent-standalonewheel, since it is now bundled in the engine wheel. - Install with
pip install idun-agent-engine[guardrails]==0.6.0if you use Guardrails-AI; otherwise plainpip install idun-agent-engine==0.6.0. - Migrate Haystack agent configs to LangGraph or ADK.
- Update
RestrictToTopicConfigYAML: renametopics:to eithervalid_topics:orinvalid_topics:(or both). The old key is no longer accepted by the schema. - Switch smoke checks from
curl /healthtoPOST /agent/run(the deprecated/agent/invokestill works but will be removed in 0.7). - Run
idun setupafter upgrade so the new standalone admin DB migrations apply. - If you wrote scripts against
docs.idunplatform.com, point them atdocs.idun-group.com(the old domain redirects until further notice).
- Mintlify docs migration and UI rework
- Guardrails hub URL fixes
- LangSmith run name support for LangGraph and ADK agents
- Check connection for observability and memory providers
- MCP discover tools timeout
- ADK database session service support
- Observability V2 configuration schema
- Multi-provider observability support
- Prompt management system
- MCP servers
- Initial public release
- LangGraph and ADK framework support
- Guardrails AI integration
- Langfuse and Phoenix observability
- SQLite and PostgreSQL checkpointing
- Discord, Slack, and WhatsApp integrations
- SSO/OIDC authentication
- Docker Compose deployment