@newheap/platform-ai-chat 0.15.0 → 0.17.0

package/package.json

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

package/testing/index.d.ts

@@ -1,8 +1,16 @@
-import { AssistantStatus, AgentSummary, Conversation, ClientContext, AssistantPreferences, ToolCatalogEntry, AdminAgentInput, CodeRunSettings, AgentRunSettingsRequest, DataSkillRequest, DataTriggerRequest, McpServerInput, McpCustomAuthMode, McpDiscovery, RunCatalog, AssistantAccount, AgentRunStatus, AgentTriggerReceipt, AgentRunMcpSkip, ApprovalPresentation, AgentProposalStatus, AgentProposalOrigin, NhAssistantMcpAuthorizationWindow, NhAssistantMcpAuthorizationOutcome, NhAssistantMcpAuthorizationHandle, LiveConversationChanged, LiveConversationRead, LiveConversationRemoved, LiveConversationEvent, LiveAgentWorkChanged, NhAssistantLiveService, NhAssistantLiveState } from '@newheap/platform-ai-chat';
+import { AssistantStatus, AgentSummary, Conversation, ClientContext, AssistantPreferences, ToolCatalogEntry, AdminAgentInput, CodeRunSettings, AgentRunSettingsRequest, DataSkillRequest, DataTriggerRequest, McpServerInput, McpCustomAuthMode, McpDiscovery, RunCatalog, AssistantDataClassification, AssistantAccount, AgentRunStatus, AgentTriggerReceipt, AgentRunMcpSkip, ApprovalPresentation, AgentProposalStatus, AgentProposalOrigin, AgentProposalParent, NhAssistantMcpAuthorizationWindow, NhAssistantMcpAuthorizationOutcome, NhAssistantMcpAuthorizationHandle, LiveConversationChanged, LiveConversationRead, LiveConversationRemoved, LiveConversationEvent, LiveAgentWorkChanged, FileReference, NhAssistantUploadRequest, NhAssistantLiveService, NhAssistantLiveState } from '@newheap/platform-ai-chat';
 import * as _angular_core from '@angular/core';
 import { InjectionToken, EnvironmentProviders } from '@angular/core';
 import { Observable } from 'rxjs';
 
