een-api-toolkit 0.3.43 → 0.3.47

package/dist/index.d.ts

@@ -110,6 +110,59 @@ export declare interface AlertAction {
     status?: AlertActionStatus;
 }
 
+/**
+ * Alert Action Rule entity from EEN API v3.0.
+ *
+ * @remarks
+ * Connects alerts to actions. When an alert matches the rule's criteria,
+ * the associated alert actions are executed.
+ *
+ * @example
+ * ```typescript
+ * import { listAlertActionRules, type AlertActionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listAlertActionRules({
+ *   enabled: true,
+ *   pageSize: 20
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface AlertActionRule {
+    /** Unique identifier */
+    id: string;
+    /** ISO 8601 timestamp when created */
+    createTimestamp: string;
+    /** Human-readable name */
+    name: string;
+    /** Optional notes about the rule */
+    notes?: string;
+    /** Whether the rule is enabled */
+    enabled: boolean;
+    /** Alert types this rule applies to */
+    alertTypes: string[];
+    /** Actor IDs this rule applies to */
+    actorIds: string[];
+    /** Actor types this rule applies to */
+    actorTypes: string[];
+    /** Alert condition rule IDs this rule applies to */
+    ruleIds: string[];
+    /** Alert action IDs to execute when rule matches */
+    alertActionIds: string[];
+    /** Minimum priority for alerts (inclusive) */
+    priority__gte?: number;
+    /** Maximum priority for alerts (inclusive) */
+    priority__lte?: number;
+}
+
+/**
+ * Union type for all alert action settings.
+ *
+ * @category Automations
+ */
+export declare type AlertActionSettings = NotificationSettings | SmsSettings | SmtpSettings | SlackSettings | WebhookSettings | OutputPortSettings | PlaySpeakerAudioClipSettings | GenericAlertActionSettings;
+
 /**
  * Status of an alert action.
  *
@@ -117,6 +170,114 @@ export declare interface AlertAction {
  */
 export declare type AlertActionStatus = 'fired' | 'success' | 'partialSuccess' | 'silenced' | 'failed' | 'internalError';
 
