@gravity-rail/cli 0.1.0 → 0.2.0

package/dist/gr.js

@@ -2162,7 +2162,7 @@ function parsePhoneNumber4() {
   return withMetadataArgument(parsePhoneNumber3, arguments);
 }
 
-// ../client/dist/chunk-F5J4UVSB.mjs
+// ../client/dist/chunk-WFQXAPII.mjs
 function getCookieValue(name) {
   if (typeof document === "undefined") return void 0;
   const cookies = document.cookie.split(";");
@@ -2562,8 +2562,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();
@@ -2574,7 +2573,6 @@ var BuildersApi = class extends BaseApiClient {
   }
   /**
    * Get a specific builder by UUID
-   * @param builderId - Builder UUID
    */
   async getBuilder(builderId) {
     return this.fetch(`builders/${builderId}`);
@@ -2627,24 +2625,29 @@ var CELApi = 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"
@@ -2704,6 +2707,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);
@@ -2714,6 +2718,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);
@@ -2724,39 +2729,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}`
@@ -3529,6 +3540,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());
@@ -3542,32 +3554,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"
@@ -3650,30 +3668,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"
@@ -3681,6 +3705,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());
@@ -3695,56 +3720,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",
@@ -3753,6 +3790,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());
@@ -3767,9 +3805,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`, {
@@ -3777,17 +3817,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",
@@ -3798,6 +3841,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 {
@@ -3813,15 +3867,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);
@@ -3832,6 +3889,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;
@@ -3840,6 +3898,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",
@@ -3867,33 +3926,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",
@@ -3904,22 +3969,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",
@@ -3927,12 +3994,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) {
@@ -3944,12 +4013,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",
@@ -3972,44 +4043,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",
@@ -4017,6 +4096,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",
@@ -4026,6 +4106,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",
@@ -4035,6 +4116,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",
@@ -4043,6 +4125,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",
@@ -4053,6 +4136,7 @@ var AuthApi = class extends BaseApiClient {
     });
   }
   // ===== ORGANIZATION MEMBERSHIP METHODS =====
+  /** List all organizations the current account belongs to. */
   async getMyOrganizations() {
     return this.fetch("o/mine");
   }
@@ -4118,7 +4202,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());
@@ -4129,6 +4213,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");
@@ -4136,33 +4221,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}`,
@@ -4172,18 +4262,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`,
@@ -4193,7 +4285,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());
@@ -4207,70 +4299,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`,
@@ -4279,29 +4381,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"
@@ -4309,15 +4416,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`);
   }
@@ -4355,6 +4465,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();
@@ -4362,6 +4473,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();
@@ -4370,27 +4482,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());
@@ -4400,40 +4519,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`,
@@ -4443,6 +4569,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) {
@@ -4455,6 +4582,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());
@@ -4463,6 +4591,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());
@@ -4471,15 +4600,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",
@@ -4489,6 +4621,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`,
@@ -4517,10 +4650,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",
@@ -4530,55 +4664,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"
@@ -4671,6 +4815,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) {
@@ -4679,45 +4824,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());
@@ -4729,32 +4883,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",
@@ -4764,14 +4923,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`);
   }
@@ -4996,13 +5155,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);
@@ -5016,33 +5177,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());
@@ -5055,6 +5221,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);
@@ -5073,7 +5240,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());
@@ -5085,26 +5252,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());
@@ -5114,6 +5286,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());
@@ -5124,6 +5297,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"
@@ -5132,24 +5306,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}`);
@@ -5289,6 +5452,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());
@@ -5301,9 +5465,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",
@@ -5311,6 +5477,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",
@@ -5318,11 +5485,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}`,
@@ -5331,6 +5500,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",
@@ -5338,7 +5508,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());
@@ -5346,31 +5516,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);
@@ -5379,52 +5555,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`,
@@ -5434,33 +5618,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}`
@@ -5468,29 +5656,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());
@@ -5501,19 +5695,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}`,
@@ -5522,18 +5720,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`);
   }
@@ -5584,9 +5786,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();
@@ -5773,6 +5973,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`);
   }
