Repository navigation
v2.0.0
akgentic-framework v2.0.0
A major release. The headline change is Catalog v2 — a ground-up redesign of akgentic-catalog. All other packages (core, llm, tool, agent, team, infra, frontend) are synced to their latest master.
Catalog v2 (breaking)
akgentic-catalog has been rebuilt around a single, unified model:
- Unified
CatalogAPI — the old per-type services (agent_catalog,team_catalog,template_catalog,tool_catalog) and per-type repositories are replaced by oneCatalogclass and a singleEntrymodel covering every catalog kind. - Namespace-oriented layout — catalog content is organised into namespaces (
global,agent-team,digital-product-team, …), each with its own_meta.yaml, agents, models, tools, prompts and team definitions. A newnamespace_metamodel and namespace bundle import/export replace the flatagents/teams/tools/templates/directories. - New resolver —
resolver.pyresolves cross-namespace references, sibling overrides and typed splices into fully materialised cards. - New serialization & validation layers — dedicated
serialization.pyandvalidation.pymodules; namespace-level validation with structured validation reports. - Single unified API router — the four separate
*_router.pymodules collapse into onerouter.pywith consistent body-format handling. - Postgres backend rework — per-type repos replaced by one
repository.pywith a query translator; Mongo backend likewise consolidated into a single entry repository. (The previous Nagra-specific Postgres repos are removed.) - CLI rebuilt — per-type CLI commands replaced by a unified CLI with bundle, validate and graph/schema support.
Other changes
- Frontend — new namespace panel (route, guard, validation report) for browsing and editing catalog namespaces; chat, home, auth and API/fetch services updated to the v2 catalog API.
- infra — admin catalog routes updated for the unified catalog; mutation-log and auth-dependency helpers added; team workspace cleanup on delete.
- team — welcome announcement / welcome-message support added.
- core —
AgentCardandActorSystemrefinements. - CI / release — release workflow can now be dispatched from any branch (not just
master); per-package CI workflows updated.
Migration note: Catalog v1 data and code are not compatible with v2. v1 examples are preserved under
examples-v1-archived/and v1 fixtures undertests/fixtures/*-v1/for reference.
Full Changelog: v1.2.3...v2.0.0