@m6d/cortex-angular 0.15.2 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m6d/cortex-angular",
-  "version": "0.15.2",
+  "version": "0.17.0",
   "description": "Angular chat widget for Cortex agents",
   "license": "MIT",
   "sideEffects": false,
@@ -21,8 +21,8 @@
     "@angular/common": ">=21.2.0 <23",
     "@angular/core": ">=21.2.0 <23",
     "@angular/platform-browser": ">=21.2.0 <23",
-    "@tanstack/ai": ">=0.55.0 <1.0.0",
-    "@tanstack/ai-client": ">=0.32.0 <1.0.0",
+    "@tanstack/ai": ">=1.0.0 <2.0.0",
+    "@tanstack/ai-client": ">=1.0.0 <2.0.0",
     "dompurify": "^3.0.0",
     "highlight.js": "^11.0.0",
     "leaflet": "^1.9.0",

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;
 	};
 };
@@ -485,11 +488,24 @@ type TokenUsage$1 = {
 	};
 	total: number;
 };
+/**
+ * Response of `GET /connections/:server?call=<toolCallId>`: where the
+ * caller's own account stands with the agent's MCP server of that name, for
+ * the card of that `connectAccount` call. `connected` with all a sign-in
+ * may ask for; `pending` while it is not connected, or lacks access a
+ * sign-in may still grant; `refused` once the card's own sign-in came back
+ * without it, or no sign-in may ask again.
+ */
+export type AccountConnection$1 = {
+	status: "connected" | "pending" | "refused";
+};
 /**
  * What Cortex offers this agent's clients, fetched once at widget startup.
  * 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 +531,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
@@ -551,6 +568,7 @@ declare class CortexChatService {
 			listLlmRequests(threadId: string, messageId: string): Promise<LlmRequest$1[]>;
 			abortStream(threadId: string): Promise<AbortRunResult$1>;
 			initiateToolCall(threadId: string, toolCallId: string): Promise<ClientToolInitiateResult$1>;
+			accountConnection(server: string, toolCallId: string, signal?: AbortSignal): Promise<AccountConnection$1>;
 			uploadAttachment(threadId: string, file: File): Promise<AttachmentSummary$1>;
 			deleteAttachment(id: string): Promise<void>;
 			downloadAttachment(id: string): Promise<{
@@ -599,7 +617,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();
@@ -610,6 +628,8 @@ declare class CortexChatService {
 export declare class CortexChatWidgetComponent implements OnInit {
 	readonly config: import("@angular/core").InputSignal<CortexAngularConfig>;
 	protected readonly direction: import("@angular/core").Signal<"ltr" | "rtl">;
+	protected readonly viewMode: import("@angular/core").Signal<CortexViewMode>;
+	private readonly container;
 	private readonly landingComposer;
 	/** The consumer's own parts by slot; each replaces the widget's default and gets the same context. */
 	private readonly slotDirectives;
@@ -621,8 +641,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 +656,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: {
@@ -669,6 +687,7 @@ export declare class CortexChatWidgetComponent implements OnInit {
 	}>;
 	protected readonly composerSlot: import("@angular/core").Signal<"translate_access_refused" | "translate_visitor_unverified" | "translate_agent_unreachable" | "translate_agent_missing" | "composer" | "translate_read_only" | "translate_messages_disabled" | undefined>;
 	private readonly injector;
+	constructor();
 	ngOnInit(): void;
 	protected onWidgetDragOver(event: DragEvent): void;
 	protected onWidgetDrop(event: DragEvent): void;
@@ -695,7 +714,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>
  */