@healthcloudai/hc-ams 0.0.1 → 3.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +204 -7
- package/dist/index.cjs +719 -3
- package/dist/index.d.cts +927 -2
- package/dist/index.d.ts +927 -2
- package/dist/index.js +705 -2
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -20,14 +20,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
20
20
|
// src/index.ts
|
|
21
21
|
var index_exports = {};
|
|
22
22
|
__export(index_exports, {
|
|
23
|
+
AgentsClient: () => AgentsClient,
|
|
23
24
|
AmsClient: () => AmsClient,
|
|
25
|
+
AuthClient: () => AuthClient,
|
|
24
26
|
DEFAULT_TIMEOUT_MS: () => DEFAULT_TIMEOUT_MS,
|
|
27
|
+
DataSourcesClient: () => DataSourcesClient,
|
|
28
|
+
DepartmentsClient: () => DepartmentsClient,
|
|
29
|
+
GuardrailsClient: () => GuardrailsClient,
|
|
25
30
|
HCAmsSDK: () => HCAmsSDK,
|
|
31
|
+
PoliciesClient: () => PoliciesClient,
|
|
26
32
|
SDKError: () => SDKError,
|
|
27
33
|
SERVICE_NAME: () => SERVICE_NAME,
|
|
34
|
+
SkillsClient: () => SkillsClient,
|
|
35
|
+
TeamsClient: () => TeamsClient,
|
|
36
|
+
TestPersonasClient: () => TestPersonasClient,
|
|
37
|
+
ToolsClient: () => ToolsClient,
|
|
38
|
+
WssClient: () => WssClient,
|
|
28
39
|
assertEnvironment: () => assertEnvironment,
|
|
29
40
|
assertTimeout: () => assertTimeout,
|
|
30
|
-
|
|
41
|
+
resolveAmsAuthBaseUrl: () => resolveAmsAuthBaseUrl,
|
|
42
|
+
resolveBaseUrl: () => resolveBaseUrl,
|
|
43
|
+
resolveWssBaseUrl: () => resolveWssBaseUrl
|
|
31
44
|
});
|
|
32
45
|
module.exports = __toCommonJS(index_exports);
|
|
33
46
|
|
|
@@ -38,6 +51,14 @@ function resolveBaseUrl(environment) {
|
|
|
38
51
|
const prefix = environment === "prod" ? "" : `${environment}-`;
|
|
39
52
|
return `https://${prefix}amsservices.health.cloud/api/ams`;
|
|
40
53
|
}
|
|
54
|
+
function resolveAmsAuthBaseUrl(environment) {
|
|
55
|
+
const prefix = environment === "prod" ? "" : `${environment}-`;
|
|
56
|
+
return `https://${prefix}amsservices.health.cloud/api/auth`;
|
|
57
|
+
}
|
|
58
|
+
function resolveWssBaseUrl(environment) {
|
|
59
|
+
const prefix = environment === "prod" ? "" : `${environment}-`;
|
|
60
|
+
return `wss://${prefix}amsservices.health.cloud`;
|
|
61
|
+
}
|
|
41
62
|
function assertEnvironment(environment) {
|
|
42
63
|
if (environment !== "dev" && environment !== "uat" && environment !== "prod") {
|
|
43
64
|
throw new Error(`Unsupported HealthCloud environment: "${environment}"`);
|
|
@@ -269,10 +290,639 @@ var AmsClient = class extends BaseServiceClient {
|
|
|
269
290
|
}
|
|
270
291
|
};
|
|
271
292
|
|
|
293
|
+
// src/clients/AgentsClient.ts
|
|
294
|
+
var AgentsClient = class extends BaseServiceClient {
|
|
295
|
+
constructor(http) {
|
|
296
|
+
super(http);
|
|
297
|
+
}
|
|
298
|
+
/** GET /agents */
|
|
299
|
+
list() {
|
|
300
|
+
return this.send("GET", "/agents");
|
|
301
|
+
}
|
|
302
|
+
/** GET /agents/{agent_id} */
|
|
303
|
+
get(agentId) {
|
|
304
|
+
return this.send("GET", "/agents/{agent_id}", {
|
|
305
|
+
pathParams: { agent_id: agentId }
|
|
306
|
+
});
|
|
307
|
+
}
|
|
308
|
+
/** POST /agents */
|
|
309
|
+
create(request) {
|
|
310
|
+
return this.send("POST", "/agents", { body: request });
|
|
311
|
+
}
|
|
312
|
+
/** PUT /agents/{agent_id} */
|
|
313
|
+
update(agentId, request) {
|
|
314
|
+
return this.send("PUT", "/agents/{agent_id}", {
|
|
315
|
+
pathParams: { agent_id: agentId },
|
|
316
|
+
body: request
|
|
317
|
+
});
|
|
318
|
+
}
|
|
319
|
+
/** DELETE /agents/{agent_id} */
|
|
320
|
+
delete(agentId) {
|
|
321
|
+
return this.send("DELETE", "/agents/{agent_id}", {
|
|
322
|
+
pathParams: { agent_id: agentId }
|
|
323
|
+
});
|
|
324
|
+
}
|
|
325
|
+
/** GET /agents/candidates — non-orchestrator agents eligible as transfer targets. */
|
|
326
|
+
listTransferCandidates() {
|
|
327
|
+
return this.send("GET", "/agents/candidates");
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* GET /agents/{agent_id}/conversation?session_id={tenant_id}/{patient_id}
|
|
331
|
+
*
|
|
332
|
+
* `sessionId` must be the literal `"{tenant_id}/{patient_id}"` string used
|
|
333
|
+
* to key the WSS session (see {@link "../wss/WssClient".WssClient}).
|
|
334
|
+
*/
|
|
335
|
+
getConversation(agentId, sessionId) {
|
|
336
|
+
return this.send("GET", "/agents/{agent_id}/conversation", {
|
|
337
|
+
pathParams: { agent_id: agentId },
|
|
338
|
+
query: { session_id: sessionId }
|
|
339
|
+
});
|
|
340
|
+
}
|
|
341
|
+
/**
|
|
342
|
+
* DELETE /agents/{agent_id}/conversation?session_id={tenant_id}/{patient_id}
|
|
343
|
+
*
|
|
344
|
+
* Deletes both the persisted chat history and any live WSS session state
|
|
345
|
+
* for that session.
|
|
346
|
+
*/
|
|
347
|
+
deleteConversation(agentId, sessionId) {
|
|
348
|
+
return this.send("DELETE", "/agents/{agent_id}/conversation", {
|
|
349
|
+
pathParams: { agent_id: agentId },
|
|
350
|
+
query: { session_id: sessionId }
|
|
351
|
+
});
|
|
352
|
+
}
|
|
353
|
+
};
|
|
354
|
+
|
|
355
|
+
// src/clients/DepartmentsClient.ts
|
|
356
|
+
var DepartmentsClient = class extends BaseServiceClient {
|
|
357
|
+
constructor(http) {
|
|
358
|
+
super(http);
|
|
359
|
+
}
|
|
360
|
+
/** GET /departments */
|
|
361
|
+
list() {
|
|
362
|
+
return this.send("GET", "/departments");
|
|
363
|
+
}
|
|
364
|
+
/** GET /departments/{department_id} */
|
|
365
|
+
get(departmentId) {
|
|
366
|
+
return this.send("GET", "/departments/{department_id}", {
|
|
367
|
+
pathParams: { department_id: departmentId }
|
|
368
|
+
});
|
|
369
|
+
}
|
|
370
|
+
/** POST /departments */
|
|
371
|
+
create(request) {
|
|
372
|
+
return this.send("POST", "/departments", { body: request });
|
|
373
|
+
}
|
|
374
|
+
/** PUT /departments/{department_id} */
|
|
375
|
+
update(departmentId, request) {
|
|
376
|
+
return this.send("PUT", "/departments/{department_id}", {
|
|
377
|
+
pathParams: { department_id: departmentId },
|
|
378
|
+
body: request
|
|
379
|
+
});
|
|
380
|
+
}
|
|
381
|
+
/** DELETE /departments/{department_id} */
|
|
382
|
+
delete(departmentId) {
|
|
383
|
+
return this.send("DELETE", "/departments/{department_id}", {
|
|
384
|
+
pathParams: { department_id: departmentId }
|
|
385
|
+
});
|
|
386
|
+
}
|
|
387
|
+
/** POST /departments/{department_id}/activate */
|
|
388
|
+
activate(departmentId) {
|
|
389
|
+
return this.send("POST", "/departments/{department_id}/activate", {
|
|
390
|
+
pathParams: { department_id: departmentId }
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
/** POST /departments/{department_id}/deactivate */
|
|
394
|
+
deactivate(departmentId) {
|
|
395
|
+
return this.send("POST", "/departments/{department_id}/deactivate", {
|
|
396
|
+
pathParams: { department_id: departmentId }
|
|
397
|
+
});
|
|
398
|
+
}
|
|
399
|
+
};
|
|
400
|
+
|
|
401
|
+
// src/clients/TeamsClient.ts
|
|
402
|
+
var TeamsClient = class extends BaseServiceClient {
|
|
403
|
+
constructor(http) {
|
|
404
|
+
super(http);
|
|
405
|
+
}
|
|
406
|
+
/** GET /teams */
|
|
407
|
+
list() {
|
|
408
|
+
return this.send("GET", "/teams");
|
|
409
|
+
}
|
|
410
|
+
/** GET /teams/{team_id} */
|
|
411
|
+
get(teamId) {
|
|
412
|
+
return this.send("GET", "/teams/{team_id}", {
|
|
413
|
+
pathParams: { team_id: teamId }
|
|
414
|
+
});
|
|
415
|
+
}
|
|
416
|
+
/** POST /teams */
|
|
417
|
+
create(request) {
|
|
418
|
+
return this.send("POST", "/teams", { body: request });
|
|
419
|
+
}
|
|
420
|
+
/** PUT /teams/{team_id} */
|
|
421
|
+
update(teamId, request) {
|
|
422
|
+
return this.send("PUT", "/teams/{team_id}", {
|
|
423
|
+
pathParams: { team_id: teamId },
|
|
424
|
+
body: request
|
|
425
|
+
});
|
|
426
|
+
}
|
|
427
|
+
/** DELETE /teams/{team_id} */
|
|
428
|
+
delete(teamId) {
|
|
429
|
+
return this.send("DELETE", "/teams/{team_id}", {
|
|
430
|
+
pathParams: { team_id: teamId }
|
|
431
|
+
});
|
|
432
|
+
}
|
|
433
|
+
};
|
|
434
|
+
|
|
435
|
+
// src/clients/SkillsClient.ts
|
|
436
|
+
var SkillsClient = class extends BaseServiceClient {
|
|
437
|
+
constructor(http) {
|
|
438
|
+
super(http);
|
|
439
|
+
}
|
|
440
|
+
/** GET /skills */
|
|
441
|
+
list() {
|
|
442
|
+
return this.send("GET", "/skills");
|
|
443
|
+
}
|
|
444
|
+
/** GET /skills/{skill_id} */
|
|
445
|
+
get(skillId) {
|
|
446
|
+
return this.send("GET", "/skills/{skill_id}", {
|
|
447
|
+
pathParams: { skill_id: skillId }
|
|
448
|
+
});
|
|
449
|
+
}
|
|
450
|
+
/** POST /skills */
|
|
451
|
+
create(request) {
|
|
452
|
+
return this.send("POST", "/skills", { body: request });
|
|
453
|
+
}
|
|
454
|
+
/** PUT /skills/{skill_id} */
|
|
455
|
+
update(skillId, request) {
|
|
456
|
+
return this.send("PUT", "/skills/{skill_id}", {
|
|
457
|
+
pathParams: { skill_id: skillId },
|
|
458
|
+
body: request
|
|
459
|
+
});
|
|
460
|
+
}
|
|
461
|
+
/** DELETE /skills/{skill_id} */
|
|
462
|
+
delete(skillId) {
|
|
463
|
+
return this.send("DELETE", "/skills/{skill_id}", {
|
|
464
|
+
pathParams: { skill_id: skillId }
|
|
465
|
+
});
|
|
466
|
+
}
|
|
467
|
+
};
|
|
468
|
+
|
|
469
|
+
// src/clients/PoliciesClient.ts
|
|
470
|
+
var PoliciesClient = class extends BaseServiceClient {
|
|
471
|
+
constructor(http) {
|
|
472
|
+
super(http);
|
|
473
|
+
}
|
|
474
|
+
/** GET /policies */
|
|
475
|
+
list() {
|
|
476
|
+
return this.send("GET", "/policies");
|
|
477
|
+
}
|
|
478
|
+
/** GET /policies/{policy_id} */
|
|
479
|
+
get(policyId) {
|
|
480
|
+
return this.send("GET", "/policies/{policy_id}", {
|
|
481
|
+
pathParams: { policy_id: policyId }
|
|
482
|
+
});
|
|
483
|
+
}
|
|
484
|
+
/** POST /policies */
|
|
485
|
+
create(request) {
|
|
486
|
+
return this.send("POST", "/policies", { body: request });
|
|
487
|
+
}
|
|
488
|
+
/** PUT /policies/{policy_id} */
|
|
489
|
+
update(policyId, request) {
|
|
490
|
+
return this.send("PUT", "/policies/{policy_id}", {
|
|
491
|
+
pathParams: { policy_id: policyId },
|
|
492
|
+
body: request
|
|
493
|
+
});
|
|
494
|
+
}
|
|
495
|
+
/** DELETE /policies/{policy_id} */
|
|
496
|
+
delete(policyId) {
|
|
497
|
+
return this.send("DELETE", "/policies/{policy_id}", {
|
|
498
|
+
pathParams: { policy_id: policyId }
|
|
499
|
+
});
|
|
500
|
+
}
|
|
501
|
+
};
|
|
502
|
+
|
|
503
|
+
// src/clients/GuardrailsClient.ts
|
|
504
|
+
var GuardrailsClient = class extends BaseServiceClient {
|
|
505
|
+
constructor(http) {
|
|
506
|
+
super(http);
|
|
507
|
+
}
|
|
508
|
+
/** GET /guardrails */
|
|
509
|
+
list() {
|
|
510
|
+
return this.send("GET", "/guardrails");
|
|
511
|
+
}
|
|
512
|
+
/** GET /guardrails/{guardrail_id} */
|
|
513
|
+
get(guardrailId) {
|
|
514
|
+
return this.send("GET", "/guardrails/{guardrail_id}", {
|
|
515
|
+
pathParams: { guardrail_id: guardrailId }
|
|
516
|
+
});
|
|
517
|
+
}
|
|
518
|
+
/** POST /guardrails */
|
|
519
|
+
create(request) {
|
|
520
|
+
return this.send("POST", "/guardrails", { body: request });
|
|
521
|
+
}
|
|
522
|
+
/** PUT /guardrails/{guardrail_id} */
|
|
523
|
+
update(guardrailId, request) {
|
|
524
|
+
return this.send("PUT", "/guardrails/{guardrail_id}", {
|
|
525
|
+
pathParams: { guardrail_id: guardrailId },
|
|
526
|
+
body: request
|
|
527
|
+
});
|
|
528
|
+
}
|
|
529
|
+
/** DELETE /guardrails/{guardrail_id} */
|
|
530
|
+
delete(guardrailId) {
|
|
531
|
+
return this.send("DELETE", "/guardrails/{guardrail_id}", {
|
|
532
|
+
pathParams: { guardrail_id: guardrailId }
|
|
533
|
+
});
|
|
534
|
+
}
|
|
535
|
+
};
|
|
536
|
+
|
|
537
|
+
// src/clients/DataSourcesClient.ts
|
|
538
|
+
var DataSourcesClient = class extends BaseServiceClient {
|
|
539
|
+
constructor(http) {
|
|
540
|
+
super(http);
|
|
541
|
+
}
|
|
542
|
+
/** GET /data-sources */
|
|
543
|
+
list() {
|
|
544
|
+
return this.send("GET", "/data-sources");
|
|
545
|
+
}
|
|
546
|
+
/** GET /data-sources/{data_source_id} */
|
|
547
|
+
get(dataSourceId) {
|
|
548
|
+
return this.send("GET", "/data-sources/{data_source_id}", {
|
|
549
|
+
pathParams: { data_source_id: dataSourceId }
|
|
550
|
+
});
|
|
551
|
+
}
|
|
552
|
+
};
|
|
553
|
+
|
|
554
|
+
// src/clients/ToolsClient.ts
|
|
555
|
+
var ToolsClient = class extends BaseServiceClient {
|
|
556
|
+
constructor(http) {
|
|
557
|
+
super(http);
|
|
558
|
+
}
|
|
559
|
+
/** GET /tools */
|
|
560
|
+
list() {
|
|
561
|
+
return this.send("GET", "/tools");
|
|
562
|
+
}
|
|
563
|
+
/** GET /tools/{tool_id} */
|
|
564
|
+
get(toolId) {
|
|
565
|
+
return this.send("GET", "/tools/{tool_id}", {
|
|
566
|
+
pathParams: { tool_id: toolId }
|
|
567
|
+
});
|
|
568
|
+
}
|
|
569
|
+
};
|
|
570
|
+
|
|
571
|
+
// src/clients/TestPersonasClient.ts
|
|
572
|
+
var TestPersonasClient = class extends BaseServiceClient {
|
|
573
|
+
constructor(http) {
|
|
574
|
+
super(http);
|
|
575
|
+
}
|
|
576
|
+
/** GET /test-patient-credentials */
|
|
577
|
+
list() {
|
|
578
|
+
return this.send("GET", "/test-patient-credentials");
|
|
579
|
+
}
|
|
580
|
+
/** GET /test-patient-credentials/{credential_id} */
|
|
581
|
+
get(credentialId) {
|
|
582
|
+
return this.send("GET", "/test-patient-credentials/{credential_id}", {
|
|
583
|
+
pathParams: { credential_id: credentialId }
|
|
584
|
+
});
|
|
585
|
+
}
|
|
586
|
+
/** POST /test-patient-credentials */
|
|
587
|
+
create(request) {
|
|
588
|
+
return this.send("POST", "/test-patient-credentials", { body: request });
|
|
589
|
+
}
|
|
590
|
+
/** PUT /test-patient-credentials/{credential_id} */
|
|
591
|
+
update(credentialId, request) {
|
|
592
|
+
return this.send("PUT", "/test-patient-credentials/{credential_id}", {
|
|
593
|
+
pathParams: { credential_id: credentialId },
|
|
594
|
+
body: request
|
|
595
|
+
});
|
|
596
|
+
}
|
|
597
|
+
/** DELETE /test-patient-credentials/{credential_id} */
|
|
598
|
+
delete(credentialId) {
|
|
599
|
+
return this.send("DELETE", "/test-patient-credentials/{credential_id}", {
|
|
600
|
+
pathParams: { credential_id: credentialId }
|
|
601
|
+
});
|
|
602
|
+
}
|
|
603
|
+
/**
|
|
604
|
+
* POST /test-patient-credentials/{credential_id}/login
|
|
605
|
+
*
|
|
606
|
+
* Logs this persona into Health Cloud and returns a real patient access
|
|
607
|
+
* token — feed `access_token`/`patient_id` into
|
|
608
|
+
* {@link "../wss/WssClient".WssClient} to open a chat session as this persona.
|
|
609
|
+
*/
|
|
610
|
+
login(credentialId) {
|
|
611
|
+
return this.send("POST", "/test-patient-credentials/{credential_id}/login", {
|
|
612
|
+
pathParams: { credential_id: credentialId }
|
|
613
|
+
});
|
|
614
|
+
}
|
|
615
|
+
};
|
|
616
|
+
|
|
617
|
+
// src/clients/AuthClient.ts
|
|
618
|
+
var AuthClient = class extends BaseServiceClient {
|
|
619
|
+
constructor(http) {
|
|
620
|
+
super(http);
|
|
621
|
+
}
|
|
622
|
+
/** POST /api/auth/login (public) */
|
|
623
|
+
login(request) {
|
|
624
|
+
return this.send("POST", "/login", { body: request, auth: false });
|
|
625
|
+
}
|
|
626
|
+
/** POST /api/auth/reset-password (public) */
|
|
627
|
+
resetPassword(request) {
|
|
628
|
+
return this.send("POST", "/reset-password", { body: request, auth: false });
|
|
629
|
+
}
|
|
630
|
+
/** POST /api/auth/confirm-reset-password (public) */
|
|
631
|
+
confirmResetPassword(request) {
|
|
632
|
+
return this.send("POST", "/confirm-reset-password", { body: request, auth: false });
|
|
633
|
+
}
|
|
634
|
+
/** POST /api/auth/register (public) */
|
|
635
|
+
register(request) {
|
|
636
|
+
return this.send("POST", "/register", { body: request, auth: false });
|
|
637
|
+
}
|
|
638
|
+
/** GET /api/auth/me (Bearer required) */
|
|
639
|
+
me() {
|
|
640
|
+
return this.send("GET", "/me");
|
|
641
|
+
}
|
|
642
|
+
};
|
|
643
|
+
|
|
644
|
+
// src/wss/WssClient.ts
|
|
645
|
+
var WssClient = class {
|
|
646
|
+
constructor(options) {
|
|
647
|
+
this.options = options;
|
|
648
|
+
this.authenticated = false;
|
|
649
|
+
// Storage is necessarily untyped across the heterogeneous event map; `on`/`dispatch` restore type safety at the boundary.
|
|
650
|
+
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
651
|
+
this.listeners = /* @__PURE__ */ new Map();
|
|
652
|
+
var _a, _b, _c, _d;
|
|
653
|
+
if (options.healthcloudToken === void 0 && options.getAccessToken === void 0) {
|
|
654
|
+
throw new SDKError({
|
|
655
|
+
message: "WssClient requires either `healthcloudToken` or `getAccessToken`.",
|
|
656
|
+
statusCode: 0
|
|
657
|
+
});
|
|
658
|
+
}
|
|
659
|
+
const base = (_a = options.baseUrlOverride) != null ? _a : resolveWssBaseUrl(options.environment);
|
|
660
|
+
const sessionId = `${options.tenantId}/${options.patientId}`;
|
|
661
|
+
const path = options.agentId ? `/ws/agents/${encodeURIComponent(options.agentId)}/chat` : "/ws";
|
|
662
|
+
const url = new URL(`${base}${path}`);
|
|
663
|
+
url.searchParams.set("session_id", sessionId);
|
|
664
|
+
if (options.lang) url.searchParams.set("lang", options.lang);
|
|
665
|
+
if (options.voice) url.searchParams.set("voice", "1");
|
|
666
|
+
if (options.voiceId) url.searchParams.set("voice_id", options.voiceId);
|
|
667
|
+
if (options.audioFormat) url.searchParams.set("audio_format", options.audioFormat);
|
|
668
|
+
if (options.replaySince !== void 0) url.searchParams.set("replay_since", String(options.replaySince));
|
|
669
|
+
if (options.handoff && options.handoff.length > 0) {
|
|
670
|
+
url.searchParams.set("handoff", JSON.stringify(options.handoff));
|
|
671
|
+
}
|
|
672
|
+
this.url = url.toString();
|
|
673
|
+
this.turnTimeoutMs = (_b = options.turnTimeoutMs) != null ? _b : 6e4;
|
|
674
|
+
this.authTimeoutMs = (_c = options.authTimeoutMs) != null ? _c : 1e4;
|
|
675
|
+
const ctor = (_d = options.WebSocketImpl) != null ? _d : globalThis.WebSocket;
|
|
676
|
+
if (!ctor) {
|
|
677
|
+
throw new SDKError({
|
|
678
|
+
message: 'No WebSocket implementation available. Pass `WebSocketImpl` (e.g. `new WssClient({ ..., WebSocketImpl: require("ws") })`) on runtimes without a global WebSocket (Node < 21).',
|
|
679
|
+
statusCode: 0
|
|
680
|
+
});
|
|
681
|
+
}
|
|
682
|
+
this.WebSocketCtor = ctor;
|
|
683
|
+
}
|
|
684
|
+
async resolveToken() {
|
|
685
|
+
var _a;
|
|
686
|
+
if (this.options.getAccessToken) {
|
|
687
|
+
return this.options.getAccessToken();
|
|
688
|
+
}
|
|
689
|
+
return (_a = this.options.healthcloudToken) != null ? _a : "";
|
|
690
|
+
}
|
|
691
|
+
/**
|
|
692
|
+
* Opens the socket and runs the auth handshake: sends
|
|
693
|
+
* `{"type":"auth","token":...}` as soon as the socket opens, and resolves
|
|
694
|
+
* only once the server replies `{"type":"auth_ok"}`. Rejects on a
|
|
695
|
+
* connect/auth error, an auth timeout, or a rejection frame — in every
|
|
696
|
+
* case before any chat frame can be sent (see {@link send}).
|
|
697
|
+
*/
|
|
698
|
+
connect() {
|
|
699
|
+
return new Promise((resolve, reject) => {
|
|
700
|
+
this.authenticated = false;
|
|
701
|
+
const socket = new this.WebSocketCtor(this.url);
|
|
702
|
+
this.socket = socket;
|
|
703
|
+
let authTimer;
|
|
704
|
+
const settle = (fn) => {
|
|
705
|
+
cleanup();
|
|
706
|
+
fn();
|
|
707
|
+
};
|
|
708
|
+
const onOpen = () => {
|
|
709
|
+
authTimer = setTimeout(() => {
|
|
710
|
+
settle(
|
|
711
|
+
() => reject(new SDKError({ message: `Authentication timed out after ${this.authTimeoutMs}ms.`, statusCode: 0 }))
|
|
712
|
+
);
|
|
713
|
+
socket.close();
|
|
714
|
+
}, this.authTimeoutMs);
|
|
715
|
+
this.resolveToken().then((token) => socket.send(JSON.stringify({ type: "auth", token }))).catch((error) => {
|
|
716
|
+
clearTimeout(authTimer);
|
|
717
|
+
settle(
|
|
718
|
+
() => reject(
|
|
719
|
+
new SDKError({
|
|
720
|
+
message: "Failed to resolve the Health Cloud access token for the auth frame.",
|
|
721
|
+
statusCode: 0,
|
|
722
|
+
cause: error
|
|
723
|
+
})
|
|
724
|
+
)
|
|
725
|
+
);
|
|
726
|
+
socket.close();
|
|
727
|
+
});
|
|
728
|
+
};
|
|
729
|
+
const onError = (event) => {
|
|
730
|
+
clearTimeout(authTimer);
|
|
731
|
+
settle(() => reject(new SDKError({ message: "WebSocket connection failed.", statusCode: 0, cause: event })));
|
|
732
|
+
};
|
|
733
|
+
const onClose = (event) => {
|
|
734
|
+
clearTimeout(authTimer);
|
|
735
|
+
if (this.authenticated) return;
|
|
736
|
+
settle(
|
|
737
|
+
() => {
|
|
738
|
+
var _a, _b;
|
|
739
|
+
return reject(
|
|
740
|
+
new SDKError({
|
|
741
|
+
message: `WebSocket closed before authenticating (code ${(_a = event.code) != null ? _a : "unknown"}): ${(_b = event.reason) != null ? _b : ""}`.trim(),
|
|
742
|
+
statusCode: 0
|
|
743
|
+
})
|
|
744
|
+
);
|
|
745
|
+
}
|
|
746
|
+
);
|
|
747
|
+
};
|
|
748
|
+
const onMessage = (event) => {
|
|
749
|
+
var _a, _b;
|
|
750
|
+
if (!this.authenticated) {
|
|
751
|
+
let frame;
|
|
752
|
+
try {
|
|
753
|
+
frame = JSON.parse(String((_a = event.data) != null ? _a : ""));
|
|
754
|
+
} catch {
|
|
755
|
+
return;
|
|
756
|
+
}
|
|
757
|
+
if ((frame == null ? void 0 : frame.type) === "auth_ok") {
|
|
758
|
+
clearTimeout(authTimer);
|
|
759
|
+
this.authenticated = true;
|
|
760
|
+
settle(() => resolve());
|
|
761
|
+
return;
|
|
762
|
+
}
|
|
763
|
+
if ((frame == null ? void 0 : frame.type) === "error") {
|
|
764
|
+
clearTimeout(authTimer);
|
|
765
|
+
settle(
|
|
766
|
+
() => {
|
|
767
|
+
var _a2, _b2;
|
|
768
|
+
return reject(
|
|
769
|
+
new SDKError({
|
|
770
|
+
message: `WebSocket authentication was rejected: ${(_b2 = (_a2 = frame == null ? void 0 : frame.payload) == null ? void 0 : _a2.message) != null ? _b2 : "unknown error"}`,
|
|
771
|
+
statusCode: 401
|
|
772
|
+
})
|
|
773
|
+
);
|
|
774
|
+
}
|
|
775
|
+
);
|
|
776
|
+
return;
|
|
777
|
+
}
|
|
778
|
+
return;
|
|
779
|
+
}
|
|
780
|
+
this.dispatch((_b = event.data) != null ? _b : "");
|
|
781
|
+
};
|
|
782
|
+
const cleanup = () => {
|
|
783
|
+
socket.removeEventListener("open", onOpen);
|
|
784
|
+
socket.removeEventListener("error", onError);
|
|
785
|
+
socket.removeEventListener("close", onClose);
|
|
786
|
+
};
|
|
787
|
+
socket.addEventListener("open", onOpen);
|
|
788
|
+
socket.addEventListener("error", onError);
|
|
789
|
+
socket.addEventListener("close", onClose);
|
|
790
|
+
socket.addEventListener("message", onMessage);
|
|
791
|
+
});
|
|
792
|
+
}
|
|
793
|
+
/** Subscribes to a typed server event. Returns an unsubscribe function. */
|
|
794
|
+
on(type, handler) {
|
|
795
|
+
let set = this.listeners.get(type);
|
|
796
|
+
if (!set) {
|
|
797
|
+
set = /* @__PURE__ */ new Set();
|
|
798
|
+
this.listeners.set(type, set);
|
|
799
|
+
}
|
|
800
|
+
set.add(handler);
|
|
801
|
+
return () => set.delete(handler);
|
|
802
|
+
}
|
|
803
|
+
/** Sends a raw outgoing frame: `{"type": type, "payload": payload}`. */
|
|
804
|
+
send(type, payload = {}) {
|
|
805
|
+
if (!this.socket) {
|
|
806
|
+
throw new SDKError({ message: "WssClient is not connected. Call connect() first.", statusCode: 0 });
|
|
807
|
+
}
|
|
808
|
+
if (!this.authenticated) {
|
|
809
|
+
throw new SDKError({
|
|
810
|
+
message: "WssClient has not finished authenticating yet. Await connect() before sending frames.",
|
|
811
|
+
statusCode: 0
|
|
812
|
+
});
|
|
813
|
+
}
|
|
814
|
+
this.socket.send(JSON.stringify({ type, payload }));
|
|
815
|
+
}
|
|
816
|
+
sendChat(payload) {
|
|
817
|
+
this.send("chat", payload);
|
|
818
|
+
}
|
|
819
|
+
sendVoice(active) {
|
|
820
|
+
this.send("voice", { active });
|
|
821
|
+
}
|
|
822
|
+
sendAudioInput(payload) {
|
|
823
|
+
this.send("audio_input", payload);
|
|
824
|
+
}
|
|
825
|
+
sendToolConfirmation(payload) {
|
|
826
|
+
this.send("tool_confirmation", payload);
|
|
827
|
+
}
|
|
828
|
+
sendHandoff(messages) {
|
|
829
|
+
this.send("handoff", { messages });
|
|
830
|
+
}
|
|
831
|
+
/**
|
|
832
|
+
* Sends a `chat` frame and resolves once that turn completes, buffering
|
|
833
|
+
* every streamed `chat` delta into the final `message` and collecting
|
|
834
|
+
* `activity`/`transfer`/`artifact_block`/`notification`/`response_suggestions`
|
|
835
|
+
* events emitted during the turn.
|
|
836
|
+
*
|
|
837
|
+
* Resolves with `status: "failed"`/`"cancelled"` (rather than rejecting)
|
|
838
|
+
* on `turn_failed`/`turn_cancelled`, so callers can inspect whatever
|
|
839
|
+
* partial `message`/side-effects were collected before the turn ended.
|
|
840
|
+
* Rejects only if no terminal event arrives within `timeoutMs`.
|
|
841
|
+
*/
|
|
842
|
+
sendAndAwaitTurn(content, opts = {}) {
|
|
843
|
+
const { timeoutMs = this.turnTimeoutMs, ...chatOpts } = opts;
|
|
844
|
+
return new Promise((resolve, reject) => {
|
|
845
|
+
let message = "";
|
|
846
|
+
const activity = [];
|
|
847
|
+
const transfers = [];
|
|
848
|
+
const artifacts = [];
|
|
849
|
+
const notifications = [];
|
|
850
|
+
let suggestions;
|
|
851
|
+
let turnId;
|
|
852
|
+
const unsubscribers = [];
|
|
853
|
+
const cleanup = () => {
|
|
854
|
+
clearTimeout(timer);
|
|
855
|
+
unsubscribers.forEach((unsub) => unsub());
|
|
856
|
+
};
|
|
857
|
+
const timer = setTimeout(() => {
|
|
858
|
+
cleanup();
|
|
859
|
+
reject(new SDKError({ message: `Turn timed out after ${timeoutMs}ms.`, statusCode: 0 }));
|
|
860
|
+
}, timeoutMs);
|
|
861
|
+
unsubscribers.push(
|
|
862
|
+
this.on("chat", (event) => {
|
|
863
|
+
var _a;
|
|
864
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
865
|
+
if (event.replace) {
|
|
866
|
+
message = event.content;
|
|
867
|
+
} else {
|
|
868
|
+
message += event.content;
|
|
869
|
+
}
|
|
870
|
+
}),
|
|
871
|
+
this.on("activity", (event) => activity.push(event)),
|
|
872
|
+
this.on("transfer", (event) => transfers.push(event)),
|
|
873
|
+
this.on("artifact_block", (event) => artifacts.push(event)),
|
|
874
|
+
this.on("notification", (event) => notifications.push(event)),
|
|
875
|
+
this.on("response_suggestions", (event) => {
|
|
876
|
+
suggestions = event;
|
|
877
|
+
}),
|
|
878
|
+
this.on("turn_completed", (event) => {
|
|
879
|
+
var _a;
|
|
880
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
881
|
+
cleanup();
|
|
882
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "completed" });
|
|
883
|
+
}),
|
|
884
|
+
this.on("turn_failed", (event) => {
|
|
885
|
+
var _a;
|
|
886
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
887
|
+
cleanup();
|
|
888
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "failed" });
|
|
889
|
+
}),
|
|
890
|
+
this.on("turn_cancelled", (event) => {
|
|
891
|
+
var _a;
|
|
892
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
893
|
+
cleanup();
|
|
894
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "cancelled" });
|
|
895
|
+
})
|
|
896
|
+
);
|
|
897
|
+
this.sendChat({ content, ...chatOpts });
|
|
898
|
+
});
|
|
899
|
+
}
|
|
900
|
+
/** Closes the socket and clears all listeners. */
|
|
901
|
+
close(code, reason) {
|
|
902
|
+
var _a;
|
|
903
|
+
(_a = this.socket) == null ? void 0 : _a.close(code, reason);
|
|
904
|
+
this.authenticated = false;
|
|
905
|
+
this.listeners.clear();
|
|
906
|
+
}
|
|
907
|
+
dispatch(raw) {
|
|
908
|
+
let frame;
|
|
909
|
+
try {
|
|
910
|
+
frame = JSON.parse(raw);
|
|
911
|
+
} catch {
|
|
912
|
+
return;
|
|
913
|
+
}
|
|
914
|
+
const set = this.listeners.get(frame.type);
|
|
915
|
+
if (!set) return;
|
|
916
|
+
for (const handler of set) {
|
|
917
|
+
handler(frame.payload);
|
|
918
|
+
}
|
|
919
|
+
}
|
|
920
|
+
};
|
|
921
|
+
|
|
272
922
|
// src/HCAmsSDK.ts
|
|
273
923
|
var HCAmsSDK = class {
|
|
274
924
|
constructor(config) {
|
|
275
|
-
var _a, _b;
|
|
925
|
+
var _a, _b, _c;
|
|
276
926
|
assertEnvironment(config.environment);
|
|
277
927
|
assertTimeout((_a = config.timeout) != null ? _a : DEFAULT_TIMEOUT_MS);
|
|
278
928
|
this.state = {
|
|
@@ -283,7 +933,60 @@ var HCAmsSDK = class {
|
|
|
283
933
|
timeout: (_b = config.timeout) != null ? _b : DEFAULT_TIMEOUT_MS
|
|
284
934
|
};
|
|
285
935
|
this.http = new HttpClient(this.state);
|
|
936
|
+
const authBaseUrlOverride = (_c = config.baseUrlOverride) != null ? _c : resolveAmsAuthBaseUrl(config.environment);
|
|
937
|
+
const state = this.state;
|
|
938
|
+
const authState = {
|
|
939
|
+
get environment() {
|
|
940
|
+
return state.environment;
|
|
941
|
+
},
|
|
942
|
+
get tenantId() {
|
|
943
|
+
return state.tenantId;
|
|
944
|
+
},
|
|
945
|
+
get accessToken() {
|
|
946
|
+
return state.accessToken;
|
|
947
|
+
},
|
|
948
|
+
set accessToken(value) {
|
|
949
|
+
state.accessToken = value;
|
|
950
|
+
},
|
|
951
|
+
get baseUrlOverride() {
|
|
952
|
+
return authBaseUrlOverride;
|
|
953
|
+
},
|
|
954
|
+
get timeout() {
|
|
955
|
+
return state.timeout;
|
|
956
|
+
}
|
|
957
|
+
};
|
|
958
|
+
this.authHttp = new HttpClient(authState);
|
|
286
959
|
this.ams = new AmsClient(this.http);
|
|
960
|
+
this.agents = new AgentsClient(this.http);
|
|
961
|
+
this.departments = new DepartmentsClient(this.http);
|
|
962
|
+
this.teams = new TeamsClient(this.http);
|
|
963
|
+
this.skills = new SkillsClient(this.http);
|
|
964
|
+
this.policies = new PoliciesClient(this.http);
|
|
965
|
+
this.guardrails = new GuardrailsClient(this.http);
|
|
966
|
+
this.dataSources = new DataSourcesClient(this.http);
|
|
967
|
+
this.tools = new ToolsClient(this.http);
|
|
968
|
+
this.testPersonas = new TestPersonasClient(this.http);
|
|
969
|
+
this.auth = new AuthClient(this.authHttp);
|
|
970
|
+
}
|
|
971
|
+
/**
|
|
972
|
+
* Opens a WebSocket agent-chat session using this SDK's configured
|
|
973
|
+
* environment (and `tenantId`, if set and not overridden here). See
|
|
974
|
+
* {@link WssClient} for the full API (typed event subscription,
|
|
975
|
+
* `sendAndAwaitTurn`, etc).
|
|
976
|
+
*/
|
|
977
|
+
connectAgentChat(options) {
|
|
978
|
+
var _a;
|
|
979
|
+
const tenantId = (_a = options.tenantId) != null ? _a : this.state.tenantId;
|
|
980
|
+
if (!tenantId) {
|
|
981
|
+
throw new Error(
|
|
982
|
+
"connectAgentChat requires a tenantId \u2014 pass one explicitly or configure it on HCAmsSDK."
|
|
983
|
+
);
|
|
984
|
+
}
|
|
985
|
+
return new WssClient({
|
|
986
|
+
...options,
|
|
987
|
+
environment: this.state.environment,
|
|
988
|
+
tenantId
|
|
989
|
+
});
|
|
287
990
|
}
|
|
288
991
|
/** Get the current runtime environment. */
|
|
289
992
|
get environment() {
|
|
@@ -304,12 +1007,25 @@ var HCAmsSDK = class {
|
|
|
304
1007
|
};
|
|
305
1008
|
// Annotate the CommonJS export names for ESM import in node:
|
|
306
1009
|
0 && (module.exports = {
|
|
1010
|
+
AgentsClient,
|
|
307
1011
|
AmsClient,
|
|
1012
|
+
AuthClient,
|
|
308
1013
|
DEFAULT_TIMEOUT_MS,
|
|
1014
|
+
DataSourcesClient,
|
|
1015
|
+
DepartmentsClient,
|
|
1016
|
+
GuardrailsClient,
|
|
309
1017
|
HCAmsSDK,
|
|
1018
|
+
PoliciesClient,
|
|
310
1019
|
SDKError,
|
|
311
1020
|
SERVICE_NAME,
|
|
1021
|
+
SkillsClient,
|
|
1022
|
+
TeamsClient,
|
|
1023
|
+
TestPersonasClient,
|
|
1024
|
+
ToolsClient,
|
|
1025
|
+
WssClient,
|
|
312
1026
|
assertEnvironment,
|
|
313
1027
|
assertTimeout,
|
|
314
|
-
|
|
1028
|
+
resolveAmsAuthBaseUrl,
|
|
1029
|
+
resolveBaseUrl,
|
|
1030
|
+
resolveWssBaseUrl
|
|
315
1031
|
});
|