Adds boolean helpers section to the runs and realtime pages

Author: samejr

docs/realtime/overview.mdx

@@ -5,6 +5,7 @@ description: Using the Trigger.dev v3 realtime API
 ---
 
 import RealtimeExamplesCards from "/snippets/realtime-examples-cards.mdx";
+import RunBooleanHelpers from "/snippets/run-boolean-helpers.mdx";
 
 Trigger.dev Realtime is a set of APIs that allow you to subscribe to runs and get real-time updates on the run status. This is useful for monitoring runs, updating UIs, and building realtime dashboards.
 
@@ -195,6 +196,23 @@ The run object returned by the async iterator has the following fields:
   Indicates whether this is a test run.
 </ParamField>
 
+## Boolean helpers
+
+Run objects returned from Realtime subscriptions include convenient boolean helper methods to check the run's status:
+
+```ts
+import { runs } from "@trigger.dev/sdk";
+
+for await (const run of runs.subscribeToRun("run_1234")) {
+  if (run.isCompleted) {
+    console.log("Run completed successfully!");
+    break;
+  }
+}
+```
+
+<RunBooleanHelpers />
+
 ## Type-safety
 
 You can infer the types of the run's payload and output by passing the type of the task to the `subscribeToRun` function. This will give you type-safe access to the run's payload and output.

docs/runs.mdx

@@ -3,6 +3,8 @@ title: "Runs"
 description: "Understanding the lifecycle of task run execution in Trigger.dev"
 ---
 
+import RunBooleanHelpers from "/snippets/run-boolean-helpers.mdx";
+
 In Trigger.dev, the concepts of runs and attempts are fundamental to understanding how tasks are executed and managed. This article explains these concepts in detail and provides insights into the various states a run can go through during its lifecycle.
 
 ## What are runs?
@@ -63,7 +65,7 @@ during execution (likely due to an Out of Memory error) and won’t be retried.
 <Icon icon="bug" iconType="solid" color="#E11D48" size={17} /> **System failure**: An unrecoverable system
 error has occurred.
 
-<Icon icon="trash-can" iconType="solid" color="#878C99" size={17} /> **Expired**: The run's Time-to-Live
+<Icon icon="trash-can" iconType="solid" color="#878C99" size={17} /> **Expired**: The run's [Time-to-Live](#time-to-live-ttl)
 (TTL) has passed before it could start executing.
 
 ## Attempts
@@ -87,6 +89,35 @@ A run is considered finished when:
 
 At this point, the run will have either an output (if successful) or an error (if failed).
 
+## Boolean helpers
+
+Run objects returned from the API and Realtime include convenient boolean helper methods to check the run's status:
+
+```ts
+import { runs } from "@trigger.dev/sdk";
+
+const run = await runs.retrieve("run_1234");
+
+if (run.isCompleted) {
+  console.log("Run completed successfully");
+}
+```
+
+<RunBooleanHelpers />
+
+These helpers are also available when subscribing to Realtime run updates:
+
+```ts
+import { runs } from "@trigger.dev/sdk";
+
+for await (const run of runs.subscribeToRun("run_1234")) {
+  if (run.isCompleted) {
+    console.log("Run completed successfully!");
+    break;
+  }
+}
+```
+
 ## Advanced run features
 
 ### Idempotency Keys

docs/snippets/run-boolean-helpers.mdx

@@ -0,0 +1,7 @@
+- **`isQueued`**: Returns `true` when the status is `QUEUED`, `PENDING_VERSION`, or `DELAYED`
+- **`isExecuting`**: Returns `true` when the status is `EXECUTING` or `DEQUEUED`. These count against your concurrency limits.
+- **`isWaiting`**: Returns `true` when the status is `WAITING`. These do not count against your concurrency limits.
+- **`isCompleted`**: Returns `true` when the status is any of the completed statuses
+- **`isCanceled`**: Returns `true` when the status is `CANCELED`
+- **`isFailed`**: Returns `true` when the status is any of the failed statuses
+- **`isSuccess`**: Returns `true` when the status is `COMPLETED`