@newheap/platform-ai-chat 0.17.0 → 0.19.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 { InjectionToken, Type, Signal, EnvironmentProviders, Injector, 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, PackagePartLink, ToolCatalogEntry, McpServer, RunCatalog, SetAgentStateRequest, AgentSkillState, AgentShadowMode, AgentShadowState, AssistantAutonomy, AssistantDataClassification, InstructionAssetReference, AgentMetadata, AgentMetadataEntry, NhAssistantAdminApiService, ɵnhAssistantErrorKeys as _nhAssistantErrorKeys, AgentEvaluation, AgentReplay, AgentEvaluationCost, AgentProposalFeedbackCategory, AgentFeedbackSummaryRow, AgentFeedbackItem, AgentFeedbackCategoryCount, StaleKind, AgentProposalFeedbackGroup, AgentSubjectType, AgentRunStatus, ɵnhAssistantCodeKeys as _nhAssistantCodeKeys, AgentRunHistoryItem, NhAssistantConsultationRoute, DataConsultation, CodeConsultation, DataTriggerVersion, DataSkill, AgentRunConfiguration, DataTrigger, SkillComparison, DataSkillVersion, TriggerComparison, ɵ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';
@@ -153,6 +153,27 @@ interface WorksOnSummary {
     viewPolicy: string | null;
 }
 
+/** How a package links one part on this host, as the forms and lists show it. */
+interface PackageLockView {
+    packageId: string;
+    packageVersion: number;
+    /** The whole part is locked. */
+    whole: boolean;
+    /** The locked fields by their names in the format; empty while the whole part or nothing is locked. */
+    fields: readonly string[];
+    /** The part changed here after its import; the next upgrade overwrites its unlocked fields. */
+    changedLocally: boolean;
+}
+/** The lock a part's link shows, or `null` for a part no package links. */
+declare function packageLockOf(link: PackagePartLink | null | undefined): PackageLockView | null;
+/**
+ * The package an agent belongs to, as the notice of the whole agent shows it: the package's id and
+ * the version this host has, without locks of its own.
+ */
+declare function agentPackageOf(agent: AdminAgent | null | undefined): PackageLockView | null;
+/** Whether a lock keeps anything of its part from changing, so the part cannot be removed. */
+declare function isPackageLocked(lock: PackageLockView | null | undefined): boolean;
+
 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 {
@@ -177,7 +198,11 @@ interface StateChange {
  * code and offers to read it again; until then it offers no "Run now" and the editor leaves what an
  * agent works on and its groups as they are. The run configuration opens with the agent's flow, whose
  * entry points open the editor, the runs and the technical account here and return to the run
- * configuration afterwards; `openMcpServers` asks the host to show the MCP servers.
+ * configuration afterwards; `openMcpServers` asks the host to show the MCP servers. "Import package"
+ * opens the import dialog of agent packages, and "Export as package" on an agent the export dialog
+ * with that agent chosen. An agent that belongs to a package says so on its card with "Unlink the
+ * agent"; it cannot be deleted until it is unlinked, nor reset while its package locks fields of
+ * its definition.
  */
 declare class NhAssistantAdminAgentsComponent {
     private readonly admin;
@@ -255,6 +280,11 @@ declare class NhAssistantAdminAgentsComponent {
     readonly accountNames: _angular_core.Signal<ReadonlyMap<string, string>>;
     /** The agent whose last action failed, so its error shows on its card. */
     readonly errorAgentId: _angular_core.WritableSignal<string | null>;
+    /** The agent whose export dialog is open, chosen in it; `null` while it is closed. */
+    readonly exporting: _angular_core.WritableSignal<AdminAgent | null>;
+    /** Whether the import dialog of agent packages is open. */
+    readonly importing: _angular_core.WritableSignal<boolean>;
+    readonly agentPackageOf: typeof agentPackageOf;
     /** The agent the run-now dialog runs; `null` while it is closed. */
     readonly runningNow: _angular_core.WritableSignal<AdminAgent | null>;
     /** The agent of the run-now dialog as the dialog needs it: its name and what it works on. */
@@ -294,6 +324,18 @@ declare class NhAssistantAdminAgentsComponent {
      * that is off still runs for a person. The server decides the rest when the run starts.
      */
     canRunNow(agent: AdminAgent): boolean;
+    /** Opens the export dialog with the agent chosen. */
+    exportPackage(agent: AdminAgent): void;
+    /** Opens the import dialog of agent packages. */
+    importPackage(): void;
+    /** A package was imported: its agents and their parts are read again. */
+    onPackageImported(): void;
+    /** The agent or a part of it was unlinked from its package. */
+    onPackageUnlinked(): void;
+    /** A package the agent belongs to keeps it from being deleted until it is unlinked. */
+    deleteLocked(agent: AdminAgent): boolean;
+    /** A reset would give fields the package locks the code's values, which the server refuses. */
+    resetLocked(agent: AdminAgent): boolean;
     /** Opens the run-now dialog of the agent. */
     runNow(agent: AdminAgent): void;
     /** Opens the conversation the run works in, in the assistant panel. */
@@ -317,6 +359,19 @@ 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;
+    /**
+     * A data shadow variant created in the agent's run configuration continues in its own run
+     * configuration's guided setup, since it receives the live agent's events only with run settings.
+     */
+    onVariantCreated(variant: AdminAgent): void;
+    /** The run configuration of a data shadow variant of the agent whose run configuration is open. */
+    variantFromRunConfiguration(variantId: 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 +380,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 & {
@@ -408,6 +467,15 @@ declare class NhAssistantAdminAgentsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminAgentsComponent, "nh-assistant-admin-agents", never, {}, { "openMcpServers": "openMcpServers"; }, never, never, true, never>;
 }
 
+/** A field error: a code such as `required`, with its translation parameters. */
+interface RunConfigFieldError {
+    code: string;
+    params?: Record<string, unknown>;
+}
+
+/** Where the instructions of a skill version or an agent created here come from. */
+type InstructionsSource = 'inline' | 'asset';
+
 /** True when a tool id matches a selector glob (`*` matches any characters). */
 declare function nhAssistantSelectorMatches(toolId: string, selector: string): boolean;
 /** How an agent created in the administration is used: chosen in the chat, working on its own, or both. */
@@ -422,7 +490,12 @@ type WorksOnScope = 'all' | 'types';
  * patterns, and assigned MCP servers. A new agent meant to work on its own continues with
  * `workRequested`. An agent in code names and describes itself with translation keys: the editor
  * shows their translation and sends the key back unless the administrator changed the text, so the
- * agent stays translated; what it works on comes from its code and is not edited here.
+ * agent stays translated; what it works on comes from its code and is not edited here. Below the form,
+ * an existing agent shows the application's fields (`nh-assistant-agent-metadata`): one slot per entry
+ * of agent metadata, where the application's own editor saves the value; a change of a field of an
+ * agent created here is its next version, which the next save of the definition continues on. Fields
+ * of the definition that the agent's package locks show read-only with a lock and the package's id and
+ * version, with "Unlink" for the definition; a save keeps their values.
  */
 declare class NhAssistantAdminAgentEditorComponent {
     private readonly admin;
@@ -457,11 +530,20 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly displayName: _angular_core.WritableSignal<string>;
     readonly description: _angular_core.WritableSignal<string>;
     readonly instructions: _angular_core.WritableSignal<string>;
+    /** Whether the instructions of an agent created here are written here or come from an asset of the application. */
+    readonly instructionsSource: _angular_core.WritableSignal<InstructionsSource>;
+    /** The application's asset the agent names, once chosen and read. */
+    readonly instructionsAsset: _angular_core.WritableSignal<InstructionAssetReference | null>;
     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>;
+    /**
+     * A new agent starts in shadow: once it has run settings its runs work in its shadow threads, where
+     * nobody is notified and nothing executes, until someone puts it live.
+     */
+    readonly startsInShadow: _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. */
@@ -490,12 +572,36 @@ declare class NhAssistantAdminAgentEditorComponent {
     private readonly created;
     /** The agent the next save updates; `null` while a new agent is not created yet. */
     private readonly editing;
+    /**
+     * The agent's version after one of its application fields changed, which made its next version;
+     * `null` while no field changed.
+     */
+    private readonly fieldsVersion;
+    /** The definition was unlinked from its package here, so it no longer locks. */
+    private readonly unlinked;
+    /** What the agent's package locks of its definition (part `agent`); `null` without a link. */
+    readonly lock: _angular_core.Signal<PackageLockView | null>;
+    /** The agent whose application fields show below the form; `null` for a new agent. */
+    readonly metadataAgent: _angular_core.Signal<AdminAgent | null>;
+    /** The entries of agent metadata the application registers, for a new agent. */
+    readonly metadataEntries: _angular_core.Signal<_newheap_platform_ai_chat.AgentMetadataEntry[]>;
     readonly isNew: _angular_core.Signal<boolean>;
     /** Only agents created here choose whether they are offered in the chat; code decides for the others. */
     readonly choosesUse: _angular_core.Signal<boolean>;
     readonly idInvalid: _angular_core.Signal<boolean>;
     readonly nameMissing: _angular_core.Signal<boolean>;
     readonly tooLong: _angular_core.Signal<boolean>;
+    /**
+     * Only an agent created here takes its instructions from an asset, when the application offers its
+     * assets; one that names an asset keeps showing it.
+     */
+    readonly assetsAvailable: _angular_core.Signal<boolean>;
+    /** An asset is the source, but none is chosen and read yet. */
+    readonly assetMissing: _angular_core.Signal<boolean>;
+    /** The problem of the asset the saved agent names, while it is still the choice. */
+    readonly assetProblem: _angular_core.Signal<_newheap_platform_ai_chat.InstructionAssetProblem | null>;
+    /** The error of the asset choice: chosen none, or the save's refusal of the reference. */
+    readonly assetError: _angular_core.Signal<RunConfigFieldError | null>;
     readonly selectorInvalid: _angular_core.Signal<boolean>;
     /**
      * The application's own object types, by name; the platform's types, such as the whole
@@ -549,8 +655,16 @@ declare class NhAssistantAdminAgentEditorComponent {
     toggleServer(serverId: string, checked: boolean): void;
     value(event: Event): string;
     checked(event: Event): boolean;
+    /** Whether the agent's package locks a field of its definition, which then shows read-only. */
+    locked(field: string): boolean;
+    /** The lock the mark next to a field's label shows; `null` for a field that changes here. */
+    lockOf(field: string): PackageLockView | null;
+    /** The definition was unlinked from its package: its fields change here again. */
+    onUnlinked(): void;
     /** The first error the server reported for a field, as a translation key. */
     fieldError(field: string): string | null;
+    /** An application field of an agent created here made the agent's next version. */
+    fieldsChanged(agentVersion: number): void;
     save(): void;
     /** What the agent works on, as the six fields the server reads together. */
     private worksOnInput;
@@ -561,6 +675,140 @@ declare class NhAssistantAdminAgentEditorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminAgentEditorComponent, "nh-assistant-admin-agent-editor", never, { "agent": { "alias": "agent"; "required": false; "isSignal": true; }; "tools": { "alias": "tools"; "required": false; "isSignal": true; }; "servers": { "alias": "servers"; "required": false; "isSignal": true; }; "catalog": { "alias": "catalog"; "required": false; "isSignal": true; }; "catalogUnavailable": { "alias": "catalogUnavailable"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "workRequested": "workRequested"; "cancelled": "cancelled"; }, never, never, true, never>;
 }
 
+/**
+ * The application's editor of one entry of agent metadata (`AddAgentMetadata`): a standalone
+ * component that the agent editor renders in the entry's slot. It injects
+ * `NhAssistantAgentMetadataSlot` for the entry's value and saves the value with it; the library has no
+ * generic form for metadata.
+ */
+interface NhAssistantAgentMetadataEditor {
+    /** The entry's name, as the application registers it with `AddAgentMetadata`. */
+    name: string;
+    /** The application's standalone component that shows and edits the value. */
+    component: Type<unknown>;
+    /** A translation key of the slot's title; the entry's name without one. */
+    label?: string;
+}
+/** The editors the application registers for its entries of agent metadata, by entry name. */
+declare const NH_ASSISTANT_AGENT_METADATA_EDITORS: InjectionToken<NhAssistantAgentMetadataEditor[]>;
+/**
+ * Registers the application's editors of agent metadata, where the administration is provided (in
+ * the application's configuration or the providers of its administration route). The agent editor
+ * renders one slot per registered entry; an entry without an editor shows that the application shows
+ * none. Several calls add their editors.
+ */
+declare function provideNhAssistantAgentMetadataEditors(...editors: NhAssistantAgentMetadataEditor[]): EnvironmentProviders;
+/** What the last change of an entry did, for the slot's status line. */
+type NhAssistantAgentMetadataStatus = 'saved' | 'removed';
+/**
+ * The slot of one entry of agent metadata, which an application's editor injects: the entry's value
+ * as the server answered it, whether it may change, and `save` and `remove`, which go through
+ * `NhAssistantAdminApiService` with the entry's version and keep the slot up to date. A refusal shows
+ * in `error`, with the validator's codes in `fieldErrors`.
+ */
+declare abstract class NhAssistantAgentMetadataSlot {
+    /** The agent's id. */
+    abstract readonly agentId: string;
+    /** The entry with its value in effect, where it comes from and its version. */
+    abstract readonly entry: Signal<AgentMetadata>;
+    /**
+     * Whether the value is read-only here: an entry of an agent in code that is not editable, or one
+     * whose value the agent's package locks until an administrator unlinks it.
+     */
+    abstract readonly readOnly: Signal<boolean>;
+    /** Whether a change is being saved. */
+    abstract readonly saving: Signal<boolean>;
+    /** The refusal of the last change, or `null`. */
+    abstract readonly error: Signal<NhAssistantError | null>;
+    /** What the last change did, until the next one starts. */
+    abstract readonly status: Signal<NhAssistantAgentMetadataStatus | null>;
+    /**
+     * Saves `value`, in the shape of the entry's type, with the entry's version: an agent created here
+     * gets its next version, an agent in code an override. Ignored while read-only or saving.
+     */
+    abstract save(value: unknown): void;
+    /** Removes the stored value: an agent in code uses its value in code again. */
+    abstract remove(): void;
+    /**
+     * The codes the server reported for the whole value, or for one of its fields by camelCase path
+     * such as `code`; empty without a refusal.
+     */
+    abstract fieldErrors(field?: string): readonly string[];
+}
+
+/**
+ * The slot of one entry: its state as the server answered it, saved through the administration API
+ * with the entry's version.
+ */
+declare class NhAssistantAgentMetadataSlotRef extends NhAssistantAgentMetadataSlot {
+    readonly agentId: string;
+    private readonly admin;
+    private readonly changed;
+    private subscription?;
+    readonly entry: _angular_core.WritableSignal<AgentMetadata>;
+    readonly saving: _angular_core.WritableSignal<boolean>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly status: _angular_core.WritableSignal<NhAssistantAgentMetadataStatus | null>;
+    /** The lock of the entry's package link (part `metadata:{name}`); `null` without one. */
+    readonly lock: _angular_core.Signal<PackageLockView | null>;
+    readonly readOnly: _angular_core.Signal<boolean>;
+    constructor(agentId: string, entry: AgentMetadata, admin: NhAssistantAdminApiService, changed: (entry: AgentMetadata) => void);
+    save(value: unknown): void;
+    remove(): void;
+    fieldErrors(field?: string): readonly string[];
+    /** The agent's next version after another entry of an agent created here changed. */
+    followAgentVersion(agentVersion: number): void;
+    dispose(): void;
+    private run;
+}
+/** One slot as the frame shows it. */
+interface NhAssistantAgentMetadataSlotView {
+    name: string;
+    label: string | null;
+    component: Type<unknown> | null;
+    slot: NhAssistantAgentMetadataSlotRef;
+    injector: Injector;
+}
+/**
+ * The application fields of an agent in the agent editor (MD3): one slot per entry of agent
+ * metadata the application registers with `AddAgentMetadata`, where the application's own editor,
+ * registered with `provideNhAssistantAgentMetadataEditors`, shows the value and saves it through
+ * `NhAssistantAgentMetadataSlot`. The frame names the entry, says where its value comes from, marks
+ * an entry of an agent in code that only code changes, and shows what a save did. A change of an
+ * agent created here is its next version: `agentVersionChanged` tells the agent editor. A new agent
+ * shows its entries once it is saved. An entry the agent's package locks is read-only for its editor,
+ * with the package's id and version and "Unlink".
+ */
+declare class NhAssistantAgentMetadataComponent {
+    private readonly admin;
+    private readonly injector;
+    private readonly editors;
+    private subscription?;
+    /** The agent whose fields are shown; `null` for a new agent, which is saved first. */
+    readonly agent: _angular_core.InputSignal<AdminAgent | null>;
+    /** The run catalog's `agentMetadata`: the entries a new agent will have. */
+    readonly entries: _angular_core.InputSignal<readonly AgentMetadataEntry[]>;
+    /** The agent's version after a field of an agent created here changed. */
+    readonly agentVersionChanged: _angular_core.OutputEmitterRef<number>;
+    readonly id: string;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly slots: _angular_core.WritableSignal<readonly NhAssistantAgentMetadataSlotView[]>;
+    readonly sourceKey: (entry: AgentMetadata) => string;
+    readonly errorKeys: typeof _nhAssistantErrorKeys;
+    constructor();
+    load(): void;
+    private slotOf;
+    /**
+     * A field of an agent created here made the agent's next version: the other fields and the agent
+     * editor continue on it. An override of an agent in code has a version of its own.
+     */
+    private onChanged;
+    private disposeSlots;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAgentMetadataComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentMetadataComponent, "nh-assistant-agent-metadata", never, { "agent": { "alias": "agent"; "required": false; "isSignal": true; }; "entries": { "alias": "entries"; "required": false; "isSignal": true; }; }, { "agentVersionChanged": "agentVersionChanged"; }, never, never, true, never>;
+}
+
 /** Periods the evaluation offers, in days before now; the server allows at most 92. */
 type NhAssistantEvaluationPeriod = 7 | 30 | 90;
 /** One row of the cost comparison: a measure of the live agent next to the variant's. */
@@ -787,6 +1035,59 @@ 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;
+    /**
+     * The consultation defined as data is switched off: it is not offered until an administrator switches
+     * it on. Its routes and tools are then those it was saved with, which it offers once it is on.
+     */
+    off: boolean;
+    problems: string[];
+    /**
+     * The tools the consulted agent is offered: the selection in code, or the one of the data that the
+     * agent's own selectors still cover. `null` offers every tool of the agent; empty offers none.
+     */
+    toolSelectors: string[] | null;
+    /** 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';
+
+/** A part of a trigger's definition that a candidate changes. */
+type TriggerField = 'source' | 'event' | 'filters' | 'debounce' | 'cron' | 'time-zone' | 'subject-set' | 'message' | 'skill' | 'conflict';
+/**
+ * One difference between the live version of a trigger and its candidate, with the values as stored:
+ * a skill id, a conflict or a source the page names in the reader's language, `null` for none.
+ */
+interface TriggerChange {
+    field: TriggerField;
+    live: string | null;
+    candidate: string | null;
+}
+/** The short definition of a version in the history: what starts it and when. */
+declare function versionSummary(version: DataTriggerVersion): string;
+
 /**
  * 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 +1106,11 @@ type AgentFlowEntry = {
 } | {
     kind: 'edit-trigger';
     triggerId: string;
+} | {
+    kind: 'add-consultation';
+} | {
+    kind: 'edit-consultation';
+    subjectType: string;
 } | {
     kind: 'edit-agent';
 } | {
@@ -815,6 +1121,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 +1135,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' | 'promote-trigger' | 'discard-trigger';
     id: string;
 }
 /**
@@ -841,7 +1153,14 @@ 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; a change of a trigger applies at once or fires as a candidate in shadow next
+ * to the live version, which they compare, promote or discard, and every trigger shows its history.
+ * `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, and
+ * switch on or off (a new one may start off), followed by the switches that turn a route off for all of
+ * its consultations.
  */
 declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     private readonly admin;
@@ -863,6 +1182,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 +1194,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 +1233,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;
@@ -920,6 +1247,18 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
         items: DataSkillVersion[] | null;
         failed: boolean;
     } | null>;
+    readonly triggerComparison: _angular_core.WritableSignal<{
+        triggerId: string;
+        result: TriggerComparison | null;
+        failed: boolean;
+    } | null>;
+    readonly triggerVersions: _angular_core.WritableSignal<{
+        triggerId: string;
+        items: DataTriggerVersion[] | null;
+        failed: boolean;
+    } | null>;
+    readonly triggerFieldKeys: Record<TriggerField, string>;
+    readonly versionSummary: typeof versionSummary;
     private readonly language;
     readonly isAdminAgent: _angular_core.Signal<boolean>;
     /** An agent created in the administration gets skills and triggers once it has run settings. */
@@ -928,10 +1267,26 @@ 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();
     ngOnInit(): void;
+    /** The lock a part's package link shows, for the lists and the forms. */
+    readonly packageLockOf: typeof packageLockOf;
+    /** Whether a part's package locks it, so it cannot be removed until it is unlinked. */
+    readonly isPackageLocked: typeof isPackageLocked;
     load(openSetup?: boolean): void;
     openSetup(): void;
     editSettings(): void;
@@ -946,14 +1301,41 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     /** Shows or hides the version history of a skill. */
     toggleVersions(skill: DataSkill): void;
     addTrigger(): void;
+    /** What a trigger's candidate changes against its live version. */
+    triggerChanges(trigger: DataTrigger): TriggerChange[];
+    /** A value of a changed field as people read it: a skill's name, a conflict, a source, or none. */
+    changeValue(change: TriggerChange, value: string | null): string;
+    promoteTrigger(trigger: DataTrigger): void;
+    discardTrigger(trigger: DataTrigger): void;
+    /** Shows or hides the comparison of a trigger's candidate with its live version. */
+    toggleTriggerComparison(trigger: DataTrigger): void;
+    /** Shows or hides the version history of a trigger. */
+    toggleTriggerVersions(trigger: DataTrigger): void;
     editTrigger(trigger: DataTrigger): void;
     setTriggerShadow(trigger: DataTrigger, shadow: boolean): void;
     removeTrigger(trigger: DataTrigger): void;
+    addConsultation(): void;
+    editConsultation(consultation: DataConsultation): void;
+    /** Switches a consultation defined as data on or off; off, asking agents get none of its tools. */
+    setConsultationState(consultation: DataConsultation, on: boolean): 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;
     onSkillSaved(result: SkillFormSaved): void;
-    onTriggerSaved(added: boolean): void;
+    onTriggerSaved(result: {
+        added: boolean;
+        candidate: boolean;
+    }): void;
     confirm(action: Confirmation['action'], id: string): void;
     isConfirming(action: Confirmation['action'], id: string): boolean;
     /**
@@ -976,12 +1358,14 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     private finish;
     /** Opens one form at a time and moves the focus into it. */
     private open;
+    /** One comparison or history is shown at a time. */
+    private closeDetails;
     /** Whether the last failed action concerned this item, so its error shows there. */
     failed(target: string): boolean;
     /** 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. */
@@ -1343,5 +1727,5 @@ declare class NhAssistantAdminMcpToolsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAdminMcpToolsComponent, "nh-assistant-admin-mcp-tools", never, { "server": { "alias": "server"; "required": true; "isSignal": true; }; }, { "closed": "closed"; "synced": "synced"; }, never, never, true, never>;
 }
 
-export { NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentRunConfigurationComponent, NhAssistantAgentRunHistoryComponent, nhAssistantSelectorMatches };
-export type { AgentUse, NhAssistantAdminTab, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantReaderDraft, NhAssistantSecretAction, NhAssistantSecretSource, WorksOnScope };
+export { NH_ASSISTANT_AGENT_METADATA_EDITORS, NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentMetadataComponent, NhAssistantAgentMetadataSlot, NhAssistantAgentRunConfigurationComponent, NhAssistantAgentRunHistoryComponent, nhAssistantSelectorMatches, provideNhAssistantAgentMetadataEditors };
+export type { AgentUse, NhAssistantAdminTab, NhAssistantAgentMetadataEditor, NhAssistantAgentMetadataStatus, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantReaderDraft, NhAssistantSecretAction, NhAssistantSecretSource, WorksOnScope };