Saga Validate

Overview

You send up to 1000 steps with id, dependsOn, actionRef, optional compensationRef, optional and terminal flags, plus mode ORCHESTRATION or CHOREOGRAPHY. The answer is valid, topological order, layers, roots, terminals and diagnostics for cycles, unreachable steps, missing dependencies, uncompensated required steps and duplicate action references. This does not execute a saga. A successful call costs 1 execution credit.

Saga authors need a published graph and compensation check, not a workflow engine.

When to use it

Scope

Non-goals

• Does not execute a saga
• Does not prove compensation correctness or idempotency
• Does not validate a message broker

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"workflow.saga_validate","input":{"steps":[{"id":"debit","actionRef":"ledger.debit","compensationRef":"ledger.credit"},{"id":"notify","dependsOn":["debit"],"actionRef":"notify.send","compensationRef":"notify.void","terminal":true}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("workflow.saga_validate", {"steps":[{"terminal":false,"actionRef":"ledger.debit","compensationRef":"ledger.credit","id":"debit"},{"id":"notify","actionRef":"notify.send","terminal":true,"compensationRef":"notify.void","dependsOn":["debit"]}]});

Errors

Other limits

Limitations

• Does not execute a saga
• Does not prove compensation correctness or idempotency
• Does not validate a message broker
• Running the saga
• Generating workflow code

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "workflow.saga_validate",
  "input": {
    "steps": [
      {
        "terminal": false,
        "actionRef": "ledger.debit",
        "compensationRef": "ledger.credit",
        "id": "debit"
      },
      {
        "id": "notify",
        "actionRef": "notify.send",
        "terminal": true,
        "compensationRef": "notify.void",
        "dependsOn": [
          "debit"
        ]
      }
    ]
  }
}

Examples

{
  "steps": [
    {
      "terminal": false,
      "actionRef": "ledger.debit",
      "compensationRef": "ledger.credit",
      "id": "debit"
    },
    {
      "id": "notify",
      "actionRef": "notify.send",
      "terminal": true,
      "compensationRef": "notify.void",
      "dependsOn": [
        "debit"
      ]
    }
  ]
}

{
  "valid": true,
  "diagnostics": [],
  "topologicalOrder": [
    "debit",
    "notify"
  ],
  "roots": [
    "debit"
  ],
  "layers": [
    [
      "debit"
    ],
    [
      "notify"
    ]
  ],
  "mode": "ORCHESTRATION",
  "stepCount": 2,
  "terminals": [
    "notify"
  ]
}

{
  "steps": [
    {
      "actionRef": "a.run",
      "dependsOn": [
        "b"
      ],
      "compensationRef": "a.undo",
      "id": "a"
    },
    {
      "actionRef": "b.run",
      "dependsOn": [
        "a"
      ],
      "compensationRef": "b.undo",
      "id": "b"
    }
  ]
}

{
  "valid": false,
  "diagnostics": [
    {
      "code": "CYCLE",
      "count": 1,
      "message": "Steps depend on each other in a loop."
    }
  ],
  "topologicalOrder": [],
  "roots": [],
  "layers": [],
  "mode": "ORCHESTRATION",
  "stepCount": 2,
  "terminals": []
}

Recommended use cases

• Reject a cyclic compensation graph
• Confirm every required step has a compensationRef

Avoid for

• Running the saga
• Generating workflow code

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags