@artooi/ag-ui-web-component 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] — 2026-06-03
+
+### Added
+- **`data-tools-url` — server tool-label catalog.** On connect the element
+  fetches a JSON catalog (`[{ name, summary, description? }]`) from the URL
+  (with `headers`) and uses it to label tool-call cards for **server-side tools**
+  whose schema never reaches the browser. Pairs with django-ag-ui's `tools/`
+  endpoint, so a tool's label flows from its server-side source (drf-mcp
+  `display_name`, `@tool(summary=…)`) with no per-tool client duplication.
+  Per-card label precedence: the tool's own `x-summary` → an explicit
+  `toolSummaries` entry → the fetched catalog → the raw name. Exports the
+  `ToolCatalogEntry` type and the `parseToolCatalog` helper.
+
 ## [0.2.2] — 2026-06-02
 
 ### Added
@@ -159,7 +172,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Notes
 - First release — exercising the automated npm OIDC publish pipeline end-to-end.
 
-[Unreleased]: https://github.com/Artui/ag-ui-web-component/compare/v0.2.2...HEAD
+[Unreleased]: https://github.com/Artui/ag-ui-web-component/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/Artui/ag-ui-web-component/compare/v0.2.2...v0.3.0
 [0.2.2]: https://github.com/Artui/ag-ui-web-component/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/Artui/ag-ui-web-component/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/Artui/ag-ui-web-component/compare/v0.1.1...v0.2.0

package/README.md

@@ -151,6 +151,7 @@ That's the whole integration: an `endpoint` attribute pointing at your AG-UI ser
 | `data-slash-commands` | — | `"true"` to enable the `/`-command palette. |
 | `data-skills` | — | Inline JSON skill catalog. |
 | `data-skills-url` | — | URL of a JSON skill catalog (fetched with `headers`). |
+| `data-tools-url` | — | URL of a server tool-label catalog (`[{ name, summary, description? }]`), fetched with `headers`; labels tool-call cards for server-side tools. |
 | `collapsed` | `collapsed` | Reflected boolean; collapses the widget. Persisted per-tab in `sessionStorage`. |
 | `theme` | — | CSS-only: `light` (default) / `dark` / `auto` / `code`. |
 | `density` | — | CSS-only: `comfortable` (default) / `compact`. |
@@ -165,7 +166,10 @@ plus the mirrors `endpoint` / `toolDisplay` / `collapsed`.
 label, used when a tool has no `x-summary` in its own schema. Built-in and client tools
 should carry `x-summary` directly; this map is the seam for **server-side tools** (drf-mcp,
 the django-ag-ui `@tool` registry), whose schema never reaches the browser — e.g.
-`chat.toolSummaries = { list_projects: "Search projects" }`.
+`chat.toolSummaries = { list_projects: "Search projects" }`. Or point
+`data-tools-url` at a server catalog endpoint (django-ag-ui's `tools/`) and the
+labels are fetched automatically — per card, `x-summary` → an explicit
+`toolSummaries` entry → the fetched catalog → the raw name.
 
 **Methods**: `registerTool`, `registerStateHook`, `setSkills`, `appendMessage`, `newChat`,
 `setCollapsed`, `toggleCollapsed`.