@hahnpro/hpc-api 2026.2.5 → 2026.2.7

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @hahnpro/hpc-api
 
+# 2026.2.7
+- Added enums: AgentId, AiAssistantId and Type ToolNameType with enums ToolName, ReturnToReferrerTool and HandOffTool 
+
+# 2026.2.6
+
+- Updated Search-Interface: SearchResult -> SearchMatchReason -> SearchMatchReasonContentPart
+- Updated search-service search method
+- Update AI-Interface: added ResourceSelectionRejected interface
+
 # 2026.2.5
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hahnpro/hpc-api",
-  "version": "2026.2.5",
+  "version": "2026.2.7",
   "description": "Module for easy access to the HahnPRO Cloud API",
   "license": "MIT",
   "author": {

package/src/index.d.ts

@@ -1,6 +1,7 @@
-export * from './lib/interfaces';
-export * from './lib/services';
 export * from './lib/api';
 export * from './lib/constants';
+export * from './lib/interfaces';
 export * from './lib/mock';
+export * from './lib/services';
+export * from './lib/token-set';
 export * from './lib/utils';

package/src/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./lib/interfaces"), exports);
-tslib_1.__exportStar(require("./lib/services"), exports);
 tslib_1.__exportStar(require("./lib/api"), exports);
 tslib_1.__exportStar(require("./lib/constants"), exports);
+tslib_1.__exportStar(require("./lib/interfaces"), exports);
 tslib_1.__exportStar(require("./lib/mock"), exports);
+tslib_1.__exportStar(require("./lib/services"), exports);
+tslib_1.__exportStar(require("./lib/token-set"), exports);
 tslib_1.__exportStar(require("./lib/utils"), exports);

package/src/lib/interfaces/ai.interface.d.ts

@@ -47,14 +47,82 @@ export declare enum ReferenceType {
     TASK = "task",
     WEB_SOURCE = "web-source"
 }
+export declare enum AgentId {
+    ASSET = "asset-agent",
+    ASSET_IDENTIFIER = "asset-identifier-agent",
+    ASSET_MULTI_IDENTIFIER = "asset-multi-identifier-agent",
+    ASSET_WEB = "asset-web-agent",
+    MESSAGE = "message-agent",
+    STATUS = "status-agent",
+    REPORT = "report-agent",
+    DEEP_RESEARCH = "deep-research-agent",
+    RESEARCH_GOAL_CLARIFIER = "research-goal-clarifier-agent",
+    RESEARCH_INSTRUCTION_BUILDER = "research-instruction-builder-agent",
+    AXALTA_ASSET_IDENTIFIER = "axalta-asset-identifier-agent",
+    AXALTA_MESSAGE = "axalta-message-agent",
+    TRIAGE = "triage-agent"
+}
+export declare enum ToolName {
+    SWITCH_ASSISTANT = "switchAssistant",
+    FIND_TASKS_BY_ASSET = "findTasksByAsset",
+    CREATE_REPORT = "createReport",
+    CREATE_JSON_REPORT = "createJSONReport",
+    GET_REPORT_TEMPLATE = "getReportTemplate",
+    GET_ADDITIONAL_DATA_TEMPLATE = "getAdditionalDataTemplate",
+    GET_INCIDENT_TEMPLATE = "getIncidentTemplate",
+    GET_ASSET_STATUS = "getAssetStatus",
+    FIND_TASK_BY_NAME = "findTaskByName",
+    GET_TASK_LOGBOOK_ENTRIES = "getTaskLogbookEntries",
+    CREATE_EVENT = "createEvent",
+    GET_ASSET_DATA = "getAssetData",
+    ASSET_SELECTION = "assetSelection",
+    SEARCH_FOR_ASSETS_BY_ID_NAME_TYPE = "searchForAssetsByIdNameType",
+    SEARCH_ASSET_TYPES = "searchAssetTypes",
+    SEARCH_FOR_EVENTS = "searchForEvents",
+    SEARCH_FOR_ASSET_AXALTA = "searchForAssetAxalta",
+    SEARCH_FOR_ASSET_WITH_ID = "searchForAssetWithId",
+    CREATE_AXALTA_EVENT = "createAxaltaEvent",
+    RESOURCE_SELECTION = "resourceSelection",
+    SEARCH_ASSETS = "searchAssets",
+    UPDATE_TASK_LOGBOOK_ENTRY = "updateTaskLogbookEntry",
+    SEARCH_FOR_DOCUMENTS = "searchForDocuments",
+    ADD_TASK_LOGBOOK_ENTRY = "addTaskLogbookEntry",
+    WEB_SEARCH = "web_search"
+}
+export declare enum ReturnToReferrerTool {
+    ASSET_IDENTIFIER = "returnToReferrer_asset-identifier-agent",
+    ASSET_MULTI_IDENTIFIER = "returnToReferrer_asset-multi-identifier-agent",
+    AXALTA_ASSET_IDENTIFIER = "returnToReferrer_axalta-asset-identifier-agent"
+}
+export declare enum HandOffTool {
+    ASSET_IDENTIFIER = "handoff_to_asset-identifier-agent",
+    ASSET_MULTI_IDENTIFIER = "handoff_to_asset-multi-identifier-agent",
+    AXALTA_ASSET_IDENTIFIER = "handoff_to_axalta-asset-identifier-agent",
+    DEEP_RESEARCH = "handoff_to_deep-research-agent",
+    RESEARCH_GOAL_CLARIFIER = "handoff_to_research-goal-clarifier-agent",
+    RESEARCH_INSTRUCTION_BUILDER = "handoff_to_research-instruction-builder-agent",
+    TRIAGE = "handoff_to_triage-agent"
+}
+export declare enum AiAssistantId {
+    ASSET = "asset-assistant",
+    ASSET_WEB = "asset-web-assistant",
+    INCIDENT = "incident-assistant",
+    REPORT = "report-assistant",
+    AXALTA_INCIDENT = "axalta-incident-assistant"
+}
+export type ToolNameType = ToolName | HandOffTool | ReturnToReferrerTool;
 export interface AiAssistant {
-    id: string;
-    agent?: string;
+    id: AiAssistantId;
+    agent: AgentId;
     pipeline?: string[];
     i18n: Record<AvailableLanguages, AssistantLabels>;
     icon?: string;
     readPermissions?: string[];
 }
+export interface ResourceSelectionRejected {
+    rejected: true;
+    message: string;
+}
 interface AssistantLabels {
     name: string;
     description?: string;
@@ -77,18 +145,18 @@ export interface AssistantMessage extends BaseMessage {
     responseId?: string;
     role: Role.ASSISTANT;
     content?: string;
-    agentStack?: string[];
+    agentStack?: AgentId[];
     status?: AssistantMessageStatus;
     toolCalls?: {
         type: 'tool-call';
         toolCallId: string;
-        toolName: string;
+        toolName: ToolNameType;
         args: any;
     }[];
     toolResults?: {
         type: 'tool-result';
         toolCallId: string;
-        toolName: string;
+        toolName: ToolNameType;
         args: any;
         result: any;
     }[];
@@ -106,9 +174,9 @@ export interface SystemMessage extends BaseMessage {
 export interface ToolMessage extends BaseMessage {
     role: Role.TOOL;
     toolCallId?: string;
-    toolName?: string;
+    toolName?: ToolNameType;
     toolType?: ToolType;
-    agentStack?: string[];
+    agentStack?: AgentId[];
     status?: ToolMessageStatus;
     result?: any;
     args?: SelectionMessage | any;
@@ -127,7 +195,7 @@ export interface SpeechToken {
 }
 export interface Thread {
     id: string;
-    assistantId: string;
+    assistantId: AiAssistantId;
     owner: Owner;
     messages: string[] | Message[];
     isEphemeral: boolean;

package/src/lib/interfaces/ai.interface.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReferenceType = exports.ToolType = exports.Role = exports.AvailableLanguages = exports.FinishReason = exports.ToolMessageStatus = exports.AssistantMessageStatus = void 0;
+exports.AiAssistantId = exports.HandOffTool = exports.ReturnToReferrerTool = exports.ToolName = exports.AgentId = exports.ReferenceType = exports.ToolType = exports.Role = exports.AvailableLanguages = exports.FinishReason = exports.ToolMessageStatus = exports.AssistantMessageStatus = void 0;
 var AssistantMessageStatus;
 (function (AssistantMessageStatus) {
     AssistantMessageStatus["ABORTING"] = "aborting";
@@ -56,3 +56,71 @@ var ReferenceType;
     ReferenceType["TASK"] = "task";
     ReferenceType["WEB_SOURCE"] = "web-source";
 })(ReferenceType || (exports.ReferenceType = ReferenceType = {}));
+var AgentId;
+(function (AgentId) {
+    AgentId["ASSET"] = "asset-agent";
+    AgentId["ASSET_IDENTIFIER"] = "asset-identifier-agent";
+    AgentId["ASSET_MULTI_IDENTIFIER"] = "asset-multi-identifier-agent";
+    AgentId["ASSET_WEB"] = "asset-web-agent";
+    AgentId["MESSAGE"] = "message-agent";
+    AgentId["STATUS"] = "status-agent";
+    AgentId["REPORT"] = "report-agent";
+    AgentId["DEEP_RESEARCH"] = "deep-research-agent";
+    AgentId["RESEARCH_GOAL_CLARIFIER"] = "research-goal-clarifier-agent";
+    AgentId["RESEARCH_INSTRUCTION_BUILDER"] = "research-instruction-builder-agent";
+    AgentId["AXALTA_ASSET_IDENTIFIER"] = "axalta-asset-identifier-agent";
+    AgentId["AXALTA_MESSAGE"] = "axalta-message-agent";
+    AgentId["TRIAGE"] = "triage-agent";
+})(AgentId || (exports.AgentId = AgentId = {}));
+var ToolName;
+(function (ToolName) {
+    ToolName["SWITCH_ASSISTANT"] = "switchAssistant";
+    ToolName["FIND_TASKS_BY_ASSET"] = "findTasksByAsset";
+    ToolName["CREATE_REPORT"] = "createReport";
+    ToolName["CREATE_JSON_REPORT"] = "createJSONReport";
+    ToolName["GET_REPORT_TEMPLATE"] = "getReportTemplate";
+    ToolName["GET_ADDITIONAL_DATA_TEMPLATE"] = "getAdditionalDataTemplate";
+    ToolName["GET_INCIDENT_TEMPLATE"] = "getIncidentTemplate";
+    ToolName["GET_ASSET_STATUS"] = "getAssetStatus";
+    ToolName["FIND_TASK_BY_NAME"] = "findTaskByName";
+    ToolName["GET_TASK_LOGBOOK_ENTRIES"] = "getTaskLogbookEntries";
+    ToolName["CREATE_EVENT"] = "createEvent";
+    ToolName["GET_ASSET_DATA"] = "getAssetData";
+    ToolName["ASSET_SELECTION"] = "assetSelection";
+    ToolName["SEARCH_FOR_ASSETS_BY_ID_NAME_TYPE"] = "searchForAssetsByIdNameType";
+    ToolName["SEARCH_ASSET_TYPES"] = "searchAssetTypes";
+    ToolName["SEARCH_FOR_EVENTS"] = "searchForEvents";
+    ToolName["SEARCH_FOR_ASSET_AXALTA"] = "searchForAssetAxalta";
+    ToolName["SEARCH_FOR_ASSET_WITH_ID"] = "searchForAssetWithId";
+    ToolName["CREATE_AXALTA_EVENT"] = "createAxaltaEvent";
+    ToolName["RESOURCE_SELECTION"] = "resourceSelection";
+    ToolName["SEARCH_ASSETS"] = "searchAssets";
+    ToolName["UPDATE_TASK_LOGBOOK_ENTRY"] = "updateTaskLogbookEntry";
+    ToolName["SEARCH_FOR_DOCUMENTS"] = "searchForDocuments";
+    ToolName["ADD_TASK_LOGBOOK_ENTRY"] = "addTaskLogbookEntry";
+    ToolName["WEB_SEARCH"] = "web_search";
+})(ToolName || (exports.ToolName = ToolName = {}));
+var ReturnToReferrerTool;
+(function (ReturnToReferrerTool) {
+    ReturnToReferrerTool["ASSET_IDENTIFIER"] = "returnToReferrer_asset-identifier-agent";
+    ReturnToReferrerTool["ASSET_MULTI_IDENTIFIER"] = "returnToReferrer_asset-multi-identifier-agent";
+    ReturnToReferrerTool["AXALTA_ASSET_IDENTIFIER"] = "returnToReferrer_axalta-asset-identifier-agent";
+})(ReturnToReferrerTool || (exports.ReturnToReferrerTool = ReturnToReferrerTool = {}));
+var HandOffTool;
+(function (HandOffTool) {
+    HandOffTool["ASSET_IDENTIFIER"] = "handoff_to_asset-identifier-agent";
+    HandOffTool["ASSET_MULTI_IDENTIFIER"] = "handoff_to_asset-multi-identifier-agent";
+    HandOffTool["AXALTA_ASSET_IDENTIFIER"] = "handoff_to_axalta-asset-identifier-agent";
+    HandOffTool["DEEP_RESEARCH"] = "handoff_to_deep-research-agent";
+    HandOffTool["RESEARCH_GOAL_CLARIFIER"] = "handoff_to_research-goal-clarifier-agent";
+    HandOffTool["RESEARCH_INSTRUCTION_BUILDER"] = "handoff_to_research-instruction-builder-agent";
+    HandOffTool["TRIAGE"] = "handoff_to_triage-agent";
+})(HandOffTool || (exports.HandOffTool = HandOffTool = {}));
+var AiAssistantId;
+(function (AiAssistantId) {
+    AiAssistantId["ASSET"] = "asset-assistant";
+    AiAssistantId["ASSET_WEB"] = "asset-web-assistant";
+    AiAssistantId["INCIDENT"] = "incident-assistant";
+    AiAssistantId["REPORT"] = "report-assistant";
+    AiAssistantId["AXALTA_INCIDENT"] = "axalta-incident-assistant";
+})(AiAssistantId || (exports.AiAssistantId = AiAssistantId = {}));

package/src/lib/interfaces/asset.interface.d.ts

@@ -3,6 +3,7 @@ export interface AssetType {
     id?: string;
     name: string;
     tags?: string[];
+    translationId?: string;
     allowedParents?: string[];
     allowedParent$name?: string;
     readPermissions: string[];

package/src/lib/interfaces/content.interface.d.ts

@@ -35,5 +35,6 @@ export declare enum ReturnType {
     JSON = 1,
     NODEBUFFER = 2,
     BLOB = 3,
-    ARRAYBUFFER = 4
+    ARRAYBUFFER = 4,
+    STREAM = 5
 }

package/src/lib/interfaces/content.interface.js

@@ -11,4 +11,5 @@ var ReturnType;
     ReturnType[ReturnType["NODEBUFFER"] = 2] = "NODEBUFFER";
     ReturnType[ReturnType["BLOB"] = 3] = "BLOB";
     ReturnType[ReturnType["ARRAYBUFFER"] = 4] = "ARRAYBUFFER";
+    ReturnType[ReturnType["STREAM"] = 5] = "STREAM";
 })(ReturnType || (exports.ReturnType = ReturnType = {}));

package/src/lib/interfaces/endpoint.interface.d.ts

@@ -11,9 +11,8 @@ export interface Endpoint {
         authToken: string;
         recipients?: string[];
     };
-    notificationCheckInterval: number;
-    notificationPauseInterval: number;
-    nbOfNotificationsBetweenPauseInterval: number;
+    spamProtection?: string;
+    pauseInterval?: number;
     readPermissions: string[];
     readWritePermissions: string[];
     owner?: Owner;

package/src/lib/interfaces/index.d.ts

@@ -1,4 +1,4 @@
-export type { AiAssistant, AssetResourceSelectionOption, AssistantMessage, DocumentResourceSelectionOption, GenericResourceSelectionOption, LogbookEntryResourceSelectionOption, Message, ResourceSelectionOption, SpeechToken, SystemMessage, Thread, ThreadPopulated, ToolMessage, UserMessage, } from './ai.interface';
+export type { AiAssistant, AssetResourceSelectionOption, AssistantMessage, DocumentResourceSelectionOption, GenericResourceSelectionOption, LogbookEntryResourceSelectionOption, Message, ResourceSelectionOption, ResourceSelectionRejected, SpeechToken, SystemMessage, Thread, ThreadPopulated, ToolMessage, ToolNameType, UserMessage, } from './ai.interface';
 export type { Alert, AlertCondition, TimeSeriesReference } from './alert.interface';
 export type { Api } from './api.interface';
 export type { AddToProperty, Asset, AssetRevision, AssetType, AssetTypeRevision, Attachment, EventCause, EventLevelOverride, RemoveFromProperty, Template, } from './asset.interface';
@@ -26,7 +26,7 @@ export type { DeleteAssetQuery, DeleteAssetTypeQuery, DeleteQuery } from './quer
 export type { CreateReferenceDto, ObjectReference, ReferencesQuery } from './reference.interface';
 export type { ConnectedResources, ConnectedResourceType, OrgResourcePermission, Resource, ResourceReference, SharedResources, } from './resource.interface';
 export type { JsonSchema, JsonSchemaArray, JsonSchemaForm, JsonSchemaType, JsonSchemaTypeName } from './schema.interface';
-export type { SearchOptions, SearchResult, SearchSortOption, SortableField } from './search.interface';
+export type { SearchMatchReason, SearchMatchReasonContentPart, SearchOptions, SearchResult, SearchSortOption, SortableField, } from './search.interface';
 export type { Secret } from './secret.interface';
 export type { ServerSentEvent } from './sse.interface';
 export type { Artifact, FileType, Storage, StorageProvider } from './storage.interface';
@@ -34,7 +34,7 @@ export type { Assignee, LogbookEntry, LogbookEntryDto, Task } from './task.inter
 export type { TimeSeries, TimeSeriesBucket, TimeSeriesCondition, TimeSeriesValue, TS_GROUPS } from './timeseries.interface';
 export type { Application, Consent, Permission, TableSetting, TableSettingProfile, UserSettings } from './user-settings.interface';
 export type { VaultSecret } from './vault.interface';
-export { AssistantMessageStatus, AvailableLanguages, FinishReason, ReferenceType, Role, ToolMessageStatus, ToolType } from './ai.interface';
+export { AgentId, AiAssistantId, AssistantMessageStatus, AvailableLanguages, FinishReason, HandOffTool, ReferenceType, ReturnToReferrerTool, Role, ToolMessageStatus, ToolName, ToolType, } from './ai.interface';
 export { AlertLevel, AlertType } from './alert.interface';
 export { ReturnType } from './content.interface';
 export { instanceOfTimePeriod } from './data.interface';

package/src/lib/interfaces/index.js

@@ -1,15 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TaskStatus = exports.Priority = exports.AssigneeType = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.ObjectReferenceType = exports.OwnerType = exports.LABEL_COLORS = exports.EventLevel = exports.instanceOfTimePeriod = exports.ReturnType = exports.AlertType = exports.AlertLevel = exports.ToolType = exports.ToolMessageStatus = exports.Role = exports.ReferenceType = exports.FinishReason = exports.AvailableLanguages = exports.AssistantMessageStatus = exports.OrganizationMembersInviteOrAdd = void 0;
+exports.TaskStatus = exports.Priority = exports.AssigneeType = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.ObjectReferenceType = exports.OwnerType = exports.LABEL_COLORS = exports.EventLevel = exports.instanceOfTimePeriod = exports.ReturnType = exports.AlertType = exports.AlertLevel = exports.ToolType = exports.ToolName = exports.ToolMessageStatus = exports.Role = exports.ReturnToReferrerTool = exports.ReferenceType = exports.HandOffTool = exports.FinishReason = exports.AvailableLanguages = exports.AssistantMessageStatus = exports.AiAssistantId = exports.AgentId = exports.OrganizationMembersInviteOrAdd = void 0;
 var organization_interface_1 = require("./organization.interface");
 Object.defineProperty(exports, "OrganizationMembersInviteOrAdd", { enumerable: true, get: function () { return organization_interface_1.OrganizationMembersInviteOrAdd; } });
 var ai_interface_1 = require("./ai.interface");
+Object.defineProperty(exports, "AgentId", { enumerable: true, get: function () { return ai_interface_1.AgentId; } });
+Object.defineProperty(exports, "AiAssistantId", { enumerable: true, get: function () { return ai_interface_1.AiAssistantId; } });
 Object.defineProperty(exports, "AssistantMessageStatus", { enumerable: true, get: function () { return ai_interface_1.AssistantMessageStatus; } });
 Object.defineProperty(exports, "AvailableLanguages", { enumerable: true, get: function () { return ai_interface_1.AvailableLanguages; } });
 Object.defineProperty(exports, "FinishReason", { enumerable: true, get: function () { return ai_interface_1.FinishReason; } });
+Object.defineProperty(exports, "HandOffTool", { enumerable: true, get: function () { return ai_interface_1.HandOffTool; } });
 Object.defineProperty(exports, "ReferenceType", { enumerable: true, get: function () { return ai_interface_1.ReferenceType; } });
+Object.defineProperty(exports, "ReturnToReferrerTool", { enumerable: true, get: function () { return ai_interface_1.ReturnToReferrerTool; } });
 Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return ai_interface_1.Role; } });
 Object.defineProperty(exports, "ToolMessageStatus", { enumerable: true, get: function () { return ai_interface_1.ToolMessageStatus; } });
+Object.defineProperty(exports, "ToolName", { enumerable: true, get: function () { return ai_interface_1.ToolName; } });
 Object.defineProperty(exports, "ToolType", { enumerable: true, get: function () { return ai_interface_1.ToolType; } });
 var alert_interface_1 = require("./alert.interface");
 Object.defineProperty(exports, "AlertLevel", { enumerable: true, get: function () { return alert_interface_1.AlertLevel; } });

package/src/lib/interfaces/reference.interface.d.ts

@@ -12,7 +12,13 @@ export declare enum ObjectReferenceType {
      * Marks an Object as updated by an AI-Thread.
      * Object is linked to the AI-Thread's ID.'
      */
-    UPDATED_BY_THREAD = "updated_by_thread"
+    UPDATED_BY_THREAD = "updated_by_thread",
+    /**
+     * Marks an Object as being part of the 'Weber Engineering Flange Skill Check Application' to link examinees to an
+     * examination, in which they participate.
+     */
+    FLANGE_SKILL_CHECK_APPLICATION_EXAMINATION_EXAMINEE = "flange_skill_check_application_examination_examinee",
+    FLANGE_SKILL_CHECK_APPLICATION_EXAMINATION_EXAMINER = "flange_skill_check_application_examination_examiner"
 }
 export interface ObjectReference {
     id: number;

package/src/lib/interfaces/reference.interface.js

@@ -17,4 +17,10 @@ var ObjectReferenceType;
      * Object is linked to the AI-Thread's ID.'
      */
     ObjectReferenceType["UPDATED_BY_THREAD"] = "updated_by_thread";
+    /**
+     * Marks an Object as being part of the 'Weber Engineering Flange Skill Check Application' to link examinees to an
+     * examination, in which they participate.
+     */
+    ObjectReferenceType["FLANGE_SKILL_CHECK_APPLICATION_EXAMINATION_EXAMINEE"] = "flange_skill_check_application_examination_examinee";
+    ObjectReferenceType["FLANGE_SKILL_CHECK_APPLICATION_EXAMINATION_EXAMINER"] = "flange_skill_check_application_examination_examiner";
 })(ObjectReferenceType || (exports.ObjectReferenceType = ObjectReferenceType = {}));

package/src/lib/interfaces/search.interface.d.ts

@@ -14,10 +14,20 @@ export interface SearchSortOption<T> {
     field: SortableField<T>;
     order: 'asc' | 'desc';
 }
+export interface SearchMatchReason {
+    field: string;
+    content: SearchMatchReasonContentPart[];
+}
+export interface SearchMatchReasonContentPart {
+    text: string;
+    isHighlighted: boolean;
+}
 export interface SearchResult<T extends {
     id?: string;
 } = any, K extends keyof T & string = keyof T & string> {
-    docs: Pick<T, K | 'id'>[];
+    docs: (Pick<T, K | 'id'> & {
+        matchReason?: SearchMatchReason[];
+    })[];
     limit: number;
     offset: number;
     total: number;

package/src/lib/mock/api.mock.js

@@ -64,9 +64,8 @@ class MockAPI {
             ...v,
             status: v.status,
             config: v.config,
-            notificationCheckInterval: v.notificationCheckInterval,
-            notificationPauseInterval: v.notificationPauseInterval,
-            nbOfNotificationsBetweenPauseInterval: v.nbOfNotificationsBetweenPauseInterval,
+            spamProtection: v.spamProtection,
+            pauseInterval: v.pauseInterval,
             readPermissions: v.readPermissions ?? [],
             readWritePermissions: v.readWritePermissions ?? [],
         }));

