@gravity-rail/sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   IndexStatus
 } from "./chunk-KQJR26B5.js";
 
-// ../client/dist/chunk-F5J4UVSB.mjs
+// ../client/dist/chunk-WFQXAPII.mjs
 import { parsePhoneNumberFromString } from "libphonenumber-js";
 function getCookieValue(name) {
   if (typeof document === "undefined") return void 0;
@@ -411,8 +411,7 @@ var AppsApi = class extends BaseApiClient {
 };
 var BuildersApi = class extends BaseApiClient {
   /**
-   * List all builders
-   * @param all - If true, return all (superuser access required)
+   * List all builders (optionally all with superuser access)
    */
   async listBuilders(all) {
     const params = new URLSearchParams();
@@ -423,7 +422,6 @@ var BuildersApi = class extends BaseApiClient {
   }
   /**
    * Get a specific builder by UUID
-   * @param builderId - Builder UUID
    */
   async getBuilder(builderId) {
     return this.fetch(`builders/${builderId}`);
@@ -598,24 +596,29 @@ var OrgApi = class extends BaseApiClient {
   }
 };
 var SupervisorsApi = class extends BaseApiClient {
+  /** List all supervisors in a workspace. */
   async getSupervisors(wid) {
     return this.fetch(`w/${wid}/supervisors`);
   }
+  /** Get a single supervisor by ID. */
   async getSupervisor(wid, id) {
     return this.fetch(`w/${wid}/supervisors/${id}`);
   }
+  /** Create a new supervisor in a workspace. */
   async createSupervisor(wid, supervisor) {
     return this.fetch(`w/${wid}/supervisors`, {
       method: "POST",
       body: JSON.stringify(supervisor)
     });
   }
+  /** Update an existing supervisor with partial data. */
   async updateSupervisor(wid, id, supervisor) {
     return this.fetch(`w/${wid}/supervisors/${id}`, {
       method: "PUT",
       body: JSON.stringify(supervisor)
     });
   }
+  /** Delete a supervisor by ID. */
   async deleteSupervisor(wid, id) {
     return this.fetch(`w/${wid}/supervisors/${id}`, {
       method: "DELETE"
@@ -675,6 +678,7 @@ var AbilitiesApi = class extends BaseApiClient {
   }
 };
 var AccessGrantsApi = class extends BaseApiClient {
+  /** List access grants received by the current member. */
   async getMyReceivedGrants(wid, params) {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set("status", params.status);
@@ -685,6 +689,7 @@ var AccessGrantsApi = class extends BaseApiClient {
       `w/${wid}/access-grants/my/received${qs ? `?${qs}` : ""}`
     );
   }
+  /** List access grants given by the current member. */
   async getMyGivenGrants(wid, params) {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set("status", params.status);
@@ -695,39 +700,45 @@ var AccessGrantsApi = class extends BaseApiClient {
       `w/${wid}/access-grants/my/given${qs ? `?${qs}` : ""}`
     );
   }
+  /** Get a single access grant by UUID. */
   async getAccessGrant(wid, uuid) {
     return this.fetch(`w/${wid}/access-grants/${uuid}`);
   }
+  /** Create a new access grant for a resource. */
   async createAccessGrant(wid, data) {
     return this.fetch(`w/${wid}/access-grants`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Resolve a pending access grant by approving or denying it. */
   async resolveAccessGrant(wid, uuid, data) {
     return this.fetch(`w/${wid}/access-grants/${uuid}/resolve`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Revoke a previously approved access grant. */
   async revokeAccessGrant(wid, uuid, data) {
     return this.fetch(`w/${wid}/access-grants/${uuid}/revoke`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** List all access grants with optional filtering by status, resource type, and resource ID. */
   async getAccessGrants(wid, params) {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set("status", params.status);
     if (params?.resourceType) searchParams.set("resource_type", params.resourceType);
     if (params?.resourceId) searchParams.set("resource_id", params.resourceId.toString());
     if (params?.page) searchParams.set("page", params.page.toString());
-    if (params?.pageSize) searchParams.set("pageSize", params.pageSize.toString());
+    if (params?.pageSize) searchParams.set("page_size", params.pageSize.toString());
     const qs = searchParams.toString();
     return this.fetch(
       `w/${wid}/access-grants${qs ? `?${qs}` : ""}`
     );
   }
+  /** Get all access grants for a specific member. */
   async getMemberGrants(wid, memberId) {
     const resp = await this.fetch(
       `w/${wid}/access-grants/member/${memberId}`
@@ -1500,6 +1511,7 @@ var AdminApi = class extends BaseApiClient {
   }
 };
 var AgentsApi = class extends BaseApiClient {
+  /** List agents in a workspace with optional pagination, sorting, and search. */
   async getAgents(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -1513,32 +1525,38 @@ var AgentsApi = class extends BaseApiClient {
       `w/${wid}/agents${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single agent by ID. */
   async getAgent(wid, id) {
     return this.fetch(`w/${wid}/agents/${id}`);
   }
+  /** Create a new agent in a workspace. */
   async createAgent(wid, agent) {
     return this.fetch(`w/${wid}/agents`, {
       method: "POST",
       body: JSON.stringify(agent)
     });
   }
+  /** Update an existing agent. */
   async updateAgent(wid, id, agent) {
     return this.fetch(`w/${wid}/agents/${id}`, {
       method: "PUT",
       body: JSON.stringify(agent)
     });
   }
+  /** Delete an agent by ID, optionally forcing deletion of agents with active references. */
   async deleteAgent(wid, id, force) {
     const params = force ? "?force=true" : "";
     return this.fetch(`w/${wid}/agents/${id}${params}`, {
       method: "DELETE"
     });
   }
+  /** Archive an agent, hiding it from default listings. */
   async archiveAgent(wid, id) {
     return this.fetch(`w/${wid}/agents/${id}/archive`, {
       method: "POST"
     });
   }
+  /** Restore an archived agent back to active status. */
   async unarchiveAgent(wid, id) {
     return this.fetch(`w/${wid}/agents/${id}/unarchive`, {
       method: "POST"
@@ -1621,30 +1639,36 @@ var AIModelsApi = class extends BaseApiClient {
 };
 var ApiKeysApi = class extends BaseApiClient {
   // Workspace-specific API key methods
+  /** List all API keys for a workspace. */
   async getApiKeys(wid) {
     return this.fetch(`w/${wid}/api-keys`);
   }
+  /** Create a new API key for a workspace. */
   async createApiKey(wid, apiKey) {
     return this.fetch(`w/${wid}/api-keys`, {
       method: "POST",
       body: JSON.stringify(apiKey)
     });
   }
+  /** Revoke a workspace API key. */
   async revokeApiKey(wid, id) {
     return this.fetch(`w/${wid}/api-keys/${id}`, {
       method: "DELETE"
     });
   }
   // Global (account-level) API key methods
+  /** List all account-level API keys. */
   async getGlobalApiKeys() {
     return this.fetch(`account/api-keys`);
   }
+  /** Create a new account-level API key. */
   async createGlobalApiKey(apiKey) {
     return this.fetch(`account/api-keys`, {
       method: "POST",
       body: JSON.stringify(apiKey)
     });
   }
+  /** Revoke an account-level API key. */
   async revokeGlobalApiKey(id) {
     return this.fetch(`account/api-keys/${id}`, {
       method: "DELETE"
@@ -1652,6 +1676,7 @@ var ApiKeysApi = class extends BaseApiClient {
   }
 };
 var AssignmentsApi = class extends BaseApiClient {
+  /** List assignments with optional filtering, pagination, and sorting. */
   async getAssignments(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -1666,56 +1691,68 @@ var AssignmentsApi = class extends BaseApiClient {
       `w/${wid}/assignments${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single assignment by ID. */
   async getAssignment(wid, id) {
     return this.fetch(`w/${wid}/assignments/${id}`);
   }
+  /** Get all chat messages for an assignment. */
   async getAssignmentMessages(wid, id) {
     return this.fetch(`w/${wid}/assignments/${id}/messages`);
   }
+  /** Update an assignment by ID. */
   async updateAssignment(wid, id, assignment) {
     return this.fetch(`w/${wid}/assignments/${id}`, {
       method: "PUT",
       body: JSON.stringify(assignment)
     });
   }
+  /** Delete an assignment by ID. */
   async deleteAssignment(wid, id) {
     return this.fetch(`w/${wid}/assignments/${id}`, {
       method: "DELETE"
     });
   }
+  /** Get a specific task within an assignment. */
   async getAssignmentTask(wid, id, assignmentTaskId) {
     return this.fetch(`w/${wid}/assignments/${id}/tasks/${assignmentTaskId}`);
   }
+  /** Set the current active task for an assignment. */
   async selectCurrentAssignmentTask(wid, id, assignmentTaskId) {
     return this.fetch(`w/${wid}/assignments/${id}/tasks/${assignmentTaskId}/select`, {
       method: "PUT"
     });
   }
+  /** Create a new assignment for a member. */
   async createAssignment(wid, data) {
     return this.fetch(`w/${wid}/assignments`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Get the current task detail for an assignment from the operator perspective. */
   async getAssignmentTaskDetail(wid, assignmentId) {
     return this.fetch(
       `w/${wid}/assignments/${assignmentId}/current-task-detail`
     );
   }
+  /** Get the CEL expression evaluation context for an assignment. */
   async getAssignmentCelContext(wid, assignmentId) {
     return this.fetch(
       `w/${wid}/assignments/${assignmentId}/cel-context`
     );
   }
+  /** Cancel an active assignment with an optional reason. */
   async cancelAssignment(wid, id, data) {
     return this.fetch(`w/${wid}/assignments/${id}/cancel`, {
       method: "POST",
       body: JSON.stringify(data ?? {})
     });
   }
+  /** List available tools for an assignment. */
   async getAssignmentTools(wid, assignmentId) {
     return this.fetch(`w/${wid}/assignments/${assignmentId}/tools`);
   }
+  /** Execute a tool within an assignment context. */
   async executeAssignmentTool(wid, assignmentId, toolName, parameters = {}) {
     return this.fetch(`w/${wid}/assignments/${assignmentId}/execute-tool`, {
       method: "POST",
@@ -1724,6 +1761,7 @@ var AssignmentsApi = class extends BaseApiClient {
   }
 };
 var AssistantsApi = class extends BaseApiClient {
+  /** List assistants in a workspace with optional pagination, sorting, and search. */
   async getAssistants(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -1738,9 +1776,11 @@ var AssistantsApi = class extends BaseApiClient {
       `w/${wid}/assistants${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single assistant by ID. */
   async getAssistant(wid, id) {
     return this.fetch(`w/${wid}/assistants/${id}`);
   }
+  /** Create a new assistant in a workspace. */
   async createAssistant(wid, assistant) {
     const assistantData = { ...assistant };
     return this.fetch(`w/${wid}/assistants`, {
@@ -1748,17 +1788,20 @@ var AssistantsApi = class extends BaseApiClient {
       body: JSON.stringify(assistantData)
     });
   }
+  /** Update an existing assistant with partial data. */
   async updateAssistant(wid, id, assistant) {
     return this.fetch(`w/${wid}/assistants/${id}`, {
       method: "PUT",
       body: JSON.stringify(assistant)
     });
   }
+  /** Delete an assistant by ID. */
   async deleteAssistant(wid, id) {
     return this.fetch(`w/${wid}/assistants/${id}`, {
       method: "DELETE"
     });
   }
+  /** Generate a text-to-speech audio preview for a given voice model. */
   async previewTTS(wid, request) {
     const response = await this.fetchRaw(`w/${wid}/assistants/tts-preview`, {
       method: "POST",
@@ -1769,6 +1812,17 @@ var AssistantsApi = class extends BaseApiClient {
     });
     return response.arrayBuffer();
   }
+  /** Generate a thinking sound audio preview. */
+  async previewThinkingSound(wid, request) {
+    const response = await this.fetchRaw(`w/${wid}/assistants/thinking-sound-preview`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request)
+    });
+    return response.arrayBuffer();
+  }
 };
 function sanitizePhoneForBackend(phoneNumber) {
   try {
@@ -1784,15 +1838,18 @@ function sanitizePhoneForBackend(phoneNumber) {
   return phoneNumber;
 }
 var AuthApi = class extends BaseApiClient {
+  /** Get the authenticated user's account. */
   async getUserAccount() {
     return this.fetch("account");
   }
+  /** Update the authenticated user's account information. */
   async updateUserAccount(info) {
     return this.fetch("account", {
       method: "POST",
       body: JSON.stringify(info)
     });
   }
+  /** Initiate SMS login by sending a verification code to the given phone number. */
   async login(phoneNumber, wid, organizationUuid) {
     const params = new URLSearchParams();
     if (wid) params.append("wid", wid);
@@ -1803,6 +1860,7 @@ var AuthApi = class extends BaseApiClient {
       body: JSON.stringify(body)
     });
   }
+  /** Resend the SMS verification code to the given phone number. */
   async resendCode(phoneNumber, organizationUuid) {
     const body = { phoneNumber: sanitizePhoneForBackend(phoneNumber) };
     if (organizationUuid) body.organizationUuid = organizationUuid;
@@ -1811,6 +1869,7 @@ var AuthApi = class extends BaseApiClient {
       body: JSON.stringify(body)
     });
   }
+  /** Verify an SMS code and complete authentication, handling 2FA if required. */
   async verifyCodeWith2FA(phoneNumber, code, organizationUuid) {
     const verifyResponse = await this.fetch("auth/verify-with-2fa", {
       method: "POST",
@@ -1838,33 +1897,39 @@ var AuthApi = class extends BaseApiClient {
     }
     return verifyResponse;
   }
+  /** Log in with email and password credentials. */
   async emailPasswordLogin(email, password, organizationUuid) {
     return await this.fetch(`auth/email-password-login`, {
       method: "POST",
       body: JSON.stringify({ email, password, organizationUuid })
     });
   }
+  /** Sign up a new account with email and password. */
   async emailPasswordSignup(email, password, name, organizationUuid) {
     return await this.fetch(`auth/email-password-signup`, {
       method: "POST",
       body: JSON.stringify({ email, password, name, organizationUuid })
     });
   }
+  /** Change the current account password by providing the existing password. */
   async changePassword(currentPassword, newPassword) {
     return await this.fetch(`auth/change-password`, {
       method: "POST",
       body: JSON.stringify({ currentPassword, newPassword })
     });
   }
+  /** Set a password for an account that does not yet have one. */
   async setPassword(newPassword) {
     return await this.fetch(`auth/set-password`, {
       method: "POST",
       body: JSON.stringify({ newPassword })
     });
   }
+  /** Check whether the current account has a password set. */
   async getPasswordStatus() {
     return await this.fetch(`auth/password-status`);
   }
+  /** Log out the current session by clearing auth cookies. */
   async logout() {
     const response = await fetch(`/api/auth/logout`, {
       method: "POST",
@@ -1875,22 +1940,24 @@ var AuthApi = class extends BaseApiClient {
     }
     return await response.json();
   }
-  // request a token from auth/cross-domain-token
+  /** Request a cross-domain authentication token for single sign-on across domains. */
   async requestCrossDomainToken() {
     return this.fetch("auth/cross-domain-token", {
       method: "POST"
     });
   }
+  /** Exchange a cross-domain token for an authenticated session token. */
   async exchangeToken(token) {
     return this.fetch("auth/exchange-token", {
       method: "POST",
       body: JSON.stringify({ token })
     });
   }
+  /** Get the organization and workspace mapping for a custom domain. */
   async getDomainMapping(customDomain) {
     return this.fetch(`s/mapping/${customDomain}`);
   }
-  // Signup API (used by eval scripts)
+  /** Create a new signup with member and data records for a workspace. */
   async createSignup(wid, data) {
     return this.fetch(`w/${wid}/create-signup`, {
       method: "POST",
@@ -1898,12 +1965,14 @@ var AuthApi = class extends BaseApiClient {
     });
   }
   // ===== MAGIC LINK AUTHENTICATION METHODS =====
+  /** Request a magic link to be sent to the given email address for passwordless login. */
   async requestMagicLink(email, organizationUuid, redirectUrl) {
     return await this.fetch(`auth/request-magic-link`, {
       method: "POST",
       body: JSON.stringify({ email, organizationUuid, redirectUrl })
     });
   }
+  /** Validate a magic link token and optional OTP to complete authentication. */
   async validateMagicLink(token, otp) {
     const body = { token };
     if (otp) {
@@ -1915,12 +1984,14 @@ var AuthApi = class extends BaseApiClient {
     });
   }
   // ===== EMAIL VERIFICATION METHODS =====
+  /** Send a verification code to the given email address for login. */
   async sendEmailVerification(email, organizationUuid) {
     return await this.fetch(`auth/send-email-verification`, {
       method: "POST",
       body: JSON.stringify({ email, organizationUuid })
     });
   }
+  /** Verify an email code and complete authentication, handling 2FA if required. */
   async verifyEmail(email, code, organizationUuid) {
     const verifyResponse = await this.fetch(`auth/verify-email`, {
       method: "POST",
@@ -1943,44 +2014,52 @@ var AuthApi = class extends BaseApiClient {
     return verifyResponse;
   }
   // ===== TWO-FACTOR AUTHENTICATION METHODS =====
+  /** Get the current two-factor authentication status and configured methods. */
   async getTwoFactorStatus() {
     return this.fetch("auth/2fa/status");
   }
+  /** Initiate TOTP two-factor setup and receive the secret and QR code URI. */
   async setupTOTP(data) {
     return this.fetch("auth/2fa/totp/setup", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Verify a TOTP code to complete two-factor setup. */
   async verifyTOTPSetup(data) {
     return this.fetch("auth/2fa/totp/verify", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Initiate WebAuthn (passkey/security key) two-factor setup. */
   async setupWebAuthn(data) {
     return this.fetch("auth/2fa/webauthn/setup", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Verify a WebAuthn assertion to complete two-factor setup. */
   async verifyWebAuthnSetup(data) {
     return this.fetch("auth/2fa/webauthn/verify", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Generate new two-factor recovery codes, invalidating any existing ones. */
   async generateRecoveryCodes(data = {}) {
     return this.fetch("auth/2fa/recovery-codes/generate", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Disable a specific two-factor authentication method. */
   async disableTwoFactorMethod(methodId) {
     return this.fetch(`auth/2fa/methods/${methodId}`, {
       method: "DELETE"
     });
   }
+  /** Update settings for a two-factor authentication method. */
   async updateTwoFactorMethod(data) {
     return this.fetch(`auth/2fa/methods/${data.methodId}`, {
       method: "PUT",
@@ -1988,6 +2067,7 @@ var AuthApi = class extends BaseApiClient {
     });
   }
   // ===== TWO-FACTOR AUTHENTICATION LOGIN METHODS =====
+  /** Verify a TOTP code during login to complete two-factor authentication. */
   async verifyTOTPAuth(tempToken, code) {
     return this.fetch("auth/2fa/auth/totp", {
       method: "POST",
@@ -1997,6 +2077,7 @@ var AuthApi = class extends BaseApiClient {
       })
     });
   }
+  /** Verify a recovery code during login to complete two-factor authentication. */
   async verifyRecoveryCodeAuth(tempToken, code) {
     return this.fetch("auth/2fa/auth/recovery", {
       method: "POST",
@@ -2006,6 +2087,7 @@ var AuthApi = class extends BaseApiClient {
       })
     });
   }
+  /** Get WebAuthn credential request options for two-factor login verification. */
   async getWebAuthnAuthOptions(tempToken) {
     return this.fetch("auth/2fa/webauthn/options", {
       method: "POST",
@@ -2014,6 +2096,7 @@ var AuthApi = class extends BaseApiClient {
       })
     });
   }
+  /** Verify a WebAuthn assertion during login to complete two-factor authentication. */
   async verifyWebAuthnAuth(tempToken, assertionResponse) {
     return this.fetch("auth/2fa/webauthn", {
       method: "POST",
@@ -2024,6 +2107,7 @@ var AuthApi = class extends BaseApiClient {
     });
   }
   // ===== ORGANIZATION MEMBERSHIP METHODS =====
+  /** List all organizations the current account belongs to. */
   async getMyOrganizations() {
     return this.fetch("o/mine");
   }
@@ -2089,7 +2173,7 @@ var AuthApi = class extends BaseApiClient {
   }
 };
 var CalendarsApi = class extends BaseApiClient {
-  // Calendar CRUD
+  /** List calendars in a workspace with optional pagination. */
   async getCalendars(wid, params) {
     const queryParams = new URLSearchParams();
     if (params?.page) queryParams.append("page", params.page.toString());
@@ -2100,6 +2184,7 @@ var CalendarsApi = class extends BaseApiClient {
       `w/${wid}/calendars${queryString ? `?${queryString}` : ""}`
     );
   }
+  /** Get a single calendar by ID, optionally including its schedules. */
   async getCalendar(wid, id, includeSchedules) {
     const params = new URLSearchParams();
     if (includeSchedules) params.append("include_schedules", "true");
@@ -2107,33 +2192,38 @@ var CalendarsApi = class extends BaseApiClient {
       `w/${wid}/calendars/${id}${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Create a new calendar in the workspace. */
   async createCalendar(wid, calendar) {
     return this.fetch(`w/${wid}/calendars`, {
       method: "POST",
       body: JSON.stringify(calendar)
     });
   }
+  /** Update a calendar's configuration. */
   async updateCalendar(wid, id, calendar) {
     return this.fetch(`w/${wid}/calendars/${id}`, {
       method: "PUT",
       body: JSON.stringify(calendar)
     });
   }
+  /** Delete a calendar by ID. */
   async deleteCalendar(wid, id) {
     return this.fetch(`w/${wid}/calendars/${id}`, {
       method: "DELETE"
     });
   }
-  // Calendar Schedules
+  /** List all schedules for a calendar. */
   async getCalendarSchedules(wid, calendarId) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/schedules`);
   }
+  /** Create a new schedule for a calendar. */
   async createCalendarSchedule(wid, calendarId, schedule) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/schedules`, {
       method: "POST",
       body: JSON.stringify(schedule)
     });
   }
+  /** Update an existing calendar schedule. */
   async updateCalendarSchedule(wid, calendarId, scheduleId, schedule) {
     return this.fetch(
       `w/${wid}/calendars/${calendarId}/schedules/${scheduleId}`,
@@ -2143,18 +2233,20 @@ var CalendarsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Delete a calendar schedule. */
   async deleteCalendarSchedule(wid, calendarId, scheduleId) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/schedules/${scheduleId}`, {
       method: "DELETE"
     });
   }
-  // Availability
+  /** Check availability for a time range on a calendar. */
   async checkAvailability(wid, calendarId, check) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/availability`, {
       method: "POST",
       body: JSON.stringify(check)
     });
   }
+  /** Get available booking slots for a calendar within a date range. */
   async getAvailableSlots(wid, calendarId, request) {
     return this.fetch(
       `w/${wid}/calendars/${calendarId}/available-slots`,
@@ -2164,7 +2256,7 @@ var CalendarsApi = class extends BaseApiClient {
       }
     );
   }
-  // Calendar Events
+  /** List calendar events with optional filtering by date range, status, and member. */
   async getCalendarEvents(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.calendarId) params.append("calendarId", options.calendarId.toString());
@@ -2178,70 +2270,80 @@ var CalendarsApi = class extends BaseApiClient {
       `w/${wid}/calendar-events${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single calendar event by ID. */
   async getCalendarEvent(wid, eventId) {
     return this.fetch(`w/${wid}/calendar-events/${eventId}`);
   }
+  /** Create a new calendar event. */
   async createCalendarEvent(wid, event) {
     return this.fetch(`w/${wid}/calendar-events`, {
       method: "POST",
       body: JSON.stringify(event)
     });
   }
+  /** Update an existing calendar event. */
   async updateCalendarEvent(wid, eventId, event) {
     return this.fetch(`w/${wid}/calendar-events/${eventId}`, {
       method: "PUT",
       body: JSON.stringify(event)
     });
   }
+  /** Cancel a calendar event with an optional reason. */
   async cancelCalendarEvent(wid, eventId, reason) {
     return this.fetch(`w/${wid}/calendar-events/${eventId}/cancel`, {
       method: "POST",
       body: JSON.stringify({ cancellationReason: reason })
     });
   }
+  /** Delete a calendar event by ID. */
   async deleteCalendarEvent(wid, eventId) {
     return this.fetch(`w/${wid}/calendar-events/${eventId}`, {
       method: "DELETE"
     });
   }
-  // Event attendees
+  /** Update an attendee's details on a calendar event. */
   async updateEventAttendee(wid, eventId, attendeeId, update) {
     return this.fetch(`w/${wid}/calendar-events/${eventId}/attendees/${attendeeId}`, {
       method: "PUT",
       body: JSON.stringify(update)
     });
   }
-  // Event Types
+  /** List all calendar event types in the workspace. */
   async getEventTypes(wid) {
     return this.fetch(`w/${wid}/calendar-event-types`);
   }
+  /** Get a single calendar event type by ID. */
   async getEventType(wid, id) {
     return this.fetch(`w/${wid}/calendar-event-types/${id}`);
   }
+  /** Create a new calendar event type. */
   async createEventType(wid, eventType) {
     return this.fetch(`w/${wid}/calendar-event-types`, {
       method: "POST",
       body: JSON.stringify(eventType)
     });
   }
+  /** Update an existing calendar event type. */
   async updateEventType(wid, id, eventType) {
     return this.fetch(`w/${wid}/calendar-event-types/${id}`, {
       method: "PUT",
       body: JSON.stringify(eventType)
     });
   }
+  /** Delete a calendar event type by ID. */
   async deleteEventType(wid, id) {
     return this.fetch(`w/${wid}/calendar-event-types/${id}`, {
       method: "DELETE"
     });
   }
-  // iCal Feed Management
+  /** Generate or regenerate an iCal feed token for a calendar. */
   async generateICalToken(wid, calendarId, regenerate = false) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/ical-token`, {
       method: "POST",
       body: JSON.stringify({ regenerate })
     });
   }
+  /** Revoke the iCal feed token for a calendar, disabling external feed access. */
   async revokeICalToken(wid, calendarId) {
     return this.fetch(
       `w/${wid}/calendars/${calendarId}/ical-token`,
@@ -2250,29 +2352,34 @@ var CalendarsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Get the iCal feed URL for a calendar. */
   async getICalFeedUrl(wid, calendarId) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/ical-url`);
   }
-  // Google Calendar Integration
+  /** List Google Calendars available for linking. */
   async listGoogleCalendars(wid) {
     return this.fetch(`w/${wid}/calendars/google/list`);
   }
+  /** Get the Google Calendar integration status for the workspace. */
   async getGoogleCalendarStatus(wid) {
     return this.fetch(
       `w/${wid}/calendars/google/status`
     );
   }
+  /** Link a calendar to a Google Calendar for two-way sync. */
   async linkCalendarToGoogle(wid, calendarId, request) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/google/link`, {
       method: "POST",
       body: JSON.stringify(request)
     });
   }
+  /** Unlink a calendar from its connected Google Calendar. */
   async unlinkCalendarFromGoogle(wid, calendarId) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/google/link`, {
       method: "DELETE"
     });
   }
+  /** Trigger a manual sync between a calendar and its linked Google Calendar. */
   async syncCalendarWithGoogle(wid, calendarId) {
     return this.fetch(`w/${wid}/calendars/${calendarId}/google/sync`, {
       method: "POST"
@@ -2280,15 +2387,18 @@ var CalendarsApi = class extends BaseApiClient {
   }
 };
 var CallsApi = class extends BaseApiClient {
+  /** Initiate a new outbound call. */
   async initiateCall(wid, request) {
     return this.fetch(`w/${wid}/call`, {
       method: "POST",
       body: JSON.stringify(request)
     });
   }
+  /** Get a voice authentication token for real-time audio. */
   async getVoiceToken(wid) {
     return this.fetch(`w/${wid}/voice/token`);
   }
+  /** Get message timing data for a chat recording. */
   async getMessageTiming(wid, chatId) {
     return this.fetch(`w/${wid}/recordings/chat/${chatId}/message-timing`);
   }
@@ -2326,6 +2436,7 @@ var ChatsApi = class extends BaseApiClient {
     }
     return params;
   }
+  /** List chats with optional filtering, sorting, and pagination. */
   async getChats(wid, options = {}) {
     const params = this.buildChatsQueryParams(options, true);
     const queryString = params.toString();
@@ -2333,6 +2444,7 @@ var ChatsApi = class extends BaseApiClient {
       `w/${wid}/chats${queryString ? `?${queryString}` : ""}`
     );
   }
+  /** Export multiple chats as a downloadable blob. */
   async exportChats(wid, options = {}) {
     const params = this.buildChatsQueryParams(options, false);
     const queryString = params.toString();
@@ -2341,27 +2453,34 @@ var ChatsApi = class extends BaseApiClient {
     );
     return response.blob();
   }
+  /** Export a single chat in the specified format as a downloadable blob. */
   async exportChat(wid, chatId, format = "jsonl") {
     const response = await this.fetchRaw(`w/${wid}/chats/${chatId}/export?format=${format}`);
     return response.blob();
   }
+  /** Get a single chat by ID. */
   async getChat(wid, id) {
     return this.fetch(`w/${wid}/chats/${id}`);
   }
+  /** Get token usage statistics for a chat. */
   async getChatTokenUsage(wid, chatId) {
     return this.fetch(`w/${wid}/chats/${chatId}/token-usage`);
   }
+  /** Get todo items extracted from a chat. */
   async getChatTodos(wid, chatId) {
     return this.fetch(`w/${wid}/chats/${chatId}/todos`);
   }
+  /** Get loaded and revealed skills for a chat. */
   async getChatSkills(wid, chatId) {
     return this.fetch(
       `w/${wid}/chats/${chatId}/skills`
     );
   }
+  /** List chat IDs that need a response. */
   async getChatsNeedsResponse(wid) {
     return this.fetch(`w/${wid}/chats/needs-response`);
   }
+  /** Get daily chat creation statistics with optional filtering. */
   async getChatsDailyCreationStats(wid, options) {
     const params = new URLSearchParams();
     if (options?.archived !== void 0) params.append("archived", options.archived.toString());
@@ -2371,40 +2490,47 @@ var ChatsApi = class extends BaseApiClient {
       `w/${wid}/chats/stats/daily-creation${queryString ? `?${queryString}` : ""}`
     );
   }
+  /** Archive a chat. */
   async archiveChat(wid, id) {
     return this.fetch(`w/${wid}/chats/${id}/archive`, {
       method: "PUT"
     });
   }
+  /** Unarchive a chat. */
   async unarchiveChat(wid, id) {
     return this.fetch(`w/${wid}/chats/${id}/unarchive`, {
       method: "PUT"
     });
   }
+  /** Create a new chat. */
   async createChat(wid, chat) {
     return this.fetch(`w/${wid}/chats`, {
       method: "POST",
       body: JSON.stringify(chat)
     });
   }
+  /** Delete a chat, optionally providing a reason. */
   async deleteChat(wid, id, reason) {
     return this.fetch(`w/${wid}/chats/${id}`, {
       method: "DELETE",
       body: reason ? JSON.stringify({ reason }) : void 0
     });
   }
+  /** Update a chat's properties. */
   async updateChat(wid, id, chat) {
     return this.fetch(`w/${wid}/chats/${id}`, {
       method: "PUT",
       body: JSON.stringify(chat)
     });
   }
+  /** Update the mute status of a chat. */
   async updateChatMute(wid, id, muted) {
     return this.fetch(`w/${wid}/chats/${id}/mute`, {
       method: "PUT",
       body: JSON.stringify({ muted })
     });
   }
+  /** Update the needs-response flag on a chat. */
   async updateChatNeedsResponse(wid, id, needsResponse) {
     return this.fetch(
       `w/${wid}/chats/${id}/needs-response`,
@@ -2414,6 +2540,7 @@ var ChatsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Generate an AI summary for a chat, optionally updating its labels. */
   async summarizeChat(wid, id, updateLabels) {
     const params = new URLSearchParams();
     if (updateLabels !== void 0) {
@@ -2426,6 +2553,7 @@ var ChatsApi = class extends BaseApiClient {
       }
     );
   }
+  /** List messages in a chat with optional pagination. */
   async getChatMessages(wid, id, limit, offset) {
     const params = new URLSearchParams();
     if (limit) params.append("limit", limit.toString());
@@ -2434,6 +2562,7 @@ var ChatsApi = class extends BaseApiClient {
       `w/${wid}/chats/${id}/messages${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** List messages associated with a specific tool call in a chat. */
   async getChatToolCallMessages(wid, chatId, callId, limit = 100, offset = 0) {
     const params = new URLSearchParams();
     params.append("limit", limit.toString());
@@ -2442,15 +2571,18 @@ var ChatsApi = class extends BaseApiClient {
       `w/${wid}/chats/${chatId}/tool-calls/${callId}/messages?${params.toString()}`
     );
   }
+  /** Get the tools available in a chat. */
   async getChatTools(wid, chatId) {
     return this.fetch(`w/${wid}/chats/${chatId}/tools`);
   }
+  /** Initiate an outbound phone call from a chat. */
   async initiateOutboundCall(wid, chatId, phoneNumberId) {
     return this.fetch(`w/${wid}/chats/${chatId}/outbound-call`, {
       method: "POST",
       body: JSON.stringify({ phoneNumberId, chatId })
     });
   }
+  /** Send a message as the assistant in a chat, optionally including tool calls. */
   async sendAssistantMessage(wid, chatId, message, toolCalls) {
     return this.fetch(`w/${wid}/chats/${chatId}/send-assistant-message`, {
       method: "POST",
@@ -2460,6 +2592,7 @@ var ChatsApi = class extends BaseApiClient {
       })
     });
   }
+  /** Rate a chat message by its UUID. */
   async rateMessage(wid, chatId, messageUuid, rating) {
     return this.fetch(
       `w/${wid}/chats/${chatId}/messages/${messageUuid}/rate`,
@@ -2488,10 +2621,11 @@ var ChatsApi = class extends BaseApiClient {
       body: JSON.stringify({ content })
     });
   }
+  /** Get assignment tasks linked to a chat. */
   async getChatAssignmentTasks(wid, chatId) {
     return this.fetch(`w/${wid}/chats/${chatId}/assignment-tasks`);
   }
-  // Chat Completion API (used by eval scripts)
+  /** Create a chat completion using the OpenAI-compatible API (used by eval scripts). */
   async createChatCompletion(wid, chatId, data) {
     return this.fetch(`w/${wid}/web-chat/${chatId}/chat/completions?stream=false`, {
       method: "POST",
@@ -2501,55 +2635,65 @@ var ChatsApi = class extends BaseApiClient {
       })
     });
   }
-  // Chat Labels API
+  /** List all chat labels in a workspace. */
   async getChatLabels(wid) {
     return this.fetch(`w/${wid}/chat-labels`);
   }
+  /** Get a chat label by ID. */
   async getChatLabel(wid, id) {
     return this.fetch(`w/${wid}/chat-labels/${id}`);
   }
+  /** Get a chat label by UUID. */
   async getChatLabelByUuid(wid, uuid) {
     return this.fetch(`w/${wid}/chat-labels/${uuid}`);
   }
+  /** Create a new chat label. */
   async createChatLabel(wid, label) {
     return this.fetch(`w/${wid}/chat-labels`, {
       method: "POST",
       body: JSON.stringify(label)
     });
   }
+  /** Update a chat label. */
   async updateChatLabel(wid, id, label) {
     return this.fetch(`w/${wid}/chat-labels/${id}`, {
       method: "PUT",
       body: JSON.stringify(label)
     });
   }
+  /** Delete a chat label. */
   async deleteChatLabel(wid, id) {
     return this.fetch(`w/${wid}/chat-labels/${id}`, {
       method: "DELETE"
     });
   }
-  // Chat Filters
+  /** List all chat filters in a workspace. */
   async getChatFilters(wid) {
     return this.fetch(`w/${wid}/chat-filters`);
   }
+  /** Get a chat filter by ID. */
   async getChatFilter(wid, id) {
     return this.fetch(`w/${wid}/chat-filters/${id}`);
   }
+  /** Get a chat filter by UUID. */
   async getChatFilterByUuid(wid, uuid) {
     return this.fetch(`w/${wid}/chat-filters/by-uuid/${uuid}`);
   }
+  /** Create a new chat filter. */
   async createChatFilter(wid, filter) {
     return this.fetch(`w/${wid}/chat-filters`, {
       method: "POST",
       body: JSON.stringify(filter)
     });
   }
+  /** Update a chat filter. */
   async updateChatFilter(wid, id, filter) {
     return this.fetch(`w/${wid}/chat-filters/${id}`, {
       method: "PUT",
       body: JSON.stringify(filter)
     });
   }
+  /** Delete a chat filter. */
   async deleteChatFilter(wid, id) {
     return this.fetch(`w/${wid}/chat-filters/${id}`, {
       method: "DELETE"
@@ -2642,6 +2786,7 @@ var CustomToolkitsApi = class extends BaseApiClient {
   }
 };
 var DataTypesApi = class extends BaseApiClient {
+  /** List all data types for a workspace, optionally filtering by archived status. */
   async getDataTypes(wid, options) {
     const params = new URLSearchParams();
     if (options?.archived !== void 0) {
@@ -2650,45 +2795,54 @@ var DataTypesApi = class extends BaseApiClient {
     const queryString = params.toString();
     return this.fetch(`w/${wid}/data-types${queryString ? `?${queryString}` : ""}`);
   }
+  /** Get a single data type by ID. */
   async getDataType(wid, id) {
     return this.fetch(`w/${wid}/data-types/${id}`);
   }
+  /** Get a single data type by its slug. */
   async getDataTypeBySlug(wid, slug) {
     return this.fetch(`w/${wid}/data-types/slug/${slug}`);
   }
+  /** Create a new data type definition in the workspace. */
   async createDataType(wid, dataType) {
     return this.fetch(`w/${wid}/data-types`, {
       method: "POST",
       body: JSON.stringify(dataType)
     });
   }
+  /** Update an existing data type definition. */
   async updateDataType(wid, id, dataType) {
     return this.fetch(`w/${wid}/data-types/${id}`, {
       method: "PUT",
       body: JSON.stringify(dataType)
     });
   }
+  /** Delete a data type definition by ID. */
   async deleteDataType(wid, id) {
     return this.fetch(`w/${wid}/data-types/${id}`, {
       method: "DELETE"
     });
   }
+  /** Archive a data type, hiding it from default listings. */
   async archiveDataType(wid, id) {
     return this.fetch(`w/${wid}/data-types/${id}/archive`, {
       method: "POST"
     });
   }
+  /** Restore an archived data type back to active status. */
   async unarchiveDataType(wid, id) {
     return this.fetch(`w/${wid}/data-types/${id}/unarchive`, {
       method: "POST"
     });
   }
+  /** Clone a data type with a new name and slug. */
   async cloneDataType(wid, id, data) {
     return this.fetch(`w/${wid}/data-types/${id}/clone`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** List data records for a data type with optional filtering and pagination. */
   async getDataRecords(wid, dataTypeId, options) {
     const params = new URLSearchParams();
     if (options?.memberId) params.append("member_id", options.memberId.toString());
@@ -2700,32 +2854,37 @@ var DataTypesApi = class extends BaseApiClient {
       `w/${wid}/data-types/${dataTypeId}/records${params?.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single data record by ID. */
   async getDataRecord(wid, recordId) {
     return this.fetch(`w/${wid}/data-types/records/${recordId}`);
   }
+  /** Create a new data record under the specified data type. */
   async createDataRecord(wid, dataTypeId, record) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/records`, {
       method: "POST",
       body: JSON.stringify(record)
     });
   }
+  /** Update an existing data record's field values. */
   async updateDataRecord(wid, dataTypeId, recordId, record) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/records/${recordId}`, {
       method: "PUT",
       body: JSON.stringify(record)
     });
   }
+  /** Delete a data record by ID. */
   async deleteDataRecord(wid, dataTypeId, recordId) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/records/${recordId}`, {
       method: "DELETE"
     });
   }
+  /** Get the change history for a data record. */
   async getDataRecordChanges(wid, dataTypeId, recordId) {
     return this.fetch(
       `w/${wid}/data-types/${dataTypeId}/records/${recordId}/changes`
     );
   }
-  // Upsert Data Record API (used by eval scripts)
+  /** Upsert a data record by external ID, creating or updating as needed. */
   async upsertDataRecord(wid, dataTypeId, externalId, data) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/upsert/${externalId}`, {
       method: "POST",
@@ -2735,14 +2894,14 @@ var DataTypesApi = class extends BaseApiClient {
       })
     });
   }
-  // Toggle field indexing for faster search
+  /** Toggle search indexing for a data type field. */
   async toggleFieldIndex(wid, dataTypeId, fieldSlug, shouldIndex) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/fields/${fieldSlug}/toggle-index`, {
       method: "POST",
       body: JSON.stringify({ shouldIndex })
     });
   }
-  // Get field index status
+  /** Get the index status for a data type field. */
   async getFieldIndexStatus(wid, dataTypeId, fieldSlug) {
     return this.fetch(`w/${wid}/data-types/${dataTypeId}/fields/${fieldSlug}/index-status`);
   }
@@ -2967,13 +3126,15 @@ var SlackAppsApi = class extends BaseApiClient {
   }
 };
 var EventsApi = class extends BaseApiClient {
-  // Event Rules API
+  /** List all event rules in the workspace. */
   async getEventRules(wid) {
     return this.fetch(`w/${wid}/event-rules`);
   }
+  /** Get the available action types that can be used in event rules. */
   async getAvailableActions(wid) {
     return this.fetch(`w/${wid}/event-rules/actions/available`);
   }
+  /** Search event rules by object type, event type, action type, and related entities. */
   async searchEventRules(wid, params) {
     const searchParams = new URLSearchParams();
     if (params.objectType) searchParams.append("objectType", params.objectType);
@@ -2987,33 +3148,38 @@ var EventsApi = class extends BaseApiClient {
     if (params.includeDisabled) searchParams.append("includeDisabled", "true");
     return this.fetch(`w/${wid}/event-rules/search?${searchParams.toString()}`);
   }
+  /** Get a single event rule by ID. */
   async getEventRule(wid, id) {
     return this.fetch(`w/${wid}/event-rules/${id}`);
   }
+  /** Create a new event rule in the workspace. */
   async createEventRule(wid, rule) {
     return this.fetch(`w/${wid}/event-rules`, {
       method: "POST",
       body: JSON.stringify(rule)
     });
   }
+  /** Update an existing event rule. */
   async updateEventRule(wid, id, rule) {
     return this.fetch(`w/${wid}/event-rules/${id}`, {
       method: "PUT",
       body: JSON.stringify(rule)
     });
   }
+  /** Delete an event rule by ID. */
   async deleteEventRule(wid, id) {
     return this.fetch(`w/${wid}/event-rules/${id}`, {
       method: "DELETE"
     });
   }
+  /** Reorder event rules by specifying the desired rule ID sequence. */
   async reorderEventRules(wid, ruleIds) {
     return this.fetch(`w/${wid}/event-rules/reorder`, {
       method: "POST",
       body: JSON.stringify(ruleIds)
     });
   }
-  // Webhook Logs API
+  /** List webhook logs with optional filtering by event type and success status. */
   async getWebhookLogs(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -3026,6 +3192,7 @@ var EventsApi = class extends BaseApiClient {
       `w/${wid}/webhook-logs${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** List event rule executions with cursor-based pagination and filtering. */
   async getRuleExecutions(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.cursor) params.append("cursor", options.cursor);
@@ -3044,7 +3211,7 @@ var EventsApi = class extends BaseApiClient {
       `w/${wid}/event-rules/executions${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
-  // Events API
+  /** List scheduled events with optional pagination and active status filtering. */
   async getEvents(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -3056,26 +3223,31 @@ var EventsApi = class extends BaseApiClient {
       `w/${wid}/events${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single scheduled event by ID. */
   async getEvent(wid, id) {
     return this.fetch(`w/${wid}/events/${id}`);
   }
+  /** Create a new scheduled event. */
   async createEvent(wid, event) {
     return this.fetch(`w/${wid}/events`, {
       method: "POST",
       body: JSON.stringify(event)
     });
   }
+  /** Update an existing scheduled event. */
   async updateEvent(wid, id, event) {
     return this.fetch(`w/${wid}/events/${id}`, {
       method: "PUT",
       body: JSON.stringify(event)
     });
   }
+  /** Delete a scheduled event by ID. */
   async deleteEvent(wid, id) {
     return this.fetch(`w/${wid}/events/${id}`, {
       method: "DELETE"
     });
   }
+  /** Manually trigger a scheduled event for a specific member or member filter. */
   async runEvent(wid, id, params) {
     const searchParams = new URLSearchParams();
     if (params.memberId) searchParams.append("member_id", params.memberId.toString());
@@ -3085,6 +3257,7 @@ var EventsApi = class extends BaseApiClient {
       method: "POST"
     });
   }
+  /** List event run history with optional filtering by event and status. */
   async getEventRuns(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -3095,6 +3268,7 @@ var EventsApi = class extends BaseApiClient {
     if (options.status) params.append("status", options.status);
     return this.fetch(`w/${wid}/events/runs?${params.toString()}`);
   }
+  /** Delete all run history for a scheduled event. */
   async resetEventRuns(wid, eventId) {
     return this.fetch(`w/${wid}/events/${eventId}/runs`, {
       method: "DELETE"
@@ -3103,24 +3277,13 @@ var EventsApi = class extends BaseApiClient {
 };
 var FeaturesApi = class extends BaseApiClient {
   /**
-   * Get the full feature registry with all metadata.
-   *
-   * Returns all feature definitions including:
-   * - Dependencies between features
-   * - Visibility settings for upgrade prompts
-   * - Associated abilities, tools, routes, and event types
-   * - UI configuration (icons, sidebar groups)
-   *
-   * @returns Feature registry response with all feature definitions
+   * Get the full feature registry with all metadata
    */
   async getFeatureRegistry() {
     return this.fetch("features/registry");
   }
   /**
-   * Get a specific feature definition by slug.
-   *
-   * @param slug - The feature slug (e.g., "calendar", "gmail")
-   * @returns The full feature definition
+   * Get a specific feature definition by slug
    */
   async getFeatureBySlug(slug) {
     return this.fetch(`features/${slug}`);
@@ -3260,6 +3423,7 @@ var FhirConnectionsApi = class extends BaseApiClient {
   }
 };
 var FilesApi = class extends BaseApiClient {
+  /** List files in a workspace with optional folder filtering, sorting, and search. */
   async getFiles(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.folderId) params.append("folder_id", options.folderId.toString());
@@ -3272,9 +3436,11 @@ var FilesApi = class extends BaseApiClient {
       `w/${wid}/files${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single file by ID. */
   async getFile(wid, id) {
     return this.fetch(`w/${wid}/files/${id}`);
   }
+  /** Create a new file record in the workspace. */
   async createFile(wid, file) {
     return this.fetch(`w/${wid}/files`, {
       method: "POST",
@@ -3282,6 +3448,7 @@ var FilesApi = class extends BaseApiClient {
       body: JSON.stringify(file)
     });
   }
+  /** Update an existing file's metadata. */
   async updateFile(wid, id, file) {
     return this.fetch(`w/${wid}/files/${id}`, {
       method: "PUT",
@@ -3289,11 +3456,13 @@ var FilesApi = class extends BaseApiClient {
       body: JSON.stringify(file)
     });
   }
+  /** Delete a file by ID. */
   async deleteFile(wid, id) {
     return this.fetch(`w/${wid}/files/${id}`, {
       method: "DELETE"
     });
   }
+  /** Convert a file to the specified format (text, markdown, or PDF). */
   async convertFile(wid, fileId, format = "pdf") {
     return this.fetch(
       `w/${wid}/files/${fileId}/convert?format=${format}`,
@@ -3302,6 +3471,7 @@ var FilesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Generate a pre-signed upload URL for uploading file content. */
   async generateFileUploadUrl(wid, request) {
     return this.fetch(`w/${wid}/files/upload-url`, {
       method: "POST",
@@ -3309,7 +3479,7 @@ var FilesApi = class extends BaseApiClient {
       body: JSON.stringify(request)
     });
   }
-  // Directories API
+  /** List folders in a workspace, optionally filtered by parent folder. */
   async getFolders(wid, parentId) {
     const params = new URLSearchParams();
     if (parentId) params.append("parent_id", parentId.toString());
@@ -3317,31 +3487,37 @@ var FilesApi = class extends BaseApiClient {
       `w/${wid}/folders${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single folder by ID. */
   async getFolder(wid, id) {
     return this.fetch(`w/${wid}/folders/${id}`);
   }
+  /** Create a new folder in the workspace. */
   async createFolder(wid, directory) {
     return this.fetch(`w/${wid}/folders`, {
       method: "POST",
       body: JSON.stringify(directory)
     });
   }
+  /** Update a folder's properties. */
   async updateFolder(wid, id, directory) {
     return this.fetch(`w/${wid}/folders/${id}`, {
       method: "PUT",
       body: JSON.stringify(directory)
     });
   }
+  /** Delete a folder by ID. */
   async deleteFolder(wid, id) {
     return this.fetch(`w/${wid}/folders/${id}`, {
       method: "DELETE"
     });
   }
+  /** Trigger reindexing of a folder's contents for search. */
   async reindexFolder(wid, id) {
     return this.fetch(`w/${wid}/folders/${id}/reindex`, {
       method: "POST"
     });
   }
+  /** Search for content within a folder using semantic search. */
   async searchFolder(wid, id, params) {
     const searchParams = new URLSearchParams();
     searchParams.append("query", params.query);
@@ -3350,52 +3526,60 @@ var FilesApi = class extends BaseApiClient {
       `w/${wid}/folders/${id}/search?${searchParams.toString()}`
     );
   }
-  // File Labels API
+  /** List all file labels in the workspace. */
   async getFileLabels(wid) {
     return this.fetch(`w/${wid}/file-labels`);
   }
+  /** Get a single file label by ID. */
   async getFileLabel(wid, id) {
     return this.fetch(`w/${wid}/file-labels/${id}`);
   }
+  /** Get a single file label by UUID. */
   async getFileLabelByUuid(wid, uuid) {
     return this.fetch(`w/${wid}/file-labels/${uuid}`);
   }
+  /** Create a new file label in the workspace. */
   async createFileLabel(wid, label) {
     return this.fetch(`w/${wid}/file-labels`, {
       method: "POST",
       body: JSON.stringify(label)
     });
   }
+  /** Update a file label's properties. */
   async updateFileLabel(wid, id, label) {
     return this.fetch(`w/${wid}/file-labels/${id}`, {
       method: "PUT",
       body: JSON.stringify(label)
     });
   }
+  /** Delete a file label by ID. */
   async deleteFileLabel(wid, id) {
     return this.fetch(`w/${wid}/file-labels/${id}`, {
       method: "DELETE"
     });
   }
-  // File Sharing API
+  /** Get sharing settings for a file. */
   async getFileSharing(wid, fileId) {
     return this.fetch(`w/${wid}/files/${fileId}/sharing`);
   }
+  /** Update the role associations for a file's sharing permissions. */
   async updateFileRoles(wid, fileId, data) {
     return this.fetch(`w/${wid}/files/${fileId}/sharing/roles`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Remove a role's access to a file. */
   async removeFileRole(wid, fileId, roleId) {
     return this.fetch(`w/${wid}/files/${fileId}/sharing/roles/${roleId}`, {
       method: "DELETE"
     });
   }
-  // Folder Sharing API
+  /** Get sharing settings for a folder. */
   async getFolderSharing(wid, folderId) {
     return this.fetch(`w/${wid}/folders/${folderId}/sharing`);
   }
+  /** Update the role associations for a folder's sharing permissions. */
   async updateFolderRoles(wid, folderId, data) {
     return this.fetch(
       `w/${wid}/folders/${folderId}/sharing/roles`,
@@ -3405,33 +3589,37 @@ var FilesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Remove a role's access to a folder. */
   async removeFolderRole(wid, folderId, roleId) {
     return this.fetch(`w/${wid}/folders/${folderId}/sharing/roles/${roleId}`, {
       method: "DELETE"
     });
   }
-  // Batch Sharing API
+  /** Update all sharing settings for a file in a single request. */
   async updateFileSharing(wid, fileId, data) {
     return this.fetch(`w/${wid}/files/${fileId}/sharing`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Update all sharing settings for a folder in a single request. */
   async updateFolderSharing(wid, folderId, data) {
     return this.fetch(`w/${wid}/folders/${folderId}/sharing`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
-  // Public Sharing API (unauthenticated access to public files/folders)
+  /** Get metadata for a publicly shared file (unauthenticated). */
   async getPublicFile(wid, fileId) {
     return this.fetch(`w/${wid}/sharing/files/${fileId}`);
   }
+  /** Get contents of a publicly shared folder (unauthenticated). */
   async getPublicFolder(wid, folderId, page = 1, pageSize = 100) {
     return this.fetch(
       `w/${wid}/sharing/folders/${folderId}?page=${page}&pageSize=${pageSize}`
     );
   }
+  /** List files within a publicly shared folder (unauthenticated). */
   async getPublicFolderFiles(wid, folderId, page = 1, pageSize = 100) {
     return this.fetch(
       `w/${wid}/sharing/folders/${folderId}/files?page=${page}&pageSize=${pageSize}`
@@ -3439,29 +3627,35 @@ var FilesApi = class extends BaseApiClient {
   }
 };
 var InboxesApi = class extends BaseApiClient {
+  /** List all inboxes in a workspace. */
   async getInboxes(wid) {
     return this.fetch(`w/${wid}/inboxes`);
   }
+  /** Get an inbox by ID. */
   async getInbox(wid, id) {
     return this.fetch(`w/${wid}/inboxes/${id}`);
   }
+  /** Create a new inbox. */
   async createInbox(wid, inbox) {
     return this.fetch(`w/${wid}/inboxes`, {
       method: "POST",
       body: JSON.stringify(inbox)
     });
   }
+  /** Update an inbox. */
   async updateInbox(wid, id, inbox) {
     return this.fetch(`w/${wid}/inboxes/${id}`, {
       method: "PUT",
       body: JSON.stringify(inbox)
     });
   }
+  /** Delete an inbox. */
   async deleteInbox(wid, id) {
     return this.fetch(`w/${wid}/inboxes/${id}`, {
       method: "DELETE"
     });
   }
+  /** List emails in an inbox with optional pagination and attachment inclusion. */
   async getInboxEmails(wid, inboxId, options = {}) {
     const params = new URLSearchParams();
     if (options.limit) params.append("limit", options.limit.toString());
@@ -3472,19 +3666,23 @@ var InboxesApi = class extends BaseApiClient {
       `w/${wid}/inboxes/${inboxId}/emails${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single email from an inbox. */
   async getInboxEmail(wid, inboxId, emailId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/emails/${emailId}`);
   }
+  /** Mark an email as read. */
   async markEmailAsRead(wid, inboxId, emailId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/emails/${emailId}/mark-read`, {
       method: "POST"
     });
   }
+  /** Mark an email as unread. */
   async markEmailAsUnread(wid, inboxId, emailId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/emails/${emailId}/unread`, {
       method: "POST"
     });
   }
+  /** Convert an email to text, markdown, or PDF format. */
   async convertEmail(wid, emailId, format = "pdf") {
     return this.fetch(
       `w/${wid}/inboxes/emails/${emailId}/convert?format=${format}`,
@@ -3493,18 +3691,22 @@ var InboxesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Download an email attachment as raw bytes. */
   async downloadEmailAttachment(wid, inboxId, emailId, attachmentId) {
     const response = await this.fetchRaw(
       `w/${wid}/inboxes/${inboxId}/emails/${emailId}/attachments/${attachmentId}`
     );
     return response.arrayBuffer();
   }
+  /** List email threads in an inbox. */
   async getInboxThreads(wid, inboxId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/threads`);
   }
+  /** List emails in a thread by assignment ID. */
   async getThreadEmails(wid, inboxId, assignmentId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/assignments/${assignmentId}/emails`);
   }
+  /** List emails associated with a chat. */
   async getChatEmails(wid, inboxId, chatId) {
     return this.fetch(`w/${wid}/inboxes/${inboxId}/chats/${chatId}/emails`);
   }
@@ -3555,9 +3757,7 @@ var InquiriesApi = class extends BaseApiClient {
     });
   }
   /**
-   * Export inquiries to CSV (superuser only)
-   * @param statusFilter Optional status filter: 'new', 'in_progress', 'done', or undefined for all
-   * @returns A Blob containing the CSV data
+   * Export inquiries to CSV with optional status filtering (superuser only)
    */
   async exportInquiriesCsv(statusFilter) {
     const params = new URLSearchParams();
@@ -3744,6 +3944,7 @@ var McpServersApi = class extends BaseApiClient {
   }
 };
 var MembersApi = class extends BaseApiClient {
+  /** Get the currently authenticated member for a workspace. */
   async getCurrentMember(wid) {
     return this.fetch(`w/${wid}/me`);
   }
@@ -3774,12 +3975,14 @@ var MembersApi = class extends BaseApiClient {
       method: "DELETE"
     });
   }
+  /** Update the currently authenticated member's profile. */
   async updateCurrentMember(wid, member) {
     return this.fetch(`w/${wid}/me`, {
       method: "PUT",
       body: JSON.stringify(member)
     });
   }
+  /** List workspace members with pagination, filtering, and sorting. */
   async getWorkspaceMembers(wid, page = 1, pageSize = 10, filters, search, role, sortBy, sortOrder, memberType, isArchived = false, isManager, memberTypes, hasAccount, excludeIds) {
     const params = new URLSearchParams();
     if (page) params.append("page", page.toString());
@@ -3812,21 +4015,25 @@ var MembersApi = class extends BaseApiClient {
     }
     return this.fetch(`w/${wid}/members?${params.toString()}`);
   }
+  /** Get a single workspace member by ID. */
   async getWorkspaceMember(wid, memberId) {
     return this.fetch(`w/${wid}/members/${memberId}`);
   }
+  /** Create a new workspace member. */
   async createWorkspaceMember(wid, data) {
     return this.fetch(`w/${wid}/members`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update a workspace member by ID. */
   async updateMember(wid, memberId, data) {
     return this.fetch(`w/${wid}/members/${memberId}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete a workspace member, optionally forcing removal of associated data. */
   async deleteMember(wid, memberId, options) {
     const params = new URLSearchParams();
     if (options?.force) {
@@ -3838,98 +4045,119 @@ var MembersApi = class extends BaseApiClient {
       method: "DELETE"
     });
   }
+  /** Archive a workspace member. */
   async archiveMember(wid, memberId) {
     return this.fetch(`w/${wid}/members/${memberId}/archive`, {
       method: "POST"
     });
   }
+  /** Unarchive a previously archived workspace member. */
   async unarchiveMember(wid, memberId) {
     return this.fetch(`w/${wid}/members/${memberId}/unarchive`, {
       method: "POST"
     });
   }
   // Member Filter APIs
+  /** List all saved member filters for a workspace. */
   async getMemberFilters(wid) {
     return this.fetch(`w/${wid}/member-filters`);
   }
+  /** Get a single member filter by ID. */
   async getMemberFilter(wid, filterId) {
     return this.fetch(`w/${wid}/member-filters/${filterId}`);
   }
+  /** Create a new saved member filter. */
   async createMemberFilter(wid, data) {
     return this.fetch(`w/${wid}/member-filters`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update a saved member filter. */
   async updateMemberFilter(wid, filterId, data) {
     return this.fetch(`w/${wid}/member-filters/${filterId}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete a saved member filter. */
   async deleteMemberFilter(wid, filterId) {
     return this.fetch(`w/${wid}/member-filters/${filterId}`, {
       method: "DELETE"
     });
   }
+  /** Get the count of members matching a saved filter. */
   async getMemberFilterCount(wid, filterId) {
     return this.fetch(`w/${wid}/member-filters/${filterId}/count`);
   }
   // Member Labels API
+  /** List all member labels for a workspace. */
   async getMemberLabels(wid) {
     return this.fetch(`w/${wid}/member-labels`);
   }
+  /** Get a single member label by ID. */
   async getMemberLabel(wid, id) {
     return this.fetch(`w/${wid}/member-labels/${id}`);
   }
+  /** Get a single member label by UUID. */
   async getMemberLabelByUuid(wid, uuid) {
     return this.fetch(`w/${wid}/member-labels/${uuid}`);
   }
+  /** Create a new member label. */
   async createMemberLabel(wid, label) {
     return this.fetch(`w/${wid}/member-labels`, {
       method: "POST",
       body: JSON.stringify(label)
     });
   }
+  /** Update a member label. */
   async updateMemberLabel(wid, id, label) {
     return this.fetch(`w/${wid}/member-labels/${id}`, {
       method: "PUT",
       body: JSON.stringify(label)
     });
   }
+  /** Delete a member label. */
   async deleteMemberLabel(wid, id) {
     return this.fetch(`w/${wid}/member-labels/${id}`, {
       method: "DELETE"
     });
   }
   // Member Roles API
+  /** List all member roles for a workspace. */
   async getMemberRoles(wid) {
     return this.fetch(`w/${wid}/member-roles`);
   }
+  /** Get a single member role by ID. */
   async getMemberRole(wid, id) {
     return this.fetch(`w/${wid}/member-roles/${id}`);
   }
+  /** Get a single member role by UUID. */
   async getMemberRoleByUuid(wid, uuid) {
     return this.fetch(`w/${wid}/member-roles/${uuid}`);
   }
+  /** Create a new member role. */
   async createMemberRole(wid, memberRole) {
     return this.fetch(`w/${wid}/member-roles`, {
       method: "POST",
       body: JSON.stringify(memberRole)
     });
   }
+  /** Update a member role. */
   async updateMemberRole(wid, id, memberRole) {
     return this.fetch(`w/${wid}/member-roles/${id}`, {
       method: "PUT",
       body: JSON.stringify(memberRole)
     });
   }
+  /** Delete a member role. */
   async deleteMemberRole(wid, id) {
     return this.fetch(`w/${wid}/member-roles/${id}`, {
       method: "DELETE"
     });
   }
   // Import/Export Members API
+  /** Import members from a CSV file, streaming progress updates via callback. */
   async importMembers(wid, file, newMemberRoleId, onProgress) {
     const formData = new FormData();
     formData.append("file", file);
@@ -3974,6 +4202,7 @@ var MembersApi = class extends BaseApiClient {
     }
     return { success: true };
   }
+  /** Export members as a downloadable file with selected fields and data types. */
   async exportMembers(wid, selectedFields, selectedDataTypes, memberType) {
     const params = new URLSearchParams();
     selectedFields.forEach((field) => params.append("selected_fields", field));
@@ -3993,6 +4222,7 @@ var MembersApi = class extends BaseApiClient {
     }
     return response.blob();
   }
+  /** Get message activity counts for the specified members over a time period. */
   async getMembersMessageActivity(wid, memberIds, days = 30) {
     const memberIdsStr = memberIds.join(",");
     const params = new URLSearchParams();
@@ -4141,6 +4371,7 @@ var MembersApi = class extends BaseApiClient {
   }
 };
 var MilestonesApi = class extends BaseApiClient {
+  /** List milestones in a workspace with optional pagination and sorting. */
   async getMilestones(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -4151,21 +4382,25 @@ var MilestonesApi = class extends BaseApiClient {
       `w/${wid}/milestones${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single milestone by ID. */
   async getMilestone(wid, id) {
     return this.fetch(`w/${wid}/milestones/${id}`);
   }
+  /** Create a new milestone in a workspace. */
   async createMilestone(wid, milestone) {
     return this.fetch(`w/${wid}/milestones`, {
       method: "POST",
       body: JSON.stringify(milestone)
     });
   }
+  /** Update an existing milestone with partial data. */
   async updateMilestone(wid, id, milestone) {
     return this.fetch(`w/${wid}/milestones/${id}`, {
       method: "PUT",
       body: JSON.stringify(milestone)
     });
   }
+  /** Delete a milestone by ID. */
   async deleteMilestone(wid, id) {
     return this.fetch(`w/${wid}/milestones/${id}`, {
       method: "DELETE"
@@ -4226,21 +4461,25 @@ var MondayIntegrationApi = class extends BaseApiClient {
   }
 };
 var NotificationRulesApi = class extends BaseApiClient {
+  /** List all notification rules in a workspace. */
   async getNotificationRules(wid) {
     return this.fetch(`w/${wid}/notification-rules`);
   }
+  /** Create a new notification rule. */
   async createNotificationRule(wid, rule) {
     return this.fetch(`w/${wid}/notification-rules`, {
       method: "POST",
       body: JSON.stringify(rule)
     });
   }
+  /** Update a notification rule. */
   async updateNotificationRule(wid, ruleId, rule) {
     return this.fetch(`w/${wid}/notification-rules/${ruleId}`, {
       method: "PUT",
       body: JSON.stringify(rule)
     });
   }
+  /** Delete a notification rule. */
   async deleteNotificationRule(wid, ruleId) {
     return this.fetch(`w/${wid}/notification-rules/${ruleId}`, {
       method: "DELETE"
@@ -4248,57 +4487,69 @@ var NotificationRulesApi = class extends BaseApiClient {
   }
 };
 var OperatorApi = class extends BaseApiClient {
+  /** List all operator groups for a workspace. */
   async getOperatorGroups(wid) {
     return this.fetch(`w/${wid}/operator/groups`);
   }
+  /** Get a single operator group by ID. */
   async getOperatorGroup(wid, groupId) {
     return this.fetch(`w/${wid}/operator/groups/${groupId}`);
   }
+  /** Create a new operator group. */
   async createOperatorGroup(wid, data) {
     return this.fetch(`w/${wid}/operator/groups`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update an operator group. */
   async updateOperatorGroup(wid, groupId, data) {
     return this.fetch(`w/${wid}/operator/groups/${groupId}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete an operator group. */
   async deleteOperatorGroup(wid, groupId) {
     return this.fetch(`w/${wid}/operator/groups/${groupId}`, {
       method: "DELETE"
     });
   }
+  /** Add a member to an operator group. */
   async addGroupMember(wid, groupId, data) {
     return this.fetch(`w/${wid}/operator/groups/${groupId}/members`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Remove a member from an operator group. */
   async removeGroupMember(wid, groupId, memberId) {
     return this.fetch(`w/${wid}/operator/groups/${groupId}/members/${memberId}`, {
       method: "DELETE"
     });
   }
+  /** Get all currently live (online) operators in a workspace. */
   async getLiveOperators(wid) {
     return this.fetch(`w/${wid}/presence/live`);
   }
+  /** Get the current member's presence status. */
   async getPresenceStatus(wid) {
     return this.fetch(`w/${wid}/presence/me`);
   }
+  /** Disconnect the current member's presence session. */
   async disconnectPresence(wid) {
     return this.fetch(`w/${wid}/presence/disconnect-self`, {
       method: "POST"
     });
   }
   // Operator chat message methods
+  /** Get paginated chat messages for an operator chat. */
   async getOperatorChatMessages(wid, chatId, limit = 50, offset = 0) {
     return this.fetch(
       `w/${wid}/operator/chats/${chatId}/messages?limit=${limit}&offset=${offset}`
     );
   }
+  /** Send a message in an operator chat. */
   async sendOperatorMessage(wid, chatId, content) {
     return this.fetch(`w/${wid}/operator/chats/${chatId}/messages`, {
       method: "POST",
@@ -4382,45 +4633,54 @@ var OAuthApi = class extends BaseApiClient {
   }
 };
 var PhoneNumbersApi = class extends BaseApiClient {
+  /** List all phone numbers in a workspace. */
   async getPhoneNumbers(wid) {
     return this.fetch(`w/${wid}/phone-numbers`);
   }
+  /** List phone numbers available for provisioning. */
   async getAvailablePhoneNumbers(wid) {
     return this.fetch(
       `w/${wid}/phone-numbers/available-numbers`
     );
   }
+  /** Request provisioning of a specific phone number. */
   async requestPhoneNumber(wid, phoneNumber) {
     return this.fetch(`w/${wid}/phone-numbers/request`, {
       method: "POST",
       body: JSON.stringify({ phone_number: phoneNumber })
     });
   }
+  /** Get a phone number by ID. */
   async getPhoneNumber(wid, id) {
     return this.fetch(`w/${wid}/phone-numbers/${id}`);
   }
+  /** Create a new phone number record. */
   async createPhoneNumber(wid, phoneNumber) {
     return this.fetch(`w/${wid}/phone-numbers`, {
       method: "POST",
       body: JSON.stringify(phoneNumber)
     });
   }
+  /** Update a phone number record. */
   async updatePhoneNumber(wid, id, phoneNumber) {
     return this.fetch(`w/${wid}/phone-numbers/${id}`, {
       method: "PUT",
       body: JSON.stringify(phoneNumber)
     });
   }
+  /** Delete a phone number. */
   async deletePhoneNumber(wid, id) {
     return this.fetch(`w/${wid}/phone-numbers/${id}`, {
       method: "DELETE"
     });
   }
+  /** List paginated call records for a phone number. */
   async getPhoneNumberCalls(wid, id, page = 1, pageSize = 10) {
     return this.fetch(
       `w/${wid}/phone-numbers/${id}/calls?page=${page}&pageSize=${pageSize}`
     );
   }
+  /** List paginated SMS messages for a phone number. */
   async getPhoneNumberMessages(wid, id, page = 1, pageSize = 10) {
     return this.fetch(
       `w/${wid}/phone-numbers/${id}/messages?page=${page}&pageSize=${pageSize}`
@@ -4428,6 +4688,7 @@ var PhoneNumbersApi = class extends BaseApiClient {
   }
 };
 var PronunciationsApi = class extends BaseApiClient {
+  /** List pronunciation entries for an organization, optionally filtered by scope. */
   async getPronunciationEntries(orgUuid, options = {}) {
     const params = new URLSearchParams();
     if (options.scope) params.append("scope", options.scope);
@@ -4437,55 +4698,65 @@ var PronunciationsApi = class extends BaseApiClient {
     );
     return response.items;
   }
+  /** Create a new pronunciation entry for an organization. */
   async createPronunciationEntry(orgUuid, data) {
     return this.fetch(`o/${orgUuid}/pronunciations`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update an existing organization pronunciation entry. */
   async updatePronunciationEntry(orgUuid, id, data) {
     return this.fetch(`o/${orgUuid}/pronunciations/${id}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete a pronunciation entry from an organization. */
   async deletePronunciationEntry(orgUuid, id) {
     return this.fetch(`o/${orgUuid}/pronunciations/${id}`, {
       method: "DELETE"
     });
   }
+  /** Export all pronunciation entries for an organization as term/respelling pairs. */
   async exportPronunciationEntries(orgUuid) {
     return this.fetch(`o/${orgUuid}/pronunciations/export`);
   }
+  /** Bulk import pronunciation entries into an organization. */
   async importPronunciationEntries(orgUuid, entries) {
     return this.fetch(`o/${orgUuid}/pronunciations/import`, {
       method: "POST",
       body: JSON.stringify({ entries })
     });
   }
+  /** List the current user's personal pronunciation entries. */
   async getMyPronunciations() {
     const response = await this.fetch(
       "account/pronunciations"
     );
     return response.items;
   }
+  /** Create a personal pronunciation entry for the current user. */
   async createMyPronunciation(data) {
     return this.fetch("account/pronunciations", {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update a personal pronunciation entry. */
   async updateMyPronunciation(id, data) {
     return this.fetch(`account/pronunciations/${id}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete a personal pronunciation entry. */
   async deleteMyPronunciation(id) {
     return this.fetch(`account/pronunciations/${id}`, {
       method: "DELETE"
     });
   }
+  /** Get AI-suggested respellings for a given term. */
   async suggestPronunciations(term, language) {
     const response = await this.fetch(
       "account/pronunciations/suggest",
@@ -4496,12 +4767,14 @@ var PronunciationsApi = class extends BaseApiClient {
     );
     return response.suggestions;
   }
+  /** List recommended voices for pronunciation preview. */
   async getRecommendedVoices() {
     const response = await this.fetch(
       "account/pronunciations/voices"
     );
     return response.voices;
   }
+  /** Generate an audio preview of a pronunciation respelling using a specified voice. */
   async previewPronunciation(data) {
     const response = await this.fetchRaw("account/pronunciations/preview", {
       method: "POST",
@@ -4515,24 +4788,29 @@ var PronunciationsApi = class extends BaseApiClient {
   }
 };
 var QualificationsApi = class extends BaseApiClient {
+  /** List all qualifications in a workspace. */
   async getQualifications(wid) {
     return this.fetch(`w/${wid}/qualifications`);
   }
+  /** Get a single qualification by ID. */
   async getQualification(wid, id) {
     return this.fetch(`w/${wid}/qualifications/${id}`);
   }
+  /** Create a new qualification in a workspace. */
   async createQualification(wid, data) {
     return this.fetch(`w/${wid}/qualifications`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update an existing qualification. */
   async updateQualification(wid, id, data) {
     return this.fetch(`w/${wid}/qualifications/${id}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** List members assigned to a qualification with optional filtering. */
   async getQualificationMembers(wid, id, params) {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set("status", params.status);
@@ -4544,16 +4822,19 @@ var QualificationsApi = class extends BaseApiClient {
       `w/${wid}/qualifications/${id}/members${qs ? `?${qs}` : ""}`
     );
   }
+  /** Archive a qualification. */
   async archiveQualification(wid, id) {
     return this.fetch(`w/${wid}/qualifications/${id}`, {
       method: "DELETE"
     });
   }
+  /** List all qualifications assigned to a specific member. */
   async getMemberQualifications(wid, memberId) {
     return this.fetch(
       `w/${wid}/qualifications/members/${memberId}/qualifications`
     );
   }
+  /** Assign a qualification to a member. */
   async assignQualification(wid, memberId, data) {
     return this.fetch(
       `w/${wid}/qualifications/members/${memberId}/qualifications`,
@@ -4563,6 +4844,7 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Update a member's qualification status or settings. */
   async updateMemberQualification(wid, memberId, qualificationId, data) {
     return this.fetch(
       `w/${wid}/qualifications/members/${memberId}/qualifications/${qualificationId}`,
@@ -4572,6 +4854,7 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Remove a qualification assignment from a member. */
   async removeMemberQualification(wid, memberId, qualificationId) {
     return this.fetch(
       `w/${wid}/qualifications/members/${memberId}/qualifications/${qualificationId}`,
@@ -4580,17 +4863,20 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Get the status change history for a member's qualification. */
   async getMemberQualificationLog(wid, memberId, qualificationId) {
     return this.fetch(
       `w/${wid}/qualifications/members/${memberId}/qualifications/${qualificationId}/log`
     );
   }
   // ===== Requirements =====
+  /** List all requirements for a qualification. */
   async listRequirements(wid, qualificationId) {
     return this.fetch(
       `w/${wid}/qualifications/${qualificationId}/requirements`
     );
   }
+  /** Create a new requirement for a qualification. */
   async createRequirement(wid, qualificationId, data) {
     return this.fetch(
       `w/${wid}/qualifications/${qualificationId}/requirements`,
@@ -4600,11 +4886,13 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Get a single qualification requirement by ID. */
   async getRequirement(wid, requirementId) {
     return this.fetch(
       `w/${wid}/qualifications/requirements/${requirementId}`
     );
   }
+  /** Update a qualification requirement. */
   async updateRequirement(wid, requirementId, data) {
     return this.fetch(
       `w/${wid}/qualifications/requirements/${requirementId}`,
@@ -4614,12 +4902,14 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Delete a qualification requirement. */
   async deleteRequirement(wid, requirementId) {
     return this.fetch(`w/${wid}/qualifications/requirements/${requirementId}`, {
       method: "DELETE"
     });
   }
   // ===== Submissions =====
+  /** List submissions for a qualification, optionally filtered by status or member. */
   async listSubmissions(wid, qualificationId, params) {
     const searchParams = new URLSearchParams();
     if (params?.status) searchParams.set("status", params.status);
@@ -4629,11 +4919,13 @@ var QualificationsApi = class extends BaseApiClient {
       `w/${wid}/qualifications/${qualificationId}/submissions${qs ? `?${qs}` : ""}`
     );
   }
+  /** Get a single qualification submission by ID. */
   async getSubmission(wid, submissionId) {
     return this.fetch(
       `w/${wid}/qualifications/submissions/${submissionId}`
     );
   }
+  /** Submit an answer for a qualification requirement. */
   async submitAnswer(wid, requirementId, data) {
     return this.fetch(
       `w/${wid}/qualifications/requirements/${requirementId}/submit`,
@@ -4643,6 +4935,7 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Start a chat scenario for a qualification requirement. */
   async startScenario(wid, requirementId) {
     return this.fetch(
       `w/${wid}/qualifications/requirements/${requirementId}/start-scenario`,
@@ -4651,11 +4944,13 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Delete a submission to allow the member to retry. */
   async retrySubmission(wid, submissionId) {
     await this.fetch(`w/${wid}/qualifications/submissions/${submissionId}/retry`, {
       method: "DELETE"
     });
   }
+  /** Submit the current user's qualification for review. */
   async submitForReview(wid, qualificationId) {
     return this.fetch(
       `w/${wid}/qualifications/members/me/qualifications/${qualificationId}/submit`,
@@ -4664,6 +4959,7 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Review a qualification submission, approving or rejecting it. */
   async reviewSubmission(wid, submissionId, data) {
     return this.fetch(
       `w/${wid}/qualifications/submissions/${submissionId}/review`,
@@ -4673,6 +4969,7 @@ var QualificationsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Override the score for a specific criterion on a submission. */
   async overrideCriterionScore(wid, submissionId, criterionId, data) {
     return this.fetch(
       `w/${wid}/qualifications/submissions/${submissionId}/criteria/${criterionId}`,
@@ -4684,6 +4981,7 @@ var QualificationsApi = class extends BaseApiClient {
   }
 };
 var ReportsApi = class extends BaseApiClient {
+  /** Get AI model usage report for a workspace within an optional date range. */
   async getAIUsageReport(wid, params) {
     const queryParams = new URLSearchParams();
     if (params?.start_date) {
@@ -4696,6 +4994,7 @@ var ReportsApi = class extends BaseApiClient {
     const url = `w/${wid}/reports/ai-usage${queryString ? `?${queryString}` : ""}`;
     return this.fetch(url);
   }
+  /** Get SMS usage report for a workspace within an optional date range. */
   async getSMSUsageReport(wid, params) {
     const queryParams = new URLSearchParams();
     if (params?.start_date) {
@@ -4708,6 +5007,7 @@ var ReportsApi = class extends BaseApiClient {
     const url = `w/${wid}/reports/sms-usage${queryString ? `?${queryString}` : ""}`;
     return this.fetch(url);
   }
+  /** Get phone call usage report for a workspace within an optional date range. */
   async getPhoneUsageReport(wid, params) {
     const queryParams = new URLSearchParams();
     if (params?.start_date) {
@@ -4720,6 +5020,7 @@ var ReportsApi = class extends BaseApiClient {
     const url = `w/${wid}/reports/phone-usage${queryString ? `?${queryString}` : ""}`;
     return this.fetch(url);
   }
+  /** Get usage report for a specific member within an optional date range. */
   async getMemberUsage(wid, memberId, params) {
     const queryParams = new URLSearchParams();
     if (params?.start_date) {
@@ -4732,6 +5033,7 @@ var ReportsApi = class extends BaseApiClient {
     const url = `w/${wid}/reports/member-usage/${memberId}${queryString ? `?${queryString}` : ""}`;
     return this.fetch(url);
   }
+  /** Get voice (STT/TTS) usage report for a workspace within an optional date range. */
   async getVoiceUsageReport(wid, params) {
     const queryParams = new URLSearchParams();
     if (params?.start_date) {
@@ -4746,9 +5048,11 @@ var ReportsApi = class extends BaseApiClient {
   }
 };
 var SitesApi = class extends BaseApiClient {
+  /** List all sites in a workspace. */
   async getSites(wid) {
     return this.fetch(`w/${wid}/sites`);
   }
+  /** Check whether a site slug is available for use. */
   async checkSiteSlugAvailability(wid, slug, siteUuid = null) {
     const params = new URLSearchParams();
     if (siteUuid) params.append("site_uuid", siteUuid);
@@ -4756,6 +5060,7 @@ var SitesApi = class extends BaseApiClient {
       `w/${wid}/sites/available/${slug}?${params.toString()}`
     );
   }
+  /** Check whether a custom domain is available for a site. */
   async checkSiteDomainAvailability(wid, domain, siteUuid = null) {
     const params = new URLSearchParams();
     if (siteUuid) params.append("site_uuid", siteUuid);
@@ -4763,24 +5068,29 @@ var SitesApi = class extends BaseApiClient {
       `w/${wid}/sites/domain-available/${domain}?${params.toString()}`
     );
   }
+  /** Get a single site by ID. */
   async getSite(wid, id) {
     return this.fetch(`w/${wid}/sites/${id}`);
   }
+  /** Get a single site by UUID. */
   async getSiteByUuid(wid, uuid) {
     return this.fetch(`s/${wid}/${uuid}`);
   }
+  /** Get a fully rendered page from a site by slug or ID. */
   async getSiteRenderedPage(wid, siteUuid, pageSlugOrId) {
     return this.fetch(`s/${wid}/${siteUuid}/pages/${pageSlugOrId}`);
   }
+  /** Get the rendered navigation menu for a site, including all translations. */
   async getSiteRenderedMenu(wid, siteUuid) {
     return this.fetch(`s/${wid}/${siteUuid}/menu`);
   }
+  /** Sign up a new user through a site's public registration. */
   async siteSignup(wid, siteUuid) {
     return this.fetch(`s/${wid}/${siteUuid}/signup`, {
       method: "POST"
     });
   }
-  // ===== SITE-SPECIFIC AUTHENTICATION METHODS =====
+  /** Send a phone verification code for site-specific authentication. */
   async siteSendPhoneCode(wid, siteUuid, phoneNumber) {
     return this.fetch(
       `s/${wid}/${siteUuid}/auth/send-phone-code`,
@@ -4790,6 +5100,7 @@ var SitesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Send an email verification code for site-specific authentication. */
   async siteSendEmailCode(wid, siteUuid, email) {
     return this.fetch(
       `s/${wid}/${siteUuid}/auth/send-email-code`,
@@ -4799,6 +5110,7 @@ var SitesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Verify a phone or email code and complete site authentication. */
   async siteVerifyCode(wid, siteUuid, code, phoneNumber, email) {
     const verifyResponse = await this.fetch(`s/${wid}/${siteUuid}/auth/verify`, {
       method: "POST",
@@ -4814,28 +5126,33 @@ var SitesApi = class extends BaseApiClient {
     }
     return verifyResponse;
   }
+  /** Trigger a crawl of the site's external content source. */
   async crawlSite(wid, siteId) {
     return this.fetch(`w/${wid}/sites/${siteId}/crawl`, {
       method: "POST"
     });
   }
+  /** Create a new site in the workspace. */
   async createSite(wid, site) {
     return this.fetch(`w/${wid}/sites`, {
       method: "POST",
       body: JSON.stringify(site)
     });
   }
+  /** Update a site's configuration. */
   async updateSite(wid, id, site) {
     return this.fetch(`w/${wid}/sites/${id}`, {
       method: "PUT",
       body: JSON.stringify(site)
     });
   }
+  /** Delete a site by ID. */
   async deleteSite(wid, id) {
     return this.fetch(`w/${wid}/sites/${id}`, {
       method: "DELETE"
     });
   }
+  /** List pages for a site with optional pagination, sorting, and search. */
   async getSitePages(wid, siteId, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -4847,36 +5164,43 @@ var SitesApi = class extends BaseApiClient {
       `w/${wid}/sites/${siteId}/pages${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single page by ID within a site. */
   async getPage(wid, siteId, pageId) {
     return this.fetch(`w/${wid}/sites/${siteId}/pages/${pageId}`);
   }
+  /** Get a single page by its slug within a site. */
   async getPageBySlug(wid, siteId, slug) {
     return this.fetch(`w/${wid}/sites/${siteId}/pages/by-slug/${slug}`);
   }
+  /** Create a new page within a site. */
   async createPage(wid, siteId, page) {
     return this.fetch(`w/${wid}/sites/${siteId}/pages`, {
       method: "POST",
       body: JSON.stringify(page)
     });
   }
+  /** Update a page's content or metadata. */
   async updatePage(wid, siteId, pageId, page) {
     return this.fetch(`w/${wid}/sites/${siteId}/pages/${pageId}`, {
       method: "PUT",
       body: JSON.stringify(page)
     });
   }
+  /** Delete a page from a site. */
   async deletePage(wid, siteId, pageId) {
     return this.fetch(`w/${wid}/sites/${siteId}/pages/${pageId}`, {
       method: "DELETE"
     });
   }
+  /** Get aggregate counts (pages, menu items, etc.) for a site. */
   async getSiteCounts(wid, siteId) {
     return this.fetch(`w/${wid}/sites/${siteId}/counts`);
   }
-  // Menu management methods
+  /** Get the full menu tree for a site. */
   async getSiteMenu(wid, siteId) {
     return this.fetch(`w/${wid}/sites/${siteId}/menu`);
   }
+  /** List menu items for a site, optionally filtered by parent item. */
   async getMenuItems(wid, siteId, parentId) {
     const params = new URLSearchParams();
     if (parentId !== void 0 && parentId !== null) {
@@ -4887,36 +5211,41 @@ var SitesApi = class extends BaseApiClient {
       `w/${wid}/sites/${siteId}/menu/items${query ? `?${query}` : ""}`
     );
   }
+  /** Create a new menu item in a site's navigation. */
   async createMenuItem(wid, siteId, item) {
     return this.fetch(`w/${wid}/sites/${siteId}/menu/items`, {
       method: "POST",
       body: JSON.stringify(item)
     });
   }
+  /** Update a menu item's properties. */
   async updateMenuItem(wid, siteId, itemId, item) {
     return this.fetch(`w/${wid}/sites/${siteId}/menu/items/${itemId}`, {
       method: "PUT",
       body: JSON.stringify(item)
     });
   }
+  /** Delete a menu item from a site's navigation. */
   async deleteMenuItem(wid, siteId, itemId) {
     return this.fetch(`w/${wid}/sites/${siteId}/menu/items/${itemId}`, {
       method: "DELETE"
     });
   }
+  /** Reorder menu items within a site's navigation. */
   async reorderMenuItems(wid, siteId, data) {
     return this.fetch(`w/${wid}/sites/${siteId}/menu/reorder`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
-  // Site media upload method
+  /** Generate a pre-signed upload URL for site media content. */
   async generateSiteMediaUploadUrl(wid, siteId, uploadRequest) {
     return this.fetch(`w/${wid}/sites/${siteId}/media/upload-url`, {
       method: "POST",
       body: JSON.stringify(uploadRequest)
     });
   }
+  /** Initiate Google OAuth flow for site-specific authentication. */
   async siteGoogleOAuthInitiate(wid, siteUuid, origin) {
     const params = new URLSearchParams({ origin });
     return this.fetch(
@@ -4925,24 +5254,29 @@ var SitesApi = class extends BaseApiClient {
   }
 };
 var SubscriptionsApi = class extends BaseApiClient {
+  /** List all subscriptions for the current account. */
   async getSubscriptions() {
     return this.fetch("subscriptions");
   }
+  /** List all subscriptions associated with a workspace. */
   async getWorkspaceSubscriptions(wid) {
     return this.fetch(`w/${wid}/subscriptions`);
   }
+  /** Cancel an active subscription. */
   async cancelSubscription(subscriptionId) {
     return this.fetch(`subscriptions/${subscriptionId}/cancel`, {
       method: "POST",
       credentials: "include"
     });
   }
+  /** Reactivate a previously cancelled subscription. */
   async reactivateSubscription(subscriptionId) {
     return this.fetch(`subscriptions/${subscriptionId}/reactivate`, {
       method: "POST",
       credentials: "include"
     });
   }
+  /** Update a subscription's budget or plan period. */
   async updateSubscription(subscriptionId, updates) {
     return this.fetch(`subscriptions/${subscriptionId}`, {
       method: "PUT",
@@ -4953,6 +5287,7 @@ var SubscriptionsApi = class extends BaseApiClient {
       }
     });
   }
+  /** Provision the member role associated with a subscription. */
   async provisionMemberRole(subscriptionId) {
     return this.fetch(`subscriptions/${subscriptionId}/provision-role`, {
       method: "POST",
@@ -4961,6 +5296,7 @@ var SubscriptionsApi = class extends BaseApiClient {
   }
 };
 var TasksApi = class extends BaseApiClient {
+  /** List all tasks in a workspace, optionally filtering by workflow or including archived. */
   async getTasks(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.includeArchived) {
@@ -4973,31 +5309,37 @@ var TasksApi = class extends BaseApiClient {
       `w/${wid}/tasks${params.toString() ? `?${params.toString()}` : ""}`
     );
   }
+  /** Get a single task by ID. */
   async getTask(wid, id) {
     return this.fetch(`w/${wid}/tasks/${id}`);
   }
+  /** Create a new task in a workspace. */
   async createTask(wid, task) {
     return this.fetch(`w/${wid}/tasks`, {
       method: "POST",
       body: JSON.stringify(task)
     });
   }
+  /** Update an existing task with partial data. */
   async updateTask(wid, id, task) {
     return this.fetch(`w/${wid}/tasks/${id}`, {
       method: "PUT",
       body: JSON.stringify(task)
     });
   }
+  /** Delete a task by ID. */
   async deleteTask(wid, id) {
     return this.fetch(`w/${wid}/tasks/${id}`, {
       method: "DELETE"
     });
   }
+  /** Archive a task, hiding it from default listings. */
   async archiveTask(wid, id) {
     return this.fetch(`w/${wid}/tasks/${id}/archive`, {
       method: "PUT"
     });
   }
+  /** Restore an archived task back to active status. */
   async unarchiveTask(wid, id) {
     return this.fetch(`w/${wid}/tasks/${id}/unarchive`, {
       method: "PUT"
@@ -5051,17 +5393,21 @@ var ToolkitsApi = class extends BaseApiClient {
   }
 };
 var WorkflowsApi = class extends BaseApiClient {
+  /** List all workflows in a workspace, optionally including archived ones. */
   async getWorkflows(wid, archived = false) {
     const url = archived ? `w/${wid}/workflows?archived=true` : `w/${wid}/workflows`;
     return this.fetch(url);
   }
+  /** Get a single workflow by ID. */
   async getWorkflow(wid, id) {
     return this.fetch(`w/${wid}/workflows/${id}`);
   }
+  /** Get activity metrics for a single workflow. */
   async getWorkflowActivity(wid, id, options) {
     const params = options?.days ? `?days=${options.days}` : "";
     return this.fetch(`w/${wid}/workflows/${id}/activity${params}`);
   }
+  /** Get activity metrics for multiple workflows in a single request. */
   async getWorkflowsActivityBatch(wid, workflowIds, options) {
     const params = new URLSearchParams();
     params.set("workflow_ids", workflowIds.join(","));
@@ -5070,6 +5416,7 @@ var WorkflowsApi = class extends BaseApiClient {
       `w/${wid}/workflows/activity/batch?${params.toString()}`
     );
   }
+  /** Get the Mermaid diagram representation of a workflow. */
   async getWorkflowDiagram(wid, id) {
     return this.fetch(`w/${wid}/workflows/${id}/diagram`);
   }
@@ -5084,52 +5431,62 @@ var WorkflowsApi = class extends BaseApiClient {
     }
     return `${this.baseUrl}/api/v2/w/${wid}/workflows/${id}/thumbnail`;
   }
+  /** Create a new workflow in a workspace. */
   async createWorkflow(wid, workflow) {
     return this.fetch(`w/${wid}/workflows`, {
       method: "POST",
       body: JSON.stringify(workflow)
     });
   }
+  /** Update an existing workflow. */
   async updateWorkflow(wid, id, workflow) {
     return this.fetch(`w/${wid}/workflows/${id}`, {
       method: "PUT",
       body: JSON.stringify(workflow)
     });
   }
+  /** Preview the impact of deleting a workflow, including affected tasks and assignments. */
   async getWorkflowDeletionPreview(wid, id) {
     return this.fetch(`w/${wid}/workflows/${id}/deletion-preview`);
   }
+  /** Delete a workflow, optionally cascading to delete its tasks. */
   async deleteWorkflow(wid, id, cascade = false) {
     const url = cascade ? `w/${wid}/workflows/${id}?cascade=true` : `w/${wid}/workflows/${id}`;
     return this.fetch(url, {
       method: "DELETE"
     });
   }
+  /** Archive a workflow. */
   async archiveWorkflow(wid, id) {
     return this.fetch(`w/${wid}/workflows/${id}/archive`, {
       method: "POST"
     });
   }
+  /** Unarchive a previously archived workflow. */
   async unarchiveWorkflow(wid, id) {
     return this.fetch(`w/${wid}/workflows/${id}/unarchive`, {
       method: "POST"
     });
   }
+  /** Clone a workflow with a new name. */
   async cloneWorkflow(wid, id, data) {
     return this.fetch(`w/${wid}/workflows/${id}/clone`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** List available workflow templates. */
   async getWorkflowTemplates(wid) {
     return this.fetch(`w/${wid}/workflows/templates`);
   }
+  /** Create a new workflow from a template. */
   async createWorkflowFromTemplate(wid, templateUuid, data) {
     return this.fetch(`w/${wid}/workflows/templates/${templateUuid}/create-workflow`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Get task assignment statistics for a workflow within an optional date range. */
   async getWorkflowTaskAssignmentStats(wid, id, fromDate, toDate) {
     const params = new URLSearchParams();
     if (fromDate) params.append("from_date", fromDate);
@@ -5138,6 +5495,7 @@ var WorkflowsApi = class extends BaseApiClient {
       `w/${wid}/workflows/${id}/task-assignment-stats?${params.toString()}`
     );
   }
+  /** List chats for a specific task within a workflow. */
   async getTaskChats(wid, workflowId, taskId, fromDate, toDate, limit = 100, offset = 0) {
     const params = new URLSearchParams();
     if (fromDate) params.append("from_date", fromDate);
@@ -5149,15 +5507,18 @@ var WorkflowsApi = class extends BaseApiClient {
     );
   }
   // Workflow Contributors API
+  /** List all contributors for a workflow. */
   async getWorkflowContributors(wid, workflowId) {
     return this.fetch(`w/${wid}/workflows/${workflowId}/contributors`);
   }
+  /** Add a contributor to a workflow. */
   async createWorkflowContributor(wid, workflowId, data) {
     return this.fetch(`w/${wid}/workflows/${workflowId}/contributors`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Update a workflow contributor's settings. */
   async updateWorkflowContributor(wid, workflowId, contributorId, data) {
     return this.fetch(
       `w/${wid}/workflows/${workflowId}/contributors/${contributorId}`,
@@ -5167,6 +5528,7 @@ var WorkflowsApi = class extends BaseApiClient {
       }
     );
   }
+  /** Remove a contributor from a workflow. */
   async deleteWorkflowContributor(wid, workflowId, contributorId) {
     return this.fetch(
       `w/${wid}/workflows/${workflowId}/contributors/${contributorId}`,
@@ -5346,59 +5708,73 @@ var WorkspaceInvitationsApi = class extends BaseApiClient {
   }
 };
 var WorkspacesApi = class extends BaseApiClient {
+  /** List all workspaces accessible to the current user. */
   async getWorkspaces() {
     return this.fetch("w/");
   }
+  /** List all publicly visible workspaces. */
   async getPublicWorkspaces() {
     return this.fetch("w/public");
   }
+  /** Get a single workspace by ID. */
   async getWorkspace(wid) {
     return this.fetch(`w/${wid}`);
   }
+  /** Create a new workspace. */
   async createWorkspace(workspace) {
     return this.fetch("w/", {
       method: "POST",
       body: JSON.stringify(workspace)
     });
   }
+  /** Update an existing workspace. */
   async updateWorkspace(wid, workspace) {
     return this.fetch(`w/${wid}`, {
       method: "PUT",
       body: JSON.stringify(workspace)
     });
   }
+  /** Delete a workspace. */
   async deleteWorkspace(wid) {
     return this.fetch(`w/${wid}`, {
       method: "DELETE"
     });
   }
+  /** Leave a workspace as the current user. */
   async leaveWorkspace(wid) {
     return this.fetch(`w/${wid}/me`, {
       method: "DELETE"
     });
   }
+  /** Get the default settings for a workspace. */
   async getWorkspaceDefaults(wid) {
     return this.fetch(`w/${wid}/defaults`);
   }
+  /** Update the default settings for a workspace. */
   async updateWorkspaceDefaults(wid, defaults) {
     return this.fetch(`w/${wid}/defaults`, {
       method: "PUT",
       body: JSON.stringify(defaults)
     });
   }
+  /** Get entity counts (members, tasks, workflows, etc.) for a workspace. */
   async getWorkspaceCounts(wid) {
     return this.fetch(`w/${wid}/counts`);
   }
+  /** Check whether the workspace is currently within business hours. */
   async getBusinessHoursStatus(wid) {
     return this.fetch(`w/${wid}/business-hours-status`);
   }
+  /** List all available workspace feature flags from the registry. */
   async getAvailableWorkspaceFeatures() {
     const result = await this.fetch(`features/registry`);
     return result.features;
   }
+  /** Get active notices for a workspace. */
   async getWorkspaceNotices(wid) {
     return this.fetch(`w/${wid}/notices`);
   }
+  /** List notifications for the current user in a workspace. */
   async getNotifications(wid, options = {}) {
     const params = new URLSearchParams();
     if (options.page) params.append("page", options.page.toString());
@@ -5407,32 +5783,39 @@ var WorkspacesApi = class extends BaseApiClient {
     const url = `w/${wid}/notifications${queryString ? `?${queryString}` : ""}`;
     return this.fetch(url);
   }
+  /** Get a single notification by ID. */
   async getNotification(wid, id) {
     return this.fetch(`w/${wid}/notifications/${id}`);
   }
+  /** Get the count of unread notifications for the current user. */
   async getUnreadNotificationCount(wid) {
     return this.fetch(`w/${wid}/notifications/unread-count`);
   }
+  /** Mark a notification as read. */
   async markNotificationAsRead(wid, id) {
     return this.fetch(`w/${wid}/notifications/${id}/read`, {
       method: "POST"
     });
   }
+  /** Dismiss a single notification. */
   async dismissNotification(wid, id) {
     return this.fetch(`w/${wid}/notifications/${id}/dismiss`, {
       method: "POST"
     });
   }
+  /** Dismiss all notifications for the current user in a workspace. */
   async dismissAllNotifications(wid) {
     return this.fetch(`w/${wid}/notifications/dismiss-all`, {
       method: "POST"
     });
   }
   // ===== Push Notifications =====
+  /** Get the VAPID public key for Web Push subscription registration. */
   async getVapidPublicKey() {
     const response = await this.fetch("push/vapid-public-key");
     return response.publicKey;
   }
+  /** Register a Web Push subscription for the current user. */
   async registerPushSubscription(wid, subscription) {
     return this.fetch(
       `w/${wid}/push-subscriptions`,
@@ -5442,6 +5825,7 @@ var WorkspacesApi = class extends BaseApiClient {
       }
     );
   }
+  /** Unregister a Web Push subscription by endpoint URL. */
   async unregisterPushSubscription(wid, endpoint) {
     return this.fetch(
       `w/${wid}/push-subscriptions?endpoint=${encodeURIComponent(endpoint)}`,
@@ -5450,32 +5834,39 @@ var WorkspacesApi = class extends BaseApiClient {
       }
     );
   }
+  /** List all active Web Push subscriptions for the current user. */
   async listPushSubscriptions(wid) {
     return this.fetch(`w/${wid}/push-subscriptions`);
   }
+  /** List all client workspaces managed by this reseller workspace. */
   async getResellerWorkspaces(wid) {
     return this.fetch(`w/${wid}/reseller/workspaces`);
   }
+  /** Create a new client workspace under a reseller workspace. */
   async createClientWorkspace(wid, data) {
     return this.fetch(`w/${wid}/reseller/workspaces`, {
       method: "POST",
       body: JSON.stringify(data)
     });
   }
+  /** Get a single client workspace by ID. */
   async getClientWorkspace(wid, workspaceId) {
     return this.fetch(`w/${wid}/reseller/workspaces/${workspaceId}`);
   }
+  /** Update a client workspace's name or slug. */
   async updateClientWorkspace(wid, workspaceId, data) {
     return this.fetch(`w/${wid}/reseller/workspaces/${workspaceId}`, {
       method: "PUT",
       body: JSON.stringify(data)
     });
   }
+  /** Delete a client workspace. */
   async deleteClientWorkspace(wid, workspaceId) {
     return this.fetch(`w/${wid}/reseller/workspaces/${workspaceId}`, {
       method: "DELETE"
     });
   }
+  /** Provision a client workspace, setting up its database and resources. */
   async provisionClientWorkspace(wid, workspaceId) {
     return this.fetch(
       `w/${wid}/reseller/workspaces/${workspaceId}/provision`,
@@ -5484,44 +5875,53 @@ var WorkspacesApi = class extends BaseApiClient {
       }
     );
   }
+  /** List products available from a reseller workspace, optionally filtering by featured status. */
   async getProducts(wid, featured) {
     const params = featured !== void 0 ? `?featured=${featured}` : "";
     return this.fetch(`w/${wid}/reseller/products${params}`);
   }
+  /** Get a product by ID using the global endpoint. */
   async getProduct(id) {
     return this.fetch(`products/${id}`);
   }
+  /** Get a publicly accessible product by ID. */
   async getPublicProduct(id) {
     return this.fetch(`products/${id}`);
   }
+  /** Create a new product for a reseller workspace. */
   async createProduct(wid, product) {
     return this.fetch(`w/${wid}/reseller/products`, {
       method: "POST",
       body: JSON.stringify(product)
     });
   }
+  /** Update an existing product. */
   async updateProduct(wid, id, updates) {
     return this.fetch(`w/${wid}/reseller/products/${id}`, {
       method: "PUT",
       body: JSON.stringify(updates)
     });
   }
+  /** Delete a product from a reseller workspace. */
   async deleteProduct(wid, id) {
     return this.fetch(`w/${wid}/reseller/products/${id}`, {
       method: "DELETE"
     });
   }
   // Workspace Secret Key
+  /** Reset and regenerate the workspace secret key. */
   async resetWorkspaceSecretKey(wid) {
     return this.fetch(`w/${wid}/defaults/reset-secret-key`, {
       method: "POST"
     });
   }
   // Workspace Export/Import API
+  /** Export workspace configuration, optionally scoped to a single workflow. */
   async exportWorkspace(wid, workflowId) {
     const params = workflowId ? `?workflow_id=${workflowId}` : "";
     return this.fetch(`w/${wid}/export${params}`);
   }
+  /** Preview the result of importing workspace configuration without applying changes. */
   async previewWorkspaceImport(wid, exportData, importMappings, createNew, autoMap) {
     return this.fetch(`w/${wid}/preview-import`, {
       method: "POST",
@@ -5533,6 +5933,7 @@ var WorkspacesApi = class extends BaseApiClient {
       })
     });
   }
+  /** Import workspace configuration from exported data. */
   async importWorkspace(wid, exportData, importMappings, createNew) {
     return this.fetch(`w/${wid}/import`, {
       method: "POST",
@@ -5543,6 +5944,7 @@ var WorkspacesApi = class extends BaseApiClient {
       })
     });
   }
+  /** Preview a workspace import using the legacy untyped interface. */
   // Legacy method for backward compatibility
   async previewImportWorkspace(wid, exportData, importMappings = {}, createNew = {}) {
     return this.fetch(`w/${wid}/preview-import`, {
@@ -5554,9 +5956,11 @@ var WorkspacesApi = class extends BaseApiClient {
       })
     });
   }
+  /** List available themes for a workspace. */
   async getWorkspaceThemes(wid) {
     return this.fetch(`w/${wid}/themes`);
   }
+  /** Update the active themes for a workspace. */
   async updateWorkspaceThemes(wid, themes) {
     return this.fetch(`w/${wid}/themes`, {
       method: "PUT",
@@ -5665,24 +6069,29 @@ function formatAppContextAsMarkdown(context) {
 ${lines.join("\n")}`;
 }
 var WorkflowNotesApi = class extends BaseApiClient {
+  /** List all notes for a specific workflow. */
   async getWorkflowNotes(wid, workflowId) {
     return this.fetch(`w/${wid}/workflow-notes?workflow_id=${workflowId}`);
   }
+  /** Get a single workflow note by ID. */
   async getWorkflowNote(wid, id) {
     return this.fetch(`w/${wid}/workflow-notes/${id}`);
   }
+  /** Create a new note on a workflow. */
   async createWorkflowNote(wid, note) {
     return this.fetch(`w/${wid}/workflow-notes`, {
       method: "POST",
       body: JSON.stringify(note)
     });
   }
+  /** Update an existing workflow note with partial data. */
   async updateWorkflowNote(wid, id, note) {
     return this.fetch(`w/${wid}/workflow-notes/${id}`, {
       method: "PUT",
       body: JSON.stringify(note)
     });
   }
+  /** Delete a workflow note by ID. */
   async deleteWorkflowNote(wid, id) {
     return this.fetch(`w/${wid}/workflow-notes/${id}`, {
       method: "DELETE"
@@ -6125,6 +6534,7 @@ function bindWorkflowsMethods(target, workflows, workflowNotes, assistants, supe
   target.updateAssistant = assistants.updateAssistant.bind(assistants);
   target.deleteAssistant = assistants.deleteAssistant.bind(assistants);
   target.previewTTS = assistants.previewTTS.bind(assistants);
+  target.previewThinkingSound = assistants.previewThinkingSound.bind(assistants);
   target.getSupervisors = supervisors.getSupervisors.bind(supervisors);
   target.getSupervisor = supervisors.getSupervisor.bind(supervisors);
   target.createSupervisor = supervisors.createSupervisor.bind(supervisors);
@@ -6206,6 +6616,8 @@ function bindToolkitsMethods(target, toolkits, templates, aiModels, customToolki
   target.getVariableRegistry = templates.getVariableRegistry.bind(templates);
   target.getChatModels = aiModels.getChatModels.bind(aiModels);
   target.getRealtimeModels = aiModels.getRealtimeModels.bind(aiModels);
+  target.getSTTModels = aiModels.getSTTModels.bind(aiModels);
+  target.getTTSModels = aiModels.getTTSModels.bind(aiModels);
   target.getVoiceModels = aiModels.getVoiceModels.bind(aiModels);
   target.getAllModels = aiModels.getAllModels.bind(aiModels);
   target.getCustomToolkits = customToolkits.getCustomToolkits.bind(customToolkits);
@@ -6802,6 +7214,7 @@ var GravityRailClient = class {
   updateAssistant;
   deleteAssistant;
   previewTTS;
+  previewThinkingSound;
   getSupervisors;
   getSupervisor;
   createSupervisor;
@@ -6880,6 +7293,8 @@ var GravityRailClient = class {
   getVariableRegistry;
   getChatModels;
   getRealtimeModels;
+  getSTTModels;
+  getTTSModels;
   getVoiceModels;
   getAllModels;
   getCustomToolkits;
@@ -7160,7 +7575,7 @@ function getTTSProvider(ttsModel) {
   if (!ttsModel || ttsModel === "native") return ttsModel ?? null;
   return ttsModel.split(":")[0] ?? null;
 }
-var TTS_PREVIEW_PROVIDERS = ["openai", "elevenlabs", "google", "aws"];
+var TTS_PREVIEW_PROVIDERS = ["openai", "elevenlabs", "google", "aws", "pocket"];
 function getVoiceModelId(assistant) {
   const config = assistant.realtimeModelConfig;
   return config?.voiceModel ?? null;
@@ -7271,8 +7686,11 @@ var CHAT_TYPES = {
   MANAGER: "manager",
   CONTRIBUTOR: "contributor",
   DEVELOPER: "developer",
-  AGENT: "agent",
-  DM: "dm"
+  MEMBER: "member",
+  /** @deprecated Use MEMBER instead */
+  AGENT: "member",
+  /** @deprecated Use MEMBER instead */
+  DM: "member"
 };
 var BUILTIN_ASSISTANT_CHAT_TYPES = /* @__PURE__ */ new Set([
   CHAT_TYPES.MANAGER,
@@ -7281,7 +7699,7 @@ var BUILTIN_ASSISTANT_CHAT_TYPES = /* @__PURE__ */ new Set([
 ]);
 var NO_ASSISTANT_PARTICIPANT_CHAT_TYPES = /* @__PURE__ */ new Set([
   ...BUILTIN_ASSISTANT_CHAT_TYPES,
-  CHAT_TYPES.DM
+  CHAT_TYPES.MEMBER
 ]);
 function usesBuiltinAssistant(chatType) {
   return BUILTIN_ASSISTANT_CHAT_TYPES.has(chatType);
@@ -8088,7 +8506,7 @@ var SCOPE_PRESETS = {
   ALL: Object.keys(SCOPES)
 };
 
-// ../client/dist/chunk-JKJZGXAC.mjs
+// ../client/dist/chunk-HC6VELKR.mjs
 var AccessLevel = /* @__PURE__ */ ((AccessLevel2) => {
   AccessLevel2["PRIVATE"] = "private";
   AccessLevel2["PUBLIC"] = "public";
@@ -8483,6 +8901,7 @@ var TTS_MODEL_ELEVENLABS_TURBO = "elevenlabs:tts:eleven_turbo_v2_5";
 var TTS_MODEL_ELEVENLABS_MULTILINGUAL = "elevenlabs:tts:eleven_multilingual_v2";
 var TTS_MODEL_AWS_POLLY_GENERATIVE = "aws:tts:polly-generative";
 var TTS_MODEL_AWS_POLLY_NEURAL = "aws:tts:polly-neural";
+var TTS_MODEL_POCKET = "pocket:tts:default";
 var FhirVendor = /* @__PURE__ */ ((FhirVendor2) => {
   FhirVendor2["ECLINICALWORKS"] = "eclinicalworks";
   FhirVendor2["EPIC"] = "epic";
@@ -8645,6 +9064,7 @@ export {
   TTS_MODEL_ELEVENLABS_FLASH,
   TTS_MODEL_ELEVENLABS_MULTILINGUAL,
   TTS_MODEL_ELEVENLABS_TURBO,
+  TTS_MODEL_POCKET,
   TTS_PREVIEW_PROVIDERS,
   TemplatesApi,
   ToolkitState,