@newheap/platform-ai-chat 0.16.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/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.