@smartytalent/mcp-tools 0.1.33-dev.62 → 0.1.33-dev.64

package/dist/tools.json

@@ -942,7 +942,16 @@
                   "type": "string"
                 },
                 "isSystem": {
-                  "type": "boolean"
+                  "type": "boolean",
+                  "description": "Marks tenant-internal system users (admins, integrations, the Boe bot). Distinct from `type` - `isSystem=true` only means 'not a regular end-user'; the human-vs-bot split lives in `type`."
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "human",
+                    "ai"
+                  ],
+                  "description": "Discriminator for human-vs-bot users.\n  'ai'    - Boe bot user. tenant.relationships.boeUser points at one\n            of these per tenant. Drives the createMeetingAttendee\n            AI-dispatch decision: principalType=user + user.type='ai'\n            makes the meeting service spawn a Fargate bot instead of\n            returning Chime join credentials.\n  'human' - regular user (recruiter, observer, candidate-with-account).\n  null    - legacy rows without the field; treated as 'human' by the\n            server (safer default - we'd rather miss a bot dispatch\n            than accidentally dispatch a Fargate task for a real human)."
                 },
                 "address": {
                   "type": "object",
@@ -1207,7 +1216,16 @@
                   "type": "string"
                 },
                 "isSystem": {
-                  "type": "boolean"
+                  "type": "boolean",
+                  "description": "Marks tenant-internal system users (admins, integrations, the Boe bot). Distinct from `type` - `isSystem=true` only means 'not a regular end-user'; the human-vs-bot split lives in `type`."
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "human",
+                    "ai"
+                  ],
+                  "description": "Discriminator for human-vs-bot users.\n  'ai'    - Boe bot user. tenant.relationships.boeUser points at one\n            of these per tenant. Drives the createMeetingAttendee\n            AI-dispatch decision: principalType=user + user.type='ai'\n            makes the meeting service spawn a Fargate bot instead of\n            returning Chime join credentials.\n  'human' - regular user (recruiter, observer, candidate-with-account).\n  null    - legacy rows without the field; treated as 'human' by the\n            server (safer default - we'd rather miss a bot dispatch\n            than accidentally dispatch a Fargate task for a real human)."
                 },
                 "address": {
                   "type": "object",
@@ -14313,6 +14331,18 @@
             "archived"
           ]
         },
+        "filterCandidate": {
+          "type": "string",
+          "description": "Filter meetings (or other resources) by the linked candidate id. Backed by the CandidateIdIndex GSI on meeting; same convention used by other services for candidate reverse-lookup."
+        },
+        "filterJob": {
+          "type": "string",
+          "description": "Filter meetings by linked job id. Backed by the JobIdIndex GSI."
+        },
+        "filterHost": {
+          "type": "string",
+          "description": "Filter meetings by the user hosting (human recruiter or boe user). Backed by the HostIdIndex GSI."
+        },
         "filterCreatedFrom": {
           "type": "string",
           "description": "Filters results to include only those created from the specified date and time. The value must be in ISO 8601 format."
@@ -14501,11 +14531,22 @@
                   "description": "Raw AWS Chime CreateMeeting `Meeting` object - passed verbatim to chime-sdk-js. Includes MeetingFeatures.Audio.EchoReduction when enabled server-side.",
                   "additionalProperties": true
                 },
