Agent Chat

from raysurfer import AsyncRaySurfer

rs = AsyncRaySurfer()

# First call — agent creates files from scratch
response = await rs.chat(
    "Create hello.py with a greet(name) function",
    user="user-123",
    org="acme-corp",
)
print(response.output)
print(response.changed_files)  # ["hello.py"]

# Second call — agent sees hello.py already in its workspace
response = await rs.chat(
    "Import greet from hello.py and create main.py",
    user="user-123",
    org="acme-corp",
)
print(response.workspace_files)  # ["hello.py", "main.py"]

import { RaySurfer } from "raysurfer";

const rs = new RaySurfer();

const response = await rs.chat(
  "Create hello.ts with a greet(name) function",
  { user: "user-123", org: "acme-corp" },
);
console.log(response.output);
console.log(response.changedFiles);

const response2 = await rs.chat(
  "Import greet from hello.ts and create main.ts",
  { user: "user-123", org: "acme-corp" },
);
console.log(response2.workspaceFiles);

curl -X POST https://api.raysurfer.com/api/agent-chat \
  -H "Authorization: Bearer $RAYSURFER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_query": "Create hello.py with a greet(name) function",
    "user_id": "user-123",
    "org_id": "acme-corp"
  }'

response = await rs.chat("Create a Flask app", user="dev-1", org="startup")

response.success          # True
response.output           # "I created app.py with a Flask app..."
response.changed_files    # ["app.py"]
response.workspace_files  # ["app.py"]
response.duration_ms      # 4200
response.session_id       # "sess_abc123"

const response = await rs.chat("Create a Flask app", { user: "dev-1", org: "startup" });

response.success;        // true
response.output;         // "I created app.py with a Flask app..."
response.changedFiles;   // ["app.py"]
response.workspaceFiles; // ["app.py"]
response.durationMs;     // 4200
response.sessionId;      // "sess_abc123"