Document dismiss, metrics create, and paired devices in the README

Synced from the landing SDK docs for the 1.15.0 SDK and 1.18.0 CLI releases.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: bardonadam

README.md

@@ -29,6 +29,25 @@ from activitysmith import (
 activitysmith = ActivitySmith(api_key=os.environ["ACTIVITYSMITH_API_KEY"])
 ```
 
+## Paired Devices
+
+List the iPhones and iPads paired to your account, for example to check that a device is paired before you send. Active devices come first:
+
+```python
+result = activitysmith.devices.list()
+
+for device in result.devices:
+    print(device.device_name, device.system_name, device.is_active)
+```
+
+An empty list means no device is paired. Install ActivitySmith on your iPhone, sign in with the same account, and allow notifications. Channel-scoped API keys cannot list devices.
+
+Pass `include_inactive` to also list devices that can no longer receive deliveries:
+
+```python
+activitysmith.devices.list(include_inactive=True)
+```
+
 ## Push Notifications
 
 ### Send a Push Notification
@@ -215,6 +234,21 @@ activitysmith.notifications.replace(
 )
 ```
 
+### Dismiss a Push Notification
+
+Pass the `notification_id` to `dismiss` when a Push Notification no longer needs attention, for example after you answered an agent's question somewhere else. Dismissing clears it from the Lock Screen and Notification Center on every device it was sent to. History keeps it.
+
+Devices clear the notification in the background, so it can take a moment.
+
+```python
+sent = activitysmith.notifications.send(
+    title="🙋 Agent needs your input",
+    message="Approve the database migration?",
+)
+
+activitysmith.notifications.dismiss(sent.notification_id)
+```
+
 ## Live Activities
 
 Choose the Live Activity type that matches what you want to show:
@@ -593,11 +627,9 @@ activitysmith.live_activities.stream(
 
 ![Lock screen widgets](https://cdn.activitysmith.com/features/lock-screen-widgets.png)
 
-ActivitySmith lets you display any value on your Lock Screen with widgets - SaaS metrics, revenue, signups, uptime, habits, or anything else you want to track. Create a metric in the [web app](https://activitysmith.com/app/widgets), then update the metric value using our API, add a widget to your lock screen and it will fetch the latest update automatically.
+ActivitySmith lets you display any value on your Lock Screen with widgets - SaaS metrics, revenue, signups, uptime, habits, or anything else you want to track. Send a value to a metric key, add a widget to your Lock Screen, and it fetches the latest value automatically.
 
-![Create widget metric](https://cdn.activitysmith.com/features/create-widget-metric.png)
-
-Use the metric key to update its value.
+Use the metric key to update its value. The first value creates the metric.
 
 ```python
 activitysmith.metrics.update("deploy.success_rate", 99.9)
@@ -609,6 +641,25 @@ String metric values work too.
 activitysmith.metrics.update("prod.status", "healthy")
 ```
 
+### Create a metric
+
+Use `create` to set the label and how widgets show the value, such as currency, percent, or a unit. Omitted fields keep their current values, so you can call it every time your app starts.
+
+```python
+activitysmith.metrics.create(
+    "mrr",
+    label="MRR",
+    format="currency",
+    currency_code="USD",
+)
+
+activitysmith.metrics.update("mrr", 12450)
+```
+
+You can also create and edit metrics in the [web app](https://activitysmith.com/app/widgets).
+
+![Create widget metric](https://cdn.activitysmith.com/features/create-widget-metric.png)
+
 ## App Icon Badge
 
 ![ActivitySmith app icon with an App Icon Badge](https://cdn.activitysmith.com/features/badge-count.png)