-                "participants": {
-                  "type": "array",
-                  "items": {
-                    "type": "object"
-                  }
+                "candidateId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.candidate.data.id, used by the CandidateIdIndex GSI for reverse-lookup ('list meetings for this candidate'). Sparse - present only when the relationship is set. Do NOT set this directly on createMeeting / updateMeeting; pass relationships.candidate instead and the server derives the scalar."
+                },
+                "jobId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.job.data.id, used by the JobIdIndex GSI ('list meetings for this job'). Derived server-side from relationships.job."
+                },
+                "hostId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.host.data.id (always a users id - human recruiter or boe user). Used by the HostIdIndex GSI for the 'my meetings' dashboard. Derived server-side from relationships.host."
+                },
+                "notetakerEnabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "When true (default), human-hosted meetings auto-dispatch a Boe notetaker bot at meeting start time. Set false on createMeeting to opt out for sensitive sessions. Ignored when the meeting is itself AI-hosted (host.data.id is a boe user); the host bot already takes notes."
                 },
                 "recordingStatus": {
                   "type": "string",
@@ -14719,14 +14760,15 @@
               "title": "MeetingRelationshipsSchema",
               "type": "object",
               "properties": {
-                "participants": {
-                  "title": "MeetingRelationshipsParticipantsSchema",
+                "team": {
+                  "title": "MeetingRelationshipsTeamSchema",
                   "type": "object",
+                  "description": "Tenant users with stake in this meeting (host + co-hosts + observers + HR backup). Drives access control + 'my meetings' notifications + dashboard visibility. Candidates and guests do NOT live here - they appear in the attendees relationship once they join Chime.",
                   "properties": {
                     "data": {
                       "type": "array",
                       "items": {
-                        "title": "MeetingRelationshipsParticipantsDataSchema",
+                        "title": "MeetingRelationshipsTeamDataSchema",
                         "type": "object",
                         "properties": {
                           "type": {
@@ -14779,7 +14821,7 @@
                 "candidate": {
                   "title": "MeetingRelationshipsCandidateSchema",
                   "type": "object",
-                  "description": "Candidate the meeting is about, when known (e.g. interview).",
+                  "description": "Candidate the meeting is about, when known (e.g. interview). Setting this also writes the top-level candidateId scalar (CandidateIdIndex GSI key) so the 'meetings for candidate X' query is a direct GSI hit.",
                   "properties": {
                     "data": {
                       "type": "object",
@@ -14811,6 +14853,65 @@
                       }
                     }
                   }
+                },
+                "host": {
+                  "title": "MeetingRelationshipsHostSchema",
+                  "type": "object",
+                  "description": "User leading the meeting. May be a human recruiter or a boe user (e.g. usr-boe-interviewer for AI-hosted sessions). Setting this also writes the top-level hostId scalar (HostIdIndex GSI key) so the 'my meetings' dashboard query is a direct GSI hit. Always points at the users resource - there is no separate 'aiHost' shape because Boe IS a user.",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
+                "job": {
+                  "title": "MeetingRelationshipsJobSchema",
+                  "type": "object",
+                  "description": "Job opening the meeting is about. Drives interviewer-bot context enrichment (job description, mustHaves, competencies auto-loaded into the prompt) and the 'meetings for this role' job-page view. Setting this also writes the top-level jobId scalar (JobIdIndex GSI key).",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "type": {
+                          "type": "string"
+                        },
+                        "id": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
+                "attendees": {
+                  "title": "MeetingRelationshipsAttendeesSchema",
+                  "type": "object",
+                  "description": "Chime attendee records - everyone with a live or terminated Chime SDK attendee for this meeting (humans + bots, unified). Use `?include=attendees,attendees.user,attendees.candidate` on showMeeting / listMeetings to sideload the full roster in one round-trip. Not embedded in attributes - relationship + sideload only.",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "title": "MeetingRelationshipsAttendeesDataSchema",
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string"
+                          },
+                          "id": {
+                            "type": "string",
+                            "description": "Chime attendee id (resource id of the attendee)."
+                          }
+                        }
+                      }
+                    }
+                  }
                 }
               }
             }
@@ -15002,11 +15103,22 @@
                   "description": "Raw AWS Chime CreateMeeting `Meeting` object - passed verbatim to chime-sdk-js. Includes MeetingFeatures.Audio.EchoReduction when enabled server-side.",
                   "additionalProperties": true
                 },
-                "participants": {
-                  "type": "array",
-                  "items": {
-                    "type": "object"
-                  }
+                "candidateId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.candidate.data.id, used by the CandidateIdIndex GSI for reverse-lookup ('list meetings for this candidate'). Sparse - present only when the relationship is set. Do NOT set this directly on createMeeting / updateMeeting; pass relationships.candidate instead and the server derives the scalar."
+                },
+                "jobId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.job.data.id, used by the JobIdIndex GSI ('list meetings for this job'). Derived server-side from relationships.job."
+                },
+                "hostId": {
+                  "type": "string",
+                  "description": "Top-level scalar mirror of relationships.host.data.id (always a users id - human recruiter or boe user). Used by the HostIdIndex GSI for the 'my meetings' dashboard. Derived server-side from relationships.host."
+                },
+                "notetakerEnabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "When true (default), human-hosted meetings auto-dispatch a Boe notetaker bot at meeting start time. Set false on createMeeting to opt out for sensitive sessions. Ignored when the meeting is itself AI-hosted (host.data.id is a boe user); the host bot already takes notes."
                 },
                 "recordingStatus": {
                   "type": "string",
@@ -15252,6 +15364,24 @@
       "operationId": "meetingOptions"
     }
   },
