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

package/CHANGELOG.md

@@ -7,6 +7,49 @@ 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
+- **Friendly tool-call card labels.** The built-in tools now carry `x-summary`
+  labels (`navigate_to_route` → "Navigate", `list_routes` → "List pages",
+  `read_page` → "Read the page", state-hook `read_*`/`set_*` → "Read/Update
+  <name>"). For tools whose schema never reaches the browser — **server-side
+  tools** (drf-mcp, `@tool` registry) — a new `toolSummaries: Record<string,
+  string>` property maps tool name → label as a fallback (e.g.
+  `chat.toolSummaries = { list_projects: "Search projects" }`).
+
+### Changed
+- A tool call that ends with **no client handler and no `TOOL_CALL_RESULT`** now
+  settles the card as **"No result returned."** instead of the misleading
+  "Executed on the server." (nothing executed it).
+
+### Fixed
+- **Incoming-text animations no longer double-fire.** Two distinct cases:
+  - *End of stream:* `data-text-animation="word"` wrapped the finished assistant
+    message into staggered `.word` spans on `TEXT_MESSAGE_END`, so a response
+    that had already streamed in re-animated itself one word at a time. The word
+    reveal now runs only when a message arrives **at once** (single text delta,
+    or an error bubble); a message streamed across multiple deltas keeps its
+    progressive reveal and isn't re-wrapped.
+  - *Reload from memory:* on rehydrate the whole transcript mounts at once, so
+    every restored assistant bubble animated its text in parallel (fade) or
+    re-wrapped word-by-word — wrong, since it's old content, not arriving. Restored
+    bubbles are now marked `message--restored`, excluded from the fade entrance
+    animation and never word-wrapped, so history appears statically.
+
 ## [0.2.1] — 2026-06-02
 
 ### Added
@@ -129,7 +172,9 @@ 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.1...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
 [0.1.1]: https://github.com/Artui/ag-ui-web-component/compare/v0.1.0...v0.1.1

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`. |
@@ -158,8 +159,17 @@ That's the whole integration: an `endpoint` attribute pointing at your AG-UI ser
 
 **Properties** (JS only, not attributes): `headers`, `autoConfirm`, `confirmPredicate`,
 `agentFactory`, `getTools`, `getContext`, `routeMap`, `navigate`, `getPageMap`,
-`autoInjectPageMap`, `conversationStore`, `navigationResult`, `skillContext`, plus the mirrors
-`endpoint` / `toolDisplay` / `collapsed`.
+`autoInjectPageMap`, `conversationStore`, `navigationResult`, `skillContext`, `toolSummaries`,
+plus the mirrors `endpoint` / `toolDisplay` / `collapsed`.
+
+`toolSummaries` is a `Record<string, string>` mapping tool name → a friendly card
+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" }`. 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`.