@m6d/cortex-angular 0.15.1 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m6d/cortex-angular",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Angular chat widget for Cortex agents",
   "license": "MIT",
   "sideEffects": false,

package/types/m6d-cortex-angular.d.ts

@@ -80,6 +80,8 @@ export type TokenUsage = {
  * The widget hides UI for anything absent; Cortex enforces each.
  */
 export type AgentCapabilities = {
+	/** The agent's display name per locale, which titles a new chat; `{}` for an agent without one. */
+	displayName: Partial<LocalizedText>;
 	attachments: boolean;
 	/**
 	 * False when this caller may not send to the chat: the agent's `message`
@@ -121,6 +123,8 @@ export type Suggestion = {
 /** The manifest's suggestion and greeting schemas are built from these. */
 export type Suggestions = Record<Locale, Suggestion[]>;
 export type Greeting = Record<Locale, string>;
+/** Author-written copy the widget shows verbatim, one string per locale. */
+export type LocalizedText = Record<Locale, string>;
 export type TriggerFiringSummary = {
 	name: string;
 	firingId: string;
@@ -203,8 +207,6 @@ export type MediaRenderContext = {
  */
 export type MediaRenderer = (host: HTMLElement, source: string, context: MediaRenderContext) => Promise<() => void>;
 export type MediaRenderers = Partial<Record<string, MediaRenderer>>;
-/** One value for every locale, or a map keyed by locale ('en', 'ar'). */
-export type Localized<T> = T | Partial<Record<Locale, T>>;
 export type CortexViewMode = "helper" | "full";
 export type CortexTheme = "light" | "dark" | "system";
 export type CortexToolCallContext = {
@@ -252,12 +254,6 @@ export type CortexConfig = {
 	 * fence tag; `map` swaps the built-in Leaflet map for another provider.
 	 */
 	mediaRenderers?: MediaRenderers;
-	/**
-	 * Chat header title while no thread is selected; defaults to a localized
-	 * "New Chat". Like the other copy props, either one value for every locale
-	 * or a map keyed by locale (`{ en: 'Support', ar: 'الدعم' }`).
-	 */
-	agentName?: Localized<string>;
 	/**
 	 * A thread to open when the widget mounts, by id, once the thread list holds
 	 * it: a deep link into one conversation, such as the console's inspector.
@@ -283,10 +279,11 @@ export type CortexConfig = {
 export type CortexHeaderContext = {
 	screen: "chat" | "threads";
 	viewMode: CortexViewMode;
-	/** The open thread's title; null on a new chat. */
-	title: string | null;
-	/** `agentName` in the widget's locale. */
-	agentName: string | undefined;
+	/**
+	 * The open thread's title, else the agent's display name in the widget's
+	 * locale, else the built-in "New Chat"; empty while the handshake is out.
+	 */
+	title: string;
 	/** How many conversations the history lists; undefined while the first load is out. */
 	threadCount: number | undefined;
 	isWorking: boolean;
@@ -404,6 +401,12 @@ export type CortexWidgetState = {
 	session: ChatSessionState;
 	/** What Cortex offers this agent's clients; undefined until the handshake answers. */
 	capabilities: AgentCapabilities | undefined;
+	/**
+	 * The agent's display name from the last handshake answered, kept while a
+	 * new one is out; `{}` once the first try fails. Undefined only before the
+	 * first answer or miss.
+	 */
+	displayName: AgentCapabilities["displayName"] | undefined;
 	/** Why the handshake has not answered yet, once a try has failed. */
 	unanswered: Unanswered | undefined;
 	/** The files held for the next message. */
@@ -420,7 +423,7 @@ export type CortexWidgetState = {
 	 * one of its fields changes, which a streamed chunk does only as the turn
 	 * starts and stops working, so a framework redraws them only then.
 	 */
-	parts: Pick<CortexWidgetState, "threads" | "selected" | "capabilities" | "debugMode"> & {
+	parts: Pick<CortexWidgetState, "threads" | "selected" | "capabilities" | "displayName" | "debugMode"> & {
 		isWorking: boolean;
 	};
 };
@@ -490,6 +493,8 @@ type TokenUsage$1 = {
  * The widget hides UI for anything absent; Cortex enforces each.
  */
 export type AgentCapabilities$1 = {
+	/** The agent's display name per locale, which titles a new chat; `{}` for an agent without one. */
+	displayName: Partial<LocalizedText$1>;
 	attachments: boolean;
 	/**
 	 * False when this caller may not send to the chat: the agent's `message`
@@ -515,6 +520,7 @@ type Suggestion$1 = {
 };
 type Suggestions$1 = Record<Locale$1, Suggestion$1[]>;
 type Greeting$1 = Record<Locale$1, string>;
+type LocalizedText$1 = Record<Locale$1, string>;
 /**
  * Response of `POST /chat/:threadId/tools/:toolCallId/initiate` for a pending
  * call stamped with an embed. The payload is for the widget only; it never
@@ -599,7 +605,7 @@ declare class CortexChatService {
 	readonly debugMode: import("@angular/core").Signal<boolean>;
 	readonly turnFailure: import("@angular/core").Signal<TurnFailure | undefined>;
 	/** What the header, landing and history are drawn from: a streamed chunk leaves it as it was. */
-	readonly parts: import("@angular/core").Signal<Pick<CortexWidgetState, "threads" | "capabilities" | "debugMode" | "selected"> & {
+	readonly parts: import("@angular/core").Signal<Pick<CortexWidgetState, "threads" | "capabilities" | "debugMode" | "displayName" | "selected"> & {
 		isWorking: boolean;
 	}>;
 	constructor();
@@ -621,8 +627,7 @@ export declare class CortexChatWidgetComponent implements OnInit {
 		chatHeader: {
 			screen: "chat" | "threads";
 			viewMode: CortexViewMode;
-			title: string | null;
-			agentName: string | undefined;
+			title: string;
 			threadCount: number | undefined;
 			isWorking: boolean;
 			debug: {
@@ -637,8 +642,7 @@ export declare class CortexChatWidgetComponent implements OnInit {
 		threadsHeader: {
 			screen: "chat" | "threads";
 			viewMode: CortexViewMode;
-			title: string | null;
-			agentName: string | undefined;
+			title: string;
 			threadCount: number | undefined;
 			isWorking: boolean;
 			debug: {
@@ -695,7 +699,7 @@ export type SlotTemplateContext<Slot extends SlotName> = {
  *
  *   <cortex-chat-widget [config]="config">
  *     <ng-template cortexSlot="header" let-chat>
- *       <div class="cortex-widget__chat-header">{{ chat.title ?? chat.agentName }}</div>
+ *       <div class="cortex-widget__chat-header">{{ chat.title }}</div>
  *     </ng-template>
  *   </cortex-chat-widget>
  */