@runloop/api-client - v1.18.1
    Preparing search index...

    Class ScenarioOps

    Scenario SDK interface for managing scenarios.

    The ScenarioOps class provides a high-level abstraction for managing scenarios.

    Use fromId() to get a Scenario by ID, list() to retrieve all scenarios, or builder() to construct a new scenario with a fluent API. Once you have a scenario, call scenario.run() to start a ScenarioRun with your agent mounted.

    This interface is accessed via RunloopSDK.scenario. You should construct a RunloopSDK instance and use it from there:

    const runloop = new RunloopSDK();
    const scenario = runloop.scenario.fromId('scn_123');

    // Get scenario details
    const info = await scenario.getInfo();
    console.log(info.name);

    // Start a run with agent mounted and wait for the devbox to be ready
    const run = await scenario.run({
      run_name: 'my-run',
      runProfile: {
        mounts: [{
          type: 'agent_mount',
          agent_id: 'agt_123',
          agent_name: null,
          agent_path: '/home/user/agent',
        }],
      },
    });

    // Execute your agent on the devbox
    await run.devbox.cmd.exec('python /home/user/agent/main.py');

    // Score and complete
    await run.scoreAndComplete();
    Index

    Methods

    builder fromId list

    Methods

    • Create a new ScenarioBuilder for constructing a scenario with a fluent API.

      Parameters

      • name: string

        Name for the scenario

      Returns ScenarioBuilder

      A ScenarioBuilder instance

      const runloop = new RunloopSDK();
      const scenario = await runloop.scenario
        .builder('my-scenario')
        .withProblemStatement('Fix the bug in main.py')
        .addTestCommandScorer('tests', { test_command: 'pytest' })
        .push();

    • Get a scenario object by its ID.

      Parameters

      • id: string

        The ID of the scenario

      Returns RunloopSDK.Scenario

      A Scenario instance

      const runloop = new RunloopSDK();
      const scenario = runloop.scenario.fromId('scn_123');
      const info = await scenario.getInfo();
      console.log(info.name);

    • List scenarios with optional filters (paginated).

      Parameters

      • Optionalparams: ScenarioListParams

        Optional filter parameters

      • Optionaloptions: RequestOptions<unknown>

        Request options

      Returns Promise<RunloopSDK.Scenario[]>

      An array of Scenario instances

      const runloop = new RunloopSDK();
      const scenarios = await runloop.scenario.list({ limit: 10 });
      console.log(scenarios.map((s) => s.id));

    Settings

    Member Visibility

    On This Page

    OverviewQuickstartUsage
    Methods