@or-sdk/hitl 0.36.5 → 0.37.0-beta.4142.0

package/dist/types/api/SessionEvents.d.ts

@@ -1,15 +1,160 @@
 import { GetNewEventsCountOptions, GetNewEventsCountResponse, SaveLastReadEventOptions } from '../types/read-events';
 import { GetSessionEventsOptions, GetSessionEventsResponse, AddEventsOptions, AddEventsResponse, GetBulkSessionEventsOptions, GetBulkSessionsEventsResponse } from '../types/session-events';
 import { HITLBase } from './HITLBase';
+/**
+ * Manages events for Human-in-the-Loop (HitL) sessions
+ *
+ * This class provides functionality to:
+ * - Retrieve and manage session events
+ * - Track event read status
+ * - Handle bulk event operations
+ * - Manage event counts
+ *
+ * @remarks
+ * - All methods interact with the `/session-events` endpoint
+ * @public
+ */
 export declare class SessionEvents extends HITLBase {
     protected static MODULE_URL: string;
     protected static GET_BULK_EVENTS_URL: string;
     protected static GET_EVENTS_COUNT_URL: string;
     protected static SAVE_READ_EVENT_URL: string;
+    /**
+     * Retrieves events for a specific HitL session
+     *
+     * @param options - Configuration parameters for retrieving session events
+     *
+     * Required parameters:
+     * - `sessionId` - (string) ID of the session to retrieve events for
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<SessionEvent[]>} Promise resolving to the list of session events
+     *
+     * @example
+     * ```typescript
+     * const events = await hitlApi.sessionEvents.getSessionEventsList({
+     *   sessionId: 'session-id'
+     * });
+     * ```
+     *
+     * @remarks Makes a GET request to `/session-events`
+     * @public
+     */
     static getSessionEventsList(options: GetSessionEventsOptions): Promise<GetSessionEventsResponse>;
+    /**
+     * Retrieves events for multiple HitL sessions in bulk
+     *
+     * @param options - Configuration parameters for bulk event retrieval
+     *
+     * Required parameters:
+     * - `sessionIds` - (string[]) Array of session IDs to retrieve events for
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<GetBulkSessionsEventsResponse>} Promise resolving to events for multiple sessions
+     *
+     * @example
+     * ```typescript
+     * const bulkEvents = await hitlApi.sessionEvents.getBulkSessionEventsList({
+     *   sessionIds: ['session-id-1', 'session-id-2']
+     * });
+     * ```
+     *
+     * @remarks Makes a POST request to `/session-events/bulk`
+     * @public
+     */
     static getBulkSessionEventsList(options: GetBulkSessionEventsOptions): Promise<GetBulkSessionsEventsResponse>;
+    /**
+     * Adds new events to a HITL session
+     *
+     * @param options - Configuration parameters for adding session events
+     *
+     * Required parameters:
+     * - `events` - (Partial<SessionEvent>[]) Array of partial event objects
+     * - `sessionId` - (string) ID of the session to add events to
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<AddEventsResult>} Promise resolving to the add operation result
+     *
+     * @example
+     * ```typescript
+     * const result = await hitlApi.sessionEvents.addEvents({
+     *   sessionId: 'session-id',
+     *   events: [
+     *     { type: 'message', content: 'Hello' },
+     *     { type: 'status', content: 'typing' }
+     *   ]
+     * });
+     * ```
+     *
+     * @remarks Makes a POST request to `/session-events`
+     * @public
+     */
     static addEvents({ sessionId, events, ...options }: AddEventsOptions): Promise<AddEventsResponse>;
+    /**
+     * Retrieves count of unread events for specified sessions
+     *
+     * @param options - Configuration parameters for retrieving unread events count
+     *
+     * Required parameters:
+     * - `sessionIds` - (string[]) Array of session IDs to get events count for
+     *
+     * Optional parameters:
+     * - `agentId` - (string) ID of the agent to get unread events for
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<NewEventsCount>} Promise resolving to the unread events count
+     *
+     * @example
+     * ```typescript
+     * // Basic usage with required parameters
+     * const count = await hitlApi.sessionEvents.getNewEventsCount({
+     *   sessionIds: ['session-id-1', 'session-id-2']
+     * });
+     * ```
+     *
+     * @remarks Makes a GET request to `/sessions-events/get-new-events`
+     * @public
+     */
     static getNewEventsCount({ agentId, ...options }: GetNewEventsCountOptions): Promise<GetNewEventsCountResponse>;
+    /**
+     * Records the last read event for a specific session
+     *
+     * @param options - Configuration parameters for saving last read event
+     *
+     * Required parameters:
+     * - `eventId` - (string) ID of the last read event
+     * - `eventTimestamp` - (string | number) Timestamp of the last read event
+     * - `sessionId` - (string) ID of the session
+     *
+     * Optional parameters:
+     * - `agentId` - (string) ID of the agent who read the event
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<void>} Promise resolving when the read status is saved
+     *
+     * @example
+     * ```typescript
+     * await hitlApi.sessionEvents.saveLastReadEvent({
+     *   sessionId: 'session-id-1',
+     *   eventId: 'event-id-2',
+     *   eventTimestamp: Date.now()
+     * });
+     * ```
+     *
+     * @remarks Makes a POST request to `/sessions-events/save-read-event`
+     * @public
+     */
     static saveReadEventByUserId({ agentId, ...options }: SaveLastReadEventOptions): Promise<void>;
 }
 //# sourceMappingURL=SessionEvents.d.ts.map

