TypeScript twins - Arga

List twins

for (const twin of await client.twins.list()) {
  console.log(twin.name, twin.label, twin.kind);
}

Provision

const { runId } = await client.twins.provision({
  twins: ['stripe', 'slack'],
  ttlMinutes: 60,
  scenarioId: 'scenario-id', // optional
  public: true,
});

Poll until ready:

const status = await client.twins.getStatus(runId);
if (status.status === 'ready' && status.twins) {
  for (const [name, twin] of Object.entries(status.twins)) {
    console.log(name, twin.baseUrl, twin.envVars);
  }
}

Generate seed data from a prompt

Generation mode options require arga-sdk 0.1.3 or later.

const { runId } = await client.twins.provision({
  twins: ['slack'],
  scenarioPrompt: 'A support channel with linked escalation threads and consistent message authors',
  scenarioGenerationMode: 'thorough',
});

Use scenarioGenerationMode: 'fast' for everyday scenarios, or omit it to use the server’s Fast default. Thorough handles complex requirements with a longer wait. A scenarioId takes precedence and reuses saved seed data.

Reset, extend, and tear down

await client.twins.reset(runId);
await client.twins.extend(runId, { ttlMinutes: 90 });
await client.twins.teardown(runId);

reset restores the baseline captured when the Twin Run was provisioned. teardown ends the run immediately.