@newheap/platform-ai-chat 0.12.0 → 0.14.0

package/index.d.ts

@@ -12,7 +12,7 @@ import { TemplatePortal } from '@angular/cdk/portal';
 type AgentSubjectRole = 'none' | 'reader' | 'participant' | 'approver';
 type AgentRunStatus = 'queued' | 'running' | 'waiting-for-approval' | 'completed' | 'failed' | 'cancelled';
 type AgentProposalStatus = 'pending' | 'approved' | 'rejected' | 'expired' | 'withdrawn' | 'stale' | 'executing' | 'executed' | 'execution-failed' | 'execution-unknown' | 'resolved' | 'shadow';
-type AgentGrantSource = 'none' | 'delegated' | 'agent' | 'delegated-read';
+type AgentGrantSource = 'none' | 'delegated' | 'agent' | 'delegated-read' | 'accountable';
 /**
  * How a run worked: `model` through the language model, `rule` through the agent's rules without a
  * model, `rule-then-model` when the rules handed the run over to the model.
@@ -49,6 +49,10 @@ interface AgentRun {
     /** The skill of the agent the run worked in; missing or null for the agent's own tools. */
     skill?: string | null;
     skillChosenBy?: AgentSkillChooser | null;
+    /** The version of a skill defined as data the run worked in; absent for a skill in code. */
+    skillVersion?: number | null;
+    /** The run evaluated a candidate version of its skill in the shadow thread. */
+    skillCandidate?: boolean;
     /** The agent that handed the run's work off; missing or null for a run no agent asked for. */
     requestedByAgentId?: string | null;
     /**
@@ -74,6 +78,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 +103,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
@@ -494,7 +508,7 @@ interface ToolCallPart {
      * `delegated`, `agent` or `delegated-read` when an agent used rights beyond the caller's own:
      * the initiator's, its own grant, or a person's through a gateway read.
      */
-    grantSource?: 'delegated' | 'agent' | 'delegated-read' | null;
+    grantSource?: 'delegated' | 'agent' | 'delegated-read' | 'accountable' | null;
     /** The result came from rights this viewer does not have and is shielded from them. */
     restricted?: boolean;
 }
