@newheap/platform-ai-chat 0.12.0 → 0.13.0

package/i18n/en.json

@@ -346,7 +346,11 @@
       "assistant-consult-limit-reached": "You reached the daily number of consultations.",
       "assistant-consult-timeout": "The agent did not answer in time.",
       "assistant-consult-failed": "The agent could not answer.",
-      "assistant-consult-read-only": "A consultation cannot change anything."
+      "assistant-consult-read-only": "A consultation cannot change anything.",
+      "assistant-moved-to-shadow": "The work went to the agent's shadow thread, where a run in shadow takes it.",
+      "assistant-shadow-variant": "A shadow variant always works in shadow.",
+      "assistant-service-account-not-used": "This agent does not answer to a technical account.",
+      "assistant-service-account-not-found": "No account that may sign in exists with this id."
     },
     "notices": {
       "no-answer": "The assistant finished without an answer. Try again or rephrase your question.",
@@ -499,6 +503,49 @@
             "paused": "The skill {{skill}} starts no new runs: its events wait, triage no longer chooses it and running work finishes. The other skills keep working.",
             "stopped": "The runs of the skill {{skill}} are cancelled and its waiting events dropped; its triggers are refused. The other skills keep working."
           }
+        },
+        "shadow": {
+          "badge": "Shadow",
+          "hint": "Its work goes to shadow threads that only administrators see.",
+          "changed": "Shadow mode set by {{user}} on {{date}}.",
+          "locked": "A shadow variant always works in shadow.",
+          "action": {
+            "shadow": "Put in shadow",
+            "live": "Put live",
+            "code": "Follow the code"
+          },
+          "explain": {
+            "shadow": "New runs work in shadow threads that only administrators see: nobody is notified and nothing proposed there executes. Running work finishes as it started; the live threads and their open proposals stay.",
+            "live": "New runs work live: people see them, are notified and decide their proposals.",
+            "code": "The mode in code decides again."
+          },
+          "skill-explain": {
+            "shadow": "Work that reaches the skill {{skill}} goes to the shadow threads; the other skills keep their mode.",
+            "live": "The skill {{skill}} works live again, unless its agent works in shadow.",
+            "code": "The mode in code decides again for the skill {{skill}}."
+          },
+          "confirm": {
+            "shadow": "Confirm shadow",
+            "live": "Confirm live",
+            "code": "Confirm"
+          }
+        },
+        "service-account": {
+          "label": "Technical account: {{account}}",
+          "configured": "In code: {{account}}",
+          "input-label": "Account id",
+          "action": {
+            "set": "Change technical account",
+            "code": "Use the account in code"
+          },
+          "explain": {
+            "set": "New runs answer to this account and use its rights. Runs that started and their proposals keep their account.",
+            "code": "New runs answer to the account in code again: {{account}}."
+          },
+          "confirm": {
+            "set": "Confirm account",
+            "code": "Confirm"
+          }
         }
       },
       "agent-editor": {
@@ -819,7 +866,8 @@
           "ignored": "The agent is busy; nothing was started.",
           "deduplicated": "This was already started.",
           "rejected": "The agent could not be started."
-        }
+        },
+        "shadow": "Shadow thread: only administrators see it, and nothing proposed here executes."
       },
       "subject": {
         "title": "Agent suggestions",

package/i18n/nl.json

@@ -346,7 +346,11 @@
       "assistant-consult-limit-reached": "Je hebt het aantal raadplegingen voor vandaag bereikt.",
       "assistant-consult-timeout": "De agent antwoordde niet op tijd.",
       "assistant-consult-failed": "De agent kon niet antwoorden.",
-      "assistant-consult-read-only": "Een raadpleging kan niets wijzigen."
+      "assistant-consult-read-only": "Een raadpleging kan niets wijzigen.",
+      "assistant-moved-to-shadow": "Het werk is naar de schaduwthread van de agent gegaan, waar een run in schaduw het oppakt.",
+      "assistant-shadow-variant": "Een schaduwvariant werkt altijd in schaduw.",
+      "assistant-service-account-not-used": "Deze agent werkt niet onder een technisch account.",
+      "assistant-service-account-not-found": "Er bestaat geen account met deze id dat mag inloggen."
     },
     "notices": {
       "no-answer": "De assistent is klaar zonder antwoord. Probeer het opnieuw of stel je vraag anders.",
@@ -499,6 +503,49 @@
             "paused": "De vaardigheid {{skill}} start geen nieuwe runs: haar gebeurtenissen wachten, triage kiest haar niet meer en lopend werk wordt afgemaakt. De andere vaardigheden werken door.",
             "stopped": "De runs van de vaardigheid {{skill}} worden geannuleerd en haar wachtende gebeurtenissen vervallen; haar triggers worden geweigerd. De andere vaardigheden werken door."
           }
