@cimulate/copilot-sdk 3.8.0 → 3.10.0

package/dist/types/model/ConversationEvents.d.ts

@@ -0,0 +1,8 @@
+interface ConversationEvents {
+    conversationId: string;
+    limit?: number;
+    since?: string;
+    includeEvents?: string[];
+    excludeEvents?: string[];
+}
+export { ConversationEvents };

package/dist/types/model/CopilotAPIEvent.d.ts

@@ -11,7 +11,8 @@ import { FollowUp } from "./FollowUp";
 import { Inquiry } from "./Inquiry";
 import { PartialInquiry } from "./PartialInquiry";
 import { Progress } from "./Progress";
+import { RefinedBrowse } from "./RefinedBrowse";
 import { RefinedSearch } from "./RefinedSearch";
 import { ReturnedFields } from "./ReturnedFields";
-export type CopilotAPIEvent<TReturnedFields extends ReturnedFields = ReturnedFields> = ConnectAck | ConnectError | DisplayProducts<TReturnedFields> | Done | CopilotError | FollowUp | Inquiry | PartialInquiry | Progress | RefinedSearch<TReturnedFields>;
+export type CopilotAPIEvent<TReturnedFields extends ReturnedFields = ReturnedFields> = ConnectAck | ConnectError | DisplayProducts<TReturnedFields> | Done | CopilotError | FollowUp | Inquiry | PartialInquiry | Progress | RefinedBrowse<TReturnedFields> | RefinedSearch<TReturnedFields>;
 export type CopilotEventName = CopilotAPIEvent["name"];

package/dist/types/model/CopilotEvent.d.ts

@@ -6,6 +6,7 @@ import { Done } from './Done';
 import { FollowUp } from './FollowUp';
 import { Inquiry } from './Inquiry';
 import { Progress } from './Progress';
+import { RefinedBrowse } from './RefinedBrowse';
 import { RefinedSearch } from './RefinedSearch';
 import { ReturnedFields } from "./ReturnedFields";
 interface CopilotEvent<TReturnedFields extends ReturnedFields = ReturnedFields> {
@@ -13,7 +14,7 @@ interface CopilotEvent<TReturnedFields extends ReturnedFields = ReturnedFields>
     sessionId: string;
     name: string;
     eventSourceId: string;
-    data: ConnectAck | FollowUp | Inquiry | DisplayProducts<TReturnedFields> | RefinedSearch<TReturnedFields> | Progress | Done | CopilotError;
+    data: ConnectAck | FollowUp | Inquiry | DisplayProducts<TReturnedFields> | RefinedBrowse<TReturnedFields> | RefinedSearch<TReturnedFields> | Progress | Done | CopilotError;
     createdAt: string;
     metadata: CommonMetadata;
 }

package/dist/types/model/RefinedBrowse.d.ts

@@ -0,0 +1,16 @@
+import { BrowseParams } from './BrowseParams';
+import { Facet } from './Facet';
+import { ReturnedFields } from "./ReturnedFields";
+interface RefinedBrowse<TReturnedFields extends ReturnedFields = ReturnedFields> {
+    sessionId: string;
+    id: string;
+    createdAt: string;
+    eventSourceId: string;
+    message: string;
+    name: 'refined_browse';
+    browseParams: BrowseParams;
+    hits?: TReturnedFields;
+    totalHits?: number;
+    facets?: Facet[];
+}
+export { RefinedBrowse };

package/dist/types/model/ReturnedFields.d.ts

@@ -2,5 +2,6 @@
  * @generic
  * @overrides DisplayProducts.products
  * @overrides RefinedSearch.hits
+ * @overrides RefinedBrowse.hits
  */
 export type ReturnedFields = Record<string, any>[];

package/dist/types/model/index.d.ts

@@ -7,6 +7,7 @@ export * from './CommonRequiredFields';
 export * from './ConnectAck';
 export * from './ConnectAckMetadata';
 export * from './ConnectError';
+export * from './ConversationEvents';
 export * from './ConversationReset';
 export * from './ConversationResetAck';
 export * from './CopilotApiAck';
@@ -36,6 +37,7 @@ export * from './ProductViewAck';
 export * from './ProductViewSuggestion';
 export * from './Progress';
 export * from './ProgressToolKwargs';
+export * from './RefinedBrowse';
 export * from './RefinedSearch';
 export * from './ReturnedFields';
 export * from './SearchParams';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimulate/copilot-sdk",
-  "version": "3.8.0",
+  "version": "3.10.0",
   "description": "A lightweight API client SDK for Cimulate Copilot",
   "files": [
     "dist/**",

package/src/copilot.ts

@@ -9,7 +9,9 @@ import type {
   CopilotBrowse,
   CopilotBrowseAck,
   ConnectError,
+  ConversationEvents,
   CopilotAPIEvent,
+  CopilotEvent,
   CopilotEventName,
   CopilotSearch,
   CopilotSearchAck,
@@ -38,6 +40,7 @@ interface CommonOptions {
 }
 
 type CimulateCopilotOptions = (ApiKeyAuth | ApiTokenAuth) & CommonOptions;
+type CopilotEvents = CopilotEvent[]
 
 const socketDefaults: SocketIOOptions = {
   path: "/api/v1/socket.io",
@@ -328,6 +331,26 @@ export default class CimulateCopilot<
     });
   }
 
