@hahnpro/hpc-api 2026.6.5 → 2026.6.6

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @hahnpro/hpc-api
 
+# 2026.6.6
+
+- Added One-Shot-AI Endpoint
+
 # 2026.6.5
 
 - Added new endpoints to the Dataspace API service client

package/package.json

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

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

@@ -256,4 +256,10 @@ export interface GenericResourceSelectionOption extends BaseResourceSelectionOpt
     resourceType: Exclude<ReferenceType, ReferenceType.ASSET | ReferenceType.DOCUMENT | ReferenceType.LOGBOOK_ENTRY>;
 }
 export type ResourceSelectionOption = AssetResourceSelectionOption | DocumentResourceSelectionOption | LogbookEntryResourceSelectionOption | GenericResourceSelectionOption;
+export declare enum OneShotTaskId {
+    ASSET_ASSISTANT_PARTIAL_SUMMARY = "ASSET_ASSISTANT_PARTIAL_SUMMARY"
+}
+export interface OneShotTaskResult {
+    text: string;
+}
 export {};

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AiAssistantId = exports.HandOffTool = exports.ReturnToReferrerTool = exports.ToolName = exports.AgentId = exports.ReferenceType = exports.AttachmentHandlingMode = exports.ToolType = exports.ErrorMessageType = exports.Role = exports.AvailableLanguages = exports.FinishReason = exports.ToolMessageStatus = exports.AssistantMessageStatus = void 0;
+exports.OneShotTaskId = exports.AiAssistantId = exports.HandOffTool = exports.ReturnToReferrerTool = exports.ToolName = exports.AgentId = exports.ReferenceType = exports.AttachmentHandlingMode = exports.ToolType = exports.ErrorMessageType = exports.Role = exports.AvailableLanguages = exports.FinishReason = exports.ToolMessageStatus = exports.AssistantMessageStatus = void 0;
 var AssistantMessageStatus;
 (function (AssistantMessageStatus) {
     AssistantMessageStatus["ABORTING"] = "aborting";
@@ -137,3 +137,7 @@ var AiAssistantId;
     AiAssistantId["REPORT"] = "report-assistant";
     AiAssistantId["AXALTA_INCIDENT"] = "axalta-incident-assistant";
 })(AiAssistantId || (exports.AiAssistantId = AiAssistantId = {}));
+var OneShotTaskId;
+(function (OneShotTaskId) {
+    OneShotTaskId["ASSET_ASSISTANT_PARTIAL_SUMMARY"] = "ASSET_ASSISTANT_PARTIAL_SUMMARY";
+})(OneShotTaskId || (exports.OneShotTaskId = OneShotTaskId = {}));

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

@@ -73,6 +73,32 @@ export interface CompanyCandidate {
     source: string;
     sourceId: string;
 }
