@healthcloudai/hc-ams 0.0.1 → 3.5.1
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 +101 -7
- package/dist/index.cjs +711 -3
- package/dist/index.d.cts +907 -2
- package/dist/index.d.ts +907 -2
- package/dist/index.js +697 -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,631 @@ 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
|
+
this.url = url.toString();
|
|
665
|
+
this.turnTimeoutMs = (_b = options.turnTimeoutMs) != null ? _b : 6e4;
|
|
666
|
+
this.authTimeoutMs = (_c = options.authTimeoutMs) != null ? _c : 1e4;
|
|
667
|
+
const ctor = (_d = options.WebSocketImpl) != null ? _d : globalThis.WebSocket;
|
|
668
|
+
if (!ctor) {
|
|
669
|
+
throw new SDKError({
|
|
670
|
+
message: 'No WebSocket implementation available. Pass `WebSocketImpl` (e.g. `new WssClient({ ..., WebSocketImpl: require("ws") })`) on runtimes without a global WebSocket (Node < 21).',
|
|
671
|
+
statusCode: 0
|
|
672
|
+
});
|
|
673
|
+
}
|
|
674
|
+
this.WebSocketCtor = ctor;
|
|
675
|
+
}
|
|
676
|
+
async resolveToken() {
|
|
677
|
+
var _a;
|
|
678
|
+
if (this.options.getAccessToken) {
|
|
679
|
+
return this.options.getAccessToken();
|
|
680
|
+
}
|
|
681
|
+
return (_a = this.options.healthcloudToken) != null ? _a : "";
|
|
682
|
+
}
|
|
683
|
+
/**
|
|
684
|
+
* Opens the socket and runs the auth handshake: sends
|
|
685
|
+
* `{"type":"auth","token":...}` as soon as the socket opens, and resolves
|
|
686
|
+
* only once the server replies `{"type":"auth_ok"}`. Rejects on a
|
|
687
|
+
* connect/auth error, an auth timeout, or a rejection frame — in every
|
|
688
|
+
* case before any chat frame can be sent (see {@link send}).
|
|
689
|
+
*/
|
|
690
|
+
connect() {
|
|
691
|
+
return new Promise((resolve, reject) => {
|
|
692
|
+
this.authenticated = false;
|
|
693
|
+
const socket = new this.WebSocketCtor(this.url);
|
|
694
|
+
this.socket = socket;
|
|
695
|
+
let authTimer;
|
|
696
|
+
const settle = (fn) => {
|
|
697
|
+
cleanup();
|
|
698
|
+
fn();
|
|
699
|
+
};
|
|
700
|
+
const onOpen = () => {
|
|
701
|
+
authTimer = setTimeout(() => {
|
|
702
|
+
settle(
|
|
703
|
+
() => reject(new SDKError({ message: `Authentication timed out after ${this.authTimeoutMs}ms.`, statusCode: 0 }))
|
|
704
|
+
);
|
|
705
|
+
socket.close();
|
|
706
|
+
}, this.authTimeoutMs);
|
|
707
|
+
this.resolveToken().then((token) => socket.send(JSON.stringify({ type: "auth", token }))).catch((error) => {
|
|
708
|
+
clearTimeout(authTimer);
|
|
709
|
+
settle(
|
|
710
|
+
() => reject(
|
|
711
|
+
new SDKError({
|
|
712
|
+
message: "Failed to resolve the Health Cloud access token for the auth frame.",
|
|
713
|
+
statusCode: 0,
|
|
714
|
+
cause: error
|
|
715
|
+
})
|
|
716
|
+
)
|
|
717
|
+
);
|
|
718
|
+
socket.close();
|
|
719
|
+
});
|
|
720
|
+
};
|
|
721
|
+
const onError = (event) => {
|
|
722
|
+
clearTimeout(authTimer);
|
|
723
|
+
settle(() => reject(new SDKError({ message: "WebSocket connection failed.", statusCode: 0, cause: event })));
|
|
724
|
+
};
|
|
725
|
+
const onClose = (event) => {
|
|
726
|
+
clearTimeout(authTimer);
|
|
727
|
+
if (this.authenticated) return;
|
|
728
|
+
settle(
|
|
729
|
+
() => {
|
|
730
|
+
var _a, _b;
|
|
731
|
+
return reject(
|
|
732
|
+
new SDKError({
|
|
733
|
+
message: `WebSocket closed before authenticating (code ${(_a = event.code) != null ? _a : "unknown"}): ${(_b = event.reason) != null ? _b : ""}`.trim(),
|
|
734
|
+
statusCode: 0
|
|
735
|
+
})
|
|
736
|
+
);
|
|
737
|
+
}
|
|
738
|
+
);
|
|
739
|
+
};
|
|
740
|
+
const onMessage = (event) => {
|
|
741
|
+
var _a, _b;
|
|
742
|
+
if (!this.authenticated) {
|
|
743
|
+
let frame;
|
|
744
|
+
try {
|
|
745
|
+
frame = JSON.parse(String((_a = event.data) != null ? _a : ""));
|
|
746
|
+
} catch {
|
|
747
|
+
return;
|
|
748
|
+
}
|
|
749
|
+
if ((frame == null ? void 0 : frame.type) === "auth_ok") {
|
|
750
|
+
clearTimeout(authTimer);
|
|
751
|
+
this.authenticated = true;
|
|
752
|
+
settle(() => resolve());
|
|
753
|
+
return;
|
|
754
|
+
}
|
|
755
|
+
if ((frame == null ? void 0 : frame.type) === "error") {
|
|
756
|
+
clearTimeout(authTimer);
|
|
757
|
+
settle(
|
|
758
|
+
() => {
|
|
759
|
+
var _a2, _b2;
|
|
760
|
+
return reject(
|
|
761
|
+
new SDKError({
|
|
762
|
+
message: `WebSocket authentication was rejected: ${(_b2 = (_a2 = frame == null ? void 0 : frame.payload) == null ? void 0 : _a2.message) != null ? _b2 : "unknown error"}`,
|
|
763
|
+
statusCode: 401
|
|
764
|
+
})
|
|
765
|
+
);
|
|
766
|
+
}
|
|
767
|
+
);
|
|
768
|
+
return;
|
|
769
|
+
}
|
|
770
|
+
return;
|
|
771
|
+
}
|
|
772
|
+
this.dispatch((_b = event.data) != null ? _b : "");
|
|
773
|
+
};
|
|
774
|
+
const cleanup = () => {
|
|
775
|
+
socket.removeEventListener("open", onOpen);
|
|
776
|
+
socket.removeEventListener("error", onError);
|
|
777
|
+
socket.removeEventListener("close", onClose);
|
|
778
|
+
};
|
|
779
|
+
socket.addEventListener("open", onOpen);
|
|
780
|
+
socket.addEventListener("error", onError);
|
|
781
|
+
socket.addEventListener("close", onClose);
|
|
782
|
+
socket.addEventListener("message", onMessage);
|
|
783
|
+
});
|
|
784
|
+
}
|
|
785
|
+
/** Subscribes to a typed server event. Returns an unsubscribe function. */
|
|
786
|
+
on(type, handler) {
|
|
787
|
+
let set = this.listeners.get(type);
|
|
788
|
+
if (!set) {
|
|
789
|
+
set = /* @__PURE__ */ new Set();
|
|
790
|
+
this.listeners.set(type, set);
|
|
791
|
+
}
|
|
792
|
+
set.add(handler);
|
|
793
|
+
return () => set.delete(handler);
|
|
794
|
+
}
|
|
795
|
+
/** Sends a raw outgoing frame: `{"type": type, "payload": payload}`. */
|
|
796
|
+
send(type, payload = {}) {
|
|
797
|
+
if (!this.socket) {
|
|
798
|
+
throw new SDKError({ message: "WssClient is not connected. Call connect() first.", statusCode: 0 });
|
|
799
|
+
}
|
|
800
|
+
if (!this.authenticated) {
|
|
801
|
+
throw new SDKError({
|
|
802
|
+
message: "WssClient has not finished authenticating yet. Await connect() before sending frames.",
|
|
803
|
+
statusCode: 0
|
|
804
|
+
});
|
|
805
|
+
}
|
|
806
|
+
this.socket.send(JSON.stringify({ type, payload }));
|
|
807
|
+
}
|
|
808
|
+
sendChat(payload) {
|
|
809
|
+
this.send("chat", payload);
|
|
810
|
+
}
|
|
811
|
+
sendVoice(active) {
|
|
812
|
+
this.send("voice", { active });
|
|
813
|
+
}
|
|
814
|
+
sendAudioInput(payload) {
|
|
815
|
+
this.send("audio_input", payload);
|
|
816
|
+
}
|
|
817
|
+
sendToolConfirmation(payload) {
|
|
818
|
+
this.send("tool_confirmation", payload);
|
|
819
|
+
}
|
|
820
|
+
sendHandoff(messages) {
|
|
821
|
+
this.send("handoff", { messages });
|
|
822
|
+
}
|
|
823
|
+
/**
|
|
824
|
+
* Sends a `chat` frame and resolves once that turn completes, buffering
|
|
825
|
+
* every streamed `chat` delta into the final `message` and collecting
|
|
826
|
+
* `activity`/`transfer`/`artifact_block`/`notification`/`response_suggestions`
|
|
827
|
+
* events emitted during the turn.
|
|
828
|
+
*
|
|
829
|
+
* Resolves with `status: "failed"`/`"cancelled"` (rather than rejecting)
|
|
830
|
+
* on `turn_failed`/`turn_cancelled`, so callers can inspect whatever
|
|
831
|
+
* partial `message`/side-effects were collected before the turn ended.
|
|
832
|
+
* Rejects only if no terminal event arrives within `timeoutMs`.
|
|
833
|
+
*/
|
|
834
|
+
sendAndAwaitTurn(content, opts = {}) {
|
|
835
|
+
const { timeoutMs = this.turnTimeoutMs, ...chatOpts } = opts;
|
|
836
|
+
return new Promise((resolve, reject) => {
|
|
837
|
+
let message = "";
|
|
838
|
+
const activity = [];
|
|
839
|
+
const transfers = [];
|
|
840
|
+
const artifacts = [];
|
|
841
|
+
const notifications = [];
|
|
842
|
+
let suggestions;
|
|
843
|
+
let turnId;
|
|
844
|
+
const unsubscribers = [];
|
|
845
|
+
const cleanup = () => {
|
|
846
|
+
clearTimeout(timer);
|
|
847
|
+
unsubscribers.forEach((unsub) => unsub());
|
|
848
|
+
};
|
|
849
|
+
const timer = setTimeout(() => {
|
|
850
|
+
cleanup();
|
|
851
|
+
reject(new SDKError({ message: `Turn timed out after ${timeoutMs}ms.`, statusCode: 0 }));
|
|
852
|
+
}, timeoutMs);
|
|
853
|
+
unsubscribers.push(
|
|
854
|
+
this.on("chat", (event) => {
|
|
855
|
+
var _a;
|
|
856
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
857
|
+
if (event.replace) {
|
|
858
|
+
message = event.content;
|
|
859
|
+
} else {
|
|
860
|
+
message += event.content;
|
|
861
|
+
}
|
|
862
|
+
}),
|
|
863
|
+
this.on("activity", (event) => activity.push(event)),
|
|
864
|
+
this.on("transfer", (event) => transfers.push(event)),
|
|
865
|
+
this.on("artifact_block", (event) => artifacts.push(event)),
|
|
866
|
+
this.on("notification", (event) => notifications.push(event)),
|
|
867
|
+
this.on("response_suggestions", (event) => {
|
|
868
|
+
suggestions = event;
|
|
869
|
+
}),
|
|
870
|
+
this.on("turn_completed", (event) => {
|
|
871
|
+
var _a;
|
|
872
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
873
|
+
cleanup();
|
|
874
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "completed" });
|
|
875
|
+
}),
|
|
876
|
+
this.on("turn_failed", (event) => {
|
|
877
|
+
var _a;
|
|
878
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
879
|
+
cleanup();
|
|
880
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "failed" });
|
|
881
|
+
}),
|
|
882
|
+
this.on("turn_cancelled", (event) => {
|
|
883
|
+
var _a;
|
|
884
|
+
turnId = (_a = event.turn_id) != null ? _a : turnId;
|
|
885
|
+
cleanup();
|
|
886
|
+
resolve({ message, activity, transfers, artifacts, notifications, suggestions, turnId, status: "cancelled" });
|
|
887
|
+
})
|
|
888
|
+
);
|
|
889
|
+
this.sendChat({ content, ...chatOpts });
|
|
890
|
+
});
|
|
891
|
+
}
|
|
892
|
+
/** Closes the socket and clears all listeners. */
|
|
893
|
+
close(code, reason) {
|
|
894
|
+
var _a;
|
|
895
|
+
(_a = this.socket) == null ? void 0 : _a.close(code, reason);
|
|
896
|
+
this.authenticated = false;
|
|
897
|
+
this.listeners.clear();
|
|
898
|
+
}
|
|
899
|
+
dispatch(raw) {
|
|
900
|
+
let frame;
|
|
901
|
+
try {
|
|
902
|
+
frame = JSON.parse(raw);
|
|
903
|
+
} catch {
|
|
904
|
+
return;
|
|
905
|
+
}
|
|
906
|
+
const set = this.listeners.get(frame.type);
|
|
907
|
+
if (!set) return;
|
|
908
|
+
for (const handler of set) {
|
|
909
|
+
handler(frame.payload);
|
|
910
|
+
}
|
|
911
|
+
}
|
|
912
|
+
};
|
|
913
|
+
|
|
272
914
|
// src/HCAmsSDK.ts
|
|
273
915
|
var HCAmsSDK = class {
|
|
274
916
|
constructor(config) {
|
|
275
|
-
var _a, _b;
|
|
917
|
+
var _a, _b, _c;
|
|
276
918
|
assertEnvironment(config.environment);
|
|
277
919
|
assertTimeout((_a = config.timeout) != null ? _a : DEFAULT_TIMEOUT_MS);
|
|
278
920
|
this.state = {
|
|
@@ -283,7 +925,60 @@ var HCAmsSDK = class {
|
|
|
283
925
|
timeout: (_b = config.timeout) != null ? _b : DEFAULT_TIMEOUT_MS
|
|
284
926
|
};
|
|
285
927
|
this.http = new HttpClient(this.state);
|
|
928
|
+
const authBaseUrlOverride = (_c = config.baseUrlOverride) != null ? _c : resolveAmsAuthBaseUrl(config.environment);
|
|
929
|
+
const state = this.state;
|
|
930
|
+
const authState = {
|
|
931
|
+
get environment() {
|
|
932
|
+
return state.environment;
|
|
933
|
+
},
|
|
934
|
+
get tenantId() {
|
|
935
|
+
return state.tenantId;
|
|
936
|
+
},
|
|
937
|
+
get accessToken() {
|
|
938
|
+
return state.accessToken;
|
|
939
|
+
},
|
|
940
|
+
set accessToken(value) {
|
|
941
|
+
state.accessToken = value;
|
|
942
|
+
},
|
|
943
|
+
get baseUrlOverride() {
|
|
944
|
+
return authBaseUrlOverride;
|
|
945
|
+
},
|
|
946
|
+
get timeout() {
|
|
947
|
+
return state.timeout;
|
|
948
|
+
}
|
|
949
|
+
};
|
|
950
|
+
this.authHttp = new HttpClient(authState);
|
|
286
951
|
this.ams = new AmsClient(this.http);
|
|
952
|
+
this.agents = new AgentsClient(this.http);
|
|
953
|
+
this.departments = new DepartmentsClient(this.http);
|
|
954
|
+
this.teams = new TeamsClient(this.http);
|
|
955
|
+
this.skills = new SkillsClient(this.http);
|
|
956
|
+
this.policies = new PoliciesClient(this.http);
|
|
957
|
+
this.guardrails = new GuardrailsClient(this.http);
|
|
958
|
+
this.dataSources = new DataSourcesClient(this.http);
|
|
959
|
+
this.tools = new ToolsClient(this.http);
|
|
960
|
+
this.testPersonas = new TestPersonasClient(this.http);
|
|
961
|
+
this.auth = new AuthClient(this.authHttp);
|
|
962
|
+
}
|
|
963
|
+
/**
|
|
964
|
+
* Opens a WebSocket agent-chat session using this SDK's configured
|
|
965
|
+
* environment (and `tenantId`, if set and not overridden here). See
|
|
966
|
+
* {@link WssClient} for the full API (typed event subscription,
|
|
967
|
+
* `sendAndAwaitTurn`, etc).
|
|
968
|
+
*/
|
|
969
|
+
connectAgentChat(options) {
|
|
970
|
+
var _a;
|
|
971
|
+
const tenantId = (_a = options.tenantId) != null ? _a : this.state.tenantId;
|
|
972
|
+
if (!tenantId) {
|
|
973
|
+
throw new Error(
|
|
974
|
+
"connectAgentChat requires a tenantId \u2014 pass one explicitly or configure it on HCAmsSDK."
|
|
975
|
+
);
|
|
976
|
+
}
|
|
977
|
+
return new WssClient({
|
|
978
|
+
...options,
|
|
979
|
+
environment: this.state.environment,
|
|
980
|
+
tenantId
|
|
981
|
+
});
|
|
287
982
|
}
|
|
288
983
|
/** Get the current runtime environment. */
|
|
289
984
|
get environment() {
|
|
@@ -304,12 +999,25 @@ var HCAmsSDK = class {
|
|
|
304
999
|
};
|
|
305
1000
|
// Annotate the CommonJS export names for ESM import in node:
|
|
306
1001
|
0 && (module.exports = {
|
|
1002
|
+
AgentsClient,
|
|
307
1003
|
AmsClient,
|
|
1004
|
+
AuthClient,
|
|
308
1005
|
DEFAULT_TIMEOUT_MS,
|
|
1006
|
+
DataSourcesClient,
|
|
1007
|
+
DepartmentsClient,
|
|
1008
|
+
GuardrailsClient,
|
|
309
1009
|
HCAmsSDK,
|
|
1010
|
+
PoliciesClient,
|
|
310
1011
|
SDKError,
|
|
311
1012
|
SERVICE_NAME,
|
|
1013
|
+
SkillsClient,
|
|
1014
|
+
TeamsClient,
|
|
1015
|
+
TestPersonasClient,
|
|
1016
|
+
ToolsClient,
|
|
1017
|
+
WssClient,
|
|
312
1018
|
assertEnvironment,
|
|
313
1019
|
assertTimeout,
|
|
314
|
-
|
|
1020
|
+
resolveAmsAuthBaseUrl,
|
|
1021
|
+
resolveBaseUrl,
|
|
1022
|
+
resolveWssBaseUrl
|
|
315
1023
|
});
|