+  async getConversationEvents(
+    args: ConversationEvents
+  ): Promise<CopilotEvents>;
+  async getConversationEvents(
+    args: ConversationEvents,
+    callback?: (events: CopilotEvents) => void
+  ): Promise<void>;
+  async getConversationEvents(
+    args: ConversationEvents,
+    callback?: (events: CopilotEvents) => void
+  ): Promise<CopilotEvents | void> {
+    return new Promise((resolve) => {
+      this.socket.emit("conversation_events", args, (response: CopilotEvents) => {
+        if (callback) callback(response);
+        // TODO - error handling
+        resolve(response as CopilotEvents);
+      });
+    });
+  }
+
   on<E extends CopilotEventName>(
     name: E,
     handler: (event: Extract<CopilotAPIEvent<T>, { name: E }>) => void

package/src/model/ConversationEvents.ts

@@ -0,0 +1,9 @@
+
+interface ConversationEvents {
+  conversationId: string;
+  limit?: number;
+  since?: string;
+  includeEvents?: string[];
+  excludeEvents?: string[];
+}
+export { ConversationEvents };

package/src/model/CopilotAPIEvent.ts

@@ -11,6 +11,7 @@ import { FollowUp } from "./FollowUp";
 import { Inquiry } from "./Inquiry";
 import { PartialInquiry } from "./PartialInquiry";
 import { Progress } from "./Progress";
+import { RefinedBrowse } from "./RefinedBrowse";
 import { RefinedSearch } from "./RefinedSearch";
 import { ReturnedFields } from "./ReturnedFields";
 
@@ -26,6 +27,7 @@ export type CopilotAPIEvent<
   | Inquiry
   | PartialInquiry
   | Progress
+  | RefinedBrowse<TReturnedFields>
   | RefinedSearch<TReturnedFields>;
 
 export type CopilotEventName = CopilotAPIEvent["name"];

package/src/model/CopilotEvent.ts

@@ -6,6 +6,7 @@ import { Done } from './Done';
 import { FollowUp } from './FollowUp';
 import { Inquiry } from './Inquiry';
 import { Progress } from './Progress';
+import { RefinedBrowse } from './RefinedBrowse';
 import { RefinedSearch } from './RefinedSearch';
 import { ReturnedFields } from "./ReturnedFields";
 
@@ -14,7 +15,7 @@ interface CopilotEvent<TReturnedFields extends ReturnedFields = ReturnedFields>
   sessionId: string;
   name: string;
   eventSourceId: string;
-  data: ConnectAck | FollowUp | Inquiry | DisplayProducts<TReturnedFields> | RefinedSearch<TReturnedFields> | Progress | Done | CopilotError;
+  data: ConnectAck | FollowUp | Inquiry | DisplayProducts<TReturnedFields> | RefinedBrowse<TReturnedFields> | RefinedSearch<TReturnedFields> | Progress | Done | CopilotError;
   createdAt: string;
   metadata: CommonMetadata;
 }

package/src/model/RefinedBrowse.ts

@@ -0,0 +1,17 @@
+import { BrowseParams } from './BrowseParams';
+import { Facet } from './Facet';
+import { ReturnedFields } from "./ReturnedFields";
+
+interface RefinedBrowse<TReturnedFields extends ReturnedFields = ReturnedFields> {
+  sessionId: string;
+  id: string;
+  createdAt: string;
+  eventSourceId: string;
+  message: string;
+  name: 'refined_browse';
+  browseParams: BrowseParams;
+  hits?: TReturnedFields;
+  totalHits?: number;
+  facets?: Facet[];
+}
+export { RefinedBrowse };

package/src/model/ReturnedFields.ts

@@ -2,5 +2,6 @@
  * @generic
  * @overrides DisplayProducts.products
  * @overrides RefinedSearch.hits
+ * @overrides RefinedBrowse.hits
  */
 export type ReturnedFields = Record<string, any>[];

package/src/model/index.ts

@@ -7,6 +7,7 @@ export * from './CommonRequiredFields';
 export * from './ConnectAck';
 export * from './ConnectAckMetadata';
 export * from './ConnectError';
+export * from './ConversationEvents';
 export * from './ConversationReset';
 export * from './ConversationResetAck';
 export * from './CopilotApiAck';
@@ -36,6 +37,7 @@ export * from './ProductViewAck';
 export * from './ProductViewSuggestion';
 export * from './Progress';
 export * from './ProgressToolKwargs';
+export * from './RefinedBrowse';
 export * from './RefinedSearch';
 export * from './ReturnedFields';
 export * from './SearchParams';