@@ -823,6 +837,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 +890,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 +909,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 {
@@ -1151,6 +1217,271 @@ interface AgentFeedbackList {
     items: AgentFeedbackItem[];
     total: number;
 }
+/** A building block registered in code that run configuration as data names. */
+interface RunBlock {
+    name: string;
+    description: string;
+}
+/** Response of `GET admin/run-catalog`: what skills, triggers and run settings defined as data can name. */
+interface RunCatalog {
+    triggerEvents: RunBlock[];
+    subjectSets: RunBlock[];
+    ruleHandlers: RunBlock[];
+    approvalPolicies: string[];
+    /** Chat profiles with function calling and streaming. */
+    profiles: string[];
+}
+/** Which part of the run configuration a problem concerns. */
+type RunConfigurationProblemKind = 'agent' | 'skill' | 'candidate' | 'trigger';
+/**
+ * Data that is out of effect because it no longer fits the code, for example after a deploy removed
+ * a profile, policy, rule handler, event or subject set it names.
+ */
+interface RunConfigurationProblem {
+    agentId: string;
+    kind: RunConfigurationProblemKind;
+    /** The agent, skill or trigger id. */
+    id: string;
+    /** Such as `unknown-event` or `tool-not-covered`. */
+    code: string;
+}
+/** Whom an agent answers to. */
+type AgentAccountability = 'agent' | 'subject-responsible' | 'service-account';
+/** Reads with rights beyond the thread's readers: shielded from them, or refused. */
+type AgentElevatedReads = 'restricted' | 'deny';
+/**
+ * The run settings of an agent created in the administration. Grants are never data: in headless
+ * runs the agent acts with the rights of the account it answers to, within its tool selectors.
+ */
+interface AgentRunSettings {
+    version: number;
+    accountability: AgentAccountability;
+    serviceAccountActorId: string | null;
+    delegateFromInitiator: boolean;
+    allowGatewayReads: boolean;
+    elevatedReads: AgentElevatedReads;
+    approvalPolicy: string | null;
+    retryCount: number;
+    dailyToolCalls: number | null;
+    dailyTokens: number | null;
+    maxConcurrentRuns: number;
+    maxRunsPerSubjectPerDay: number;
+    maxTokensPerRun: number | null;
+    triageProfile: string | null;
+    ruleHandler: string | null;
+    changedAt: string;
+    changedBy: string;
+    reason: string | null;
+    inEffect: boolean;
+    problem: string | null;
+}
+/** Body of `PUT admin/agents/{id}/run-settings`. */
+interface AgentRunSettingsRequest {
+    accountability: AgentAccountability;
+    /** For `service-account` only: an account that exists and may sign in. */
+    serviceAccountActorId?: string | null;
+    delegateFromInitiator?: boolean;
+    /** Not for an agent that answers to itself. */
+    allowGatewayReads?: boolean;
+    elevatedReads?: AgentElevatedReads;
+    approvalPolicy?: string | null;
+    /** 0 to 10; 3 by default. */
+    retryCount?: number | null;
+    /** With `dailyTokens`, the daily budget per scope. */
+    dailyToolCalls?: number | null;
+    dailyTokens?: number | null;
+    /** 1 to 100; 4 by default. */
+    maxConcurrentRuns?: number | null;
+    /** 1 to 1,000; 10 by default. */
+    maxRunsPerSubjectPerDay?: number | null;
+    maxTokensPerRun?: number | null;
+    triageProfile?: string | null;
+    ruleHandler?: string | null;
+    /** The settings' current version; `null` for new settings. */
+    expectedVersion?: number | null;
+    /** Optional, at most 500 characters. */
+    reason?: string | null;
+}
+/** A skill the agent declares in code; it cannot change here. */
+interface CodeSkill {
+    skillId: string;
+    description: string;
+}
+/** A trigger registered in code; it cannot change here. */
+interface CodeTrigger {
+    triggerId: string;
+    source: 'event' | 'schedule' | 'webhook';
+    skillId: string | null;
+}
+/** One version of a skill defined as data. */
+interface DataSkill {
+    skillId: string;
+    version: number;
+    description: string;
+    instructions: string | null;
+    instructionsHash: string | null;
+    tools: string[];
+    profile: string | null;
+    ruleHandler: string | null;
+    maxTokensPerRun: number | null;
+    dailyToolCalls: number | null;
+    dailyTokens: number | null;
+    approvalPolicy: string | null;
+    changedAt: string;
+    changedBy: string;
+    reason: string | null;
+    /** `false` with `problem` when the version no longer fits the code. */
+    inEffect: boolean;
+    problem: string | null;
+    /** The candidate that runs in shadow next to this live version; missing or null without one. */
+    candidate?: DataSkill | null;
+}
+/** How a change of a skill takes effect: at once, or as a candidate in shadow next to the live version. */
+type SkillApplyMode = 'live' | 'shadow';
+/** Body of `PUT admin/agents/{id}/skills/{skillId}`. */
+interface DataSkillRequest {
+    /** At most 300 characters; triage and `use_skill` choose by it. */
+    description: string;
+    /** At most 20,000 characters. */
+    instructions?: string | null;
+    /** Within the agent's own tool selectors; empty uses the agent's. */
+    tools?: string[];
+    profile?: string | null;
+    ruleHandler?: string | null;
+    maxTokensPerRun?: number | null;
+    dailyToolCalls?: number | null;
+    dailyTokens?: number | null;
+    approvalPolicy?: string | null;
+    /** The live version the change was made on; `null` for a new skill. */
+    expectedVersion?: number | null;
+    reason?: string | null;
+    /** For a change of a skill; `live` by default. */
+    apply?: SkillApplyMode;
+}
+type DataSkillVersionStatus = 'live' | 'candidate' | 'superseded' | 'discarded';
+/** One version in the history of a skill defined as data. */
+interface DataSkillVersion {
+    version: number;
+    status: DataSkillVersionStatus;
+    description: string;
+    instructionsHash: string | null;
+    createdAt: string;
+    createdBy: string;
+    reason: string | null;
+}
+/** Body of `POST admin/agents/{id}/skills/{skillId}/candidate/promote` and `.../discard`. */
+interface SkillCandidateRequest {
+    /** The candidate version the change is for. */
+    version: number;
+    reason?: string | null;
+}
+/** The runs of one version in a comparison. */
+interface SkillVersionStats {
+    version: number;
+    runs: number;
+    completed: number;
+    failed: number;
+    proposals: number;
+    toolCalls: number;
+    tokens: number;
+}
+/** The proposals of both versions for one tool. */
+interface SkillComparisonTool {
+    toolId: string;
+    liveProposals: number;
+    candidateProposals: number;
+    liveApproved: number;
+    liveRejected: number;
+}
+/** Response of `GET admin/agents/{id}/skills/{skillId}/candidate/comparison`. Counts only. */
+interface SkillComparison {
+    agentId: string;
+    skillId: string;
+    from: string;
+    to: string;
+    live: SkillVersionStats;
+    candidate: SkillVersionStats;
+    /** The events both versions handled. */
+    pairedEvents: number;
+    tools: SkillComparisonTool[];
+}
+/** Optional period of a comparison; it starts when the candidate was saved by default. */
+interface SkillComparisonFilter {
+    from?: string;
+    to?: string;
+}
+/** What happens to an event while a run on the subject is active. */
+type TriggerConflict = 'coalesce' | 'queue' | 'supersede' | 'ignore';
+/** A trigger defined as data: a named event or a schedule that starts the agent. */
+interface DataTrigger {
+    triggerId: string;
+    skillId: string | null;
+    source: 'event' | 'schedule';
+    event: string | null;
+    cron: string | null;
+    timeZone: string | null;
+    subjectSet: string | null;
+    message: string | null;
+    conflict: TriggerConflict;
+    debounceSeconds: number;
+    /** In shadow its runs work in the agent's shadow threads. A new trigger starts in shadow. */
+    shadow: boolean;
+    version: number;
+    changedAt: string;
+    changedBy: string;
+    reason: string | null;
+    inEffect: boolean;
+    problem: string | null;
+}
+/** Body of `PUT admin/agents/{id}/triggers/{triggerId}`. */
+interface DataTriggerRequest {
+    source: 'event' | 'schedule';
+    /** The skill the runs work in; empty lets the agent's rules or triage choose. */
+    skill?: string | null;
+    /** For an event trigger: a registered trigger event. */
+    event?: string | null;
+    /** For a schedule: a five- or six-field cron expression. */
+    cron?: string | null;
+    /** For a schedule: an IANA or Windows time zone; UTC by default. */
+    timeZone?: string | null;
+    /** For a schedule: a registered subject set. */
+    subjectSet?: string | null;
+    /** For a schedule: what every run receives, at most 2,000 characters. */
+    message?: string | null;
+    conflict?: TriggerConflict | null;
+    /** For an event trigger: at most 3,600; 120 by default. */
+    debounceSeconds?: number | null;
+    /** The trigger's current version; `null` for a new trigger. */
+    expectedVersion?: number | null;
+    reason?: string | null;
+}
+/** Body of `POST admin/agents/{id}/triggers/{triggerId}/shadow`. */
+interface DataTriggerShadowRequest {
+    mode: 'shadow' | 'live';
+    reason?: string | null;
+}
+/** Query of the removals of run settings, data skills and data triggers. */
+interface RunConfigurationRemoval {
+    expectedVersion?: number | null;
+    reason?: string | null;
+}
+/**
+ * Response of `GET admin/agents/{id}/configuration`: the agent's run settings, skills and triggers,
+ * in code and as data, and the data that no longer fits the code.
+ */
+interface AgentRunConfiguration {
+    agentId: string;
+    /** The agent's own tool selectors; a data skill's tools stay within them. */
+    toolSelectors: string[];
+    codeSkills: CodeSkill[];
+    dataSkills: DataSkill[];
+    codeTriggers: CodeTrigger[];
+    dataTriggers: DataTrigger[];
+    problems: RunConfigurationProblem[];
+    source: 'code' | 'admin';
+    /** The run settings of an agent created in the administration; `null` for an agent in code and one that only chats. */
+    runSettings: AgentRunSettings | null;
+}
 
 /** Decides whether the current user may see and use the assistant. */
 interface NhAssistantAccessPolicy {
@@ -1324,7 +1655,17 @@ declare class NhAssistantApiError extends Error {
     readonly status: number;
     readonly code: string;
     readonly messageKey: string;
-    constructor(status: number, code: string, messageKey: string);
+    /**
+     * The field errors of an `assistant-validation` response: camelCase field names with stable
+     * values such as `required`, `invalid`, `too-long` or `not-found`. Empty otherwise.
+     */
+    readonly fieldErrors: Readonly<Record<string, readonly string[]>>;
+    constructor(status: number, code: string, messageKey: string, 
+    /**
+     * The field errors of an `assistant-validation` response: camelCase field names with stable
+     * values such as `required`, `invalid`, `too-long` or `not-found`. Empty otherwise.
+     */
+    fieldErrors?: Readonly<Record<string, readonly string[]>>);
 }
 /** Translation key that belongs to a failure code. */
 declare function nhAssistantErrorMessageKey(code: string): string;
@@ -1413,6 +1754,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[]>;
@@ -1454,6 +1808,41 @@ declare class NhAssistantAdminApiService {
     startAgentReplay(variantId: string, request: AgentReplayRequest): Observable<AgentReplay>;
     /** The latest replays into a shadow variant, newest first. */
     getAgentReplays(variantId: string): Observable<AgentReplayList>;
+    /** The building blocks in code that run settings, skills and triggers defined as data can name. */
+    getRunCatalog(): Observable<RunCatalog>;
+    /**
+     * The agent's run settings, skills and triggers, in code and as data, and the data that no longer
+     * fits the code. An agent in code without a run configuration answers `assistant-agent-not-found`.
+     */
+    getAgentConfiguration(agentId: string): Observable<AgentRunConfiguration>;
+    /**
+     * Adds or changes the run settings of an agent created in the administration. An agent in code
+     * fails with `assistant-run-settings-in-code`; an unknown technical account with
+     * `assistant-service-account-not-found`.
+     */
+    saveRunSettings(agentId: string, request: AgentRunSettingsRequest): Observable<AgentRunSettings>;
+    /** Removes the run settings; while data skills or triggers belong to the agent, `assistant-run-settings-in-use`. */
+    removeRunSettings(agentId: string, removal?: RunConfigurationRemoval): Observable<void>;
+    /**
+     * Adds a skill defined as data, which starts in shadow, or stores its next version: with `apply`
+     * `live` at once, with `shadow` as the candidate that runs in shadow next to the live version.
+     */
+    saveDataSkill(agentId: string, skillId: string, request: DataSkillRequest): Observable<DataSkill>;
+    /** Takes a skill defined as data out of effect; while a data trigger names it, `assistant-skill-in-use`. */
+    removeDataSkill(agentId: string, skillId: string, removal?: RunConfigurationRemoval): Observable<void>;
+    /** Every version of a skill defined as data, newest first. */
+    getDataSkillVersions(agentId: string, skillId: string): Observable<DataSkillVersion[]>;
+    /** Makes the candidate the live version of its skill. */
+    promoteSkillCandidate(agentId: string, skillId: string, request: SkillCandidateRequest): Observable<DataSkill>;
+    /** Discards the candidate; it stays as history. */
+    discardSkillCandidate(agentId: string, skillId: string, request: SkillCandidateRequest): Observable<void>;
+    /** Compares the candidate with the live version on the runs they made in the period. */
+    compareSkillCandidate(agentId: string, skillId: string, filter?: SkillComparisonFilter): Observable<SkillComparison>;
+    /** Adds a trigger defined as data, which starts in shadow, or changes one in the mode it has. */
+    saveDataTrigger(agentId: string, triggerId: string, request: DataTriggerRequest): Observable<DataTrigger>;
+    removeDataTrigger(agentId: string, triggerId: string, removal?: RunConfigurationRemoval): Observable<void>;
+    /** Puts a trigger defined as data in shadow or live. */
+    setDataTriggerShadow(agentId: string, triggerId: string, request: DataTriggerShadowRequest): Observable<DataTrigger>;
     private download;
     private request;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NhAssistantAdminApiService, never>;
@@ -1647,6 +2036,8 @@ declare class NhAssistantLiveService {
 interface NhAssistantError {
     code: string;
     messageKey: string;
+    /** The field errors of an `assistant-validation` failure, by camelCase field name. */
+    fieldErrors?: Readonly<Record<string, readonly string[]>>;
 }
 /**
  * A non-blocking remark about a turn that completed normally, for example a limit that cut the
@@ -1792,7 +2183,10 @@ declare class NhAssistantStore {
     readonly pageContextExcluded: _angular_core.Signal<boolean>;
     /** Whether the drawer was open when this account last left the application. */
     readonly restorePanelOpen: _angular_core.Signal<boolean>;
-    /** True while the user can send: enabled, an agent is chosen and no turn runs or waits. */
+    /**
+     * True while the user can send: enabled, an agent is chosen and no turn runs or waits. A
+     * conversation whose last turn failed accepts a new message; an archived one does not.
+     */
     readonly canSend: _angular_core.Signal<boolean>;
     /** Messages not yet accepted by the server, for the open conversation. Never persisted. */
     readonly queuedMessages: _angular_core.Signal<readonly NhAssistantQueuedMessage[]>;
@@ -1853,7 +2247,12 @@ declare class NhAssistantStore {
      * their own turns. Resolves `false` when the message was not accepted.
      */
     send(text: string): Promise<boolean>;
-    /** Sends immediately when idle, otherwise appends to the conversation's FIFO queue. */
+    /**
+     * Sends immediately when the conversation accepts a message, otherwise appends to the
+     * conversation's FIFO queue. A shown error alone does not hold a message back while nothing is
+     * queued: the person asks again, for example after a failed turn. Queued messages still wait
+     * for an explicit `resumeQueue` after Stop or a failure.
+     */
     submit(text: string): Promise<boolean>;
     /** Edits an unsent queued message without replacing the composer's current draft. */
     updateQueuedMessage(id: string, text: string): boolean;
@@ -2266,8 +2665,14 @@ declare class NhAssistantPanelComponent implements AfterViewInit, OnDestroy {
     readonly conversation: _angular_core.Signal<Conversation | null>;
     private readonly conversationId;
     readonly messages: _angular_core.Signal<Message[]>;
+    /** An archived conversation takes no new messages. A failed one does: the person asks again. */
     readonly closed: _angular_core.Signal<boolean>;
     readonly busy: _angular_core.Signal<boolean>;
+    /**
+     * The last turn failed and no error bar explains it, for example after the conversation was
+     * reopened. The panel then says so, while the composer stays available.
+     */
+    readonly lastTurnFailed: _angular_core.Signal<boolean>;
     readonly composerDisabled: _angular_core.Signal<boolean>;
     readonly editingQueuedId: _angular_core.WritableSignal<string | null>;
     readonly queuedDraft: _angular_core.WritableSignal<string>;
@@ -2737,4 +3142,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, AgentAccountability, AgentArtifact, AgentConsultation, AgentConsultationList, AgentConsultationStatus, AgentDecisionOutcome, AgentElevatedReads, 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, AgentRunConfiguration, AgentRunKind, AgentRunList, AgentRunRetryMode, AgentRunSettings, AgentRunSettingsRequest, 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, CodeSkill, CodeTrigger, Conversation, ConversationKind, ConversationMember, ConversationPage, ConversationRole, ConversationStatus, ConversationSummary, ConversationThread, ConversationThreadDecision, CreateConversationRequest, DataSkill, DataSkillRequest, DataSkillVersion, DataSkillVersionStatus, DataTrigger, DataTriggerRequest, DataTriggerShadowRequest, 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, RunBlock, RunCatalog, RunConfigurationProblem, RunConfigurationProblemKind, RunConfigurationRemoval, SendMessageRequest, SetAgentServiceAccountRequest, SetAgentShadowRequest, SetAgentStateRequest, ShareLink, SkillApplyMode, SkillCandidateRequest, SkillComparison, SkillComparisonFilter, SkillComparisonTool, SkillVersionStats, StaleKind, StartAgentRequest, TextPart, ToolCallPart, ToolCallStatus, ToolCatalogEffect, ToolCatalogEntry, ToolCompletedEvent, ToolStartedEvent, TriggerConflict, 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.14.0",
   "peerDependencies": {
     "@angular/cdk": "^20.2.14",
     "@angular/common": "^20.3.28",

package/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { AssistantStatus, AgentSummary, Conversation, ClientContext, AssistantPreferences, ToolCatalogEntry, AdminAgentInput, McpServerInput, LiveConversationChanged, LiveConversationRead, LiveConversationRemoved, LiveConversationEvent, NhAssistantLiveService, LiveAgentWorkChanged, NhAssistantLiveState } from '@newheap/platform-ai-chat';
+import { AssistantStatus, AgentSummary, Conversation, ClientContext, AssistantPreferences, ToolCatalogEntry, AdminAgentInput, McpServerInput, RunCatalog, LiveConversationChanged, LiveConversationRead, LiveConversationRemoved, LiveConversationEvent, NhAssistantLiveService, LiveAgentWorkChanged, NhAssistantLiveState } from '@newheap/platform-ai-chat';
 import * as i0 from '@angular/core';
 import { InjectionToken, EnvironmentProviders } from '@angular/core';
 import { Observable } from 'rxjs';
@@ -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
@@ -119,6 +124,18 @@ interface NhAssistantMockAdminScenario {
     policies?: string[];
     /** Hosts that may receive the user's token (`forward-user-token`). Default: none. */
     forwardUserTokenHosts?: string[];
+    /**
+     * The building blocks in code that run configuration as data names. Default: none, with
+     * `policies` as the approval policies.
+     */
+    runCatalog?: Partial<RunCatalog>;
+    /** Triggers in code, per agent; they cannot change in the administration. */
+    codeTriggers?: {
+        agentId: string;
+        triggerId: string;
+        source: 'event' | 'schedule' | 'webhook';
+        skillId?: string | null;
+    }[];
 }
 /** A person in the simulated organization. */
 interface NhAssistantMockPerson {