@newheap/platform-ai-chat 0.13.0 → 0.14.0

package/README.md

@@ -125,6 +125,11 @@ conversation opens, and live only in this tab's memory. They clear on account ch
 loss of access, deletion or leaving a conversation. Standalone composers preserve their
 default behavior; opt into the extra send button with `[queueWhileBusy]="true"` and
 connect it to `NhAssistantStore.submit` using `canSubmit`.
+A failed turn leaves the conversation open, as on the server: the error bar keeps the
+translated failure and the next message starts a new turn in the same conversation or agent
+thread. While nothing is queued, that message is sent directly even with the error bar shown.
+A reopened conversation whose last turn failed says that the last answer could not be
+completed. Only an archived conversation is closed for new messages.
 Explicit send returns focus to the
 editor. Automatic focus restoration happens only when a disappearing composer control
 owned focus, never after the user chose another control, and is skipped for coarse

package/admin/index.d.ts

@@ -1,5 +1,7 @@
 import * as _angular_core from '@angular/core';
-import { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, ToolCatalogEntry, McpServer, SetAgentStateRequest, AgentShadowMode, AgentSkillState, AgentShadowState, AssistantAutonomy, AgentEvaluation, AgentReplay, AgentEvaluationCost, AgentProposalFeedbackCategory, AgentFeedbackSummaryRow, AgentFeedbackItem, AgentFeedbackCategoryCount, StaleKind, AgentProposalFeedbackGroup, McpServerTestResult, McpAuthMode, McpToolEffect, McpTool } from '@newheap/platform-ai-chat';
+import { OnInit } from '@angular/core';
+import * as _newheap_platform_ai_chat from '@newheap/platform-ai-chat';
+import { NhAssistantStore, NhAssistantError, ApplicationContext, ApplicationContextVersion, AdminAgent, ToolCatalogEntry, McpServer, SetAgentStateRequest, AgentShadowMode, AgentSkillState, AgentShadowState, AssistantAutonomy, AgentEvaluation, AgentReplay, AgentEvaluationCost, AgentProposalFeedbackCategory, AgentFeedbackSummaryRow, AgentFeedbackItem, AgentFeedbackCategoryCount, StaleKind, AgentProposalFeedbackGroup, AgentAccountability, AgentElevatedReads, TriggerConflict, RunCatalog, AgentRunConfiguration, DataSkill, DataTrigger, SkillComparison, DataSkillVersion, SkillApplyMode, McpServerTestResult, McpAuthMode, McpToolEffect, McpTool } from '@newheap/platform-ai-chat';
 
 type NhAssistantAdminTab = 'context' | 'agents' | 'mcp-servers';
 /**
@@ -65,8 +67,9 @@ type AgentStateAction = SetAgentStateRequest['state'];
  * and for every agent its run state with pause, stop and resume, its shadow mode and that of each
  * skill, and the technical account of an agent that answers to one, each with an optional reason.
  * Editing opens `nh-assistant-admin-agent-editor`; the feedback action opens
- * `nh-assistant-agent-feedback-report` for the agent, and the evaluation action of an agent with
- * shadow variants opens `nh-assistant-agent-evaluation`.
+ * `nh-assistant-agent-feedback-report` for the agent, the evaluation action of an agent with
+ * shadow variants opens `nh-assistant-agent-evaluation`, and the run configuration action opens
+ * `nh-assistant-agent-run-configuration` for the skills, triggers and run settings defined as data.
  */
 declare class NhAssistantAdminAgentsComponent {
     private readonly admin;
@@ -89,6 +92,8 @@ declare class NhAssistantAdminAgentsComponent {
     readonly reporting: _angular_core.WritableSignal<AdminAgent | null>;
     /** The agent whose comparison with its shadow variants is shown instead of the list. */
     readonly evaluating: _angular_core.WritableSignal<AdminAgent | null>;
+    /** The agent whose run configuration is shown instead of the list. */
+    readonly configuring: _angular_core.WritableSignal<AdminAgent | null>;
     readonly confirming: _angular_core.WritableSignal<{
         agentId: string;
         action: "delete" | "reset";
@@ -126,6 +131,15 @@ declare class NhAssistantAdminAgentsComponent {
     variantsOf(agent: AdminAgent): string[];
     /** Compares the agent with its shadow variants. */
     openEvaluation(agent: AdminAgent): void;
+    /**
+     * Whether the agent can run on its own and so has a run configuration: an agent in code with runs,
+     * or any agent created here, which gets run settings as data.
+     */
+    hasRunConfiguration(agent: AdminAgent): boolean;
+    /** Shows the agent's skills, triggers and run settings defined as data. */
+    openRunConfiguration(agent: AdminAgent): void;
+    /** Returns to the list, refreshed, and to the run configuration action of the agent. */
+    closeRunConfiguration(): void;
     /** Returns to the list and to the evaluation action of the agent whose comparison was open. */
     closeEvaluation(): void;
     /** Returns to the list and to the feedback action of the agent whose report was open. */
@@ -162,6 +176,11 @@ declare class NhAssistantAdminAgentsComponent {
     /** Closes the open confirmation and change forms before another opens; one is open at a time. */
     private closeForms;
     private replace;
+    /**
+     * Reloads the agents behind the visible list, for example their skills after the run
+     * configuration changed; the list stays as it is when that fails.
+     */
+    private refreshAgents;
     /** Agent changes affect the agent picker of the panel. */
     private refreshChat;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminAgentsComponent, never>;
@@ -370,6 +389,147 @@ declare class NhAssistantAgentFeedbackReportComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NhAssistantAgentFeedbackReportComponent, "nh-assistant-agent-feedback-report", never, { "agentId": { "alias": "agentId"; "required": true; "isSignal": true; }; "itemsPerPage": { "alias": "itemsPerPage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type Form = 'settings' | 'skill' | 'trigger';
+/** A removal, promotion or discard that waits for its confirmation. */
+interface Confirmation {
+    action: 'remove-settings' | 'remove-skill' | 'remove-trigger' | 'promote' | 'discard';
+    id: string;
+}
+/**
+ * The run configuration of one agent as data: the run settings of an agent created in the
+ * administration, its skills and triggers in code (read only) and as data, and the data that no
+ * longer fits the code. Administrators add and change data skills, live at once or as a candidate in
+ * shadow that 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. New skills and triggers start in
+ * shadow; `changed` tells the agents page to reload the agent's skill states.
+ */
+declare class NhAssistantAgentRunConfigurationComponent implements OnInit {
+    private readonly admin;
+    private readonly injector;
+    private readonly host;
+    private loadSubscription?;
+    private actionSubscription?;
+    private detailSubscription?;
+    readonly agent: _angular_core.InputSignal<AdminAgent>;
+    /** A change of the run configuration changed the agent's skills or state. */
+    readonly changed: _angular_core.OutputEmitterRef<void>;
+    readonly id: string;
+    readonly maxReason = 500;
+    readonly maxDescription = 300;
+    readonly maxInstructions = 20000;
+    readonly maxMessage = 2000;
+    readonly accountabilities: AgentAccountability[];
+    readonly elevatedReadModes: AgentElevatedReads[];
+    readonly conflicts: TriggerConflict[];
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loadFailed: _angular_core.WritableSignal<boolean>;
+    readonly busy: _angular_core.WritableSignal<boolean>;
+    readonly catalog: _angular_core.WritableSignal<RunCatalog | null>;
+    readonly configuration: _angular_core.WritableSignal<AgentRunConfiguration | null>;
+    readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
+    readonly errorKeys: _angular_core.Signal<string[]>;
+    readonly saved: _angular_core.WritableSignal<string | null>;
+    readonly form: _angular_core.WritableSignal<Form | null>;
+    readonly confirming: _angular_core.WritableSignal<Confirmation | null>;
+    readonly reason: _angular_core.WritableSignal<string>;
+    /** The skill being changed; `null` with the skill form open adds a new skill. */
+    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>;
+    readonly comparison: _angular_core.WritableSignal<{
+        skillId: string;
+        result: SkillComparison | null;
+        failed: boolean;
+    } | null>;
+    readonly versions: _angular_core.WritableSignal<{
+        skillId: string;
+        items: DataSkillVersion[] | null;
+        failed: boolean;
+    } | null>;
+    readonly accountability: _angular_core.WritableSignal<AgentAccountability>;
+    readonly serviceAccount: _angular_core.WritableSignal<string>;
+    readonly approvalPolicy: _angular_core.WritableSignal<string>;
+    readonly ruleHandler: _angular_core.WritableSignal<string>;
+    readonly triageProfile: _angular_core.WritableSignal<string>;
+    readonly retryCount: _angular_core.WritableSignal<string>;
+    readonly maxConcurrentRuns: _angular_core.WritableSignal<string>;
+    readonly maxRunsPerSubjectPerDay: _angular_core.WritableSignal<string>;
+    readonly maxTokensPerRun: _angular_core.WritableSignal<string>;
+    readonly dailyToolCalls: _angular_core.WritableSignal<string>;
+    readonly dailyTokens: _angular_core.WritableSignal<string>;
+    readonly allowGatewayReads: _angular_core.WritableSignal<boolean>;
+    readonly delegateFromInitiator: _angular_core.WritableSignal<boolean>;
+    readonly elevatedReads: _angular_core.WritableSignal<AgentElevatedReads>;
+    readonly skillId: _angular_core.WritableSignal<string>;
+    readonly skillDescription: _angular_core.WritableSignal<string>;
+    readonly skillInstructions: _angular_core.WritableSignal<string>;
+    readonly skillTools: _angular_core.WritableSignal<string[]>;
+    readonly skillProfile: _angular_core.WritableSignal<string>;
+    readonly skillRuleHandler: _angular_core.WritableSignal<string>;
+    readonly skillApprovalPolicy: _angular_core.WritableSignal<string>;
+    readonly skillMaxTokens: _angular_core.WritableSignal<string>;
+    readonly skillDailyToolCalls: _angular_core.WritableSignal<string>;
+    readonly skillDailyTokens: _angular_core.WritableSignal<string>;
+    readonly skillApply: _angular_core.WritableSignal<SkillApplyMode>;
+    readonly triggerId: _angular_core.WritableSignal<string>;
+    readonly triggerSource: _angular_core.WritableSignal<"event" | "schedule">;
+    readonly triggerEvent: _angular_core.WritableSignal<string>;
+    readonly triggerCron: _angular_core.WritableSignal<string>;
+    readonly triggerTimeZone: _angular_core.WritableSignal<string>;
+    readonly triggerSubjectSet: _angular_core.WritableSignal<string>;
+    readonly triggerMessage: _angular_core.WritableSignal<string>;
+    readonly triggerSkill: _angular_core.WritableSignal<string>;
+    readonly triggerConflict: _angular_core.WritableSignal<TriggerConflict>;
+    readonly triggerDebounce: _angular_core.WritableSignal<string>;
+    readonly isAdminAgent: _angular_core.Signal<boolean>;
+    /** An agent created in the administration gets skills and triggers once it has run settings. */
+    readonly canAddRunData: _angular_core.Signal<boolean>;
+    readonly skillOptions: _angular_core.Signal<string[]>;
+    readonly problems: _angular_core.Signal<_newheap_platform_ai_chat.RunConfigurationProblem[]>;
+    readonly skillIdInvalid: _angular_core.Signal<boolean>;
+    readonly triggerIdInvalid: _angular_core.Signal<boolean>;
+    readonly descriptionInvalid: _angular_core.Signal<boolean>;
+    constructor();
+    ngOnInit(): void;
+    load(): void;
+    /** The first error of a field from the last failed save, as a translation key. */
+    fieldError(field: string): string | null;
+    editSettings(): void;
+    saveSettings(): void;
+    removeSettings(): void;
+    addSkill(): void;
+    editSkill(skill: DataSkill): void;
+    toggleTool(selector: string, selected: boolean): void;
+    saveSkill(): void;
+    removeSkill(skill: DataSkill): void;
+    promote(skill: DataSkill): void;
+    discard(skill: DataSkill): void;
+    /** Shows or hides the comparison of a skill's candidate with its live version. */
+    toggleComparison(skill: DataSkill): void;
+    /** Shows or hides the version history of a skill. */
+    toggleVersions(skill: DataSkill): void;
+    addTrigger(): void;
+    editTrigger(trigger: DataTrigger): void;
+    /** A schedule skips a tick while a run is busy by default; an event coalesces. */
+    setTriggerSource(source: 'event' | 'schedule'): void;
+    saveTrigger(): void;
+    setTriggerShadow(trigger: DataTrigger, shadow: boolean): void;
+    removeTrigger(trigger: DataTrigger): void;
+    confirm(action: Confirmation['action'], id: string): void;
+    isConfirming(action: Confirmation['action'], id: string): boolean;
+    cancel(): void;
+    value(event: Event): string;
+    checked(event: Event): boolean;
+    private fillSkill;
+    private fillTrigger;
+    /** Opens one form at a time and moves the focus into it. */
+    private open;
+    /** 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; }; }, { "changed": "changed"; }, never, never, true, never>;
+}
+
 /** Result of the latest connection test per server. */
 interface TestState {
     running: boolean;
@@ -502,5 +662,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, nhAssistantSelectorMatches };
+export { NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentRunConfigurationComponent, nhAssistantSelectorMatches };
 export type { NhAssistantAdminTab, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantSecretAction };