Handle signal outcomes

A signal terminates once by emitting a value, failing, or closing without a value.

Source	`outcome`	`succeeded`	`failed`	`closed`	`onSuccess`	`onFailure`	`onClose`
Emits	Tagged value	`true`	`false`	`false`	Source value	Closes	Closes
Fails	Tagged failure	`false`	`true`	`false`	Closes	Error value	Closes
Closes	Tagged closure	`false`	`false`	`true`	Closes	Closes	`null`

Use outcome when later work needs one value for every terminal state:

automations/report-selection.automation.ts

import { automation, onHttpRequest, respondToHttpRequest } from "automate.ax"

export default automation("Report request selection", () => {
  const request = onHttpRequest()
  const selected = request.path.filter((path) => path.startsWith("/api/"))

  respondToHttpRequest({
    body: selected.outcome().transform((value) => JSON.stringify(value) ?? ""),
    requestId: request.requestId,
  })
})

Use succeeded, failed, or closed when another signal needs a boolean. Use onSuccess, onFailure, or onClose when an entire synchronous section should run for one state. Failure and closure are different: failure carries an AutomationError; closure means a route produced no value. To use a backup only when another signal closes, branch on closed(preferred). Failure remains distinct and doesn’t select the backup unless you route it explicitly.

Start

Concepts

Guides

Handle signal outcomes