+/**
+ * Supported alert action types.
+ *
+ * @category Automations
+ */
+export declare type AlertActionType = 'notification' | 'sms' | 'smtp' | 'slack' | 'webhook' | 'brivo' | 'zendesk' | 'immix' | 'zapier' | 'sentinel' | 'evalinkTalos' | 'outputPort' | 'ebus' | 'playSpeakerAudioClip' | 'zulipPrivate' | 'zulipStream';
+
+/**
+ * Alert Condition Rule entity from EEN API v3.0.
+ *
+ * @remarks
+ * Defines rules that process events and create alerts. Each rule specifies
+ * input event types and the output alert type to generate.
+ *
+ * @example
+ * ```typescript
+ * import { listAlertConditionRules, type AlertConditionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listAlertConditionRules({
+ *   enabled: true,
+ *   include: ['actions', 'insights']
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface AlertConditionRule {
+    /** Unique identifier */
+    id: string;
+    /** ISO 8601 timestamp when created */
+    createTimestamp: string;
+    /** Rule type identifier */
+    type: string;
+    /** ID of the user who created the rule */
+    creatorId: string;
+    /** Human-readable name */
+    name: string;
+    /** Optional notes about the rule */
+    notes?: string;
+    /** Whether the rule is enabled */
+    enabled: boolean;
+    /** Priority level (1-10) */
+    priority: number;
+    /** Actors (cameras, bridges, etc.) this rule applies to */
+    actors: AlertConditionRuleActor[];
+    /** Input event types that trigger this rule */
+    inputEventTypes: string[];
+    /** Output alert type generated by this rule */
+    outputAlertType: string;
+    /** Actions associated with this rule (requires include=actions) */
+    actions?: AlertConditionRuleAction[];
+    /** Insights about rule performance (requires include=insights) */
+    insights?: AlertConditionRuleInsights;
+}
+
+/**
+ * Action reference in alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface AlertConditionRuleAction {
+    /** Action ID */
+    id: string;
+    /** Action name */
+    name?: string;
+    /** Action type */
+    type?: string;
+}
+
+/**
+ * Actor configuration for alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface AlertConditionRuleActor {
+    /** Actor ID */
+    id: string;
+    /** Actor type */
+    type: string;
+    /** Actor account ID */
+    accountId?: string;
+}
+
+/**
+ * Fields that can be included in alert condition rule responses.
+ *
+ * @category Automations
+ */
+export declare type AlertConditionRuleInclude = 'actions' | 'insights';
+
+/**
+ * Insights data for alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface AlertConditionRuleInsights {
+    /** Total number of alerts triggered */
+    totalAlerts?: number;
+    /** ISO 8601 timestamp of last triggered alert */
+    lastTriggered?: string;
+    /** Count of alerts by time period */
+    alertCounts?: {
+        last24Hours?: number;
+        last7Days?: number;
+        last30Days?: number;
+    };
+}
+
 /**
  * Fields that can be included in alert responses.
  *
@@ -147,6 +308,44 @@ export declare interface AlertType {
     description: string;
 }
 
+/**
+ * Alert Action entity from EEN API v3.0.
+ *
+ * @remarks
+ * Represents an action that can be executed when an alert is triggered.
+ * Actions include notifications, webhooks, integrations, and physical outputs.
+ *
+ * @example
+ * ```typescript
+ * import { listAlertActions, type AlertAction } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listAlertActions({ enabled: true })
+ * if (data) {
+ *   data.results.forEach((action) => {
+ *     console.log(`Action: ${action.name} (${action.type})`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface AutomationAlertAction {
+    /** Unique identifier */
+    id: string;
+    /** ISO 8601 timestamp when created */
+    createTimestamp: string;
+    /** Action type */
+    type: AlertActionType;
+    /** Human-readable name */
+    name: string;
+    /** Optional notes about the action */
+    notes?: string;
+    /** Whether the action is enabled */
+    enabled: boolean;
+    /** Type-specific settings */
+    settings: AlertActionSettings;
+}
+
 /**
  * Bridge entity from EEN API v3.0.
  *
@@ -974,6 +1173,67 @@ declare interface Event_2 {
 }
 export { Event_2 as Event }
 
+/**
+ * Event Alert Condition Rule entity from EEN API v3.0.
+ *
+ * @remarks
+ * Defines conditions under which events trigger alerts. These rules filter
+ * incoming events and determine when to generate alerts.
+ *
+ * @example
+ * ```typescript
+ * import { listEventAlertConditionRules, type EventAlertConditionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listEventAlertConditionRules({
+ *   enabled: true,
+ *   pageSize: 50
+ * })
+ * if (data) {
+ *   data.results.forEach((rule: EventAlertConditionRule) => {
+ *     console.log(`Rule: ${rule.name}, Priority: ${rule.priority}`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface EventAlertConditionRule {
+    /** Unique identifier */
+    id: string;
+    /** ISO 8601 timestamp when created */
+    createTimestamp: string;
+    /** ISO 8601 timestamp when last updated */
+    updateTimestamp: string;
+    /** Human-readable name */
+    name: string;
+    /** Priority level (1-10, higher is more important) */
+    priority: number;
+    /** Optional notes about the rule */
+    notes?: string;
+    /** Whether the rule is enabled */
+    enabled: boolean;
+    /** Cooldown period in seconds between alerts */
+    cooldownSeconds: number;
+    /** Human validation configuration */
+    humanValidation?: HumanValidation;
+    /** Event filter configuration */
+    eventFilter: EventFilter;
+    /** Output alert types generated by this rule */
+    outputAlertTypes: string[];
+}
+
+/**
+ * Field values available for filtering event alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface EventAlertConditionRuleFieldValues {
+    /** Available event types */
+    eventTypes?: string[];
+    /** Available output alert types */
+    outputAlertTypes?: string[];
+}
+
 /**
  * Event data object within an event.
  *
@@ -1010,6 +1270,18 @@ export declare interface EventFieldValues {
     type: string[];
 }
 
+/**
+ * Event filter configuration for event alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface EventFilter {
+    /** Event types to include */
+    types: string[];
+    /** Resource filter configuration */
+    resourceFilter?: EventResourceFilter;
+}
+
 /**
  * Event metric entity from EEN API v3.0.
  *
@@ -1056,6 +1328,22 @@ export declare interface EventMetric {
     [key: string]: unknown;
 }
 
+/**
+ * Resource filter for event filtering.
+ *
+ * @category Automations
+ */
+export declare interface EventResourceFilter {
+    /** Filter by specific account IDs */
+    accountIds?: string[];
+    /** Filter by specific actor IDs */
+    actorIds?: string[];
+    /** Filter by actor tags (all must match) */
+    actorTags__contains?: string[];
+    /** Filter by actor tags (any must match) */
+    actorTags__any?: string[];
+}
+
 /**
  * Event subscription entity from EEN API v3.0.
  *
@@ -1347,6 +1635,13 @@ export declare interface FilterCreate {
  */
 export declare function formatTimestamp(timestamp: string): string;
 