+        },
+        "shadow": {
+          "badge": "Schaduw",
+          "hint": "Het werk gaat naar schaduwthreads die alleen beheerders zien.",
+          "changed": "Schaduwmodus ingesteld door {{user}} op {{date}}.",
+          "locked": "Een schaduwvariant werkt altijd in schaduw.",
+          "action": {
+            "shadow": "In schaduw zetten",
+            "live": "Live zetten",
+            "code": "Code laten beslissen"
+          },
+          "explain": {
+            "shadow": "Nieuwe runs werken in schaduwthreads die alleen beheerders zien: niemand krijgt een melding en niets wat daar wordt voorgesteld, wordt uitgevoerd. Lopend werk wordt afgemaakt zoals het begon; de live threads en hun open voorstellen blijven.",
+            "live": "Nieuwe runs werken live: mensen zien ze, krijgen meldingen en beslissen over de voorstellen.",
+            "code": "De modus in de code beslist weer."
+          },
+          "skill-explain": {
+            "shadow": "Werk dat bij de vaardigheid {{skill}} komt, gaat naar de schaduwthreads; de andere vaardigheden houden hun modus.",
+            "live": "De vaardigheid {{skill}} werkt weer live, tenzij haar agent in schaduw werkt.",
+            "code": "De modus in de code beslist weer voor de vaardigheid {{skill}}."
+          },
+          "confirm": {
+            "shadow": "Schaduw bevestigen",
+            "live": "Live bevestigen",
+            "code": "Bevestigen"
+          }
+        },
+        "service-account": {
+          "label": "Technisch account: {{account}}",
+          "configured": "In de code: {{account}}",
+          "input-label": "Account-id",
+          "action": {
+            "set": "Technisch account wijzigen",
+            "code": "Account uit de code gebruiken"
+          },
+          "explain": {
+            "set": "Nieuwe runs werken onder dit account en met zijn rechten. Runs die al begonnen en hun voorstellen houden hun account.",
+            "code": "Nieuwe runs werken weer onder het account uit de code: {{account}}."
+          },
+          "confirm": {
+            "set": "Account bevestigen",
+            "code": "Bevestigen"
+          }
         }
       },
       "agent-editor": {
@@ -819,7 +866,8 @@
           "ignored": "De agent is bezig; er is niets gestart.",
           "deduplicated": "Dit was al gestart.",
           "rejected": "De agent kon niet starten."
-        }
+        },
+        "shadow": "Schaduwthread: alleen beheerders zien hem, en niets wat hier wordt voorgesteld, wordt uitgevoerd."
       },
       "subject": {
         "title": "Voorstellen van agents",

package/index.d.ts

@@ -74,6 +74,11 @@ interface AgentThread {
     role: AgentSubjectRole;
     activeRun: AgentRun | null;
     waitingInputs: number;
+    /**
+     * The thread holds the agent's shadow work about the subject: only administrators see it,
+     * nobody is notified and nothing proposed in it executes.
+     */
+    shadow?: boolean;
 }
 interface AgentThreadLookup {
     thread: AgentThread | null;
@@ -94,6 +99,11 @@ interface AgentSubjectWorkAgent {
     agentId: string;
     thread: AgentThread | null;
     canStart: boolean;
+    /**
+     * For administrators, the agent's shadow thread about the subject while the agent or one of its
+     * skills works in shadow; missing or `null` otherwise.
+     */
+    shadowThread?: AgentThread | null;
 }
 /**
  * A proposal on a subject with the caller's live decision right. Only a pending proposal can be
@@ -823,6 +833,41 @@ interface AdminAgent extends AdminAgentInput {
     skills?: AgentSkillState[];
     /** The live agent this agent is a shadow variant of; missing or null for an agent that is no variant. */
     shadowOf?: string | null;
+    /** Whether the agent works in shadow, and how the code and an administrator decided it. */
+    shadow?: AgentShadowState | null;
+    /** The technical account that answers for the agent's new runs; null when it answers to none. */
+    serviceAccount?: AgentServiceAccountState | null;
+}
+/** The shadow modes an administrator chooses; `code` lets the mode in code decide again. */
+type AgentShadowMode = 'shadow' | 'live' | 'code';
+/**
+ * The shadow mode of an agent or a skill. In shadow the work goes to the agent's shadow threads,
+ * which only administrators see; nobody is notified and nothing proposed there executes.
+ */
+interface AgentShadowState {
+    /** Whether the work goes to shadow threads now; for a skill this includes the agent's mode. */
+    shadow: boolean;
+    /** The mode in code: `Shadow()` on the agent or the skill. */
+    configured: boolean;
+    /** The mode an administrator set at runtime; `null` follows the code. */
+    override: boolean | null;
+    /** A shadow variant always works in shadow; its mode cannot change. */
+    locked: boolean;
+    changedAt: string | null;
+    changedBy: string | null;
+    reason: string | null;
+}
+/** The technical account of an agent that answers to one. */
+interface AgentServiceAccountState {
+    /** The account that answers for the agent's new runs. */
+    actorId: string;
+    /** The account in code. */
+    configuredActorId: string;
+    /** Whether an administrator set `actorId` at runtime. */
+    overridden: boolean;
+    changedAt: string | null;
+    changedBy: string | null;
+    reason: string | null;
 }
 /** One skill of an agent with its own state and today's usage across scopes. */
 interface AgentSkillState {
@@ -841,6 +886,8 @@ interface AgentSkillState {
     dailyTokens: number | null;
     cancelledRuns: number;
     startedRuns: number;
+    /** Whether the skill's work goes to the agent's shadow threads. */
+    shadow?: AgentShadowState;
 }
 /** Response of `GET` and `POST admin/agents/{id}/state`. */
 interface AgentState {
@@ -858,6 +905,21 @@ interface AgentState {
     startedRuns: number;
     skills?: AgentSkillState[];
     shadowOf?: string | null;
+    /** `null` for an agent without runs, which only chats. */
+    shadow?: AgentShadowState | null;
+    serviceAccount?: AgentServiceAccountState | null;
+}
+/** Body of `POST admin/agents/{id}/shadow` and `POST admin/agents/{id}/skills/{skillId}/shadow`. */
+interface SetAgentShadowRequest {
+    mode: AgentShadowMode;
+    /** Optional, at most 500 characters. */
+    reason?: string | null;
+}
+/** Body of `POST admin/agents/{id}/service-account`. `null` uses the account in code again. */
+interface SetAgentServiceAccountRequest {
+    actorId: string | null;
+    /** Optional, at most 500 characters. */
+    reason?: string | null;
 }
 /** Body of `POST admin/agents/{id}/state`. `active` resumes the agent. */
 interface SetAgentStateRequest {
@@ -1413,6 +1475,19 @@ declare class NhAssistantAdminApiService {
      * Pauses, stops or resumes one skill of an agent; its other skills keep working.
      */
     setSkillState(agentId: string, skillId: string, request: SetAgentStateRequest): Observable<AgentSkillState>;
+    /**
+     * Puts an agent in shadow, live, or back to the mode in code. A shadow variant cannot change
+     * (`assistant-shadow-variant`).
+     */
+    setAgentShadow(agentId: string, request: SetAgentShadowRequest): Observable<AgentState>;
+    /** Puts one skill of an agent in shadow, live, or back to the mode in code. */
+    setSkillShadow(agentId: string, skillId: string, request: SetAgentShadowRequest): Observable<AgentSkillState>;
+    /**
+     * Changes the technical account that answers for the agent's new runs, or with `actorId: null`
+     * uses the account in code again. Fails with `assistant-service-account-not-found` for an
+     * account that does not exist or may not sign in.
+     */
+    setServiceAccount(agentId: string, request: SetAgentServiceAccountRequest): Observable<AgentState>;
     /** Deletes an admin agent. Code agents cannot be deleted; stop them instead. */
     deleteAgent(agentId: string): Observable<void>;
     getMcpServers(): Observable<McpServer[]>;
@@ -2737,4 +2812,4 @@ declare function nhAssistantErrorKeys(error: NhAssistantError | null): string[];
 declare const NH_ASSISTANT_DASH_CASE: RegExp;
 
 export { NH_ASSISTANT_ACCESS_POLICY, NH_ASSISTANT_CONFIG, NH_ASSISTANT_CONVERSATION_FRAGMENT, NH_ASSISTANT_FEEDBACK_CATEGORIES, NH_ASSISTANT_FEEDBACK_GROUPS, NH_ASSISTANT_FETCH, NH_ASSISTANT_ICONS, NH_ASSISTANT_JOIN_FRAGMENT, NH_ASSISTANT_MAX_BULK_FEEDBACK, NH_ASSISTANT_MAX_CUSTOM_INSTRUCTIONS, NH_ASSISTANT_MAX_FEEDBACK_TEXT, NH_ASSISTANT_MAX_PROPOSAL_LOOKUP, NH_ASSISTANT_MAX_SUBJECT_SUMMARY, NH_ASSISTANT_NO_ANSWER_NOTICE_CODE, NH_ASSISTANT_PAGE_CONTEXT_LIMITS, NH_ASSISTANT_PANEL_MOBILE_QUERY, NH_ASSISTANT_PANEL_WIDTH, NH_ASSISTANT_SSE_EVENT_TYPES, NH_ASSISTANT_TRANSLATIONS, NH_ASSISTANT_VIRTUAL_SCROLL_THRESHOLD, NhAssistantActivityComponent, NhAssistantAdminApiService, NhAssistantAgentPickerComponent, NhAssistantAgentRunApiService, NhAssistantAllowAllAccessPolicy, NhAssistantApiError, NhAssistantApiService, NhAssistantApprovalCardComponent, NhAssistantClientErrorCodes, NhAssistantComposerComponent, NhAssistantConversationListComponent, NhAssistantLauncherComponent, NhAssistantLiveService, NhAssistantPanelComponent, NhAssistantPanelService, NhAssistantPreferencesComponent, NhAssistantProposalFeedbackComponent, NhAssistantPushService, NhAssistantShareComponent, NhAssistantSseParser, NhAssistantStore, NhAssistantSubjectBadgeComponent, NhAssistantSubjectSummaryService, NhAssistantThreadComponent, NhAssistantToolCallCardComponent, NhAssistantToolCallGroupComponent, NhAssistantTranslationMerger, applyNhAssistantApprovalDecision, applyNhAssistantConversationChange, applyNhAssistantEvent, applyNhAssistantLiveEvent, describeNhAssistantClientContext, formatNhAssistantCountdown, nhAssistantCodeForStatus, nhAssistantErrorMessageKey, nhAssistantIsUnread, nhAssistantLatestTurnHasText, nhAssistantShareLink, normalizeNhAssistantClientContext, provideNhAssistant, NH_ASSISTANT_DASH_CASE as ɵNH_ASSISTANT_DASH_CASE, NhAssistantIconComponent as ɵNhAssistantIconComponent, NhAssistantTranslatePipe as ɵNhAssistantTranslatePipe, nhAssistantErrorKeys as ɵnhAssistantErrorKeys, nhAssistantReloadOnAgentWork as ɵnhAssistantReloadOnAgentWork, toNhAssistantError as ɵtoNhAssistantError };
-export type { AdminAgent, AdminAgentInput, AgentArtifact, AgentConsultation, AgentConsultationList, AgentConsultationStatus, AgentDecisionOutcome, AgentEvaluation, AgentEvaluationCost, AgentEvaluationDecisions, AgentEvaluationDifference, AgentEvaluationFilter, AgentEvaluationRouting, AgentEvaluationRuns, AgentEvaluationTool, AgentExecutionResolution, AgentFeedbackCategoryCount, AgentFeedbackExportFilter, AgentFeedbackFilter, AgentFeedbackItem, AgentFeedbackList, AgentFeedbackListFilter, AgentFeedbackOutcome, AgentFeedbackSummary, AgentFeedbackSummaryRow, AgentGrantSource, AgentInbox, AgentInboxFilter, AgentInvalidationCount, AgentProposal, AgentProposalDecision, AgentProposalDecisionRight, AgentProposalFeedback, AgentProposalFeedbackCategory, AgentProposalFeedbackGroup, AgentProposalLookup, AgentProposalObject, AgentProposalStatus, AgentReplay, AgentReplayList, AgentReplayRequest, AgentRun, AgentRunKind, AgentRunList, AgentRunRetryMode, AgentRunState, AgentRunStatus, AgentSkillChooser, AgentSkillState, AgentState, AgentSubjectRole, AgentSubjectSummary, AgentSubjectSummaryList, AgentSubjectWork, AgentSubjectWorkAgent, AgentSubjectWorkProposal, AgentSummary, AgentThread, AgentThreadLookup, AgentThreadMemory, AgentTriggerReceipt, ApplicationContext, ApplicationContextVersion, ApprovalDecision, ApprovalPart, ApprovalPresentation, ApprovalPresentationField, ApprovalRequiredEvent, ApprovalStatus, AssistantAddressForm, AssistantAutonomy, AssistantCollaboration, AssistantErrorEvent, AssistantPreferences, AssistantResponseLength, AssistantStatus, AssistantStyle, ClientContext, ClientContextEntity, Conversation, ConversationKind, ConversationMember, ConversationPage, ConversationRole, ConversationStatus, ConversationSummary, ConversationThread, ConversationThreadDecision, CreateConversationRequest, DecideApprovalRequest, DirectoryEntry, LiveAgentWorkChanged, LiveAgentWorkReason, LiveConversationChanged, LiveConversationEvent, LiveConversationRead, LiveConversationRemoved, McpAuthMode, McpServer, McpServerInput, McpServerTestResult, McpTool, McpToolEffect, McpToolStatus, Message, MessageAuthorKind, MessageDeltaEvent, MessagePart, NhAssistantAccessPolicy, NhAssistantActivity, NhAssistantApprovalChoice, NhAssistantApprovalRight, NhAssistantApprovalWaitingFor, NhAssistantClientContext, NhAssistantClientErrorCode, NhAssistantConfig, NhAssistantError, NhAssistantFetch, NhAssistantIconName, NhAssistantLiveState, NhAssistantNotice, NhAssistantProposalFeedbackSaved, NhAssistantPushConfig, NhAssistantPushState, NhAssistantQueuedMessage, NhAssistantRawSseMessage, NhAssistantSseEvent, NhAssistantSseEventMap, NhAssistantSseEventType, NhAssistantStatusCodes, NhAssistantToolCallGroupState, NotificationSettings, PushSubscriptionRequest, SendMessageRequest, SetAgentStateRequest, ShareLink, StaleKind, StartAgentRequest, TextPart, ToolCallPart, ToolCallStatus, ToolCatalogEffect, ToolCatalogEntry, ToolCompletedEvent, ToolStartedEvent, TurnCompletedEvent, TurnCompletionStatus, TurnStartedEvent, TurnUsage, UpdateAdminAgentRequest, UpdateApplicationContextRequest, UpdateMcpToolRequest };
+export type { AdminAgent, AdminAgentInput, AgentArtifact, AgentConsultation, AgentConsultationList, AgentConsultationStatus, AgentDecisionOutcome, AgentEvaluation, AgentEvaluationCost, AgentEvaluationDecisions, AgentEvaluationDifference, AgentEvaluationFilter, AgentEvaluationRouting, AgentEvaluationRuns, AgentEvaluationTool, AgentExecutionResolution, AgentFeedbackCategoryCount, AgentFeedbackExportFilter, AgentFeedbackFilter, AgentFeedbackItem, AgentFeedbackList, AgentFeedbackListFilter, AgentFeedbackOutcome, AgentFeedbackSummary, AgentFeedbackSummaryRow, AgentGrantSource, AgentInbox, AgentInboxFilter, AgentInvalidationCount, AgentProposal, AgentProposalDecision, AgentProposalDecisionRight, AgentProposalFeedback, AgentProposalFeedbackCategory, AgentProposalFeedbackGroup, AgentProposalLookup, AgentProposalObject, AgentProposalStatus, AgentReplay, AgentReplayList, AgentReplayRequest, AgentRun, AgentRunKind, AgentRunList, AgentRunRetryMode, AgentRunState, AgentRunStatus, AgentServiceAccountState, AgentShadowMode, AgentShadowState, AgentSkillChooser, AgentSkillState, AgentState, AgentSubjectRole, AgentSubjectSummary, AgentSubjectSummaryList, AgentSubjectWork, AgentSubjectWorkAgent, AgentSubjectWorkProposal, AgentSummary, AgentThread, AgentThreadLookup, AgentThreadMemory, AgentTriggerReceipt, ApplicationContext, ApplicationContextVersion, ApprovalDecision, ApprovalPart, ApprovalPresentation, ApprovalPresentationField, ApprovalRequiredEvent, ApprovalStatus, AssistantAddressForm, AssistantAutonomy, AssistantCollaboration, AssistantErrorEvent, AssistantPreferences, AssistantResponseLength, AssistantStatus, AssistantStyle, ClientContext, ClientContextEntity, Conversation, ConversationKind, ConversationMember, ConversationPage, ConversationRole, ConversationStatus, ConversationSummary, ConversationThread, ConversationThreadDecision, CreateConversationRequest, DecideApprovalRequest, DirectoryEntry, LiveAgentWorkChanged, LiveAgentWorkReason, LiveConversationChanged, LiveConversationEvent, LiveConversationRead, LiveConversationRemoved, McpAuthMode, McpServer, McpServerInput, McpServerTestResult, McpTool, McpToolEffect, McpToolStatus, Message, MessageAuthorKind, MessageDeltaEvent, MessagePart, NhAssistantAccessPolicy, NhAssistantActivity, NhAssistantApprovalChoice, NhAssistantApprovalRight, NhAssistantApprovalWaitingFor, NhAssistantClientContext, NhAssistantClientErrorCode, NhAssistantConfig, NhAssistantError, NhAssistantFetch, NhAssistantIconName, NhAssistantLiveState, NhAssistantNotice, NhAssistantProposalFeedbackSaved, NhAssistantPushConfig, NhAssistantPushState, NhAssistantQueuedMessage, NhAssistantRawSseMessage, NhAssistantSseEvent, NhAssistantSseEventMap, NhAssistantSseEventType, NhAssistantStatusCodes, NhAssistantToolCallGroupState, NotificationSettings, PushSubscriptionRequest, SendMessageRequest, SetAgentServiceAccountRequest, SetAgentShadowRequest, SetAgentStateRequest, ShareLink, StaleKind, StartAgentRequest, TextPart, ToolCallPart, ToolCallStatus, ToolCatalogEffect, ToolCatalogEntry, ToolCompletedEvent, ToolStartedEvent, TurnCompletedEvent, TurnCompletionStatus, TurnStartedEvent, TurnUsage, UpdateAdminAgentRequest, UpdateApplicationContextRequest, UpdateMcpToolRequest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newheap/platform-ai-chat",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",

package/testing/index.d.ts

@@ -95,13 +95,18 @@ interface NhAssistantMockMcpServer extends McpServerInput {
 /** A preconfigured agent. Code agents default to the scenario's chat agents. */
 interface NhAssistantMockAdminAgent extends AdminAgentInput {
     source: 'code' | 'admin';
-    /** The skills of a code agent, by id and description; they start active. */
+    /** The skills of a code agent, by id and description; they start active, and in shadow with `shadow`. */
     skills?: {
         skillId: string;
         description: string;
+        shadow?: boolean;
     }[];
     /** The live agent this code agent is a shadow variant of. */
     shadowOf?: string;
+    /** The agent starts in shadow, as with `Shadow()` in code. */
+    shadow?: boolean;
+    /** The technical account in code, as with `ServiceAccount(actorId)`. */
+    serviceAccount?: string;
 }
 /**
  * Administration data of the mock. Hosts without an admin scenario still get working