@@ -5803,12 +6004,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());
@@ -5841,21 +6044,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) {
@@ -5867,98 +6074,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);
@@ -6003,6 +6231,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));
@@ -6022,6 +6251,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();
@@ -6170,6 +6400,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());
@@ -6180,21 +6411,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"
@@ -6255,21 +6490,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"
@@ -6277,57 +6516,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",
@@ -6411,45 +6662,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}`
@@ -6457,6 +6717,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);
@@ -6466,55 +6727,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",
@@ -6525,12 +6796,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",
@@ -6544,24 +6817,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);
@@ -6573,16 +6851,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`,
@@ -6592,6 +6873,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}`,
@@ -6601,6 +6883,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}`,
@@ -6609,17 +6892,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`,
@@ -6629,11 +6915,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}`,
@@ -6643,12 +6931,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);
@@ -6658,11 +6948,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`,
@@ -6672,6 +6964,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`,
@@ -6680,11 +6973,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`,
@@ -6693,6 +6988,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`,
@@ -6702,6 +6998,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}`,
@@ -6713,6 +7010,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) {
@@ -6725,6 +7023,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) {
@@ -6737,6 +7036,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) {
@@ -6749,6 +7049,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) {
@@ -6761,6 +7062,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) {
@@ -6775,9 +7077,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);
@@ -6785,6 +7089,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);
@@ -6792,24 +7097,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`,
@@ -6819,6 +7129,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`,
@@ -6828,6 +7139,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",
@@ -6843,28 +7155,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());
@@ -6876,36 +7193,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) {
@@ -6916,36 +7240,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(
@@ -6954,24 +7283,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",
@@ -6982,6 +7316,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",
@@ -6990,6 +7325,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) {
@@ -7002,31 +7338,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"
@@ -7080,17 +7422,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(","));
@@ -7099,6 +7445,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`);
   }
@@ -7113,52 +7460,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);
@@ -7167,6 +7524,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);
@@ -7178,15 +7536,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}`,
@@ -7196,6 +7557,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}`,
@@ -7375,59 +7737,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 result2 = await this.fetch(`features/registry`);
     return result2.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());
@@ -7436,32 +7812,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`,
@@ -7471,6 +7854,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)}`,
@@ -7479,32 +7863,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`,
@@ -7513,44 +7904,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",
@@ -7562,6 +7962,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",
@@ -7572,6 +7973,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`, {
@@ -7583,9 +7985,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",
@@ -7633,24 +8037,29 @@ var WorkspacesApi = class extends BaseApiClient {
   }
 };
 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"
