@newheap/platform-ai-chat 0.18.0 → 0.20.0

package/README.md

@@ -154,6 +154,13 @@ 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.
 
+A question an agent asked with `ask_question` (`run.AllowQuestions()` on the server) shows as
+`nh-assistant-question-card`: the person it is addressed to gets a button per choice, everyone else
+reads it with whom it waits for. The turn waits for the answer as for an approval
+(`conversation.pendingQuestion`); the thread emits `(questionAnswer)` for the addressee and the panel
+calls `NhAssistantStore.answerQuestion`, which streams the resumed turn. An agent message of a chat
+with `run.SkillsInChat()` names the skill it worked in (`message.skillId`).
+
 A tool call whose agent proposal closed without running no longer waits: it ends as
 `rejected`, as `not-executed` when the proposal expired, was withdrawn or became stale, or as
 `failed` when its execution failed before it started, with the result code

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, 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 { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, PackagePartLink, ToolCatalogEntry, McpServer, RunCatalog, SetAgentStateRequest, AgentSkillState, AgentShadowMode, ShadowVariantPromotion, 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. */
@@ -323,6 +365,18 @@ declare class NhAssistantAdminAgentsComponent {
      * 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;
+    /**
+     * A data shadow variant promoted onto the agent whose run configuration is open: the agent shows its
+     * new version there and in the list, and the variant, which was removed, leaves the list.
+     */
+    onVariantPromoted(promotion: ShadowVariantPromotion): 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. */
@@ -418,6 +472,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. */
@@ -432,7 +495,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;
@@ -460,6 +528,12 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly cancelled: _angular_core.OutputEmitterRef<void>;
     readonly uses: readonly AgentUse[];
     readonly id: string;
+    private readonly language;
+    /**
+     * The agent's name in the title, as the agent list shows it: an agent in code names itself with a
+     * translation key, which reads in the reader's language.
+     */
+    readonly titleName: _angular_core.Signal<string>;
     readonly max = 20000;
     readonly autonomyLevels: readonly AssistantAutonomy[];
     readonly classifications: readonly AssistantDataClassification[];
@@ -467,11 +541,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. */
@@ -500,12 +583,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
@@ -559,8 +666,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;
@@ -571,6 +686,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. */
@@ -812,7 +1061,17 @@ interface ConsultationRow {
     /** 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;
@@ -826,6 +1085,20 @@ interface ConsultationRow {
  */
 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.
@@ -876,7 +1149,7 @@ interface SkillFormSaved {
 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' | 'remove-consultation' | 'promote' | 'discard';
+    action: 'remove-settings' | 'remove-skill' | 'remove-trigger' | 'remove-consultation' | 'promote' | 'discard' | 'promote-trigger' | 'discard-trigger';
     id: string;
 }
 /**
@@ -891,11 +1164,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. Its
+ * 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,
- * followed by the switches that turn a route off for all of its consultations.
+ * 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;
@@ -982,6 +1258,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. */
@@ -1006,6 +1294,10 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     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;
@@ -1020,11 +1312,23 @@ 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. */
@@ -1039,7 +1343,10 @@ declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
     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;
     /**
@@ -1062,6 +1369,8 @@ 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. */
@@ -1429,5 +1738,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 };

package/agent-runs/index.d.ts

@@ -366,6 +366,11 @@ declare class NhAssistantAgentProposalsComponent {
     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. */