@newheap/platform-ai-chat 0.17.0 → 0.18.0

package/README.md

@@ -148,7 +148,9 @@ caller may decide each one. `NhAssistantStore.approvalRights` turns that into a
 approval card, `decide(decision, reason, approvalId)` decides a run's proposal with its
 proposal hash through `POST approvals/{id}/decisions` and reloads the thread, and cards
 the caller may not decide say who does (`waitingFor`: an approver, or another approver
-under four-eyes). Messages a trigger wrote (`authorKind: 'trigger'`) read as an event.
+under four-eyes). Messages a trigger wrote (`authorKind: 'trigger'`) read as an event, and
+messages the application posted (`role: 'application'`) as the application's, with their sender,
+title, Markdown text and a link within the application or to an `https` address.
 Custom layouts pass `[approvalRights]` to `nh-assistant-thread` and handle
 `(approvalChoice)`, which carries the approval id.
 
@@ -328,6 +330,14 @@ run for the whole application instead of a set of objects (sent as `subjectSet:
 division for an agent that works per division); the trigger list names it, and subject links name the
 whole application (`nh-system`, `isSystem` in the run catalog) once.
 
+An agent's run configuration lists its consultations: those in code read only, and those defined as
+data, which administrators add, change and remove within the agent's `consultationCeiling`
+(`saveDataConsultation`, `removeDataConsultation`), with only the routes, requests and limits that
+ceiling and the agent allow. Each consultation names the agents that ask it, with a link to their
+editors, and its problems; the route switches turn a route off for all consultations of the agent, and
+the flow's "When it runs" step names them. The mock API plays them with the scenario's
+`consultationsAsData`, an agent's `consultableAsData` and its `dataConsultations`.
+
 With live updates the inbox, the thread view and its tabs reload by themselves when the hub
 reports `AgentWorkChanged` for work they show, debounced, and after every reconnect. The
 update names the thread, its subject (`subjectType`, `subjectId`) and whether a run, a

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, 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 { 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, NhAssistantConsultationRoute, DataConsultation, CodeConsultation, 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';
@@ -317,6 +317,12 @@ declare class NhAssistantAdminAgentsComponent {
     onWorkRequested(agent: AdminAgent): void;
     /** The flow of the agent's run configuration opens the editor; saving or cancelling returns there. */
     editFromRunConfiguration(agent: AdminAgent): void;
+    /**
+     * A consultation of the agent's run configuration opens the editor of an agent that asks it, whose
+     * tool selectors are the consultation's second key; saving or cancelling returns to the run
+     * configuration it came from.
+     */
+    askerFromRunConfiguration(agent: AdminAgent, askerId: string): void;
     /** The flow of the agent's run configuration opens its runs; going back returns there. */
     runsFromRunConfiguration(agent: AdminAgent): void;
     /** The flow of an agent in code opens the form that replaces its technical account on its card. */
@@ -325,7 +331,11 @@ declare class NhAssistantAdminAgentsComponent {
     onEditorSaved(agent: AdminAgent): void;
     /** The editor closed without saving: back to the run configuration that opened it, or to the list. */
     onEditorCancelled(): void;
-    /** Opens the run configuration again when its flow opened what closes now; `false` otherwise. */
+    /**
+     * Opens the run configuration again when its flow, or one of its consultations, opened what closes
+     * now; `false` otherwise. The editor of an agent that asks a consultation returns to the consulted
+     * agent's run configuration.
+     */
     private returnToRunConfiguration;
     /** What the agent works on, with its object types named as the run catalog names them. */
     worksOn(agent: AdminAgent): WorksOnSummary & {
@@ -787,6 +797,35 @@ declare class NhAssistantAgentRunHistoryComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentRunHistoryComponent, "nh-assistant-agent-run-history", never, { "agentId": { "alias": "agentId"; "required": true; "isSignal": true; }; "subjectTypes": { "alias": "subjectTypes"; "required": false; "isSignal": true; }; }, { "openConversation": "openConversation"; }, never, never, true, never>;
 }
 
+/** One consultation as the section and the flow list it: in code or defined as data. */
+interface ConsultationRow {
+    subjectType: string;
+    origin: 'code' | 'data';
+    description: string | null;
+    /** The routes in effect: those code allows, or those of the data that still fit. */
+    routes: NhAssistantConsultationRoute[];
+    /** It generates the request tool now. */
+    requests: boolean;
+    /** MCP clients see its tools. */
+    mcp: boolean;
+    consultToolId: string;
+    /** The agents whose tool selectors select its consult tool now. */
+    askingAgents: string[];
+    inEffect: boolean;
+    problems: string[];
+    /** The consultation defined as data; `null` for one in code. */
+    data: DataConsultation | null;
+    code: CodeConsultation | null;
+}
+/**
+ * Why administrators cannot add a consultation to the agent now, or `null` when they can:
+ * `application` when the application does not let them define consultations, `agent` when the agent
+ * is in code and not consultable as data, `needs-settings` while an agent created here has no run
+ * settings, `limit` when it has as many as the ceiling allows, and `no-types` when every kind of
+ * object it works on already has a consultation.
+ */
+type ConsultationsClosed = 'application' | 'agent' | 'needs-settings' | 'limit' | 'no-types';
+
 /**
  * What an entry point of the flow opens: the run configuration opens its own forms; the agent editor,
  * the technical account, the runs view and the MCP servers belong to the page that hosts it.
@@ -805,6 +844,11 @@ type AgentFlowEntry = {
 } | {
     kind: 'edit-trigger';
     triggerId: string;
+} | {
+    kind: 'add-consultation';
+} | {
+    kind: 'edit-consultation';
+    subjectType: string;
 } | {
     kind: 'edit-agent';
 } | {
@@ -815,6 +859,12 @@ type AgentFlowEntry = {
     kind: 'mcp-servers';
 };
 
+/** What a saved consultation form tells its host. */
+interface ConsultationFormSaved {
+    consultation: DataConsultation;
+    added: boolean;
+}
+
 /** What a saved skill form tells its host. */
 interface SkillFormSaved {
     skill: DataSkill;
@@ -823,10 +873,10 @@ interface SkillFormSaved {
     added: boolean;
 }
 
-type Form = 'setup' | 'settings' | 'skill' | 'trigger';
+type Form = 'setup' | 'settings' | 'skill' | 'trigger' | 'consultation';
 /** A removal, promotion or discard that waits for its confirmation. */
 interface Confirmation {
-    action: 'remove-settings' | 'remove-skill' | 'remove-trigger' | 'promote' | 'discard';
+    action: 'remove-settings' | 'remove-skill' | 'remove-trigger' | 'remove-consultation' | 'promote' | 'discard';
     id: string;
 }
 /**
@@ -841,7 +891,11 @@ interface Confirmation {
  * they compare with the live version and promote or discard; they add data triggers on the
  * application's events or on a schedule and put them live; a schedule without a subject set runs for
  * the whole application, or for every division of an agent that works per division. New skills and
- * triggers start in shadow; `changed` tells the agents page to reload the agent's skill states.
+ * triggers start in shadow; `changed` tells the agents page to reload the agent's skill states. Its
+ * consultations (AC20) show what other assistants may consult it about: those in code read only, and
+ * those defined as data, which administrators add, change and remove within the agent's ceiling in
+ * code, each with the agents that ask it (`openAgent` opens the editor of one) and its problems,
+ * followed by the switches that turn a route off for all of its consultations.
  */
 declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     private readonly admin;
@@ -863,6 +917,8 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
      * `null` while unknown.
      */
     readonly servers: _angular_core.InputSignal<readonly McpServer[] | null>;
+    /** Every agent of the administration, to name the agents that ask the agent's consultations. */
+    readonly agents: _angular_core.InputSignal<readonly AdminAgent[]>;
     /** A change of the run configuration changed the agent's skills or state. */
     readonly changed: _angular_core.OutputEmitterRef<void>;
     /** The flow asks to open the agent editor: what it works on, its tools, MCP servers and groups. */
@@ -873,6 +929,8 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     readonly openRuns: _angular_core.OutputEmitterRef<void>;
     /** The flow asks to open the MCP servers, whose background use decides what runs without a person use. */
     readonly openMcpServers: _angular_core.OutputEmitterRef<void>;
+    /** Opens the editor of an agent that asks one of the agent's consultations, by its id. */
+    readonly openAgent: _angular_core.OutputEmitterRef<string>;
     readonly id: string;
     readonly maxReason: 500;
     readonly skillNameKeys: typeof skillNameKeys;
@@ -910,6 +968,10 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     readonly editingSkill: _angular_core.WritableSignal<DataSkill | null>;
     /** The trigger being changed; `null` with the trigger form open adds a new trigger. */
     readonly editingTrigger: _angular_core.WritableSignal<DataTrigger | null>;
+    /** The consultation being changed; `null` with the consultation form open adds a new one. */
+    readonly editingConsultation: _angular_core.WritableSignal<DataConsultation | null>;
+    /** Counts the loads, so the route switches read the agent's routes again after a change. */
+    readonly loads: _angular_core.WritableSignal<number>;
     readonly comparison: _angular_core.WritableSignal<{
         skillId: string;
         result: SkillComparison | null;
@@ -928,6 +990,18 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     readonly skillIds: _angular_core.Signal<string[]>;
     readonly triggerIds: _angular_core.Signal<string[]>;
     readonly problems: _angular_core.Signal<_newheap_platform_ai_chat.RunConfigurationProblem[]>;
+    /** The consultations in code and as data, by subject type. */
+    readonly consultationRows: _angular_core.Signal<ConsultationRow[]>;
+    readonly showConsultations: _angular_core.Signal<boolean>;
+    /** The ceiling within which administrators may define the agent's consultations; `null` for none. */
+    readonly consultationCeiling: _angular_core.Signal<_newheap_platform_ai_chat.ConsultationCeiling | null>;
+    /** Why administrators cannot add a consultation now, or `null` when they can. */
+    readonly consultationsClosed: _angular_core.Signal<ConsultationsClosed | null>;
+    /** The subject types the agent already has a consultation about. */
+    readonly consultationTypes: _angular_core.Signal<string[]>;
+    /** Whom the agent answers to, which decides whether a consultation may lend its rights. */
+    readonly accountability: _angular_core.Signal<_newheap_platform_ai_chat.AgentAccountability | null>;
+    readonly approvalPolicy: _angular_core.Signal<string | null>;
     /** What the run settings' approval policy means, in a sentence. */
     readonly settingsPolicy: _angular_core.Signal<string | null>;
     constructor();
@@ -949,6 +1023,18 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     editTrigger(trigger: DataTrigger): void;
     setTriggerShadow(trigger: DataTrigger, shadow: boolean): void;
     removeTrigger(trigger: DataTrigger): void;
+    addConsultation(): void;
+    editConsultation(consultation: DataConsultation): void;
+    removeConsultation(consultation: DataConsultation): void;
+    onConsultationSaved(result: ConsultationFormSaved): void;
+    /** The name of a subject type, as the run catalog names it in the reader's language. */
+    typeName(subjectType: string): string;
+    /** An agent's name: the translation of an agent in code, the administrator's text, or its id. */
+    agentNameOf(agentId: string): string;
+    /** Who may ask a consultation defined as data, in a sentence; `null` for one in code, whose code says it. */
+    askSentence(row: ConsultationRow): string | null;
+    /** What the consultation may do and who decides its proposals, by the routes in effect. */
+    decideSentence(row: ConsultationRow): string;
     /** A form saved: show what happened and reload, which every change may affect. */
     onSetupCompleted(live: boolean): void;
     onSettingsSaved(): void;
@@ -981,7 +1067,7 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     /** Runs a change and reloads the configuration, which every change may affect. */
     private run;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentRunConfigurationComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentRunConfigurationComponent, "nh-assistant-agent-run-configuration", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "startSetup": { "alias": "startSetup"; "required": false; "isSignal": true; }; "tools": { "alias": "tools"; "required": false; "isSignal": true; }; "servers": { "alias": "servers"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "editAgent": "editAgent"; "changeAccount": "changeAccount"; "openRuns": "openRuns"; "openMcpServers": "openMcpServers"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentRunConfigurationComponent, "nh-assistant-agent-run-configuration", never, { "agent": { "alias": "agent"; "required": true; "isSignal": true; }; "startSetup": { "alias": "startSetup"; "required": false; "isSignal": true; }; "tools": { "alias": "tools"; "required": false; "isSignal": true; }; "servers": { "alias": "servers"; "required": false; "isSignal": true; }; "agents": { "alias": "agents"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "editAgent": "editAgent"; "changeAccount": "changeAccount"; "openRuns": "openRuns"; "openMcpServers": "openMcpServers"; "openAgent": "openAgent"; }, never, never, true, never>;
 }
 
 /** Result of the latest connection test per server. */

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,13 +339,28 @@ 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;
@@ -455,9 +486,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 +501,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>;