Praxa Execution Fabric: Quickstart

curl -X POST https://api.praxa.io/api/custom-agent-run \
  -H "Authorization: Bearer aura_agent_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Summarize the last five support tickets for this customer.",
    "externalSessionId": "customer-482910"
  }'

const response = await fetch("https://api.praxa.io/api/custom-agent-run", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRAXA_AGENT_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    message: "Summarize the last five support tickets for this customer.",
    externalSessionId: "customer-482910",
  }),
});

if (!response.ok) {
  throw new Error(`Agent run failed: ${response.status}`);
}

const result = await response.json();

curl -X POST https://api.praxa.io/v1/execute \
  -H "Authorization: Bearer praxa_sk_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2b1e3a-2b3e-4a6d-9c1a-3a2b1e3a2b3e" \
  -d '{
    "task": "Research three competitors and draft a one-page comparison.",
    "context": { "notes": "Focus on pricing and support SLAs." },
    "tools": { "allow": ["web_search", "document_write"] },
    "policy": {
      "riskCeiling": "human_approval",
      "budgetCap": { "amountMicros": 2000000, "currency": "USD" },
      "toolAllowlist": ["web_search", "document_write"]
    },
    "delivery": { "mode": "turn" }
  }'

const response = await fetch("https://api.praxa.io/v1/execute", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRAXA_SK_KEY}`,
    "Content-Type": "application/json",
    Accept: "text/event-stream",
    "X-AI-Platform-Version": "v1",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    task: "Research three competitors and draft a one-page comparison.",
    context: { notes: "Focus on pricing and support SLAs." },
    tools: { allow: ["web_search", "document_write"] },
    policy: {
      riskCeiling: "human_approval",
      budgetCap: { amountMicros: 2_000_000, currency: "USD" },
      toolAllowlist: ["web_search", "document_write"],
    },
    delivery: { mode: "turn" },
  }),
});

if (!response.ok || !response.body) {
  throw new Error(`Execute request failed: ${response.status}`);
}

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  for (const line of buffer.split("\n")) {
    if (!line.startsWith("data:")) continue;
    const payload = line.slice(5).trim();
    if (payload === "[DONE]") continue;
    const event = JSON.parse(payload);

    if (event.type === "approval.required") {
      // Show event.summary to a human, then resolve it:
      // POST /v1/runs/:id/approve  { "action_digest": event.action_digest, "decision": "approved" }
    }
    if (event.type === "response.final" || event.type === "request.failed") {
      // Terminal event. Stop reading.
    }
  }
}

curl -X POST https://api.praxa.io/v1/runs/run_abc123/approve \
  -H "Authorization: Bearer praxa_sk_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "action_digest": "...", "decision": "approved" }'