Collaboration WebSocket

wss://app.runtm.com/api/cloud/sessions/{session_id}/collaborate?token={ws_token}

{
  "type": "user_joined",
  "user": {
    "id": "user_xyz",
    "name": "Jane Developer",
    "email": "[email protected]",
    "avatar_url": "https://..."
  },
  "active_users": 3
}

{
  "type": "user_left",
  "user": {
    "id": "user_xyz",
    "name": "Jane Developer"
  },
  "active_users": 2
}

{
  "type": "cursor_update",
  "user_id": "user_xyz",
  "position": {
    "file": "src/app.tsx",
    "line": 42,
    "column": 15
  }
}

{
  "type": "selection_change",
  "user_id": "user_xyz",
  "selection": {
    "file": "src/app.tsx",
    "start": { "line": 10, "column": 0 },
    "end": { "line": 15, "column": 20 }
  }
}

ws.send(JSON.stringify({
  type: "cursor_update",
  position: {
    file: "src/app.tsx",
    line: 42,
    column: 15,
  },
}));

const tokenResponse = await fetch(
  "https://app.runtm.com/api/cloud/sessions/ses_abc123/ws-token",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer runtm_sk_live_abc123...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ capability: "collaborate" }),
  }
);
const { token } = await tokenResponse.json();

const ws = new WebSocket(
  `wss://app.runtm.com/api/cloud/sessions/ses_abc123/collaborate?token=${token}`
);

const activeUsers = new Map();

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  switch (msg.type) {
    case "user_joined":
      activeUsers.set(msg.user.id, msg.user);
      console.log(`${msg.user.name} joined (${msg.active_users} online)`);
      break;
    case "user_left":
      activeUsers.delete(msg.user.id);
      console.log(`${msg.user.name} left (${msg.active_users} online)`);
      break;
    case "cursor_update":
      console.log(`${msg.user_id} → ${msg.position.file}:${msg.position.line}`);
      break;
  }
};