@newheap/platform-ai-chat 0.19.0 → 0.21.0

package/admin/index.d.ts

@@ -1,9 +1,31 @@
+import { TranslationObject } from '@ngx-translate/core';
 import * as _angular_core 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, 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 { 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';
 
+/**
+ * The administration's own translation bundles, keyed by language. All keys live under
+ * `nh-assistant.admin.`. They ship with this entry point, so they load with the administration's
+ * lazy route instead of with the panel; `NH_ASSISTANT_TRANSLATIONS` holds the other texts.
+ */
+declare const NH_ASSISTANT_ADMIN_TRANSLATIONS: Readonly<Record<'en' | 'nl', TranslationObject>>;
+/**
+ * Merges the administration's texts into `TranslateService` whenever the host loads or replaces a
+ * language, like `NhAssistantTranslationMerger` does for the other assistant texts. Keys the host
+ * defines under `nh-assistant.admin.` win. The administration's components start it themselves
+ * unless the assistant leaves translations to the host (`translations: 'host'`).
+ */
+declare class NhAssistantAdminTranslationMerger {
+    private readonly translate;
+    private readonly destroyRef;
+    private started;
+    start(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminTranslationMerger, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NhAssistantAdminTranslationMerger>;
+}
+
 type NhAssistantAdminTab = 'context' | 'agents' | 'mcp-servers';
 /**
  * The assistant administration page with the tabs Context, Agents and MCP servers. The host
@@ -202,7 +224,8 @@ interface StateChange {
  * 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.
+ * its definition. A chat-only agent (`chatOnly`) says so instead of what it works on and offers no
+ * "Run now", runs, run state changes or shadow mode: it never runs on its own.
  */
 declare class NhAssistantAdminAgentsComponent {
     private readonly admin;
@@ -370,6 +393,11 @@ declare class NhAssistantAdminAgentsComponent {
      * 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. */
@@ -495,7 +523,9 @@ type WorksOnScope = 'all' | 'types';
  * 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.
+ * version, with "Unlink" for the definition; a save keeps their values. A new agent is created with its
+ * MCP servers; an existing agent's save sends no `mcpServerIds`, so an assignment made since the editor
+ * opened stays, and then assigns or unassigns only the servers the administrator changed, one by one.
  */
 declare class NhAssistantAdminAgentEditorComponent {
     private readonly admin;
@@ -523,6 +553,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[];
@@ -566,8 +602,14 @@ declare class NhAssistantAdminAgentEditorComponent {
     readonly saving: _angular_core.WritableSignal<boolean>;
     readonly error: _angular_core.WritableSignal<NhAssistantError | null>;
     /**
-     * A new agent that was created while its groups could not be saved yet: the next save completes it
-     * as an existing agent.
+     * The definition was saved, but a change of the MCP servers failed; the next save retries the
+     * changes that are left.
+     */
+    readonly assignmentsFailed: _angular_core.WritableSignal<boolean>;
+    /**
+     * The agent as a save left it when part of the save failed: a new agent that was created while its
+     * groups could not be saved yet, or an agent whose definition was saved while a change of its MCP
+     * servers failed. The next save completes it as an existing agent.
      */
     private readonly created;
     /** The agent the next save updates; `null` while a new agent is not created yet. */
@@ -666,6 +708,14 @@ declare class NhAssistantAdminAgentEditorComponent {
     /** An application field of an agent created here made the agent's next version. */
     fieldsChanged(agentVersion: number): void;
     save(): void;
+    /**
+     * The MCP servers the administrator added or removed, after the definition was saved, one call per
+     * server: removals first, so an agent with as many servers as allowed can swap one, then additions.
+     * Only the assignments change, never the agent's version. The first failure stops the rest: the
+     * editor then keeps the saved agent with the changes that succeeded, so the next save continues on
+     * its version with the changes that are left.
+     */
+    private saveAssignments;
     /** What the agent works on, as the six fields the server reads together. */
     private worksOnInput;
     private reset;
@@ -1692,7 +1742,9 @@ interface ToolDraft {
 /**
  * The tools of one MCP server. Every tool starts disabled as a change that needs approval;
  * the administrator enables it and chooses the effect. Remote annotations appear as hints
- * only, and a changed remote input schema is shown as a warning.
+ * only, and a changed remote input schema is shown as a warning. A tool whose settings were reviewed
+ * before any sync saw it (`awaitingSync`) shows as not seen yet: its settings change here, and the
+ * first sync that finds it on the server makes it available with them.
  */
 declare class NhAssistantAdminMcpToolsComponent {
     private readonly admin;
@@ -1727,5 +1779,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_AGENT_METADATA_EDITORS, NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentMetadataComponent, NhAssistantAgentMetadataSlot, NhAssistantAgentRunConfigurationComponent, NhAssistantAgentRunHistoryComponent, nhAssistantSelectorMatches, provideNhAssistantAgentMetadataEditors };
+export { NH_ASSISTANT_ADMIN_TRANSLATIONS, NH_ASSISTANT_AGENT_METADATA_EDITORS, NH_ASSISTANT_MAX_INSTRUCTIONS, NhAssistantAdminAgentEditorComponent, NhAssistantAdminAgentsComponent, NhAssistantAdminComponent, NhAssistantAdminContextComponent, NhAssistantAdminMcpServerEditorComponent, NhAssistantAdminMcpServersComponent, NhAssistantAdminMcpToolsComponent, NhAssistantAdminTranslationMerger, NhAssistantAgentEvaluationComponent, NhAssistantAgentFeedbackReportComponent, NhAssistantAgentMetadataComponent, NhAssistantAgentMetadataSlot, NhAssistantAgentRunConfigurationComponent, NhAssistantAgentRunHistoryComponent, nhAssistantSelectorMatches, provideNhAssistantAgentMetadataEditors };
 export type { AgentUse, NhAssistantAdminTab, NhAssistantAgentMetadataEditor, NhAssistantAgentMetadataStatus, NhAssistantEvaluationPeriod, NhAssistantFeedbackPeriod, NhAssistantReaderDraft, NhAssistantSecretAction, NhAssistantSecretSource, WorksOnScope };