+  {
+    "name": "list_meeting_attendees",
+    "description": "List Meeting Attendees",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "include": {
+          "type": "string",
+          "description": "JSON:API compound document request - comma-separated list of relationship paths to include in the response (e.g. `feedbacks`, `feedbacks,boeUser`). Currently advisory: the service always returns all declared relationships with empty defaults."
+        }
+      }
+    },
+    "_meta": {
+      "method": "GET",
+      "path": "/v1/meetings/{meetingId}/attendees",
+      "operationId": "listMeetingAttendees"
+    }
+  },
   {
     "name": "create_meeting_attendee",
     "description": "Create Meeting Attendee",
@@ -15279,18 +15409,103 @@
             "attributes": {
               "title": "MeetingAttendeeAttributesSchema",
               "type": "object",
+              "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.",
               "properties": {
+                "chimeAttendeeId": {
+                  "type": "string",
+                  "description": "Chime SDK attendee id. Server-generated, immutable. Also the resource id of this attendee. Not accepted on the request - server allocates."
+                },
+                "externalUserId": {
+                  "type": "string",
+                  "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."
+                },
+                "joinToken": {
+                  "type": "string",
+                  "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."
+                },
+                "principalType": {
+                  "type": "string",
+                  "enum": [
+                    "user",
+                    "candidate",
+                    "talent",
+                    "guest"
+                  ],
+                  "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."
+                },
+                "principalId": {
+                  "type": "string",
+                  "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)."
+                },
                 "name": {
-                  "type": "string"
+                  "type": "string",
+                  "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."
+                },
+                "role": {
+                  "type": "string",
+                  "enum": [
+                    "host",
+                    "attendee",
+                    "candidate",
+                    "observer",
+                    "interviewer",
+                    "notetaker",
+                    "sales",
+                    "other"
+                  ],
+                  "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."
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "joining",
+                    "active",
+                    "left",
+                    "dropped",
+                    "ended",
+                    "error"
+                  ],
+                  "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."
                 },
                 "email": {
-                  "type": "string"
+                  "type": "string",
+                  "description": "Optional. Auth humans: from user profile (server-resolved). Guests: from lobby form (accepted on request)."
                 },
-                "role": {
-                  "type": "string"
+                "phone": {
+                  "type": "string",
+                  "description": "Optional. Typed in lobby form when present (guest only)."
                 },
-                "externalUserId": {
-                  "type": "string"
+                "voice": {
+                  "type": "string",
+                  "description": "AI only. Realtime model voice (alloy / echo / fable / onyx / nova / shimmer). Used at dispatch."
+                },
+                "config": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "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."
+                },
+                "taskArn": {
+                  "type": "string",
+                  "description": "AI only. ECS task ARN for the bot (operational). Server-managed."
+                },
+                "errorMessage": {
+                  "type": "string",
+                  "description": "Populated when status=error."
+                },
+                "joinedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Server-stamped from chime:AttendeeJoined event."
+                },
+                "leftAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Server-stamped from chime:AttendeeLeft / Dropped event."
+                },
+                "chimeMeetingData": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "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."
                 }
               }
             }