+/**
+ * Generic settings type for alert actions with unknown types.
+ *
+ * @category Automations
+ */
+declare type GenericAlertActionSettings = Record<string, unknown>;
+
 /**
  * Exchange authorization code for access token
  */
@@ -1391,6 +1686,96 @@ export declare function getAccessToken(code: string): Promise<Result<TokenRespon
  */
 export declare function getAlert(alertId: string, params?: GetAlertParams): Promise<Result<Alert>>;
 
+/**
+ * Get a specific alert action by ID.
+ *
+ * @remarks
+ * Fetches a single alert action from `/api/v3.0/alertActions/{id}`.
+ *
+ * @param actionId - The unique identifier of the action to fetch
+ * @returns A Result containing the action or an error
+ *
+ * @example
+ * ```typescript
+ * import { getAlertAction } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getAlertAction('action-123')
+ *
+ * if (data) {
+ *   console.log(`Action: ${data.name} (${data.type})`)
+ *   console.log('Settings:', data.settings)
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function getAlertAction(actionId: string): Promise<Result<AutomationAlertAction>>;
+
+/**
+ * Get a specific alert action rule by ID.
+ *
+ * @remarks
+ * Fetches a single alert action rule from `/api/v3.0/alertActionRules/{id}`.
+ *
+ * @param ruleId - The unique identifier of the rule to fetch
+ * @returns A Result containing the rule or an error
+ *
+ * @example
+ * ```typescript
+ * import { getAlertActionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getAlertActionRule('rule-123')
+ *
+ * if (data) {
+ *   console.log(`Rule: ${data.name}`)
+ *   console.log(`Alert types: ${data.alertTypes.join(', ')}`)
+ *   console.log(`Actions: ${data.alertActionIds.length}`)
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function getAlertActionRule(ruleId: string): Promise<Result<AlertActionRule>>;
+
+/**
+ * Get a specific alert condition rule by ID.
+ *
+ * @remarks
+ * Fetches a single alert condition rule from `/api/v3.0/alertConditionRules/{id}`.
+ * Use the `include` parameter to request additional fields like actions or insights.
+ *
+ * @param ruleId - The unique identifier of the rule to fetch
+ * @param params - Optional parameters (e.g., include additional fields)
+ * @returns A Result containing the rule or an error
+ *
+ * @example
+ * ```typescript
+ * import { getAlertConditionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getAlertConditionRule('rule-123', {
+ *   include: ['actions', 'insights']
+ * })
+ *
+ * if (data) {
+ *   console.log(`Rule: ${data.name}`)
+ *   console.log(`Actions: ${data.actions?.length ?? 0}`)
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function getAlertConditionRule(ruleId: string, params?: GetAlertConditionRuleParams): Promise<Result<AlertConditionRule>>;
+
+/**
+ * Parameters for getting a single alert condition rule.
+ *
+ * @category Automations
+ */
+export declare interface GetAlertConditionRuleParams {
+    /** Fields to include in response */
+    include?: AlertConditionRuleInclude[];
+}
+
 /**
  * Parameters for getting a single alert by ID.
  *
@@ -1725,6 +2110,71 @@ export declare function getCurrentUser(): Promise<Result<UserProfile>>;
  */
 export declare function getEvent(eventId: string, params?: GetEventParams): Promise<Result<Event_2>>;
 
