@smartytalent/mcp-tools 0.1.33-dev.64 → 0.1.33-dev.66
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/dist/tools.json +505 -0
- package/package.json +1 -1
package/dist/tools.json
CHANGED
|
@@ -15502,6 +15502,23 @@
|
|
|
15502
15502
|
"format": "date-time",
|
|
15503
15503
|
"description": "Server-stamped from chime:AttendeeLeft / Dropped event."
|
|
15504
15504
|
},
|
|
15505
|
+
"experienceRating": {
|
|
15506
|
+
"type": "object",
|
|
15507
|
+
"description": "Post-meeting subjective rating submitted by the attendee after\nthey left. Each dimension is 1-5 (1=very bad, 5=very good).\nSubmit gate (server-side): only accepted while status is in\n{left, dropped, ended} - 400 otherwise. submittedAt is\nserver-stamped; clients cannot set it. Schema is forward-\ncompatible - new dimensions can be added without migration.",
|
|
15508
|
+
"properties": {
|
|
15509
|
+
"audioVideo": {
|
|
15510
|
+
"type": "integer",
|
|
15511
|
+
"minimum": 1,
|
|
15512
|
+
"maximum": 5,
|
|
15513
|
+
"description": "1=Very bad, 5=Very good. Captures the attendee's perception of audio + video quality during the call."
|
|
15514
|
+
},
|
|
15515
|
+
"submittedAt": {
|
|
15516
|
+
"type": "string",
|
|
15517
|
+
"format": "date-time",
|
|
15518
|
+
"description": "Server-stamped on PATCH. Client-supplied values are ignored."
|
|
15519
|
+
}
|
|
15520
|
+
}
|
|
15521
|
+
},
|
|
15505
15522
|
"chimeMeetingData": {
|
|
15506
15523
|
"type": "object",
|
|
15507
15524
|
"additionalProperties": true,
|
|
@@ -15532,6 +15549,340 @@
|
|
|
15532
15549
|
"operationId": "meetingAttendeesOptions"
|
|
15533
15550
|
}
|
|
15534
15551
|
},
|
|
15552
|
+
{
|
|
15553
|
+
"name": "create_guest_meeting_attendee",
|
|
15554
|
+
"description": "Create Guest Meeting Attendee",
|
|
15555
|
+
"inputSchema": {
|
|
15556
|
+
"title": "CreateMeetingAttendeeRequestBody",
|
|
15557
|
+
"type": "object",
|
|
15558
|
+
"required": [
|
|
15559
|
+
"data"
|
|
15560
|
+
],
|
|
15561
|
+
"properties": {
|
|
15562
|
+
"data": {
|
|
15563
|
+
"title": "CreateMeetingAttendeeRequestBodyData",
|
|
15564
|
+
"type": "object",
|
|
15565
|
+
"required": [
|
|
15566
|
+
"type",
|
|
15567
|
+
"attributes"
|
|
15568
|
+
],
|
|
15569
|
+
"properties": {
|
|
15570
|
+
"type": {
|
|
15571
|
+
"type": "string",
|
|
15572
|
+
"enum": [
|
|
15573
|
+
"attendees"
|
|
15574
|
+
]
|
|
15575
|
+
},
|
|
15576
|
+
"attributes": {
|
|
15577
|
+
"title": "MeetingAttendeeAttributesSchema",
|
|
15578
|
+
"type": "object",
|
|
15579
|
+
"description": "Chime attendee record - someone (or some bot) with a live or terminated\nChime SDK attendee for this meeting. Unified across human-auth +\nhuman-guest + AI; principalType + the optional relationships disambiguate.\nUsed both as the createMeetingAttendee request body shape (subset of fields\naccepted - server ignores fields it sets itself) and as the response shape.",
|
|
15580
|
+
"properties": {
|
|
15581
|
+
"chimeAttendeeId": {
|
|
15582
|
+
"type": "string",
|
|
15583
|
+
"description": "Chime SDK attendee id. Server-generated, immutable. Also the resource id of this attendee. Not accepted on the request - server allocates."
|
|
15584
|
+
},
|
|
15585
|
+
"externalUserId": {
|
|
15586
|
+
"type": "string",
|
|
15587
|
+
"description": "Namespace-prefixed identifier sent to Chime CreateAttendee. Format: `user:<userId>` for auth humans, `guest:<guestId>` for lobby walk-ins, `boe:<userId>` for AI users. Visible in Chime State Change events so any consumer can identify the principal type without a DB join. Derived server-side from principalType / user.type - do not set on the request."
|
|
15588
|
+
},
|
|
15589
|
+
"joinToken": {
|
|
15590
|
+
"type": "string",
|
|
15591
|
+
"description": "One-time Chime SDK join token. Present only on the createMeetingAttendee response; do NOT cache or re-use - request a fresh attendee if the join fails."
|
|
15592
|
+
},
|
|
15593
|
+
"principalType": {
|
|
15594
|
+
"type": "string",
|
|
15595
|
+
"enum": [
|
|
15596
|
+
"user",
|
|
15597
|
+
"candidate",
|
|
15598
|
+
"talent",
|
|
15599
|
+
"guest"
|
|
15600
|
+
],
|
|
15601
|
+
"description": "Type of the underlying principal who owns this attendance. Mirrors call.fromType / call.toType taxonomy so the same vocabulary spans channels. Required on createMeetingAttendee request."
|
|
15602
|
+
},
|
|
15603
|
+
"principalId": {
|
|
15604
|
+
"type": "string",
|
|
15605
|
+
"description": "Stable id of the principal (e.g. usr-anna, cnd-tomek, gst-xyz). For namespace `boe:` attendees this is the boe user's id - Boe is a user just like a human, the principalType is still 'user'. Required on createMeetingAttendee request unless principalType=guest (then the server allocates a guest id)."
|
|
15606
|
+
},
|
|
15607
|
+
"name": {
|
|
15608
|
+
"type": "string",
|
|
15609
|
+
"description": "Display name shown in the roster. Source: user.name for principalType=user (auth or boe), lobby-typed name for guest, candidate/talent name for those types. Accepted on the request as an override; otherwise server resolves it from the principal."
|
|
15610
|
+
},
|
|
15611
|
+
"role": {
|
|
15612
|
+
"type": "string",
|
|
15613
|
+
"enum": [
|
|
15614
|
+
"host",
|
|
15615
|
+
"attendee",
|
|
15616
|
+
"candidate",
|
|
15617
|
+
"observer",
|
|
15618
|
+
"interviewer",
|
|
15619
|
+
"notetaker",
|
|
15620
|
+
"sales",
|
|
15621
|
+
"other"
|
|
15622
|
+
],
|
|
15623
|
+
"description": "Function this attendee plays in THIS meeting. Distinct from user.type (which says human-vs-bot at the user level). At most one `host` per meeting. AI bot roles (interviewer / notetaker / sales) drive prompt template selection in the bot container."
|
|
15624
|
+
},
|
|
15625
|
+
"status": {
|
|
15626
|
+
"type": "string",
|
|
15627
|
+
"enum": [
|
|
15628
|
+
"joining",
|
|
15629
|
+
"active",
|
|
15630
|
+
"left",
|
|
15631
|
+
"dropped",
|
|
15632
|
+
"ended",
|
|
15633
|
+
"error"
|
|
15634
|
+
],
|
|
15635
|
+
"description": "Lifecycle on the attendee record.\n joining - row created, attendee not yet on Chime grid (typical for bots between dispatch and Chime ack, or for fresh createMeetingAttendee responses pre-join)\n active - present on the Chime grid, audio bridging\n left - left cleanly (clicked leave or natural end)\n dropped - lost connection or network drop (per Chime AttendeeDropped event)\n ended - bot path: server-initiated dismiss (DELETE) or natural completion\n error - bot dispatch / join failed; see errorMessage\nServer-managed - do not set on the request."
|
|
15636
|
+
},
|
|
15637
|
+
"email": {
|
|
15638
|
+
"type": "string",
|
|
15639
|
+
"description": "Optional. Auth humans: from user profile (server-resolved). Guests: from lobby form (accepted on request)."
|
|
15640
|
+
},
|
|
15641
|
+
"phone": {
|
|
15642
|
+
"type": "string",
|
|
15643
|
+
"description": "Optional. Typed in lobby form when present (guest only)."
|
|
15644
|
+
},
|
|
15645
|
+
"voice": {
|
|
15646
|
+
"type": "string",
|
|
15647
|
+
"description": "AI only. Realtime model voice (alloy / echo / fable / onyx / nova / shimmer). Used at dispatch."
|
|
15648
|
+
},
|
|
15649
|
+
"config": {
|
|
15650
|
+
"type": "object",
|
|
15651
|
+
"additionalProperties": true,
|
|
15652
|
+
"description": "AI only. Per-bot runtime config: mode, language, targetLanguage, persona, faceId, context (job-context auto-enrichment seed). Echoed back so FE can confirm what the bot received."
|
|
15653
|
+
},
|
|
15654
|
+
"taskArn": {
|
|
15655
|
+
"type": "string",
|
|
15656
|
+
"description": "AI only. ECS task ARN for the bot (operational). Server-managed."
|
|
15657
|
+
},
|
|
15658
|
+
"errorMessage": {
|
|
15659
|
+
"type": "string",
|
|
15660
|
+
"description": "Populated when status=error."
|
|
15661
|
+
},
|
|
15662
|
+
"joinedAt": {
|
|
15663
|
+
"type": "string",
|
|
15664
|
+
"format": "date-time",
|
|
15665
|
+
"description": "Server-stamped from chime:AttendeeJoined event."
|
|
15666
|
+
},
|
|
15667
|
+
"leftAt": {
|
|
15668
|
+
"type": "string",
|
|
15669
|
+
"format": "date-time",
|
|
15670
|
+
"description": "Server-stamped from chime:AttendeeLeft / Dropped event."
|
|
15671
|
+
},
|
|
15672
|
+
"experienceRating": {
|
|
15673
|
+
"type": "object",
|
|
15674
|
+
"description": "Post-meeting subjective rating submitted by the attendee after\nthey left. Each dimension is 1-5 (1=very bad, 5=very good).\nSubmit gate (server-side): only accepted while status is in\n{left, dropped, ended} - 400 otherwise. submittedAt is\nserver-stamped; clients cannot set it. Schema is forward-\ncompatible - new dimensions can be added without migration.",
|
|
15675
|
+
"properties": {
|
|
15676
|
+
"audioVideo": {
|
|
15677
|
+
"type": "integer",
|
|
15678
|
+
"minimum": 1,
|
|
15679
|
+
"maximum": 5,
|
|
15680
|
+
"description": "1=Very bad, 5=Very good. Captures the attendee's perception of audio + video quality during the call."
|
|
15681
|
+
},
|
|
15682
|
+
"submittedAt": {
|
|
15683
|
+
"type": "string",
|
|
15684
|
+
"format": "date-time",
|
|
15685
|
+
"description": "Server-stamped on PATCH. Client-supplied values are ignored."
|
|
15686
|
+
}
|
|
15687
|
+
}
|
|
15688
|
+
},
|
|
15689
|
+
"chimeMeetingData": {
|
|
15690
|
+
"type": "object",
|
|
15691
|
+
"additionalProperties": true,
|
|
15692
|
+
"description": "Raw AWS Chime CreateMeeting `Meeting` object - passed verbatim to chime-sdk-js. Only on the createMeetingAttendee response (so the joining client gets everything it needs in one round-trip); not stored on the row."
|
|
15693
|
+
}
|
|
15694
|
+
}
|
|
15695
|
+
}
|
|
15696
|
+
}
|
|
15697
|
+
}
|
|
15698
|
+
}
|
|
15699
|
+
},
|
|
15700
|
+
"_meta": {
|
|
15701
|
+
"method": "POST",
|
|
15702
|
+
"path": "/v1/guest/meetings/{meetingId}/attendees",
|
|
15703
|
+
"operationId": "createGuestMeetingAttendee"
|
|
15704
|
+
}
|
|
15705
|
+
},
|
|
15706
|
+
{
|
|
15707
|
+
"name": "guest_meeting_attendees_options",
|
|
15708
|
+
"description": "Guest Meeting Attendees Options",
|
|
15709
|
+
"inputSchema": {
|
|
15710
|
+
"type": "object",
|
|
15711
|
+
"properties": {}
|
|
15712
|
+
},
|
|
15713
|
+
"_meta": {
|
|
15714
|
+
"method": "OPTIONS",
|
|
15715
|
+
"path": "/v1/guest/meetings/{meetingId}/attendees",
|
|
15716
|
+
"operationId": "guestMeetingAttendeesOptions"
|
|
15717
|
+
}
|
|
15718
|
+
},
|
|
15719
|
+
{
|
|
15720
|
+
"name": "patch_guest_meeting_attendee",
|
|
15721
|
+
"description": "Patch Guest Meeting Attendee",
|
|
15722
|
+
"inputSchema": {
|
|
15723
|
+
"title": "CreateMeetingAttendeeRequestBody",
|
|
15724
|
+
"type": "object",
|
|
15725
|
+
"required": [
|
|
15726
|
+
"data"
|
|
15727
|
+
],
|
|
15728
|
+
"properties": {
|
|
15729
|
+
"data": {
|
|
15730
|
+
"title": "CreateMeetingAttendeeRequestBodyData",
|
|
15731
|
+
"type": "object",
|
|
15732
|
+
"required": [
|
|
15733
|
+
"type",
|
|
15734
|
+
"attributes"
|
|
15735
|
+
],
|
|
15736
|
+
"properties": {
|
|
15737
|
+
"type": {
|
|
15738
|
+
"type": "string",
|
|
15739
|
+
"enum": [
|
|
15740
|
+
"attendees"
|
|
15741
|
+
]
|
|
15742
|
+
},
|
|
15743
|
+
"attributes": {
|
|
15744
|
+
"title": "MeetingAttendeeAttributesSchema",
|
|
15745
|
+
"type": "object",
|
|
15746
|
+
"description": "Chime attendee record - someone (or some bot) with a live or terminated\nChime SDK attendee for this meeting. Unified across human-auth +\nhuman-guest + AI; principalType + the optional relationships disambiguate.\nUsed both as the createMeetingAttendee request body shape (subset of fields\naccepted - server ignores fields it sets itself) and as the response shape.",
|
|
15747
|
+
"properties": {
|
|
15748
|
+
"chimeAttendeeId": {
|
|
15749
|
+
"type": "string",
|
|
15750
|
+
"description": "Chime SDK attendee id. Server-generated, immutable. Also the resource id of this attendee. Not accepted on the request - server allocates."
|
|
15751
|
+
},
|
|
15752
|
+
"externalUserId": {
|
|
15753
|
+
"type": "string",
|
|
15754
|
+
"description": "Namespace-prefixed identifier sent to Chime CreateAttendee. Format: `user:<userId>` for auth humans, `guest:<guestId>` for lobby walk-ins, `boe:<userId>` for AI users. Visible in Chime State Change events so any consumer can identify the principal type without a DB join. Derived server-side from principalType / user.type - do not set on the request."
|
|
15755
|
+
},
|
|
15756
|
+
"joinToken": {
|
|
15757
|
+
"type": "string",
|
|
15758
|
+
"description": "One-time Chime SDK join token. Present only on the createMeetingAttendee response; do NOT cache or re-use - request a fresh attendee if the join fails."
|
|
15759
|
+
},
|
|
15760
|
+
"principalType": {
|
|
15761
|
+
"type": "string",
|
|
15762
|
+
"enum": [
|
|
15763
|
+
"user",
|
|
15764
|
+
"candidate",
|
|
15765
|
+
"talent",
|
|
15766
|
+
"guest"
|
|
15767
|
+
],
|
|
15768
|
+
"description": "Type of the underlying principal who owns this attendance. Mirrors call.fromType / call.toType taxonomy so the same vocabulary spans channels. Required on createMeetingAttendee request."
|
|
15769
|
+
},
|
|
15770
|
+
"principalId": {
|
|
15771
|
+
"type": "string",
|
|
15772
|
+
"description": "Stable id of the principal (e.g. usr-anna, cnd-tomek, gst-xyz). For namespace `boe:` attendees this is the boe user's id - Boe is a user just like a human, the principalType is still 'user'. Required on createMeetingAttendee request unless principalType=guest (then the server allocates a guest id)."
|
|
15773
|
+
},
|
|
15774
|
+
"name": {
|
|
15775
|
+
"type": "string",
|
|
15776
|
+
"description": "Display name shown in the roster. Source: user.name for principalType=user (auth or boe), lobby-typed name for guest, candidate/talent name for those types. Accepted on the request as an override; otherwise server resolves it from the principal."
|
|
15777
|
+
},
|
|
15778
|
+
"role": {
|
|
15779
|
+
"type": "string",
|
|
15780
|
+
"enum": [
|
|
15781
|
+
"host",
|
|
15782
|
+
"attendee",
|
|
15783
|
+
"candidate",
|
|
15784
|
+
"observer",
|
|
15785
|
+
"interviewer",
|
|
15786
|
+
"notetaker",
|
|
15787
|
+
"sales",
|
|
15788
|
+
"other"
|
|
15789
|
+
],
|
|
15790
|
+
"description": "Function this attendee plays in THIS meeting. Distinct from user.type (which says human-vs-bot at the user level). At most one `host` per meeting. AI bot roles (interviewer / notetaker / sales) drive prompt template selection in the bot container."
|
|
15791
|
+
},
|
|
15792
|
+
"status": {
|
|
15793
|
+
"type": "string",
|
|
15794
|
+
"enum": [
|
|
15795
|
+
"joining",
|
|
15796
|
+
"active",
|
|
15797
|
+
"left",
|
|
15798
|
+
"dropped",
|
|
15799
|
+
"ended",
|
|
15800
|
+
"error"
|
|
15801
|
+
],
|
|
15802
|
+
"description": "Lifecycle on the attendee record.\n joining - row created, attendee not yet on Chime grid (typical for bots between dispatch and Chime ack, or for fresh createMeetingAttendee responses pre-join)\n active - present on the Chime grid, audio bridging\n left - left cleanly (clicked leave or natural end)\n dropped - lost connection or network drop (per Chime AttendeeDropped event)\n ended - bot path: server-initiated dismiss (DELETE) or natural completion\n error - bot dispatch / join failed; see errorMessage\nServer-managed - do not set on the request."
|
|
15803
|
+
},
|
|
15804
|
+
"email": {
|
|
15805
|
+
"type": "string",
|
|
15806
|
+
"description": "Optional. Auth humans: from user profile (server-resolved). Guests: from lobby form (accepted on request)."
|
|
15807
|
+
},
|
|
15808
|
+
"phone": {
|
|
15809
|
+
"type": "string",
|
|
15810
|
+
"description": "Optional. Typed in lobby form when present (guest only)."
|
|
15811
|
+
},
|
|
15812
|
+
"voice": {
|
|
15813
|
+
"type": "string",
|
|
15814
|
+
"description": "AI only. Realtime model voice (alloy / echo / fable / onyx / nova / shimmer). Used at dispatch."
|
|
15815
|
+
},
|
|
15816
|
+
"config": {
|
|
15817
|
+
"type": "object",
|
|
15818
|
+
"additionalProperties": true,
|
|
15819
|
+
"description": "AI only. Per-bot runtime config: mode, language, targetLanguage, persona, faceId, context (job-context auto-enrichment seed). Echoed back so FE can confirm what the bot received."
|
|
15820
|
+
},
|
|
15821
|
+
"taskArn": {
|
|
15822
|
+
"type": "string",
|
|
15823
|
+
"description": "AI only. ECS task ARN for the bot (operational). Server-managed."
|
|
15824
|
+
},
|
|
15825
|
+
"errorMessage": {
|
|
15826
|
+
"type": "string",
|
|
15827
|
+
"description": "Populated when status=error."
|
|
15828
|
+
},
|
|
15829
|
+
"joinedAt": {
|
|
15830
|
+
"type": "string",
|
|
15831
|
+
"format": "date-time",
|
|
15832
|
+
"description": "Server-stamped from chime:AttendeeJoined event."
|
|
15833
|
+
},
|
|
15834
|
+
"leftAt": {
|
|
15835
|
+
"type": "string",
|
|
15836
|
+
"format": "date-time",
|
|
15837
|
+
"description": "Server-stamped from chime:AttendeeLeft / Dropped event."
|
|
15838
|
+
},
|
|
15839
|
+
"experienceRating": {
|
|
15840
|
+
"type": "object",
|
|
15841
|
+
"description": "Post-meeting subjective rating submitted by the attendee after\nthey left. Each dimension is 1-5 (1=very bad, 5=very good).\nSubmit gate (server-side): only accepted while status is in\n{left, dropped, ended} - 400 otherwise. submittedAt is\nserver-stamped; clients cannot set it. Schema is forward-\ncompatible - new dimensions can be added without migration.",
|
|
15842
|
+
"properties": {
|
|
15843
|
+
"audioVideo": {
|
|
15844
|
+
"type": "integer",
|
|
15845
|
+
"minimum": 1,
|
|
15846
|
+
"maximum": 5,
|
|
15847
|
+
"description": "1=Very bad, 5=Very good. Captures the attendee's perception of audio + video quality during the call."
|
|
15848
|
+
},
|
|
15849
|
+
"submittedAt": {
|
|
15850
|
+
"type": "string",
|
|
15851
|
+
"format": "date-time",
|
|
15852
|
+
"description": "Server-stamped on PATCH. Client-supplied values are ignored."
|
|
15853
|
+
}
|
|
15854
|
+
}
|
|
15855
|
+
},
|
|
15856
|
+
"chimeMeetingData": {
|
|
15857
|
+
"type": "object",
|
|
15858
|
+
"additionalProperties": true,
|
|
15859
|
+
"description": "Raw AWS Chime CreateMeeting `Meeting` object - passed verbatim to chime-sdk-js. Only on the createMeetingAttendee response (so the joining client gets everything it needs in one round-trip); not stored on the row."
|
|
15860
|
+
}
|
|
15861
|
+
}
|
|
15862
|
+
}
|
|
15863
|
+
}
|
|
15864
|
+
}
|
|
15865
|
+
}
|
|
15866
|
+
},
|
|
15867
|
+
"_meta": {
|
|
15868
|
+
"method": "PATCH",
|
|
15869
|
+
"path": "/v1/guest/meetings/{meetingId}/attendees/{attendeeId}",
|
|
15870
|
+
"operationId": "patchGuestMeetingAttendee"
|
|
15871
|
+
}
|
|
15872
|
+
},
|
|
15873
|
+
{
|
|
15874
|
+
"name": "guest_meeting_attendee_options",
|
|
15875
|
+
"description": "Guest Meeting Attendee Options",
|
|
15876
|
+
"inputSchema": {
|
|
15877
|
+
"type": "object",
|
|
15878
|
+
"properties": {}
|
|
15879
|
+
},
|
|
15880
|
+
"_meta": {
|
|
15881
|
+
"method": "OPTIONS",
|
|
15882
|
+
"path": "/v1/guest/meetings/{meetingId}/attendees/{attendeeId}",
|
|
15883
|
+
"operationId": "guestMeetingAttendeeOptions"
|
|
15884
|
+
}
|
|
15885
|
+
},
|
|
15535
15886
|
{
|
|
15536
15887
|
"name": "meeting_transcription",
|
|
15537
15888
|
"description": "Manage Meeting Transcription",
|
|
@@ -15704,6 +16055,160 @@
|
|
|
15704
16055
|
"operationId": "showMeetingAttendee"
|
|
15705
16056
|
}
|
|
15706
16057
|
},
|
|
16058
|
+
{
|
|
16059
|
+
"name": "patch_meeting_attendee",
|
|
16060
|
+
"description": "Patch Meeting Attendee",
|
|
16061
|
+
"inputSchema": {
|
|
16062
|
+
"title": "CreateMeetingAttendeeRequestBody",
|
|
16063
|
+
"type": "object",
|
|
16064
|
+
"required": [
|
|
16065
|
+
"data"
|
|
16066
|
+
],
|
|
16067
|
+
"properties": {
|
|
16068
|
+
"data": {
|
|
16069
|
+
"title": "CreateMeetingAttendeeRequestBodyData",
|
|
16070
|
+
"type": "object",
|
|
16071
|
+
"required": [
|
|
16072
|
+
"type",
|
|
16073
|
+
"attributes"
|
|
16074
|
+
],
|
|
16075
|
+
"properties": {
|
|
16076
|
+
"type": {
|
|
16077
|
+
"type": "string",
|
|
16078
|
+
"enum": [
|
|
16079
|
+
"attendees"
|
|
16080
|
+
]
|
|
16081
|
+
},
|
|
16082
|
+
"attributes": {
|
|
16083
|
+
"title": "MeetingAttendeeAttributesSchema",
|
|
16084
|
+
"type": "object",
|
|
16085
|
+
"description": "Chime attendee record - someone (or some bot) with a live or terminated\nChime SDK attendee for this meeting. Unified across human-auth +\nhuman-guest + AI; principalType + the optional relationships disambiguate.\nUsed both as the createMeetingAttendee request body shape (subset of fields\naccepted - server ignores fields it sets itself) and as the response shape.",
|
|
16086
|
+
"properties": {
|
|
16087
|
+
"chimeAttendeeId": {
|
|
16088
|
+
"type": "string",
|
|
16089
|
+
"description": "Chime SDK attendee id. Server-generated, immutable. Also the resource id of this attendee. Not accepted on the request - server allocates."
|
|
16090
|
+
},
|
|
16091
|
+
"externalUserId": {
|
|
16092
|
+
"type": "string",
|
|
16093
|
+
"description": "Namespace-prefixed identifier sent to Chime CreateAttendee. Format: `user:<userId>` for auth humans, `guest:<guestId>` for lobby walk-ins, `boe:<userId>` for AI users. Visible in Chime State Change events so any consumer can identify the principal type without a DB join. Derived server-side from principalType / user.type - do not set on the request."
|
|
16094
|
+
},
|
|
16095
|
+
"joinToken": {
|
|
16096
|
+
"type": "string",
|
|
16097
|
+
"description": "One-time Chime SDK join token. Present only on the createMeetingAttendee response; do NOT cache or re-use - request a fresh attendee if the join fails."
|
|
16098
|
+
},
|
|
16099
|
+
"principalType": {
|
|
16100
|
+
"type": "string",
|
|
16101
|
+
"enum": [
|
|
16102
|
+
"user",
|
|
16103
|
+
"candidate",
|
|
16104
|
+
"talent",
|
|
16105
|
+
"guest"
|
|
16106
|
+
],
|
|
16107
|
+
"description": "Type of the underlying principal who owns this attendance. Mirrors call.fromType / call.toType taxonomy so the same vocabulary spans channels. Required on createMeetingAttendee request."
|
|
16108
|
+
},
|
|
16109
|
+
"principalId": {
|
|
16110
|
+
"type": "string",
|
|
16111
|
+
"description": "Stable id of the principal (e.g. usr-anna, cnd-tomek, gst-xyz). For namespace `boe:` attendees this is the boe user's id - Boe is a user just like a human, the principalType is still 'user'. Required on createMeetingAttendee request unless principalType=guest (then the server allocates a guest id)."
|
|
16112
|
+
},
|
|
16113
|
+
"name": {
|
|
16114
|
+
"type": "string",
|
|
16115
|
+
"description": "Display name shown in the roster. Source: user.name for principalType=user (auth or boe), lobby-typed name for guest, candidate/talent name for those types. Accepted on the request as an override; otherwise server resolves it from the principal."
|
|
16116
|
+
},
|
|
16117
|
+
"role": {
|
|
16118
|
+
"type": "string",
|
|
16119
|
+
"enum": [
|
|
16120
|
+
"host",
|
|
16121
|
+
"attendee",
|
|
16122
|
+
"candidate",
|
|
16123
|
+
"observer",
|
|
16124
|
+
"interviewer",
|
|
16125
|
+
"notetaker",
|
|
16126
|
+
"sales",
|
|
16127
|
+
"other"
|
|
16128
|
+
],
|
|
16129
|
+
"description": "Function this attendee plays in THIS meeting. Distinct from user.type (which says human-vs-bot at the user level). At most one `host` per meeting. AI bot roles (interviewer / notetaker / sales) drive prompt template selection in the bot container."
|
|
16130
|
+
},
|
|
16131
|
+
"status": {
|
|
16132
|
+
"type": "string",
|
|
16133
|
+
"enum": [
|
|
16134
|
+
"joining",
|
|
16135
|
+
"active",
|
|
16136
|
+
"left",
|
|
16137
|
+
"dropped",
|
|
16138
|
+
"ended",
|
|
16139
|
+
"error"
|
|
16140
|
+
],
|
|
16141
|
+
"description": "Lifecycle on the attendee record.\n joining - row created, attendee not yet on Chime grid (typical for bots between dispatch and Chime ack, or for fresh createMeetingAttendee responses pre-join)\n active - present on the Chime grid, audio bridging\n left - left cleanly (clicked leave or natural end)\n dropped - lost connection or network drop (per Chime AttendeeDropped event)\n ended - bot path: server-initiated dismiss (DELETE) or natural completion\n error - bot dispatch / join failed; see errorMessage\nServer-managed - do not set on the request."
|
|
16142
|
+
},
|
|
16143
|
+
"email": {
|
|
16144
|
+
"type": "string",
|
|
16145
|
+
"description": "Optional. Auth humans: from user profile (server-resolved). Guests: from lobby form (accepted on request)."
|
|
16146
|
+
},
|
|
16147
|
+
"phone": {
|
|
16148
|
+
"type": "string",
|
|
16149
|
+
"description": "Optional. Typed in lobby form when present (guest only)."
|
|
16150
|
+
},
|
|
16151
|
+
"voice": {
|
|
16152
|
+
"type": "string",
|
|
16153
|
+
"description": "AI only. Realtime model voice (alloy / echo / fable / onyx / nova / shimmer). Used at dispatch."
|
|
16154
|
+
},
|
|
16155
|
+
"config": {
|
|
16156
|
+
"type": "object",
|
|
16157
|
+
"additionalProperties": true,
|
|
16158
|
+
"description": "AI only. Per-bot runtime config: mode, language, targetLanguage, persona, faceId, context (job-context auto-enrichment seed). Echoed back so FE can confirm what the bot received."
|
|
16159
|
+
},
|
|
16160
|
+
"taskArn": {
|
|
16161
|
+
"type": "string",
|
|
16162
|
+
"description": "AI only. ECS task ARN for the bot (operational). Server-managed."
|
|
16163
|
+
},
|
|
16164
|
+
"errorMessage": {
|
|
16165
|
+
"type": "string",
|
|
16166
|
+
"description": "Populated when status=error."
|
|
16167
|
+
},
|
|
16168
|
+
"joinedAt": {
|
|
16169
|
+
"type": "string",
|
|
16170
|
+
"format": "date-time",
|
|
16171
|
+
"description": "Server-stamped from chime:AttendeeJoined event."
|
|
16172
|
+
},
|
|
16173
|
+
"leftAt": {
|
|
16174
|
+
"type": "string",
|
|
16175
|
+
"format": "date-time",
|
|
16176
|
+
"description": "Server-stamped from chime:AttendeeLeft / Dropped event."
|
|
16177
|
+
},
|
|
16178
|
+
"experienceRating": {
|
|
16179
|
+
"type": "object",
|
|
16180
|
+
"description": "Post-meeting subjective rating submitted by the attendee after\nthey left. Each dimension is 1-5 (1=very bad, 5=very good).\nSubmit gate (server-side): only accepted while status is in\n{left, dropped, ended} - 400 otherwise. submittedAt is\nserver-stamped; clients cannot set it. Schema is forward-\ncompatible - new dimensions can be added without migration.",
|
|
16181
|
+
"properties": {
|
|
16182
|
+
"audioVideo": {
|
|
16183
|
+
"type": "integer",
|
|
16184
|
+
"minimum": 1,
|
|
16185
|
+
"maximum": 5,
|
|
16186
|
+
"description": "1=Very bad, 5=Very good. Captures the attendee's perception of audio + video quality during the call."
|
|
16187
|
+
},
|
|
16188
|
+
"submittedAt": {
|
|
16189
|
+
"type": "string",
|
|
16190
|
+
"format": "date-time",
|
|
16191
|
+
"description": "Server-stamped on PATCH. Client-supplied values are ignored."
|
|
16192
|
+
}
|
|
16193
|
+
}
|
|
16194
|
+
},
|
|
16195
|
+
"chimeMeetingData": {
|
|
16196
|
+
"type": "object",
|
|
16197
|
+
"additionalProperties": true,
|
|
16198
|
+
"description": "Raw AWS Chime CreateMeeting `Meeting` object - passed verbatim to chime-sdk-js. Only on the createMeetingAttendee response (so the joining client gets everything it needs in one round-trip); not stored on the row."
|
|
16199
|
+
}
|
|
16200
|
+
}
|
|
16201
|
+
}
|
|
16202
|
+
}
|
|
16203
|
+
}
|
|
16204
|
+
}
|
|
16205
|
+
},
|
|
16206
|
+
"_meta": {
|
|
16207
|
+
"method": "PATCH",
|
|
16208
|
+
"path": "/v1/meetings/{meetingId}/attendees/{attendeeId}",
|
|
16209
|
+
"operationId": "patchMeetingAttendee"
|
|
16210
|
+
}
|
|
16211
|
+
},
|
|
15707
16212
|
{
|
|
15708
16213
|
"name": "delete_meeting_attendee",
|
|
15709
16214
|
"description": "Remove Meeting Attendee",
|