@m6d/cortex-angular 0.14.1 → 0.15.0

package/package.json

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

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

@@ -175,7 +175,12 @@ export type CortexHeaders = Record<string, string>;
  */
 export type CortexTransport = {
 	baseUrl: string | (() => string);
-	getHeaders: () => CortexHeaders | Promise<CortexHeaders>;
+	/**
+	 * The headers every call carries, usually the end user's bearer. Left out
+	 * for an anonymous agent: the widget signs in as a visitor, and Cortex
+	 * gives this browser an id it keeps and sends from then on.
+	 */
+	getHeaders?: () => CortexHeaders | Promise<CortexHeaders>;
 	/**
 	 * Sent with every thread the widget creates. The console's playground puts
 	 * a test thread's variables here; Cortex honours it only from a verified
@@ -341,9 +346,10 @@ export type CortexSlotContexts<View> = {
 };
 /**
  * Why Cortex left a read unanswered: it could not be reached (or failed),
- * it refused the caller's sign-in (401), or it serves no such agent (404).
+ * it refused the caller's sign-in (401), the agent's reCAPTCHA check
+ * refused the visitor, or it serves no such agent (404).
  */
-export type Unanswered = "unreachable" | "refused" | "missing";
+export type Unanswered = "unreachable" | "refused" | "unverified" | "missing";
 /** Why the composer refused a file before uploading it: the attachment policy's reason, or one file too many. */
 export type AttachmentRefusal = Exclude<ReturnType<typeof checkAttachmentPolicy>, "ok"> | "count";
 export type QueuedAttachment = {
@@ -535,6 +541,8 @@ export type CortexChatMessage = CortexMessage<MessagePart>;
 declare class CortexChatService {
 	readonly widget: {
 		api: {
+			onVisitorReplaced(heard: () => void): () => void;
+			retrySignIn(): void;
 			getCapabilities(): Promise<AgentCapabilities$1>;
 			listThreads(): Promise<ThreadSummary[]>;
 			createThread(): Promise<ThreadSummary>;
@@ -553,6 +561,7 @@ declare class CortexChatService {
 				[x: string]: string;
 			}>;
 			resolveUrl: (path: string) => string;
+			readVisitorAnswer: (response: Response, sent: HeadersInit | undefined) => "refused" | "stale" | undefined;
 		};
 		getState: () => CortexWidgetState;
 		getDraft: () => string;
@@ -578,6 +587,7 @@ declare class CortexChatService {
 		openHistory: () => void;
 		closeHistory: () => void;
 		toggleDebug: () => void;
+		retry: () => void;
 	};
 	private readonly snapshot;
 	private readonly text;
@@ -657,7 +667,7 @@ export declare class CortexChatWidgetComponent implements OnInit {
 			openThread: (thread: ThreadSummary) => void;
 		};
 	}>;
-	protected readonly composerSlot: import("@angular/core").Signal<"translate_access_refused" | "translate_agent_unreachable" | "translate_agent_missing" | "composer" | "translate_read_only" | "translate_messages_disabled" | undefined>;
+	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;
 	ngOnInit(): void;
 	protected onWidgetDragOver(event: DragEvent): void;