Human nodes

Bring a person in: approvals, interventions in the live view, notifications.

Generated from the node definitions in src/lib/flow/node/human/ and the English labels (component.flow.node.human). Every node also has the common settings.

Contents

• Approval — human/approval
• Form — human/form
• Intervention — human/intervention
• Notify — human/notify

Approval

human/approval · icon stamp

Lets you review and edit data

It's an intervention with two buttons, Reject and Approve, and the data to edit; the one auto will pick counts down on its button. In Studio it shows above the canvas, on a campaign's dashboard in the Waiting for you dialog, without a browser view (it's a decision, not a task in the browser).

Fields

Output dots

• approve — Approve
• reject — Reject

Output shape

Later nodes read it as {{ nodes.<id>.output… }}.

{
  "data": "unknown",
  "decision": "string"
}

Default settings

timeout 1 day; the rest are the common defaults.

Example node

{
  "id": "approval",
  "type": "human/approval",
  "name": "Approval",
  "field": {
    "auto": "off",
    "autoAfterMs": 60000
  },
  "setting": {
    "retry": {
      "count": 0,
      "waitMs": 1000,
      "backoff": "fixed"
    },
    "error": { "mode": "stop", "fallback": null, "break": { "count": 3, "waitMs": 600000 } },
    "timeoutMs": 86400000,
    "disabled": false
  },
  "pin": null
}

Form

human/form · icon clipboard-pen

Asks a few questions and waits for the answers.

• In the app: the run's waiting dialog (Studio, the campaign dashboard) shows one input per question, and Send answers.
• At a public link: anyone with the run's form link (/form/wait/<token>, in the log and the output's link) answers on a mooflair page. Send the link in a message before.

A required question left empty fails the node. With a wait limit and no answer in time, it takes the timeout dot.

Output dots: next, timeout.

{ "answer": { "message": "…" }, "link": "https://app.example.com/form/wait/eyJ…" }

Default timeout: 7 days.

Intervention

human/intervention · icon hand

Waits for you in the live view

It shows its message, the selector it waits for, and Done: Done checks first, and the check also runs by itself every few seconds (the dialog shows why it isn't done yet). When a check fails you can still Continue anyway. On any node, On error: ask a human shows the failure with a Retry button.

Fields

Output dots

• next — Next

Output shape

Later nodes read it as {{ nodes.<id>.output… }}.

{
  "waitedMs": "number"
}

Default settings

timeout 1 day; the rest are the .

Example node

{
  "id": "intervention",
  "type": "human/intervention",
  "name": "Intervention",
  "field": {},
  "setting": {
    "retry": {
      "count": 0,
      "waitMs": 1000,
      "backoff": "fixed"
    },
    "error": { "mode": "stop", "fallback": null, "break": { "count": 3, "waitMs": 600000 } },
    "timeoutMs": 86400000,
    "disabled": false
  },
  "pin": null
}

Notify

human/notify · icon bell-ring

Tells you something: in mooflair, Discord or Slack

Fields

Output dots

• next — Next

Output shape

Later nodes read it as {{ nodes.<id>.output… }}.

{
  "channel": "string",
  "title": "string"
}

Example node

{
  "id": "notify",
  "type": "human/notify",
  "name": "Notify",
  "field": {
    "channel": "app",
    "level": "info"
  },
  "setting": {
    "retry": {
      "count": 0,
      "waitMs": 1000,
      "backoff": "fixed"
    },
    "error": { "mode": "stop", "fallback": null, "break": { "count": 3, "waitMs": 600000 } },
    "timeoutMs": 60000,
    "disabled": false
  },
  "pin": null
}