@newheap/platform-ai-chat 0.2.0 → 0.4.0

package/i18n/en.json

@@ -159,6 +159,9 @@
       "assistant-turn-failed": "The assistant could not finish the answer. Try again.",
       "assistant-turn-timeout": "The answer took too long and was stopped. Try again or ask a narrower question."
     },
+    "notices": {
+      "no-answer": "The assistant finished without an answer. Try again or rephrase your question."
+    },
     "preferences": {
       "title": "Your preferences",
       "description": "Choose how the assistant answers you. Preferences change the style only; they never change what the assistant may do or which actions need your approval.",

package/i18n/nl.json

@@ -159,6 +159,9 @@
       "assistant-turn-failed": "De assistent kon het antwoord niet afmaken. Probeer het opnieuw.",
       "assistant-turn-timeout": "Het antwoord duurde te lang en is gestopt. Probeer het opnieuw of stel een gerichtere vraag."
     },
+    "notices": {
+      "no-answer": "De assistent is klaar zonder antwoord. Probeer het opnieuw of stel je vraag anders."
+    },
     "preferences": {
       "title": "Je voorkeuren",
       "description": "Kies hoe de assistent je antwoordt. Voorkeuren veranderen alleen de stijl; ze veranderen nooit wat de assistent mag of welke acties je goedkeuring nodig hebben.",

package/index.d.ts

@@ -336,6 +336,12 @@ interface NhAssistantConfig {
      * failing getter or an invalid shape only leaves the context out. Default: none.
      */
     getPageContext?: () => ClientContext | null | Promise<ClientContext | null>;
+    /**
+     * Stable, non-secret identity for browser UI state (for example a user id plus tenant id).
+     * Runs in the assistant injection context. Return null on sign-out. Without this callback
+     * the assistant keeps UI state in memory only. Never return an access token.
+     */
+    getStateScope?: () => string | null | Promise<string | null>;
     /** Injectable access policy. Default: always allowed. */
     accessPolicy?: Type<NhAssistantAccessPolicy>;
     /** Agent selected when the user has not chosen one. Default: the first agent the server lists. */
@@ -507,6 +513,11 @@ declare class NhAssistantAdminApiService {
 declare function applyNhAssistantEvent(conversation: Conversation, event: NhAssistantSseEvent, clientMessageId?: string): Conversation;
 /** Records the user's approval decision locally until the server state is reloaded. */
 declare function applyNhAssistantApprovalDecision(conversation: Conversation, approvalId: string, decision: 'approve' | 'reject'): Conversation;
+/**
+ * True when an assistant message after the latest user message contains non-blank text,
+ * so the latest turn produced a visible answer. Tool calls and approvals alone do not count.
+ */
+declare function nhAssistantLatestTurnHasText(conversation: Conversation): boolean;
 
 /** Limits of the page context (contract 15.2). */
 declare const NH_ASSISTANT_PAGE_CONTEXT_LIMITS: {
@@ -532,6 +543,13 @@ interface NhAssistantError {
     code: string;
     messageKey: string;
 }
+/**
+ * A non-blocking remark about a turn that completed normally, for example a limit that cut the
+ * answer short. The conversation stays usable; the notice only explains the answer.
+ */
+type NhAssistantNotice = NhAssistantError;
+/** Notice code for a completed turn that produced no answer text and no server code. */
+declare const NH_ASSISTANT_NO_ANSWER_NOTICE_CODE = "assistant-no-answer";
 /**
  * Signal-based state of one assistant scope: availability, agents, the conversation list
  * and the active conversation with its streamed turn.
@@ -541,6 +559,7 @@ declare class NhAssistantStore {
     private readonly config;
     private readonly injector;
     private readonly accessPolicy;
+    private readonly uiState;
     private readonly accessGrantedState;
     private readonly statusState;
     private readonly statusLoadingState;
@@ -553,14 +572,19 @@ declare class NhAssistantStore {
     private readonly streamingState;
     private readonly decidingState;
     private readonly errorState;
+    private readonly noticeState;
     private readonly lastUsageState;
     private readonly restoredDraftState;
     private readonly pageContextState;
     private readonly pageContextExcludedState;
+    private readonly restorePanelOpenState;
     private accessSubscription?;
     private streamSubscription?;
     private cancelTimer?;
     private initialization?;
+    private statusRevision;
+    private accountRevision;
+    private pendingSendResolve?;
     /** True when the access policy allows the user and the server reports the assistant as enabled. */
     readonly enabled: _angular_core.Signal<boolean>;
     readonly accessGranted: _angular_core.Signal<boolean | null>;
@@ -583,6 +607,8 @@ declare class NhAssistantStore {
     readonly pendingApproval: _angular_core.Signal<ApprovalPart | null>;
     readonly deciding: _angular_core.Signal<boolean>;
     readonly error: _angular_core.Signal<NhAssistantError | null>;
+    /** Non-blocking remark about the latest completed turn; shown only while no error is shown. */
+    readonly notice: _angular_core.Signal<NhAssistantError | null>;
     readonly lastUsage: _angular_core.Signal<TurnUsage | null>;
     /** Text of a message the server did not accept, so the composer can offer it again. */
     readonly restoredDraft: _angular_core.Signal<string | null>;
@@ -590,6 +616,8 @@ declare class NhAssistantStore {
     readonly pageContext: _angular_core.Signal<ClientContext | null>;
     /** True when the user left the page context out of the next message. */
     readonly pageContextExcluded: _angular_core.Signal<boolean>;
+    /** Whether the drawer was open when this account last left the application. */
+    readonly restorePanelOpen: _angular_core.Signal<boolean>;
     /** True while the user can send: enabled, an agent is chosen and no turn runs or waits. */
     readonly canSend: _angular_core.Signal<boolean>;
     constructor();
@@ -603,6 +631,7 @@ declare class NhAssistantStore {
     /** Leaves the active conversation; the next message creates a new one. */
     startNewConversation(): void;
     openConversation(conversationId: string): Promise<void>;
+    private loadConversation;
     deleteConversation(conversationId: string): Promise<void>;
     /**
      * Sends a user message. Creates a conversation with the selected agent when none is
@@ -615,6 +644,9 @@ declare class NhAssistantStore {
     /** Asks the server to stop the running turn or to abandon a waiting approval. */
     cancel(): Promise<void>;
     clearError(): void;
+    clearNotice(): void;
+    /** Persists only drawer visibility, never the page context or a message draft. */
+    setPanelOpen(open: boolean): void;
     /** Reads the host's page context again so the chip shows what the next message sends. */
     refreshPageContext(): Promise<void>;
     /** Leaves the page context out of the next message only, or includes it again. */
@@ -630,7 +662,10 @@ declare class NhAssistantStore {
     private startInitialization;
     private createConversation;
     private runStream;
+    private stopLocalTurn;
     private applyEvent;
+    /** A completed turn with a server code, or without any answer text, explains itself with a notice. */
+    private completionNotice;
     private afterTurn;
     private reloadActiveConversation;
     private updateActive;
@@ -664,6 +699,7 @@ declare class NhAssistantPanelService {
     readonly isOpen: Signal<boolean>;
     constructor();
     open(conversationId?: string): void;
+    private showPanel;
     close(): void;
     toggle(): void;
     /** Called by `nh-assistant-panel`; hosts should place that component once instead. */
@@ -733,6 +769,7 @@ declare class NhAssistantPanelComponent implements AfterViewInit, OnDestroy {
     readonly composerDisabled: _angular_core.Signal<boolean>;
     readonly composerStatus: _angular_core.Signal<"running" | "waiting-for-approval" | null>;
     readonly errorKeys: _angular_core.Signal<string[]>;
+    readonly noticeKeys: _angular_core.Signal<string[]>;
     constructor();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
@@ -959,5 +996,5 @@ declare function nhAssistantErrorKeys(error: NhAssistantError | null): string[];
 /** Dash-case identifiers as the contract requires for agent and MCP server ids. */
 declare const NH_ASSISTANT_DASH_CASE: RegExp;
 
-export { NH_ASSISTANT_ACCESS_POLICY, NH_ASSISTANT_CONFIG, NH_ASSISTANT_FETCH, NH_ASSISTANT_ICONS, NH_ASSISTANT_MAX_CUSTOM_INSTRUCTIONS, NH_ASSISTANT_PAGE_CONTEXT_LIMITS, NH_ASSISTANT_PANEL_MOBILE_QUERY, NH_ASSISTANT_PANEL_WIDTH, NH_ASSISTANT_SSE_EVENT_TYPES, NH_ASSISTANT_TRANSLATIONS, NH_ASSISTANT_VIRTUAL_SCROLL_THRESHOLD, NhAssistantAdminApiService, NhAssistantAgentPickerComponent, NhAssistantAllowAllAccessPolicy, NhAssistantApiError, NhAssistantApiService, NhAssistantApprovalCardComponent, NhAssistantClientErrorCodes, NhAssistantComposerComponent, NhAssistantConversationListComponent, NhAssistantLauncherComponent, NhAssistantPanelComponent, NhAssistantPanelService, NhAssistantPreferencesComponent, NhAssistantSseParser, NhAssistantStore, NhAssistantThreadComponent, NhAssistantToolCallCardComponent, NhAssistantTranslationMerger, applyNhAssistantApprovalDecision, applyNhAssistantEvent, describeNhAssistantClientContext, formatNhAssistantCountdown, nhAssistantCodeForStatus, nhAssistantErrorMessageKey, normalizeNhAssistantClientContext, provideNhAssistant, NH_ASSISTANT_DASH_CASE as ɵNH_ASSISTANT_DASH_CASE, NhAssistantIconComponent as ɵNhAssistantIconComponent, NhAssistantTranslatePipe as ɵNhAssistantTranslatePipe, nhAssistantErrorKeys as ɵnhAssistantErrorKeys, toNhAssistantError as ɵtoNhAssistantError };
-export type { AdminAgent, AdminAgentInput, AgentSummary, ApplicationContext, ApplicationContextVersion, ApprovalDecision, ApprovalPart, ApprovalPresentation, ApprovalPresentationField, ApprovalRequiredEvent, ApprovalStatus, AssistantAddressForm, AssistantAutonomy, AssistantErrorEvent, AssistantPreferences, AssistantResponseLength, AssistantStatus, AssistantStyle, ClientContext, ClientContextEntity, Conversation, ConversationPage, ConversationStatus, ConversationSummary, CreateConversationRequest, DecideApprovalRequest, McpAuthMode, McpServer, McpServerInput, McpServerTestResult, McpTool, McpToolEffect, McpToolStatus, Message, MessageDeltaEvent, MessagePart, NhAssistantAccessPolicy, NhAssistantClientContext, NhAssistantClientErrorCode, NhAssistantConfig, NhAssistantError, NhAssistantFetch, NhAssistantIconName, NhAssistantRawSseMessage, NhAssistantSseEvent, NhAssistantSseEventMap, NhAssistantSseEventType, NhAssistantStatusCodes, SendMessageRequest, TextPart, ToolCallPart, ToolCallStatus, ToolCatalogEffect, ToolCatalogEntry, ToolCompletedEvent, ToolStartedEvent, TurnCompletedEvent, TurnCompletionStatus, TurnStartedEvent, TurnUsage, UpdateAdminAgentRequest, UpdateApplicationContextRequest, UpdateMcpToolRequest };
+export { NH_ASSISTANT_ACCESS_POLICY, NH_ASSISTANT_CONFIG, NH_ASSISTANT_FETCH, NH_ASSISTANT_ICONS, NH_ASSISTANT_MAX_CUSTOM_INSTRUCTIONS, NH_ASSISTANT_NO_ANSWER_NOTICE_CODE, NH_ASSISTANT_PAGE_CONTEXT_LIMITS, NH_ASSISTANT_PANEL_MOBILE_QUERY, NH_ASSISTANT_PANEL_WIDTH, NH_ASSISTANT_SSE_EVENT_TYPES, NH_ASSISTANT_TRANSLATIONS, NH_ASSISTANT_VIRTUAL_SCROLL_THRESHOLD, NhAssistantAdminApiService, NhAssistantAgentPickerComponent, NhAssistantAllowAllAccessPolicy, NhAssistantApiError, NhAssistantApiService, NhAssistantApprovalCardComponent, NhAssistantClientErrorCodes, NhAssistantComposerComponent, NhAssistantConversationListComponent, NhAssistantLauncherComponent, NhAssistantPanelComponent, NhAssistantPanelService, NhAssistantPreferencesComponent, NhAssistantSseParser, NhAssistantStore, NhAssistantThreadComponent, NhAssistantToolCallCardComponent, NhAssistantTranslationMerger, applyNhAssistantApprovalDecision, applyNhAssistantEvent, describeNhAssistantClientContext, formatNhAssistantCountdown, nhAssistantCodeForStatus, nhAssistantErrorMessageKey, nhAssistantLatestTurnHasText, normalizeNhAssistantClientContext, provideNhAssistant, NH_ASSISTANT_DASH_CASE as ɵNH_ASSISTANT_DASH_CASE, NhAssistantIconComponent as ɵNhAssistantIconComponent, NhAssistantTranslatePipe as ɵNhAssistantTranslatePipe, nhAssistantErrorKeys as ɵnhAssistantErrorKeys, toNhAssistantError as ɵtoNhAssistantError };
+export type { AdminAgent, AdminAgentInput, AgentSummary, ApplicationContext, ApplicationContextVersion, ApprovalDecision, ApprovalPart, ApprovalPresentation, ApprovalPresentationField, ApprovalRequiredEvent, ApprovalStatus, AssistantAddressForm, AssistantAutonomy, AssistantErrorEvent, AssistantPreferences, AssistantResponseLength, AssistantStatus, AssistantStyle, ClientContext, ClientContextEntity, Conversation, ConversationPage, ConversationStatus, ConversationSummary, CreateConversationRequest, DecideApprovalRequest, McpAuthMode, McpServer, McpServerInput, McpServerTestResult, McpTool, McpToolEffect, McpToolStatus, Message, MessageDeltaEvent, MessagePart, NhAssistantAccessPolicy, NhAssistantClientContext, NhAssistantClientErrorCode, NhAssistantConfig, NhAssistantError, NhAssistantFetch, NhAssistantIconName, NhAssistantNotice, NhAssistantRawSseMessage, NhAssistantSseEvent, NhAssistantSseEventMap, NhAssistantSseEventType, NhAssistantStatusCodes, SendMessageRequest, TextPart, ToolCallPart, ToolCallStatus, ToolCatalogEffect, ToolCatalogEntry, ToolCompletedEvent, ToolStartedEvent, TurnCompletedEvent, TurnCompletionStatus, TurnStartedEvent, TurnUsage, UpdateAdminAgentRequest, UpdateApplicationContextRequest, UpdateMcpToolRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newheap/platform-ai-chat",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",