@newheap/platform-ai-chat 0.1.1 → 0.3.0

package/i18n/en.json

@@ -58,7 +58,11 @@
       "send": "Send message",
       "stop": "Stop the assistant",
       "characters": "{{count}} of {{max}} characters",
-      "too-long": "The message is too long."
+      "too-long": "The message is too long.",
+      "status": {
+        "running": "You can keep typing while the assistant works. Sending is temporarily unavailable.",
+        "waiting-for-approval": "You can keep typing while an action waits for your approval. Sending is temporarily unavailable."
+      }
     },
     "tool-call": {
       "label": "Tool call: {{name}}",
@@ -67,6 +71,7 @@
       "arguments": "Input",
       "result": "Result",
       "result-code": "Result",
+      "tool-id": "Technical tool id",
       "status": {
         "running": "Running",
         "succeeded": "Completed",
@@ -77,6 +82,9 @@
     },
     "approval": {
       "title": "Approval required",
+      "fallback-summary": "Review this action before it runs.",
+      "technical-details": "Technical details",
+      "tool-id": "Tool id",
       "targets": "Affects",
       "arguments": "Proposed change",
       "expires-in": "Expires in {{time}}",

package/i18n/nl.json

@@ -58,7 +58,11 @@
       "send": "Bericht versturen",
       "stop": "Assistent stoppen",
       "characters": "{{count}} van {{max}} tekens",
-      "too-long": "Het bericht is te lang."
+      "too-long": "Het bericht is te lang.",
+      "status": {
+        "running": "Je kunt verder typen terwijl de assistent bezig is. Versturen is tijdelijk niet mogelijk.",
+        "waiting-for-approval": "Je kunt verder typen terwijl een actie op je goedkeuring wacht. Versturen is tijdelijk niet mogelijk."
+      }
     },
     "tool-call": {
       "label": "Toolaanroep: {{name}}",
@@ -67,6 +71,7 @@
       "arguments": "Invoer",
       "result": "Resultaat",
       "result-code": "Resultaat",
+      "tool-id": "Technisch tool-id",
       "status": {
         "running": "Bezig",
         "succeeded": "Voltooid",
@@ -77,6 +82,9 @@
     },
     "approval": {
       "title": "Goedkeuring nodig",
+      "fallback-summary": "Controleer deze actie voordat ze wordt uitgevoerd.",
+      "technical-details": "Technische details",
+      "tool-id": "Tool-id",
       "targets": "Betreft",
       "arguments": "Voorgestelde wijziging",
       "expires-in": "Verloopt over {{time}}",

package/index.d.ts

@@ -59,6 +59,16 @@ interface ToolCallPart {
     resultCode: string | null;
 }
 type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+interface ApprovalPresentationField {
+    label: string;
+    value: string;
+}
+interface ApprovalPresentation {
+    toolDisplayName: string;
+    summary: string;
+    fields: ApprovalPresentationField[];
+    notice: string | null;
+}
 interface ApprovalPart {
     type: 'approval';
     approvalId: string;
@@ -66,6 +76,8 @@ interface ApprovalPart {
     proposalHash: string;
     toolId: string;
     summary: string;
+    /** Trusted server-side presentation. Missing on old events and when no presenter handled the tool. */
+    presentation?: ApprovalPresentation | null;
     argumentsPreview: string;
     targets: string[];
     expiresAt: string;
@@ -324,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. */
@@ -529,6 +547,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;
@@ -545,10 +564,14 @@ declare class NhAssistantStore {
     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>;
@@ -578,6 +601,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();
@@ -591,6 +616,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
@@ -603,6 +629,8 @@ declare class NhAssistantStore {
     /** Asks the server to stop the running turn or to abandon a waiting approval. */
     cancel(): Promise<void>;
     clearError(): 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. */
@@ -618,6 +646,7 @@ declare class NhAssistantStore {
     private startInitialization;
     private createConversation;
     private runStream;
+    private stopLocalTurn;
     private applyEvent;
     private afterTurn;
     private reloadActiveConversation;
@@ -652,6 +681,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. */
@@ -719,6 +749,7 @@ declare class NhAssistantPanelComponent implements AfterViewInit, OnDestroy {
     readonly closed: _angular_core.Signal<boolean>;
     readonly busy: _angular_core.Signal<boolean>;
     readonly composerDisabled: _angular_core.Signal<boolean>;
+    readonly composerStatus: _angular_core.Signal<"running" | "waiting-for-approval" | null>;
     readonly errorKeys: _angular_core.Signal<string[]>;
     constructor();
     ngAfterViewInit(): void;
@@ -779,20 +810,28 @@ declare class NhAssistantThreadComponent {
 }
 
 /**
- * Message input. Enter sends, Shift+Enter inserts a new line. While the assistant runs
- * the send button becomes a stop button.
+ * Message input. Enter sends when sending is available; Shift+Enter inserts a new line.
+ * Drafting remains available while the assistant runs or waits for approval.
  */
 declare class NhAssistantComposerComponent {
-    /** Disables typing and sending, for example while a turn runs or waits for approval. */
+    /** Disables the editor only when the conversation itself cannot accept a draft. */
     readonly disabled: _angular_core.InputSignal<boolean>;
+    /** Blocks sending without disabling the editor or clearing its draft. */
+    readonly sendDisabled: _angular_core.InputSignal<boolean>;
     /** Shows the stop button instead of the send button. */
     readonly busy: _angular_core.InputSignal<boolean>;
+    /** Announces why sending is temporarily unavailable. */
+    readonly status: _angular_core.InputSignal<"running" | "waiting-for-approval" | null>;
     readonly maxLength: _angular_core.InputSignal<number | null>;
     /** Text to put back into the input, for example a message the server did not accept. */
     readonly restore: _angular_core.InputSignal<string | null>;
     readonly send: _angular_core.OutputEmitterRef<string>;
     readonly cancel: _angular_core.OutputEmitterRef<void>;
     readonly restored: _angular_core.OutputEmitterRef<void>;
+    private readonly host;
+    private readonly textarea;
+    private ownedFocus;
+    private previousBusy;
     readonly inputId: string;
     readonly hintId: string;
     readonly text: _angular_core.WritableSignal<string>;
@@ -801,11 +840,15 @@ declare class NhAssistantComposerComponent {
     readonly showCounter: _angular_core.Signal<boolean>;
     readonly canSend: _angular_core.Signal<boolean>;
     constructor();
+    onFocusIn(): void;
+    onFocusOut(event: FocusEvent): void;
     onInput(event: Event): void;
     onKeydown(event: KeyboardEvent): void;
+    onSubmit(event: SubmitEvent): void;
     submit(): void;
+    private restoreOwnedFocus;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantComposerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantComposerComponent, "nh-assistant-composer", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "restore": { "alias": "restore"; "required": false; "isSignal": true; }; }, { "send": "send"; "cancel": "cancel"; "restored": "restored"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantComposerComponent, "nh-assistant-composer", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "sendDisabled": { "alias": "sendDisabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "restore": { "alias": "restore"; "required": false; "isSignal": true; }; }, { "send": "send"; "cancel": "cancel"; "restored": "restored"; }, never, never, true, never>;
 }
 
 /** Shows one tool invocation with its status and expandable input and result previews. */
@@ -840,6 +883,7 @@ declare class NhAssistantApprovalCardComponent {
     readonly actionable: _angular_core.Signal<boolean>;
     readonly disabled: _angular_core.Signal<boolean>;
     readonly countdown: _angular_core.Signal<string>;
+    readonly presentedSummary: _angular_core.Signal<string | null>;
     constructor();
     choose(decision: ApprovalDecision): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantApprovalCardComponent, never>;
@@ -934,4 +978,4 @@ declare function nhAssistantErrorKeys(error: NhAssistantError | null): string[];
 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, 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 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 };

package/package.json

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

package/testing/index.d.ts

@@ -31,6 +31,15 @@ interface NhAssistantMockApprovalStep {
         displayName: string;
         toolVersion?: number;
         summary: string;
+        presentation?: {
+            toolDisplayName: string;
+            summary: string;
+            fields: {
+                label: string;
+                value: string;
+            }[];
+            notice: string | null;
+        } | null;
         argumentsPreview: string;
         targets: string[];
         /** Default 300 seconds. */