How to run an agent
for three weeks.

curl -X POST https://api.openagents.cc/v1/agents/research-sentinel/runs \
  -H 'x-api-key: $CONTINUUM_API_KEY' \
  -H 'content-type: application/json' \
  -d '{
    "input": {"goal": "Review the release queue"},
    "budgetCredits": 1,
    "idempotencyKey": "release-review-2026-08-03"
  }'

// Every weekday at 09:00 Paris time, daylight saving included.
await continuum.triggers.create('digest', {
  cron: '0 9 * * 1-5',
  timezone: 'Europe/Paris',
  inputTemplate: { window: 'since-yesterday' },
});

// What each schedule did last, and why if it did nothing.
for (const trigger of await continuum.triggers.list('digest')) {
  console.log(trigger.cron, trigger.nextFireAt, trigger.lastStatus, trigger.lastError);
}

{
  "name": "Digest",
  "slug": "digest",
  "manifest": { "model": "gpt-5-mini", "system": "..." },
  "triggers": [
    { "cron": "0 9 * * 1-5", "timezone": "Europe/Paris" }
  ]
}

npm install @continuum/agent

import { defineAgent, tool } from '@continuum/agent';
import { z } from 'zod';

export default defineAgent({
  model: 'gpt-5-mini',
  system: 'You handle refunds. End every turn with a directive.',
  tools: [
    tool({
      name: 'refundOrder',
      // The model picks tools by this sentence alone.
      description: 'Refunds an order and returns the refund id.',
      parameters: z.object({ orderId: z.string() }),
      async run({ orderId }, ctx) {
        const res = await fetch('https://api.stripe.com/v1/refunds', {
          method: 'POST',
          headers: { authorization: `Bearer ${ctx.secrets.STRIPE_KEY}` },
          body: new URLSearchParams({ charge: orderId }),
        });
        return await res.json();
      },
    }),
  ],
});

{
  "name": "Refund desk",
  "slug": "refund-desk",
  "entry": "agent.ts",
  "manifest": {
    "model": "gpt-5-mini",
    "system": "You handle refunds."
  }
}

$ continuum deploy
  ✓ bundled agent.ts → 412.3 KB (18 modules)
  ✓ uploaded sha256:9f2c1a4e7b03… (new)
  ✓ 1 tool: refundOrder
  ✓ deployed refund-desk v7 (active)

import { parseWebhook } from '@continuum/sdk';

export async function POST(request: Request) {
  // The raw bytes, not a parsed body: re-serializing JSON reorders keys
  // and the signature covers the exact bytes we sent.
  const body = await request.text();

  try {
    const event = await parseWebhook({
      body,
      header: request.headers.get('continuum-signature'),
      secret: process.env.CONTINUUM_WEBHOOK_SECRET!,
    });

    // At-least-once: the same event id can arrive more than once.
    // Deduplicate on it before doing anything with a side effect.
    if (await alreadyHandled(event.id)) return new Response(null, { status: 200 });

    if (event.type === 'run.completed') {
      await onRunFinished(event.data.run);
    }

    return new Response(null, { status: 200 });
  } catch {
    // Not ours, or too old. A rotated secret looks like this too.
    return new Response(null, { status: 400 });
  }
}

import { ContinuumApiError } from '@continuum/sdk';

try {
  await continuum.runs.start('research-sentinel', { input: {} });
} catch (error) {
  if (error instanceof ContinuumApiError) {
    console.error({
      code: error.code,
      status: error.status,
      retryable: error.retryable,
      requestId: error.requestId,
    });
  }
}