DocumentationArticlesSupportersYouTubeGitHub

Changelog

Explore code, SDKs, blogs, and use cases for developing multi-agent systems. Learn how AGNTCY enables open, interoperable AI infrastructure at scale.

release   ·   dir   ·   v1.6.1   ·   2026-07-22
v1.6.1
# 🚀 AGNTCY Dir v1.6.1 Release
This release focuses on a new client/server auth mode, routing operability, import reliability for extractor enrichment, and database stability.
🌟 Key highlights
- **JWT-TLS authentication**: New jwt-tls auth mode combines standard web-PKI TLS transport with SPIFFE JWT-SVID bearer credentials, for deployments that need public CA–verified TLS plus identity-based RPC auth.
- **Configurable routing republish**: routing.republish_interval lets operators tune how often local CID provider announcements are refreshed (default remains 36h).
- **Import/extractor fixes**: Extractor-enriched imports now stamp the correct OASF schema_version, and in-process CLI reuse no longer leaks schema version between imports.
Fixed
- **Import**: Align extractor-enriched records with the extractor’s latest OASF schema version (#1862)
- **Import**: Reset SchemaVersion on each loadConfig call to avoid cross-import leakage in long-lived/in-process CLI sessions (#1863)
- **Database**: Configure SQL connection pool idle limits for SQLite and PostgreSQL (#1850)
• *Full Changelog: [v1.6.0...v1.6.1](https://github.com/agntcy/dir/compare/v1.6.0...v1.6.1)**
🤝 Community & Support
- [Repository](https://github.com/agntcy/dir)
- [Discussions](https://github.com/agntcy/dir/discussions)
- [Documentation](https://dir.agntcy.org/)
- [Quick Start](https://dir.agntcy.org/latest/dir/dir-quickstart/)
🙏 Acknowledgments
Thank you to all contributors who made this release possible! Special thanks to the community for
feedback, bug reports, and feature requests that helped shape this release.
<details>
<summary>
What's Changed
</summary>
• release(dir): prepare server release v1.6.1 by @csirmazbendeguz in #1859
• release(dir): prepare api release v1.6.1 by @csirmazbendeguz in #1860
• fix(import): reset SchemaVersion per loadConfig to avoid in-process leak by @ajaky in #1863
• fix(import): align extractor-enriched record schema version with OASF latest by @ajaky in #1862
• feat(dir): add JWT-TLS auth mode by @csirmazbendeguz in #1857
• feat(routing): configurable republish interval with default by @tkircsi in #1858
• docs(dir): document NL search, a2a-scanner, and extractor enrichment by @paralta in #1851
• chore(deps): update module golang.org/x/crypto to v0.54.0 by @agntcy-automation[bot] in #1830
• test(e2e): add extractor enricher coverage for dirctl import by @ajaky in #1849
• fix(dir): increase db connection pool by @csirmazbendeguz in #1850
• docs: contributor list updates by @ajaky, @lgecse in #1842–#1847
</details>
Version: v1.6.1
Date: 2026-07-22
Status: Released
Breaking: Yes
Components: Core
Authors: @csirmazbendeguz, @ajaky, @tkircsi, @paralta, @agntcy, @lgecse
PRs:4aeb58c
Docs
Release PR
release   ·   dir   ·   v1.6.0   ·   2026-07-22
v1.6.0
# 🚀 AGNTCY Dir v1.6.0 Release
This release brings **automated security scanning** for MCP servers, Agent Skills, and A2A cards, **natural-language search** across the Directory and DHT routing layer, and **DHT autosync** for federated discovery. It also introduces **`dirctl init`** and **`dirctl install`** for onboarding agents with the Directory Agent Skill and MCP server, expands OCI referrer and ingestion APIs, and ships real usage metrics in the AI Catalog.
🌟 Key Features
- **Security Scanning**: Automated scanning with MCP, skill, and A2A scanners; `ScanReport` proto and referrer persistence; scan search filters and pull support; security results surfaced in the AI Finder UI; bundled Cisco scanners in the reconciler image with Azure OpenAI key binding
- **Natural-Language Search**: NL query support in `dirctl search`, `SearchService`, and `dirctl routing search`; OASF extractor provisioning in `dirctl init`; record usage metrics and popularity sort modes
- **DHT Autosync**: Autosync manager, trigger, worker, and `routing.autosync` configuration for federated DHT sync; NAT hardening for reliable peer connectivity
- **OCI Referrers & Ingestion**: `ListReferrers` and `PullReferrer` RPCs; shared `Ingestor` ingestion service; OCI address in discovery responses; skill bundle support and extraction on batch export
- **Agent Onboarding (`dirctl init` / `dirctl install`)**: Install the Directory Agent Skill and MCP server; seed a default local context; batch install; MCP export formats for Claude Code and Cursor; integration-aware DIR agent skill workflow
- **AI Catalog & Metrics**: Real usage metrics replacing placeholder stats; metrics reconciler task wired in Helm
Full Changelog: https://github.com/agntcy/dir/compare/v1.5.0...v1.6.0
🤝 Community & Support
- [Repository](https://github.com/agntcy/dir)
- [Discussions](https://github.com/agntcy/dir/discussions)
- [Documentation](https://dir.agntcy.org/)
- [Quick Start](https://dir.agntcy.org/latest/dir/dir-quickstart/)
🙏 Acknowledgments
Thank you to all contributors who made this release possible! Special thanks to the community for
feedback, bug reports, and feature requests that helped shape this release.
<details>
<summary>
What's Changed
</summary>
• chore(dir): update changelog by @csirmazbendeguz in #1672•
• chore(docs): patch docs and sample apps by @ramizpolic in #1667•
• chore(dirctl): update brew formula to v1.5.0 by @build-agntcy in #1674•
• fix(helm): roll apiserver pods when ConfigMap changes by @akijakya in #1675•
• docs(dir): add build-time doc versioning and refresh concept guides by @paralta in #1676•
• docs(dir): restructure usage guides into lean walkthroughs by @paralta in #1677•
• fix(dirctl): remove env var patch for v1.4 brew in v1.5 by @arpad-csepi in #1679•
• docs(dir): reorganize concepts and deploy navigation by @paralta in #1680•
• chore(deps): update module github.com/containerd/containerd/v2 to v2.3.2 [security] by @agntcy-automation[bot] in #1682•
• chore(deps): update module github.com/containerd/containerd to v1.7.33 [security] by @agntcy-automation[bot] in #1681•
• chore(deps): update module github.com/spiffe/go-spiffe/v2 to v2.8.1 by @agntcy-automation[bot] in #1687•
• chore(deps): update module k8s.io/apimachinery to v0.36.2 by @agntcy-automation[bot] in #1686•
• chore(deps): update postgresql by @agntcy-automation[bot] in #1683•
• chore(deps): update module golang.org/x/crypto to v0.53.0 by @agntcy-automation[bot] in #1688•
• chore(deps): update module golang.org/x/mod to v0.37.0 by @agntcy-automation[bot] in #1689•
• ci(license): skip license cache warm-up when cache is already hit by @paralta in #1709•
• fix(client): populate Signature field correctly for key-based signatures by @paralta in #1710•
• chore(deps): update module github.com/regclient/regclient to v0.11.5 [security] by @agntcy-automation[bot] in #1711•
• feat(search): track record usage metrics and add popularity sort modes by @paralta in #1708•
• feat(cli): add --config flag to dirctl import and simplify pipeline setup by @paralta in #1715•
• chore(docs): updating copyright message by @keraron in #1717•
• chore(deps): update github actions by @agntcy-automation[bot] in #1684•
• chore(deps): update module github.com/sigstore/cosign/v3 to v3.1.1 by @agntcy-automation[bot] in #1718•
• chore(deps): update zot by @agntcy-automation[bot] in #1714•
• chore(deps): update go patches by @agntcy-automation[bot] in #1685•
• chore(deps): update google.golang.org/genproto/googleapis/api digest to b703f56 by @agntcy-automation[bot] in #1629•
• feat(cli): move raw OASF retrieval to `dirctl pull`; drop `--format=oasf` from export by @akijakya in #1707•
• chore(dir): rename Agent Skill media type by @csirmazbendeguz in #1721•
• chore(dir): update dependencies by @csirmazbendeguz in #1722•
• chore(docs): adding 404 page by @keraron in #1736•
• feat(dir): add skill bundles by @csirmazbendeguz in #1706•
• feat(utils): add shared scanner package with MCP runner and RunAll orchestrator by @paralta in #1738•
• feat(dir): extract skill bundles on batch export by @csirmazbendeguz in #1741•
• feat(cli): dirctl install by @akijakya in #1745•
• feat(utils/scanner): add SkillRunner to scan agent skill bundles by @paralta in #1746•
• feat(proto,api,client): define ScanReport proto and add referrer persistence by @paralta in #1744•
• refactor(ci): update renovate bot config by @arpad-csepi in #1748•
• feat(security): add automated security scanning, scan search filters, and pull support by @paralta in #1757•
• chore(deps): update module google.golang.org/grpc to v1.82.0 by @agntcy-automation[bot] in #1755•
• chore(deps): update module github.com/libp2p/go-libp2p-kad-dht to v0.41.0 by @agntcy-automation[bot] in #1754•
• docs(cli): dirctl init, dirctl install missing docs by @akijakya in #1758•
• feat(cli): provision the OASF extractor assets in dirctl init by @akijakya in #1756•
• chore(docs): adding discord link by @keraron in #1761•
• chore(dir, sdk): split and update sdk documentations by @arpad-csepi in #1759•
• chore(deps): update postgresql by @agntcy-automation[bot] in #1713•
• feat(gateway): surface security scan results in the AI Finder UI by @paralta in #1760•
• feat(cli): seed a default local context in dirctl init by @akijakya in #1764•
• feat(dir): add mcp-claudecode export format by @conorbronsdon in #1766•
• chore(ci): disable daemon external test by @ramizpolic in #1778•
• feat(dir): add mcp-cursor export format by @conorbronsdon in #1767•
• feat(search): add natural-language query support to dirctl search and SearchService by @paralta in #1770•
• feat(dir): batch install by @csirmazbendeguz in #1763•
• feat(reconciler): bundle scanners in image and document scan task setup by @paralta in #1773•
• chore(docs): community section in the main page by @keraron in #1782•
• chore(dir): update buf.lock by @arpad-csepi in #1784•
• fix(dir): update oasf test skill values by @arpad-csepi in #1785•
• feat(routing): add natural-language search to dirctl routing search by @paralta in #1783•
• chore(deps): update module oras.land/oras-go/v2 to v2.6.2 [security] by @agntcy-automation[bot] in #1786•
• feat(routing): add routing.autosync config block by @tkircsi in #1797•
• feat(server): extract shared ingestion service (Ingestor) by @tkircsi in #1798•
• feat(server): inject shared Ingestor + autosync config into routing by @tkircsi in #1800•
• feat(dir): add listreferrers, pullreferrer rpc by @csirmazbendeguz in #1799•
• chore(deps): update github actions by @agntcy-automation[bot] in #1753•
• chore(deps): update go patches by @agntcy-automation[bot] in #1751•
• chore(cli): bump dir-importer to pick up OASF 1.1.0 schema version by @paralta in #1801•
• feat(dir): add a2a-scanner support by @conorbronsdon in #1776•
• ci(codeql): use official taskfile action by @arpad-csepi in #1772•
• chore(deps): update helm release zot to v0.1.121 by @agntcy-automation[bot] in #1752•
• chore(deps): update module github.com/pelletier/go-toml/v2 to v2.4.3 by @agntcy-automation[bot] in #1768•
• chore(deps): update module github.com/rs/zerolog to v1.35.1 by @agntcy-automation[bot] in #1769•
• feat(routing): add DHT autosync manager, trigger & worker by @tkircsi in #1802•
• chore(dir): bump go version to v1.26.5 by @csirmazbendeguz in #1805•
• fix(build): correct golang:1.26.5 image digest in Dockerfiles by @paralta in #1809•
• fix(database): fix GetRecordCIDs failing with PostgreSQL backend by @paralta in #1807•
• feat(cli): `dirctl init` to install directory Agent Skill and MCP server by @akijakya in #1787•
• release(dir): prepare api release v1.6.0 by @csirmazbendeguz in #1804•
• fix(reconciler): create nonroot home directory in container images by @paralta in #1810•
• feat(cli/importer): bump dir importer and upgrade to OASF 1.1.0 by @paralta in #1806•
• feat(workflows): add integration-aware DIR agent skill by @ramizpolic in #1700•
• fix(tests): revert OASF schema version from 1.1.0 back to 1.0.0 by @paralta in #1815•
• fix(reconciler): add git to Dockerfile by @csirmazbendeguz in #1816•
• feat(catalog): replace placeholder stats with real usage metrics by @paralta in #1812•
• feat(search): add --schema-version flag to NL search for OASF version scoping by @paralta in #1813•
• chore(docs): updating community section by @keraron in #1817•
• feat(install): wire up metrics reconciler task in Helm chart by @paralta in #1819•
• feat(routing): nat hardening for autosync by @tkircsi in #1808•
• chore(dir): bump dir-import, dir-mcp, dir-runtime by @csirmazbendeguz in #1821•
• feat(dir): provide oci address in discovery response by @tkircsi in #1820•
• feat(reconciler): bind Azure OpenAI keys by @tkircsi in #1823•
• chore(docs): update Discord invite link by @muscariello in #1825•
• chore(docs): fix front-page Discord widget link by @muscariello in #1826•
• chore(reconciler): pin cisco scanner package versions by @paralta in #1833•
• fix(skill): patch sync flow in agent skill by @ramizpolic in #1834•
• fix(dir): downgrade mcp-scanner, skill-scanner by @csirmazbendeguz in #1836•
• chore(dir): upgrade grpc-health-probe to v0.4.53 by @csirmazbendeguz in #1837•
• fix(dir): bump scanner versions by @csirmazbendeguz in #1840•
• fix(reconciler): normalize remote directory URL into gRPC dial target by @tkircsi in #1839•
• chore(docs): update contributors list by @muscariello in #1835•
• release(dir): prepare server release 1.6.0 by @csirmazbendeguz in #1822•
</details>
Version: v1.6.0
Date: 2026-07-22
Status: Released
Breaking: Yes
Components: Core
Authors: @csirmazbendeguz, @ramizpolic, @build, @akijakya, @paralta, @arpad, @agntcy, @keraron, @conorbronsdon, @tkircsi, @muscariello
PRs:2c2efb9
Compare: Previous version
Docs
Release PR
Compare
release   ·   slim   ·   slimctl-v2.0.0-alpha.7   ·   2026-07-20
slimctl-v2.0.0-alpha.7
# Added
- *(session)* add close and rejoin functions ([#1873](https://github.com/agntcy/slim/pull/1873))
Version: slimctl-v2.0.0-alpha.7
Date: 2026-07-20
Status: Released
Breaking: Yes
Components: Core
Authors:
PRs:ab42a5b
Docs
Release PR
release   ·   slim   ·   slim-v2.0.0-alpha.7   ·   2026-07-20
slim-v2.0.0-alpha.7
# Other
- updated the following local packages: agntcy-slim-config, agntcy-slim-tracing, agntcy-slim-service
Version: slim-v2.0.0-alpha.7
Date: 2026-07-20
Status: Released
Breaking: Yes
Components: Core
Authors:
PRs:ab42a5b
Docs
Release PR
release   ·   slim   ·   slim-version-v2.0.0-alpha.7   ·   2026-07-20
slim-version-v2.0.0-alpha.7
# Added
- add agntcy-slim-version crate as single source of truth for version and build info ([#1360](https://github.com/agntcy/slim/pull/1360))
Version: slim-version-v2.0.0-alpha.7
Date: 2026-07-20
Status: Released
Breaking: Yes
Components: Core
Authors:
PRs:ab42a5b
Docs
Release PR
release   ·   slim   ·   slimctl-v2.0.0-alpha.6   ·   2026-07-20
slimctl-v2.0.0-alpha.6
# Other
- updated the following local packages: agntcy-slim-config, agntcy-slim-proto, agntcy-slim-tracing, agntcy-slim-datapath, agntcy-slim-session, agntcy-slim-service, agntcy-slim
Version: slimctl-v2.0.0-alpha.6
Date: 2026-07-20
Status: Released
Breaking: Yes
Components: Core
Authors:
PRs:837bc07
Docs
Release PR
release   ·   slim   ·   slim-version-v2.0.0-alpha.6   ·   2026-07-20
slim-version-v2.0.0-alpha.6
# Added
- add agntcy-slim-version crate as single source of truth for version and build info ([#1360](https://github.com/agntcy/slim/pull/1360))
Version: slim-version-v2.0.0-alpha.6
Date: 2026-07-20
Status: Released
Breaking: Yes
Components: Core
Authors:
PRs:837bc07
Docs
Release PR
release   ·   oasf-sdk   ·   v1.1.0   ·   2026-07-14
v1.1.0
What's Changed
• test: improve test suites by @akijakya in #159
• feat: `module.artifact` translator support by @akijakya in #160
• ci: add tooling by @akijakya in #161
• refactor(ci): add release age to renovatebot by @arpad-csepi in #162
• feat(translator): translate OASF records to AI Catalog entries by @paralta in #163
• fix(translator): use camelCase in nested entries by @akijakya in #165
• feat(server): serve RecordToCatalog over the translation gRPC endpoint by @paralta in #164
• fix: ensure authors version skill translator by @akijakya in #167
• fix: strip YAML quotes from SKILL.md metadata values by @akijakya in #168
• feat(oasf-sdk): add agent skills bundles by @csirmazbendeguz in #169
• feat(extractor): provision-based OASF taxonomy extractor + gRPC proto by @akijakya in #173
• feat(server): add extractor gRPC controller (auto-provisioning) by @akijakya in #174
• feat(server): add grpc health service and gate e2e on real readiness by @conorbronsdon in #176
• feat(extractor): support OASF 1.1.0 in curated module versions by @akijakya in #177
• release: update module set to version v1.1.0 by @csirmazbendeguz in #178
New Contributors
• @csirmazbendeguz made their first contribution in #169
• @conorbronsdon made their first contribution in #176
Full Changelog: https://github.com/agntcy/oasf-sdk/compare/v1.0.5...v1.1.0
Version: v1.1.0
Date: 2026-07-14
Status: Released
Breaking: Yes
Components: Core
Authors: @akijakya, @arpad, @paralta, @csirmazbendeguz, @conorbronsdon
PRs:e0c46da
Compare: Previous version
Docs
Release PR
Compare
release   ·   oasf   ·   v1.1.0   ·   2026-07-10
v1.1.0
New Features
- **Granular skills and domains** – Expanded the taxonomy with a far more detailed set of skills and domains, giving agent records richer, more precise classification (#475)
- **Improved category support** – Reworked category handling in the server, with categories endpoints now returning nested class taxonomies for easier discovery and navigation (#412, #414)
- **Class API improvements** – Overhauled the class APIs and cleaned up the overall API surface and Swagger UI for a more consistent developer experience (#426, #428)
- **Version-aware API and Swagger UI** – Improved the version API and made the Swagger UI version-aware so consumers can explore the schema per version (#430, #416)
- **Descriptor object and module artifact** – Added a `descriptor` object and a `module.artifact` attribute to the schema (#458)
- **JSON schema constraints** – Extended the JSON schema generator to emit `maxLength` and `pattern` constraints (#464)
- **Helm log level and ingress options** – Added configurable log level settings and support for the F5 ingress controller in the Helm chart (#446, #454)
Changed
- **Relaxed Agent Skills requirements** – Loosened the attribute requirements of the `agentskills` module for more flexible authoring (#450)
- **Deprecated ACP objects** – Deprecated ACP-related objects and dictionary entries in the schema and server (#445)
- **Language model module refactoring** – Refactored the language model modules for a cleaner structure (#396)
- **Server cleanup** – Reduced code duplication across the server and removed the unused ingress-export (#473, #455)
Fixed
Corrections across the server, schema, API, and Helm chart, including validation fixes, constraint backfill with correct field shapes, `class_type` taxonomy scope enforcement, subclass sorting, feature extraction skill captions, a versioned link to the A2A AgentCard proto spec, body param schemas for validation/translation endpoints, unknown version path routing, and a UUID example typo. (#463, #460, #477, #432, #441, #410, #433, #443, #434)
Documentation & Infrastructure
Added a `RELEASE.md` guide, repo badges, and Codecov coverage upload; introduced a PR title check, Renovate, and pre-commit configuration; migrated the server test suite to Elixir; simplified and hardened image builds with multi-arch support; and added documented CVE exceptions to `.trivyignore`. (#436, #404, #402, #394, #469, #466, #448, #452, #453, #482, #470, #403, #405)
Contributors
Thanks to everyone who contributed to this release: @akijakya, @muscariello, and @pregnor.
New Contributors
- @pregnor made their first contribution in #434
Full Changelog: https://github.com/agntcy/oasf/compare/v1.0.0...v1.1.0
Version: v1.1.0
Date: 2026-07-10
Status: Released
Breaking: Yes
Components: Core
Authors: @akijakya, @muscariello, @pregnor
PRs:f510be0
Compare: Previous version
Docs
Release PR
Compare
release   ·   coffeeAgntcy   ·   0.2.1   ·   2026-07-01
0.2.1
0.2.1 (2026-07-01)
Patch release: **Helm hardening for agentic-workflows-api and lungo-ui**, **Grafana observability deep-links** across chat patterns, and a **Colombia payment MCP** client fix.
# Summary
• *Breaking / migration (read first)**
<details>
<summary><strong>Agentic Workflows API Helm</strong> — <code>agentic-workflows-api@0.1.4</code>, ExternalSecret, Azure + LLM config</summary>
- Adds optional **ExternalSecret** wiring and **`secretRef`** env injection when **`externalSecrets`** is set ([#675](https://github.com/agntcy/coffeeAgntcy/pull/675)).
- ConfigMap now exposes **`AZURE_API_BASE`**, **`AZURE_API_VERSION`**, and **`LLM_MODEL`** for pattern chat / Azure-backed models ([#676](https://github.com/agntcy/coffeeAgntcy/pull/676), [#677](https://github.com/agntcy/coffeeAgntcy/pull/677)).
- Chart **`agentic-workflows-api`** **0.1.1 → 0.1.4** across those fixes.
- Set in **`deployment/helm/agentic-workflows-api/values.yaml`** (or umbrella overrides):
config:
azureApiBase: "<your-azure-openai-endpoint>"
azureApiVersion: "2024-02-15-preview"
llmModel: "<deployment-name>"
corsAllowedOrigins: "<allowed-origins>"
- For cluster secret stores, configure **`externalSecrets`** (see other Lungo subcharts / **`local-cluster/config-overrides.yaml.gotmpl`** for examples).
</details>
<details>
<summary><strong>Lungo UI Helm</strong> — <code>lungo-ui@0.1.5</code>, <code>envFrom</code> template fix</summary>
- Fixes **`lungo-ui`** deployment template so **`envFrom`** is always declared before optional **`secretRef`** entries ([#686](https://github.com/agntcy/coffeeAgntcy/pull/686)).
- Chart **`lungo-ui`** **0.1.4 → 0.1.5**.
- Run **`helm dependency update`** under **`deployment/helm/local-cluster`** (or your umbrella) before upgrading.
</details>
• *Migration steps**
1. **Helm / KinD:** bump subcharts to **`agentic-workflows-api@0.1.4`** and **`lungo-ui@0.1.5`**, then upgrade the release.
2. **Pattern chat on Azure:** set **`config.azureApiBase`**, **`config.azureApiVersion`**, and **`config.llmModel`** in agentic-workflows-api values (or equivalent ConfigMap overrides).
3. **Production secrets:** enable **`externalSecrets`** on **`agentic-workflows-api`** (and **`lungo-ui`** if needed) instead of relying on inline chart secrets.
4. **Docker Compose:** rebuild agents/UI if you run Colombia farm workflows — payment MCP client creation changed ([#678](https://github.com/agntcy/coffeeAgntcy/pull/678)).
• *Highlights**
<details>
<summary><strong>Grafana session deep-links</strong> — correct OTEL session/trace IDs in all chat feeds</summary>
- New **`GrafanaSessionLink`** component and **`useObservabilitySessionId`** hook resolve the right session/trace id across auction, group, recruiter, and standard agent responses ([#683](https://github.com/agntcy/coffeeAgntcy/pull/683), closes [#671](https://github.com/agntcy/coffeeAgntcy/issues/671)).
- Recruiter supervisor emits trace metadata for streaming Grafana links; **`ChatArea`** message routing simplified.
- Unit tests for **`useObservabilitySessionId`** and recruiter supervisor paths.
</details>
<details>
<summary><strong>Colombia payment MCP</strong> — SLIM topic-based client creation</summary>
- **`invoke_payment_mcp_tool`** uses App SDK **`topic=`** (not legacy FastMCP/url args) when creating the payment MCP client ([#678](https://github.com/agntcy/coffeeAgntcy/pull/678)).
- Adds **`test_payment_client.py`** coverage for the corrected invocation path.
</details>
# Dependencies
| Component | 0.2.0 | 0.2.1 |
| --- | --- | --- |
| `agentic-workflows-api` Helm chart | 0.1.1 | **0.1.4** |
| `lungo-ui` Helm chart | 0.1.4 | **0.1.5** |
No changes to **`lungo/uv.lock`**, **`corto/uv.lock`**, **`recruiter/uv.lock`**, or **`frontend/package-lock.json`** since 0.2.0.
# Changeset
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/675">#675</a> — @pregnor — fix(lungo,helm,awapi): add externalSecret resource</summary>
- Adds **`es-secrets.tpl.yaml`** and optional **`secretRef`** in the agentic-workflows-api deployment when **`externalSecrets`** is configured.
- Bumps **`agentic-workflows-api`** chart **0.1.1 → 0.1.2**.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/676">#676</a> — @pregnor — fix(lungo,helm,awapi): specify model4 pattern_chat</summary>
- Wires **`LLM_MODEL`** from **`values.config.llmModel`** into the agentic-workflows-api ConfigMap for pattern chat.
- Bumps **`agentic-workflows-api`** chart **0.1.2 → 0.1.3**.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/677">#677</a> — @pregnor — fix(lungo,helm,awapi): fix azure env vars</summary>
- Exposes **`AZURE_API_BASE`** and **`AZURE_API_VERSION`** via ConfigMap for Azure OpenAI-backed pattern chat.
- Bumps **`agentic-workflows-api`** chart **0.1.3 → 0.1.4**.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/678">#678</a> — @pregnor — fix(lungo,columbia): fix payment MCP call</summary>
- Corrects payment MCP client factory call to use **`topic="lungo_payment_service"`** with the configured transport instance.
- Adds unit tests in **`tests/unit/mcp_servers/test_payment_client.py`**.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/683">#683</a> — @pregnor — fix(#671,lungo,fe): fix UI response grafana link</summary>
- Introduces **`GrafanaSessionLink`** and **`useObservabilitySessionId`** for pattern-aware Grafana deep-links in chat feeds.
- Refactors recruiter supervisor streaming to propagate trace/session ids; simplifies **`ChatArea`** routing.
- Adds frontend and recruiter unit tests for observability session resolution.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/686">#686</a> — @pregnor — fix(lungoui,helm): fix deployment template envfrom</summary>
- Declares **`envFrom:`** unconditionally in **`lungo-ui`** deployment template so optional ExternalSecret refs render valid YAML.
- Bumps **`lungo-ui`** chart **0.1.4 → 0.1.5**.
</details>
---
Version: 0.2.1
Date: 2026-07-01
Status: Released
Breaking: Yes
Components: Core
Authors: @0, @pregnor
PRs:b6a5eff
Docs
Release PR
release   ·   observe   ·   sdk-v1.0.43   ·   2026-06-29
sdk-v1.0.43
What's Changed
• feat: event contract for pushing events by @91pavan in #124•
Full Changelog: https://github.com/agntcy/observe/compare/sdk-v1.0.42...sdk-v1.0.43
Version: sdk-v1.0.43
Date: 2026-06-29
Status: Released
Breaking: Yes
Components: Core
Authors: @91pavan
PRs:893c15d
Compare: Previous version
Docs
Release PR
Compare
release   ·   coffeeAgntcy   ·   0.2.0   ·   2026-06-25
0.2.0
0.2.0 (2026-06-25)
Fiber milestone: **Open UI Kit frontend**, **SLIM 1.4 upgrade** (Lungo + Corto), **MCP live workflow events**, **pattern reference library chat**, **A2A transport rails** on agent nodes, and **recruiter flow optimizations**.
# Summary
• *Breaking / migration (read first)**
<details>
<summary><strong>Lungo UI — Open UI Kit migration</strong> — Tailwind removed; Node.js ≥ 24 required</summary>
- Full frontend restyle on **`@open-ui-kit/core`** + MUI; **Tailwind CSS**, PostCSS, and related utility deps removed ([#614](https://github.com/agntcy/coffeeAgntcy/pull/614)).
- **`frontend/package.json`** requires **`node >= 24.0.0`** and **`npm >= 11.10.1`**; run **`npm ci`** after pull.
- Custom UI work should use Open UI Kit / MUI tokens — not Tailwind classes.
</details>
<details>
<summary><strong>SLIM 1.4.0</strong> — Helm, Python bindings, Corto + Lungo agents</summary>
- SLIM Helm dependency **v0.6.0 → v1.4.0**; **`slim-bindings`** **1.1.0 → 1.4.0** in Lungo/Corto lockfiles ([#665](https://github.com/agntcy/coffeeAgntcy/pull/665)).
- Updates agent cards, A2A transport config, Compose, and Helm transport secrets across **Lungo and Corto**.
- Refresh **`lungo/.env`**, **`corto/.env`**, and rebuild agent images after upgrade.
</details>
<details>
<summary><strong>Helm chart bumps</strong> — <code>lungo-local-cluster@0.5.0</code>, <code>lungo-ui@0.1.4</code>, subcharts <code>0.1.2</code></summary>
- Umbrella **`lungo-local-cluster`** **0.4.1 → 0.5.0**; **`lungo-ui`** **0.1.2 → 0.1.4** (via [#645](https://github.com/agntcy/coffeeAgntcy/pull/645), [#614](https://github.com/agntcy/coffeeAgntcy/pull/614), [#662](https://github.com/agntcy/coffeeAgntcy/pull/662)).
- All Lungo agent/MCP subcharts **0.1.1 → 0.1.2**; **`agentic-workflows-api@0.1.1`**.
- Deployment **tolerations** added to Lungo and Corto Helm charts ([#647](https://github.com/agntcy/coffeeAgntcy/pull/647)).
- Run **`helm dependency update`** under **`deployment/helm/local-cluster`** (and Corto umbrella) before upgrading.
</details>
<details>
<summary><strong>Recruiter agent</strong> — App SDK JSONRPC transport and directory search batching</summary>
- Recruiter aligns with Lungo **A2A client** usage; agent cards use canonical **JSONRPC** transport metadata ([#655](https://github.com/agntcy/coffeeAgntcy/pull/655)).
- Directory registry search is batched; bundled **dirctl** bumped to **v1.5.0** for export support.
- Rebuild recruiter images / refresh **`recruiter/uv.lock`** on upgrade.
</details>
<details>
<summary><strong>Pattern chat API</strong> — optional LiteLLM proxy for <code>POST /patterns/{name}/chat</code></summary>
- New docs-grounded pattern advisor endpoint ([#651](https://github.com/agntcy/coffeeAgntcy/pull/651)).
- For proxy-backed models, set **`LITELLM_PROXY_BASE_URL`** and **`LITELLM_PROXY_API_KEY`** in **`lungo/.env`** (see **`.env.example`**).
</details>
• *Migration steps**
1. Refresh env templates:
cp coffeeAGNTCY/coffee_agents/lungo/.env.example coffeeAGNTCY/coffee_agents/lungo/.env
cp coffeeAGNTCY/coffee_agents/lungo/frontend/.env.example coffeeAGNTCY/coffee_agents/lungo/frontend/.env
cp coffeeAGNTCY/coffee_agents/corto/.env.example coffeeAGNTCY/coffee_agents/corto/.env
2. **Frontend dev:** use **Node.js ≥ 24**, then:
cd coffeeAGNTCY/coffee_agents/lungo/frontend
npm ci
3. **Helm / KinD:** **`helm dependency update`** in **`deployment/helm/local-cluster`**, upgrade to **`lungo-local-cluster@0.5.0`**, then reinstall/upgrade the release.
4. **Docker Compose:** rebuild UI and agents after SLIM/dependency bumps:
docker compose --profile frontend up --build
5. **Recruiter (optional):** rebuild the recruiter service if you run the recruit workflow standalone or via Compose.
• *Highlights**
<details>
<summary><strong>MCP live workflow events</strong> — transient tool-call topology in the UI graph</summary>
- **`EventEmittingMCPClient`** wraps MCP **`call_tool`** to emit CREATE/DELETE topology fragments correlated with A2A events ([#630](https://github.com/agntcy/coffeeAgntcy/pull/630), closes [#587](https://github.com/agntcy/coffeeAgntcy/issues/587)).
- Colombia farm and weather MCP paths instrumented; documented in **`docs/a2a_event_schema_middleware.md`**.
- Controlled by existing **`EMIT_WORKFLOW_EVENTS`**; no emission when identity cannot be resolved.
</details>
<details>
<summary><strong>Pattern reference library</strong> — backend chat + frontend explorer canvas</summary>
- **`POST /patterns/{name}/chat`** streams a docs-grounded pattern advisor; FE pattern explorer with resizable doc/chat panels and Mermaid rendering ([#651](https://github.com/agntcy/coffeeAgntcy/pull/651), [#652](https://github.com/agntcy/coffeeAgntcy/pull/652)).
</details>
<details>
<summary><strong>A2A transport rail</strong> — per-agent transport interfaces on graph nodes</summary>
- Agent nodes render an expandable **transport rail** showing available transports and highlighting the active/preferred one from OASF card metadata ([#664](https://github.com/agntcy/coffeeAgntcy/pull/664)).
</details>
<details>
<summary><strong>Workflow graph animations</strong> — broadcast-type prompt events</summary>
- UI pulses graph nodes for **broadcast-type** workflow events, not only direct agent prompts ([#643](https://github.com/agntcy/coffeeAgntcy/pull/643)).
</details>
<details>
<summary><strong>UI polish</strong> — chat area, sidebar, and graph styling</summary>
- Chat area backgrounds, sidebar hierarchy/indentation, collapse control placement, and graph node sizing refinements ([#662](https://github.com/agntcy/coffeeAgntcy/pull/662)).
</details>
# Dependencies
| Component | 0.1.2 | 0.2.0 |
| --- | --- | --- |
| `lungo-local-cluster` Helm chart | 0.4.1 | **0.5.0** |
| SLIM Helm chart | v0.6.0 | **v1.4.0** |
| `lungo-ui` Helm chart | 0.1.2 | **0.1.4** |
| Lungo agent/MCP subcharts | 0.1.1 | **0.1.2** |
| `agentic-workflows-api` subchart | 0.1.0 | **0.1.1** |
• *Lungo** (`lungo/uv.lock`):
| Package | 0.1.2 | 0.2.0 |
| --- | --- | --- |
| `langgraph` | 1.0.7 | **1.2.2** |
| `mcp` | 1.26.0 | **1.27.1** |
| `slim-bindings` | 1.1.0 | **1.4.0** |
Unchanged from 0.1.2 in Lungo: `agntcy-app-sdk` 0.5.5, `a2a-sdk` 0.3.20, `ioa-observe-sdk` 1.0.41, `agntcy-identity-service-sdk` 0.0.7.
• *Recruiter** (`recruiter/uv.lock`): `agntcy-app-sdk` 0.4.6 → **0.5.5**, `a2a-sdk` 0.3.2 → **0.3.20**, `langgraph` 1.0.5 → **1.2.1**, `mcp` 1.24.0 → **1.27.1**, `slim-bindings` 0.6.3 → **1.1.0**.
• *Lungo frontend** (`frontend/package-lock.json`): adds **`@open-ui-kit/core@^1.6.0`**; removes Tailwind stack; **`react@^19.1.0`**.
• *Corto** (`corto/uv.lock`): aligned with Lungo on core AGNTCY pins (`agntcy-app-sdk` 0.5.5, `a2a-sdk` 0.3.20, `slim-bindings` 1.4.0, `ioa-observe-sdk` 1.0.41).
# Built With
(Versions from `coffeeAGNTCY/coffee_agents/lungo/uv.lock` and `lungo/frontend/package-lock.json`.)
- [AGNTCY App SDK](https://github.com/agntcy/app-sdk) = v0.5.5
- [SLIM](https://github.com/agntcy/slim) = v1.4.0
- [NATS](https://github.com/nats-io/nats-server) = latest
- [A2A](https://github.com/a2aproject/a2a-python) = v0.3.20
- [MCP](https://github.com/modelcontextprotocol/python-sdk) = v1.27.1
- [LangGraph](https://github.com/langchain-ai/langgraph) = v1.2.2
- [Observe SDK](https://github.com/agntcy/observe) = 1.0.41
- [AGNTCY Identity Service SDK](https://github.com/agntcy/identity-service) = 0.0.7
- [AGNTCY Directory](https://github.com/agntcy/dir) = v1.0.0
# Changeset
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/642">#642</a> — @pregnor — fix(lungo,helm,ui): fix configmap loading</summary>
- Removes a redundant ConfigMap volume mount from the **`lungo-ui`** deployment template that broke runtime **`env-config.js`** loading.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/644">#644</a> — @mihaialexandrescu — chore: do not trigger pytest on frontend changes</summary>
- Limits backend pytest CI to Python paths so frontend-only PRs skip the Lungo test workflow.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/645">#645</a> — @pregnor — release(lungo,ui,helm): bump chart to release chart fix</summary>
- Bumps **`lungo-ui`** Helm chart **0.1.2 → 0.1.3** ahead of the Open UI Kit release train.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/647">#647</a> — @pregnor — Feat/chart deployment tolerations</summary>
- Adds optional **`tolerations`** blocks to Lungo and Corto Helm deployment templates (all agent/MCP/UI subcharts).
- Bumps affected subchart patch versions for release.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/614">#614</a> — @misi-bp — refactor(full UI): Migrate from Tailwind to Open UI Kit</summary>
- Replaces Tailwind with **`@open-ui-kit/core`** across the Lungo UI; drops Tailwind/PostCSS toolchain.
- Requires **Node.js ≥ 24**; bumps Helm **`lungo-ui@0.1.4`** and umbrella chart dependencies.
- Large component restyle: layout, chat, graph, workflow views, and shared theming.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/643">#643</a> — @mihaialexandrescu — fix(lungo): workflow event animations for broadcast-type prompts</summary>
- Extends **`useAgentAPI`** so broadcast/group workflow events pulse the correct graph nodes in the UI.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/630">#630</a> — @delthazor — (feat) Implement MCP live event processing</summary>
- Adds **`common/mcp_event_middleware/`** with **`wrap_mcp_client`** / **`EventEmittingMCPClient`** for transient MCP tool-call topology events.
- Extends **`common/workflow_utils/mcp.py`** builders; instruments Colombia farm MCP path; unit and integration tests.
- Updates **`docs/a2a_event_schema_middleware.md`** for MCP lifecycle (CREATE on start, DELETE on end).
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/652">#652</a> — @codyhartsook — docs(#588): add agent interaction mermaid diagrams to workflow docs</summary>
- Embeds Mermaid sequence diagrams in pattern/workflow documentation for agent interaction flows.
- FE pattern doc viewer renders diagrams with theme-aware edge colors.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/651">#651</a> — @codyhartsook — feat(#588): pattern reference library explorer — BE chat + FE canvas</summary>
- OpenAPI **`POST /patterns/{name}/chat`** with streaming ADK/LiteLLM pattern advisor backed by reference markdown.
- FE pattern explorer: resizable doc/chat panels, **`usePatternChatAPI`**, Mermaid in docs, GitHub doc links.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/665">#665</a> — @pregnor — chore(dep): upgrade SLIM to 1.4.0</summary>
- Bumps SLIM Helm dependency to **v1.4.0** and **`slim-bindings`** across Lungo and Corto **`uv.lock`** files; updates root **Built With**.
- Refactors Corto exchange/farm agents to shared **`a2a_transport_config`**; adds Helm transport secrets and Compose wiring.
- Updates Lungo farm agent cards and integration tests for SLIM 1.4 transport metadata.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/662">#662</a> — @misi-bp — feat: UI improvements from John</summary>
- Chat area and sidebar visual polish (backgrounds, typography, collapse control, parent category selection).
- Graph node sizing/position fixes; Helm subchart version bumps for UI deployment.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/664">#664</a> — @codyhartsook — feat(lungo): A2A transport rail on agent nodes</summary>
- **`TransportRail`** component on graph nodes shows transport interfaces from OASF metadata.
- Highlights active or preferred transport; expands to show transport names on hover/click.
</details>
<details>
<summary><a href="https://github.com/agntcy/coffeeAgntcy/pull/655">#655</a> — @codyhartsook — Optimize recruiter flow, match lungo a2a client usage, fix card translation</summary>
- Recruiter registry search batched; App SDK JSONRPC transport in agent cards aligned with Lungo.
- Bumps bundled **dirctl** to **v1.5.0**; fixes card translation and directory timeout handling.
- Refreshes **`recruiter/uv.lock`** to current AGNTCY stack pins.
</details>
---
Version: 0.2.0
Date: 2026-06-25
Status: Released
Breaking: Yes
Components: Core
Authors: @open, @0, @pregnor, @mihaialexandrescu, @misi, @delthazor, @codyhartsook
PRs:cccd566
Docs
Release PR
Page 1 of 5

Copyright © AGNTCY a Series of LF Projects, LLC

For web site terms of use, trademark policy and other project policies please see https://lfprojects.org.

Terms & ConditionsPrivacy Policy