+/** An upload as the application's file source receives it, after the assistant's checks. */
+interface NhAssistantMockUpload {
+    conversationId: string;
+    name: string;
+    mediaType: string;
+    size: number;
+}
+
 /** Streams text as `message.delta` events, split into word-sized pieces. */
 interface NhAssistantMockTextStep {
     /** Fixed text, or text built from the page context the client sent with the message. */
@@ -107,14 +115,21 @@ interface NhAssistantMockMcpServer extends McpServerInput {
     /** A server each person connects to starts with the caller's own account connected. */
     personalConnected?: boolean;
 }
-/** A preconfigured agent. Code agents default to the scenario's chat agents. */
+/**
+ * A preconfigured agent. Code agents default to the scenario's chat agents. `startsOff` starts it
+ * off, as `StartsOff()` in code does for an agent in code.
+ */
 interface NhAssistantMockAdminAgent extends AdminAgentInput {
     source: 'code' | 'admin';
-    /** The skills of a code agent, by id and description; they start active, and in shadow with `shadow`. */
+    /**
+     * The skills of a code agent, by id and description; they start active, in shadow with `shadow`
+     * and off with `startsOff`, as `StartsOff()` in code.
+     */
     skills?: {
         skillId: string;
         description: string;
         shadow?: boolean;
+        startsOff?: boolean;
     }[];
     /** The live agent this code agent is a shadow variant of. */
     shadowOf?: string;
@@ -212,6 +227,13 @@ interface NhAssistantMockAdminScenario {
      * administration work per division, as an application that lists its divisions does.
      */
     runCatalog?: Partial<RunCatalog>;
+    /**
+     * The data classifications each model profile and its fallbacks permit together, by profile name.
+     * An agent or skill whose classification its profile does not permit is saved with the warning
+     * `classification-not-permitted`, as on the server. A profile that is not listed permits every
+     * classification. Default: none.
+     */
+    profileClassifications?: Record<string, AssistantDataClassification[]>;
     /**
      * Triggers in code, per agent; they cannot change in the administration. `subjectType` is the type
      * a trigger names up front, `nh-system` for a schedule for the whole application.
@@ -432,6 +454,21 @@ interface NhAssistantMockScenario {
      * the approval inbox, their thread and their subject's work list them, and people decide them.
      */
     proposals?: NhAssistantMockProposal[];
+    /**
+     * The application's own answer to an upload that passed the assistant's checks: `null` stores it,
+     * a code refuses it as the server passes the file source's refusal on, for example
+     * `'application-virus-found'` as `assistant-file-upload-refused`. People attach files to messages for
+     * the agents whose summary in `agents` lists `uploads`; without such an agent the application keeps
+     * no files for the assistant. Default: every upload is stored.
+     */
+    refuseUpload?: (upload: NhAssistantMockUpload) => string | null;
+    /**
+     * The application's upload scanner (`INhAssistantUploadScanner`), which the server runs after the
+     * checks of type, size and signature and before the file source: `'refused'` refuses the upload with
+     * `assistant-file-scan-refused`, `'failed'` with `assistant-file-upload-failed`, `null` lets it pass.
+     * Default: no scanner, as on a server without one.
+     */
+    scanUpload?: (upload: NhAssistantMockUpload) => 'refused' | 'failed' | null;
 }
 /**
  * A proposal an agent left, as the mock serves it; the mock fills what it leaves out. With
@@ -454,6 +491,17 @@ interface NhAssistantMockProposal {
     status?: AgentProposalStatus;
     rationale?: string | null;
     placedBy?: AgentProposalOrigin | null;
+    /**
+     * The subject the proposal's subject belonged to when it was made, such as the project of a task;
+     * the grouped inbox groups by it. Default none.
+     */
+    parent?: AgentProposalParent | null;
+    /** The division of the proposal's subject, which the inbox's `divisionId` filter matches. Default none. */
+    divisionId?: string | null;
+    /** When the proposal was made, an ISO date. Default when the mock started. */
+    createdAt?: string;
+    /** When the proposal expires, an ISO date. Default three days after it was made. */
+    expiresAt?: string;
     /**
      * Whether the signed-in user may decide it. Default `true`. A proposal of the whole application
      * (`nh-system`) exists only for its approvers who pass the agent's view policy, by default its
@@ -536,6 +584,7 @@ declare class NhAssistantMockBackend {
     private readonly shareTokens;
     private readonly activeActors;
     private readonly liveSubject;
+    private readonly files;
     private pushEnabled;
     private sequence;
     /** Requests received so far, oldest first. */
@@ -569,6 +618,19 @@ declare class NhAssistantMockBackend {
      * (`reauthorization-required`) or another authorization server (`issuer-changed`).
      */
     setMcpConnectionStatus(serverId: string, status: 'reauthorization-required' | 'issuer-changed'): void;
+    /** The files people uploaded, oldest first, as the application's file source stored them. */
+    get uploads(): readonly {
+        conversationId: string;
+        name: string;
+        mediaType: string;
+        size: number;
+        reference: FileReference;
+    }[];
+    /**
+     * An upload implementation (`NH_ASSISTANT_UPLOAD`) that answers `POST conversations/{id}/files` with
+     * the server's checks, after reporting the progress in four steps.
+     */
+    readonly upload: (request: NhAssistantUploadRequest) => Promise<Response>;
     /** A `fetch` implementation that answers the assistant endpoints below `apiBaseUrl`. */
     readonly fetch: (input: string, init: RequestInit) => Promise<Response>;
     private route;
@@ -603,6 +665,12 @@ declare class NhAssistantMockBackend {
     private maxParticipants;
     /** A contract error with the one status the server gives its code. */
     private error;
+    /** The path below `apiBaseUrl`, or `null` for another URL. */
+    private pathOf;
+    /** Whether the application keeps files for the assistant: an agent of the scenario takes uploads. */
+    private offersFiles;
+    /** What people may attach to a message to the agent, as its summary says. */
+    private uploadsOf;
     /**
      * Whether the caller decides the agent's proposals of the whole application: an approver of the whole
      * application (an administrator in the mock) who passes the agent's view policy, by default its
@@ -662,11 +730,11 @@ declare class NhAssistantMockLiveService implements NhAssistantLiveSurface {
  * Replaces the assistant transport with an in-memory back-end that plays `script`.
  * Register it after `provideNhAssistant(...)` in the same injector. Every client feature
  * (status, agents, conversations, streamed turns, approvals, cancellation, sharing, read
- * state, live updates and MCP authorizations) then works without a server. Inject
- * `NhAssistantMockBackend` to switch the feature flag, simulate a colleague or inspect the
- * received requests.
+ * state, live updates, uploads with their progress and MCP authorizations) then works without a
+ * server. Inject `NhAssistantMockBackend` to switch the feature flag, simulate a colleague or
+ * inspect the received requests and uploads.
  */
 declare function provideNhAssistantMockApi(script: NhAssistantMockScenario): EnvironmentProviders;
 
 export { NH_ASSISTANT_MOCK_HUB_PATH, NH_ASSISTANT_MOCK_SCENARIO, NhAssistantMockAuthorizationWindow, NhAssistantMockBackend, NhAssistantMockLiveService, provideNhAssistantMockApi };
-export type { NhAssistantMockAdminAgent, NhAssistantMockAdminScenario, NhAssistantMockAgentGroup, NhAssistantMockApprovalStep, NhAssistantMockCollaboration, NhAssistantMockConnectionStep, NhAssistantMockDataSkill, NhAssistantMockDataTrigger, NhAssistantMockDivision, NhAssistantMockErrorStep, NhAssistantMockFailStep, NhAssistantMockLiveMessage, NhAssistantMockMcpServer, NhAssistantMockPerson, NhAssistantMockProposal, NhAssistantMockRemoteTool, NhAssistantMockRequest, NhAssistantMockRun, NhAssistantMockRunConfigurationPreset, NhAssistantMockRunNow, NhAssistantMockScenario, NhAssistantMockStep, NhAssistantMockSubject, NhAssistantMockSubjectType, NhAssistantMockTextStep, NhAssistantMockTiming, NhAssistantMockToolStep, NhAssistantMockTurn };
+export type { NhAssistantMockAdminAgent, NhAssistantMockAdminScenario, NhAssistantMockAgentGroup, NhAssistantMockApprovalStep, NhAssistantMockCollaboration, NhAssistantMockConnectionStep, NhAssistantMockDataSkill, NhAssistantMockDataTrigger, NhAssistantMockDivision, NhAssistantMockErrorStep, NhAssistantMockFailStep, NhAssistantMockLiveMessage, NhAssistantMockMcpServer, NhAssistantMockPerson, NhAssistantMockProposal, NhAssistantMockRemoteTool, NhAssistantMockRequest, NhAssistantMockRun, NhAssistantMockRunConfigurationPreset, NhAssistantMockRunNow, NhAssistantMockScenario, NhAssistantMockStep, NhAssistantMockSubject, NhAssistantMockSubjectType, NhAssistantMockTextStep, NhAssistantMockTiming, NhAssistantMockToolStep, NhAssistantMockTurn, NhAssistantMockUpload };