package/dist/types/api/SessionEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAetC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAU;IAC9C,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAoB;IACzD,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAqB;WA0BrC,oBAAoB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;WAsChB,wBAAwB,CAC1C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC;WA4C3B,SAAS,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAClD,OAAO,CAAC,iBAAiB,CAAC;WAsCT,iBAAiB,CACnC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,yBAAyB,CAAC;WA6CjB,qBAAqB,CACvC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,IAAI,CAAC;CAejB"}
+{"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAU;IAC9C,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAoB;IACzD,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAqB;IAEzD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,oBAAoB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IAcpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;WACiB,wBAAwB,CAC1C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IAezC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACW,SAAS,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAClD,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;WACiB,iBAAiB,CACnC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,yBAAyB,CAAC;IAgBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACiB,qBAAqB,CACvC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/types/api/SessionRelations.d.ts

@@ -1,9 +1,118 @@
 import { GetSessionRelationsOptions, GetSessionRelationsResponse, CreateSessionRelationsOptions, CreateSessionRelationsResponse, DeleteSessionRelationsOptions } from '../types/session-relations';
 import { HITLBase } from './HITLBase';
+/**
+ * Manages relationships between HitL (Human-in-the-Loop) sessions
+ *
+ * This class provides functionality to:
+ * - Retrieve session relationships
+ * - Create new relationships between sessions
+ * - Remove existing relationships
+ *
+ * @remarks
+ * - All methods in this class interact with the `/session-relations` endpoint
+ * @public
+ */
 export declare class SessionRelations extends HITLBase {
     protected static MODULE_URL: string;
+    /**
+     * Retrieves a list of HitL session relations based on specified criteria
+     *
+     * @param options - Configuration parameters for retrieving HitL session relations
+     *
+     * Required parameters:
+     * - `sessionIds` - (string[]) Array of session IDs to retrieve relations for
+     *
+     * Optional parameters:
+     * - `relations` - (string[]) Array of specific relation types to retrieve
+     * - `skipSessions` - (boolean) Whether to skip retrieving session details
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<GetSessionRelationsResponse>} Promise resolving to session relationships
+     *
+     * @example
+     * ```typescript
+     * // Get all relations and sessions from this relations for specific sessions
+     * const relations = await hitlApi.sessionRelations.getSessionRelations({
+     *   sessionIds: ['session-id-1', 'session-id-2']
+     * });
+     *
+     * // Get specific relation types with session details skipped
+     * const relations = await hitlApi.sessionRelations.getSessionRelations({
+     *   sessionIds: ['session-id-1'],
+     *   relations: ['parent', 'child'],
+     *   skipSessions: true
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a GET request to the `/session-relations` endpoint
+     * @public
+     */
     static getSessionRelations(options: GetSessionRelationsOptions): Promise<GetSessionRelationsResponse>;
+    /**
+     * Creates new relations between HitL sessions
+     *
+     * @param options - Configuration parameters for creating session relations
+     *
+     * Required parameters:
+     * - `relations` - ({@link SessionRelation}[]) Array of session relation objects to create
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<SessionRelation[]>} Promise resolving to array of created session relations
+     *
+     * @example
+     * ```typescript
+     * const created = await hitlApi.sessionRelations.createSessionRelations({
+     *   relations: [{
+     *     aSessionId: 'session-id-1',
+     *     bSessionId: 'session-id-2',
+     *     relation: 'parent'
+     *   }, {
+     *     aSessionId: 'session-id-1',
+     *     bSessionId: 'session-id-3',
+     *     relation: 'parent'
+     *   }]
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a POST request to the `/session-relations` endpoint
+     * @public
+     */
     static createSessionRelations(options: CreateSessionRelationsOptions): Promise<CreateSessionRelationsResponse>;
+    /**
+     * Deletes specified HitL session relationships
+     *
+     * @param options - Configuration parameters for deleting relationships
+     *
+     * Required parameters:
+     * - `relations` - ({@link SessionRelation}[]) Array of session relation objects to delete
+     *
+     * Optional parameters:
+     * - `timeout` - (number) Request timeout in milliseconds
+     * - `version` - (string | number) API version to use
+     *
+     * @returns {Promise<void>} Promise that resolves when deletion is complete
+     *
+     * @example
+     * ```typescript
+     * await hitlApi.sessionRelations.deleteSessionRelations({
+     *   relations: [{
+     *     aSessionId: 'session-id-1',
+     *     bSessionId: 'session-id-2',
+     *     relation: 'parent'
+     *   }]
+     * });
+     * ```
+     *
+     * @remarks
+     * Makes a DELETE request to the `/session-relations` endpoint
+     * @public
+     */
     static deleteSessionRelations(options: DeleteSessionRelationsOptions): Promise<void>;
 }
 //# sourceMappingURL=SessionRelations.d.ts.map

package/dist/types/api/SessionRelations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionRelations.d.ts","sourceRoot":"","sources":["../../../src/api/SessionRelations.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AActC,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAuB;WAqCpC,mBAAmB,CAC/B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC;WA+CzB,sBAAsB,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,8BAA8B,CAAC;WA2C5B,sBAAsB,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;CAajB"}
+{"version":3,"file":"SessionRelations.d.ts","sourceRoot":"","sources":["../../../src/api/SessionRelations.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,SAAS,CAAC,MAAM,CAAC,UAAU,SAAuB;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;WACW,mBAAmB,CAC/B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC;IAcvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;WACW,sBAAsB,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,8BAA8B,CAAC;IAc1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACW,sBAAsB,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;CAajB"}