Control state, faults, and time

import { createLocalWorld } from "@firedrill/sdk";

const world = await createLocalWorld({ root: process.cwd() });
const binding = await world.listen(); // Exactly one source-defined actor is required when actorId is omitted.

try {
  // Pass binding.environment to your existing client's configuration seam.
  // Keep its local bearer tokens private; these are not provider credentials.
  await useExistingClient(binding.environment);
} finally {
  await binding.close();
  world.close();
}

import { createLocalWorld } from "@firedrill/sdk";

const world = await createLocalWorld({
  root: process.cwd(),
  drill: "refund-dispute",
});

try {
  const result = world.call({
    actorId: "support-agent",
    packageId: "billing",
    operationId: "refunds.create",
    arguments: { orderId: "order-1", amount: 12900 },
    idempotencyKey: "refund-order-1",
  });

  world.advanceTime(3_600_000_000);
  const records = world.state({ packageId: "billing", namespace: "refunds" });
  const evidence = world.evidence();
} finally {
  world.close();
}