Sandbox

1
import { Recursiv } from '@recursiv/sdk';
2
3
const r = new Recursiv({ anonymous: true });
4
5
const { data, meta } = await r.sandbox.execute({
6
  code: 'console.log("Hello, world!")',
7
  language: 'typescript',
8
});
9
10
console.log(data.output);                    // "Hello, world!\n"
11
console.log(data.exitCode);                  // 0
12
console.log(data.executionTime);             // milliseconds
13
console.log(meta.remaining_executions);      // 9 (out of 10/day)

1
interface SandboxResponse {
2
  data: {
3
    output: string;        // Combined stdout/stderr
4
    exitCode: number;      // 0 on success, non-zero on error
5
    executionTime: number; // Execution time in milliseconds
6
    error?: string;        // Error message if execution failed
7
  };
8
  meta: {
9
    sandbox_id: string;
10
    remaining_executions: number; // Remaining executions today
11
    signup_url: string;           // URL to sign up for unlimited access
12
  };
13
}

1
const r = new Recursiv({ anonymous: true });

1
const { data } = await r.sandbox.execute({
2
  code: `
3
    interface User {
4
      name: string;
5
      age: number;
6
    }
7
8
    const user: User = { name: 'Alice', age: 30 };
9
    console.log(JSON.stringify(user));
10
  `,
11
  language: 'typescript',
12
});
13
14
console.log(data.output); // {"name":"Alice","age":30}

1
const { data } = await r.sandbox.execute({
2
  code: `
3
    const numbers = [1, 2, 3, 4, 5];
4
    const sum = numbers.reduce((a, b) => a + b, 0);
5
    console.log('Sum:', sum);
6
  `,
7
  language: 'javascript',
8
});
9
10
console.log(data.output); // Sum: 15

1
const { data } = await r.sandbox.execute({
2
  code: `
3
import json
4
5
data = {"message": "Hello from Python", "numbers": list(range(5))}
6
print(json.dumps(data))
7
  `,
8
  language: 'python',
9
});
10
11
console.log(data.output); // {"message": "Hello from Python", "numbers": [0, 1, 2, 3, 4]}

1
const { meta } = await r.sandbox.execute({
2
  code: 'console.log("test")',
3
});
4
5
if (meta.remaining_executions === 0) {
6
  console.log(`Daily limit reached. Sign up at ${meta.signup_url}`);
7
}

1
import { RateLimitError } from '@recursiv/sdk';
2
3
try {
4
  await r.sandbox.execute({ code: 'console.log("test")' });
5
} catch (err) {
6
  if (err instanceof RateLimitError) {
7
    console.log('Daily sandbox limit reached.');
8
    console.log('Upgrade:', err.upgradeUrl);
9
  }
10
}

1
const { data } = await r.sandbox.execute({
2
  code: 'throw new Error("something broke")',
3
  language: 'typescript',
4
});
5
6
if (data.exitCode !== 0) {
7
  console.error('Execution failed:');
8
  console.error(data.output); // Contains the error stack trace
9
  console.error(data.error);  // Error summary if available
10
}