npm install @stevora/sdk

export STEVORA_API_KEY=stv_your_key

import { AgentRuntime } from '@stevora/sdk';

const stevora = new AgentRuntime({
  apiKey: process.env.STEVORA_API_KEY,
  baseUrl: 'https://api.stevora.in',
});

const definition = await stevora.definitions.create({
  name: 'refund-review',
  version: String(Date.now()),
  description: 'Draft a customer reply and wait for human approval.',
  steps: [
    {
      type: 'llm',
      name: 'draft-response',
      model: 'gemini-3.6-flash',
      responseFormat: 'json',
      maxTokens: 1024,
      systemPrompt:
        'Return only JSON with keys reply and reason. Keep the reply under 40 words.',
      messages: [
        {
          role: 'user',
          content:
            'Customer: {{input.message}} Order: {{input.orderId}}. Draft a clear response confirming human review.',
        },
      ],
    },
    {
      type: 'approval',
      name: 'human-review',
      contentKey: 'reply',
      prompt: 'Approve this reply before it is sent.',
    },
  ],
});

const run = await stevora.workflows.create({
  definitionId: definition.id,
  input: {
    orderId: 'ORDER-842',
    message: 'I was charged twice. Please refund the duplicate charge.',
  },
  idempotencyKey: `refund-order-842-${Date.now()}`,
});

console.log(`Run started: ${run.id}`);

let approval;
while (!approval) {
  const current = await stevora.workflows.get(run.id);
  if (current.status === 'FAILED') {
    throw new Error(JSON.stringify(current.error));
  }

  const pending = await stevora.approvals.list({ pending: true });
  approval = pending.find((item) => item.workflowRunId === run.id);

  if (!approval) {
    await new Promise((resolve) => setTimeout(resolve, 1500));
  }
}

console.log('Draft waiting for approval:', approval.content);

// In a real product, call this after a person clicks Approve.
await stevora.approvals.approve(approval.id, 'quickstart-user');

const completed = await stevora.workflows.waitForCompletion(run.id, {
  pollIntervalMs: 1000,
  timeoutMs: 60000,
});

const cost = await stevora.workflows.getCost(run.id);

console.log(`Final status: ${completed.status}`);
console.log(`LLM cost: $${cost.totalCostDollars}`);

node run.mjs