@@ -8211,6 +8620,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);
@@ -8292,6 +8702,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);
@@ -8888,6 +9300,7 @@ var GravityRailClient = class {
   updateAssistant;
   deleteAssistant;
   previewTTS;
+  previewThinkingSound;
   getSupervisors;
   getSupervisor;
   createSupervisor;
@@ -8966,6 +9379,8 @@ var GravityRailClient = class {
   getVariableRegistry;
   getChatModels;
   getRealtimeModels;
+  getSTTModels;
+  getTTSModels;
   getVoiceModels;
   getAllModels;
   getCustomToolkits;
@@ -9348,8 +9763,7 @@ var CHAT_TYPES = {
   MANAGER: "manager",
   CONTRIBUTOR: "contributor",
   DEVELOPER: "developer",
-  DM: "dm"
-};
+  MEMBER: "member"};
 var BUILTIN_ASSISTANT_CHAT_TYPES = /* @__PURE__ */ new Set([
   CHAT_TYPES.MANAGER,
   CHAT_TYPES.CONTRIBUTOR,
@@ -9357,7 +9771,7 @@ var BUILTIN_ASSISTANT_CHAT_TYPES = /* @__PURE__ */ new Set([
 ]);
 /* @__PURE__ */ new Set([
   ...BUILTIN_ASSISTANT_CHAT_TYPES,
-  CHAT_TYPES.DM
+  CHAT_TYPES.MEMBER
 ]);
 var ENVIRONMENTS = {
   dev: {
@@ -9658,6 +10072,93 @@ function printTable(items, columns, options = {}) {
   console.log("");
   console.log(`Total: ${items.length} item(s)`);
 }
+var AGUIClient = class {
+  endpointUrl;
+  accessToken;
+  debug;
+  constructor(options) {
+    this.endpointUrl = `${options.baseUrl}/api/v2/w/${options.workspaceUuid}/web-chat/${options.chatId}/chat/agui`;
+    this.accessToken = options.accessToken;
+    this.debug = options.debug ?? false;
+  }
+  /**
+   * Send messages and stream the response
+   */
+  async sendMessage(messages, onEvent) {
+    const body = JSON.stringify({
+      model: "manager",
+      messages
+    });
+    if (this.debug) {
+      console.log(`
+[DEBUG] POST ${this.endpointUrl}`);
+      console.log(`[DEBUG] Body: ${messages.length} message(s)`);
+    }
+    const response = await fetch(this.endpointUrl, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.accessToken}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream"
+      },
+      body
+    });
+    if (this.debug) {
+      console.log(`[DEBUG] Response status: ${response.status}`);
+    }
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "");
+      if (this.debug) {
+        console.log(`[DEBUG] Error response: ${errorText}`);
+      }
+      throw new Error(`Chat request failed: ${response.status}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          const data = line.slice(6);
+          if (data === "[DONE]") {
+            onEvent({ type: "done" });
+            continue;
+          }
+          try {
+            const event = JSON.parse(data);
+            onEvent(event);
+          } catch {
+          }
+        }
+      }
+    }
+  }
+};
+function isTextContentEvent(event) {
+  const type = event.type.toLowerCase();
+  return type === "text_message_content";
+}
+function isErrorEvent(event) {
+  const type = event.type.toLowerCase();
+  return type === "run_error";
+}
+function getTextDelta(event) {
+  if (isTextContentEvent(event) && event.delta) {
+    return event.delta;
+  }
+  return null;
+}
+function getErrorMessage(event) {
+  if (isErrorEvent(event)) {
+    return event.message || event.code || "Unknown error";
+  }
+  return null;
+}
 var CLIError = class extends Error {
   constructor(message, exitCode = 1) {
     super(message);
@@ -10299,28 +10800,67 @@ var chatsDomain = {
     }),
     // Messages
     {
-      path: ["chats", "messages"],
-      description: "Get messages for a chat",
+      path: ["chats", "messages", "list"],
+      description: "List messages for a chat",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Chat ID", required: true }],
+      args: [{ name: "chat-id", description: "Chat ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getChatMessages(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "chat-id")
         );
         outputData(result2, ctx, MESSAGE_COLUMNS);
       }
     },
     {
-      path: ["chats", "send-message"],
-      description: "Send an assistant message to a chat",
+      path: ["chats", "messages", "send"],
+      description: "Send a user message to a chat (triggers AI inference). Use --stream to stream the response.",
       mutates: true,
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Chat ID", required: true }],
+      args: [
+        { name: "chat-id", description: "Chat ID", required: true },
+        { name: "stream", description: "Stream the AI response via AG-UI", isFlag: true }
+      ],
+      handler: async ({ ctx, workspace, args, data }) => {
+        const content = typeof data === "string" ? data : data?.content;
+        if (!content)
+          throw new Error(
+            `Message content is required (pass --data '"your message"' or --data '{"content":"your message"}')`
+          );
+        const chatId = requireNumber(args, "chat-id");
+        if (args.stream) {
+          const aguiClient = new AGUIClient({
+            baseUrl: ctx.envConfig.apiUrl,
+            workspaceUuid: workspace,
+            chatId,
+            accessToken: ctx.accessToken
+          });
+          process.stdout.write("\x1B[32mAssistant:\x1B[0m ");
+          await aguiClient.sendMessage([{ role: "user", content }], (event) => {
+            const delta = getTextDelta(event);
+            if (delta) process.stdout.write(delta);
+            const errorMsg = getErrorMessage(event);
+            if (errorMsg) process.stderr.write(`
+\x1B[31mError: ${errorMsg}\x1B[0m
+`);
+          });
+          process.stdout.write("\n");
+        } else {
+          const result2 = await ctx.apiClient.sendChatMessage(workspace, chatId, content);
+          outputSingle(result2, ctx, MESSAGE_COLUMNS);
+        }
+      }
+    },
+    {
+      path: ["chats", "messages", "send-as-assistant"],
+      description: "Send an assistant message to a chat (does not trigger AI inference)",
+      mutates: true,
+      requiresWorkspace: true,
+      args: [{ name: "chat-id", description: "Chat ID", required: true }],
       handler: async ({ ctx, workspace, args, data }) => {
         const result2 = await ctx.apiClient.sendAssistantMessage(
           workspace,
-          requireNumber(args, "id"),
+          requireNumber(args, "chat-id"),
           data
         );
         outputSingle(result2, ctx, MESSAGE_COLUMNS);
@@ -10761,7 +11301,7 @@ var workspacesDomain = {
       requiresWorkspace: true,
       handler: async ({ ctx, workspace }) => {
         const result2 = await ctx.apiClient.getChats(workspace, {
-          chatType: "dm",
+          chatType: "member",
           mine: true,
           sortBy: "updatedAt",
           sortOrder: "desc"
@@ -10801,8 +11341,7 @@ var COLUMNS5 = [
   COL.id(),
   COL.uuid(),
   COL.name(),
-  COL.status(),
-  { header: "TYPE", getValue: (item) => item.workflow_type ?? "" },
+  { header: "TASKS", getValue: (item) => String(item.taskCount ?? "") },
   COL.created()
 ];
 var NOTE_COLUMNS = [
@@ -11018,16 +11557,13 @@ var assignmentsDomain = {
       description: "Cancel an assignment",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "id", description: "Assignment ID", required: true },
-        { name: "reason", description: "Cancellation reason" }
-      ],
-      handler: async ({ ctx, workspace, args }) => {
-        const data = args.reason ? { reason: args.reason } : {};
+      args: [{ name: "id", description: "Assignment ID", required: true }],
+      handler: async ({ ctx, workspace, args, data }) => {
+        const body = data ?? {};
         const result2 = await ctx.apiClient.cancelAssignment(
           workspace,
           requireNumber(args, "id"),
-          data
+          body
         );
         outputSingle(result2, ctx, COLUMNS8);
       }
@@ -11036,11 +11572,11 @@ var assignmentsDomain = {
       path: ["assignments", "messages", "list"],
       description: "List messages for an assignment",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Assignment ID", required: true }],
+      args: [{ name: "assignment-id", description: "Assignment ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getAssignmentMessages(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "assignment-id")
         );
         outputData(result2, ctx, MESSAGE_COLUMNS3);
       }
@@ -11050,14 +11586,14 @@ var assignmentsDomain = {
       description: "Get an assignment task",
       requiresWorkspace: true,
       args: [
-        { name: "id", description: "Assignment ID", required: true },
-        { name: "task-id", description: "Assignment task ID", required: true }
+        { name: "assignment-id", description: "Assignment ID", required: true },
+        { name: "id", description: "Assignment task ID", required: true }
       ],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getAssignmentTask(
           workspace,
-          requireNumber(args, "id"),
-          requireNumber(args, "task-id")
+          requireNumber(args, "assignment-id"),
+          requireNumber(args, "id")
         );
         outputSingle(result2, ctx, TASK_COLUMNS);
       }
@@ -11066,11 +11602,11 @@ var assignmentsDomain = {
       path: ["assignments", "tasks", "detail"],
       description: "Get current task detail for an assignment",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Assignment ID", required: true }],
+      args: [{ name: "assignment-id", description: "Assignment ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getAssignmentTaskDetail(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "assignment-id")
         );
         outputSingle(result2, ctx, TASK_COLUMNS);
       }
@@ -11078,18 +11614,19 @@ var assignmentsDomain = {
     {
       path: ["assignments", "tasks", "select"],
       description: "Select current assignment task",
+      mutates: true,
       requiresWorkspace: true,
       args: [
-        { name: "id", description: "Assignment ID", required: true },
-        { name: "task-id", description: "Assignment task ID", required: true }
+        { name: "assignment-id", description: "Assignment ID", required: true },
+        { name: "id", description: "Assignment task ID", required: true }
       ],
       handler: async ({ ctx, workspace, args }) => {
         await ctx.apiClient.selectCurrentAssignmentTask(
           workspace,
-          requireNumber(args, "id"),
-          requireNumber(args, "task-id")
+          requireNumber(args, "assignment-id"),
+          requireNumber(args, "id")
         );
-        process.stdout.write(`Selected assignment task ${args["task-id"]}
+        process.stdout.write(`Selected assignment task ${args.id}
 `);
       }
     },
@@ -11097,11 +11634,11 @@ var assignmentsDomain = {
       path: ["assignments", "tools", "list"],
       description: "List tools for an assignment",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Assignment ID", required: true }],
+      args: [{ name: "assignment-id", description: "Assignment ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getAssignmentTools(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "assignment-id")
         );
         const tools = result2.tools ?? result2;
         outputData(Array.isArray(tools) ? tools : [tools], ctx, TOOL_COLUMNS);
@@ -11183,10 +11720,7 @@ var dataTypesDomain = {
       path: ["data-types", "records", "get"],
       description: "Get a data record",
       requiresWorkspace: true,
-      args: [
-        { name: "data-type-id", description: "Data type ID", required: true },
-        { name: "id", description: "Record ID", required: true }
-      ],
+      args: [{ name: "id", description: "Record ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getDataRecord(workspace, requireNumber(args, "id"));
         outputSingle(result2, ctx, RECORD_COLUMNS);
@@ -11530,9 +12064,12 @@ var eventsDomain = {
       path: ["events", "rules", "executions"],
       description: "List executions for an event rule",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Event rule ID", required: true }],
-      handler: async ({ ctx, workspace }) => {
-        const result2 = await ctx.apiClient.getRuleExecutions(workspace);
+      args: [{ name: "rule-id", description: "Event rule ID" }],
+      handler: async ({ ctx, workspace, args }) => {
+        const ruleId = args["rule-id"] ? requireNumber(args, "rule-id") : void 0;
+        const result2 = await ctx.apiClient.getRuleExecutions(workspace, {
+          ...ruleId ? { ruleId } : {}
+        });
         outputData(result2, ctx);
       }
     },
@@ -11566,9 +12103,12 @@ var eventsDomain = {
       path: ["events", "custom", "runs"],
       description: "List runs for a custom event",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Event ID", required: true }],
-      handler: async ({ ctx, workspace }) => {
-        const result2 = await ctx.apiClient.getEventRuns(workspace);
+      args: [{ name: "event-id", description: "Event ID" }],
+      handler: async ({ ctx, workspace, args }) => {
+        const eventId = args["event-id"] ? requireNumber(args, "event-id") : void 0;
+        const result2 = await ctx.apiClient.getEventRuns(workspace, {
+          ...eventId ? { eventId } : {}
+        });
         outputData(result2, ctx);
       }
     }
@@ -11681,11 +12221,14 @@ var calendarsDomain = {
     // Events sub-resource
     {
       path: ["calendars", "events", "list"],
-      description: "List events for a calendar",
+      description: "List calendar events (optionally filter by calendar)",
       requiresWorkspace: true,
-      args: [{ name: "calendar-id", description: "Calendar ID", required: true }],
-      handler: async ({ ctx, workspace }) => {
-        const result2 = await ctx.apiClient.getCalendarEvents(workspace);
+      args: [{ name: "calendar-id", description: "Calendar ID (optional filter)" }],
+      handler: async ({ ctx, workspace, args }) => {
+        const calendarId = args["calendar-id"] ? requireNumber(args, "calendar-id") : void 0;
+        const result2 = await ctx.apiClient.getCalendarEvents(workspace, {
+          ...calendarId ? { calendarId } : {}
+        });
         outputData(result2, ctx, EVENT_COLUMNS2);
       }
     },
@@ -11693,10 +12236,7 @@ var calendarsDomain = {
       path: ["calendars", "events", "get"],
       description: "Get a calendar event",
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getCalendarEvent(
           workspace,
@@ -11710,7 +12250,6 @@ var calendarsDomain = {
       description: "Create a calendar event",
       mutates: true,
       requiresWorkspace: true,
-      args: [{ name: "calendar-id", description: "Calendar ID", required: true }],
       handler: async ({ ctx, workspace, data }) => {
         const result2 = await ctx.apiClient.createCalendarEvent(workspace, data);
         outputSingle(result2, ctx, EVENT_COLUMNS2);
@@ -11721,10 +12260,7 @@ var calendarsDomain = {
       description: "Update a calendar event",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event ID", required: true }],
       handler: async ({ ctx, workspace, args, data }) => {
         const result2 = await ctx.apiClient.updateCalendarEvent(
           workspace,
@@ -11739,10 +12275,7 @@ var calendarsDomain = {
       description: "Cancel a calendar event",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.cancelCalendarEvent(
           workspace,
@@ -11756,10 +12289,7 @@ var calendarsDomain = {
       description: "Delete a calendar event",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         await ctx.apiClient.deleteCalendarEvent(workspace, requireNumber(args, "id"));
         process.stdout.write(`Deleted calendar event ${args.id}
@@ -11769,9 +12299,8 @@ var calendarsDomain = {
     // Event types sub-resource
     {
       path: ["calendars", "event-types", "list"],
-      description: "List event types for a calendar",
+      description: "List calendar event types",
       requiresWorkspace: true,
-      args: [{ name: "calendar-id", description: "Calendar ID", required: true }],
       handler: async ({ ctx, workspace }) => {
         const result2 = await ctx.apiClient.getCalendarEventTypes(workspace);
         outputData(result2, ctx, EVENT_TYPE_COLUMNS);
@@ -11781,10 +12310,7 @@ var calendarsDomain = {
       path: ["calendars", "event-types", "get"],
       description: "Get a calendar event type",
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event type ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event type ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getCalendarEventType(
           workspace,
@@ -11798,7 +12324,6 @@ var calendarsDomain = {
       description: "Create a calendar event type",
       mutates: true,
       requiresWorkspace: true,
-      args: [{ name: "calendar-id", description: "Calendar ID", required: true }],
       handler: async ({ ctx, workspace, data }) => {
         const result2 = await ctx.apiClient.createCalendarEventType(workspace, data);
         outputSingle(result2, ctx, EVENT_TYPE_COLUMNS);
@@ -11809,10 +12334,7 @@ var calendarsDomain = {
       description: "Update a calendar event type",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event type ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event type ID", required: true }],
       handler: async ({ ctx, workspace, args, data }) => {
         const result2 = await ctx.apiClient.updateCalendarEventType(
           workspace,
@@ -11827,10 +12349,7 @@ var calendarsDomain = {
       description: "Delete a calendar event type",
       mutates: true,
       requiresWorkspace: true,
-      args: [
-        { name: "calendar-id", description: "Calendar ID", required: true },
-        { name: "id", description: "Event type ID", required: true }
-      ],
+      args: [{ name: "id", description: "Event type ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         await ctx.apiClient.deleteCalendarEventType(workspace, requireNumber(args, "id"));
         process.stdout.write(`Deleted event type ${args.id}
@@ -12024,27 +12543,27 @@ var phoneNumbersDomain = {
       }
     },
     {
-      path: ["phone-numbers", "calls"],
+      path: ["phone-numbers", "calls", "list"],
       description: "List calls for a phone number",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Phone number ID", required: true }],
+      args: [{ name: "phone-number-id", description: "Phone number ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getPhoneNumberCalls(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "phone-number-id")
         );
         outputData(result2, ctx);
       }
     },
     {
-      path: ["phone-numbers", "messages"],
+      path: ["phone-numbers", "messages", "list"],
       description: "List messages for a phone number",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Phone number ID", required: true }],
+      args: [{ name: "phone-number-id", description: "Phone number ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getPhoneNumberMessages(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "phone-number-id")
         );
         outputData(result2, ctx);
       }
@@ -12079,77 +12598,80 @@ var inboxesDomain = {
       columns: COLUMNS15
     }),
     {
-      path: ["inboxes", "emails"],
+      path: ["inboxes", "emails", "list"],
       description: "List emails in an inbox",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Inbox ID", required: true }],
+      args: [{ name: "inbox-id", description: "Inbox ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
-        const result2 = await ctx.apiClient.getInboxEmails(workspace, requireNumber(args, "id"));
+        const result2 = await ctx.apiClient.getInboxEmails(
+          workspace,
+          requireNumber(args, "inbox-id")
+        );
         outputData(result2, ctx, EMAIL_COLUMNS);
       }
     },
     {
-      path: ["inboxes", "email"],
+      path: ["inboxes", "emails", "get"],
       description: "Get a specific email",
       requiresWorkspace: true,
       args: [
         { name: "inbox-id", description: "Inbox ID", required: true },
-        { name: "email-id", description: "Email ID", required: true }
+        { name: "id", description: "Email ID", required: true }
       ],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getInboxEmail(
           workspace,
           requireNumber(args, "inbox-id"),
-          requireNumber(args, "email-id")
+          requireNumber(args, "id")
         );
         outputSingle(result2, ctx, EMAIL_COLUMNS);
       }
     },
     {
-      path: ["inboxes", "threads"],
+      path: ["inboxes", "emails", "threads"],
       description: "List email threads in an inbox",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "Inbox ID", required: true }],
+      args: [{ name: "inbox-id", description: "Inbox ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getInboxThreads(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "inbox-id")
         );
         outputData(result2, ctx);
       }
     },
     {
-      path: ["inboxes", "mark-read"],
+      path: ["inboxes", "emails", "mark-read"],
       description: "Mark an email as read",
       mutates: true,
       requiresWorkspace: true,
       args: [
         { name: "inbox-id", description: "Inbox ID", required: true },
-        { name: "email-id", description: "Email ID", required: true }
+        { name: "id", description: "Email ID", required: true }
       ],
       handler: async ({ ctx, workspace, args }) => {
         await ctx.apiClient.markEmailAsRead(
           workspace,
           requireNumber(args, "inbox-id"),
-          requireNumber(args, "email-id")
+          requireNumber(args, "id")
         );
         process.stdout.write("Email marked as read\n");
       }
     },
     {
-      path: ["inboxes", "mark-unread"],
+      path: ["inboxes", "emails", "mark-unread"],
       description: "Mark an email as unread",
       mutates: true,
       requiresWorkspace: true,
       args: [
         { name: "inbox-id", description: "Inbox ID", required: true },
-        { name: "email-id", description: "Email ID", required: true }
+        { name: "id", description: "Email ID", required: true }
       ],
       handler: async ({ ctx, workspace, args }) => {
         await ctx.apiClient.markEmailAsUnread(
           workspace,
           requireNumber(args, "inbox-id"),
-          requireNumber(args, "email-id")
+          requireNumber(args, "id")
         );
         process.stdout.write("Email marked as unread\n");
       }
@@ -12499,14 +13021,14 @@ var mcpServersDomain = {
       }
     },
     {
-      path: ["mcp-servers", "tools"],
+      path: ["mcp-servers", "tools", "list"],
       description: "List tools for an MCP server",
       requiresWorkspace: true,
-      args: [{ name: "id", description: "MCP server ID", required: true }],
+      args: [{ name: "mcp-server-id", description: "MCP server ID", required: true }],
       handler: async ({ ctx, workspace, args }) => {
         const result2 = await ctx.apiClient.getMcpServerTools(
           workspace,
-          requireNumber(args, "id")
+          requireNumber(args, "mcp-server-id")
         );
         outputData(result2, ctx);
       }
@@ -12556,7 +13078,7 @@ var apiKeysDomain = {
       }
     },
     {
-      path: ["api-keys", "global-list"],
+      path: ["api-keys", "global", "list"],
       description: "List global/account-level API keys",
       requiresWorkspace: false,
       handler: async ({ ctx }) => {
@@ -12565,8 +13087,9 @@ var apiKeysDomain = {
       }
     },
     {
-      path: ["api-keys", "global-create"],
+      path: ["api-keys", "global", "create"],
       description: "Create a global/account-level API key",
+      mutates: true,
       requiresWorkspace: false,
       handler: async ({ ctx, data }) => {
         const result2 = await ctx.apiClient.createGlobalApiKey(data);
@@ -12574,8 +13097,9 @@ var apiKeysDomain = {
       }
     },
     {
-      path: ["api-keys", "global-revoke"],
+      path: ["api-keys", "global", "revoke"],
       description: "Revoke a global/account-level API key",
+      mutates: true,
       requiresWorkspace: false,
       args: [{ name: "id", description: "API key ID", required: true }],
       handler: async ({ ctx, args }) => {