@newheap/platform-ai-chat 0.19.0 → 0.21.0

package/README.md

@@ -154,6 +154,13 @@ title, Markdown text and a link within the application or to an `https` address.
 Custom layouts pass `[approvalRights]` to `nh-assistant-thread` and handle
 `(approvalChoice)`, which carries the approval id.
 
+A question an agent asked with `ask_question` (`run.AllowQuestions()` on the server) shows as
+`nh-assistant-question-card`: the person it is addressed to gets a button per choice, everyone else
+reads it with whom it waits for. The turn waits for the answer as for an approval
+(`conversation.pendingQuestion`); the thread emits `(questionAnswer)` for the addressee and the panel
+calls `NhAssistantStore.answerQuestion`, which streams the resumed turn. An agent message of a chat
+with `run.SkillsInChat()` names the skill it worked in (`message.skillId`).
+
 A tool call whose agent proposal closed without running no longer waits: it ends as
 `rejected`, as `not-executed` when the proposal expired, was withdrawn or became stale, or as
 `failed` when its execution failed before it started, with the result code
@@ -234,7 +241,9 @@ invitation link. Participants can view members and leave. Custom hosts using
 ## Administration
 
 The administration page is a separate entry point, so it stays out of the initial
-bundle. Route to it lazily behind the host's admin permission and pass the route as
+bundle, and its `nh-assistant.admin.` texts come with it: every component of
+`@newheap/platform-ai-chat/admin` merges them when it is created, unless the assistant
+uses `translations: 'host'`. Route to it lazily behind the host's admin permission and pass the route as
 `adminRoute`:
 
 ```typescript
@@ -529,7 +538,15 @@ Error events are shown through their `messageKey`, then `nh-assistant.errors.<co
 then a generic text. Tool result codes use `nh-assistant.result-codes.<code>` and
 fall back to the code. With `translations: 'host'`, copy the bundles from
 `NH_ASSISTANT_TRANSLATIONS` or from `@newheap/platform-ai-chat/i18n/en.json` and
-`nl.json`.
+`nl.json`, and the administration's `nh-assistant.admin.` texts from
+`NH_ASSISTANT_ADMIN_TRANSLATIONS` (`@newheap/platform-ai-chat/admin`) or from
+`@newheap/platform-ai-chat/admin/i18n/en.json` and `nl.json`.
+
+The root entry point bundles the texts of the panel and its other components, which load
+with the application. The administration ships its texts in its own entry point, so they
+load with its lazy route; a host page that shows
+`nh-assistant.admin.` keys without an administration component starts
+`NhAssistantAdminTranslationMerger` itself.
 
 ## Mock API