@@ -15477,143 +15692,42 @@
     }
   },
   {
-    "name": "create_meeting_ai_attendee",
-    "description": "Create Meeting AI Attendee",
-    "inputSchema": {
-      "title": "CreateMeetingAiAttendeeRequestBody",
-      "type": "object",
-      "required": [
-        "data"
-      ],
-      "properties": {
-        "data": {
-          "title": "CreateMeetingAiAttendeeRequestBodyData",
-          "type": "object",
-          "required": [
-            "type",
-            "attributes"
-          ],
-          "properties": {
-            "type": {
-              "type": "string",
-              "enum": [
-                "ai-attendees"
-              ]
-            },
-            "attributes": {
-              "title": "MeetingAiAttendeeSettingsSchema",
-              "type": "object",
-              "description": "Settings supplied at createMeetingAiAttendee time. Boe always\njoins with mic on, camera off; toggle via 'boe-control' Chime\nDataMessage at runtime.",
-              "properties": {
-                "displayName": {
-                  "type": "string",
-                  "default": "Boe"
-                },
-                "voice": {
-                  "type": "string",
-                  "default": "alloy"
-                },
-                "language": {
-                  "type": "string",
-                  "description": "Reply language for Boe's assistant behaviour (e.g. English)"
-                },
-                "faceId": {
-                  "type": "string",
-                  "description": "Simli avatar face UUID for camera_on. Falls back to the tenant default if omitted."
-                },
-                "persona": {
-                  "type": "string",
-                  "description": "Optional persona text appended to the base system prompt"
-                },
-                "role": {
-                  "type": "string",
-                  "enum": [
-                    "interviewer",
-                    "notetaker",
-                    "sales"
-                  ],
-                  "description": "Picks a system prompt template from the bot container's\nprompt/<role>.md library.\n'interviewer' drives a structured screening conversation\n  with a candidate (compliance, behavioral block, etc.).\n'notetaker' silently observes and captures action items,\n  decisions, and open questions; speaks only when addressed.\n'sales' runs a discovery + pitch conversation with a\n  prospect, advances toward a concrete next step. No\n  commercial commitments on the call.\nOmit (or pass empty) for the generic silent-listening\nassistant prompt - back-compat default."
-                },
-                "context": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Per-meeting context values used to fill {placeholder} tokens\nin the chosen role's prompt template. The required keys depend\non the role - the prompt itself documents what it expects.\n\nBE-side enrichment: for role=interviewer, supplying just\n`{ \"jobId\": \"...\" }` causes the BE to fetch the job row and\nauto-populate roleName, roleDescription, mustHaves,\ncompetencies, workLocation, workMode, workHours, salaryRange,\nroleDetailShareable, and companyInfoShareable from it. Any\nadditional keys you supply override the assembled values\n(FE wins on conflicts). Use this to inject recruiterNotes,\nnextStepsShareable, expectedTimeline, and any field you want\nto override.\n\nMissing or empty values are substituted with the literal\nstring \"not provided\"; the prompt is written to handle that\ngracefully (\"do NOT make up missing fields\"). Each string\nvalue is capped at 1500 chars - the BE truncates and logs\na warning if exceeded (ECS RunTask containerOverrides has\nan 8KB total limit across all env vars)."
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "_meta": {
-      "method": "POST",
-      "path": "/v1/meetings/{meetingId}/ai-attendees",
-      "operationId": "createMeetingAiAttendee"
-    }
-  },
-  {
-    "name": "list_meeting_ai_attendees",
-    "description": "List Meeting AI Attendees",
-    "inputSchema": {
-      "type": "object",
-      "properties": {}
-    },
-    "_meta": {
-      "method": "GET",
-      "path": "/v1/meetings/{meetingId}/ai-attendees",
-      "operationId": "listMeetingAiAttendees"
-    }
-  },
-  {
-    "name": "meeting_ai_attendees_options",
-    "description": "Meeting AI Attendees Options",
-    "inputSchema": {
-      "type": "object",
-      "properties": {}
-    },
-    "_meta": {
-      "method": "OPTIONS",
-      "path": "/v1/meetings/{meetingId}/ai-attendees",
-      "operationId": "meetingAiAttendeesOptions"
-    }
-  },
-  {
-    "name": "show_meeting_ai_attendee",
-    "description": "Show Meeting AI Attendee",
+    "name": "show_meeting_attendee",
+    "description": "Show Meeting Attendee",
     "inputSchema": {
       "type": "object",
       "properties": {}
     },
     "_meta": {
       "method": "GET",
-      "path": "/v1/meetings/{meetingId}/ai-attendees/{aiAttendeeId}",
-      "operationId": "showMeetingAiAttendee"
+      "path": "/v1/meetings/{meetingId}/attendees/{attendeeId}",
+      "operationId": "showMeetingAttendee"
     }
   },
   {
-    "name": "delete_meeting_ai_attendee",
-    "description": "Dismiss Meeting AI Attendee",
+    "name": "delete_meeting_attendee",
+    "description": "Remove Meeting Attendee",
     "inputSchema": {
       "type": "object",
       "properties": {}
     },
     "_meta": {
       "method": "DELETE",
-      "path": "/v1/meetings/{meetingId}/ai-attendees/{aiAttendeeId}",
-      "operationId": "deleteMeetingAiAttendee"
+      "path": "/v1/meetings/{meetingId}/attendees/{attendeeId}",
+      "operationId": "deleteMeetingAttendee"
     }
   },
   {
-    "name": "meeting_ai_attendee_options",
-    "description": "Meeting AI Attendee Options",
+    "name": "meeting_attendee_options",
+    "description": "Meeting Attendee Options",
     "inputSchema": {
       "type": "object",
       "properties": {}
     },
     "_meta": {
       "method": "OPTIONS",
-      "path": "/v1/meetings/{meetingId}/ai-attendees/{aiAttendeeId}",
-      "operationId": "meetingAiAttendeeOptions"
+      "path": "/v1/meetings/{meetingId}/attendees/{attendeeId}",
+      "operationId": "meetingAttendeeOptions"
     }
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartytalent/mcp-tools",
-  "version": "0.1.33-dev.62",
+  "version": "0.1.33-dev.64",
   "description": "MCP tool definitions for SmartyTalent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",