+export type CrmImportDuplicateEntityType = 'contact' | 'company' | 'touchpoint';
+export type CrmImportDuplicateDecision = 'autoMerged' | 'needsReview';
+export type CrmImportDuplicateReasonCode = 'same_name_business_vs_public_email' | 'same_name_same_phone' | 'same_name_conflicting_business_domains' | 'multiple_existing_matches' | 'weak_name_only';
+export interface CrmImportContactDuplicateDetails {
+    primaryEmail?: string;
+    preservedEmails: string[];
+}
+export interface CrmImportContactDuplicateMemberDetails {
+    email?: string;
+    domain?: string;
+    role?: string;
+}
+export interface CrmImportDuplicateMember {
+    sourceId: string;
+    name: string;
+    isCanonical: boolean;
+    contactDetails?: CrmImportContactDuplicateMemberDetails;
+}
+export interface CrmImportDuplicateGroup<T extends CrmImportDuplicateEntityType = CrmImportDuplicateEntityType> {
+    entityType: T;
+    decision: CrmImportDuplicateDecision;
+    reasonCodes: CrmImportDuplicateReasonCode[];
+    canonicalSourceId?: string;
+    members: CrmImportDuplicateMember[];
+    contactDetails?: CrmImportContactDuplicateDetails;
+}
 export interface MatchResult {
     found: boolean;
     assetId?: string;
@@ -98,6 +124,7 @@ export interface CrmImportResponse {
     touchpoints: TouchpointCandidate[];
     contacts: ContactCandidate[];
     companies: CompanyCandidate[];
+    duplicates: CrmImportDuplicateGroup[];
     contactMatches: Record<string, MatchResult>;
     companyMatches: Record<string, MatchResult>;
     companyAssetIds: Record<string, string>;

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

@@ -1,4 +1,4 @@
-export type { AiAssistant, AssetResourceSelectionOption, AssistantMessage, DocumentResourceSelectionOption, ErrorMessage, GenericResourceSelectionOption, LogbookEntryResourceSelectionOption, Message, MessageAttachment, ResourceSelectionOption, ResourceSelectionRejected, SpeechToken, SystemMessage, Thread, ThreadPopulated, ToolMessage, ToolNameType, UserMessage, } from './ai.interface';
+export type { AiAssistant, AssetResourceSelectionOption, AssistantMessage, DocumentResourceSelectionOption, ErrorMessage, GenericResourceSelectionOption, LogbookEntryResourceSelectionOption, Message, MessageAttachment, OneShotTaskResult, ResourceSelectionOption, ResourceSelectionRejected, SpeechToken, SystemMessage, Thread, ThreadPopulated, ToolMessage, ToolNameType, UserMessage, } from './ai.interface';
 export type { Alert, AlertCondition, TimeSeriesReference, UpdatedField } from './alert.interface';
 export type { Api, Change, ChangeSubject, ObjectIdLike } from './api.interface';
 export type { AddToProperty, Asset, AssetChange, AssetRevision, AssetSubject, AssetTimeSeriesValue, AssetType, AssetTypeRevision, AssetTypeSearchResult, Attachment, EventCause, EventLevelOverride, RemoveFromProperty, Template, } from './asset.interface';
@@ -6,7 +6,7 @@ export type { Audit } from './audit.interface';
 export type { Author } from './author.interface';
 export type { AzureBillingEvent, AzureBillingResult, Billing, BillingEvent, BillingResource, BillingSubscription, BillingValues, OnceBilledResources, RegularlyBilledResources, } from './billing.interface';
 export type { Content, ContentAnalysis, ContentChange, ContentSearchResult, IndexingStatusData, ReindexStatusSsePayload, } from './content.interface';
-export type { CompanyCandidate, ContactCandidate, CrmImportJsonRequest, CrmImportParser, CrmImportResponse, ImportResult, ImportResultStats, MatchResult, MeetingReport, ReportActivity, ReportParticipant, ReportSummary, TouchpointCandidate, } from './crm.interface';
+export type { CompanyCandidate, ContactCandidate, CrmImportDuplicateDecision, CrmImportDuplicateEntityType, CrmImportDuplicateGroup, CrmImportDuplicateMember, CrmImportDuplicateReasonCode, CrmImportContactDuplicateDetails, CrmImportContactDuplicateMemberDetails, CrmImportJsonRequest, CrmImportParser, CrmImportResponse, ImportResult, ImportResultStats, MatchResult, MeetingReport, ReportActivity, ReportParticipant, ReportSummary, TouchpointCandidate, } from './crm.interface';
 export type { DataInterface, Filter, Paginated, RequestParameter } from './data.interface';
 export type { ShareInDataspaceDto, ShareInDataspaceResult } from './dataspace.interface';
 export type { EdgeDeviceRequestResponse, EdgeDeviceResult, WebIOData } from './edge-device.interface';
@@ -43,7 +43,7 @@ export type { Retention, SearchTimeSeriesResult, SelectedField, TimeSeries, Time
 export type { Translation, TranslationData } from './translation.interface';
 export type { Application, Consent, Permission, TableSetting, TableSettingProfile, UserSettings } from './user-settings.interface';
 export type { KVSecretVersion, VaultSecret } from './vault.interface';
-export { AgentId, AiAssistantId, AssistantMessageStatus, AttachmentHandlingMode, AvailableLanguages, ErrorMessageType, FinishReason, HandOffTool, ReferenceType, ReturnToReferrerTool, Role, ToolMessageStatus, ToolName, ToolType, } from './ai.interface';
+export { AgentId, AiAssistantId, AssistantMessageStatus, AttachmentHandlingMode, AvailableLanguages, ErrorMessageType, FinishReason, HandOffTool, OneShotTaskId, ReferenceType, ReturnToReferrerTool, Role, ToolMessageStatus, ToolName, ToolType, } from './ai.interface';
 export { AlertLevel, AlertStatus, AlertType, DEFAULT_DEADMAN_CONDITION, DEFAULT_RELATIVE_CONDITION, DEFAULT_THRESHOLD_CONDITION, } from './alert.interface';
 export { ChangeAction } from './api.interface';
 export { BillingResourceType } from './billing.interface';

package/src/lib/interfaces/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NatsStreams = exports.natsHpcPrefix = exports.natsFlowsPrefix = exports.NatsConsumers = exports.SubscriptionType = exports.LABEL_COLORS = exports.FlowDiagram = exports.Flow = exports.NATS_FLOW_TRIGGER_STATUSES = exports.FlowDeployment = exports.UNKOWN_STATES = exports.STOPPED_STATES = exports.RUNNING_STATES = exports.PROCESSING_STATES = exports.FlowDeploymentStatus = exports.ERROR_STATES = exports.TimeSlotStatus = exports.APPLICATION_AREA = exports.eventLevels = exports.EventLevelOverrideWrapper = exports.EventLevel = exports.NotificationEndpointType = exports.NotificationEndpointStatus = exports.NotificationEndpointSpamProtection = exports.instanceOfTimePeriod = exports.ReturnType = exports.IndexingStatus = exports.ContentAnalysisStatus = exports.BillingResourceType = exports.ChangeAction = exports.DEFAULT_THRESHOLD_CONDITION = exports.DEFAULT_RELATIVE_CONDITION = exports.DEFAULT_DEADMAN_CONDITION = exports.AlertType = exports.AlertStatus = exports.AlertLevel = exports.ToolType = exports.ToolName = exports.ToolMessageStatus = exports.Role = exports.ReturnToReferrerTool = exports.ReferenceType = exports.HandOffTool = exports.FinishReason = exports.ErrorMessageType = exports.AvailableLanguages = exports.AttachmentHandlingMode = exports.AssistantMessageStatus = exports.AiAssistantId = exports.AgentId = void 0;
-exports.WebSocketMessageType = exports.SecretType = exports.isUserMessage = exports.isTask = exports.isStorage = exports.isOwner = exports.isLogbookEntry = exports.isEvent = exports.isContentAnalysis = exports.isContent = exports.isAuthor = exports.isAssignee = exports.isAsset = exports.TranslationEditData = exports.RETENTION_VALUES = exports.TaskStatus = exports.Priority = exports.INACTIVE_TASK_STATUSES = exports.buildTaskStatusFilter = exports.AssigneeType = exports.ACTIVE_TASK_STATUSES = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.isPopulated = exports.EventType = exports.CommandType = exports.arePopulated = exports.ObjectReferenceType = exports.OwnerType = exports.OrganizationMembersInviteOrAdd = exports.NotificationRuleStatus = void 0;
+exports.natsHpcPrefix = exports.natsFlowsPrefix = exports.NatsConsumers = exports.SubscriptionType = exports.LABEL_COLORS = exports.FlowDiagram = exports.Flow = exports.NATS_FLOW_TRIGGER_STATUSES = exports.FlowDeployment = exports.UNKOWN_STATES = exports.STOPPED_STATES = exports.RUNNING_STATES = exports.PROCESSING_STATES = exports.FlowDeploymentStatus = exports.ERROR_STATES = exports.TimeSlotStatus = exports.APPLICATION_AREA = exports.eventLevels = exports.EventLevelOverrideWrapper = exports.EventLevel = exports.NotificationEndpointType = exports.NotificationEndpointStatus = exports.NotificationEndpointSpamProtection = exports.instanceOfTimePeriod = exports.ReturnType = exports.IndexingStatus = exports.ContentAnalysisStatus = exports.BillingResourceType = exports.ChangeAction = exports.DEFAULT_THRESHOLD_CONDITION = exports.DEFAULT_RELATIVE_CONDITION = exports.DEFAULT_DEADMAN_CONDITION = exports.AlertType = exports.AlertStatus = exports.AlertLevel = exports.ToolType = exports.ToolName = exports.ToolMessageStatus = exports.Role = exports.ReturnToReferrerTool = exports.ReferenceType = exports.OneShotTaskId = exports.HandOffTool = exports.FinishReason = exports.ErrorMessageType = exports.AvailableLanguages = exports.AttachmentHandlingMode = exports.AssistantMessageStatus = exports.AiAssistantId = exports.AgentId = void 0;
+exports.WebSocketMessageType = exports.SecretType = exports.isUserMessage = exports.isTask = exports.isStorage = exports.isOwner = exports.isLogbookEntry = exports.isEvent = exports.isContentAnalysis = exports.isContent = exports.isAuthor = exports.isAssignee = exports.isAsset = exports.TranslationEditData = exports.RETENTION_VALUES = exports.TaskStatus = exports.Priority = exports.INACTIVE_TASK_STATUSES = exports.buildTaskStatusFilter = exports.AssigneeType = exports.ACTIVE_TASK_STATUSES = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.isPopulated = exports.EventType = exports.CommandType = exports.arePopulated = exports.ObjectReferenceType = exports.OwnerType = exports.OrganizationMembersInviteOrAdd = exports.NotificationRuleStatus = exports.NatsStreams = void 0;
 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; } });