package/src/lib/mock/asset.mock.service.d.ts

@@ -1,5 +1,5 @@
 import { APIBaseMock, DataMockService, MockAPI, TrashMockService } from '.';
-import { AddToProperty, Asset, AssetRevision, Attachment, DeleteQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, TokenOption } from '../interfaces';
+import { AddToProperty, Asset, AssetRevision, Attachment, DeleteQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, TokenOption, type SearchResult } from '../interfaces';
 import { AssetService } from '../services';
 import { CrossPlatformFormData } from '../utils';
 import { ShareMockService } from './share.mock.service';
@@ -33,5 +33,8 @@ export declare class AssetMockService extends BaseService implements AssetServic
     link(id: string, elementId: string, targetProperty: string, options?: TokenOption & {
         [key: string]: any;
     }): Promise<void>;
+    search(query: string, params?: RequestParameter, options?: TokenOption & {
+        [key: string]: any;
+    }): Promise<SearchResult[]>;
 }
 export {};

package/src/lib/mock/asset.mock.service.js

@@ -135,5 +135,8 @@ class AssetMockService extends BaseService {
     link(id, elementId, targetProperty, options = {}) {
         throw new Error('Method not implemented.');
     }
+    search(query, params = {}, options = {}) {
+        throw new Error('Method not implemented.');
+    }
 }
 exports.AssetMockService = AssetMockService;

