activitysmith 1.4.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f1236d70e7c0a571966c66fee6c6c336a4bb21c7dd139640e87c9221eee214
-  data.tar.gz: dc381048f626f8bee8d38309f802665f1b500d5867d762cc03d1d33285e5b18e
+  metadata.gz: 17820f972e80244f813c791d40dd85f577e20138ab932a03360586b749fb0435
+  data.tar.gz: 7505405af1b3bccd651c14aa1961e514db8faddcec679d902771310b6fd50792
 SHA512:
-  metadata.gz: 81ba38f68b643bd772b070cb1fe41a1508be65fee8a333dc2ab9612d3b1086862aa832523c2386b62c7704debf148df1a572ee8928e3c790c6c856dbf8c5a707
-  data.tar.gz: 5e4ff4d86a8ab98de278ebf84e6356b66592b14086cc0bcc324c0d7c08b1f5144264d9f152f7efa9175b45f26991cc4993e7cb6ddd70cf883e1122aaf7263f50
+  metadata.gz: 9b4b5da68c74c193b9b7eb87adca266b4573ebf56fb7c5a96133c4c6b45fb3eff85fbf168ae914951321359e4effd0c1ca3188a2c5cae14f0c838478862ab437
+  data.tar.gz: 1c21388cb1a583fa807fc8959db0286a0d65f937c031bde333120028e7508f45080e1f9dec46edfbe656cdb9bb9d667f5baa5845104dac6d772290f3eda1663c

data/README.md

