@gravity-rail/sdk 0.5.1 → 0.7.0

package/dist/index-D1G8EKz2.d.ts

@@ -0,0 +1,1607 @@
+import { pA as WorkspaceFeature, kx as Resource$1, jO as ProductType } from './client-Dft3Kmkn.js';
+import { dR as SortOrder } from './inquiries-BIlL6Obb.js';
+
+interface MemberNotificationPreferences {
+    notifySms?: boolean;
+    notifyEmail?: boolean;
+    notifyVoice?: boolean;
+    notifyWhatsapp?: boolean;
+}
+interface MemberNotifyActionParams {
+    memberId?: number | null;
+    sendToOwner?: boolean;
+    messageTemplate?: string | null;
+}
+
+/** Legacy enum kept for callers using UPPER_SNAKE member names (e.g. ToolkitState.ENABLED). */
+declare enum ToolkitState {
+    DISABLED = "disabled",
+    ENABLED = "enabled",
+    AUTH = "auth"
+}
+interface ToolParameter {
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean;
+    enum?: string[];
+    default?: any;
+}
+
+/**
+ * Generated by Orval (filtered by scripts/types-codegen/allowlist.txt and
+ * grouped by scripts/types-codegen/group_generated.ts).  Do not edit manually.
+ * Group: workspace_health
+ */
+/**
+ * Information about an attached addon product.
+ */
+interface AttachedAddonInfo {
+    subscriptionId: number;
+    productId: number;
+    productName: string;
+    providesFeatures: string[];
+}
+/**
+ * Request body for switching a workspace's product (plan).
+ *
+ * The caller supplies the target product id only — the server resolves
+ * the active workspace SubscriptionItem, updates the matching Stripe
+ * workspace line item when one exists (``proration_behavior=none``),
+ * and re-syncs workspace features. Provisioning is not re-run.
+ */
+interface ChangeWorkspaceProductRequest {
+    productId: number;
+}
+/**
+ * Response payload for a successful workspace product switch.
+ */
+interface ChangeWorkspaceProductResponse {
+    workspaceUuid: string;
+    subscriptionId: number;
+    subscriptionItemId: number;
+    previousProductId: number;
+    newProductId: number;
+    previousProductName: string;
+    newProductName: string;
+    addedFeatures: string[];
+    removedFeatures: string[];
+    stripeUpdated?: boolean;
+    stripeSkipReason?: string | null;
+}
+/**
+ * Information about the workspace's current plan.
+ */
+interface CurrentPlanInfo {
+    subscriptionId: number;
+    productId: number;
+    productName: string;
+    productType: string;
+    planPeriod: string;
+    subscriptionStatus: string;
+    providesFeatures: string[];
+}
+/**
+ * Feature sync status between workspace and subscription.
+ */
+interface FeatureSyncStatus {
+    inSync: boolean;
+    missingFeatures: string[];
+    extraFeatures: string[];
+    dependencyErrors: string[];
+}
+/**
+ * Response model for provision-plan endpoint.
+ */
+interface ProvisionPlanResponse {
+    success: boolean;
+    workspaceUuid: string;
+    previousFeatures: string[];
+    newFeatures: string[];
+    addedFeatures: string[];
+    removedFeatures: string[];
+    message: string;
+}
+/**
+ * Response model for workspace health check.
+ */
+interface WorkspaceHealthResponse$1 {
+    workspaceUuid: string;
+    workspaceName: string;
+    dbStatus: string;
+    dbStatusCode: number;
+    currentPlan?: CurrentPlanInfo | null;
+    attachedAddons?: AttachedAddonInfo[];
+    featureSync: FeatureSyncStatus;
+    expectedFeatures: string[];
+    currentFeatures: string[];
+}
+
+type WorkspaceHealthResponse = Omit<WorkspaceHealthResponse$1, 'attachedAddons'> & {
+    attachedAddons: AttachedAddonInfo[];
+};
+interface ProvisionPlanRequest {
+    subscriptionId?: number;
+}
+
+interface TaskCountResponse {
+    taskCount: number;
+}
+interface EmailCountsResponse {
+    emailCount?: number;
+    unreadCount?: number;
+}
+interface MetricValue {
+    value: number;
+    label: string;
+    change?: number;
+    changeType?: 'increase' | 'decrease' | 'neutral';
+}
+interface TimeSeriesDataPoint {
+    timestamp: string;
+    value: number;
+    label?: string;
+}
+interface TimeSeriesData {
+    data: TimeSeriesDataPoint[];
+    period: 'hour' | 'day' | 'week' | 'month' | 'year';
+    startDate: string;
+    endDate: string;
+}
+interface StatisticsSummary {
+    total: number;
+    active: number;
+    inactive: number;
+    growth: number;
+    growthPercentage: number;
+}
+interface AnalyticsFilter {
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    memberIds?: number[];
+    taskIds?: number[];
+    siteIds?: number[];
+    dataTypeIds?: number[];
+}
+interface AnalyticsQuery {
+    filters?: AnalyticsFilter;
+    groupBy?: 'day' | 'week' | 'month' | 'year' | 'member' | 'task' | 'site';
+    sortBy?: string;
+    sortOrder?: SortOrder;
+    limit?: number;
+    offset?: number;
+}
+interface DashboardMetrics {
+    totalMembers: number;
+    activeMembers: number;
+    totalTasks: number;
+    completedTasks: number;
+    totalChats: number;
+    activeChats: number;
+    totalSites: number;
+    activeSites: number;
+    recentActivity: TimeSeriesData;
+    memberGrowth: TimeSeriesData;
+    taskCompletion: TimeSeriesData;
+}
+interface PerformanceMetrics {
+    averageResponseTime: number;
+    taskCompletionRate: number;
+    memberSatisfactionScore: number;
+    systemUptime: number;
+    errorRate: number;
+    throughput: number;
+}
+interface ExportStatistics {
+    totalRecords: number;
+    exportedRecords: number;
+    failedRecords: number;
+    processingTime: number;
+    fileSize: number;
+    exportFormat: 'csv' | 'json' | 'xlsx';
+}
+interface ImportStatistics {
+    totalRecords: number;
+    importedRecords: number;
+    failedRecords: number;
+    duplicateRecords: number;
+    processingTime: number;
+    validationErrors: string[];
+}
+interface UsageStatistics {
+    apiCalls: number;
+    storageUsed: number;
+    bandwidthUsed: number;
+    activeUsers: number;
+    peakConcurrentUsers: number;
+    averageSessionDuration: number;
+}
+interface BillingStatistics {
+    currentPeriodUsage: UsageStatistics;
+    previousPeriodUsage: UsageStatistics;
+    projectedUsage: UsageStatistics;
+    costBreakdown: {
+        category: string;
+        amount: number;
+        unit: string;
+    }[];
+}
+interface HealthCheckStatistics {
+    serviceStatus: 'healthy' | 'degraded' | 'unhealthy';
+    uptime: number;
+    responseTime: number;
+    errorCount: number;
+    warningCount: number;
+    lastChecked: string;
+}
+interface SystemStatistics {
+    cpu: number;
+    memory: number;
+    storage: number;
+    network: number;
+    activeConnections: number;
+    queueLength: number;
+    healthChecks: HealthCheckStatistics[];
+}
+
+/**
+ * Generated by Orval (filtered by scripts/types-codegen/allowlist.txt and
+ * grouped by scripts/types-codegen/group_generated.ts).  Do not edit manually.
+ * Group: usage
+ */
+/**
+ * AI model usage breakdown response.
+ */
+interface AIModelUsageResponse {
+    modelId: string;
+    rawTokens: number;
+    credits: number;
+    multiplier: number;
+    inputMultiplier?: number | null;
+    outputMultiplier?: number | null;
+    cachedMultiplier?: number | null;
+    messageCount: number;
+}
+/**
+ * AI usage details response.
+ */
+interface AIUsageDetailsResponse {
+    total: number;
+    chat: number;
+    realtime: number;
+    image: number;
+    video: number;
+    models: AIModelUsageResponse[];
+}
+/**
+ * Communication details including phone numbers and daily breakdowns.
+ */
+interface CommunicationDetailsResponse {
+    sms: SMSCommunicationDetailsResponse;
+    phone: PhoneCommunicationDetailsResponse;
+}
+/**
+ * Daily phone call usage row for charts and exports.
+ */
+interface DailyPhoneRowResponse {
+    date: string;
+    phoneNumberId: number;
+    phoneNumber: string;
+    phoneName: string | null;
+    inbound: number;
+    outbound: number;
+    totalDurationSeconds: number;
+}
+/**
+ * Daily SMS usage row for charts and exports.
+ */
+interface DailySMSRowResponse {
+    date: string;
+    phoneNumberId: number;
+    phoneNumber: string;
+    phoneName: string | null;
+    inbound: number;
+    outbound: number;
+    totalChars: number;
+    totalSegments?: number;
+}
+/**
+ * Efficiency metrics summary.
+ */
+interface EfficiencyMetricsResponse {
+    workspacesOverBudget: number;
+    averageUtilizationRate: number;
+}
+/**
+ * Email usage response.
+ */
+interface EmailUsageResponse {
+    total: number;
+    sent: number;
+    received: number;
+}
+/**
+ * Phone call usage details for a phone number.
+ */
+interface PhoneCallPhoneNumberUsageResponse {
+    phoneNumberId: number;
+    phoneNumber: string;
+    phoneName: string | null;
+    inbound: number;
+    outbound: number;
+    totalDurationSeconds: number;
+}
+/**
+ * Phone call usage response.
+ */
+interface PhoneCallUsageResponse {
+    totalMinutes: number;
+    inbound: number;
+    outbound: number;
+}
+/**
+ * Detailed phone communication data.
+ */
+interface PhoneCommunicationDetailsResponse {
+    phoneNumbers: PhoneCallPhoneNumberUsageResponse[];
+    dailyRows: DailyPhoneRowResponse[];
+}
+/**
+ * Product overage configuration response.
+ */
+interface ProductOverageConfigResponse {
+    id: number | null;
+    name: string;
+    unitType: string;
+    unitCost: number;
+}
+/**
+ * Resource types tracked by the billing system.
+ *
+ * Two categories:
+ * - Usage resources: consumed over time, tracked per billing period.
+ *   Each has a credit cost defined in CREDITS_PER_UNIT. Credits are
+ *   the unified billing currency; resources are what you actually consume.
+ * - State resources: current count, not cumulative (members, sites, etc.)
+ */
+type Resource = (typeof Resource)[keyof typeof Resource];
+declare const Resource: {
+    readonly credit: "credit";
+    readonly stt: "stt";
+    readonly tts: "tts";
+    readonly sms: "sms";
+    readonly email: "email";
+    readonly phone_call: "phone_call";
+    readonly phone_number: "phone_number";
+    readonly inbox: "inbox";
+    readonly site: "site";
+    readonly member: "member";
+    readonly workspace: "workspace";
+    readonly org_admin: "org_admin";
+    readonly storage_mb: "storage_mb";
+};
+/**
+ * Resource overage details response.
+ */
+interface ResourceOverageResponse {
+    included: number;
+    used: number;
+    overageAmount: number;
+    overageCostCents: number;
+}
+/**
+ * Resource usage breakdown response.
+ */
+interface ResourceUsageResponse {
+    credit: AIUsageDetailsResponse;
+    sms: SMSMessageUsageResponse;
+    phoneCall: PhoneCallUsageResponse;
+    email: EmailUsageResponse;
+    storageMb: number;
+    member: number;
+    phoneNumber: number;
+    site: number;
+    inbox: number;
+}
+/**
+ * Detailed SMS communication data.
+ */
+interface SMSCommunicationDetailsResponse {
+    totalCharacters: number;
+    totalSegments?: number;
+    phoneNumbers: SMSPhoneNumberUsageResponse[];
+    dailyRows: DailySMSRowResponse[];
+}
+/**
+ * SMS message usage response.
+ */
+interface SMSMessageUsageResponse {
+    total: number;
+    inbound: number;
+    outbound: number;
+    totalSegments?: number;
+}
+/**
+ * SMS usage details for a phone number.
+ */
+interface SMSPhoneNumberUsageResponse {
+    phoneNumberId: number;
+    phoneNumber: string;
+    phoneName: string | null;
+    inbound: number;
+    outbound: number;
+    totalChars: number;
+    totalSegments?: number;
+}
+/**
+ * Top resource overage summary.
+ */
+interface TopResourceOverageResponse {
+    resource: string;
+    overageCostCents: number;
+}
+/**
+ * Product summary for usage reporting.
+ */
+interface UsageProductSummaryResponse {
+    id: number;
+    name: string;
+    inclusions: UsageProductSummaryResponseInclusions;
+    overages: UsageProductSummaryResponseOverages;
+}
+type UsageProductSummaryResponseInclusions = {
+    [key: string]: number;
+};
+type UsageProductSummaryResponseOverages = {
+    [key: string]: ProductOverageConfigResponse;
+};
+/**
+ * Usage report response.
+ */
+interface UsageReportResponse {
+    workspaces: WorkspaceUsageReportResponse[];
+    summary: UsageReportSummaryResponse;
+}
+/**
+ * Summary metrics for usage report.
+ */
+interface UsageReportSummaryResponse {
+    totalOverageCostCents: number;
+    topResourcesByOverage: TopResourceOverageResponse[];
+    efficiencyMetrics: EfficiencyMetricsResponse;
+}
+/**
+ * Workspace usage report response.
+ */
+interface WorkspaceUsageReportResponse {
+    uuid: string;
+    name: string;
+    slug: string;
+    product: UsageProductSummaryResponse;
+    usage: ResourceUsageResponse;
+    overages: Partial<Record<Resource, ResourceOverageResponse>>;
+    totalOverageCostCents: number;
+    communicationDetails: CommunicationDetailsResponse;
+}
+
+interface PhoneNumberUsage {
+    phoneNumberId: number;
+    phoneNumber: string;
+    phoneName: string | null;
+    inbound: number;
+    outbound: number;
+}
+interface UsageReportRequest {
+    workspaceUuids: string[];
+    startDate: string;
+    endDate: string;
+}
+interface MemberUsageReport {
+    memberId: number;
+    periodStart: string;
+    periodEnd: string;
+    totalChats: number;
+    totalMessages: number;
+    totalCredits: number;
+}
+
+/**
+ * Generated by Orval (filtered by scripts/types-codegen/allowlist.txt and
+ * grouped by scripts/types-codegen/group_generated.ts).  Do not edit manually.
+ * Group: voice_metrics
+ */
+interface CallEndSection$1 {
+    statuses: CallEndStatusEntry$1[];
+    totalCalls?: number;
+    successRate?: number;
+}
+interface CallEndStatusEntry$1 {
+    status: string;
+    total?: number;
+    timeSeries?: MetricDataPoint[];
+}
+interface EngineTimeSeries {
+    engine: string;
+    timeSeries: MetricDataPoint[];
+}
+interface MetricDataPoint {
+    timestamp: string;
+    value: number;
+}
+interface MetricSection$1 {
+    metricName: string;
+    label: string;
+    unit: string;
+    description?: string;
+    timeSeries: MetricDataPoint[];
+    summary: MetricSummary$1;
+    byEngine?: EngineTimeSeries[] | null;
+}
+interface MetricSummary$1 {
+    avg?: number;
+    min?: number;
+    max?: number;
+    count?: number;
+    p50?: number;
+    p90?: number;
+    p99?: number;
+    has_distribution?: boolean;
+}
+interface RequestsSection$1 {
+    statuses: RequestsStatusEntry$1[];
+    totalRequests?: number;
+    successRate?: number;
+}
+interface RequestsStatusEntry$1 {
+    status: string;
+    total?: number;
+    timeSeries?: MetricDataPoint[];
+}
+interface TtsReconnectOutcomeEntry$1 {
+    outcome: string;
+    total?: number;
+    timeSeries?: MetricDataPoint[];
+}
+interface TtsReconnectSection$1 {
+    outcomes: TtsReconnectOutcomeEntry$1[];
+    totalReconnects?: number;
+    successRate?: number;
+    duration?: MetricSection$1 | null;
+}
+interface VoiceMetricsResponse$1 {
+    voice: MetricSection$1[];
+    chat: MetricSection$1[];
+    callEnd: CallEndSection$1;
+    requests: RequestsSection$1;
+    ttsReconnect: TtsReconnectSection$1;
+    timeRange: VoiceMetricsTimeRange;
+    availableEngines?: string[];
+    availableChannels?: string[];
+}
+interface VoiceMetricsTimeRange {
+    start: string;
+    end: string;
+    hours: number;
+    periodSeconds: number;
+}
+
+/** Admin dashboards treat absent aggregates as zero. */
+type MetricSummary = Required<Pick<MetricSummary$1, 'avg' | 'min' | 'max' | 'count' | 'p50' | 'p90' | 'p99'>> & Omit<MetricSummary$1, 'avg' | 'min' | 'max' | 'count' | 'p50' | 'p90' | 'p99'>;
+type MetricSection = Omit<MetricSection$1, 'summary' | 'timeSeries'> & {
+    summary: MetricSummary;
+    timeSeries: MetricDataPoint[];
+};
+type CallEndStatusEntry = Omit<CallEndStatusEntry$1, 'total' | 'timeSeries'> & {
+    total: number;
+    timeSeries: MetricDataPoint[];
+};
+type CallEndSection = Omit<CallEndSection$1, 'statuses' | 'totalCalls'> & {
+    statuses: CallEndStatusEntry[];
+    totalCalls: number;
+};
+type RequestsStatusEntry = Omit<RequestsStatusEntry$1, 'total' | 'timeSeries'> & {
+    total: number;
+    timeSeries: MetricDataPoint[];
+};
+type RequestsSection = Omit<RequestsSection$1, 'statuses' | 'totalRequests'> & {
+    statuses: RequestsStatusEntry[];
+    totalRequests: number;
+};
+type TtsReconnectOutcomeEntry = Omit<TtsReconnectOutcomeEntry$1, 'total' | 'timeSeries'> & {
+    total: number;
+    timeSeries: MetricDataPoint[];
+};
+type TtsReconnectSection = Omit<TtsReconnectSection$1, 'outcomes' | 'totalReconnects' | 'duration'> & {
+    outcomes: TtsReconnectOutcomeEntry[];
+    totalReconnects: number;
+    duration?: MetricSection | null;
+};
+type VoiceMetricsResponse = Omit<VoiceMetricsResponse$1, 'voice' | 'chat' | 'callEnd' | 'requests' | 'ttsReconnect'> & {
+    voice: MetricSection[];
+    chat: MetricSection[];
+    callEnd: CallEndSection;
+    requests: RequestsSection;
+    ttsReconnect: TtsReconnectSection;
+};
+
+/**
+ * Generated by Orval (filtered by scripts/types-codegen/allowlist.txt and
+ * grouped by scripts/types-codegen/group_generated.ts).  Do not edit manually.
+ * Group: health_dashboard
+ */
+/**
+ * Channel delivery failure and volume counts.
+ */
+interface ChannelFailures {
+    smsFailures?: number;
+    smsTotal?: number;
+    smsResponded?: number;
+    smsOutboundChats?: number;
+    voiceFailures?: number;
+    voiceTotal?: number;
+    emailFailures?: number;
+    emailTotal?: number;
+    smsTopFailurePhoneNumberId?: number | null;
+    voiceTopFailurePhoneNumberId?: number | null;
+}
+/**
+ * Event rule execution failure and volume counts.
+ */
+interface EventRuleMetrics {
+    failures?: number;
+    total?: number;
+}
+/**
+ * Response for the health metrics endpoint.
+ */
+interface HealthMetricsResponse {
+    summary: HealthSummary;
+    previousSummary?: HealthSummary | null;
+    workspaces: WorkspaceHealthRow[];
+    skippedWorkspaces?: SkippedWorkspace[];
+    hours: number;
+}
+/**
+ * Aggregate summary across all queried workspaces.
+ */
+interface HealthSummary {
+    totalWorkspaces?: number;
+    criticalCount?: number;
+    warningCount?: number;
+    healthyCount?: number;
+    totalSmsFailures?: number;
+    totalSmsVolume?: number;
+    totalVoiceFailures?: number;
+    totalVoiceVolume?: number;
+    totalEmailFailures?: number;
+    totalEmailVolume?: number;
+    totalEventRuleFailures?: number;
+    totalEventRuleVolume?: number;
+    totalWebhookFailures?: number;
+    totalWebhookVolume?: number;
+    totalSmsResponded?: number;
+    totalSmsOutboundChats?: number;
+    totalMemberChats?: number;
+    totalNeedsResponse?: number;
+    totalAccessGapWarnings?: number;
+}
+/**
+ * A workspace that was skipped during metrics collection.
+ */
+interface SkippedWorkspace {
+    uuid: string;
+    reason: string;
+}
+/**
+ * Webhook delivery failure and volume counts.
+ */
+interface WebhookMetrics {
+    failures?: number;
+    total?: number;
+}
+/**
+ * Health metrics for a single workspace.
+ */
+interface WorkspaceHealthRow {
+    workspaceUuid: string;
+    workspaceName: string;
+    organizationId: number;
+    organizationName?: string | null;
+    statusCode: number;
+    statusLabel: string;
+    healthStatus: string;
+    channelFailures: ChannelFailures;
+    eventRules: EventRuleMetrics;
+    webhooks: WebhookMetrics;
+    memberChats?: number;
+    needsResponse?: number;
+    accessGapWarnings?: number;
+}
+
+interface HealthMetricsRequest {
+    workspaceUuids?: string[];
+    organizationIds?: number[];
+    hours?: number;
+}
+interface ErrorCodeBucket {
+    code: string;
+    count: number;
+    label: string | null;
+}
+interface TopOffender {
+    id: number;
+    name: string | null;
+    identifier: string | null;
+    failureCount: number;
+}
+interface ChannelErrorBreakdown {
+    byCodes: ErrorCodeBucket[];
+    topResources: TopOffender[];
+}
+interface WorkspaceHealthDetail {
+    workspaceUuid: string;
+    hours: number;
+    sms: ChannelErrorBreakdown | null;
+    voice: ChannelErrorBreakdown | null;
+    webhooks: ChannelErrorBreakdown | null;
+    eventRules: ChannelErrorBreakdown | null;
+}
+interface HealthDetailRequest {
+    hours?: number;
+}
+
+/**
+ * App context types - shared between client and server
+ *
+ * These types represent the current state of the user's interaction with the app,
+ * providing context to AI assistants about what the user is viewing/editing.
+ */
+/**
+ * Information about a site in the context
+ */
+interface SiteContext {
+    id: number;
+    name?: string;
+    slug?: string;
+}
+/**
+ * Information about a page in the context
+ */
+interface PageContext {
+    id: number;
+    name?: string;
+    slug?: string;
+}
+/**
+ * Information about a workflow in the context
+ */
+interface WorkflowContext {
+    id: number;
+    name?: string;
+    selectedTask?: TaskContext;
+}
+/**
+ * Information about a task in the context
+ */
+interface TaskContext {
+    id: number;
+    name?: string;
+}
+/**
+ * Information about a data record in the context
+ */
+interface DataRecordContext {
+    id: number;
+    type?: string;
+    name?: string;
+}
+/**
+ * Information about a toolkit in the context
+ */
+interface ToolkitContext {
+    id: string;
+    name?: string;
+}
+/**
+ * App context provided to AI assistants
+ *
+ * This represents the current page/state the user is in,
+ * allowing the AI to provide context-aware assistance.
+ */
+interface AppContext {
+    /** Current page URI (e.g., 'app:page:workflows/123') */
+    appUri?: string;
+    /** Current browser URL for linking back to this page */
+    pageUrl?: string;
+    /** Auto-approve all tool calls without HITL interruption */
+    autoApprove?: boolean;
+    /** Enable deep thinking mode for the current session */
+    deepThink?: boolean;
+    /** Setup spec IDs linked to the current workspace that are pending execution. */
+    pendingSetupSpecIds?: number[];
+    /** Additional structured page state */
+    pageState?: {
+        /** Route parameters from Next.js */
+        routeParams?: Record<string, string | string[]>;
+        /** Site being viewed/edited */
+        site?: SiteContext;
+        /** Page being viewed/edited */
+        page?: PageContext;
+        /** Workflow being viewed/edited */
+        workflow?: WorkflowContext;
+        /** Data record being viewed/edited */
+        dataRecord?: DataRecordContext;
+        /** Toolkit being viewed */
+        toolkit?: ToolkitContext;
+        /** Open drawers/modals */
+        openDrawers?: string[];
+        /** Selected tabs */
+        selectedTabs?: string[];
+        /** Any other page-specific state */
+        [key: string]: any;
+    };
+}
+/**
+ * Format app context as markdown for display in bug reports, etc.
+ */
+declare function formatAppContextAsMarkdown(context: AppContext | undefined): string;
+
+type OpenAITurnDetectionType = 'semantic_vad' | 'server_vad';
+type OpenAISemanticVADEagerness = 'low' | 'medium' | 'high' | 'auto';
+interface OpenAISemanticVADTurnDetection {
+    type: 'semantic_vad';
+    eagerness?: OpenAISemanticVADEagerness;
+    create_response?: boolean;
+    interrupt_response?: boolean;
+}
+interface OpenAIServerVADTurnDetection {
+    type: 'server_vad';
+    threshold?: number;
+    prefix_padding_ms?: number;
+    silence_duration_ms?: number;
+    create_response?: boolean;
+    interrupt_response?: boolean;
+}
+type OpenAITurnDetection = OpenAISemanticVADTurnDetection | OpenAIServerVADTurnDetection;
+type ThinkingSound = 'none' | 'typing' | 'strumming' | 'speech';
+type InterruptionSound = 'none' | 'clav' | 'bells' | 'organ' | 'guzheng';
+/** Default filler phrases suggested when the user first enables "speech" mode. */
+declare const DEFAULT_THINKING_SPEECH_PHRASES: readonly string[];
+type TTSModel = 'native' | 'elevenlabs:tts:eleven_turbo_v2' | 'elevenlabs:tts:eleven_turbo_v2_5' | 'elevenlabs:tts:eleven_multilingual_v2' | 'elevenlabs:tts:eleven_flash_v2_5' | 'openai:tts:tts-1' | 'openai:tts:tts-1-hd' | 'openai:tts:gpt-4o-mini-tts' | 'aws:tts:polly-generative' | 'aws:tts:polly-neural' | 'google:tts:chirp';
+/** Extract the provider from a TTSModel ID (e.g. "elevenlabs:tts:eleven_flash_v2_5" -> "elevenlabs"). */
+declare function getTTSProvider(ttsModel: string | null | undefined): string | null;
+/**
+ * Base configuration for all realtime models.
+ * Contains common fields that apply to all realtime model providers.
+ */
+interface BaseRealtimeModelConfig {
+    /** Sound to play while the agent is processing tool calls. */
+    thinkingSound?: ThinkingSound | null;
+    /** Volume level for the thinking sound (0-100). 0 means muted. Missing or null means full volume (100). */
+    thinkingSoundVolume?: number | null;
+    /** Initial delay in milliseconds before playing thinking sound. Prevents needless interruption on short tool calls. Default: 500ms. */
+    thinkingSoundInitialDelay?: number | null;
+    /** When `thinkingSound` is 'speech', one of these phrases is spoken while the agent runs a tool. Phrases rotate round-robin per session. */
+    thinkingSpeechPhrases?: string[] | null;
+    /** Sound to play when user stops speaking after interrupting the assistant. Provides immediate auditory feedback that input was received. Default: none. */
+    interruptionSound?: InterruptionSound | null;
+    /** Volume level for the interruption sound (0-100). 0 means muted. Missing or null means full volume (100). */
+    interruptionSoundVolume?: number | null;
+    /** TTS model ID in provider:tts:model format (e.g. 'elevenlabs:tts:eleven_flash_v2_5'), or 'native'. */
+    ttsModel?: TTSModel | null;
+    /** Canonical voice identifier (e.g., elevenlabs:voice:catt) that selects the specific agent voice. */
+    voiceModel?: string | null;
+}
+/**
+ * Native realtime providers always use the model's built-in audio. The
+ * backend Pydantic schemas now enforce `ttsModel: "native"` and reject
+ * external `sttModel`. Mirroring that contract on the client surface
+ * keeps the editor in sync — see `useVoiceConfig.buildSubmitConfig`.
+ */
+interface OpenAIRealtimeModelConfig extends BaseRealtimeModelConfig {
+    ttsModel?: 'native' | null;
+    turnDetection?: OpenAITurnDetection | null;
+}
+interface GeminiRealtimeModelConfig extends BaseRealtimeModelConfig {
+    ttsModel?: 'native' | null;
+}
+interface CustomRealtimeModelConfig extends BaseRealtimeModelConfig {
+    sttModel?: string | null;
+    sttConfig?: Record<string, unknown> | null;
+    inferenceModel: string;
+    inferenceModelConfig?: ChatModelConfig | null;
+}
+interface AWSRealtimeModelConfig extends BaseRealtimeModelConfig {
+    ttsModel?: 'native' | null;
+}
+/**
+ * xAI Voice Agent realtime config. Only `server_vad` is supported, so
+ * the server-side schema rejects `semantic_vad`. Mirrors
+ * `lib/constants.py:XAIRealtimeModelConfig`.
+ */
+interface XAIRealtimeModelConfig extends BaseRealtimeModelConfig {
+    ttsModel?: 'native' | null;
+    turnDetection?: OpenAIServerVADTurnDetection | null;
+}
+type RealtimeModelConfig = OpenAIRealtimeModelConfig | GeminiRealtimeModelConfig | CustomRealtimeModelConfig | AWSRealtimeModelConfig | XAIRealtimeModelConfig;
+type GeminiThinkingLevel = 'minimal' | 'low' | 'medium' | 'high';
+type OpenAIReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
+/**
+ * xAI (Grok) reasoning levels. Note "none" disables reasoning entirely
+ * (used by Grok 4.3 to switch into non-reasoning mode); xAI does NOT
+ * accept OpenAI's "minimal".
+ * https://docs.x.ai/developers/model-capabilities/text/reasoning#effort-levels
+ */
+type XAIReasoningEffort = 'none' | 'low' | 'medium' | 'high';
+/**
+ * Base configuration for all chat models.
+ * Can be extended for provider-specific options.
+ */
+interface BaseChatModelConfig {
+}
+interface GeminiChatModelConfig extends BaseChatModelConfig {
+    thinkingLevel?: GeminiThinkingLevel | null;
+    includeThoughts?: boolean | null;
+}
+interface ClaudeChatModelConfig extends BaseChatModelConfig {
+    thinkingEnabled?: boolean | null;
+    thinkingBudgetTokens?: number | null;
+}
+interface OpenAIChatModelConfig extends BaseChatModelConfig {
+    provider: 'openai';
+    reasoningEffort?: OpenAIReasoningEffort | null;
+}
+interface XAIChatModelConfig extends BaseChatModelConfig {
+    provider: 'xai';
+    reasoningEffort?: XAIReasoningEffort | null;
+}
+type ChatModelConfig = GeminiChatModelConfig | ClaudeChatModelConfig | OpenAIChatModelConfig | XAIChatModelConfig;
+/**
+ * Supported TTS preview providers.
+ * These are the voice providers that support TTS preview in the UI.
+ */
+declare const TTS_PREVIEW_PROVIDERS: readonly ["openai", "elevenlabs", "google", "aws", "pocket", "deepgram", "xai"];
+type TTSPreviewProvider = (typeof TTS_PREVIEW_PROVIDERS)[number];
+/**
+ * Get the canonical voice model ID from a realtime model config.
+ *
+ * Voice model IDs follow the format: `{provider}:voice:{voiceName}`
+ * Examples:
+ * - `openai:voice:ash`
+ * - `elevenlabs:voice:catt`
+ * - `google:voice:puck`
+ *
+ * @param entity - An object with optional realtimeModelConfig
+ * @returns The canonical voice model ID, or null if no voice is configured
+ */
+declare function getVoiceModelId(entity: {
+    realtimeModelConfig?: RealtimeModelConfig | null;
+}): string | null;
+/**
+ * Check if an entity's voice can be previewed.
+ *
+ * @param entity - An object with optional realtimeModelConfig
+ * @returns True if the entity's voice supports TTS preview
+ */
+declare function canPreviewVoice(entity: {
+    realtimeModelConfig?: RealtimeModelConfig | null;
+}): boolean;
+
+/**
+ * Default AI model constants shared across the frontend.
+ *
+ * These are used as fallback defaults when creating new agents, assistants,
+ * and other entities that require a model selection.
+ */
+/** Default chat/inference model for new agents and assistants. */
+declare const DEFAULT_CHAT_MODEL = "aws:bedrock:claude-4-5-haiku";
+/** Default inference model for custom voice stack. */
+declare const DEFAULT_VOICE_INFERENCE_MODEL = "google:vertex:gemini-3-flash";
+/** Default voice model for custom realtime configurations. */
+declare const DEFAULT_CUSTOM_VOICE_MODEL = "elevenlabs:voice:river";
+
+/**
+ * Resource metadata for products
+ *
+ * Defines labels, units, and descriptions for each resource type
+ */
+
+/** Scope defines where a resource can be configured */
+type ResourceScope = 'workspace' | 'org' | 'any';
+interface ResourceMetadata {
+    label: string;
+    unit: string;
+    unitPlural: string;
+    description: string;
+    /** Feature required to use this resource (null means always available) */
+    requiresFeature: WorkspaceFeature | null;
+    /** Where this resource can be configured */
+    scope: ResourceScope;
+}
+/**
+ * Get metadata for a specific resource
+ */
+declare function getResourceMetadata(resource: Resource$1): ResourceMetadata | undefined;
+/**
+ * Get all available resource slugs
+ */
+declare function getAllResourceSlugs(): Resource$1[];
+/**
+ * Get the scope ('workspace' or 'org') for a product type.
+ */
+declare function getScopeFromProductType(productType: ProductType): ResourceScope;
+/**
+ * Get resources applicable to a given scope and optional feature set.
+ *
+ * @param scope - 'workspace', 'org', or 'any' to filter by where resources can be configured
+ * @param enabledFeatures - Optional list of enabled features. If provided, resources requiring
+ *                          features not in this list will be excluded. If null/undefined,
+ *                          all resources matching the scope are returned.
+ */
+declare function getApplicableResources(scope: ResourceScope, enabledFeatures?: WorkspaceFeature[] | null): Resource$1[];
+/**
+ * Get resources applicable to a product type.
+ * This is a convenience wrapper around getApplicableResources that derives scope from product type.
+ * Does not filter by features - use getApplicableResources directly for feature-based filtering.
+ */
+declare function getApplicableResourceSlugs(productType: ProductType): Resource$1[];
+
+/**
+ * Centralized OAuth and API scope management for TypeScript/JavaScript clients.
+ *
+ * This module provides all available scopes for Applications and API keys,
+ * serving as a single source of truth for permission management across frontend
+ * and TypeScript-based services (like MCP servers).
+ *
+ * IMPORTANT: Keep in sync with lib/context/scopes.py
+ */
+/**
+ * Categories of scopes for organization
+ * Must match namespaces used in Python Scope enum
+ */
+declare enum ScopeCategory {
+    WORKSPACE = "workspace",
+    MEMBERS = "members",
+    MEMBER_ROLES = "member_roles",
+    CHATS = "chats",
+    DM = "dm",
+    WORKFLOWS = "workflows",
+    ASSIGNMENTS = "assignments",
+    AUTOMATIONS = "automations",
+    DATATYPES = "datatypes",
+    RECORDS = "records",
+    FILES = "files",
+    JOURNEYS = "journeys",
+    EXPERIMENTS = "experiments",
+    SITES = "sites",
+    AGENTS = "agents",
+    CALENDARS = "calendars",
+    INBOXES = "inboxes",
+    PHONES = "phones",
+    WEBHOOKS = "webhooks",
+    APPS = "apps",
+    LABELS = "labels",
+    ANALYTICS = "analytics",
+    OPERATOR = "operator",
+    EXPORT = "export",
+    ORG = "org"
+}
+/**
+ * Individual scope definition
+ */
+interface ScopeDefinition {
+    /** The scope identifier (e.g., "workspace:read") */
+    name: string;
+    /** The category this scope belongs to */
+    category: ScopeCategory;
+    /** Human-readable description of what this scope allows */
+    description: string;
+    /** List of other scopes this scope automatically includes */
+    implies?: readonly string[];
+    /** Whether this scope should be highlighted as dangerous */
+    dangerous?: boolean;
+}
+/**
+ * All available OAuth scopes
+ * Must match Python Scope enum in lib/context/scopes.py
+ */
+declare const SCOPES: {
+    readonly 'workspace:read': {
+        readonly name: "workspace:read";
+        readonly category: ScopeCategory.WORKSPACE;
+        readonly description: "View workspace settings";
+    };
+    readonly 'workspace:write': {
+        readonly name: "workspace:write";
+        readonly category: ScopeCategory.WORKSPACE;
+        readonly description: "Modify workspace settings";
+        readonly implies: readonly ["workspace:read"];
+    };
+    readonly 'workspace:admin': {
+        readonly name: "workspace:admin";
+        readonly category: ScopeCategory.WORKSPACE;
+        readonly description: "Full workspace control";
+        readonly implies: readonly ["workspace:write"];
+        readonly dangerous: true;
+    };
+    readonly 'members:read': {
+        readonly name: "members:read";
+        readonly category: ScopeCategory.MEMBERS;
+        readonly description: "View all members";
+    };
+    readonly 'members:write': {
+        readonly name: "members:write";
+        readonly category: ScopeCategory.MEMBERS;
+        readonly description: "Create and update members";
+        readonly implies: readonly ["members:read"];
+    };
+    readonly 'members:admin': {
+        readonly name: "members:admin";
+        readonly category: ScopeCategory.MEMBERS;
+        readonly description: "Delete members, manage permissions";
+        readonly implies: readonly ["members:write"];
+        readonly dangerous: true;
+    };
+    readonly 'member_roles:read': {
+        readonly name: "member_roles:read";
+        readonly category: ScopeCategory.MEMBER_ROLES;
+        readonly description: "View role definitions";
+    };
+    readonly 'member_roles:write': {
+        readonly name: "member_roles:write";
+        readonly category: ScopeCategory.MEMBER_ROLES;
+        readonly description: "Create and edit roles";
+        readonly implies: readonly ["member_roles:read"];
+    };
+    readonly 'member_roles:admin': {
+        readonly name: "member_roles:admin";
+        readonly category: ScopeCategory.MEMBER_ROLES;
+        readonly description: "Delete roles";
+        readonly implies: readonly ["member_roles:write"];
+        readonly dangerous: true;
+    };
+    readonly 'chats:read': {
+        readonly name: "chats:read";
+        readonly category: ScopeCategory.CHATS;
+        readonly description: "View all conversations";
+    };
+    readonly 'chats:write': {
+        readonly name: "chats:write";
+        readonly category: ScopeCategory.CHATS;
+        readonly description: "Send messages in conversations";
+        readonly implies: readonly ["chats:read"];
+    };
+    readonly 'chats:admin': {
+        readonly name: "chats:admin";
+        readonly category: ScopeCategory.CHATS;
+        readonly description: "Delete conversations";
+        readonly implies: readonly ["chats:write"];
+    };
+    readonly 'dm:read': {
+        readonly name: "dm:read";
+        readonly category: ScopeCategory.DM;
+        readonly description: "View direct messages";
+    };
+    readonly 'dm:write': {
+        readonly name: "dm:write";
+        readonly category: ScopeCategory.DM;
+        readonly description: "Send direct messages";
+        readonly implies: readonly ["dm:read"];
+    };
+    readonly 'dm:admin': {
+        readonly name: "dm:admin";
+        readonly category: ScopeCategory.DM;
+        readonly description: "Delete direct messages";
+        readonly implies: readonly ["dm:write"];
+    };
+    readonly 'workflows:read': {
+        readonly name: "workflows:read";
+        readonly category: ScopeCategory.WORKFLOWS;
+        readonly description: "View workflow definitions";
+    };
+    readonly 'workflows:write': {
+        readonly name: "workflows:write";
+        readonly category: ScopeCategory.WORKFLOWS;
+        readonly description: "Create and edit workflows";
+        readonly implies: readonly ["workflows:read"];
+    };
+    readonly 'workflows:admin': {
+        readonly name: "workflows:admin";
+        readonly category: ScopeCategory.WORKFLOWS;
+        readonly description: "Delete workflows";
+        readonly implies: readonly ["workflows:write"];
+    };
+    readonly 'assignments:read': {
+        readonly name: "assignments:read";
+        readonly category: ScopeCategory.ASSIGNMENTS;
+        readonly description: "View all assignments";
+    };
+    readonly 'assignments:write': {
+        readonly name: "assignments:write";
+        readonly category: ScopeCategory.ASSIGNMENTS;
+        readonly description: "Create and modify assignments";
+        readonly implies: readonly ["assignments:read"];
+    };
+    readonly 'assignments:admin': {
+        readonly name: "assignments:admin";
+        readonly category: ScopeCategory.ASSIGNMENTS;
+        readonly description: "Delete assignments";
+        readonly implies: readonly ["assignments:write"];
+    };
+    readonly 'automations:read': {
+        readonly name: "automations:read";
+        readonly category: ScopeCategory.AUTOMATIONS;
+        readonly description: "View scheduled tasks and rules";
+    };
+    readonly 'automations:write': {
+        readonly name: "automations:write";
+        readonly category: ScopeCategory.AUTOMATIONS;
+        readonly description: "Create and edit automations";
+        readonly implies: readonly ["automations:read"];
+    };
+    readonly 'automations:admin': {
+        readonly name: "automations:admin";
+        readonly category: ScopeCategory.AUTOMATIONS;
+        readonly description: "Delete automations";
+        readonly implies: readonly ["automations:write"];
+    };
+    readonly 'datatypes:read': {
+        readonly name: "datatypes:read";
+        readonly category: ScopeCategory.DATATYPES;
+        readonly description: "View data type schemas";
+    };
+    readonly 'datatypes:write': {
+        readonly name: "datatypes:write";
+        readonly category: ScopeCategory.DATATYPES;
+        readonly description: "Create and edit data types";
+        readonly implies: readonly ["datatypes:read"];
+    };
+    readonly 'datatypes:admin': {
+        readonly name: "datatypes:admin";
+        readonly category: ScopeCategory.DATATYPES;
+        readonly description: "Delete data types";
+        readonly implies: readonly ["datatypes:write"];
+    };
+    readonly 'records:read': {
+        readonly name: "records:read";
+        readonly category: ScopeCategory.RECORDS;
+        readonly description: "View all data records";
+    };
+    readonly 'records:write': {
+        readonly name: "records:write";
+        readonly category: ScopeCategory.RECORDS;
+        readonly description: "Create and modify records";
+        readonly implies: readonly ["records:read"];
+    };
+    readonly 'records:admin': {
+        readonly name: "records:admin";
+        readonly category: ScopeCategory.RECORDS;
+        readonly description: "Delete records";
+        readonly implies: readonly ["records:write"];
+    };
+    readonly 'files:read': {
+        readonly name: "files:read";
+        readonly category: ScopeCategory.FILES;
+        readonly description: "View all files";
+    };
+    readonly 'files:write': {
+        readonly name: "files:write";
+        readonly category: ScopeCategory.FILES;
+        readonly description: "Upload and modify files";
+        readonly implies: readonly ["files:read"];
+    };
+    readonly 'files:admin': {
+        readonly name: "files:admin";
+        readonly category: ScopeCategory.FILES;
+        readonly description: "Delete files";
+        readonly implies: readonly ["files:write"];
+    };
+    readonly 'journeys:read': {
+        readonly name: "journeys:read";
+        readonly category: ScopeCategory.JOURNEYS;
+        readonly description: "View journey definitions";
+    };
+    readonly 'journeys:write': {
+        readonly name: "journeys:write";
+        readonly category: ScopeCategory.JOURNEYS;
+        readonly description: "Create and edit journeys";
+        readonly implies: readonly ["journeys:read"];
+    };
+    readonly 'journeys:admin': {
+        readonly name: "journeys:admin";
+        readonly category: ScopeCategory.JOURNEYS;
+        readonly description: "Delete journeys";
+        readonly implies: readonly ["journeys:write"];
+    };
+    readonly 'experiments:read': {
+        readonly name: "experiments:read";
+        readonly category: ScopeCategory.EXPERIMENTS;
+        readonly description: "View experiments and assignments";
+    };
+    readonly 'experiments:write': {
+        readonly name: "experiments:write";
+        readonly category: ScopeCategory.EXPERIMENTS;
+        readonly description: "Create and edit experiments";
+        readonly implies: readonly ["experiments:read"];
+    };
+    readonly 'experiments:admin': {
+        readonly name: "experiments:admin";
+        readonly category: ScopeCategory.EXPERIMENTS;
+        readonly description: "Delete draft experiments and archive experiments";
+        readonly implies: readonly ["experiments:write"];
+    };
+    readonly 'sites:read': {
+        readonly name: "sites:read";
+        readonly category: ScopeCategory.SITES;
+        readonly description: "View site configurations";
+    };
+    readonly 'sites:write': {
+        readonly name: "sites:write";
+        readonly category: ScopeCategory.SITES;
+        readonly description: "Create and edit sites";
+        readonly implies: readonly ["sites:read"];
+    };
+    readonly 'sites:admin': {
+        readonly name: "sites:admin";
+        readonly category: ScopeCategory.SITES;
+        readonly description: "Delete sites";
+        readonly implies: readonly ["sites:write"];
+    };
+    readonly 'agents:read': {
+        readonly name: "agents:read";
+        readonly category: ScopeCategory.AGENTS;
+        readonly description: "View agent members";
+    };
+    readonly 'agents:write': {
+        readonly name: "agents:write";
+        readonly category: ScopeCategory.AGENTS;
+        readonly description: "Create and configure agents";
+        readonly implies: readonly ["agents:read"];
+    };
+    readonly 'agents:admin': {
+        readonly name: "agents:admin";
+        readonly category: ScopeCategory.AGENTS;
+        readonly description: "Delete agents";
+        readonly implies: readonly ["agents:write"];
+    };
+    readonly 'calendars:read': {
+        readonly name: "calendars:read";
+        readonly category: ScopeCategory.CALENDARS;
+        readonly description: "View calendars";
+    };
+    readonly 'calendars:write': {
+        readonly name: "calendars:write";
+        readonly category: ScopeCategory.CALENDARS;
+        readonly description: "Create and edit calendar events";
+        readonly implies: readonly ["calendars:read"];
+    };
+    readonly 'calendars:admin': {
+        readonly name: "calendars:admin";
+        readonly category: ScopeCategory.CALENDARS;
+        readonly description: "Delete calendars";
+        readonly implies: readonly ["calendars:write"];
+    };
+    readonly 'inboxes:read': {
+        readonly name: "inboxes:read";
+        readonly category: ScopeCategory.INBOXES;
+        readonly description: "View inbox configurations";
+    };
+    readonly 'inboxes:write': {
+        readonly name: "inboxes:write";
+        readonly category: ScopeCategory.INBOXES;
+        readonly description: "Configure inboxes";
+        readonly implies: readonly ["inboxes:read"];
+    };
+    readonly 'inboxes:admin': {
+        readonly name: "inboxes:admin";
+        readonly category: ScopeCategory.INBOXES;
+        readonly description: "Delete inboxes";
+        readonly implies: readonly ["inboxes:write"];
+    };
+    readonly 'phones:read': {
+        readonly name: "phones:read";
+        readonly category: ScopeCategory.PHONES;
+        readonly description: "View phone numbers";
+    };
+    readonly 'phones:write': {
+        readonly name: "phones:write";
+        readonly category: ScopeCategory.PHONES;
+        readonly description: "Configure phone numbers";
+        readonly implies: readonly ["phones:read"];
+    };
+    readonly 'phones:admin': {
+        readonly name: "phones:admin";
+        readonly category: ScopeCategory.PHONES;
+        readonly description: "Delete phone numbers";
+        readonly implies: readonly ["phones:write"];
+    };
+    readonly 'webhooks:read': {
+        readonly name: "webhooks:read";
+        readonly category: ScopeCategory.WEBHOOKS;
+        readonly description: "View webhook logs";
+    };
+    readonly 'webhooks:write': {
+        readonly name: "webhooks:write";
+        readonly category: ScopeCategory.WEBHOOKS;
+        readonly description: "Configure webhooks";
+        readonly implies: readonly ["webhooks:read"];
+    };
+    readonly 'webhooks:admin': {
+        readonly name: "webhooks:admin";
+        readonly category: ScopeCategory.WEBHOOKS;
+        readonly description: "Delete webhooks";
+        readonly implies: readonly ["webhooks:write"];
+    };
+    readonly 'webhooks:raw': {
+        readonly name: "webhooks:raw";
+        readonly category: ScopeCategory.WEBHOOKS;
+        readonly description: "Access raw webhook payloads";
+    };
+    readonly 'apps:read': {
+        readonly name: "apps:read";
+        readonly category: ScopeCategory.APPS;
+        readonly description: "View app integrations";
+    };
+    readonly 'apps:write': {
+        readonly name: "apps:write";
+        readonly category: ScopeCategory.APPS;
+        readonly description: "Configure app integrations";
+        readonly implies: readonly ["apps:read"];
+    };
+    readonly 'apps:admin': {
+        readonly name: "apps:admin";
+        readonly category: ScopeCategory.APPS;
+        readonly description: "Delete app integrations";
+        readonly implies: readonly ["apps:write"];
+    };
+    readonly 'labels:read': {
+        readonly name: "labels:read";
+        readonly category: ScopeCategory.LABELS;
+        readonly description: "View labels";
+    };
+    readonly 'labels:write': {
+        readonly name: "labels:write";
+        readonly category: ScopeCategory.LABELS;
+        readonly description: "Deprecated — label mutations now require the parent resource write scope (members:write, chats:write, files:write)";
+        readonly implies: readonly ["labels:read"];
+    };
+    readonly 'analytics:read': {
+        readonly name: "analytics:read";
+        readonly category: ScopeCategory.ANALYTICS;
+        readonly description: "View analytics and reports";
+    };
+    readonly 'export:read': {
+        readonly name: "export:read";
+        readonly category: ScopeCategory.EXPORT;
+        readonly description: "Export workspace data";
+    };
+    readonly 'export:write': {
+        readonly name: "export:write";
+        readonly category: ScopeCategory.EXPORT;
+        readonly description: "Export workspace data";
+        readonly implies: readonly ["export:read"];
+    };
+    readonly 'export:admin': {
+        readonly name: "export:admin";
+        readonly category: ScopeCategory.EXPORT;
+        readonly description: "Export all data including sensitive information";
+        readonly implies: readonly ["export:write"];
+        readonly dangerous: true;
+    };
+    readonly 'org:info': {
+        readonly name: "org:info";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "View basic org info and own workspaces";
+    };
+    readonly 'org:read': {
+        readonly name: "org:read";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "View org info";
+        readonly implies: readonly ["org:info"];
+    };
+    readonly 'org:write': {
+        readonly name: "org:write";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "Update org settings";
+        readonly implies: readonly ["org:read"];
+    };
+    readonly 'org:admin': {
+        readonly name: "org:admin";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "Full org management";
+        readonly implies: readonly ["org:write"];
+        readonly dangerous: true;
+    };
+    readonly 'operator:read': {
+        readonly name: "operator:read";
+        readonly category: ScopeCategory.OPERATOR;
+        readonly description: "View operator dashboard and listen in";
+    };
+    readonly 'operator:write': {
+        readonly name: "operator:write";
+        readonly category: ScopeCategory.OPERATOR;
+        readonly description: "Go Live and handle interactions as an operator";
+        readonly implies: readonly ["operator:read"];
+    };
+    readonly 'org:manage_admins': {
+        readonly name: "org:manage_admins";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "Assign admin and owner roles (owner only)";
+        readonly implies: readonly ["org:admin"];
+        readonly dangerous: true;
+    };
+    readonly 'org:delete': {
+        readonly name: "org:delete";
+        readonly category: ScopeCategory.ORG;
+        readonly description: "Delete organization (owner only)";
+        readonly implies: readonly ["org:admin"];
+        readonly dangerous: true;
+    };
+};
+/**
+ * Type-safe scope name. Use this instead of raw strings for scope checks.
+ */
+type ScopeName = keyof typeof SCOPES;
+/**
+ * Manager for scope operations and validations
+ */
+declare class ScopeManager {
+    /**
+     * Get a scope by name
+     */
+    static getScope(name: ScopeName): ScopeDefinition;
+    /**
+     * Get all available scopes
+     */
+    static getAllScopes(): Record<ScopeName, ScopeDefinition>;
+    /**
+     * Get all scopes in a specific category
+     */
+    static getScopesByCategory(category: ScopeCategory): ScopeDefinition[];
+    /**
+     * Expand a list of scope names to include all implied scopes
+     */
+    static expandScopes(scopeNames: string[]): Set<string>;
+    /**
+     * Validate that all scope names are valid
+     * @returns List of invalid scope names, or empty array if all valid
+     * @throws Error if any scope names are invalid
+     */
+    static validateScopes(scopeNames: string[]): string[];
+    /**
+     * Get all dangerous scopes from a list of scope names
+     */
+    static getDangerousScopes(scopeNames: string[]): ScopeDefinition[];
+    /**
+     * Format scope descriptions grouped by category
+     */
+    static formatScopeDescription(scopeNames: string[]): Record<ScopeCategory, Array<{
+        name: string;
+        description: string;
+        dangerous?: boolean;
+        implied: boolean;
+    }>>;
+    /**
+     * Parse a space-separated scope string into an array
+     */
+    static parseScopeString(scopeString: string): string[];
+    /**
+     * Convert scope array to space-separated string
+     */
+    static formatScopeString(scopes: string[]): string;
+}
+/**
+ * Common scope combinations for convenience
+ */
+declare const SCOPE_PRESETS: {
+    /** Data access - members and records management */
+    DATA: ScopeName[];
+    /** Chat access - members and chat management */
+    CHATS: ScopeName[];
+    /** Full access - all available scopes */
+    ALL: ScopeName[];
+};
+
+export { type MetricDataPoint as $, type AIModelUsageResponse as A, type BaseChatModelConfig as B, type CallEndSection as C, DEFAULT_CHAT_MODEL as D, type EfficiencyMetricsResponse as E, type EmailUsageResponse as F, type EngineTimeSeries as G, type ErrorCodeBucket as H, type EventRuleMetrics as I, type ExportStatistics as J, type FeatureSyncStatus as K, type GeminiChatModelConfig as L, type GeminiRealtimeModelConfig as M, type GeminiThinkingLevel as N, type MetricSummary$1 as O, type HealthCheckStatistics as P, type HealthDetailRequest as Q, type HealthMetricsRequest as R, type HealthMetricsResponse as S, type HealthSummary as T, type ImportStatistics as U, type VoiceMetricsResponse$1 as V, type WorkspaceHealthResponse$1 as W, type InterruptionSound as X, type MemberNotificationPreferences as Y, type MemberNotifyActionParams as Z, type MemberUsageReport as _, type AIUsageDetailsResponse as a, type WorkspaceHealthDetail as a$, type MetricSection as a0, type MetricSummary as a1, type MetricValue as a2, type OpenAIChatModelConfig as a3, type OpenAIRealtimeModelConfig as a4, type OpenAIReasoningEffort as a5, type OpenAISemanticVADEagerness as a6, type OpenAISemanticVADTurnDetection as a7, type OpenAIServerVADTurnDetection as a8, type OpenAITurnDetection as a9, type SiteContext as aA, type SkippedWorkspace as aB, type StatisticsSummary as aC, type SystemStatistics as aD, type TTSModel as aE, type TTSPreviewProvider as aF, TTS_PREVIEW_PROVIDERS as aG, type TaskContext as aH, type TaskCountResponse as aI, type ThinkingSound as aJ, type TimeSeriesData as aK, type TimeSeriesDataPoint as aL, type ToolParameter as aM, type ToolkitContext as aN, ToolkitState as aO, type TopOffender as aP, type TopResourceOverageResponse as aQ, type TtsReconnectOutcomeEntry as aR, type TtsReconnectSection as aS, type UsageProductSummaryResponse as aT, type UsageReportResponse as aU, type UsageReportRequest as aV, type UsageStatistics as aW, type VoiceMetricsResponse as aX, type VoiceMetricsTimeRange as aY, type WebhookMetrics as aZ, type WorkflowContext as a_, type OpenAITurnDetectionType as aa, type PageContext as ab, type PerformanceMetrics as ac, type PhoneCallPhoneNumberUsageResponse as ad, type PhoneCallUsageResponse as ae, type PhoneCommunicationDetailsResponse as af, type PhoneNumberUsage as ag, type ProductOverageConfigResponse as ah, type ProvisionPlanRequest as ai, type ProvisionPlanResponse as aj, type RealtimeModelConfig as ak, type RequestsSection as al, type RequestsStatusEntry as am, type ResourceMetadata as an, type ResourceOverageResponse as ao, type ResourceScope as ap, type ResourceUsageResponse as aq, SCOPES as ar, SCOPE_PRESETS as as, type SMSCommunicationDetailsResponse as at, type SMSMessageUsageResponse as au, type SMSPhoneNumberUsageResponse as av, ScopeCategory as aw, type ScopeDefinition as ax, ScopeManager as ay, type ScopeName as az, type AWSRealtimeModelConfig as b, type WorkspaceHealthResponse as b0, type WorkspaceHealthRow as b1, type WorkspaceUsageReportResponse as b2, type XAIChatModelConfig as b3, type XAIRealtimeModelConfig as b4, type XAIReasoningEffort as b5, canPreviewVoice as b6, formatAppContextAsMarkdown as b7, getAllResourceSlugs as b8, getApplicableResourceSlugs as b9, getApplicableResources as ba, getResourceMetadata as bb, getScopeFromProductType as bc, getTTSProvider as bd, getVoiceModelId as be, type AnalyticsFilter as c, type AnalyticsQuery as d, type AppContext as e, type AttachedAddonInfo as f, type BaseRealtimeModelConfig as g, type BillingStatistics as h, type CallEndStatusEntry as i, type ChangeWorkspaceProductRequest as j, type ChangeWorkspaceProductResponse as k, type ChannelErrorBreakdown as l, type ChannelFailures as m, type ChatModelConfig as n, type ClaudeChatModelConfig as o, type CommunicationDetailsResponse as p, type CurrentPlanInfo as q, type CustomRealtimeModelConfig as r, DEFAULT_CUSTOM_VOICE_MODEL as s, DEFAULT_THINKING_SPEECH_PHRASES as t, DEFAULT_VOICE_INFERENCE_MODEL as u, type DailyPhoneRowResponse as v, type DailySMSRowResponse as w, type DashboardMetrics as x, type DataRecordContext as y, type EmailCountsResponse as z };