@@ -11,6 +11,7 @@ Object.defineProperty(exports, "AvailableLanguages", { enumerable: true, get: fu
 Object.defineProperty(exports, "ErrorMessageType", { enumerable: true, get: function () { return ai_interface_1.ErrorMessageType; } });
 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, "OneShotTaskId", { enumerable: true, get: function () { return ai_interface_1.OneShotTaskId; } });
 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; } });

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

@@ -1,5 +1,5 @@
 import { APIBaseMock } from '.';
-import { AiAssistant, Message, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
+import { AiAssistant, Message, OneShotTaskId, OneShotTaskResult, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
 import { AiService } from '../services';
 export declare class AiMockService extends APIBaseMock<never> implements AiService {
     constructor();
@@ -16,4 +16,5 @@ export declare class AiMockService extends APIBaseMock<never> implements AiServi
     listAssistantThreads(assistantId: string): Promise<ThreadPopulated[]>;
     provideFeedback(traceId: string, value: number, comment?: string): Promise<void>;
     deleteThread(threadId: string, options?: TokenOption): Promise<Thread>;
+    runOneShotTask(taskId: OneShotTaskId, params: Record<string, unknown>): Promise<OneShotTaskResult>;
 }

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

@@ -45,5 +45,8 @@ class AiMockService extends _1.APIBaseMock {
     deleteThread(threadId, options = {}) {
         throw new Error('Method not implemented.');
     }
+    runOneShotTask(taskId, params) {
+        return Promise.resolve({ text: 'Mock response' });
+    }
 }
 exports.AiMockService = AiMockService;

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

@@ -27,6 +27,7 @@ class CrmMockService extends crm_service_1.CrmService {
             touchpoints: [],
             contacts: [],
             companies: [],
+            duplicates: [],
             contactMatches: {},
             companyMatches: {},
             companyAssetIds: {},

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

@@ -1,6 +1,6 @@
 import { HttpClientService } from '.';
 import { APIBase } from '../api-base';
-import { AiAssistant, AiAssistantId, Message, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
+import { AiAssistant, AiAssistantId, Message, OneShotTaskId, OneShotTaskResult, Paginated, SpeechToken, Thread, ThreadPopulated, TokenOption } from '../interfaces';
 export declare class AiService extends APIBase {
     constructor(httpClient: HttpClientService);
     addMessage(message: string, threadId?: string, assistantId?: AiAssistantId, context?: Record<string, unknown>, attachmentIds?: string[]): Promise<Message>;
@@ -16,4 +16,5 @@ export declare class AiService extends APIBase {
     listThreads(assistantIds?: AiAssistantId[], params?: {}, options?: TokenOption): Promise<ThreadPopulated[]>;
     provideFeedback(traceId: string, value: number, comment?: string): Promise<void>;
     deleteThread(threadId: string, options?: TokenOption): Promise<Thread>;
+    runOneShotTask(taskId: OneShotTaskId, params: Record<string, unknown>): Promise<OneShotTaskResult>;
 }

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

@@ -48,5 +48,8 @@ class AiService extends api_base_1.APIBase {
     deleteThread(threadId, options = {}) {
         return this.httpClient.delete(`${this.basePath}/threads/${threadId}`, options);
     }
+    runOneShotTask(taskId, params) {
+        return this.httpClient.post(`${this.basePath}/one-shot`, { taskId, params });
+    }
 }
 exports.AiService = AiService;