+/**
+ * Get a specific event alert condition rule by ID.
+ *
+ * @remarks
+ * Fetches a single event alert condition rule from
+ * `/api/v3.0/eventAlertConditionRules/{id}`.
+ *
+ * @param ruleId - The unique identifier of the rule to fetch
+ * @returns A Result containing the rule or an error
+ *
+ * @example
+ * ```typescript
+ * import { getEventAlertConditionRule } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getEventAlertConditionRule('rule-123')
+ *
+ * if (error) {
+ *   if (error.code === 'NOT_FOUND') {
+ *     console.log('Rule not found')
+ *   }
+ *   return
+ * }
+ *
+ * console.log(`Rule: ${data.name}, Priority: ${data.priority}`)
+ * ```
+ *
+ * @category Automations
+ */
+export declare function getEventAlertConditionRule(ruleId: string): Promise<Result<EventAlertConditionRule>>;
+
+/**
+ * Get available field values for event alert condition rules.
+ *
+ * @remarks
+ * Fetches available values that can be used for filtering event alert condition rules.
+ * Useful for building filter UI components.
+ *
+ * @param params - Optional filter parameters
+ * @returns A Result containing field values or an error
+ *
+ * @example
+ * ```typescript
+ * import { getEventAlertConditionRuleFieldValues } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getEventAlertConditionRuleFieldValues()
+ * if (data) {
+ *   console.log('Available event types:', data.eventTypes)
+ *   console.log('Available alert types:', data.outputAlertTypes)
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function getEventAlertConditionRuleFieldValues(params?: GetEventAlertConditionRuleFieldValuesParams): Promise<Result<EventAlertConditionRuleFieldValues>>;
+
+/**
+ * Parameters for getting event alert condition rule field values.
+ *
+ * @category Automations
+ */
+export declare interface GetEventAlertConditionRuleFieldValuesParams {
+    /** Filter by enabled status */
+    enabled?: boolean;
+}
+
 /**
  * Get event metrics (time-series data) for a specific actor and event type.
  *
@@ -2366,6 +2816,27 @@ export declare function getUsers(params?: ListUsersParams): Promise<Result<Pagin
  */
 export declare function handleAuthCallback(code: string, state: string): Promise<Result<TokenResponse>>;
 