@@ -18,6 +18,8 @@ See [API reference](https://activitysmith.com/docs/api-reference/introduction).
   - [Start & Update Live Activity](#start--update-live-activity)
   - [End Live Activity](#end-live-activity)
   - [Live Activity Action](#live-activity-action)
+  - [Icons and Badges](#icons-and-badges)
+  - [Live Activity Colors](#live-activity-colors)
 - [Channels](#channels)
 - [Widgets](#widgets)
 
@@ -88,7 +90,7 @@ What will work:
   <img src="https://cdn.activitysmith.com/features/actionable-push-notifications-2.png" alt="Actionable push notification example" width="680" />
 </p>
 
-Actionable push notifications can open a URL on tap or trigger actions when someone long-presses the notification.
+Push notification `redirection` and `actions` are optional. Use them to open HTTPS URLs, run a specific iPhone Shortcut with `shortcuts://run-shortcut?name=...`, or trigger backend webhook workflows.
 Webhooks are executed by the ActivitySmith backend.
 
 ```ruby
@@ -103,6 +105,11 @@ activitysmith.notifications.send(
         type: "open_url",
         url: "https://crm.example.com/customers/cus_9f3a1d"
       },
+      {
+        title: "Chat with Jarvis",
+        type: "open_url",
+        url: "shortcuts://run-shortcut?name=Jarvis"
+      },
       {
         title: "Start Onboarding Workflow",
         type: "webhook",
@@ -120,13 +127,14 @@ activitysmith.notifications.send(
 
 ## Live Activities
 
-There are five types of Live Activities:
+There are six types of Live Activities:
 
 - `stats`: best for showing business numbers side by side, such as revenue, sales, new users, conversion, refunds, or any other value you want visible at a glance
 - `metrics`: best for live percentage values that change often, like server CPU, memory usage, disk usage, or error rate
 - `segmented_progress`: best for anything that moves through clear stages, like deployments, onboarding flows, backups, ETL pipelines, migrations, and AI agent runs
 - `progress`: best for tracking real-time progress with percentage, like tasks, backups, migrations, syncs, or uploads
 - `alert`: best for status updates, such as feature adoption, reactivation, onboarding blockers, incidents, escalations, and other operational states
+- `timer`: best for countdowns and elapsed runtime, like benchmark runs, uploads, backups, transcodes, and long-running jobs
 
 ### Start & Update Live Activity
 
@@ -264,13 +272,34 @@ activitysmith.live_activities.stream(
 )
 ```
 
-The `icon` symbol value is an Apple SF Symbol name. Browse the catalog with one of these tools:
+#### Timer
 
-- [ActivitySmith app](https://apps.apple.com/us/app/activitysmith/id6752254835) - Open Settings -> SF Symbols to browse 45 hand-picked icons ready to use
-- [SF Symbols](https://developer.apple.com/sf-symbols/) - Apple's official macOS app
-- [Interactful](https://apps.apple.com/app/interactful/id1528095640) - free third-party iOS app listing all SF Symbols under Foundations -> Iconography
+<p align="center">
+  <img
+    src="https://cdn.activitysmith.com/features/timer-live-activity.png"
+    alt="Timer Live Activity showing a benchmark run countdown"
+    width="680"
+  />
+</p>
 
-`icon` and `badge` are optional. If you omit either one, that element is not shown in the Live Activity.
+```ruby
+activitysmith.live_activities.stream(
+  "benchmark-run",
+  {
+    content_state: {
+      title: "Benchmark Run",
+      subtitle: "sampling",
+      type: "timer",
+      duration_seconds: 300,
+      color: "cyan"
+    }
+  }
+)
+```
+
+For a countdown, send `duration_seconds`. You can update `title`, `subtitle`, `color`, or any other visible field as the work changes. Leave `duration_seconds` out unless you want to change the timer.
+
+To start at 00:00 and count up, set `counts_down: false` and leave out `duration_seconds`.
 
 ### End Live Activity
 
@@ -296,8 +325,11 @@ activitysmith.live_activities.end_stream(
 
 ### Live Activity Action
 
-Live Activities can include one optional action button. Use it to open a URL from the Live Activity or trigger a backend webhook.
-For Alert Live Activities, set `color` in `content_state` to tint the action button. Icon and badge colors only affect the icon and badge.
+Live Activities can include one optional action button.
+
+- `open_url`: open an HTTPS URL.
+- `open_url` with a `shortcuts://run-shortcut?name=...` URL: run a specific iPhone Shortcut, for example to open an app.
+- `webhook`: trigger a backend GET/POST workflow.
 
 <p align="center">
   <img
@@ -323,7 +355,7 @@ activitysmith.live_activities.stream(
       ]
     },
     action: {
-      title: "Open Dashboard",
+      title: "Dashboard",
       type: "open_url",
       url: "https://ops.example.com/servers/prod-web-1"
     }
@@ -331,6 +363,28 @@ activitysmith.live_activities.stream(
 )
 ```
 
+#### Apple Shortcut action
+
+```ruby
+activitysmith.live_activities.stream(
+  "deploy-payments-api",
+  {
+    content_state: {
+      title: "Deploying payments-api",
+      subtitle: "Running database migrations",
+      type: "segmented_progress",
+      number_of_steps: 5,
+      current_step: 3
+    },
+    action: {
+      title: "Chat with Jarvis",
+      type: "open_url",
+      url: "shortcuts://run-shortcut?name=Jarvis"
+    }
+  }
+)
+```
+
 #### Webhook action
 
 ```ruby
@@ -358,6 +412,79 @@ activitysmith.live_activities.stream(
 )
 ```
 
+### Icons and Badges
+
+Add more context to Live Activities with icons and badges.
+
+#### Icon
+
+Supported Live Activity types: `stats`, `metrics`, `progress`, `segmented_progress`, `alert`, and `timer`.
+
+<p align="center">
+  <img
+    src="https://cdn.activitysmith.com/features/metrics-live-activity-with-icon.png"
+    alt="Metrics Live Activity with an SF Symbol icon on the iPhone Lock Screen"
+    width="680"
+  />
+</p>
+
+```ruby
+activitysmith.live_activities.stream(
+  "prod-web-1",
+  {
+    content_state: ActivitySmith::LiveActivities.content_state(
+      title: "Server Health",
+      subtitle: "prod-web-1",
+      type: "metrics",
+      icon: ActivitySmith::LiveActivities.alert_icon("server.rack", color: "blue"),
+      metrics: [
+        { label: "CPU", value: 18, unit: "%" },
+        { label: "MEM", value: 42, unit: "%" }
+      ]
+    )
+  }
+)
+```
+
+The `icon` symbol value is an Apple SF Symbol name. Browse the catalog with one of these tools:
+
+- [ActivitySmith app](https://apps.apple.com/us/app/activitysmith/id6752254835) - Open Settings -> SF Symbols to browse 45 hand-picked icons ready to use
+- [SF Symbols](https://developer.apple.com/sf-symbols/) - Apple's official macOS app
+- [Interactful](https://apps.apple.com/app/interactful/id1528095640) - free third-party iOS app listing all SF Symbols under Foundations -> Iconography
+
+#### Badge
+
+Badges are supported by `alert`, `progress`, and `segmented_progress` Live Activities.
+
+<p align="center">
+  <img
+    src="https://cdn.activitysmith.com/features/progress-live-activity-with-badge.png"
+    alt="Progress Live Activity with a badge on the iPhone Lock Screen"
+    width="680"
+  />
+</p>
+
+```ruby
+activitysmith.live_activities.stream(
+  "nightly-database-backup",
+  {
+    content_state: ActivitySmith::LiveActivities.content_state(
+      title: "Nightly Database Backup",
+      subtitle: "verify restore",
+      type: "progress",
+      badge: ActivitySmith::LiveActivities.alert_badge("S3", color: "cyan"),
+      percentage: 62
+    )
+  }
+)
+```
+
+### Live Activity Colors
+
+Choose from these colors for the Live Activity accent, including progress bars and action buttons, or apply them to an individual icon or badge:
+
+`lime`, `green`, `cyan`, `blue`, `purple`, `magenta`, `red`, `orange`, `yellow`, `gray`
+
 ## Channels
 
 Channels are used to target specific team members or devices. Can be used for both push notifications and live activities.

data/generated/activitysmith_openapi/api/live_activities_api.rb

@@ -20,7 +20,7 @@ module OpenapiClient
       @api_client = api_client
     end
     # End a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use DELETE /live-activity/stream/{stream_key} to end a managed Live Activity stream. This endpoint remains supported for existing integrations and advanced lifecycle control. Ends a Live Activity and archives its lifecycle. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, you can send the latest number_of_steps here if the workflow changed after start.
+    # Legacy manual lifecycle endpoint. For new integrations, use DELETE /live-activity/stream/{stream_key} to end a managed Live Activity stream. This endpoint remains supported for existing integrations and advanced lifecycle control. Ends a Live Activity and archives its lifecycle. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, you can send the latest number_of_steps here if the workflow changed after start.
     # @param live_activity_end_request [LiveActivityEndRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LiveActivityEndResponse]
@@ -30,7 +30,7 @@ module OpenapiClient
     end
 
     # End a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use DELETE /live-activity/stream/{stream_key} to end a managed Live Activity stream. This endpoint remains supported for existing integrations and advanced lifecycle control. Ends a Live Activity and archives its lifecycle. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, you can send the latest number_of_steps here if the workflow changed after start.
+    # Legacy manual lifecycle endpoint. For new integrations, use DELETE /live-activity/stream/{stream_key} to end a managed Live Activity stream. This endpoint remains supported for existing integrations and advanced lifecycle control. Ends a Live Activity and archives its lifecycle. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, you can send the latest number_of_steps here if the workflow changed after start.
     # @param live_activity_end_request [LiveActivityEndRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LiveActivityEndResponse, Integer, Hash)>] LiveActivityEndResponse data, response status code and response headers
@@ -167,7 +167,7 @@ module OpenapiClient
     end
 
     # Start a new Live Activity or update an existing one
-    # Use a stable stream_key for each ongoing thing you want to show as a Live Activity. Send the latest content_state whenever it changes, and ActivitySmith will keep the Live Activity in sync.
+    # Use a stable stream_key for each ongoing thing you want to show as a Live Activity. Send the latest content_state whenever it changes, and ActivitySmith will keep the Live Activity in sync. For timer streams, send duration_seconds to start or reset the timer; omit duration_seconds on later updates to preserve the existing timer window.
     # @param stream_key [String] Stable identifier for one ongoing thing. Allowed characters: letters, numbers, underscores, and hyphens.
     # @param live_activity_stream_request [LiveActivityStreamRequest] 
     # @param [Hash] opts the optional parameters
@@ -178,7 +178,7 @@ module OpenapiClient
     end
 
     # Start a new Live Activity or update an existing one
-    # Use a stable stream_key for each ongoing thing you want to show as a Live Activity. Send the latest content_state whenever it changes, and ActivitySmith will keep the Live Activity in sync.
+    # Use a stable stream_key for each ongoing thing you want to show as a Live Activity. Send the latest content_state whenever it changes, and ActivitySmith will keep the Live Activity in sync. For timer streams, send duration_seconds to start or reset the timer; omit duration_seconds on later updates to preserve the existing timer window.
     # @param stream_key [String] Stable identifier for one ongoing thing. Allowed characters: letters, numbers, underscores, and hyphens.
     # @param live_activity_stream_request [LiveActivityStreamRequest] 
     # @param [Hash] opts the optional parameters
@@ -250,7 +250,7 @@ module OpenapiClient
     end
 
     # Start a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Starts a Live Activity on devices matched by API key scope and optional target channels. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, number_of_steps can be changed later during update or end calls if the workflow changes.
+    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Starts a Live Activity on devices matched by API key scope and optional target channels. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, number_of_steps can be changed later during update or end calls if the workflow changes.
     # @param live_activity_start_request [LiveActivityStartRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LiveActivityStartResponse]
@@ -260,7 +260,7 @@ module OpenapiClient
     end
 
     # Start a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Starts a Live Activity on devices matched by API key scope and optional target channels. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, number_of_steps can be changed later during update or end calls if the workflow changes.
+    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Starts a Live Activity on devices matched by API key scope and optional target channels. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, number_of_steps can be changed later during update or end calls if the workflow changes.
     # @param live_activity_start_request [LiveActivityStartRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LiveActivityStartResponse, Integer, Hash)>] LiveActivityStartResponse data, response status code and response headers
@@ -318,7 +318,7 @@ module OpenapiClient
     end
 
     # Update a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Updates an existing Live Activity. If the per-activity token is not registered yet, the update is queued. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, you can increase or decrease number_of_steps here as the workflow changes.
+    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Updates an existing Live Activity. If the per-activity token is not registered yet, the update is queued. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, you can increase or decrease number_of_steps here as the workflow changes. For timer activities, send duration_seconds only when you want to reset the timer window; omit it to keep the current timer running.
     # @param live_activity_update_request [LiveActivityUpdateRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LiveActivityUpdateResponse]
@@ -328,7 +328,7 @@ module OpenapiClient
     end
 
     # Update a Live Activity (legacy manual lifecycle)
-    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Updates an existing Live Activity. If the per-activity token is not registered yet, the update is queued. Supports segmented_progress, progress, metrics, stats, and alert activity types. For segmented_progress activities, you can increase or decrease number_of_steps here as the workflow changes.
+    # Legacy manual lifecycle endpoint. For new integrations, use PUT /live-activity/stream/{stream_key} so ActivitySmith can manage start, update, rotation, and end state for you. This endpoint remains supported for existing integrations and advanced lifecycle control. Updates an existing Live Activity. If the per-activity token is not registered yet, the update is queued. Supports segmented_progress, progress, metrics, stats, alert, and timer activity types. For segmented_progress activities, you can increase or decrease number_of_steps here as the workflow changes. For timer activities, send duration_seconds only when you want to reset the timer window; omit it to keep the current timer running.
     # @param live_activity_update_request [LiveActivityUpdateRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LiveActivityUpdateResponse, Integer, Hash)>] LiveActivityUpdateResponse data, response status code and response headers

data/generated/activitysmith_openapi/models/content_state_end.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # End payload requires title. For segmented_progress include current_step and optionally number_of_steps. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message, with optional icon and badge. Type is optional when ending an existing activity. You can send an updated number_of_steps here if the workflow changed after start.
+  # End payload requires title. For segmented_progress include current_step and optionally number_of_steps. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message. For timer, omit duration_seconds to preserve and freeze the latest timer state. Optional icon is supported by all Live Activity types. Optional badge is supported by alert, progress, and segmented_progress. Type is optional when ending an existing activity. You can send an updated number_of_steps here if the workflow changed after start.
   class ContentStateEnd
     attr_accessor :title
 
@@ -23,7 +23,7 @@ module OpenapiClient
     # Total number of steps. Use for type=segmented_progress. Optional on end, and safe to change if the final workflow used more or fewer steps than originally planned.
     attr_accessor :number_of_steps
 
-    # Current step. Use for type=segmented_progress.
+    # Current completed step count. Use for type=segmented_progress. Must be less than or equal to number_of_steps when number_of_steps is provided.
     attr_accessor :current_step
 
     # Progress percentage (0–100). Use for type=progress. Takes precedence over value/upper_limit if both are provided.
@@ -35,22 +35,31 @@ module OpenapiClient
     # Maximum progress value. Use with value for type=progress.
     attr_accessor :upper_limit
 
+    # Timer duration in seconds. For type=timer, omit duration_seconds on end to preserve and freeze the latest timer state.
+    attr_accessor :duration_seconds
+
+    # Use with type=timer. When true or omitted, the timer counts down from duration_seconds. Set false for an elapsed timer; omit duration_seconds for an open-ended elapsed timer.
+    attr_accessor :counts_down
+
+    # Use with type=timer. Defaults to true. Set false to pause/freeze via API; set true on a paused timer to resume.
+    attr_accessor :is_running
+
     # Use for type=metrics or type=stats.
     attr_accessor :metrics
 
     # Alert message. Use for type=alert.
     attr_accessor :message
 
-    # Optional SF Symbol icon for type=alert.
+    # Optional SF Symbol icon. Supported by alert, progress, segmented_progress, metrics, stats, and timer.
     attr_accessor :icon
 
-    # Optional badge for type=alert.
+    # Optional badge. Supported by alert, progress, and segmented_progress.
     attr_accessor :badge
 
     # Optional. When omitted, the API uses the existing Live Activity type.
     attr_accessor :type
 
-    # Optional. Accent color for progress, segmented_progress, and metrics Live Activities. For Alert Live Activities, this tints the action button when action is included.
+    # Optional. Accent color for progress, segmented_progress, metrics, and timer Live Activities. For Alert Live Activities, this tints the action button when action is included.
     attr_accessor :color
 
     # Optional. Overrides color for the current step. Only applies to type=segmented_progress.
@@ -94,6 +103,9 @@ module OpenapiClient
         :'percentage' => :'percentage',
         :'value' => :'value',
         :'upper_limit' => :'upper_limit',
+        :'duration_seconds' => :'duration_seconds',
+        :'counts_down' => :'counts_down',
+        :'is_running' => :'is_running',
         :'metrics' => :'metrics',
         :'message' => :'message',
         :'icon' => :'icon',
@@ -121,6 +133,9 @@ module OpenapiClient
         :'percentage' => :'Float',
         :'value' => :'Float',
         :'upper_limit' => :'Float',
+        :'duration_seconds' => :'Float',
+        :'counts_down' => :'Boolean',
+        :'is_running' => :'Boolean',
         :'metrics' => :'Array<ActivityMetric>',
         :'message' => :'String',
         :'icon' => :'LiveActivityAlertIcon',
@@ -184,6 +199,22 @@ module OpenapiClient
         self.upper_limit = attributes[:'upper_limit']
       end
 
+      if attributes.key?(:'duration_seconds')
+        self.duration_seconds = attributes[:'duration_seconds']
+      end
+
+      if attributes.key?(:'counts_down')
+        self.counts_down = attributes[:'counts_down']
+      else
+        self.counts_down = true
+      end
+
+      if attributes.key?(:'is_running')
+        self.is_running = attributes[:'is_running']
+      else
+        self.is_running = true
+      end
+
       if attributes.key?(:'metrics')
         if (value = attributes[:'metrics']).is_a?(Array)
           self.metrics = value
@@ -240,8 +271,8 @@ module OpenapiClient
         invalid_properties.push('invalid value for "number_of_steps", must be greater than or equal to 1.')
       end
 
-      if !@current_step.nil? && @current_step < 1
-        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 1.')
+      if !@current_step.nil? && @current_step < 0
+        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 0.')
       end
 
       if !@percentage.nil? && @percentage > 100
@@ -277,13 +308,13 @@ module OpenapiClient
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @title.nil?
       return false if !@number_of_steps.nil? && @number_of_steps < 1
-      return false if !@current_step.nil? && @current_step < 1
+      return false if !@current_step.nil? && @current_step < 0
       return false if !@percentage.nil? && @percentage > 100
       return false if !@percentage.nil? && @percentage < 0
       return false if !@metrics.nil? && @metrics.length > 8
       return false if !@metrics.nil? && @metrics.length < 1
       return false if !@message.nil? && @message.to_s.length < 1
-      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       return false unless type_validator.valid?(@type)
       color_validator = EnumAttributeValidator.new('String', ["lime", "green", "cyan", "blue", "purple", "magenta", "red", "orange", "yellow", "gray"])
       return false unless color_validator.valid?(@color)
@@ -314,8 +345,8 @@ module OpenapiClient
         fail ArgumentError, 'current_step cannot be nil'
       end
 
-      if current_step < 1
-        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 1.'
+      if current_step < 0
+        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 0.'
       end
 
       @current_step = current_step
@@ -374,7 +405,7 @@ module OpenapiClient
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] type Object to be assigned
     def type=(type)
-      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       unless validator.valid?(type)
         fail ArgumentError, "invalid value for \"type\", must be one of #{validator.allowable_values}."
       end
@@ -427,6 +458,9 @@ module OpenapiClient
           percentage == o.percentage &&
           value == o.value &&
           upper_limit == o.upper_limit &&
+          duration_seconds == o.duration_seconds &&
+          counts_down == o.counts_down &&
+          is_running == o.is_running &&
           metrics == o.metrics &&
           message == o.message &&
           icon == o.icon &&
@@ -447,7 +481,7 @@ module OpenapiClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, metrics, message, icon, badge, type, color, step_color, step_colors, auto_dismiss_minutes].hash
+      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, duration_seconds, counts_down, is_running, metrics, message, icon, badge, type, color, step_color, step_colors, auto_dismiss_minutes].hash
     end
 
     # Builds the object from hash

data/generated/activitysmith_openapi/models/content_state_start.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # Start payload requires title and type. For segmented_progress include number_of_steps and current_step. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message, with optional icon and badge. For segmented_progress, number_of_steps is not locked and can be changed in later update or end calls.
+  # Start payload requires title and type. For segmented_progress include number_of_steps and current_step. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message. For timer include duration_seconds for countdowns, or set counts_down false without duration_seconds for an open-ended elapsed timer. Optional icon is supported by all Live Activity types. Optional badge is supported by alert, progress, and segmented_progress. For segmented_progress, number_of_steps is not locked and can be changed in later update or end calls.
   class ContentStateStart
     attr_accessor :title
 
@@ -23,7 +23,7 @@ module OpenapiClient
     # Total number of steps. Use for type=segmented_progress. This value can be increased or decreased later when updating or ending the same activity.
     attr_accessor :number_of_steps
 
-    # Current step. Use for type=segmented_progress.
+    # Current completed step count. Use for type=segmented_progress. Set 0 when the activity has started but no segment is complete yet. Must be less than or equal to number_of_steps.
     attr_accessor :current_step
 
     # Progress percentage (0–100). Use for type=progress. Takes precedence over value/upper_limit if both are provided.
@@ -35,21 +35,30 @@ module OpenapiClient
     # Maximum progress value. Use with value for type=progress.
     attr_accessor :upper_limit
 
+    # Timer duration in seconds. For type=timer countdowns, required on start when counts_down is true or omitted.
+    attr_accessor :duration_seconds
+
+    # Use with type=timer. When true or omitted, the timer counts down from duration_seconds. Set false for an elapsed timer; omit duration_seconds for an open-ended elapsed timer.
+    attr_accessor :counts_down
+
+    # Use with type=timer. Defaults to true. Set false to pause/freeze via API; set true on a paused timer to resume.
+    attr_accessor :is_running
+
     # Use for type=metrics or type=stats.
     attr_accessor :metrics
 
     # Required for type=alert.
     attr_accessor :message
 
-    # Optional SF Symbol icon for type=alert.
+    # Optional SF Symbol icon. Supported by alert, progress, segmented_progress, metrics, stats, and timer.
     attr_accessor :icon
 
-    # Optional badge for type=alert.
+    # Optional badge. Supported by alert, progress, and segmented_progress.
     attr_accessor :badge
 
     attr_accessor :type
 
-    # Optional. Accent color for progress, segmented_progress, and metrics Live Activities. For Alert Live Activities, this tints the action button when action is included.
+    # Optional. Accent color for progress, segmented_progress, metrics, and timer Live Activities. For Alert Live Activities, this tints the action button when action is included.
     attr_accessor :color
 
     # Optional. Overrides color for the current step. Only applies to type=segmented_progress.
@@ -90,6 +99,9 @@ module OpenapiClient
         :'percentage' => :'percentage',
         :'value' => :'value',
         :'upper_limit' => :'upper_limit',
+        :'duration_seconds' => :'duration_seconds',
+        :'counts_down' => :'counts_down',
+        :'is_running' => :'is_running',
         :'metrics' => :'metrics',
         :'message' => :'message',
         :'icon' => :'icon',
@@ -116,6 +128,9 @@ module OpenapiClient
         :'percentage' => :'Float',
         :'value' => :'Float',
         :'upper_limit' => :'Float',
+        :'duration_seconds' => :'Float',
+        :'counts_down' => :'Boolean',
+        :'is_running' => :'Boolean',
         :'metrics' => :'Array<ActivityMetric>',
         :'message' => :'String',
         :'icon' => :'LiveActivityAlertIcon',
@@ -178,6 +193,22 @@ module OpenapiClient
         self.upper_limit = attributes[:'upper_limit']
       end
 
+      if attributes.key?(:'duration_seconds')
+        self.duration_seconds = attributes[:'duration_seconds']
+      end
+
+      if attributes.key?(:'counts_down')
+        self.counts_down = attributes[:'counts_down']
+      else
+        self.counts_down = true
+      end
+
+      if attributes.key?(:'is_running')
+        self.is_running = attributes[:'is_running']
+      else
+        self.is_running = true
+      end
+
       if attributes.key?(:'metrics')
         if (value = attributes[:'metrics']).is_a?(Array)
           self.metrics = value
@@ -230,8 +261,8 @@ module OpenapiClient
         invalid_properties.push('invalid value for "number_of_steps", must be greater than or equal to 1.')
       end
 
-      if !@current_step.nil? && @current_step < 1
-        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 1.')
+      if !@current_step.nil? && @current_step < 0
+        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 0.')
       end
 
       if !@percentage.nil? && @percentage > 100
@@ -267,14 +298,14 @@ module OpenapiClient
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @title.nil?
       return false if !@number_of_steps.nil? && @number_of_steps < 1
-      return false if !@current_step.nil? && @current_step < 1
+      return false if !@current_step.nil? && @current_step < 0
       return false if !@percentage.nil? && @percentage > 100
       return false if !@percentage.nil? && @percentage < 0
       return false if !@metrics.nil? && @metrics.length > 8
       return false if !@metrics.nil? && @metrics.length < 1
       return false if !@message.nil? && @message.to_s.length < 1
       return false if @type.nil?
-      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       return false unless type_validator.valid?(@type)
       color_validator = EnumAttributeValidator.new('String', ["lime", "green", "cyan", "blue", "purple", "magenta", "red", "orange", "yellow", "gray"])
       return false unless color_validator.valid?(@color)
@@ -304,8 +335,8 @@ module OpenapiClient
         fail ArgumentError, 'current_step cannot be nil'
       end
 
-      if current_step < 1
-        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 1.'
+      if current_step < 0
+        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 0.'
       end
 
       @current_step = current_step
@@ -364,7 +395,7 @@ module OpenapiClient
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] type Object to be assigned
     def type=(type)
-      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       unless validator.valid?(type)
         fail ArgumentError, "invalid value for \"type\", must be one of #{validator.allowable_values}."
       end
@@ -403,6 +434,9 @@ module OpenapiClient
           percentage == o.percentage &&
           value == o.value &&
           upper_limit == o.upper_limit &&
+          duration_seconds == o.duration_seconds &&
+          counts_down == o.counts_down &&
+          is_running == o.is_running &&
           metrics == o.metrics &&
           message == o.message &&
           icon == o.icon &&
@@ -422,7 +456,7 @@ module OpenapiClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, metrics, message, icon, badge, type, color, step_color, step_colors].hash
+      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, duration_seconds, counts_down, is_running, metrics, message, icon, badge, type, color, step_color, step_colors].hash
     end
 
     # Builds the object from hash

data/generated/activitysmith_openapi/models/content_state_update.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # Update payload requires title. For segmented_progress include current_step and optionally number_of_steps. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message, with optional icon and badge. Type is optional when updating an existing activity. You can increase or decrease number_of_steps during updates.
+  # Update payload requires title. For segmented_progress include current_step and optionally number_of_steps. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For alert include message. For timer, omit duration_seconds to preserve the current timer window or send duration_seconds to reset the timer from the update request time. Optional icon is supported by all Live Activity types. Optional badge is supported by alert, progress, and segmented_progress. Type is optional when updating an existing activity. You can increase or decrease number_of_steps during updates.
   class ContentStateUpdate
     attr_accessor :title
 
@@ -23,7 +23,7 @@ module OpenapiClient
     # Total number of steps. Use for type=segmented_progress. Optional on update, and safe to change if the workflow gains or loses steps.
     attr_accessor :number_of_steps
 
-    # Current step. Use for type=segmented_progress.
+    # Current completed step count. Use for type=segmented_progress. Set 0 when no segment is complete yet. Must be less than or equal to number_of_steps when number_of_steps is provided.
     attr_accessor :current_step
 
     # Progress percentage (0–100). Use for type=progress. Takes precedence over value/upper_limit if both are provided.
@@ -35,22 +35,31 @@ module OpenapiClient
     # Maximum progress value. Use with value for type=progress.
     attr_accessor :upper_limit
 
+    # Timer duration in seconds. For type=timer, sending duration_seconds resets the timer window from the update request time; omit it to preserve the existing timer window.
+    attr_accessor :duration_seconds
+
+    # Use with type=timer. When true or omitted, the timer counts down from duration_seconds. Set false for an elapsed timer; omit duration_seconds for an open-ended elapsed timer.
+    attr_accessor :counts_down
+
+    # Use with type=timer. Defaults to true. Set false to pause/freeze via API; set true on a paused timer to resume.
+    attr_accessor :is_running
+
     # Use for type=metrics or type=stats.
     attr_accessor :metrics
 
     # Alert message. Use for type=alert.
     attr_accessor :message
 
-    # Optional SF Symbol icon for type=alert.
+    # Optional SF Symbol icon. Supported by alert, progress, segmented_progress, metrics, stats, and timer.
     attr_accessor :icon
 
-    # Optional badge for type=alert.
+    # Optional badge. Supported by alert, progress, and segmented_progress.
     attr_accessor :badge
 
     # Optional. When omitted, the API uses the existing Live Activity type.
     attr_accessor :type
 
-    # Optional. Accent color for progress, segmented_progress, and metrics Live Activities. For Alert Live Activities, this tints the action button when action is included.
+    # Optional. Accent color for progress, segmented_progress, metrics, and timer Live Activities. For Alert Live Activities, this tints the action button when action is included.
     attr_accessor :color
 
     # Optional. Overrides color for the current step. Only applies to type=segmented_progress.
@@ -91,6 +100,9 @@ module OpenapiClient
         :'percentage' => :'percentage',
         :'value' => :'value',
         :'upper_limit' => :'upper_limit',
+        :'duration_seconds' => :'duration_seconds',
+        :'counts_down' => :'counts_down',
+        :'is_running' => :'is_running',
         :'metrics' => :'metrics',
         :'message' => :'message',
         :'icon' => :'icon',
@@ -117,6 +129,9 @@ module OpenapiClient
         :'percentage' => :'Float',
         :'value' => :'Float',
         :'upper_limit' => :'Float',
+        :'duration_seconds' => :'Float',
+        :'counts_down' => :'Boolean',
+        :'is_running' => :'Boolean',
         :'metrics' => :'Array<ActivityMetric>',
         :'message' => :'String',
         :'icon' => :'LiveActivityAlertIcon',
@@ -179,6 +194,22 @@ module OpenapiClient
         self.upper_limit = attributes[:'upper_limit']
       end
 
+      if attributes.key?(:'duration_seconds')
+        self.duration_seconds = attributes[:'duration_seconds']
+      end
+
+      if attributes.key?(:'counts_down')
+        self.counts_down = attributes[:'counts_down']
+      else
+        self.counts_down = true
+      end
+
+      if attributes.key?(:'is_running')
+        self.is_running = attributes[:'is_running']
+      else
+        self.is_running = true
+      end
+
       if attributes.key?(:'metrics')
         if (value = attributes[:'metrics']).is_a?(Array)
           self.metrics = value
@@ -229,8 +260,8 @@ module OpenapiClient
         invalid_properties.push('invalid value for "number_of_steps", must be greater than or equal to 1.')
       end
 
-      if !@current_step.nil? && @current_step < 1
-        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 1.')
+      if !@current_step.nil? && @current_step < 0
+        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 0.')
       end
 
       if !@percentage.nil? && @percentage > 100
@@ -262,13 +293,13 @@ module OpenapiClient
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @title.nil?
       return false if !@number_of_steps.nil? && @number_of_steps < 1
-      return false if !@current_step.nil? && @current_step < 1
+      return false if !@current_step.nil? && @current_step < 0
       return false if !@percentage.nil? && @percentage > 100
       return false if !@percentage.nil? && @percentage < 0
       return false if !@metrics.nil? && @metrics.length > 8
       return false if !@metrics.nil? && @metrics.length < 1
       return false if !@message.nil? && @message.to_s.length < 1
-      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       return false unless type_validator.valid?(@type)
       color_validator = EnumAttributeValidator.new('String', ["lime", "green", "cyan", "blue", "purple", "magenta", "red", "orange", "yellow", "gray"])
       return false unless color_validator.valid?(@color)
@@ -298,8 +329,8 @@ module OpenapiClient
         fail ArgumentError, 'current_step cannot be nil'
       end
 
-      if current_step < 1
-        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 1.'
+      if current_step < 0
+        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 0.'
       end
 
       @current_step = current_step
@@ -358,7 +389,7 @@ module OpenapiClient
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] type Object to be assigned
     def type=(type)
-      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       unless validator.valid?(type)
         fail ArgumentError, "invalid value for \"type\", must be one of #{validator.allowable_values}."
       end
@@ -397,6 +428,9 @@ module OpenapiClient
           percentage == o.percentage &&
           value == o.value &&
           upper_limit == o.upper_limit &&
+          duration_seconds == o.duration_seconds &&
+          counts_down == o.counts_down &&
+          is_running == o.is_running &&
           metrics == o.metrics &&
           message == o.message &&
           icon == o.icon &&
@@ -416,7 +450,7 @@ module OpenapiClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, metrics, message, icon, badge, type, color, step_color, step_colors].hash
+      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, duration_seconds, counts_down, is_running, metrics, message, icon, badge, type, color, step_color, step_colors].hash
     end
 
     # Builds the object from hash

data/generated/activitysmith_openapi/models/live_activity_action.rb

@@ -21,7 +21,7 @@ module OpenapiClient
 
     attr_accessor :type
 
-    # HTTPS URL. For open_url it is opened in browser. For webhook it is called by ActivitySmith backend.
+    # Action URL. For open_url, use an HTTPS URL or a shortcuts://run-shortcut?name=... URL that runs a specific iPhone Shortcut. For webhook, use an HTTPS URL called by the ActivitySmith backend.
     attr_accessor :url
 
     # Webhook HTTP method. Used only when type=webhook.
@@ -30,28 +30,6 @@ module OpenapiClient
     # Optional webhook payload body. Used only when type=webhook.
     attr_accessor :body
 
-    class EnumAttributeValidator
-      attr_reader :datatype
-      attr_reader :allowable_values
-
-      def initialize(datatype, allowable_values)
-        @allowable_values = allowable_values.map do |value|
-          case datatype.to_s
-          when /Integer/i
-            value.to_i
-          when /Float/i
-            value.to_f
-          else
-            value
-          end
-        end
-      end
-
-      def valid?(value)
-        !value || allowable_values.include?(value)
-      end
-    end
-
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -148,11 +126,6 @@ module OpenapiClient
         invalid_properties.push('invalid value for "url", url cannot be nil.')
       end
 
-      pattern = Regexp.new(/^https:\/\//)
-      if @url !~ pattern
-        invalid_properties.push("invalid value for \"url\", must conform to the pattern #{pattern}.")
-      end
-
       invalid_properties
     end
 
@@ -163,25 +136,9 @@ module OpenapiClient
       return false if @title.nil?
       return false if @type.nil?
       return false if @url.nil?
-      return false if @url !~ Regexp.new(/^https:\/\//)
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] url Value to be assigned
-    def url=(url)
-      if url.nil?
-        fail ArgumentError, 'url cannot be nil'
-      end
-
-      pattern = Regexp.new(/^https:\/\//)
-      if url !~ pattern
-        fail ArgumentError, "invalid value for \"url\", must conform to the pattern #{pattern}."
-      end
-
-      @url = url
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

data/generated/activitysmith_openapi/models/live_activity_alert_badge.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # Optional badge for Alert Live Activities.
+  # Optional badge for Live Activities.
   class LiveActivityAlertBadge
     attr_accessor :title
 

data/generated/activitysmith_openapi/models/live_activity_alert_icon.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # Optional SF Symbol icon for Alert Live Activities.
+  # Optional SF Symbol icon for Live Activities.
   class LiveActivityAlertIcon
     # Apple SF Symbol name.
     attr_accessor :symbol

data/generated/activitysmith_openapi/models/push_notification_action.rb

@@ -20,7 +20,7 @@ module OpenapiClient
 
     attr_accessor :type
 
-    # HTTPS URL. For open_url it is opened in browser. For webhook it is called by ActivitySmith backend.
+    # Action URL. For open_url, use an HTTPS URL or a shortcuts://run-shortcut?name=... URL that runs a specific iPhone Shortcut. For webhook, use an HTTPS URL called by the ActivitySmith backend.
     attr_accessor :url
 
     # Webhook HTTP method. Used only when type=webhook.
@@ -29,28 +29,6 @@ module OpenapiClient
     # Optional webhook payload body. Used only when type=webhook.
     attr_accessor :body
 
-    class EnumAttributeValidator
-      attr_reader :datatype
-      attr_reader :allowable_values
-
-      def initialize(datatype, allowable_values)
-        @allowable_values = allowable_values.map do |value|
-          case datatype.to_s
-          when /Integer/i
-            value.to_i
-          when /Float/i
-            value.to_f
-          else
-            value
-          end
-        end
-      end
-
-      def valid?(value)
-        !value || allowable_values.include?(value)
-      end
-    end
-
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -147,11 +125,6 @@ module OpenapiClient
         invalid_properties.push('invalid value for "url", url cannot be nil.')
       end
 
-      pattern = Regexp.new(/^https:\/\//)
-      if @url !~ pattern
-        invalid_properties.push("invalid value for \"url\", must conform to the pattern #{pattern}.")
-      end
-
       invalid_properties
     end
 
@@ -162,25 +135,9 @@ module OpenapiClient
       return false if @title.nil?
       return false if @type.nil?
       return false if @url.nil?
-      return false if @url !~ Regexp.new(/^https:\/\//)
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] url Value to be assigned
-    def url=(url)
-      if url.nil?
-        fail ArgumentError, 'url cannot be nil'
-      end
-
-      pattern = Regexp.new(/^https:\/\//)
-      if url !~ pattern
-        fail ArgumentError, "invalid value for \"url\", must conform to the pattern #{pattern}."
-      end
-
-      @url = url
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

data/generated/activitysmith_openapi/models/push_notification_request.rb

@@ -24,7 +24,7 @@ module OpenapiClient
     # Optional HTTPS URL for an image, audio file, or video that users can preview or play when they expand the notification. If `redirection` is omitted, tapping the notification opens this URL. Cannot be combined with `actions`.
     attr_accessor :media
 
-    # Optional HTTPS URL opened when user taps the notification body. Overrides the default tap target from `media` when both are provided.
+    # Optional HTTPS URL or shortcuts://run-shortcut?name=... URL opened when the user taps the notification body. Use shortcuts://run-shortcut?name=... to run a specific iPhone Shortcut that already exists on the user's device. Overrides the default tap target from `media` when both are provided.
     attr_accessor :redirection
 
     # Optional interactive actions shown when users expand the notification. Cannot be combined with `media`.
@@ -157,7 +157,7 @@ module OpenapiClient
         invalid_properties.push("invalid value for \"media\", must conform to the pattern #{pattern}.")
       end
 
-      pattern = Regexp.new(/^https:\/\//)
+      pattern = Regexp.new(/^(https|shortcuts):\/\//)
       if !@redirection.nil? && @redirection !~ pattern
         invalid_properties.push("invalid value for \"redirection\", must conform to the pattern #{pattern}.")
       end
@@ -175,7 +175,7 @@ module OpenapiClient
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @title.nil?
       return false if !@media.nil? && @media !~ Regexp.new(/^https:\/\//)
-      return false if !@redirection.nil? && @redirection !~ Regexp.new(/^https:\/\//)
+      return false if !@redirection.nil? && @redirection !~ Regexp.new(/^(https|shortcuts):\/\//)
       return false if !@actions.nil? && @actions.length > 4
       true
     end
@@ -202,7 +202,7 @@ module OpenapiClient
         fail ArgumentError, 'redirection cannot be nil'
       end
 
-      pattern = Regexp.new(/^https:\/\//)
+      pattern = Regexp.new(/^(https|shortcuts):\/\//)
       if redirection !~ pattern
         fail ArgumentError, "invalid value for \"redirection\", must conform to the pattern #{pattern}."
       end

data/generated/activitysmith_openapi/models/stream_content_state.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module OpenapiClient
-  # Current state for a managed Live Activity stream. Include type on the first PUT, and whenever the stream may need to start a fresh activity. Supports segmented_progress, progress, metrics, stats, and alert types.
+  # Current state for a managed Live Activity stream. Include type on the first PUT, and whenever the stream may need to start a fresh activity. Supports segmented_progress, progress, metrics, stats, alert, and timer types. For timer, send duration_seconds to start or reset a bounded timer; omit duration_seconds on later updates to preserve the existing timer window.
   class StreamContentState
     attr_accessor :title
 
@@ -23,7 +23,7 @@ module OpenapiClient
     # Use for segmented_progress.
     attr_accessor :number_of_steps
 
-    # Use for segmented_progress.
+    # Use for segmented_progress. Set 0 when no segment is complete yet. Must be less than or equal to number_of_steps when number_of_steps is provided.
     attr_accessor :current_step
 
     # Use for progress. Takes precedence over value/upper_limit if both are provided.
@@ -35,10 +35,19 @@ module OpenapiClient
     # Maximum progress value. Use with value for progress.
     attr_accessor :upper_limit
 
+    # Timer duration in seconds. For type=timer, send duration_seconds to start or reset the timer window; omit it on later stream updates to preserve the existing timer window.
+    attr_accessor :duration_seconds
+
+    # Use with type=timer. When true or omitted, the timer counts down from duration_seconds. Set false for an elapsed timer; omit duration_seconds for an open-ended elapsed timer.
+    attr_accessor :counts_down
+
+    # Use with type=timer. Defaults to true. Set false to pause/freeze via API; set true on a paused timer to resume.
+    attr_accessor :is_running
+
     # Required on the first PUT or whenever the stream cannot infer the current activity type.
     attr_accessor :type
 
-    # Optional. Accent color for progress, segmented_progress, and metrics Live Activities. For Alert Live Activities, this tints the action button when action is included.
+    # Optional. Accent color for progress, segmented_progress, metrics, and timer Live Activities. For Alert Live Activities, this tints the action button when action is included.
     attr_accessor :color
 
     # Optional. Overrides color for the current step. Only applies to segmented_progress.
@@ -53,10 +62,10 @@ module OpenapiClient
     # Required for type=alert.
     attr_accessor :message
 
-    # Optional SF Symbol icon for type=alert.
+    # Optional SF Symbol icon. Supported by alert, progress, segmented_progress, metrics, stats, and timer.
     attr_accessor :icon
 
-    # Optional badge for type=alert.
+    # Optional badge. Supported by alert, progress, and segmented_progress.
     attr_accessor :badge
 
     # Optional. Seconds before the ended Live Activity is dismissed.
@@ -97,6 +106,9 @@ module OpenapiClient
         :'percentage' => :'percentage',
         :'value' => :'value',
         :'upper_limit' => :'upper_limit',
+        :'duration_seconds' => :'duration_seconds',
+        :'counts_down' => :'counts_down',
+        :'is_running' => :'is_running',
         :'type' => :'type',
         :'color' => :'color',
         :'step_color' => :'step_color',
@@ -125,6 +137,9 @@ module OpenapiClient
         :'percentage' => :'Float',
         :'value' => :'Float',
         :'upper_limit' => :'Float',
+        :'duration_seconds' => :'Float',
+        :'counts_down' => :'Boolean',
+        :'is_running' => :'Boolean',
         :'type' => :'String',
         :'color' => :'String',
         :'step_color' => :'String',
@@ -189,6 +204,22 @@ module OpenapiClient
         self.upper_limit = attributes[:'upper_limit']
       end
 
+      if attributes.key?(:'duration_seconds')
+        self.duration_seconds = attributes[:'duration_seconds']
+      end
+
+      if attributes.key?(:'counts_down')
+        self.counts_down = attributes[:'counts_down']
+      else
+        self.counts_down = true
+      end
+
+      if attributes.key?(:'is_running')
+        self.is_running = attributes[:'is_running']
+      else
+        self.is_running = true
+      end
+
       if attributes.key?(:'type')
         self.type = attributes[:'type']
       end
@@ -247,8 +278,8 @@ module OpenapiClient
         invalid_properties.push('invalid value for "number_of_steps", must be greater than or equal to 1.')
       end
 
-      if !@current_step.nil? && @current_step < 1
-        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 1.')
+      if !@current_step.nil? && @current_step < 0
+        invalid_properties.push('invalid value for "current_step", must be greater than or equal to 0.')
       end
 
       if !@percentage.nil? && @percentage > 100
@@ -288,10 +319,10 @@ module OpenapiClient
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @title.nil?
       return false if !@number_of_steps.nil? && @number_of_steps < 1
-      return false if !@current_step.nil? && @current_step < 1
+      return false if !@current_step.nil? && @current_step < 0
       return false if !@percentage.nil? && @percentage > 100
       return false if !@percentage.nil? && @percentage < 0
-      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      type_validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       return false unless type_validator.valid?(@type)
       color_validator = EnumAttributeValidator.new('String', ["lime", "green", "cyan", "blue", "purple", "magenta", "red", "orange", "yellow", "gray"])
       return false unless color_validator.valid?(@color)
@@ -326,8 +357,8 @@ module OpenapiClient
         fail ArgumentError, 'current_step cannot be nil'
       end
 
-      if current_step < 1
-        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 1.'
+      if current_step < 0
+        fail ArgumentError, 'invalid value for "current_step", must be greater than or equal to 0.'
       end
 
       @current_step = current_step
@@ -354,7 +385,7 @@ module OpenapiClient
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] type Object to be assigned
     def type=(type)
-      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert"])
+      validator = EnumAttributeValidator.new('String', ["segmented_progress", "progress", "metrics", "stats", "alert", "timer"])
       unless validator.valid?(type)
         fail ArgumentError, "invalid value for \"type\", must be one of #{validator.allowable_values}."
       end
@@ -453,6 +484,9 @@ module OpenapiClient
           percentage == o.percentage &&
           value == o.value &&
           upper_limit == o.upper_limit &&
+          duration_seconds == o.duration_seconds &&
+          counts_down == o.counts_down &&
+          is_running == o.is_running &&
           type == o.type &&
           color == o.color &&
           step_color == o.step_color &&
@@ -474,7 +508,7 @@ module OpenapiClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, type, color, step_color, step_colors, metrics, message, icon, badge, auto_dismiss_seconds, auto_dismiss_minutes].hash
+      [title, subtitle, number_of_steps, current_step, percentage, value, upper_limit, duration_seconds, counts_down, is_running, type, color, step_color, step_colors, metrics, message, icon, badge, auto_dismiss_seconds, auto_dismiss_minutes].hash
     end
 
     # Builds the object from hash

data/generated/activitysmith_openapi/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.7.0
 =end
 
 module OpenapiClient
-  VERSION = '1.3.1'
+  VERSION = '1.7.0'
 end

data/lib/activitysmith/live_activities.rb

@@ -7,9 +7,10 @@ module ActivitySmith
     TYPE_METRICS = "metrics"
     TYPE_STATS = "stats"
     TYPE_ALERT = "alert"
+    TYPE_TIMER = "timer"
 
     class << self
-      def content_state(title:, type: nil, subtitle: nil, message: nil, icon: nil, badge: nil, color: nil, **fields)
+      def content_state(title:, type: nil, subtitle: nil, message: nil, icon: nil, badge: nil, color: nil, duration_seconds: nil, counts_down: nil, **fields)
         {
           title: title,
           type: type,
@@ -17,7 +18,9 @@ module ActivitySmith
           message: message,
           icon: icon,
           badge: badge,
-          color: color
+          color: color,
+          duration_seconds: duration_seconds,
+          counts_down: counts_down
         }.merge(fields).compact
       end
 

data/lib/activitysmith/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActivitySmith
-  VERSION = "1.4.0"
+  VERSION = "1.7.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activitysmith
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.7.0
 platform: ruby
 authors:
 - ActivitySmith
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-28 00:00:00.000000000 Z
+date: 2026-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json