package/src/lib/mock/content.mock.service.d.ts

@@ -10,12 +10,13 @@ declare class BaseService extends APIBaseMock<Content> {
 export declare class ContentMockService extends BaseService implements ContentService {
     private contentData;
     constructor(contents: Content[], contentData: any[]);
-    download(id: string, raw?: boolean): Promise<Blob | ArrayBuffer>;
-    download(id: string, returnType: ReturnType.TEXT): Promise<string>;
-    download(id: string, returnType: ReturnType.JSON): Promise<Record<string, unknown>>;
-    download(id: string, returnType: ReturnType.NODEBUFFER): Promise<Buffer>;
-    download(id: string, returnType: ReturnType.BLOB): Promise<Blob>;
-    download(id: string, returnType: ReturnType.ARRAYBUFFER): Promise<ArrayBuffer>;
+    download(id: string, raw?: boolean, options?: any): Promise<Blob | ArrayBuffer>;
+    download(id: string, returnType: ReturnType.TEXT, options?: any): Promise<string>;
+    download(id: string, returnType: ReturnType.JSON, options?: any): Promise<Record<string, unknown>>;
+    download(id: string, returnType: ReturnType.NODEBUFFER, options?: any): Promise<Buffer>;
+    download(id: string, returnType: ReturnType.BLOB, options?: any): Promise<Blob>;
+    download(id: string, returnType: ReturnType.ARRAYBUFFER, options?: any): Promise<ArrayBuffer>;
+    download(id: string, returnType: ReturnType.STREAM, options?: any): Promise<any>;
     deleteOne(contentId: string, deleteQuery?: DeleteQuery): Promise<Content>;
     getMany(params?: RequestParameter): Promise<Paginated<Content>>;
     upload(form: CrossPlatformFormData): Promise<Content>;

package/src/lib/mock/content.mock.service.js

@@ -20,7 +20,7 @@ class ContentMockService extends BaseService {
             this.contentData.set(contents[i].id, contentData[i]);
         }
     }
-    download(id, second) {
+    download(id, second, options = {}) {
         let returnType;
         if (typeof second === 'boolean' || second == null) {
             returnType = second ? interfaces_1.ReturnType.ARRAYBUFFER : interfaces_1.ReturnType.BLOB;
@@ -60,6 +60,9 @@ class ContentMockService extends BaseService {
                 }
             case interfaces_1.ReturnType.ARRAYBUFFER:
                 return Promise.resolve(Buffer.from(this.contentData.get(id)).buffer);
+            case interfaces_1.ReturnType.STREAM: // explicitly not supported in mock to stay browser compatible
+            default:
+                return Promise.reject(new Error(`ReturnType ${returnType} not supported in mock`));
         }
     }
     deleteOne(contentId, deleteQuery = {}) {

package/src/lib/mock/object-reference.mock.service.d.ts

@@ -1,9 +1,9 @@
 import { DataMockService } from '.';
-import { CreateReferenceDto, ObjectReference, ObjectReferenceType, ReferencesQuery, TokenOption } from '../interfaces';
-import { ObjectReferenceService } from '../services/reference.service';
+import { CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery, TokenOption } from '../interfaces';
+import { ObjectReferenceService } from '../services/object-reference.service';
 export declare class ObjectReferenceMockService extends DataMockService<ObjectReference> implements ObjectReferenceService {
     constructor(initialData: ObjectReference[]);
-    find(query: ReferencesQuery, _options?: TokenOption): Promise<ObjectReference[]>;
+    find(query: ReferencesQuery, _options?: TokenOption): Promise<Paginated<ObjectReference>>;
     findAll(objId: string, _options?: TokenOption): Promise<ObjectReference[]>;
     create(dto: CreateReferenceDto, _options?: TokenOption): Promise<ObjectReference>;
     update(referenceId: number, updateData: Partial<Omit<ObjectReference, 'id' | 'createdAt'>>, _options?: TokenOption): Promise<ObjectReference>;

package/src/lib/mock/object-reference.mock.service.js

@@ -8,7 +8,7 @@ class ObjectReferenceMockService extends _1.DataMockService {
         this.data = initialData;
     }
     async find(query, _options = {}) {
-        return this.data.filter((ref) => {
+        const docs = this.data.filter((ref) => {
             const matchObjId = ref.src === query.objId || ref.tgt === query.objId;
             if (!matchObjId) {
                 return false;
@@ -25,6 +25,11 @@ class ObjectReferenceMockService extends _1.DataMockService {
             // Note: connectedObjType filter logic could be added here if needed
             return true;
         });
+        return {
+            docs,
+            total: docs.length,
+            limit: docs.length,
+        };
     }
     async findAll(objId, _options = {}) {
         return this.data.filter((ref) => ref.src === objId || ref.tgt === objId);

package/src/lib/mock/search.mock.service.d.ts

@@ -1,8 +1,8 @@
 import { APIBaseMock } from '.';
-import type { SearchOptions, SearchResult, TokenOption } from '../interfaces';
+import type { ResourceType, SearchOptions, SearchResult, TokenOption } from '../interfaces';
 import { SearchService } from '../services';
 export declare class SearchMockService extends APIBaseMock<never> implements SearchService {
     search<T extends {
         id?: string;
-    }, K extends keyof T & string = keyof T & string>(query: SearchOptions<T, K>, tokenOption?: TokenOption): Promise<SearchResult<T, K>>;
+    }, K extends keyof T & string = keyof T & string>(options: SearchOptions<T, K>, targetResourceTypes?: ResourceType[], tokenOption?: TokenOption): Promise<SearchResult<T, K>>;
 }

package/src/lib/mock/search.mock.service.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchMockService = void 0;
 const _1 = require(".");
 class SearchMockService extends _1.APIBaseMock {
-    search(query, tokenOption = {}) {
+    search(options, targetResourceTypes = [], tokenOption = {}) {
         throw new Error('Method not implemented.');
     }
 }

package/src/lib/services/ai.service.d.ts

@@ -1,19 +1,19 @@
 import { HttpClientService } from '.';
 import { APIBase } from '../api-base';
-import { AiAssistant, Message, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
+import { AiAssistant, AiAssistantId, Message, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
 export declare class AiService extends APIBase {
     constructor(httpClient: HttpClientService);
-    addMessage(message: string, threadId?: string, assistantId?: string, context?: Record<string, unknown>): Promise<Message>;
-    createThread(assistantId: string, isEphemeral?: boolean): Promise<ThreadPopulated>;
-    getLatestAssistantThread(assistantId: string): Promise<ThreadPopulated>;
-    listAssistantThreads(assistantId: string): Promise<ThreadPopulated[]>;
-    getAssistant(assistantId: string): Promise<AiAssistant>;
+    addMessage(message: string, threadId?: string, assistantId?: AiAssistantId, context?: Record<string, unknown>): Promise<Message>;
+    createThread(assistantId: AiAssistantId, isEphemeral?: boolean): Promise<ThreadPopulated>;
+    getLatestAssistantThread(assistantId: AiAssistantId): Promise<ThreadPopulated>;
+    listAssistantThreads(assistantId: AiAssistantId): Promise<ThreadPopulated[]>;
+    getAssistant(assistantId: AiAssistantId): Promise<AiAssistant>;
     getAssistants(options?: TokenOption): Promise<AiAssistant[]>;
     getSpeechToken(): Promise<SpeechToken>;
     getThreadMessages(threadId: string): Promise<Paginated<Message>>;
     getThread(threadId: string): Promise<ThreadPopulated>;
     getLatestThread(): Promise<ThreadPopulated>;
-    listThreads(assistantIds?: string[], params?: {}, options?: TokenOption): Promise<ThreadPopulated[]>;
+    listThreads(assistantIds?: AiAssistantId[], params?: {}, options?: TokenOption): Promise<ThreadPopulated[]>;
     provideFeedback(traceId: string, value: number, comment?: string): Promise<void>;
     deleteThread(threadId: string, options?: TokenOption): Promise<Thread>;
 }

package/src/lib/services/ai.service.js

@@ -37,7 +37,7 @@ class AiService extends api_base_1.APIBase {
         return this.httpClient.get(`${this.basePath}/threads/latest`);
     }
     listThreads(assistantIds, params = {}, options = {}) {
-        if (assistantIds.length) {
+        if (assistantIds?.length) {
             params = { ...params, assistantIds: assistantIds?.join(',') };
         }
         return this.httpClient.get(`${this.basePath}/threads`, { params, ...options });

package/src/lib/services/asset.service.d.ts

@@ -1,6 +1,6 @@
 import { DataService, HttpClientService, TrashService } from '.';
 import { APIBase } from '../api-base';
-import { AddToProperty, Asset, AssetRevision, Attachment, DeleteAssetQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, TokenOption } from '../interfaces';
+import { AddToProperty, Asset, AssetRevision, Attachment, DeleteAssetQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, TokenOption, type SearchResult } from '../interfaces';
 import { CrossPlatformFormData } from '../utils';
 import { ShareService } from './share.service';
 interface BaseService extends DataService<Asset>, ShareService, TrashService<Asset> {
@@ -27,5 +27,8 @@ export declare class AssetService extends BaseService {
     link(id: string, elementId: string, targetProperty: string, options?: TokenOption & {
         [key: string]: any;
     }): Promise<void>;
+    search(query: string, params?: RequestParameter, options?: TokenOption & {
+        [key: string]: any;
+    }): Promise<SearchResult[]>;
 }
 export {};

package/src/lib/services/asset.service.js

@@ -74,5 +74,8 @@ class AssetService extends BaseService {
             targetProperty,
         }, options);
     }
+    search(query, params = {}, options = {}) {
+        return this.httpClient.get(`${this.basePath}/search`, { params: { ...params, query }, ...options });
+    }
 }
 exports.AssetService = AssetService;

package/src/lib/services/content.service.d.ts

@@ -16,5 +16,6 @@ export declare class ContentService extends BaseService {
     download(id: string, returnType: ReturnType.NODEBUFFER, options?: TokenOption): Promise<Buffer>;
     download(id: string, returnType: ReturnType.BLOB, options?: TokenOption): Promise<Blob>;
     download(id: string, returnType: ReturnType.ARRAYBUFFER, options?: TokenOption): Promise<ArrayBuffer>;
+    download(id: string, returnType: ReturnType.STREAM, options?: TokenOption): Promise<any>;
 }
 export {};

package/src/lib/services/content.service.js

@@ -47,6 +47,8 @@ class ContentService extends BaseService {
                 return this.httpClient.get(url, { responseType: 'blob', ...options });
             case interfaces_1.ReturnType.ARRAYBUFFER:
                 return this.httpClient.get(url, { responseType: 'arraybuffer', ...options });
+            case interfaces_1.ReturnType.STREAM:
+                return this.httpClient.get(url, { responseType: 'stream', ...options });
         }
     }
 }

package/src/lib/services/http-client.service.d.ts

@@ -62,6 +62,7 @@ export declare class HttpClientService {
     protected discoverIssuer(uri: string): Promise<Issuer>;
     protected requestAccessToken(additionalOpts?: {}): Promise<TokenSet>;
     protected exchangeAccessToken(accessToken: string): Promise<TokenSet>;
+    exchangeExternalToken(token: string, subjectIssuer: string): Promise<TokenSet>;
     provideExternalToken(token: string): Promise<void>;
     private requestPromise;
 }

package/src/lib/services/http-client.service.js

@@ -258,6 +258,16 @@ class HttpClientService {
         };
         return this.requestAccessToken(opts);
     }
+    async exchangeExternalToken(token, subjectIssuer) {
+        return this.requestAccessToken({
+            grant_type: 'urn:ietf:params:oauth:grant-type:token-exchange',
+            subject_token: token,
+            subject_token_type: 'urn:ietf:params:oauth:token-type:access_token',
+            subject_issuer: subjectIssuer,
+            requested_token_type: 'urn:ietf:params:oauth:token-type:access_token',
+            audience: this.clientId,
+        });
+    }
     async provideExternalToken(token) {
         const issuer = await this.discoverIssuer(`${this.authBaseURL}/realms/${this.realm}`);
         const { iss: providedIssuer, exp } = (0, jose_1.decodeJwt)(token);

package/src/lib/services/index.d.ts

@@ -19,7 +19,7 @@ export { OrganizationsService } from './organizations.service';
 export { OrganizationsAdministrationService } from './organizations-administration.service';
 export { OrganizationsResourcesService } from './organizations-resources.service';
 export { ProxyService } from './proxy.service';
-export { ObjectReferenceService } from './reference.service';
+export { ObjectReferenceService } from './object-reference.service';
 export { SearchService } from './search.service';
 export { ShareService } from './share.service';
 export { TaskService } from './task.service';

package/src/lib/services/index.js

@@ -43,8 +43,8 @@ var organizations_resources_service_1 = require("./organizations-resources.servi
 Object.defineProperty(exports, "OrganizationsResourcesService", { enumerable: true, get: function () { return organizations_resources_service_1.OrganizationsResourcesService; } });
 var proxy_service_1 = require("./proxy.service");
 Object.defineProperty(exports, "ProxyService", { enumerable: true, get: function () { return proxy_service_1.ProxyService; } });
-var reference_service_1 = require("./reference.service");
-Object.defineProperty(exports, "ObjectReferenceService", { enumerable: true, get: function () { return reference_service_1.ObjectReferenceService; } });
+var object_reference_service_1 = require("./object-reference.service");
+Object.defineProperty(exports, "ObjectReferenceService", { enumerable: true, get: function () { return object_reference_service_1.ObjectReferenceService; } });
 var search_service_1 = require("./search.service");
 Object.defineProperty(exports, "SearchService", { enumerable: true, get: function () { return search_service_1.SearchService; } });
 var share_service_1 = require("./share.service");

package/src/lib/services/{reference.service.d.ts → object-reference.service.d.ts}

@@ -1,9 +1,9 @@
-import { CreateReferenceDto, ObjectReference, ObjectReferenceType, ReferencesQuery, TokenOption } from '../interfaces';
+import { CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery, TokenOption } from '../interfaces';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
 export declare class ObjectReferenceService extends DataService<ObjectReference> {
     constructor(httpClient: HttpClientService);
-    find(query: ReferencesQuery, options?: TokenOption): Promise<ObjectReference[]>;
+    find(query: ReferencesQuery, options?: TokenOption): Promise<Paginated<ObjectReference>>;
     findAll(objId: string, options?: TokenOption): Promise<ObjectReference[]>;
     create(dto: CreateReferenceDto, options?: TokenOption): Promise<ObjectReference>;
     update(referenceId: number, updateData: Partial<Omit<ObjectReference, 'id' | 'createdAt'>>, options?: TokenOption): Promise<ObjectReference>;

package/src/lib/services/search.service.d.ts

@@ -1,9 +1,9 @@
 import { HttpClientService } from '.';
 import { APIBase } from '../api-base';
-import type { SearchOptions, SearchResult, TokenOption } from '../interfaces';
+import type { ResourceType, SearchOptions, SearchResult, TokenOption } from '../interfaces';
 export declare class SearchService extends APIBase {
     constructor(httpClient: HttpClientService);
     search<T extends {
         id?: string;
-    }, K extends keyof T & string = keyof T & string>(query: SearchOptions<T, K>, tokenOption?: TokenOption): Promise<SearchResult<T, K>>;
+    }, K extends keyof T & string = keyof T & string>(options: SearchOptions<T, K>, targetResourceTypes?: ResourceType[], tokenOption?: TokenOption): Promise<SearchResult<T, K>>;
 }

package/src/lib/services/search.service.js

@@ -6,8 +6,8 @@ class SearchService extends api_base_1.APIBase {
     constructor(httpClient) {
         super(httpClient, '/search');
     }
-    search(query, tokenOption = {}) {
-        return this.httpClient.post(this.basePath, query, tokenOption);
+    search(options, targetResourceTypes = [], tokenOption = {}) {
+        return this.httpClient.post(this.basePath, { options, targetResourceTypes }, tokenOption);
     }
 }
 exports.SearchService = SearchService;