+/**
+ * Automation types for EEN API v3.0
+ *
+ * @remarks
+ * Types for Event Alert Condition Rules, Alert Condition Rules,
+ * Alert Action Rules, and Alert Actions.
+ *
+ * @category Automations
+ */
+/**
+ * Human validation configuration for event alert condition rules.
+ *
+ * @category Automations
+ */
+export declare interface HumanValidation {
+    /** Whether human validation is required */
+    required: boolean;
+    /** Timeout in seconds for validation */
+    timeoutSeconds?: number;
+}
+
 /**
  * Initialize the EEN API Toolkit
  *
@@ -2584,6 +3055,193 @@ export declare interface LayoutSettings {
     paneColumns: number;
 }
 
+/**
+ * List alert action rules with optional filters and pagination.
+ *
+ * @remarks
+ * Fetches a paginated list of alert action rules from `/api/v3.0/alertActionRules`.
+ * These rules connect alerts to actions - when an alert matches the rule's criteria,
+ * the associated actions are executed.
+ *
+ * @param params - Optional filtering and pagination parameters
+ * @returns A Result containing a paginated list of rules or an error
+ *
+ * @example
+ * ```typescript
+ * import { listAlertActionRules } from 'een-api-toolkit'
+ *
+ * // Get enabled rules for specific alert types
+ * const { data, error } = await listAlertActionRules({
+ *   enabled: true,
+ *   alertType__in: ['een.motionDetectionAlert.v1']
+ * })
+ *
+ * if (data) {
+ *   data.results.forEach(rule => {
+ *     console.log(`${rule.name}: ${rule.alertActionIds.length} actions`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function listAlertActionRules(params?: ListAlertActionRulesParams): Promise<Result<PaginatedResult<AlertActionRule>>>;
+
+/**
+ * Parameters for listing alert action rules.
+ *
+ * @example
+ * ```typescript
+ * const { data } = await listAlertActionRules({
+ *   enabled: true,
+ *   alertType__in: ['een.motionDetectionAlert.v1']
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface ListAlertActionRulesParams {
+    /** Number of results per page */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by rule IDs */
+    id__in?: string[];
+    /** Filter by alert types */
+    alertType__in?: string[];
+    /** Filter by actor IDs */
+    actorId__in?: string[];
+    /** Filter by alert action IDs */
+    alertActionId__in?: string[];
+    /** Filter by alert condition rule IDs */
+    ruleId__in?: string[];
+}
+
+/**
+ * List alert actions with optional filters and pagination.
+ *
+ * @remarks
+ * Fetches a paginated list of alert actions from `/api/v3.0/alertActions`.
+ * Alert actions define what happens when an alert is triggered (notifications,
+ * webhooks, integrations, etc.).
+ *
+ * @param params - Optional filtering and pagination parameters
+ * @returns A Result containing a paginated list of actions or an error
+ *
+ * @example
+ * ```typescript
+ * import { listAlertActions } from 'een-api-toolkit'
+ *
+ * // Get enabled webhook and notification actions
+ * const { data, error } = await listAlertActions({
+ *   enabled: true,
+ *   type__in: ['notification', 'webhook']
+ * })
+ *
+ * if (data) {
+ *   data.results.forEach(action => {
+ *     console.log(`${action.name} (${action.type})`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function listAlertActions(params?: ListAlertActionsParams): Promise<Result<PaginatedResult<AutomationAlertAction>>>;
+
+/**
+ * Parameters for listing alert actions.
+ *
+ * @example
+ * ```typescript
+ * const { data } = await listAlertActions({
+ *   enabled: true,
+ *   type__in: ['notification', 'webhook']
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface ListAlertActionsParams {
+    /** Number of results per page */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by action IDs */
+    id__in?: string[];
+    /** Filter by action types */
+    type__in?: AlertActionType[];
+}
+
+/**
+ * List alert condition rules with optional filters and pagination.
+ *
+ * @remarks
+ * Fetches a paginated list of alert condition rules from
+ * `/api/v3.0/alertConditionRules`. These rules process events and create alerts.
+ *
+ * @param params - Optional filtering and pagination parameters
+ * @returns A Result containing a paginated list of rules or an error
+ *
+ * @example
+ * ```typescript
+ * import { listAlertConditionRules } from 'een-api-toolkit'
+ *
+ * // Get enabled rules with actions
+ * const { data, error } = await listAlertConditionRules({
+ *   enabled: true,
+ *   include: ['actions', 'insights']
+ * })
+ *
+ * if (data) {
+ *   data.results.forEach(rule => {
+ *     console.log(`${rule.name}: ${rule.inputEventTypes.length} event types`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function listAlertConditionRules(params?: ListAlertConditionRulesParams): Promise<Result<PaginatedResult<AlertConditionRule>>>;
+
+/**
+ * Parameters for listing alert condition rules.
+ *
+ * @example
+ * ```typescript
+ * const { data } = await listAlertConditionRules({
+ *   enabled: true,
+ *   include: ['actions', 'insights']
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface ListAlertConditionRulesParams {
+    /** Number of results per page */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by rule IDs */
+    id__in?: string[];
+    /** Filter by actor IDs */
+    actorId__in?: string[];
+    /** Filter by input event types */
+    inputEventType__in?: string[];
+    /** Filter by output alert type */
+    outputAlertType?: string;
+    /** Filter by rule type */
+    type?: string;
+    /** Fields to include in response */
+    include?: AlertConditionRuleInclude[];
+}
+
 /**
  * List alerts with optional filters and pagination.
  *
@@ -2935,6 +3593,73 @@ export declare interface ListCamerasParams {
     status__ne?: CameraStatus;
 }
 
+/**
+ * List event alert condition rules with optional filters and pagination.
+ *
+ * @remarks
+ * Fetches a paginated list of event alert condition rules from
+ * `/api/v3.0/eventAlertConditionRules`. These rules define conditions
+ * under which events trigger alerts.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/listalertconditionrules).
+ *
+ * @param params - Optional filtering and pagination parameters
+ * @returns A Result containing a paginated list of rules or an error
+ *
+ * @example
+ * ```typescript
+ * import { listEventAlertConditionRules } from 'een-api-toolkit'
+ *
+ * // Get enabled rules
+ * const { data, error } = await listEventAlertConditionRules({
+ *   enabled: true,
+ *   pageSize: 50
+ * })
+ *
+ * if (data) {
+ *   console.log(`Found ${data.results.length} rules`)
+ *   data.results.forEach(rule => {
+ *     console.log(`${rule.name}: priority ${rule.priority}`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Automations
+ */
+export declare function listEventAlertConditionRules(params?: ListEventAlertConditionRulesParams): Promise<Result<PaginatedResult<EventAlertConditionRule>>>;
+
+/**
+ * Parameters for listing event alert condition rules.
+ *
+ * @example
+ * ```typescript
+ * const { data } = await listEventAlertConditionRules({
+ *   enabled: true,
+ *   pageSize: 50,
+ *   outputAlertType__in: ['een.motionDetectionAlert.v1']
+ * })
+ * ```
+ *
+ * @category Automations
+ */
+export declare interface ListEventAlertConditionRulesParams {
+    /** Number of results per page */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by rule IDs */
+    id__in?: string[];
+    /** Filter by output alert types */
+    outputAlertType__in?: string[];
+    /** Filter by minimum priority (inclusive) */
+    priority__gte?: number;
+    /** Filter by maximum priority (inclusive) */
+    priority__lte?: number;
+}
+
 /**
  * List available event field values for a specific actor.
  *
@@ -3881,6 +4606,16 @@ export { Notification_2 as Notification }
  */
 export declare type NotificationCategory = 'health' | 'video' | 'operational' | 'audit' | 'job' | 'security' | 'sharing';
 
