Coordinate AI providers. Verify what comes back.

export OAT=http://localhost:3000/api/v1
export TOKEN=oat_your_token_here

# 1. Create the workflow (see "Workflow JSON")
curl -s "$OAT/workflows" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d @workflow.json

# 2. Start an execution (returns 202 with an id)
curl -s "$OAT/workflows/wf_.../executions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input":{"topic":"vector databases"}}'

# 3. Poll the execution until it finishes
curl -s "$OAT/executions/ex_..." \
  -H "Authorization: Bearer $TOKEN"

const BASE = 'http://localhost:3000/api/v1';
const headers = {
  Authorization: `Bearer ${process.env.OAT_TOKEN}`,
  'Content-Type': 'application/json',
};

async function call(path, init = {}) {
  const res = await fetch(BASE + path, { headers, ...init });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
  return body.data;
}

const run = await call('/workflows/wf_.../executions', {
  method: 'POST',
  body: JSON.stringify({ input: { topic: 'vector databases' } }),
});

let execution = await call(`/executions/${run.id}`);
while (['queued', 'running'].includes(execution.status)) {
  await new Promise((r) => setTimeout(r, 1500));
  execution = await call(`/executions/${run.id}`);
}
console.log(execution.status, execution.steps);

{
  "name": "Research brief",
  "inputSchema": {
    "type": "object",
    "required": ["topic"],
    "properties": { "topic": { "type": "string" } }
  },
  "steps": [
    {
      "id": "search",
      "capability": "web.search",
      "input": { "query": "{{input.topic}}", "count": 5 }
    },
    {
      "id": "summary",
      "capability": "llm.generate",
      "dependsOn": ["search"],
      "input": {
        "prompt": "Summarize {{input.topic}} and cite URLs: {{steps.search.output.results}}"
      },
      "verification": {
        "criteria": [
          { "type": "urls_in_step", "path": "text", "sourceStep": "search" }
        ]
      }
    }
  ]
}