Skip to main content
Register your existing TypeScript functions so agents can call them. Raysurfer wraps your callbacks with tool(...), and routes tool calls back to your app during sandbox execution.
Source: rayxc-org/raysurfer-ts

​
Setup

Install the SDK and set RAYSURFER_API_KEY in your environment. 
bun add raysurfer

​
Register Tools

tool(name, description, parameters, callback) can wrap any local callback you want to expose. The description is included in the tool payload. 
import { RaySurfer } from "raysurfer";

const rs = new RaySurfer({ apiKey: "your_api_key" });

rs.tool("add", "Add two numbers", { a: "integer", b: "integer" }, async (args) => {
  return String(Number(args.a) + Number(args.b));
});

​
Execute Modes

Use exactly one mode per execute() call:

​
Primary Mode: Pass userCode

const result = await rs.execute("Compute 5 + 3", {
  userCode: "print(add(5, 3))",
});

​
Optional Mode: Sandbox Codegen

In this mode, code is generated inside the Daytona sandbox from your prompt. 
const result = await rs.execute("Compute 5 + 3", {
  codegen: {
    provider: "anthropic",
    apiKey: "YOUR_ANTHROPIC_API_KEY",
    model: "claude-opus-4-6",
    prompt: "Write Python code that calls add(a, b) for 5 and 3, then prints the result.",
  },
});

​
Full SDK Reference

See TypeScript SDK for full method signatures and response fields.