@newheap/platform-ai-chat 0.17.0 → 0.19.0

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, 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 { AgentProposal, AgentInboxGroup, AgentThreadLookup, AgentProposalDecisionRight, AgentTriggerReceipt, NhAssistantError, AgentProposalFeedback, AgentProposalOrigin, AgentProposalDecision, AgentExecutionResolution, AgentSubjectRole, AgentRun, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunRetryMode, AgentThreadMemory, AgentArtifact, AgentConsultation, NhAssistantConsultationRoute, AgentSubjectWork, AgentSubjectWorkAgent, AgentSubjectType, ɵNhAssistantPickerOption as _NhAssistantPickerOption, NhAssistantAgentRunApiService, AgentObjectAgents, AgentObjectAgent, AgentRunResult, AgentBoard, AgentBoardAgent } from '@newheap/platform-ai-chat';
 import { Observable } from 'rxjs';
 
 /**
@@ -118,6 +118,7 @@ declare class NhAssistantAgentThreadViewComponent {
     private readonly proposalList;
     private subscription?;
     private proposalSubscription?;
+    private rightsSubscription?;
     private startSubscription?;
     readonly agentId: _angular_core.InputSignal<string>;
     readonly subjectType: _angular_core.InputSignal<string>;
@@ -132,6 +133,13 @@ declare class NhAssistantAgentThreadViewComponent {
     readonly loadFailed: _angular_core.WritableSignal<boolean>;
     readonly lookup: _angular_core.WritableSignal<AgentThreadLookup | null>;
     readonly proposals: _angular_core.WritableSignal<AgentProposal[]>;
+    /**
+     * The caller's live right to decide each pending proposal, as the server checks it for the decision:
+     * four-eyes keeps the person who asked for a consultation's proposal out, also as an approver, and
+     * nobody decides here what the asker decides in their own chat. Without an answer the caller's role
+     * decides what is offered; the server checks every decision again.
+     */
+    readonly rights: _angular_core.WritableSignal<ReadonlyMap<string, AgentProposalDecisionRight> | null>;
     readonly message: _angular_core.WritableSignal<string>;
     readonly starting: _angular_core.WritableSignal<boolean>;
     readonly receipt: _angular_core.WritableSignal<AgentTriggerReceipt | null>;
@@ -159,6 +167,11 @@ declare class NhAssistantAgentThreadViewComponent {
     private refresh;
     private fetch;
     private fetchProposals;
+    /**
+     * Reads the caller's live right to decide each pending proposal, in batches of
+     * `NH_ASSISTANT_MAX_PROPOSAL_LOOKUP`, as the run result and the subject's work do.
+     */
+    private readRights;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentThreadViewComponent, never>;
     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>;
 }
@@ -228,7 +241,10 @@ interface NhAssistantFeedbackRequest {
  * 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.
+ * the caller may decide, never those on another page. `newIds` marks proposals as new. A proposal of
+ * a consultation names who asked and its route: one the person who asked decides in their own chat
+ * (`asker-decides`) waits for them without actions here; one that runs with the agent's own rights
+ * (`subject-agent-rights`) says so, and the person who asked reads why another approver decides.
  */
 declare class NhAssistantAgentProposalsComponent {
     private readonly api;
@@ -323,18 +339,38 @@ declare class NhAssistantAgentProposalsComponent {
      * the shown pending proposals that left the list because they closed as stale or were replaced.
      */
     holdClosed(previous: readonly AgentProposal[], next: readonly AgentProposal[]): void;
-    /** Whether the caller may decide this proposal: its own right when one was given, otherwise `canDecide`. */
+    /**
+     * Whether the caller may decide this proposal: its own right when one was given, otherwise
+     * `canDecide`. Nobody decides a proposal here that the person who asked decides in their own chat.
+     */
     mayDecide(proposal: AgentProposal): boolean;
+    /**
+     * Whether a pending proposal of a consultation waits for the person who asked, who decides it in
+     * their own chat: its route says so, or the server's reason for the caller's right.
+     */
+    waitsForAsker(proposal: AgentProposal): boolean;
     /**
      * Who decides a pending proposal that has a right the caller lacks: another approver when
-     * four-eyes keeps out the person who started the work, otherwise an approver.
+     * four-eyes keeps out the person who started the work, which for a consultation's proposal that
+     * runs with the agent's own rights is the person who asked, otherwise an approver. A proposal that
+     * waits for the person who asked says so on its own (`waitsForAsker`).
      */
     waitingForKey(proposal: AgentProposal): string | null;
+    /**
+     * The badge of a consultation's proposal that runs with the agent's own rights: those of a technical
+     * account when the agent answers to one, otherwise the agent's own; `null` for other proposals.
+     */
+    agentRightsKey(proposal: AgentProposal): string | null;
     toggle(proposal: AgentProposal): void;
     toggleAll(): void;
     decide(proposal: AgentProposal, decision: AgentProposalDecision): void;
     decideSelected(decision: AgentProposalDecision): void;
     resolve(proposal: AgentProposal, action: AgentExecutionResolution): void;
+    /**
+     * Whether the application executes the proposal: it was handed to the application, so an approver
+     * resolves an unknown outcome by handing it to the application again instead of running it.
+     */
+    executedByApplication(proposal: AgentProposal): boolean;
     /** Opens the feedback question in the card of a closed proposal, with the caller's own feedback. */
     giveFeedback(proposal: AgentProposal): void;
     /** True while the feedback question for this proposal is open, above the list or in its card. */
@@ -455,9 +491,9 @@ declare class NhAssistantAgentArtifactsComponent {
 
 /**
  * Who consulted the thread's agent through another assistant, newest first: the person whose rights
- * were used, the asking assistant, the outcome, the usage and the proposals left for approvers. The
- * question and the answer stay in the asking conversation and are never shown here. With live
- * updates the list reloads by itself when a run or proposal of the thread changes.
+ * were used, the asking assistant, the outcome, the usage and the proposals it left, with their
+ * number per route. The question and the answer stay in the asking conversation and are never shown
+ * here. With live updates the list reloads by itself when a run or proposal of the thread changes.
  */
 declare class NhAssistantAgentConsultationsComponent {
     private readonly api;
@@ -470,6 +506,11 @@ declare class NhAssistantAgentConsultationsComponent {
     readonly codeKeys: typeof _nhAssistantCodeKeys;
     constructor();
     load(): void;
+    /** The proposals the consultation left per route, in a fixed order; routes without proposals are left out. */
+    routeCounts(consultation: AgentConsultation): {
+        route: NhAssistantConsultationRoute;
+        count: number;
+    }[];
     /** A quiet load, after a live update, shows no loading state and keeps the list when it fails. */
     private fetch;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentConsultationsComponent, never>;