+/**
+ * Push notification settings.
+ *
+ * @category Automations
+ */
+export declare interface NotificationSettings {
+    /** User IDs to notify */
+    userIds: string[];
+}
+
 /**
  * Status of a notification delivery.
  *
@@ -3888,6 +4623,20 @@ export declare type NotificationCategory = 'health' | 'video' | 'operational' |
  */
 export declare type NotificationStatus = 'pending' | 'bounced' | 'dropped' | 'deferred' | 'delivered' | 'sent' | 'outsideUsersSchedule' | 'notificationsDisabled' | 'noNotificationActions' | 'sendingFailed' | 'throttled' | 'unableToGetSettings';
 
+/**
+ * Output port settings for triggering physical outputs.
+ *
+ * @category Automations
+ */
+export declare interface OutputPortSettings {
+    /** Device ID */
+    deviceId: string;
+    /** Output port index */
+    outputPort: number;
+    /** Duration in milliseconds */
+    durationMs?: number;
+}
+
 /**
  * Paginated response from list operations.
  *
@@ -3939,6 +4688,20 @@ export declare interface PaginationParams {
     pageToken?: string;
 }
 
+/**
+ * Speaker audio clip playback settings.
+ *
+ * @category Automations
+ */
+export declare interface PlaySpeakerAudioClipSettings {
+    /** Speaker device ID */
+    speakerId: string;
+    /** Audio clip ID to play */
+    audioClipId: string;
+    /** Volume level (0-100) */
+    volume?: number;
+}
+
 /**
  * Result of getting a recorded image.
  *
@@ -4006,6 +4769,44 @@ export declare type Result<T> = {
  */
 export declare function revokeToken(): Promise<Result<void>>;
 
+/**
+ * Slack integration settings.
+ *
+ * @category Automations
+ */
+export declare interface SlackSettings {
+    /** Slack webhook URL */
+    webhookUrl: string;
+    /** Channel to post to */
+    channel?: string;
+    /** Bot username */
+    username?: string;
+}
+
+/**
+ * SMS notification settings.
+ *
+ * @category Automations
+ */
+export declare interface SmsSettings {
+    /** Phone numbers to send SMS to */
+    phoneNumbers: string[];
+}
+
+/**
+ * Email (SMTP) notification settings.
+ *
+ * @category Automations
+ */
+export declare interface SmtpSettings {
+    /** Email addresses to send to */
+    recipients: string[];
+    /** Email subject template */
+    subject?: string;
+    /** Email body template */
+    body?: string;
+}
+
 /**
  * SSE connection handle.
  *
@@ -4522,4 +5323,18 @@ export declare interface WebhookDeliveryConfigCreate {
     technicalContactName: string;
 }
 
+/**
+ * Webhook settings.
+ *
+ * @category Automations
+ */
+export declare interface WebhookSettings {
+    /** Webhook URL */
+    url: string;
+    /** HTTP method */
+    method?: 'GET' | 'POST' | 'PUT';
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+
 export { }