@ctchealth/plato-sdk 0.0.9 → 0.0.10

package/README.md

@@ -8,11 +8,12 @@ The Plato SDK provides a simple and type-safe way to integrate with the Plato pl
 
 ## Features
 
-- 🎭 Create AI personas with customizable professional profiles and personalities
-- 🗣️ Real-time voice interactions with AI assistants
-- 📊 Comprehensive event system for call management
-- 🔒 Type-safe API with full TypeScript support
-- 🎯 Medical training simulation configuration
+- Create AI personas with customizable professional profiles and personalities
+- Real-time voice interactions with AI assistants
+- Comprehensive event system for call management
+- Type-safe API with full TypeScript support
+- Medical training simulation configuration
+- Simulation persistence and recovery across page reloads
 
 ## Installation
 
@@ -64,16 +65,10 @@ const simulation = await client.createSimulation({
   },
   presentation: 'Oral tablets, 10 tablets per pack',
   scenario: 'Discussing treatment options for an elderly patient with chronic arthritis',
-  objectives: [
-    'Demonstrate efficacy of Ibuprofen in pain management',
-    'Highlight safety profile and contraindications',
-    'Encourage patient adherence',
-  ],
-  anticipatedObjections: [
-    'Concerns about gastrointestinal side effects',
-    'Preference for lower-cost generic alternatives',
-    'Potential interactions with other medications',
-  ],
+  objectives:
+    'Demonstrate efficacy of Ibuprofen in pain management Highlight safety profile and contraindications Encourage patient adherence',
+  anticipatedObjections:
+    'Concerns about gastrointestinal side effects Preference for lower-cost generic alternatives Potential interactions with other medications',
 });
 
 // Check the simulation status - If simulation creation phase is equals to FINISHED, the simulation is ready to use
@@ -161,6 +156,7 @@ Retrieves detailed information about a completed call, including transcript, sum
 - `metric1Value`, `metric2Value`, `metric3Value`: Values for each metric
 - `createdAt`: Timestamp when the call was created
 - `endedAt`: Timestamp when the call ended
+- `callDurationMs`: Duration of the call in milliseconds
 - And other call-related fields
 
 **Example:**
@@ -233,6 +229,60 @@ console.log('Current phase:', status.phase); // e.g., 'FINISHED', 'ERROR', etc.
 - **Returns:** `{ phase: CreationPhase }` — The current phase of the simulation creation process.
 - **Typical usage:** Poll this method until the phase is `FINISHED` or `ERROR` before starting a call.
 
+## Simulation Persistence
+
+Simulations are persisted server-side and can be recovered after page reloads. Store the simulation ID client-side (e.g., localStorage) for quick recovery.
+
+### getSimulationDetails(simulationId: string)
+
+Retrieves detailed information about a simulation, including its original configuration.
+
+**Returns:** `Promise<SimulationDetailsDto>` containing:
+
+- `simulationId`: MongoDB ID
+- `phase`: Current creation phase
+- `assistantId`: The assistant ID (available after creation)
+- `configuration`: Original `CreateSimulationDto`
+- `createdAt`, `updatedAt`: Timestamps
+
+**Example:**
+
+```typescript
+// Store simulation ID after creation
+const simulation = await client.createSimulation(config);
+localStorage.setItem('plato_simulation_id', simulation.simulationId);
+
+// Recover simulation on page reload
+const simulationId = localStorage.getItem('plato_simulation_id');
+if (simulationId) {
+  const details = await client.getSimulationDetails(simulationId);
+
+  if (details.phase !== CreationPhase.ERROR) {
+    // Resume polling if still in progress
+    if (details.phase !== CreationPhase.FINISHED) {
+      startPolling(details.simulationId);
+    }
+  } else {
+    localStorage.removeItem('plato_simulation_id');
+  }
+}
+```
+
+### getUserSimulations()
+
+Retrieves all simulations for the authenticated user. Useful when the simulation ID is not stored locally.
+
+**Returns:** `Promise<Array<{ simulationId: string; phase: CreationPhase }>>`
+
+**Example:**
+
+```typescript
+const simulations = await client.getUserSimulations();
+const inProgress = simulations.find(
+  sim => sim.phase !== CreationPhase.FINISHED && sim.phase !== CreationPhase.ERROR
+);
+```
+
 ## Event System
 
 The SDK provides a comprehensive event system for managing voice calls:
@@ -277,8 +327,8 @@ interface CreateSimulationDto {
   product: ProductConfig;
   presentation?: string;
   scenario: string;
-  objectives?: string[];
-  anticipatedObjections?: string[];
+  objectives?: string;
+  anticipatedObjections?: string;
   trainingConfiguration: TrainingConfigurationDto;
 }
 ```
@@ -298,6 +348,38 @@ interface CharacterCreateDto {
 }
 ```
 
+### SimulationDetailsDto
+
+Detailed simulation information returned by `getSimulationDetails()`:
+
+```typescript
+interface SimulationDetailsDto {
+  simulationId: string;
+  phase: CreationPhase;
+  assistantId: string;
+  configuration?: CreateSimulationDto;
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+### CreationPhase
+
+Enum representing the simulation creation phases:
+
+```typescript
+enum CreationPhase {
+  STARTING = 'STARTING',
+  CORE = 'CORE',
+  BOUNDARIES = 'BOUNDARIES',
+  SPEECH_AND_THOUGHT = 'SPEECH_AND_THOUGHT',
+  CONVERSATION_EVOLUTION = 'CONVERSATION_EVOLUTION',
+  MEMORY = 'MEMORY',
+  FINISHED = 'FINISHED',
+  ERROR = 'ERROR',
+}
+```
+
 ## Error Handling
 
 The SDK throws errors for invalid configurations and API failures:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctchealth/plato-sdk",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "dependencies": {
     "tslib": "^2.3.0",
     "@vapi-ai/web": "2.1.8",
@@ -11,5 +11,6 @@
   "typings": "./src/index.d.ts",
   "publishConfig": {
     "access": "public"
-  }
-}
+  },
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2025 ctcHealth. All rights reserved.
+ *
+ * This file is part of the ctcHealth Plato Platform, a proprietary software system developed by ctcHealth.
+ *
+ * This source code and all related materials are confidential and proprietary to ctcHealth.
+ * Unauthorized access, use, copying, modification, distribution, or disclosure is strictly prohibited
+ * and may result in disciplinary action and civil and/or criminal penalties.
+ *
+ * This software is intended solely for authorized use within ctcHealth and its designated partners.
+ *
+ * For internal use only.
+ */
+export * from './lib/plato-sdk';

package/src/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Copyright (c) 2025 ctcHealth. All rights reserved.
+ *
+ * This file is part of the ctcHealth Plato Platform, a proprietary software system developed by ctcHealth.
+ *
+ * This source code and all related materials are confidential and proprietary to ctcHealth.
+ * Unauthorized access, use, copying, modification, distribution, or disclosure is strictly prohibited
+ * and may result in disciplinary action and civil and/or criminal penalties.
+ *
+ * This software is intended solely for authorized use within ctcHealth and its designated partners.
+ *
+ * For internal use only.
+ */
+tslib_1.__exportStar(require("./lib/plato-sdk"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/plato-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,0DAAgC"}

package/src/lib/plato-intefaces.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Copyright (c) 2025 ctcHealth. All rights reserved.
+ *
+ * This file is part of the ctcHealth Plato Platform, a proprietary software system developed by ctcHealth.
+ *
+ * This source code and all related materials are confidential and proprietary to ctcHealth.
+ * Unauthorized access, use, copying, modification, distribution, or disclosure is strictly prohibited
+ * and may result in disciplinary action and civil and/or criminal penalties.
+ *
+ * This software is intended solely for authorized use within ctcHealth and its designated partners.
+ *
+ * For internal use only.
+ */
+export declare enum YearOfExperience {
+    '1-5' = "1-5 years",
+    '6-10' = "6-10 years",
+    '11-20' = "16-20 years",
+    '20+' = "20+ years"
+}
+export declare enum PracticeType {
+    Private = "Private Practice",
+    Hospital = "Hospital",
+    AcademicMedicalCenter = "Academic Medical Center",
+    Clinic = "Clinic"
+}
+export declare enum SegmentType {
+    Traditionalist = "The Traditionalist",
+    Innovator = "The Innovator",
+    PatientOrientedPhysician = "The Patient-Oriented Physician",
+    FinanciallyDrivenPrescriber = "The Financially-Driven Prescriber",
+    EvidencePurist = "The Evidence-Purist",
+    CostConsciousPrescriber = "The Cost-Conscious Prescriber"
+}
+export declare enum AssistantVoiceGender {
+    Male = "Male",
+    Female = "Female"
+}
+export declare class PersonalityAndBehaviourDto {
+    riskTolerance: number;
+    researchOrientation: number;
+    recognitionNeed: number;
+    brandLoyalty: number;
+    patientEmpathy: number;
+}
+export declare class ProfessionalProfileDto {
+    practiceSettings: string;
+    yearOfExperience: number;
+    specialityAndDepartment: string;
+    location: string;
+}
+export declare class ContextDto {
+    subSpecialityOrTherapyFocus: string;
+    typicalPatientMix: string;
+    keyClinicalDrivers: string;
+}
+export declare class CharacterCreateDto {
+    name: string;
+    professionalProfile: ProfessionalProfileDto;
+    segment: SegmentType;
+    personalityAndBehaviour: PersonalityAndBehaviourDto;
+    context: ContextDto;
+    assistantGender?: AssistantVoiceGender;
+}
+export declare class ProductConfig {
+    name: string;
+    description: string;
+}
+export declare class CreateSimulationDto {
+    persona: CharacterCreateDto;
+    product: ProductConfig;
+    presentation?: string;
+    scenario: string;
+    objectives?: string;
+    anticipatedObjections?: string;
+}
+export type RecordingsLimit = 5 | 10 | 25;
+export declare class SimulationRecordingsQueryDto {
+    limit?: RecordingsLimit;
+    page?: number;
+    sort?: SortOrder;
+}
+export declare enum SortOrder {
+    ASC = "asc",
+    DESC = "desc"
+}
+export declare enum RecordingStatus {
+    STARTED = "STARTED",
+    PROCESSING = "PROCESSING",
+    FINISHED = "FINISHED",
+    FAILED = "FAILED"
+}
+export declare class SimulationRecordingsDto {
+    _id: string;
+    createdAt: Date;
+    recordingStatus?: RecordingStatus;
+}
+export interface CallCreateDto {
+    /**
+     * Call ID obtained
+     */
+    callId: string;
+    /**
+     * Call Assistant ID
+     */
+    assistantId: string;
+}
+export interface CallDTO {
+    /**
+     * call ID
+     */
+    _id: string;
+    /**
+     *  call ID obtained
+     */
+    callId: string;
+    /**
+     *  call User ID
+     */
+    platoUserId: string;
+    /**
+     *  call Assistant ID
+     */
+    assistantId: string;
+    /**
+     *  call summary of the conversation
+     */
+    summary: string;
+    /**
+     *  call transcript of the conversation
+     */
+    transcript: string;
+    /**
+     *  call feedback provided by the user
+     */
+    feedback: string;
+    /**
+     * Success Evaluation returned by model
+     */
+    successEvaluation: boolean;
+    /**
+     *  call Recording URL
+     */
+    recordingUrl: string;
+    /**
+     * Status of recording processing (e.g., 'STARTED', 'PROCESSING', 'FINISHED', 'FAILED')
+     */
+    recordingStatus?: RecordingStatus;
+    /**
+     * Date and Time of the creation of the message
+     */
+    createdAt: Date;
+    /**
+     * Date and Time of the creation of the message
+     */
+    endedAt: Date;
+    /**
+     * Rating of the call given by the user
+     */
+    rating: number;
+    /**
+     * Main strenghts of the user conversation based on the analysis of the AI
+     */
+    strengths: Array<string>;
+    /**
+     * Main weak points of the user conversation based on the analysis of the AI
+     */
+    weaknesses: Array<string>;
+    /**
+     * Name of Metric for the AI feedback report
+     */
+    metric1: string;
+    /**
+     * Name of Metric for the AI feedback report
+     */
+    metric2: string;
+    /**
+     * Name of Metric for the AI feedback report
+     */
+    metric3: string;
+    /**
+     * AI feedback value for Metric 1
+     */
+    metric1Value: number;
+    /**
+     * AI feedback value for Metric 2
+     */
+    metric2Value: number;
+    /**
+     * AI feedback value for Metric 3
+     */
+    metric3Value: number;
+    /**
+     * AI feedback value for the call score
+     */
+    score?: number;
+    /**
+     * Defines if the calls will be consider for the memory feature
+     */
+    inMemory: boolean;
+    /**
+     * Duration of the call in milliseconds
+     */
+    callDurationMs?: number;
+}
+export declare enum CreationPhase {
+    STARTING = "STARTING",
+    CORE = "CORE",
+    BOUNDARIES = "BOUNDARIES",
+    SPEECH_AND_THOUGHT = "SPEECH_AND_THOUGHT",
+    CONVERSATION_EVOLUTION = "CONVERSATION_EVOLUTION",
+    MEMORY = "MEMORY",
+    FINISHED = "FINISHED",
+    ERROR = "ERROR"
+}
+/**
+ * Response DTO for PDF file upload.
+ */
+export interface UploadPdfSlidesResponseDto {
+    /**
+     * The S3 object key where the PDF was saved
+     */
+    objectKey: string;
+    /**
+     * The original filename
+     */
+    filename: string;
+    /**
+     * The file size in bytes
+     */
+    size: number;
+    /**
+     * The content type of the file
+     */
+    contentType: string;
+}
+export interface SimulationDetailsDto {
+    simulationId: string;
+    phase: CreationPhase;
+    assistantId: string;
+    configuration?: CreateSimulationDto;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/src/lib/plato-intefaces.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreationPhase = exports.SimulationRecordingsDto = exports.RecordingStatus = exports.SortOrder = exports.SimulationRecordingsQueryDto = exports.CreateSimulationDto = exports.ProductConfig = exports.CharacterCreateDto = exports.ContextDto = exports.ProfessionalProfileDto = exports.PersonalityAndBehaviourDto = exports.AssistantVoiceGender = exports.SegmentType = exports.PracticeType = exports.YearOfExperience = void 0;
+/**
+ * Copyright (c) 2025 ctcHealth. All rights reserved.
+ *
+ * This file is part of the ctcHealth Plato Platform, a proprietary software system developed by ctcHealth.
+ *
+ * This source code and all related materials are confidential and proprietary to ctcHealth.
+ * Unauthorized access, use, copying, modification, distribution, or disclosure is strictly prohibited
+ * and may result in disciplinary action and civil and/or criminal penalties.
+ *
+ * This software is intended solely for authorized use within ctcHealth and its designated partners.
+ *
+ * For internal use only.
+ */
+var YearOfExperience;
+(function (YearOfExperience) {
+    YearOfExperience["1-5"] = "1-5 years";
+    YearOfExperience["6-10"] = "6-10 years";
+    YearOfExperience["11-20"] = "16-20 years";
+    YearOfExperience["20+"] = "20+ years";
+})(YearOfExperience || (exports.YearOfExperience = YearOfExperience = {}));
+var PracticeType;
+(function (PracticeType) {
+    PracticeType["Private"] = "Private Practice";
+    PracticeType["Hospital"] = "Hospital";
+    PracticeType["AcademicMedicalCenter"] = "Academic Medical Center";
+    PracticeType["Clinic"] = "Clinic";
+})(PracticeType || (exports.PracticeType = PracticeType = {}));
+var SegmentType;
+(function (SegmentType) {
+    SegmentType["Traditionalist"] = "The Traditionalist";
+    SegmentType["Innovator"] = "The Innovator";
+    SegmentType["PatientOrientedPhysician"] = "The Patient-Oriented Physician";
+    SegmentType["FinanciallyDrivenPrescriber"] = "The Financially-Driven Prescriber";
+    SegmentType["EvidencePurist"] = "The Evidence-Purist";
+    SegmentType["CostConsciousPrescriber"] = "The Cost-Conscious Prescriber";
+})(SegmentType || (exports.SegmentType = SegmentType = {}));
+var AssistantVoiceGender;
+(function (AssistantVoiceGender) {
+    AssistantVoiceGender["Male"] = "Male";
+    AssistantVoiceGender["Female"] = "Female";
+})(AssistantVoiceGender || (exports.AssistantVoiceGender = AssistantVoiceGender = {}));
+class PersonalityAndBehaviourDto {
+    riskTolerance;
+    researchOrientation;
+    recognitionNeed;
+    brandLoyalty;
+    patientEmpathy;
+}
+exports.PersonalityAndBehaviourDto = PersonalityAndBehaviourDto;
+class ProfessionalProfileDto {
+    practiceSettings;
+    yearOfExperience;
+    specialityAndDepartment;
+    location;
+}
+exports.ProfessionalProfileDto = ProfessionalProfileDto;
+class ContextDto {
+    subSpecialityOrTherapyFocus;
+    typicalPatientMix;
+    keyClinicalDrivers;
+}
+exports.ContextDto = ContextDto;
+class CharacterCreateDto {
+    name;
+    professionalProfile;
+    segment;
+    personalityAndBehaviour;
+    context;
+    assistantGender;
+}
+exports.CharacterCreateDto = CharacterCreateDto;
+class ProductConfig {
+    name;
+    description;
+}
+exports.ProductConfig = ProductConfig;
+class CreateSimulationDto {
+    persona;
+    product;
+    presentation;
+    scenario;
+    objectives;
+    anticipatedObjections;
+}
+exports.CreateSimulationDto = CreateSimulationDto;
+class SimulationRecordingsQueryDto {
+    limit;
+    page;
+    sort;
+}
+exports.SimulationRecordingsQueryDto = SimulationRecordingsQueryDto;
+var SortOrder;
+(function (SortOrder) {
+    SortOrder["ASC"] = "asc";
+    SortOrder["DESC"] = "desc";
+})(SortOrder || (exports.SortOrder = SortOrder = {}));
+var RecordingStatus;
+(function (RecordingStatus) {
+    RecordingStatus["STARTED"] = "STARTED";
+    RecordingStatus["PROCESSING"] = "PROCESSING";
+    RecordingStatus["FINISHED"] = "FINISHED";
+    RecordingStatus["FAILED"] = "FAILED";
+})(RecordingStatus || (exports.RecordingStatus = RecordingStatus = {}));
+class SimulationRecordingsDto {
+    _id;
+    createdAt;
+    recordingStatus;
+}
+exports.SimulationRecordingsDto = SimulationRecordingsDto;
+var CreationPhase;
+(function (CreationPhase) {
+    CreationPhase["STARTING"] = "STARTING";
+    CreationPhase["CORE"] = "CORE";
+    CreationPhase["BOUNDARIES"] = "BOUNDARIES";
+    CreationPhase["SPEECH_AND_THOUGHT"] = "SPEECH_AND_THOUGHT";
+    CreationPhase["CONVERSATION_EVOLUTION"] = "CONVERSATION_EVOLUTION";
+    CreationPhase["MEMORY"] = "MEMORY";
+    CreationPhase["FINISHED"] = "FINISHED";
+    CreationPhase["ERROR"] = "ERROR";
+})(CreationPhase || (exports.CreationPhase = CreationPhase = {}));
+//# sourceMappingURL=plato-intefaces.js.map

package/src/lib/plato-intefaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plato-intefaces.js","sourceRoot":"","sources":["../../../../../libs/plato-sdk/src/lib/plato-intefaces.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qCAAmB,CAAA;IACnB,uCAAqB,CAAA;IACrB,yCAAuB,CAAA;IACvB,qCAAmB,CAAA;AACrB,CAAC,EALW,gBAAgB,gCAAhB,gBAAgB,QAK3B;AAED,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,4CAA4B,CAAA;IAC5B,qCAAqB,CAAA;IACrB,iEAAiD,CAAA;IACjD,iCAAiB,CAAA;AACnB,CAAC,EALW,YAAY,4BAAZ,YAAY,QAKvB;AACD,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,oDAAqC,CAAA;IACrC,0CAA2B,CAAA;IAC3B,0EAA2D,CAAA;IAC3D,gFAAiE,CAAA;IACjE,qDAAsC,CAAA;IACtC,wEAAyD,CAAA;AAC3D,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB;AAED,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,yCAAiB,CAAA;AACnB,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B;AAED,MAAa,0BAA0B;IACrC,aAAa,CAAU;IACvB,mBAAmB,CAAU;IAC7B,eAAe,CAAU;IACzB,YAAY,CAAU;IACtB,cAAc,CAAU;CACzB;AAND,gEAMC;AAED,MAAa,sBAAsB;IACjC,gBAAgB,CAAU;IAC1B,gBAAgB,CAAU;IAC1B,uBAAuB,CAAU;IACjC,QAAQ,CAAU;CACnB;AALD,wDAKC;AAED,MAAa,UAAU;IACrB,2BAA2B,CAAU;IACrC,iBAAiB,CAAU;IAC3B,kBAAkB,CAAU;CAC7B;AAJD,gCAIC;AAED,MAAa,kBAAkB;IAC7B,IAAI,CAAU;IACd,mBAAmB,CAA0B;IAC7C,OAAO,CAAe;IACtB,uBAAuB,CAA8B;IACrD,OAAO,CAAc;IACrB,eAAe,CAAwB;CACxC;AAPD,gDAOC;AAED,MAAa,aAAa;IACxB,IAAI,CAAU;IACd,WAAW,CAAU;CACtB;AAHD,sCAGC;AAED,MAAa,mBAAmB;IAC9B,OAAO,CAAsB;IAC7B,OAAO,CAAiB;IACxB,YAAY,CAAU;IACtB,QAAQ,CAAU;IAClB,UAAU,CAAU;IACpB,qBAAqB,CAAU;CAChC;AAPD,kDAOC;AAID,MAAa,4BAA4B;IACvC,KAAK,CAAmB;IACxB,IAAI,CAAU;IACd,IAAI,CAAa;CAClB;AAJD,oEAIC;AAED,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAED,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,4CAAyB,CAAA;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B;AAED,MAAa,uBAAuB;IAClC,GAAG,CAAU;IACb,SAAS,CAAQ;IACjB,eAAe,CAAmB;CACnC;AAJD,0DAIC;AAiHD,IAAY,aASX;AATD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,0CAAyB,CAAA;IACzB,0DAAyC,CAAA;IACzC,kEAAiD,CAAA;IACjD,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,gCAAe,CAAA;AACjB,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB"}

package/src/lib/plato-sdk.d.ts

@@ -0,0 +1,102 @@
+import { CallDTO, CreateSimulationDto, CreationPhase, SimulationRecordingsDto, SimulationRecordingsQueryDto, UploadPdfSlidesResponseDto, SimulationDetailsDto } from './plato-intefaces';
+export interface ApiClientConfig {
+    baseUrl: string;
+    token?: string;
+    user?: string;
+}
+export interface ToolCall {
+    function: {
+        name: string;
+        arguments: {
+            slideNumber?: number;
+            progressObjectiveNumber?: number;
+            [key: string]: unknown;
+        };
+    };
+    id: string;
+}
+/**
+ * Event map for call events, providing strict typing for each event's payload.
+ * There are no inputs for the events and all of them return void.
+ */
+export interface CallEventMap {
+    'call-start': undefined;
+    'call-end': undefined;
+    'speech-start': undefined;
+    'speech-end': undefined;
+    error: Error;
+    message: {
+        type: string;
+        role: string;
+        transcript?: string;
+        transcriptType: 'final' | 'partial';
+        toolCallList?: ToolCall[];
+        toolCalls?: ToolCall[];
+        [key: string]: unknown;
+    };
+    'volume-level': number;
+}
+export type CallEventNames = keyof CallEventMap;
+export type CallEventListener<K extends CallEventNames> = (payload: CallEventMap[K]) => void;
+export declare class PlatoApiClient {
+    private config;
+    private http;
+    private eventListeners;
+    private callControllerInstance?;
+    private eventsAttached;
+    eventNames: CallEventNames[];
+    constructor(config: ApiClientConfig);
+    /**
+     * Register a listener for a call event with strict typing.
+     * @param event Event name
+     * @param listener Listener function
+     */
+    private on;
+    /**
+     * Remove a listener for a call event with strict typing.
+     * @param event Event name
+     * @param listener Listener function
+     */
+    private off;
+    /**
+     * Internal: Attach event listeners and propagate to registered listeners.
+     */
+    private attachEvents;
+    createSimulation(createSimulationParams: CreateSimulationDto): Promise<{
+        simulationId: string;
+        phase: CreationPhase;
+    }>;
+    checkSimulationStatus(simulationId: string): Promise<{
+        phase: CreationPhase;
+    }>;
+    getUserSimulations(): Promise<Array<{
+        simulationId: string;
+        phase: CreationPhase;
+    }>>;
+    getSimulationDetails(simulationId: string): Promise<SimulationDetailsDto>;
+    getCallDetails(callId: string): Promise<CallDTO>;
+    getCallRecordings(queryParams: SimulationRecordingsQueryDto): Promise<SimulationRecordingsDto[]>;
+    getCallRecording(callId: string): Promise<string>;
+    /**
+     * Remove all listeners for all call events.
+     */
+    private removeAllEventListeners;
+    startCall(simulationId: string): Promise<{
+        stopCall: () => void;
+        callId: string;
+        /**
+         * Subscribe to call events for this call with strict typing.
+         * @param event Event name
+         * @param listener Listener function
+         */
+        on: <K extends CallEventNames>(event: K, listener: CallEventListener<K>) => void;
+        /**
+         * Unsubscribe from call events for this call with strict typing.
+         * @param event Event name
+         * @param listener Listener function
+         */
+        off: <K extends CallEventNames>(event: K, listener: CallEventListener<K>) => void;
+    }>;
+    private createCall;
+    uploadPdfSlides(file: File | Blob): Promise<UploadPdfSlidesResponseDto>;
+}