@newheap/platform-ai-chat 0.15.0 → 0.17.0

package/README.md

@@ -288,6 +288,19 @@ custom layouts. Opened in the panel, the thread offers its proposals to the same
 **Decided by** shows the name from the subject's member snapshot (`decidedByDisplayName`)
 and falls back to the actor id.
 
+The inbox also gives an overview. `divisionId` and `runId` filter it like `agentId` and
+`subjectType`; `[grouped]="true"` groups the proposals by the parent the server recorded for each
+proposal's subject (such as a project for its tasks) and by subject, `[groupByRun]="true"` also by
+run. A group says how many of its proposals the page shows and whether it continues on another page,
+and "Select group" selects only the shown proposals the person may decide. Proposals made since the
+person's last visit of the inbox are marked new, and showing the inbox records the visit (`markNew`
+and `recordVisit`, both on by default; turn `recordVisit` off for an inbox that shows only part of
+it). `nh-assistant-run-result` lets its reader decide the run's proposals together.
+
+```html
+<nh-assistant-agent-inbox [grouped]="true" [groupByRun]="true" [divisionId]="activeDivisionId" />
+```
+
 Subjects show the name of their type (`subjectTypeName`, such as "Project") and link to where
 the application shows them (`subjectLink`, from the server's `AddSubjectType(...).OpenAt(...)`).
 A link within the application navigates through the router; an `https` link leaves it. Replace

package/admin/index.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { OnInit } from '@angular/core';
 import * as _newheap_platform_ai_chat from '@newheap/platform-ai-chat';
-import { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, ToolCatalogEntry, McpServer, RunCatalog, SetAgentStateRequest, AgentShadowMode, AgentSkillState, AgentShadowState, AssistantAutonomy, AgentEvaluation, AgentReplay, AgentEvaluationCost, AgentProposalFeedbackCategory, AgentFeedbackSummaryRow, AgentFeedbackItem, AgentFeedbackCategoryCount, StaleKind, AgentProposalFeedbackGroup, AgentSubjectType, AgentRunStatus, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunHistoryItem, DataSkill, AgentRunConfiguration, DataTrigger, SkillComparison, DataSkillVersion, ɵNhAssistantPickerOption as _NhAssistantPickerOption, McpServerTestResult, McpConnectionsSummary, McpBuiltInAuthMode, McpCustomAuthMode, McpAuthMode, McpTransport, McpConnectionScope, McpHeadlessUse, McpDiscovery, McpToolEffect, McpTool } from '@newheap/platform-ai-chat';
+import { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, ToolCatalogEntry, McpServer, RunCatalog, SetAgentStateRequest, AgentSkillState, AgentShadowMode, AgentShadowState, AssistantAutonomy, AssistantDataClassification, AgentEvaluation, AgentReplay, AgentEvaluationCost, AgentProposalFeedbackCategory, AgentFeedbackSummaryRow, AgentFeedbackItem, AgentFeedbackCategoryCount, StaleKind, AgentProposalFeedbackGroup, AgentSubjectType, AgentRunStatus, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunHistoryItem, DataSkill, AgentRunConfiguration, DataTrigger, SkillComparison, DataSkillVersion, ɵNhAssistantPickerOption as _NhAssistantPickerOption, McpServerTestResult, McpConnectionsSummary, McpBuiltInAuthMode, McpCustomAuthMode, McpAuthMode, McpTransport, McpConnectionScope, McpHeadlessUse, McpDiscovery, McpTool, McpToolEffect } from '@newheap/platform-ai-chat';
 import { ɵNhAssistantRunNowAgent as _NhAssistantRunNowAgent } from '@newheap/platform-ai-chat/agent-runs';
 
 type NhAssistantAdminTab = 'context' | 'agents' | 'mcp-servers';
@@ -127,6 +127,11 @@ declare function skillNameKeys(agentId: string, skillId: string): string[];
  * themselves in the language triage reads; the screen shows a translation when there is one.
  */
 declare function skillDescriptionKeys(agentId: string, skillId: string): string[];
+/**
+ * The key of a warning about an agent or a skill that is saved and in effect but may not work as
+ * configured, such as `classification-not-permitted`; a code the screen does not know shows as sent.
+ */
+declare function warningKeys(kind: 'agent' | 'skill', code: string): string[];
 /** The key an application may translate an authorization policy's name with. */
 declare function policyKeys(policy: string | null | undefined): string[];
 /** A readable name for a dash-case id: `task-follow-up` reads "Task follow up". */
@@ -149,9 +154,17 @@ interface WorksOnSummary {
 }
 
 type AgentStateAction = SetAgentStateRequest['state'];
+/** A state change being entered, of the agent or one of its skills, with the state it changes from. */
+interface StateChange {
+    agentId: string;
+    skillId?: string;
+    state: AgentStateAction;
+    from: AdminAgent['runState'] | AgentSkillState['runState'];
+}
 /**
  * Agent administration: code agents (override, reset) and agents created here (edit, delete),
- * and for every agent its run state with pause, stop and resume, its shadow mode and that of each
+ * and for every agent and skill its run state with pause, switch off, stop and resume (switch on
+ * for one that is off), its shadow mode and that of each
  * skill, and the technical account of an agent that answers to one, each with an optional reason.
  * Editing opens `nh-assistant-admin-agent-editor`; the feedback action opens
  * `nh-assistant-agent-feedback-report` for the agent, the evaluation action of an agent with
@@ -214,11 +227,7 @@ declare class NhAssistantAdminAgentsComponent {
     } | null>;
     readonly busyAgentId: _angular_core.WritableSignal<string | null>;
     /** The state change whose reason is being entered, of the agent or one of its skills. */
-    readonly changingState: _angular_core.WritableSignal<{
-        agentId: string;
-        skillId?: string;
-        state: AgentStateAction;
-    } | null>;
+    readonly changingState: _angular_core.WritableSignal<StateChange | null>;
     /** The shadow mode change whose reason is being entered, of the agent or one of its skills. */
     readonly changingShadow: _angular_core.WritableSignal<{
         agentId: string;
@@ -258,6 +267,7 @@ declare class NhAssistantAdminAgentsComponent {
     readonly errorKeys: _angular_core.Signal<string[]>;
     readonly codeTextKeys: typeof codeTextKeys;
     readonly skillNameKeys: typeof skillNameKeys;
+    readonly warningKeys: typeof warningKeys;
     readonly skillDescriptionKeys: typeof skillDescriptionKeys;
     readonly policyKeys: typeof policyKeys;
     readonly readableId: typeof readableId;
@@ -280,8 +290,8 @@ declare class NhAssistantAdminAgentsComponent {
     hasRunConfiguration(agent: AdminAgent): boolean;
     /**
      * Whether the agent can be run now: it runs on its own, so it has a run configuration, it is
-     * neither stopped nor disabled in code, and the run catalog names what it can run on. The server
-     * decides the rest when the run starts.
+     * neither stopped nor disabled in code, and the run catalog names what it can run on. An agent
+     * that is off still runs for a person. The server decides the rest when the run starts.
      */
     canRunNow(agent: AdminAgent): boolean;
     /** Opens the run-now dialog of the agent. */
@@ -332,6 +342,13 @@ declare class NhAssistantAdminAgentsComponent {
     stateActions(agent: AdminAgent): AgentStateAction[];
     /** The state changes a skill allows. */
     skillActions(skill: AgentSkillState): AgentStateAction[];
+    /**
+     * The key of a state change's label, explanation or confirmation: making an agent or skill that is
+     * off active again switches it on, which replays nothing, unlike a resume.
+     */
+    stateKey(part: 'action' | 'explain' | 'confirm', from: string, action: AgentStateAction): string;
+    /** The explanation of a state change of one skill. */
+    skillStateExplainKey(change: StateChange): string;
     /** Opens the reason form of a state change of the agent or, with a skill, of that skill. */
     askState(agent: AdminAgent, state: AgentStateAction, skill?: AgentSkillState): void;
     /**
@@ -435,6 +452,7 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly id: string;
     readonly max = 20000;
     readonly autonomyLevels: readonly AssistantAutonomy[];
+    readonly classifications: readonly AssistantDataClassification[];
     readonly agentId: _angular_core.WritableSignal<string>;
     readonly displayName: _angular_core.WritableSignal<string>;
     readonly description: _angular_core.WritableSignal<string>;
@@ -442,6 +460,12 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly autonomy: _angular_core.WritableSignal<AssistantAutonomy>;
     /** How the agent is used: in the chat, on its own, or both. */
     readonly use: _angular_core.WritableSignal<AgentUse>;
+    /** A new agent takes its triggers at once; without it, it starts off until someone switches it on. */
+    readonly switchOnNow: _angular_core.WritableSignal<boolean>;
+    /** The model profile of an agent created here; empty uses the application's chat profile. */
+    readonly profile: _angular_core.WritableSignal<string>;
+    /** The classification of the model calls of an agent created here; `internal` when it has none. */
+    readonly dataClassification: _angular_core.WritableSignal<AssistantDataClassification>;
     readonly requiredPolicy: _angular_core.WritableSignal<string>;
     readonly toolSelectors: _angular_core.WritableSignal<string[]>;
     readonly mcpServerIds: _angular_core.WritableSignal<string[]>;
@@ -498,10 +522,17 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly knownTypes: _angular_core.Signal<string[]>;
     /** What the agent works on is edited here: an agent created here, while the run catalog is known. */
     readonly editsWorksOn: _angular_core.Signal<boolean>;
+    /** An agent created here chooses its profile from those the run catalog offers. */
+    readonly choosesProfile: _angular_core.Signal<boolean>;
+    /** The profiles the run catalog offers, and the agent's own when the catalog no longer lists it. */
+    readonly profileChoices: _angular_core.Signal<string[]>;
     /** Chosen object types without a type, and not the application either: the agent would work on nothing. */
     readonly worksOnMissing: _angular_core.Signal<boolean>;
     readonly tooManyTypes: _angular_core.Signal<boolean>;
     readonly policyKeys: typeof policyKeys;
+    readonly warningKeys: typeof warningKeys;
+    /** The warnings of the agent as it was saved, until this editor saves it again. */
+    readonly warnings: _angular_core.Signal<_newheap_platform_ai_chat.AssistantConfigurationWarning[]>;
     readonly valid: _angular_core.Signal<boolean>;
     readonly errorKeys: _angular_core.Signal<string[]>;
     readonly filteredTools: _angular_core.Signal<ToolCatalogEntry[]>;
@@ -845,6 +876,7 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     readonly id: string;
     readonly maxReason: 500;
     readonly skillNameKeys: typeof skillNameKeys;
+    readonly warningKeys: typeof warningKeys;
     readonly skillDescriptionKeys: typeof skillDescriptionKeys;
     readonly readableId: typeof readableId;
     readonly loading: _angular_core.WritableSignal<boolean>;
@@ -855,6 +887,8 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
     readonly errorKeys: _angular_core.Signal<string[]>;
     readonly saved: _angular_core.WritableSignal<string | null>;
+    /** The warnings of the skill that was just saved, shown with the saved message. */
+    readonly savedWarnings: _angular_core.WritableSignal<readonly string[]>;
     readonly form: _angular_core.WritableSignal<Form | null>;
     readonly confirming: _angular_core.WritableSignal<Confirmation | null>;
     readonly reason: _angular_core.WritableSignal<string>;
@@ -1036,12 +1070,35 @@ declare class NhAssistantAdminMcpServersComponent {
 type NhAssistantSecretAction = 'keep' | 'replace' | 'clear';
 /** Where the secret is: stored here, encrypted, or a reference to a secret of the application. */
 type NhAssistantSecretSource = 'stored' | 'reference';
+/**
+ * One reader as the editor shows it: the tool, the media types as typed (separated by commas, spaces
+ * or new lines), the highest classification and the priority as typed. `key` keeps a row's controls
+ * when another row is removed.
+ */
+interface NhAssistantReaderDraft {
+    key: number;
+    toolName: string;
+    mediaTypes: string;
+    maxClassification: AssistantDataClassification | '';
+    priority: string;
+}
+/** What is wrong with one reader before it is saved. */
+interface ReaderProblems {
+    types: boolean;
+    tool: boolean;
+    duplicate: boolean;
+    classification: boolean;
+    priority: boolean;
+}
 /**
  * Creates or edits one MCP server: the authentication with a write-only secret or a reference to
  * one, OAuth with discovery the administrator confirms, an optional client certificate, the
- * transport and the use in background runs. Every field stops at the length the server accepts; a
- * refused save shows each of the server's field errors at its field, for example a secret reference
- * the application cannot resolve (`not-found`), and moves the focus to the first of them.
+ * transport, the use in background runs and, for a server that exists, its readers: per reader the
+ * synced tool that turns files into text, the media types it reads, the highest classification that
+ * may be sent to it and its priority, with readers to add and remove. Every field stops at the length
+ * the server accepts; a refused save shows each of the server's field errors at its field, those of a
+ * reader at that reader (`readers[0].toolName`), for example a secret reference the application cannot
+ * resolve (`not-found`), and moves the focus to the first of them.
  */
 declare class NhAssistantAdminMcpServerEditorComponent {
     private readonly admin;
@@ -1050,6 +1107,7 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     private subscription?;
     private discoverySubscription?;
     private modesSubscription?;
+    private toolsSubscription?;
     /** Fields whose server error the administrator changed since the refused save. */
     private readonly touched;
     /** The server to edit, or null for a new server. */
@@ -1080,6 +1138,7 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     readonly transports: readonly McpTransport[];
     readonly secretSources: readonly NhAssistantSecretSource[];
     readonly connectionScopes: readonly McpConnectionScope[];
+    readonly classifications: readonly AssistantDataClassification[];
     readonly serverId: _angular_core.WritableSignal<string>;
     readonly displayName: _angular_core.WritableSignal<string>;
     readonly url: _angular_core.WritableSignal<string>;
@@ -1110,6 +1169,15 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     readonly discovering: _angular_core.WritableSignal<boolean>;
     readonly discoveryError: _angular_core.WritableSignal<NhAssistantError | null>;
     readonly confirmAuthorization: _angular_core.WritableSignal<boolean>;
+    /** The readers of the server as the editor shows them, in their order. */
+    readonly readers: _angular_core.WritableSignal<readonly NhAssistantReaderDraft[]>;
+    readonly maxReaders = 16;
+    readonly readerPriority: {
+        readonly min: -1000;
+        readonly max: 1000;
+    };
+    /** The server's synced tools, which can read files; empty until they are loaded. */
+    readonly readerTools: _angular_core.WritableSignal<readonly McpTool[]>;
     readonly submitted: _angular_core.WritableSignal<boolean>;
     readonly saving: _angular_core.WritableSignal<boolean>;
     readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
@@ -1161,6 +1229,13 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     readonly certificateInvalid: _angular_core.Signal<boolean>;
     readonly oauthInvalid: _angular_core.Signal<boolean>;
     readonly headerNameInvalid: _angular_core.Signal<boolean>;
+    /** The tool names to choose from, keeping the stored tools the list no longer holds selectable. */
+    readonly readerToolNames: _angular_core.Signal<string[]>;
+    /** What is wrong with each reader, in the order of `readers`. */
+    readonly readerProblems: _angular_core.Signal<readonly ReaderProblems[]>;
+    /** Why a reader can or cannot be added: the server's tools are not synced, or it has the most. */
+    readonly readerAddHint: _angular_core.Signal<"nh-assistant.admin.server-editor.reader.tool-sync" | "nh-assistant.admin.server-editor.reader.limit" | "nh-assistant.admin.server-editor.reader.add-hint">;
+    readonly readerInvalid: _angular_core.Signal<boolean>;
     readonly valid: _angular_core.Signal<boolean>;
     readonly errorKeys: _angular_core.Signal<string[]>;
     /** The server's first error per field of the refused save, until the administrator changes the field. */
@@ -1179,6 +1254,17 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     serverErrorKeys(field: string): string[];
     /** The id of a field's error, for `aria-describedby`. */
     errorId(field: string): string;
+    /** The name of a reader's field in the server's errors, such as `readers[0].toolName`. */
+    readerField(index: number, field: 'mediaTypes' | 'toolName' | 'maxClassification' | 'priority'): string;
+    /** Adds an empty reader at the end, at priority 0, and moves the focus to its tool. */
+    addReader(): void;
+    /**
+     * Removes a reader and moves the focus to the button that adds one; the server's errors of the
+     * readers no longer match their positions.
+     */
+    removeReader(index: number): void;
+    /** Changes one field of a reader as the administrator typed or chose it. */
+    updateReader(index: number, field: 'toolName' | 'mediaTypes' | 'maxClassification' | 'priority', value: string): void;
     /** The ids a control describes itself with: its hint and, while the server refused it, its error. */
     describedBy(hintId: string | null, field: string): string | null;
     /** The administrator changed a field; its server error no longer applies. */
@@ -1195,8 +1281,15 @@ declare class NhAssistantAdminMcpServerEditorComponent {
     discover(): void;
     save(): void;
     private focusFirstInvalid;
+    private focusById;
     private valueKeys;
+    /** Whether the editor shows a field error at a reader's own field. */
+    private showsReaderField;
+    /** The server's errors of the readers no longer apply once a reader is added or removed. */
+    private forgetReaderErrors;
     private reset;
+    /** The synced tools of an existing server, to choose the reading tool from. */
+    private loadReaderTools;
     /**
      * The OAuth settings as the editor shows them: every value is sent, so an emptied field clears the
      * stored value. The client secret is write-only: sent only when replaced.
@@ -1251,4 +1344,4 @@ declare class NhAssistantAdminMcpToolsComponent {
 }
 
 export { NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentRunConfigurationComponent, NhAssistantAgentRunHistoryComponent, nhAssistantSelectorMatches };
-export type { AgentUse, NhAssistantAdminTab, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantSecretAction, NhAssistantSecretSource, WorksOnScope };
+export type { AgentUse, NhAssistantAdminTab, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantReaderDraft, NhAssistantSecretAction, NhAssistantSecretSource, WorksOnScope };

package/agent-runs/index.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import * as _newheap_platform_ai_chat from '@newheap/platform-ai-chat';
-import { AgentProposal, AgentThreadLookup, AgentTriggerReceipt, NhAssistantError, AgentProposalDecisionRight, AgentProposalFeedback, AgentProposalOrigin, AgentProposalDecision, AgentExecutionResolution, AgentSubjectRole, AgentRun, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunRetryMode, AgentThreadMemory, AgentArtifact, AgentConsultation, AgentSubjectWork, AgentSubjectWorkAgent, AgentSubjectType, ɵNhAssistantPickerOption as _NhAssistantPickerOption, NhAssistantAgentRunApiService, AgentObjectAgents, AgentObjectAgent, AgentRunResult, AgentBoard, AgentBoardAgent } from '@newheap/platform-ai-chat';
+import { AgentProposal, AgentInboxGroup, AgentThreadLookup, AgentTriggerReceipt, NhAssistantError, AgentProposalDecisionRight, AgentProposalFeedback, AgentProposalOrigin, AgentProposalDecision, AgentExecutionResolution, AgentSubjectRole, AgentRun, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunRetryMode, AgentThreadMemory, AgentArtifact, AgentConsultation, AgentSubjectWork, AgentSubjectWorkAgent, AgentSubjectType, ɵNhAssistantPickerOption as _NhAssistantPickerOption, NhAssistantAgentRunApiService, AgentObjectAgents, AgentObjectAgent, AgentRunResult, AgentBoard, AgentBoardAgent } from '@newheap/platform-ai-chat';
 import { Observable } from 'rxjs';
 
 /**
@@ -14,15 +14,49 @@ import { Observable } from 'rxjs';
  * longer fits, for example because someone did the work by hand, stays as a closed card with the
  * reason until it is dismissed. A proposal a run placed at its object from another subject, such as a
  * run for the whole application, names that run; `openConversation` emits its conversation.
+ *
+ * `agentId`, `subjectType`, `divisionId` and `runId` filter the inbox; changing a filter, or `grouped`,
+ * reloads it from the first page. With `grouped` the inbox shows the proposals per parent, such as a
+ * project with its own proposals and those of its tasks, and per subject, optionally per run
+ * (`groupByRun`); a group that goes on on another page says so, and "Select group" selects only its
+ * proposals shown here. With `markNew` (on by default) it marks the proposals made since the person's
+ * last visit of the inbox in its scope, the whole application or the division of `divisionId`, and
+ * those that arrive while it is shown; with `recordVisit` (on by default) showing it records the
+ * visit. Turn `recordVisit` off for an inbox that shows only part of the scope, such as one agent's
+ * proposals, so the person's next visit of the whole inbox still marks what they have not seen.
  */
 declare class NhAssistantAgentInboxComponent {
     private readonly api;
     private readonly proposalList;
     private subscription?;
+    private visitSubscription?;
+    /** The scope whose visit this view recorded; the visit is recorded once per scope shown. */
+    private visited;
+    /**
+     * What the first read of the shown scope found: the visit before this one and the proposals that
+     * were new since. Later reads, after live updates, paging or a decision, compare with both, so what
+     * was new when the inbox was opened stays new while it is shown.
+     */
+    private opened;
     /** Limits the inbox to one agent. */
     readonly agentId: _angular_core.InputSignal<string | undefined>;
     /** Limits the inbox to one kind of subject, for example `project`. */
     readonly subjectType: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Limits the inbox to the subjects of one division, for example the active division; its visits are
+     * then those of that division.
+     */
+    readonly divisionId: _angular_core.InputSignal<string | null | undefined>;
+    /** Limits the inbox to the proposals of one run. */
+    readonly runId: _angular_core.InputSignal<string | null | undefined>;
+    /** Groups the proposals per parent and subject instead of listing them by expiry alone. */
+    readonly grouped: _angular_core.InputSignal<boolean>;
+    /** In a grouped inbox, also shows a header per run within a subject. */
+    readonly groupByRun: _angular_core.InputSignal<boolean>;
+    /** Marks the proposals made since the person's last visit of the inbox, and those that arrive while it is shown. */
+    readonly markNew: _angular_core.InputSignal<boolean>;
+    /** Records the person's visit of the inbox in its scope when it is shown. */
+    readonly recordVisit: _angular_core.InputSignal<boolean>;
     readonly itemsPerPage: _angular_core.InputSignal<number>;
     /**
      * Emits the conversation of the run that placed a proposal at its object from another subject, so
@@ -36,6 +70,15 @@ declare class NhAssistantAgentInboxComponent {
     readonly loadFailed: _angular_core.WritableSignal<boolean>;
     readonly items: _angular_core.WritableSignal<AgentProposal[]>;
     readonly total: _angular_core.WritableSignal<number>;
+    /** The groups of the page in a grouped inbox; `null` for the flat inbox. */
+    readonly groups: _angular_core.WritableSignal<AgentInboxGroup[] | null>;
+    /** The proposals of the page marked as new. */
+    readonly newIds: _angular_core.WritableSignal<ReadonlySet<string>>;
+    /**
+     * The person's visit of the shown scope before the inbox was opened: `null` before their first
+     * visit, `undefined` while unknown or when new proposals are not marked.
+     */
+    readonly previousVisit: _angular_core.WritableSignal<string | null | undefined>;
     readonly pages: _angular_core.Signal<number>;
     constructor();
     load(): void;
@@ -47,8 +90,19 @@ declare class NhAssistantAgentInboxComponent {
      */
     private refresh;
     private fetch;
+    /**
+     * Marks what is new: what the server marks since the visit this view recorded, and what was made
+     * after the person's visit before the inbox was opened, on any page. Before the first visit
+     * everything is new. A server without visits marks nothing.
+     */
+    private markNewOf;
+    /**
+     * Records the visit of the shown scope after its first read, so that read still marks what arrived
+     * since the visit before.
+     */
+    private recordVisitOf;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentInboxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentInboxComponent, "nh-assistant-agent-inbox", never, { "agentId": { "alias": "agentId"; "required": false; "isSignal": true; }; "subjectType": { "alias": "subjectType"; "required": false; "isSignal": true; }; "itemsPerPage": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; }, { "openConversation": "openConversation"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentInboxComponent, "nh-assistant-agent-inbox", never, { "agentId": { "alias": "agentId"; "required": false; "isSignal": true; }; "subjectType": { "alias": "subjectType"; "required": false; "isSignal": true; }; "divisionId": { "alias": "divisionId"; "required": false; "isSignal": true; }; "runId": { "alias": "runId"; "required": false; "isSignal": true; }; "grouped": { "alias": "grouped"; "required": false; "isSignal": true; }; "groupByRun": { "alias": "groupByRun"; "required": false; "isSignal": true; }; "markNew": { "alias": "markNew"; "required": false; "isSignal": true; }; "recordVisit": { "alias": "recordVisit"; "required": false; "isSignal": true; }; "itemsPerPage": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; }, { "openConversation": "openConversation"; }, never, never, true, never>;
 }
 
 type NhAssistantAgentThreadTab = 'proposals' | 'runs' | 'consultations' | 'memory' | 'artifacts';
@@ -109,6 +163,45 @@ declare class NhAssistantAgentThreadViewComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentThreadViewComponent, "nh-assistant-agent-thread-view", never, { "agentId": { "alias": "agentId"; "required": true; "isSignal": true; }; "subjectType": { "alias": "subjectType"; "required": true; "isSignal": true; }; "subjectId": { "alias": "subjectId"; "required": true; "isSignal": true; }; }, { "openConversation": "openConversation"; }, never, never, true, never>;
 }
 
+/** The proposals of one run within a subject of a grouped list, in the order the list gave them. */
+interface NhAssistantRunSection {
+    key: string;
+    runId: string | null;
+    agentId: string;
+    /** When the run's first proposal on the page was made. */
+    proposedAt: string;
+    items: AgentProposal[];
+}
+/** One subject within a group of a grouped list. */
+interface NhAssistantSubjectSection {
+    key: string;
+    subjectType: string;
+    subjectId: string;
+    label: string;
+    typeName: string | null;
+    link: string | null;
+    /** The group's own subject, whose proposals stand directly under the group's header. */
+    own: boolean;
+    count: number;
+    total: number;
+    runs: NhAssistantRunSection[];
+}
+/** One group of a grouped list, such as a parent subject of the grouped inbox. */
+interface NhAssistantGroupSection {
+    key: string;
+    subjectType: string;
+    subjectId: string;
+    label: string;
+    typeName: string | null;
+    link: string | null;
+    count: number;
+    total: number;
+    continuesFromPreviousPage: boolean;
+    continuesOnNextPage: boolean;
+    subjects: NhAssistantSubjectSection[];
+    /** The group's pending proposals on this page that the caller may decide: what "Select group" selects. */
+    selectableIds: string[];
+}
 /** A feedback question: after a rejection above the list, or from a card's own action. */
 interface NhAssistantFeedbackRequest {
     approvalIds: string[];
@@ -132,7 +225,10 @@ interface NhAssistantFeedbackRequest {
  * replaced, as a closed card when it closes while shown, or when an approval is refused because of
  * it, until the person dismisses it. It reads those proposals by id with one lookup, never through
  * their threads. A proposal that a run placed here from another subject, such as a run for the whole
- * application, says so and offers that run's conversation through `openConversation`.
+ * application, says so and offers that run's conversation through `openConversation`. With `groups`
+ * from the grouped inbox the list shows a header per group and per subject, optionally per run
+ * (`groupByRun`), and "Select group" selects only the group's pending proposals in this list that
+ * the caller may decide, never those on another page. `newIds` marks proposals as new.
  */
 declare class NhAssistantAgentProposalsComponent {
     private readonly api;
@@ -154,6 +250,16 @@ declare class NhAssistantAgentProposalsComponent {
      * it closes.
      */
     readonly holdClosedCards: _angular_core.InputSignal<boolean>;
+    /**
+     * The groups of the grouped inbox (`AgentInbox.groups`) for `proposals` in the order the inbox gave
+     * them: the first `count` proposals belong to the first group, and so on. Without groups, or when
+     * they do not describe `proposals`, the list is flat.
+     */
+    readonly groups: _angular_core.InputSignal<readonly AgentInboxGroup[] | null>;
+    /** Shows a header per run within a subject of a grouped list. */
+    readonly groupByRun: _angular_core.InputSignal<boolean>;
+    /** Proposals to mark as new, by approval id, for example those made since the last visit of the inbox. */
+    readonly newIds: _angular_core.InputSignal<ReadonlySet<string> | null>;
     /** Emits after a proposal or its feedback changed, so the host reloads its list. */
     readonly changed: _angular_core.OutputEmitterRef<void>;
     /**
@@ -175,6 +281,11 @@ declare class NhAssistantAgentProposalsComponent {
     /** The held closed cards first, then the proposals the host gave. */
     readonly shown: _angular_core.Signal<AgentProposal[]>;
     private readonly lookups;
+    /**
+     * The grouped list: the held closed cards stay above it; `null` for a flat list, or when the groups
+     * do not describe the proposals.
+     */
+    readonly sections: _angular_core.Signal<NhAssistantGroupSection[] | null>;
     constructor();
     /**
      * The translation key of a proposal's status: the kind of a stale proposal, "replaced" for a
@@ -189,6 +300,16 @@ declare class NhAssistantAgentProposalsComponent {
         key: string;
         params: Record<string, string>;
     };
+    /** Whether the proposal is marked as new. */
+    isNew(proposal: AgentProposal): boolean;
+    /** Whether every proposal "Select group" would select in the group is selected. */
+    groupSelected(group: NhAssistantGroupSection): boolean;
+    /**
+     * Selects the group's pending proposals in this list that the caller may decide, or deselects them
+     * when all are selected. Proposals of the group on another page are never selected: an approver
+     * decides only what they see.
+     */
+    toggleGroup(group: NhAssistantGroupSection): void;
     /** True when the newer proposal that replaced this one is in the list. */
     hasSuccessor(proposal: AgentProposal): boolean;
     /** Moves focus to the newer proposal that replaced this one. */
@@ -224,6 +345,7 @@ declare class NhAssistantAgentProposalsComponent {
     onFeedbackSaved(): void;
     /** Closes the question; from a card, focus returns to the card's feedback action. */
     onFeedbackDismissed(): void;
+    private groupSection;
     private ask;
     /**
      * Reads `proposals` again by id and keeps those that closed as stale or were replaced as closed
@@ -232,7 +354,7 @@ declare class NhAssistantAgentProposalsComponent {
     private holdStale;
     private run;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentProposalsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentProposalsComponent, "nh-assistant-agent-proposals", never, { "proposals": { "alias": "proposals"; "required": true; "isSignal": true; }; "canDecide": { "alias": "canDecide"; "required": false; "isSignal": true; }; "decisionRights": { "alias": "decisionRights"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "holdClosedCards": { "alias": "holdClosedCards"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "openConversation": "openConversation"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentProposalsComponent, "nh-assistant-agent-proposals", never, { "proposals": { "alias": "proposals"; "required": true; "isSignal": true; }; "canDecide": { "alias": "canDecide"; "required": false; "isSignal": true; }; "decisionRights": { "alias": "decisionRights"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "holdClosedCards": { "alias": "holdClosedCards"; "required": false; "isSignal": true; }; "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "groupByRun": { "alias": "groupByRun"; "required": false; "isSignal": true; }; "newIds": { "alias": "newIds"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "openConversation": "openConversation"; }, never, never, true, never>;
 }
 
 /**
@@ -690,11 +812,18 @@ interface RunDuration {
  * its object, for the whole application the agent's view policy, administrators every run. The
  * thread view's run timeline and the administration's runs view open it; an application may show
  * it anywhere with a run id. With live updates it reloads by itself while the run works.
+ *
+ * The run's pending proposals that the reader may decide, by the same live check as the inbox and the
+ * subject's work (`POST approvals/lookup`), can be decided in place, one by one or selected together
+ * with "Select all"; a pending proposal the reader may not decide says who does, and a reader who may
+ * decide none sees no selection. After a rejection the list asks, optionally, what was wrong, and a
+ * proposal refused because it no longer fits stays as a closed card with the reason until dismissed.
  */
 declare class NhAssistantRunResultComponent {
     private readonly api;
     private readonly document;
     private subscription?;
+    private rightsSubscription?;
     /** The run to show. */
     readonly runId: _angular_core.InputSignal<string>;
     /**
@@ -718,11 +847,25 @@ declare class NhAssistantRunResultComponent {
     /** The text of the download's failure, then the text that a file could not be downloaded. */
     readonly downloadErrorKeys: _angular_core.Signal<string[]>;
     readonly codeKeys: typeof _nhAssistantCodeKeys;
+    /**
+     * The reader's live right to decide each pending proposal of the run, by approval id; `null` until
+     * it is known, when nobody may decide.
+     */
+    readonly rights: _angular_core.WritableSignal<ReadonlyMap<string, AgentProposalDecisionRight> | null>;
+    /** Whether the reader may decide at least one of the run's proposals: only then can they select. */
+    readonly decidable: _angular_core.Signal<boolean>;
     readonly duration: _angular_core.Signal<RunDuration | null>;
     readonly tokens: _angular_core.Signal<number>;
     constructor();
     load(): void;
+    /** A proposal was decided or its feedback given: the run's proposals and the rights are read again. */
+    onProposalsChanged(): void;
     download(artifact: AgentArtifact): Promise<void>;
+    /**
+     * Reads the reader's live right to decide each pending proposal of the run, as the server checks it
+     * for every decision. Without an answer nobody may decide here; the server checks again anyway.
+     */
+    private readRights;
     /**
      * Reads the run. A quiet reload, after a live update, keeps what is shown when it fails and shows
      * no loading state.